deepseek-harness/packages/web/web-search-searxng/src/index.ts

/**
 * `@deepseek-ai/dsh-web-search-searxng`: registers a SearXNG-backed
 * `WebSearchProvider` with `ctx.web`. A function/namespace plugin (NOT a
 * default-export service): a search provider does not own the `ctx.web` key —
 * it registers INTO the seam's provider registry, exactly as
 * `@deepseek-ai/dsh-web-search-exa` does. The key is owned by
 * `@deepseek-ai/dsh-web`.
 *
 * @module @deepseek-ai/dsh-web-search-searxng
 */

import type { Context } from '@deepseek-ai/cordis'
import z from '@deepseek-ai/schemastery'
import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings'
import type {} from '@deepseek-ai/dsh-web'
import { SearXngSearchProvider } from './provider.ts'

export {
  SEARXNG_DEFAULT_LANGUAGE,
  SEARXNG_NO_TIME_RANGE,
  SEARXNG_PROVIDER_ID,
  SEARXNG_TIME_RANGES,
  SearXngSearchProvider,
} from './provider.ts'
export type {
  SearXngSearchProviderOptions,
  SearXngSearchProviderSource,
  SearXngTimeRange,
} from './provider.ts'

/** Cordis plugin name used by loader diagnostics. */
export const name = 'web-search-searxng'

/** The web seam this provider registers into. */
export const inject = ['web']

/** Plugin config. `baseURL` is optional in the schema so an omitted value
 * surfaces as an unavailable provider (the seam's `WEB_PROVIDER_CONFIGURED_UNAVAILABLE`)
 * rather than failing boot; `apply` fills constant defaults. */
export interface Config {
  /** SearXNG instance base; `/search` is appended. Empty/unparseable makes the provider unavailable. */
  baseURL?: string
  /** SearXNG `language` to request. Defaults to `auto`. */
  language?: string
  /** SearXNG `time_range` recency filter. Omitted = no filter. */
  timeRange?: 'day' | 'week' | 'month' | 'year'
}

export const Config: z<Config> = z.object({
  baseURL: z.string(),
  language: z.string(),
  timeRange: z.union(['day', 'week', 'month', 'year'] as const),
})

/** Settings namespace carrying the SearXNG instance and any per-search filters. */
export const SEARXNG_SETTINGS_NAMESPACE = settingsNamespace('web-search-searxng')

/** Register the SearXNG search provider with `ctx.web`, reading the live section
 * per search so an in-session settings edit applies without re-registration. */
export function apply(ctx: Context, config: Config): void {
  let current: () => Config = () => config
  installSettingsSection(ctx, SEARXNG_SETTINGS_NAMESPACE, Config, config, {
    setSource: (source) => {
      current = source
    },
    // The registration carries no resolved value: the provider projects the
    // section per search, so a committed change needs no re-registration.
    onChange: () => {},
  })
  ctx.web.registerSearchProvider(new SearXngSearchProvider(() => ({
    // SearXNG exposes no uniform public endpoint and the product requires
    // evidence over an unsupported default, so `baseURL` has no constant
    // fallback: an omitted value surfaces as an unavailable provider (the
    // seam's `WEB_PROVIDER_CONFIGURED_UNAVAILABLE`), not a silent endpoint.
    baseURL: current().baseURL ?? '',
    ...current().language !== undefined ? { language: current().language } : {},
    ...current().timeRange !== undefined ? { timeRange: current().timeRange } : {},
  })))
}