dsh-web-search-pro 0.2.1 → 0.2.3

package/lib/types/default-chain.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The default engine order of a plain search, as a pure function: the router uses it to decide the order, and the settings
+ * card's status summary uses the same code to show the chain a search would try first, so the two cannot disagree.
+ * No imports: the client bundle includes this file.
+ * @module web-search-pro/default-chain
+ */
+/** The default `engines` list. A list equal to it is "not customised": the default rule for common ("常用") sources applies to it. */
+export declare const DEFAULT_ENGINES: readonly string[];
+export interface ChainInput {
+    /** The configured `engines` (route ids). */
+    engines: readonly string[];
+    /** `sources.priority` (route ids). */
+    priority?: readonly string[];
+    /** `sources.disabled` (route ids). */
+    disabled?: readonly string[];
+    /** Common ("常用") sources whose key resolves, best first. */
+    commonReady?: readonly string[];
+    /** `evidence.sourcePolicy === 'anonymous-only'`: a paid common source is never added. */
+    anonymousOnly?: boolean;
+}
+/**
+ * Order of the configured chain: `sources.disabled` removed, `sources.priority` ids that are in the list first, then the common
+ * sources whose key resolves (only while `engines` is the default list; a list the user wrote keeps its order and the position
+ * it gave a common source), then the rest. Throws when everything is disabled.
+ */
+export declare function effectiveChain(input: ChainInput): string[];
+/** One reason the effective chain differs from the `engines` list as written. */
+export type ChainReason = 
+/** `sources.disabled` removed these from the list. */
+{
+    kind: 'disabled';
+    ids: string[];
+}
+/** `sources.priority` moved these to the front. */
+ | {
+    kind: 'priority';
+    ids: string[];
+}
+/** The default rule put these ready common ("常用") sources in front of the list. */
+ | {
+    kind: 'common';
+    ids: string[];
+}
+/** `evidence.sourcePolicy: anonymous-only` kept these ready common sources out (they need a key). */
+ | {
+    kind: 'anonymous-only';
+    ids: string[];
+}
+/** The list is the user's own, so these ready common sources are not added (they keep their place only if the list names them). */
+ | {
+    kind: 'own-list';
+    ids: string[];
+};
+export interface ChainExplanation {
+    /** What a plain search would try, in order ({@link effectiveChain}); undefined when everything is disabled. */
+    chain: string[] | undefined;
+    reasons: ChainReason[];
+}
+/**
+ * {@link effectiveChain} plus why it differs from the list: the preview of the settings card says it in one sentence per reason, so
+ * a person who sees `deepseek` first in a list that does not begin with it knows which rule did that. Same inputs, same rule.
+ */
+export declare function explainChain(input: ChainInput): ChainExplanation;

package/lib/types/engines.d.ts

@@ -11,10 +11,27 @@ import { type BrowserMethod } from './browser-access.ts';
 import type { CustomPlatformSpec } from './config.ts';
 import { type ExaSearchRequest } from './exa-client.ts';
 import { EngineError } from './engine-error.ts';
+/**
+ * A source row as an engine returns it: the host's `WebSearchSource` plus the provider's own quality signals, when it has any
+ * (DeepSeek Search: `rerank_score` 0..3 and `authority` 0..4). They travel with the row as source metadata and are one small
+ * fusion signal (pipeline/fusion.ts); no engine is required to set them.
+ */
+export interface EngineSource extends WebSearchSource {
+    /** The provider's relevance / authority / freshness rank score, 0..3 (higher is better). */
+    readonly rerankScore?: number;
+    /** The provider's source-authority grade, 0..4 (unknown = absent). */
+    readonly authority?: number;
+    /** The user-defined CLI that returned the row (`custom-cli:echo`): set by the adapter, shown with the result. */
+    readonly via?: string;
+    /** The honest label of a user-defined source ("user-defined, not verified by the plugin"). */
+    readonly tag?: string;
+    /** The source's confidence (0..1), below 1 only: set by the router from the spec / `sources.confidence`, never by an engine. */
+    readonly confidence?: number;
+}
 export interface SearchOutcome {
     /** Provider-generated answer/summary text, when any. */
     content?: string;
-    sources: WebSearchSource[];
+    sources: EngineSource[];
     /** Id of the concrete backend that answered (a platform provider with a fallback chain names the leg that ran). */
     via?: string;
     /** The backend id of the platform chain that answered (`bili`, `browser-opencli`), for display and history. */
@@ -29,6 +46,8 @@ export interface Engine {
     backend?: string;
     /** Cheap local availability check; must not do network I/O. */
     available(): boolean;
+    /** Why `available()` is false, when the engine knows (a platform chain quotes it in its fall-through note instead of "unavailable"). */
+    unavailableReason?(): string | undefined;
     /** Browser-service method this engine depends on (dsh-browser is optional). */
     needsBrowser?: BrowserMethod;
     search(query: string, count: number, signal?: AbortSignal, options?: EngineSearchOptions): Promise<SearchOutcome>;
@@ -41,6 +60,8 @@ export interface EngineSearchOptions {
         include?: string[];
         exclude?: string[];
     };
+    /** The caller's original question or need (DeepSeek Search `ori_question`, cut to 128 characters by the engine); absent = none sent. */
+    originalQuestion?: string;
     /** Lower bound of the publication date (ISO 8601), compiled from a hard time_window; the engine maps it to its native filter. */
     since?: string;
     /** Domain lists compiled from hard site / exclude_site constraints (keyed sources that take them as request fields). */
@@ -81,6 +102,8 @@ export interface EngineDeps {
     usage?: UsageRecorder;
     /** Test seam: replaces the global fetch of API clients that accept one. */
     fetchImpl?: typeof fetch;
+    /** Test seam: waits between retries of the engines that retry (DeepSeek); resolves early on abort. Default: a real timer. */
+    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
     /** Test seam: replaces the DNS lookup of the SSRF check. */
     lookup?: (hostname: string) => Promise<{
         address: string;
@@ -100,6 +123,11 @@ export interface EngineDeps {
     anysearchApiKey?: string;
     /** GitHub API token (config githubToken / $GITHUB_TOKEN / $GH_TOKEN). */
     githubToken?: string;
+    /**
+     * Credential variables of the CLI adapters by the name the tool reads (`TWITTER_AUTH_TOKEN`, `TWITTER_CT0`), resolved by the router:
+     * config literal -> credentials ref -> process environment. Handed to a command only through its environment, never in argv.
+     */
+    cliEnv?: Readonly<Record<string, string>>;
     enableCli: boolean;
     opencliEnabled: boolean;
     agentReachEnabled: boolean;

package/lib/types/fetch.d.ts

@@ -8,7 +8,8 @@ import type { ResolvedConfig } from './config.ts';
 import type { BrowserService } from './browser-service.ts';
 import { type BrowserGetter } from './browser-access.ts';
 import type { ExtractRule } from './extract.ts';
-export type FetchMode = 'auto' | 'jina' | 'http' | 'playwright';
+import { type DeepSeekFetchAccess } from './providers/deepseek.ts';
+export type FetchMode = 'auto' | 'jina' | 'http' | 'playwright' | 'deepseek';
 export interface FetchOptions {
     mode: FetchMode;
     signal: AbortSignal | undefined;
@@ -63,7 +64,7 @@ export declare function detectShellPage(text: string): boolean;
 export type PageClass = 'content' | 'shell' | 'login_wall' | 'captcha' | 'js_shell' | 'error';
 /** One backend attempt of a fetch, in order (recorded in the result and in the stored fetch detail). */
 export interface FetchAttempt {
-    source: 'jina' | 'http' | 'playwright';
+    source: 'jina' | 'http' | 'playwright' | 'deepseek';
     class: PageClass;
     chars?: number;
     detail?: string;
@@ -82,14 +83,20 @@ export declare function classifyPage(text: string, meta?: {
 export declare function normalizeUrl(raw: string): string;
 /** All rules: user (DB) first, then built-ins; user rules win on ties. */
 export declare function mergedRules(store: Store): ExtractRule[];
+/**
+ * The DeepSeek Fetch API access for a call: key, endpoint, ledger. Resolved per call by the router (settings literal -> DSH credentials ->
+ * process environment); undefined = no key. Test seams (`fetchImpl`, `lookup`, `sleep`) ride along on the returned object.
+ */
+export type DeepSeekFetchAccessProvider = () => Promise<Pick<DeepSeekFetchAccess, 'apiKey' | 'baseUrl' | 'usage' | 'fetchImpl' | 'lookup' | 'sleep' | 'allowProxyFakeIp'> | undefined>;
 export declare class FetchService {
     private readonly store;
     private readonly config;
+    private readonly deepseek?;
     private readonly memory;
     /** In-flight de-duplication of identical non-fresh fetches (C3). */
     private readonly flights;
     private readonly getBrowser;
-    constructor(store: Store, config: ResolvedConfig | (() => ResolvedConfig), browser?: BrowserService | BrowserGetter);
+    constructor(store: Store, config: ResolvedConfig | (() => ResolvedConfig), browser?: BrowserService | BrowserGetter, deepseek?: DeepSeekFetchAccessProvider | undefined);
     private cfg;
     /** True when the optional browser can render right now (enabled in config and the service has render()). */
     private canRender;
@@ -98,5 +105,7 @@ export declare class FetchService {
     private runFetch;
     private fetchJina;
     private fetchHttp;
+    /** One page through the DeepSeek Fetch API. 403 / 404 are DeepSeek's own verdicts (see `DeepSeekFetchError`), never the target page's status. */
+    private fetchDeepSeek;
     private fetchPlaywright;
 }

package/lib/types/index.d.ts

@@ -29,103 +29,16 @@ declare const _default: {
     name: string;
     inject: string[];
     Config: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-        dbPath: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        toolSurface: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        ttlSeconds: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        memoryCacheEntries: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        rrfConstant: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        freshnessBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        freshnessDays: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        authorityBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        authorityDomains: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
         searchMaxResults: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        fetchDefaultChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        exaContentsPerUrlChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        exaContentsTotalChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        timeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        parallelEngines: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        toolSurface: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
         allowProxyFakeIp: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        deepseekFetch: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
         engines: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
-        parallelEngines: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        exaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        exaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        jinaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        jinaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        bochaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        bochaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        bochaBaseUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        bochaSummary: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        searxngUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        openalexMailto: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        keyedSources: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
-            apiKey?: string | null | undefined;
-            apiKeyEnv?: string | null | undefined;
-            baseUrl?: string | null | undefined;
-        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
-            apiKey: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            apiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            baseUrl: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-        }>>, string>>, "volatile">;
-        githubToken: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        githubTokenEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        enableCliBackends: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        opencliEnabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        agentReachEnabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        providerId: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        registerProvider: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        provider: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        }>>, "plain">;
-        platformRules: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
-            item?: string | null | undefined;
-            title?: string | null | undefined;
-            link?: string | null | undefined;
-            text?: string | null | undefined;
-        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
-            item: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            title: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            link: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            text: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-        }>>, string>>, "volatile">;
-        customPlatforms: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
-            name?: string | null | undefined;
-            url?: string | null | undefined;
-            item?: string | null | undefined;
-            title?: string | null | undefined;
-            link?: string | null | undefined;
-            text?: string | null | undefined;
-            cookie?: string | null | undefined;
-        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
-            name: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            url: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            item: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            title: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            link: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            text: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            cookie: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-        }>>, string>>, "volatile">;
-        browserBindings: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
-            authProfile?: string | null | undefined;
-            rulePack?: string | null | undefined;
-        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
-            authProfile: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            rulePack: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-        }>>, string>>, "volatile">;
-        platformBackends: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, "volatile">;
-        cliAdapters: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, "volatile">;
-        playwright: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-        }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-        }>>, "plain">;
         sources: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
             priority: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
             disabled: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
+            confidence: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, "volatile">;
             budget: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
                 total?: number | null | undefined;
                 daily?: number | null | undefined;
@@ -136,6 +49,7 @@ declare const _default: {
         }>>, Schemastery.ObjectT<NoInfer<{
             priority: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
             disabled: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
+            confidence: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, "volatile">;
             budget: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
                 total?: number | null | undefined;
                 daily?: number | null | undefined;
@@ -144,6 +58,29 @@ declare const _default: {
                 daily: import("@deepseek-ai/schemastery").default<number, number, "plain">;
             }>>, string>>, "volatile">;
         }>>, "plain">;
+        platformBackends: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, "volatile">;
+        keyedSources: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
+            apiKey?: string | null | undefined;
+            apiKeyEnv?: string | null | undefined;
+            baseUrl?: string | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
+            apiKey: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            apiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            baseUrl: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+        }>>, string>>, "volatile">;
+        exaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        exaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        jinaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        jinaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        bochaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        bochaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        bochaBaseUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        bochaSummary: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        githubToken: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        githubTokenEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        searxngUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        openalexMailto: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        cliAdapters: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, "volatile">;
         evidence: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
             scorer: import("@deepseek-ai/schemastery").default<"jev" | "rule", "jev" | "rule", "volatile-defined">;
             jevMode: import("@deepseek-ai/schemastery").default<"off" | "shadow" | "control" | "hybrid", "off" | "shadow" | "control" | "hybrid", "volatile-defined">;
@@ -487,85 +424,50 @@ declare const _default: {
                 }>>, string>, "plain">;
             }>>>, "volatile">;
         }>>, "plain">;
-        verbose: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-    }>>, Schemastery.ObjectT<NoInfer<{
-        dbPath: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        toolSurface: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        ttlSeconds: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        memoryCacheEntries: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        rrfConstant: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        freshnessBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        freshnessDays: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        authorityBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        authorityDomains: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
-        searchMaxResults: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
         fetchDefaultChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
         exaContentsPerUrlChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
         exaContentsTotalChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        timeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
-        allowProxyFakeIp: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        engines: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
-        parallelEngines: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        exaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        exaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        jinaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        jinaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        bochaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        bochaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        bochaBaseUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        bochaSummary: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        searxngUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        openalexMailto: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        keyedSources: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
-            apiKey?: string | null | undefined;
-            apiKeyEnv?: string | null | undefined;
-            baseUrl?: string | null | undefined;
-        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
-            apiKey: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            apiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            baseUrl: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-        }>>, string>>, "volatile">;
-        githubToken: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
-        githubTokenEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
         enableCliBackends: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
         opencliEnabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
         agentReachEnabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        providerId: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-        registerProvider: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-        provider: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        twitterAuthToken: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        twitterAuthTokenEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        twitterCt0: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        twitterCt0Env: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        playwright: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
         }>>, Schemastery.ObjectT<NoInfer<{
-            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
-            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
         }>>, "plain">;
-        platformRules: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
+        customPlatforms: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
+            name?: string | null | undefined;
+            url?: string | null | undefined;
             item?: string | null | undefined;
             title?: string | null | undefined;
             link?: string | null | undefined;
             text?: string | null | undefined;
+            cookie?: string | null | undefined;
         } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
+            name: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            url: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             item: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             title: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             link: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             text: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            cookie: import("@deepseek-ai/schemastery").default<string, string, "plain">;
         }>>, string>>, "volatile">;
-        customPlatforms: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
-            name?: string | null | undefined;
-            url?: string | null | undefined;
+        platformRules: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
             item?: string | null | undefined;
             title?: string | null | undefined;
             link?: string | null | undefined;
             text?: string | null | undefined;
-            cookie?: string | null | undefined;
         } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
-            name: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            url: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             item: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             title: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             link: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             text: import("@deepseek-ai/schemastery").default<string, string, "plain">;
-            cookie: import("@deepseek-ai/schemastery").default<string, string, "plain">;
         }>>, string>>, "volatile">;
         browserBindings: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
             authProfile?: string | null | undefined;
@@ -574,18 +476,36 @@ declare const _default: {
             authProfile: import("@deepseek-ai/schemastery").default<string, string, "plain">;
             rulePack: import("@deepseek-ai/schemastery").default<string, string, "plain">;
         }>>, string>>, "volatile">;
-        platformBackends: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, "volatile">;
-        cliAdapters: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, "volatile">;
-        playwright: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+        providerId: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        registerProvider: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        provider: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
         }>>, Schemastery.ObjectT<NoInfer<{
-            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
-            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
         }>>, "plain">;
+        timeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        ttlSeconds: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        memoryCacheEntries: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        rrfConstant: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        freshnessBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        freshnessDays: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        authorityBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        authorityDomains: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+        dbPath: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        verbose: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        searchMaxResults: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        parallelEngines: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        toolSurface: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        allowProxyFakeIp: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        deepseekFetch: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        engines: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
         sources: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
             priority: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
             disabled: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
+            confidence: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, "volatile">;
             budget: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
                 total?: number | null | undefined;
                 daily?: number | null | undefined;
@@ -596,6 +516,7 @@ declare const _default: {
         }>>, Schemastery.ObjectT<NoInfer<{
             priority: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
             disabled: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile">;
+            confidence: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<number, string>>, "volatile">;
             budget: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
                 total?: number | null | undefined;
                 daily?: number | null | undefined;
@@ -604,6 +525,29 @@ declare const _default: {
                 daily: import("@deepseek-ai/schemastery").default<number, number, "plain">;
             }>>, string>>, "volatile">;
         }>>, "plain">;
+        platformBackends: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<string[], string>>, "volatile">;
+        keyedSources: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
+            apiKey?: string | null | undefined;
+            apiKeyEnv?: string | null | undefined;
+            baseUrl?: string | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
+            apiKey: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            apiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            baseUrl: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+        }>>, string>>, "volatile">;
+        exaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        exaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        jinaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        jinaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        bochaApiKey: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        bochaApiKeyEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        bochaBaseUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        bochaSummary: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        githubToken: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        githubTokenEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        searxngUrl: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        openalexMailto: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        cliAdapters: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<import("@deepseek-ai/cosmokit").Dict<any, string>, string>>, "volatile">;
         evidence: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
             scorer: import("@deepseek-ai/schemastery").default<"jev" | "rule", "jev" | "rule", "volatile-defined">;
             jevMode: import("@deepseek-ai/schemastery").default<"off" | "shadow" | "control" | "hybrid", "off" | "shadow" | "control" | "hybrid", "volatile-defined">;
@@ -947,6 +891,76 @@ declare const _default: {
                 }>>, string>, "plain">;
             }>>>, "volatile">;
         }>>, "plain">;
+        fetchDefaultChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        exaContentsPerUrlChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        exaContentsTotalChars: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        enableCliBackends: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        opencliEnabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        agentReachEnabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        twitterAuthToken: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        twitterAuthTokenEnv: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        twitterCt0: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        twitterCt0Env: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        playwright: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        }>>, Schemastery.ObjectT<NoInfer<{
+            enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+            snapshotDir: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
+        }>>, "plain">;
+        customPlatforms: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
+            name?: string | null | undefined;
+            url?: string | null | undefined;
+            item?: string | null | undefined;
+            title?: string | null | undefined;
+            link?: string | null | undefined;
+            text?: string | null | undefined;
+            cookie?: string | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
+            name: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            url: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            item: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            title: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            link: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            text: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            cookie: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+        }>>, string>>, "volatile">;
+        platformRules: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
+            item?: string | null | undefined;
+            title?: string | null | undefined;
+            link?: string | null | undefined;
+            text?: string | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
+            item: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            title: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            link: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            text: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+        }>>, string>>, "volatile">;
+        browserBindings: import("@deepseek-ai/schemastery").default<NoInfer<import("@deepseek-ai/cosmokit").Dict<{
+            authProfile?: string | null | undefined;
+            rulePack?: string | null | undefined;
+        } & import("@deepseek-ai/cosmokit").Dict, string>>, NoInfer<import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<NoInfer<{
+            authProfile: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+            rulePack: import("@deepseek-ai/schemastery").default<string, string, "plain">;
+        }>>, string>>, "volatile">;
+        providerId: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+        registerProvider: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+        provider: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        }>>, Schemastery.ObjectT<NoInfer<{
+            evidence: import("@deepseek-ai/schemastery").default<string, string, "volatile-defined">;
+            deadlineMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        }>>, "plain">;
+        timeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        ttlSeconds: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        memoryCacheEntries: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        rrfConstant: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        freshnessBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        freshnessDays: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        authorityBoost: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+        authorityDomains: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+        dbPath: import("@deepseek-ai/schemastery").default<string, string, "volatile">;
         verbose: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
     }>>, "plain">;
     apply: typeof apply;