dsh-web-search-pro 0.2.1 → 0.2.3

package/lib/providers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"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"}

package/lib/restart.js

@@ -0,0 +1,47 @@
+/**
+ * The settings that are read once, when the plugin starts. Almost every field of `Config` is live (the Host updates the entry's
+ * configuration in place and every call reads it through `dynamic()`), but these few are applied while the plugin is mounted:
+ * a database opened, a tool registered, a cache sized, a deadline fixed. The Host lets them be edited (they are volatile in
+ * the schema), so without a marker the edit looks like it was ignored until the next restart.
+ *
+ * One constant lists them; the settings card marks them, the save bar says so when a save touches one, and `sources.status` /
+ * `config.inspect` report "待重启" when the configured value differs from the one the running plugin started with. Pure and
+ * free of imports: the client bundle includes this file.
+ * @module web-search-pro/restart
+ */
+/** Why each field is read at start-up only (shown in the docs and the card's `?` text). */
+export const RESTART_FIELDS = {
+    toolSurface: 'the tools (web_index + web_call, or one tool per action) are registered at start-up',
+    'playwright.snapshotDir': 'the snapshot folder of read.snapshot is resolved at start-up',
+    providerId: 'the id of the ctx.web provider is given to the Host at registration',
+    registerProvider: 'the ctx.web provider is registered at start-up',
+    timeoutMs: 'the per-action deadlines and the Host tool ceiling are fixed at start-up (the cooperative time budget of a search reads it live)',
+    memoryCacheEntries: 'the in-process LRU cache is sized at start-up',
+    dbPath: 'the SQLite store and the overlay file are opened at start-up',
+    verbose: 'the load marker is written at start-up',
+};
+/** The field names, in the order of the configuration groups (config-groups.ts). */
+export const RESTART_FIELD_LIST = Object.keys(RESTART_FIELDS);
+export const isRestartField = (field) => Object.hasOwn(RESTART_FIELDS, field);
+/** The values of the restart fields as short text, from a resolved configuration. */
+export function restartValues(config) {
+    return {
+        dbPath: config.dbPath,
+        toolSurface: config.toolSurface,
+        registerProvider: String(config.registerProvider),
+        providerId: config.providerId,
+        verbose: String(config.verbose),
+        memoryCacheEntries: String(config.memoryCacheEntries),
+        timeoutMs: String(config.timeoutMs),
+        'playwright.snapshotDir': config.playwright.snapshotDir ?? '',
+    };
+}
+/** The restart fields whose configured value differs from the one the running plugin started with. */
+export function pendingRestart(mounted, current) {
+    return RESTART_FIELD_LIST.filter(field => mounted[field] !== current[field]).map(field => ({ field, running: mounted[field], configured: current[field] }));
+}
+/** `待重启：toolSurface（当前生效 indexed，配置为 flat）`, one line per field. */
+export function pendingRestartLine(entry) {
+    return '待重启：' + entry.field + '（当前生效 ' + (entry.running || '(空)') + '，配置为 ' + (entry.configured || '(空)') + '）';
+}
+//# sourceMappingURL=restart.js.map

package/lib/restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart.js","sourceRoot":"","sources":["../src/restart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,WAAW,EAAE,qFAAqF;IAClG,wBAAwB,EAAE,8DAA8D;IACxF,UAAU,EAAE,qEAAqE;IACjF,gBAAgB,EAAE,gDAAgD;IAClE,SAAS,EAAE,kIAAkI;IAC7I,kBAAkB,EAAE,+CAA+C;IACnE,MAAM,EAAE,8DAA8D;IACtE,OAAO,EAAE,wCAAwC;CACR,CAAA;AAI3C,oFAAoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAmB,CAAA;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAyB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;AAc5G,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACjD,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QAC/B,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACrD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,wBAAwB,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE;KAC9D,CAAA;AACH,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,cAAc,CAAC,OAA+C,EAAE,OAA+C;IAC7H,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;AAC7J,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,OAAO,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,QAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,OAAO,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,GAAG,CAAA;AACjH,CAAC"}

package/lib/router.js

@@ -4,10 +4,11 @@
  * @module web-search-pro/router
  */
 import { credentialRef } from '@deepseek-ai/dsh-credentials';
+import { effectiveChain } from "./default-chain.js";
 import { EngineError, } from "./engines.js";
 import { customCliAdapter, customCliProviderId, customKeyProblem, customPlatformAdapter } from "./providers/platforms.js";
-import { platformBackendIssues } from "./cli/chains-spec.js";
-import { resolveCliAdapters } from "./cli/spec.js";
+import { customCliPlatformIssues, isBackendId, platformBackendIssues } from "./cli/chains-spec.js";
+import { DEFAULT_CUSTOM_CONFIDENCE, resolveCliAdapters } from "./cli/spec.js";
 import { SourceUnavailableError } from "./providers/unavailable.js";
 import { defaultProviderRegistry, costTierOf, routeIdOf } from "./providers/index.js";
 import { BOCHA_FALLBACK_KEY_ENV, BOCHA_KEY_ENV } from "./providers/bocha.js";
@@ -24,8 +25,25 @@ import { createPlatformCacheKey, createSearchCacheKey } from "./cache-key.js";
 import { allAttemptsBenign, allAttemptsEmpty, BackendRegistry, NoBackendError } from "./backend-registry.js";
 import { ExaClient } from "./exa-client.js";
 import { SingleFlight } from "./singleflight.js";
-import { mergeCandidates } from "./pipeline/candidates.js";
+import { mergeCandidates, provenanceOf } from "./pipeline/candidates.js";
+import { guaranteeSeats } from "./pipeline/confidence.js";
 import { fuseCandidates } from "./pipeline/fusion.js";
+function originExtra(origin) {
+    return origin.via || origin.tag || origin.confidence !== undefined ? { origin } : {};
+}
+function originFromExtra(extra) {
+    if (!extra)
+        return {};
+    try {
+        const origin = JSON.parse(extra).origin;
+        return origin && typeof origin === 'object'
+            ? { ...typeof origin.via === 'string' ? { via: origin.via } : {}, ...typeof origin.tag === 'string' ? { tag: origin.tag } : {}, ...typeof origin.confidence === 'number' ? { confidence: origin.confidence } : {} }
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
 export class SearchRouter {
     ctx;
     config;
@@ -45,6 +63,8 @@ export class SearchRouter {
     /** User-defined CLI adapters (settings `cliAdapters`) this router registered as `custom-cli:<id>` platforms, with the diagnostics of the entries it ignored. */
     customCli = new Map();
     cliAdapterDiagnostics = [];
+    /** Confidence of each registered custom CLI by route id (its spec's, default 0.5), rebuilt with the registrations. */
+    customConfidence = new Map();
     /** Latest local probe per route id (read by providerStatuses for the credential dimension). */
     readiness = new Map();
     /** Last real call per route id: feeds the health dimension (never inferred from a local probe). */
@@ -112,6 +132,7 @@ export class SearchRouter {
     syncCustomCliAdapters() {
         const { specs, diagnostics } = resolveCliAdapters(this.dynamic().cliAdapters);
         this.cliAdapterDiagnostics = diagnostics;
+        this.customConfidence = new Map([...specs].map(([id, spec]) => [customCliProviderId(id), spec.confidence ?? DEFAULT_CUSTOM_CONFIDENCE]));
         const next = new Map([...specs].map(([id, spec]) => [id, JSON.stringify(spec)]));
         for (const [id, entry] of [...this.customCli])
             if (next.get(id) !== entry.sig) {
@@ -133,7 +154,7 @@ export class SearchRouter {
     cliAdapterProblems() {
         this.syncCustomPlatforms();
         const cfg = this.dynamic();
-        return [...this.cliAdapterDiagnostics, ...[...this.customCli.values()].flatMap(entry => (entry.problem ? [entry.problem] : [])), ...platformBackendIssues(cfg.platformBackends, cfg.cliAdapters)];
+        return [...this.cliAdapterDiagnostics, ...[...this.customCli.values()].flatMap(entry => (entry.problem ? [entry.problem] : [])), ...customCliPlatformIssues(cfg.cliAdapters), ...platformBackendIssues(cfg.platformBackends, cfg.cliAdapters)];
     }
     /** Custom platforms the registry could not take (key clash, bad key), for `sources.status`. */
     customPlatformProblems() {
@@ -192,7 +213,9 @@ export class SearchRouter {
                     const outcome = await engine.search(input.query, input.count, input.signal, this.withBindings(id, input.options));
                     ticket?.settle(1, 'request counted by the router (the adapter booked none)');
                     this.outcomes.set(id, { ok: true, at: new Date().toISOString() });
-                    return { ...outcome, via: outcome.via ?? engine.id };
+                    // The source's confidence rides with every row it returned (only when below 1: the built-in sources add nothing).
+                    const confidence = this.confidenceOf(id, outcome.backend);
+                    return { ...outcome, via: outcome.via ?? engine.id, ...confidence < 1 ? { sources: outcome.sources.map(source => ({ ...source, confidence })) } : {} };
                 }
                 catch (error) {
                     const code = error?.code;
@@ -255,17 +278,53 @@ export class SearchRouter {
         return { deps: await this.deps(false), config: this.dynamic(), ...cli ? { cli } : {} };
     }
     /**
-     * The configured `engines` list with the user's `sources.*` preferences applied: disabled sources removed, `priority` ones that are
-     * already in the list moved to the front in their listed order. An explicit `engines` of a call never goes through this.
+     * The default engine order for a search that names no `engines`: the configured `engines` list with the user's `sources.*`
+     * preferences applied, then the default rule for "常用" (common) sources.
+     *  1. an explicit `engines` of a call never comes through here;
+     *  2. `sources.disabled` ids are removed, `sources.priority` ids that are in the list move to the front in their listed order;
+     *  3. a common source (DeepSeek Search) whose key resolves leads what is left, while `engines` is still the default list (a
+     *     list the user wrote is theirs: it keeps its order, and a common source in it keeps the position given). `sources.disabled`
+     *     and `evidence.sourcePolicy: anonymous-only` switch it off.
      */
-    preferred(ids) {
-        const src = this.dynamic().sources;
-        const disabled = new Set(this.canonicalIds(src?.disabled ?? []));
-        const kept = ids.filter(id => !disabled.has(id));
-        if (ids.length && !kept.length)
-            throw new Error('every configured engine is disabled (sources.disabled): ' + ids.join(', '));
-        const first = this.canonicalIds(src?.priority ?? []).filter(id => kept.includes(id));
-        return [...first, ...kept.filter(id => !first.includes(id))];
+    async preferred(ids) {
+        const cfg = this.dynamic();
+        const src = cfg.sources;
+        return effectiveChain({
+            engines: ids,
+            priority: this.canonicalIds(src?.priority ?? []),
+            disabled: this.canonicalIds(src?.disabled ?? []),
+            anonymousOnly: cfg.evidence?.sourcePolicy === 'anonymous-only',
+            commonReady: await this.commonReady(),
+        });
+    }
+    /** Route ids of the common ("常用") sources that are ready to run now (key resolved), best `priority` first. */
+    async commonReady() {
+        const common = this.registry.list({ operation: 'search' }).filter(a => a.descriptor.common && a.descriptor.kind !== 'platform');
+        if (!common.length)
+            return [];
+        const env = await this.probeEnv();
+        const out = [];
+        for (const adapter of common) {
+            try {
+                const readiness = await adapter.probeLocal(env);
+                if (readiness.available && readiness.credential === 'configured')
+                    out.push({ id: routeIdOf(adapter.descriptor), priority: adapter.descriptor.priority ?? 100 });
+            }
+            catch { /* a probe that throws is not ready */ }
+        }
+        return out.sort((a, b) => a.priority - b.priority).map(x => x.id);
+    }
+    /**
+     * Key and endpoint of the DeepSeek Fetch API for the fetch pipeline, or undefined when no key resolves (settings literal ->
+     * DSH credentials ref -> process environment, the same order as the search side). Resolved per call; the key is never cached.
+     */
+    async deepseekAccess() {
+        const cfg = this.dynamic();
+        const { sourceKeys, sourceBaseUrls } = await this.keyedSources(cfg, (ref, literal) => this.resolveKey(ref, literal));
+        const apiKey = sourceKeys?.deepseek;
+        if (!apiKey)
+            return undefined;
+        return { apiKey, ...sourceBaseUrls?.deepseek ? { baseUrl: sourceBaseUrls.deepseek } : {}, allowProxyFakeIp: cfg.allowProxyFakeIp, usage: this.usageRecorder() };
     }
     /** Alias / full id -> route id; ids the registry does not know are kept as written (the backend then reports them unknown). */
     canonicalIds(ids) {
@@ -345,7 +404,7 @@ export class SearchRouter {
         try {
             const selected = await this.backends.runSelected({ query: call.query, count: call.count, signal: call.signal, skipSeam: opts.skipSeam ?? false, ...call.options ? { options: call.options } : {} }, { preferred: this.canonicalIds([call.id]), signal: call.signal });
             const sources = selected.value.sources;
-            return sources.length ? { state: 'ok', sources, ...selected.value.backend ? { backend: selected.value.backend } : {} } : { state: 'empty' };
+            return sources.length ? { state: 'ok', sources, ...selected.value.backend ? { backend: selected.value.backend } : {}, ...selected.value.notes?.length ? { notes: selected.value.notes } : {} } : { state: 'empty' };
         }
         catch (error) {
             if (call.signal.aborted)
@@ -363,6 +422,33 @@ export class SearchRouter {
             return { state: 'error', message: error instanceof Error ? error.message : String(error) };
         }
     }
+    /**
+     * The credential variables of the CLI adapters under the names the tools read, each resolved like the plugin's other secrets:
+     * settings literal -> DSH credentials ref (`twitterAuthTokenEnv`) -> process environment. Values only ever reach a command's environment.
+     */
+    async cliEnv() {
+        const cfg = this.dynamic();
+        const out = {};
+        const authToken = await this.resolveKey(cfg.twitterAuthTokenEnv ?? 'TWITTER_AUTH_TOKEN', cfg.twitterAuthToken);
+        const ct0 = await this.resolveKey(cfg.twitterCt0Env ?? 'TWITTER_CT0', cfg.twitterCt0);
+        if (authToken)
+            out.TWITTER_AUTH_TOKEN = authToken;
+        if (ct0)
+            out.TWITTER_CT0 = ct0;
+        return out;
+    }
+    /** Sync twin of {@link cliEnv} for `available()` checks: settings literal and process environment only. */
+    cliEnvSync() {
+        const cfg = this.dynamic();
+        const out = {};
+        const authToken = cfg.twitterAuthToken || process.env[cfg.twitterAuthTokenEnv ?? 'TWITTER_AUTH_TOKEN'];
+        const ct0 = cfg.twitterCt0 || process.env[cfg.twitterCt0Env ?? 'TWITTER_CT0'];
+        if (authToken)
+            out.TWITTER_AUTH_TOKEN = authToken;
+        if (ct0)
+            out.TWITTER_CT0 = ct0;
+        return out;
+    }
     /** Resolve a key through credentials first, then process env. */
     async resolveKey(ref, literal) {
         if (literal && literal.length > 0)
@@ -392,8 +478,10 @@ export class SearchRouter {
         const semanticScholarApiKey = await this.resolveKey(SEMANTICSCHOLAR_KEY_ENV);
         const anysearchApiKey = await this.resolveKey(ANYSEARCH_KEY_ENV);
         const keyed = await this.keyedSources(cfg, (ref, literal) => this.resolveKey(ref, literal));
+        const cliEnv = await this.cliEnv();
         return {
             ...keyed,
+            ...Object.keys(cliEnv).length ? { cliEnv } : {},
             ...openalexApiKey ? { openalexApiKey } : {},
             ...semanticScholarApiKey ? { semanticScholarApiKey } : {},
             ...anysearchApiKey ? { anysearchApiKey } : {},
@@ -430,8 +518,10 @@ export class SearchRouter {
         const semanticScholarApiKey = process.env[SEMANTICSCHOLAR_KEY_ENV];
         const anysearchApiKey = process.env[ANYSEARCH_KEY_ENV];
         const keyed = this.keyedSourcesSync(cfg);
+        const cliEnv = this.cliEnvSync();
         return {
             ...keyed,
+            ...Object.keys(cliEnv).length ? { cliEnv } : {},
             ...openalexApiKey ? { openalexApiKey } : {},
             ...semanticScholarApiKey ? { semanticScholarApiKey } : {},
             ...anysearchApiKey ? { anysearchApiKey } : {},
@@ -512,8 +602,31 @@ export class SearchRouter {
     }
     /** Problems of the `sources.*` settings (unknown ids, bad numbers), for `sources.status`. */
     sourceDiagnostics() {
+        this.syncCustomPlatforms();
         const src = this.dynamic().sources;
-        return resolveSources({ priority: src?.priority, disabled: src?.disabled, budget: src?.budget }, id => this.registry.routeId(id) !== undefined).diagnostics;
+        return resolveSources({ priority: src?.priority, disabled: src?.disabled, budget: src?.budget, confidence: src?.confidence }, id => this.registry.routeId(id) !== undefined, isBackendId).diagnostics;
+    }
+    /** The confidence of one platform backend as a leg of a chain (`xhs`, `custom-cli:echo`): its own, without the provider's. */
+    backendConfidenceOf(id) {
+        return this.confidenceOf(id);
+    }
+    /** `sources.confidence` by canonical id (a provider's route id; a platform backend id as written), valid entries only. */
+    confidenceOverrides() {
+        const resolved = resolveSources({ confidence: this.dynamic().sources?.confidence }, id => this.registry.routeId(id) !== undefined, isBackendId);
+        return new Map(Object.entries(resolved.confidence).map(([id, value]) => [this.registry.routeId(id) ?? id, value]));
+    }
+    /**
+     * The confidence (0..1) of what `route` returned, through `backend` when it is a platform chain: `sources.confidence` of the
+     * provider times that of the backend that answered, each defaulting to the custom CLI's own (spec `confidence`, 0.5) and to 1
+     * for every built-in source, so the built-in ones are 1 unless the user set something.
+     */
+    confidenceOf(route, backend) {
+        this.syncCustomPlatforms();
+        const overrides = this.confidenceOverrides();
+        const own = (id) => overrides.get(id) ?? this.customConfidence.get(id) ?? 1;
+        const provider = this.registry.routeId(route) ?? route;
+        const via = backend === undefined || backend === provider ? undefined : this.registry.routeId(backend) ?? backend;
+        return Math.round(own(provider) * (via === undefined ? 1 : own(via)) * 10_000) / 10_000;
     }
     /** Counts a metered, non-model request (Bocha search) in the usage ledger; best effort, never throws into the search. */
     usageRecorder() {
@@ -584,7 +697,7 @@ export class SearchRouter {
             if (adapter.chain) {
                 try {
                     chainReport = await adapter.chain(env);
-                    chain = chainReport.entries;
+                    chain = chainReport.entries.map(entry => ({ ...entry, confidence: this.backendConfidenceOf(entry.id) }));
                 }
                 catch {
                     chain = undefined;
@@ -596,6 +709,8 @@ export class SearchRouter {
                 ...d.sourceFamily ? { sourceFamily: d.sourceFamily } : {},
                 requirements: d.requirements.map(({ env, ...r }) => ({ ...r, ...env ? { env: [...env] } : {} })), supportedFilters: [...d.supportedFilters], costModel: { ...d.costModel }, costTier: local.costTier ?? costTierOf(d),
                 ...d.verification?.live ? {} : { unverified: true },
+                ...d.common ? { common: true } : {},
+                confidence: this.confidenceOf(route),
                 ...chain ? { chain } : {},
                 ...this.requestBudgetOf(route) ? { budget: this.requestBudgetOf(route) } : {},
                 readiness: {
@@ -623,7 +738,7 @@ export class SearchRouter {
         const query = platform ? platform.query : opts.query.trim();
         if (!platform && !query)
             throw new Error('query must be a non-empty string');
-        const ids = platform ? [platform.id] : opts.engines && opts.engines.length ? this.canonicalIds(opts.engines) : this.preferred(this.canonicalIds(cfg.engines));
+        const ids = platform ? [platform.id] : opts.engines && opts.engines.length ? this.canonicalIds(opts.engines) : await this.preferred(this.canonicalIds(cfg.engines));
         const nq = normQuery(platform ? query || platform.url || platform.id : query);
         const count = Math.min(Math.max(opts.count, 1), 20);
         const multi = !platform && opts.multi && ids.length > 1;
@@ -676,7 +791,7 @@ export class SearchRouter {
                 if (detail?.requestedCount === undefined || detail.requestedCount >= count) {
                     const result = {
                         ...detail?.content ? { content: detail.content } : {},
-                        sources: shapeSources(cached.rows.map(r => ({ url: r.url, title: r.title, snippet: r.snippet, publishedAt: r.published })), count),
+                        sources: shapeSources(cached.rows.map(r => ({ url: r.url, title: r.title, snippet: r.snippet, publishedAt: r.published, ...originFromExtra(r.extra) })), count),
                         engine: detail?.engine ?? ids[0] ?? 'unknown',
                         enginesTried: detail?.enginesTried ?? ids,
                         fromCache: true,
@@ -724,18 +839,19 @@ export class SearchRouter {
                 throw new Error('all engines failed: ' + failures);
             }
             const merged = mergeCandidates(outputs);
-            const ranked = fuseCandidates(merged, {
+            // A source with a confidence below 1 weighs a little less in the fusion, and its best result keeps a place in the list (confidence.ts).
+            const ranked = guaranteeSeats(fuseCandidates(merged, {
                 k: cfg.rrfConstant,
                 freshnessBoost: cfg.freshnessBoost,
                 freshnessDays: cfg.freshnessDays,
                 authorityBoost: cfg.authorityBoost,
                 authorityDomains: cfg.authorityDomains,
                 nProviders: outputs.length,
-            }).slice(0, count);
+            }), count, ranked => ranked.candidate.contributions).slice(0, count);
             availableCount = merged.length;
-            outcome = { sources: ranked.map(({ candidate }) => ({ url: candidate.url, ...candidate.title ? { title: candidate.title } : {}, ...candidate.snippet ? { snippet: candidate.snippet } : {}, ...candidate.publishedAt ? { publishedAt: candidate.publishedAt } : {} })) };
-            // Per-source provenance survives in results.extra (no schema change); the cache-hit path ignores it.
-            persistExtras = ranked.map(({ candidate, score }) => JSON.stringify({ contributions: candidate.contributions, score: Number(score.toFixed(6)) }));
+            outcome = { sources: ranked.map(({ candidate }) => ({ url: candidate.url, ...candidate.title ? { title: candidate.title } : {}, ...candidate.snippet ? { snippet: candidate.snippet } : {}, ...candidate.publishedAt ? { publishedAt: candidate.publishedAt } : {}, ...provenanceOf(candidate) })) };
+            // Per-source provenance survives in results.extra (no schema change); a cache hit reads back the origin (`via`, `tag`, `confidence`) from it.
+            persistExtras = ranked.map(({ candidate, score }) => JSON.stringify({ contributions: candidate.contributions, score: Number(score.toFixed(6)), ...originExtra(provenanceOf(candidate)) }));
             usedId = 'multi(' + ids.join('+') + ')';
         }
         else {
@@ -800,7 +916,10 @@ export class SearchRouter {
             status: 'ok',
             cacheKey,
             detail: JSON.stringify({ ...finalOutcome.content ? { content: finalOutcome.content } : {}, engine: finalId, ...backendId ? { backend: backendId } : {}, enginesTried, requestedCount: count, ...fallbackNote ? { fallbackNote } : {} }),
-        }, persistExtras ? finalOutcome.sources.map((source, i) => ({ ...source, extra: persistExtras[i] })) : finalOutcome.sources, platform ? 'platform-' + platform.id : finalId));
+        }, finalOutcome.sources.map((source, i) => {
+            const extra = persistExtras ? persistExtras[i] : JSON.stringify(originExtra({ ...source.via ? { via: source.via } : {}, ...source.tag ? { tag: source.tag } : {}, ...source.confidence !== undefined ? { confidence: source.confidence } : {} }));
+            return extra === '{}' ? source : { ...source, extra };
+        }), platform ? 'platform-' + platform.id : finalId));
         const result = {
             ...outcome.content ? { content: outcome.content } : {},
             sources: shapeSources(outcome.sources, count),