@zhixuan92/multi-model-agent-core 4.7.8 → 4.7.9

package/dist/research/evidence-pack.js

@@ -0,0 +1,132 @@
+// EvidencePack types + deterministic truncation policy per spec §5.3 / §5.4.
+export const EVIDENCE_PACK_LIMITS = Object.freeze({
+    MAX_TOTAL_BYTES: 48 * 1024,
+    MAX_PER_GROUP: 10,
+    MAX_SNIPPET_CHARS: 500,
+    MAX_TOTAL_SOURCES: 50,
+});
+// Drop priority: lowest-priority group dropped first.
+const DROP_PRIORITY = [
+    'brave', 'rss', 'web_fetch',
+    'github_code', 'github_repo', 'semantic_scholar', 'arxiv',
+];
+// Within a group, priority is preserved by input order (highest first).
+function groupPriority(group) {
+    return DROP_PRIORITY.indexOf(group);
+}
+export function dedupSources(input) {
+    // Sort so highest-priority (latest in DROP_PRIORITY) wins on URL collision.
+    const sorted = [...input].sort((a, b) => groupPriority(b.source) - groupPriority(a.source));
+    const seen = new Set();
+    const kept = [];
+    for (const s of sorted) {
+        if (!s.url || seen.has(s.url))
+            continue;
+        seen.add(s.url);
+        kept.push(s);
+    }
+    return kept;
+}
+export function applyBudget(inputSources, failedAttempts) {
+    let budgetExceeded = false;
+    // 1. Dedup.
+    let sources = dedupSources(inputSources);
+    // 2. Per-group cap.
+    const perGroup = new Map();
+    for (const s of sources) {
+        if (!perGroup.has(s.source))
+            perGroup.set(s.source, []);
+        perGroup.get(s.source).push(s);
+    }
+    let totalAfterCap = 0;
+    for (const [, list] of perGroup) {
+        if (list.length > EVIDENCE_PACK_LIMITS.MAX_PER_GROUP) {
+            list.length = EVIDENCE_PACK_LIMITS.MAX_PER_GROUP;
+            budgetExceeded = true;
+        }
+        totalAfterCap += list.length;
+    }
+    sources = [].concat(...perGroup.values());
+    // 3. Total-sources cap. Drop lowest-priority groups first.
+    while (sources.length > EVIDENCE_PACK_LIMITS.MAX_TOTAL_SOURCES) {
+        budgetExceeded = true;
+        let dropped = false;
+        for (const g of DROP_PRIORITY) {
+            const idx = sources.findIndex(s => s.source === g);
+            if (idx >= 0) {
+                sources.splice(idx, 1);
+                dropped = true;
+                break;
+            }
+        }
+        if (!dropped)
+            break;
+    }
+    // 4. Total-bytes cap (on original data). Estimate serialized size; drop lowest-priority first.
+    function bytes(arr) {
+        let n = 0;
+        for (const s of arr) {
+            n += s.title.length + s.url.length + s.snippet.length + s.query.length + 100;
+        }
+        return n;
+    }
+    while (bytes(sources) > EVIDENCE_PACK_LIMITS.MAX_TOTAL_BYTES) {
+        budgetExceeded = true;
+        let dropped = false;
+        for (const g of DROP_PRIORITY) {
+            const idx = sources.findIndex(s => s.source === g);
+            if (idx >= 0) {
+                sources.splice(idx, 1);
+                dropped = true;
+                break;
+            }
+        }
+        if (!dropped)
+            break;
+    }
+    // 5. Truncate snippets to MAX_SNIPPET_CHARS.
+    sources = sources.map(s => {
+        if (s.snippet.length <= EVIDENCE_PACK_LIMITS.MAX_SNIPPET_CHARS)
+            return s;
+        return {
+            ...s,
+            snippet: s.snippet.slice(0, EVIDENCE_PACK_LIMITS.MAX_SNIPPET_CHARS) + '…',
+        };
+    });
+    return {
+        sources,
+        failedAttempts: [...failedAttempts],
+        generatedAt: new Date().toISOString(),
+        totalQueries: inputSources.length,
+        budgetExceeded,
+    };
+}
+export function serializeEvidencePack(pack) {
+    const lines = [];
+    lines.push(`## Sources (${pack.sources.length})`);
+    if (pack.budgetExceeded) {
+        lines.push('> _Note: evidence-pack budget was exceeded; some sources were dropped per priority policy._');
+    }
+    lines.push('');
+    for (const s of pack.sources) {
+        lines.push(`### [${s.source}] ${s.title}`);
+        lines.push(`- URL: ${s.url}`);
+        lines.push(`- Query: ${s.query}`);
+        if (s.publishedAt)
+            lines.push(`- Published: ${s.publishedAt}`);
+        lines.push('');
+        lines.push(s.snippet);
+        lines.push('');
+    }
+    if (pack.failedAttempts.length > 0) {
+        lines.push('## Sources that failed');
+        lines.push('');
+        for (const f of pack.failedAttempts) {
+            const detail = f.detail ? ` — ${f.detail}` : '';
+            lines.push(`- [${f.source}] query="${f.query}" reason=${f.reason}${detail}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=evidence-pack.js.map

package/dist/research/evidence-pack.js.map

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

package/dist/research/index.d.ts

@@ -1,3 +1,2 @@
-export * from './web-search.js';
-export * from './web-fetch.js';
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/research/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC"}

package/dist/research/index.js

@@ -1,4 +1,2 @@
-// research/index.ts — public surface barrel; per architecture.md:262-275.
-export * from './web-search.js';
-export * from './web-fetch.js';
+export {};
 //# sourceMappingURL=index.js.map

package/dist/research/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":""}

package/dist/research/orchestrator.d.ts

@@ -0,0 +1,24 @@
+import type { QueryPlan } from './query-plan.js';
+import { type EvidencePack } from './evidence-pack.js';
+import type { AdapterId, AdapterResult } from './adapters/types.js';
+import type { BraveSearchResponse } from './web-search.js';
+import type { WebFetchResult } from './web-fetch.js';
+export interface OrchestratorDeps {
+    enabledAdapters: AdapterId[];
+    brave: {
+        search: (query: string) => Promise<BraveSearchResponse>;
+    };
+    adapters: {
+        arxiv: (query: string) => Promise<AdapterResult[]>;
+        semanticScholar: (query: string) => Promise<AdapterResult[]>;
+        github: (query: string, kind: 'repo' | 'code') => Promise<AdapterResult[]>;
+        rss: (url: string) => Promise<AdapterResult[]>;
+    };
+    webFetch: (url: string) => Promise<WebFetchResult>;
+    hostAllowlist: Set<string>;
+    perAdapterTimeoutMs: number;
+    totalDeadlineMs: number;
+    concurrencyCap: number;
+}
+export declare function runOrchestrator(plan: QueryPlan, deps: OrchestratorDeps): Promise<EvidencePack>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/research/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/research/orchestrator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACQ,KAAK,YAAY,EAE/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7B,KAAK,EAAK;QAAE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAA;KAAE,CAAC;IACtE,QAAQ,EAAE;QACR,KAAK,EAAY,CAAC,KAAK,EAAE,MAAM,KAA6B,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACrF,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAA6B,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACrF,MAAM,EAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACpF,GAAG,EAAc,CAAC,GAAG,EAAE,MAAM,KAAgC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;KACvF,CAAC;IACF,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACnD,aAAa,EAAS,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,mBAAmB,EAAG,MAAM,CAAC;IAC7B,eAAe,EAAO,MAAM,CAAC;IAC7B,cAAc,EAAQ,MAAM,CAAC;CAC9B;AAmID,wBAAsB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBpG"}

package/dist/research/orchestrator.js

@@ -0,0 +1,162 @@
+//
+// Step 2 of the /research pipeline. Deterministic Node-only fan-out across
+// enabled adapters + Brave + webFetch + RSS, with per-adapter timeout,
+// concurrency cap scoped to this single call, allowlist enforcement on
+// every outbound hop (directFetches + rssFeeds), and post-budget evidence
+// pack assembly.
+import { applyBudget, } from './evidence-pack.js';
+const TASK_TO_GROUP = {
+    brave: 'brave',
+    arxiv: 'arxiv',
+    ss: 'semantic_scholar',
+    gh_repo: 'github_repo',
+    gh_code: 'github_code',
+    rss: 'rss',
+    fetch: 'web_fetch',
+};
+function buildTasks(plan) {
+    const tasks = [];
+    for (const q of plan.braveQueries)
+        tasks.push({ kind: 'brave', query: q });
+    for (const q of plan.arxivQueries)
+        tasks.push({ kind: 'arxiv', query: q });
+    for (const q of plan.semanticScholarQueries)
+        tasks.push({ kind: 'ss', query: q });
+    for (const g of plan.githubQueries)
+        tasks.push({ kind: g.kind === 'repo' ? 'gh_repo' : 'gh_code', query: g.q });
+    for (const u of plan.rssFeeds)
+        tasks.push({ kind: 'rss', url: u });
+    for (const u of plan.directFetches)
+        tasks.push({ kind: 'fetch', url: u });
+    return tasks;
+}
+function isAdapterEnabled(kind, enabled) {
+    switch (kind) {
+        case 'arxiv': return enabled.includes('arxiv');
+        case 'ss': return enabled.includes('semantic_scholar');
+        case 'gh_repo':
+        case 'gh_code': return enabled.includes('github_search');
+        case 'rss': return enabled.includes('rss');
+        case 'brave': return true;
+        case 'fetch': return true;
+    }
+}
+function withTimeout(p, ms) {
+    return new Promise((resolve, reject) => {
+        const t = setTimeout(() => reject(new Error('timeout')), ms);
+        p.then(v => { clearTimeout(t); resolve(v); }, e => { clearTimeout(t); reject(e); });
+    });
+}
+function isHostAllowed(url, allowlist) {
+    try {
+        const host = new URL(url).hostname.toLowerCase();
+        return allowlist.has(host);
+    }
+    catch {
+        return false;
+    }
+}
+async function runOne(task, deps, sources, fails) {
+    if (!isAdapterEnabled(task.kind, deps.enabledAdapters)) {
+        fails.push({
+            source: TASK_TO_GROUP[task.kind],
+            query: 'query' in task ? task.query : task.url,
+            reason: 'no_api_key_configured',
+        });
+        return;
+    }
+    // Allowlist enforcement on outbound hops.
+    if (task.kind === 'rss' || task.kind === 'fetch') {
+        if (!isHostAllowed(task.url, deps.hostAllowlist)) {
+            fails.push({
+                source: TASK_TO_GROUP[task.kind],
+                query: task.url,
+                reason: 'host_not_allowlisted',
+            });
+            return;
+        }
+    }
+    const queryStr = 'query' in task ? task.query : task.url;
+    try {
+        let raw;
+        switch (task.kind) {
+            case 'brave':
+                raw = await withTimeout(deps.brave.search(task.query), deps.perAdapterTimeoutMs);
+                break;
+            case 'arxiv':
+                raw = await withTimeout(deps.adapters.arxiv(task.query), deps.perAdapterTimeoutMs);
+                break;
+            case 'ss':
+                raw = await withTimeout(deps.adapters.semanticScholar(task.query), deps.perAdapterTimeoutMs);
+                break;
+            case 'gh_repo':
+                raw = await withTimeout(deps.adapters.github(task.query, 'repo'), deps.perAdapterTimeoutMs);
+                break;
+            case 'gh_code':
+                raw = await withTimeout(deps.adapters.github(task.query, 'code'), deps.perAdapterTimeoutMs);
+                break;
+            case 'rss':
+                raw = await withTimeout(deps.adapters.rss(task.url), deps.perAdapterTimeoutMs);
+                break;
+            case 'fetch':
+                raw = await withTimeout(deps.webFetch(task.url), deps.perAdapterTimeoutMs);
+                break;
+        }
+        // Normalize each task's result to EvidenceSource[].
+        if (task.kind === 'brave') {
+            const br = raw;
+            br.results.forEach((r, i) => sources.push({
+                source: 'brave', query: queryStr,
+                title: r.title, url: r.url, snippet: r.snippet, rank: i,
+            }));
+        }
+        else if (task.kind === 'fetch') {
+            const r = raw;
+            if (r.status === 'ok') {
+                sources.push({
+                    source: 'web_fetch', query: queryStr,
+                    title: `[fetched ${r.host}]`, url: queryStr,
+                    snippet: r.rawText.slice(0, 500), rank: 0,
+                });
+            }
+            else {
+                fails.push({ source: 'web_fetch', query: queryStr, reason: r.reasonCode });
+            }
+        }
+        else {
+            const arr = raw;
+            arr.forEach((a, i) => sources.push({
+                source: TASK_TO_GROUP[task.kind], query: queryStr,
+                title: a.title, url: a.url, snippet: a.snippet,
+                publishedAt: a.publishedAt, rank: i,
+            }));
+        }
+    }
+    catch (e) {
+        fails.push({
+            source: TASK_TO_GROUP[task.kind], query: queryStr,
+            reason: e.message || 'unknown',
+        });
+    }
+}
+export async function runOrchestrator(plan, deps) {
+    const tasks = buildTasks(plan);
+    const sources = [];
+    const fails = [];
+    let cursor = 0;
+    const workers = [];
+    const worker = async () => {
+        while (true) {
+            const idx = cursor++;
+            if (idx >= tasks.length)
+                return;
+            await runOne(tasks[idx], deps, sources, fails);
+        }
+    };
+    for (let i = 0; i < Math.min(deps.concurrencyCap, tasks.length); i++) {
+        workers.push(worker());
+    }
+    await Promise.all(workers);
+    return applyBudget(sources, fails);
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/research/orchestrator.js.map

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

package/dist/research/query-plan.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const QueryPlanSchema: z.ZodObject<{
+    braveQueries: z.ZodArray<z.ZodString>;
+    arxivQueries: z.ZodArray<z.ZodString>;
+    semanticScholarQueries: z.ZodArray<z.ZodString>;
+    githubQueries: z.ZodArray<z.ZodObject<{
+        q: z.ZodString;
+        kind: z.ZodEnum<{
+            code: "code";
+            repo: "repo";
+        }>;
+    }, z.core.$strip>>;
+    rssFeeds: z.ZodArray<z.ZodString>;
+    directFetches: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type QueryPlan = z.infer<typeof QueryPlanSchema>;
+export declare function parseQueryPlan(json: string): QueryPlan;
+//# sourceMappingURL=query-plan.d.ts.map

package/dist/research/query-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-plan.d.ts","sourceRoot":"","sources":["../../src/research/query-plan.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;kBAUjB,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAYtD"}

package/dist/research/query-plan.js

@@ -0,0 +1,36 @@
+// Zod schema for the structured output the worker emits in turn 1.
+// Bounds: 0..8 entries per query list, ≤ 200 chars per query, only
+// absolute https URLs for rssFeeds and directFetches.
+import { z } from 'zod';
+const Query200 = z.string().min(1).max(200);
+const Queries = z.array(Query200).max(8);
+const HttpsUrl = z.string().url().refine(u => u.startsWith('https://'), {
+    message: 'must be an absolute https:// URL',
+});
+const HttpsUrls = z.array(HttpsUrl).max(8);
+export const QueryPlanSchema = z.object({
+    braveQueries: Queries,
+    arxivQueries: Queries,
+    semanticScholarQueries: Queries,
+    githubQueries: z.array(z.object({
+        q: Query200,
+        kind: z.enum(['repo', 'code']),
+    })).max(8),
+    rssFeeds: HttpsUrls,
+    directFetches: HttpsUrls,
+}).strict();
+export function parseQueryPlan(json) {
+    let raw;
+    try {
+        raw = JSON.parse(json);
+    }
+    catch (e) {
+        throw new Error(`QueryPlan JSON parse failed: ${e.message}`);
+    }
+    const r = QueryPlanSchema.safeParse(raw);
+    if (!r.success) {
+        throw new Error(`QueryPlan schema validation failed: ${r.error.message}`);
+    }
+    return r.data;
+}
+//# sourceMappingURL=query-plan.js.map

package/dist/research/query-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-plan.js","sourceRoot":"","sources":["../../src/research/query-plan.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,mEAAmE;AACnE,sDAAsD;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5C,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACzC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;IACtE,OAAO,EAAE,kCAAkC;CAC5C,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,YAAY,EAAY,OAAO;IAC/B,YAAY,EAAY,OAAO;IAC/B,sBAAsB,EAAE,OAAO;IAC/B,aAAa,EAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACvC,CAAC,EAAK,QAAQ;QACd,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACV,QAAQ,EAAgB,SAAS;IACjC,aAAa,EAAW,SAAS;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAiC,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC;AAChB,CAAC"}

package/dist/research/user-agent.d.ts

@@ -0,0 +1,5 @@
+export declare const USER_AGENT: string;
+export declare function _resetForTests(fakePkg: {
+    version?: unknown;
+}): Promise<string>;
+//# sourceMappingURL=user-agent.d.ts.map

package/dist/research/user-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.d.ts","sourceRoot":"","sources":["../../src/research/user-agent.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,UAAU,EAAE,MAAwD,CAAC;AAGlF,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpF"}

package/dist/research/user-agent.js

@@ -0,0 +1,17 @@
+// Single source of truth for the User-Agent header sent by every outbound
+// adapter, brave, and webFetch HTTP request from this package.
+import pkg from '../../package.json' with { type: 'json' };
+const SEMVER_RE = /^\d+\.\d+\.\d+/;
+const FALLBACK = 'mma-research/0.0.0-unknown';
+function compose(version) {
+    if (typeof version !== 'string' || !SEMVER_RE.test(version)) {
+        return FALLBACK;
+    }
+    return `mma-research/${version.match(SEMVER_RE)[0]}`;
+}
+export const USER_AGENT = compose(pkg.version);
+// Test seam — exported only for unit tests; do not call from production code.
+export async function _resetForTests(fakePkg) {
+    return compose(fakePkg.version);
+}
+//# sourceMappingURL=user-agent.js.map

package/dist/research/user-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-agent.js","sourceRoot":"","sources":["../../src/research/user-agent.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+DAA+D;AAC/D,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3D,MAAM,SAAS,GAAG,gBAAgB,CAAC;AACnC,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AAE9C,SAAS,OAAO,CAAC,OAAgB;IAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,gBAAgB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAW,OAAO,CAAE,GAA6B,CAAC,OAAO,CAAC,CAAC;AAElF,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IACjE,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/research/web-fetch.d.ts

@@ -4,38 +4,21 @@ export interface WebFetchInput {
     url: string;
     cfg: ResearchConfig['fetch'];
     hostAllowlist: ReadonlySet<string>;
-    /** Hosts in this set may resolve to RFC1918 private addresses (still rejects loopback/metadata). */
     privateNetworkHosts?: ReadonlySet<string>;
-    /** Test seam — replaces DNS resolution. */
     resolveIP?: (host: string) => Promise<string>;
-    /**
-     * Test seam — return undefined to let undici use the global dispatcher (so
-     * MockAgent intercepts in tests). Default in prod builds an IP-pinning Agent
-     * per spec §7.1.10 with TLS SNI on the original hostname.
-     *
-     * Ownership: dispatchers returned by this hook are caller-owned/shared and
-     * will not be closed or destroyed by webFetch. The default dispatcher created
-     * by webFetch is one-shot and is disposed after its request completes.
-     */
+    /** Test seam — when present, treated as the IP that the connect callback
+     *  "resolved" at request time. Production must not pass this. */
+    _testConnectResolvedIp?: string;
+    /** @deprecated kept for callers that explicitly opt out; unused in prod */
     createDispatcher?: (host: string, pinnedIP: string, cfg: ResearchConfig['fetch']) => import('undici').Dispatcher | undefined;
 }
-export declare const defaultIPPinningDispatcher: (host: string, pinnedIP: string, cfg: ResearchConfig["fetch"]) => Agent;
 export type WebFetchOk = {
     status: 'ok';
-    /** Worker-facing string: <external-content …>extracted-text</external-content> */
     body: string;
-    /** Adapter-facing raw text (HTML stripped to main-text for HTML; raw bytes for XML/JSON). NOT wrapped. */
     rawText: string;
     host: string;
     bytesReturned: number;
-    /** True if the wire-level read was capped by cfg.maxBodyBytes (raw response truncated). */
     truncated: boolean;
-    /**
-     * True if the post-extraction text was capped by RETURNED_TEXT_CAP (default 64 KiB).
-     * Adapters that parse rawText (e.g. rss) MUST inspect this flag — a true value
-     * means the XML/JSON body may be syntactically incomplete and parsing should be skipped.
-     * This is independent of truncated; both can be true if both caps tripped.
-     */
     textTruncated: boolean;
     credentialsStripped: boolean;
 };
@@ -46,5 +29,7 @@ export type WebFetchErr = {
     credentialsStripped: boolean;
 };
 export type WebFetchResult = WebFetchOk | WebFetchErr;
+/** @deprecated — kept for test compatibility; no longer used in production. */
+export declare const defaultIPPinningDispatcher: (host: string, pinnedIP: string, cfg: ResearchConfig["fetch"]) => Agent;
 export declare function webFetch(input: WebFetchInput): Promise<WebFetchResult>;
 //# sourceMappingURL=web-fetch.d.ts.map

package/dist/research/web-fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/research/web-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkB1D,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7B,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,oGAAoG;IACpG,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,2CAA2C;IAC3C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,OAAO,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9H;AAED,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,EAAE,KAAK,cAAc,CAAC,OAAO,CAAC,UAQnG,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,IAAI,CAAC;IACb,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AActD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CA6K5E"}
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/research/web-fetch.ts"],"names":[],"mappings":"AASA,OAAO,EAAW,KAAK,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAW1D,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAkB,MAAM,CAAC;IAC5B,GAAG,EAAkB,cAAc,CAAC,OAAO,CAAC,CAAC;IAC7C,aAAa,EAAQ,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAW,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD;qEACiE;IACjE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,OAAO,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9H;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAClE,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAC;CAClF,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAStD,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,EAAE,KAAK,cAAc,CAAC,OAAO,CAAC,UAQnG,CAAC;AA6CL,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAoJ5E"}