infobroker 2026.8.24 → 2026.9.2

package/README.md

@@ -25,7 +25,8 @@ README DESIGN:
   Structure: Hero → North Star → Quick Start → MCP Server (§3 features) →
     Skills → Providers → Configuration → How It Compares → Contribute →
     License → Spec. No other ordering. Canonical h2 headings are enforced
-    by validate-readme.
+    by validate-readme. A TOC listing the canonical h2 sections follows the
+    Hero; validate-readme enforces TOC↔heading sync.
 
   Audience split: §2 is for developers who want to start the server.
     §3 describes what users can do with it. The Skills section (§3.5)
@@ -85,7 +86,7 @@ README DESIGN:
     document, or a changelog. The complete tool inventory lives in the
     feature taxonomy (§D of infobroker.md), which the README links to.
     Tool names appear in prose only as shorthand in backticks where a
-    feature is introduced (e.g. `kb`), never as a bare list.
+    feature is introduced (e.g. `manage_kb`), never as a bare list.
 
   Validator. Rules marked "(validate-readme)" SHALL be checked by
     scripts/validate-readme.ts. Other rules are enforced by author/AI
@@ -122,6 +123,17 @@ sources to separate established facts from contested claims. Bundled
 client skills transform raw research into polished writing. Free first.
 Privacy always.
 
+- [North Star](#north-star)
+- [Quick Start](#quick-start)
+- [MCP Server](#mcp-server)
+- [Skills](#skills)
+- [Providers](#providers)
+- [Configuration](#configuration)
+- [How It Compares](#how-it-compares)
+- [Contribute](#contribute)
+- [License](#license)
+- [Spec](#spec)
+
 ## North Star
 
 Infobroker is the [Bothan Spynet](https://starwars.fandom.com/wiki/Bothan_Spynet/Legends) as a tool — a decentralized intelligence
@@ -179,7 +191,7 @@ Requirements: Node.js 20+.
 
 ## MCP Server
 
-Your research backend. Six tools, twenty providers, one
+Your research backend. Seven tools, twenty providers, one
 corroboration engine. The complete feature inventory is documented in the
 [feature taxonomy](infobroker.md#d-appendix-feature-taxonomy) in the
 spec.
@@ -188,26 +200,43 @@ spec.
 
 > "Search for the location of the second Death Star."
 > "Find scholarly papers on hyperspace travel theories."
+> "Search the latest astromech specs and show me the passages that answer: does the R2 unit pre-date the Clone Wars?"
 
 `web_search` sends one query to every provider that can answer it. Search
 across DuckDuckGo, Wikipedia, academic databases, news, code repositories —
-or describe your task and the server picks the best source. Failed providers fall
-back silently through a configurable chain so you get results, not
-error messages. Other search tools lock you to one engine; Infobroker
-routes every query to the right provider and keeps going when one
+or describe your task and the server picks the best source. Pass an array of
+queries to batch several searches in one call. Ask for a deep read and it
+fetches the top results and ranks each page's passages against your query,
+so you get the specific text that answers the question instead of links.
+Failed providers fall back silently through a configurable chain so you get
+results, not error messages. Other search tools lock you to one engine;
+Infobroker routes every query to the right provider and keeps going when one
 fails.
 
 ### Content Extraction
 
 > "Fetch the article on the Battle of Yavin and summarize it."
 > "Get the text of that page about the Death Star plans."
+> "Where, in that report, does it mention the reactor core?"
 
 `fetch_page` hands any URL to Jina Reader, which renders it as clean
 Markdown optimized for LLM consumption. Falls back to native HTTP when
 Jina is throttled. Wikipedia and Internet Archive have dedicated
-renderers for source-specific extraction. Built-in web fetchers return
-raw HTML; Infobroker gives you clean, readable content from any source —
-ready for summarization or analysis.
+renderers for source-specific extraction. Ask a page a question — pass
+`question` to `fetch_page` and it returns the passages that answer it, each
+scored and ranked, instead of the whole document. Built-in web fetchers
+return raw HTML; Infobroker gives you clean, readable content from any
+source — ready for summarization or analysis. Fetch also reports the page's
+last-updated date when it can determine one, so you know how current your
+source is.
+
+### Citations
+
+> "Give me BibTeX references for papers on hyperdrive field dynamics."
+
+`get_citations` searches scholarly sources and returns each reference as a formatted
+BibTeX entry with its fields — title, authors, year, venue, and URL — ready
+to paste into a reference list.
 
 ### Provider Intelligence
 
@@ -217,7 +246,7 @@ ready for summarization or analysis.
 The server knows its own capabilities. `web_search` auto-selects the
 best backend for your task, weighing capability, quota, and latency —
 or routes by your intent when you ask for privacy, speed, or free-only
-sources. `providers` surfaces every configured source and drills into a
+sources. `inspect_providers` surfaces every configured source and drills into a
 single provider's uptime and error history. No other search MCP server
 gives you operational visibility into every backend.
 
@@ -226,16 +255,19 @@ gives you operational visibility into every backend.
 > "Verify whether the Empire really destroyed Alderaan."
 > "Find the consensus on who fired first — Han or Greedo."
 
-`corroborate` runs a multi-pass truth-finding loop: broad
-search across active providers, claim extraction, cross-source
-reconciliation, and targeted follow-up for gaps. Claims corroborated
-across independent sources score high confidence, weighted by each
-source's authority; every source is bound to the claim it supports.
-Contradictions are surfaced with all perspectives. Gaps trigger refined
-queries. You get a structured report — confirmed, contested, and
-unverified findings — with source provenance, per-source claims, and
-confidence scores. Every other search tool returns a list of links;
-Infobroker finds the truth and tells you how sure it is.
+`verify_claims` runs a multi-pass truth-finding loop: broad
+search across all of your active providers — search engines,
+encyclopedias, and scholarly indexes alike — then claim extraction,
+cross-source reconciliation, and targeted follow-up for gaps, dispatched
+in parallel. Claims corroborated across independent sources score high
+confidence, weighted by each source's authority; every source is bound
+to the claim it supports. Contradictions are surfaced with all
+perspectives. Gaps trigger refined queries. It also remembers: prior
+findings in your knowledge base participate as corroborating sources
+before it queries the network. You get a structured report — confirmed,
+contested, and unverified findings — with source provenance, per-source
+claims, and confidence scores. Every other search tool returns a list of
+links; Infobroker finds the truth and tells you how sure it is.
 
 ### Knowledge Base
 
@@ -243,14 +275,16 @@ Infobroker finds the truth and tells you how sure it is.
 > "Ingest this article so it's cached for next time."
 
 Every search, fetch, and corroboration run is cached in a local knowledge
-base. `kb` checks the cache before hitting external providers — only
+base. `manage_kb` checks the cache before hitting external providers — only
 falling back to the network when the cached results aren't fresh enough
 or relevant enough. Its actions ingest new text or a URL by hand, report
 what's cached, and remove content. Content is age-scored, expired on a
-freshness schedule, and deduplicated by source. Beyond the cache, `kb`
+freshness schedule, and deduplicated by source. Beyond the cache, `manage_kb`
 archives the reports you generate: ingest with `source_type: "report"`
-(and default to the knowledge base) and revisit them with `kb` list and
-`kb` get, or write them to a local directory instead. Other search MCP
+(and default to the knowledge base) and revisit them with `manage_kb` list and
+`manage_kb` get, or write them to a local directory instead. Each archived report
+records its source's last-updated date, so you can compare it against the
+live source and refresh only what has actually changed. Other search MCP
 servers re-fetch the same facts every session; Infobroker remembers and
 reuses what it already found.
 
@@ -277,7 +311,7 @@ Quota counters persist to disk and survive restarts. Rate limits are
 enforced per-provider, not globally. Configuration is hot-reloadable
 via `reload_config` — change providers, adjust chains, or tweak
 thresholds without dropping connections. `web_search` doubles as
-DuckDuckGo query autocomplete. `providers` reports the server's build
+DuckDuckGo query autocomplete. `inspect_providers` reports the server's build
 health and request stats. You always know what your search server is
 doing and how much capacity remains.
 
@@ -301,10 +335,10 @@ polishes language, and `translation` produces multilingual output.
 Gated analysis is the escalation shape. When a question is high-stakes or
 decision-driving, the classify gate routes to the `analysis-loop` skill —
 a disciplined path with confidence-scored findings, source-reliability
-grading, and structured analytic techniques — rather than the lighter
-research-and-write route. It shares the same primitives and Infobroker
-tools but runs its own gated workflow, so you get the rigor without
-leaving the pipeline.
+grading, and structured analytic techniques chosen by fit and named with a
+rationale — rather than the lighter research-and-write route. It shares the
+same primitives and Infobroker tools but runs its own gated workflow, so you
+get the rigor without leaving the pipeline.
 
 A single instruction file, `search-preferences.md`, routes your client
 toward these tools: the knowledge base first, external providers only
@@ -421,7 +455,7 @@ passphrase means the store is unrecoverable by design). Second, the server
 never writes a partial file: every save is atomic, and an unrecognized or
 newer store format is never overwritten.
 
-The `kb` tool's `encryption` action is the day-to-day surface for this
+The `manage_kb` tool's `encryption` action is the day-to-day surface for this
 journey, and it never echoes secret material — `generate_key` and `backup`
 return file paths, and `rekey` reads a key file rather than a raw key.
 
@@ -437,8 +471,8 @@ move to a new key without losing content. After re-keying, point
 confirm the new key opens the store.
 
 ```
-infobroker_kb action=encryption operation=generate_key key_file=~/.config/infobroker/kb.key
-infobroker_kb action=encryption operation=backup    key_file=~/.backup/kb.key.bak
+infobroker_manage_kb action=encryption operation=generate_key key_file=~/.config/infobroker/kb.key
+infobroker_manage_kb action=encryption operation=backup    key_file=~/.backup/kb.key.bak
 infobroker_reload_config
 ```
 
@@ -481,7 +515,7 @@ override and call `reload_config` to use it immediately.
 Two optional keys tune per-provider behavior in `config.json`:
 
 - `degraded_latency_ms` — a provider whose recent average latency exceeds
-  this many milliseconds is reported `degraded` by the `providers` health
+  this many milliseconds is reported `degraded` by the `inspect_providers` health
   action, even while reachable. A global `output.degraded_latency_ms` acts
   as the fallback when a provider omits its own.
 - `resells` — set `true` on aggregator/reseller backends (search engines
@@ -491,6 +525,19 @@ Two optional keys tune per-provider behavior in `config.json`:
   sources (Wikipedia, arXiv) leave it empty because the page is the
   origin.
 
+### Hedged fallback
+
+`web_search` and `fetch_page` fall back with a hedge instead of waiting
+out a slow provider's full timeout: the primary (first-choice) provider
+runs alone for a latency-derived window, then the remaining providers
+race and the first result wins. The common path uses one provider call;
+the hedge fires only when the primary is slow or failing. `fetch_page`
+additionally prefers the primary renderer in a short grace window so a
+marginally slow `jina` is not displaced by a lower-quality `native_fetch`.
+Tune the window with `output.hedge_enabled`, `hedge_min_delay_ms`,
+`hedge_max_delay_ms`, and `hedge_grace_ms`; set `hedge_enabled` to
+`false` for the sequential chain.
+
 ## How It Compares
 
 | Tool name | What you're used to | How Infobroker differs |
@@ -509,7 +556,7 @@ contradiction, and gaps. The bundled skills close the loop from raw
 research to finished writing. One server. Every source. Research that
 delivers.
 
-Last updated: 2026-08-24.
+Last updated: 2026-09-02.
 
 ## Contribute
 
@@ -539,7 +586,7 @@ terms and API keys.
 ## Spec
 
 The server is built from a single source specification, `infobroker.md`
-(v2026.08.24), which defines every requirement and the gates that verify it.
+(v2026.09.02), which defines every requirement and the gates that verify it.
 Each requirement traces to an implementation file, and `npm run check`
 reconciles the code, the spec, and this README so what is documented is what
 the server actually delivers.

package/dist/batch.d.ts

@@ -0,0 +1,34 @@
+export declare const MAX_BATCH_INPUTS = 5;
+export declare function capInputs(items: string[]): string[];
+interface EnvelopeOk {
+    status: "ok";
+    provider: string;
+    results: Array<{
+        url?: string;
+        [k: string]: unknown;
+    }>;
+    meta?: Record<string, unknown>;
+    truncated?: boolean;
+    output_path?: string;
+}
+interface EnvelopeError {
+    status: "error";
+    provider: string;
+    error?: unknown;
+}
+type Envelope = EnvelopeOk | EnvelopeError;
+export declare function parseEnvelope(text: string): Envelope;
+export interface PerInputMeta {
+    query: string;
+    provider: string;
+    status: "ok" | "error";
+    result_count: number;
+    truncated?: boolean;
+    output_path?: string;
+}
+export interface BatchItem {
+    query: string;
+    envelope: string;
+}
+export declare function mergeItems(items: BatchItem[]): Envelope;
+export {};

package/dist/batch.js

@@ -0,0 +1,74 @@
+// @implements REQ-020 REQ-021
+export const MAX_BATCH_INPUTS = 5;
+export function capInputs(items) {
+    return items.slice(0, MAX_BATCH_INPUTS);
+}
+export function parseEnvelope(text) {
+    const t = text.trim();
+    if (t.startsWith("[OK]")) {
+        return JSON.parse(t.slice(4));
+    }
+    if (t.startsWith("[ERROR]")) {
+        return JSON.parse(t.slice(7));
+    }
+    throw new Error("unrecognized envelope prefix");
+}
+function dedupeByUrl(results) {
+    const seen = new Set();
+    const out = [];
+    for (const r of results) {
+        const key = r.url || "";
+        if (key && seen.has(key))
+            continue;
+        if (key)
+            seen.add(key);
+        out.push(r);
+    }
+    return out;
+}
+// Merge per-input envelopes into a single envelope. Results are flattened in
+// input order and URL-deduplicated; per-input provenance is recorded in meta.
+export function mergeItems(items) {
+    const perQuery = [];
+    const okItems = [];
+    let firstError;
+    for (const item of items) {
+        let env;
+        try {
+            env = parseEnvelope(item.envelope);
+        }
+        catch {
+            env = { status: "error", provider: "system", error: { code: "internal_error", message: "batch item failed to parse" } };
+        }
+        if (env.status === "ok") {
+            okItems.push({ query: item.query, env });
+            perQuery.push({
+                query: item.query,
+                provider: env.provider,
+                status: "ok",
+                result_count: env.results.length,
+                ...(env.truncated ? { truncated: true, output_path: env.output_path } : {}),
+            });
+        }
+        else {
+            if (!firstError)
+                firstError = env;
+            perQuery.push({ query: item.query, provider: env.provider, status: "error", result_count: 0 });
+        }
+    }
+    if (okItems.length === 0) {
+        return firstError ?? { status: "error", provider: "none", error: { code: "internal_error", message: "no results" } };
+    }
+    const firstOk = okItems[0].env;
+    const results = dedupeByUrl(okItems.flatMap((o) => o.env.results));
+    return {
+        status: "ok",
+        provider: firstOk.provider,
+        results,
+        meta: {
+            ...(firstOk.meta ?? {}),
+            per_query: perQuery,
+        },
+    };
+}
+//# sourceMappingURL=batch.js.map

package/dist/batch.js.map

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

package/dist/bibtex.d.ts

@@ -0,0 +1,11 @@
+export interface CitationFields {
+    type: "article" | "misc";
+    key: string;
+    title: string;
+    authors: string[];
+    year?: string;
+    venue?: string;
+    url?: string;
+}
+export declare function formatBibtex(fields: CitationFields): string;
+export declare function citationFor(title: string, authors: string[], year?: string, venue?: string, url?: string): string;

package/dist/bibtex.js

@@ -0,0 +1,44 @@
+function escapeLatex(text) {
+    return text
+        .replace(/\\/g, "\\textbackslash{}")
+        .replace(/[{}]/g, (c) => (c === "{" ? "\\{" : "\\}"))
+        .replace(/([&%$#_])/g, "\\$1")
+        .replace(/~/g, "\\textasciitilde{}")
+        .replace(/\^/g, "\\textasciicircum{}");
+}
+function citationKey(author, year, title) {
+    const last = (author || "").split(/[,\s]+/)[0] || "anon";
+    const slug = last.toLowerCase().replace(/[^a-z0-9]/g, "");
+    const y = year || "nd";
+    return `${slug}${y}`;
+}
+export function formatBibtex(fields) {
+    const authorField = fields.authors.length > 0
+        ? fields.authors.map((a) => escapeLatex(a)).join(" and ")
+        : undefined;
+    const lines = [`@${fields.type}{${escapeLatex(fields.key)},`];
+    lines.push(`  title = {${escapeLatex(fields.title)}}`);
+    if (authorField)
+        lines.push(`  author = {${authorField}}`);
+    if (fields.year)
+        lines.push(`  year = {${fields.year}}`);
+    if (fields.venue)
+        lines.push(fields.type === "article" ? `  journal = {${escapeLatex(fields.venue)}}` : `  howpublished = {${escapeLatex(fields.venue)}}`);
+    if (fields.url)
+        lines.push(`  url = {${fields.url}}`);
+    lines.push("}");
+    return lines.join("\n");
+}
+export function citationFor(title, authors, year, venue, url) {
+    const key = citationKey(authors[0], year || undefined, title);
+    return formatBibtex({
+        type: authors.length > 0 ? "article" : "misc",
+        key,
+        title,
+        authors,
+        year,
+        venue,
+        url,
+    });
+}
+//# sourceMappingURL=bibtex.js.map

package/dist/bibtex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bibtex.js","sourceRoot":"","sources":["../src/bibtex.ts"],"names":[],"mappings":"AAWA,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI;SACR,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC;SACnC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;SACpD,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;SAC7B,OAAO,CAAC,IAAI,EAAE,oBAAoB,CAAC;SACnC,OAAO,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,MAAe,EAAE,IAAa,EAAE,KAAc;IACjE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC;IACvB,OAAO,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC3C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QACzD,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,KAAK,GAAa,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,WAAW,GAAG,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3J,IAAI,MAAM,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,OAAiB,EAAE,IAAa,EAAE,KAAc,EAAE,GAAY;IACvG,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9D,OAAO,YAAY,CAAC;QAClB,IAAI,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QAC7C,GAAG;QACH,KAAK;QACL,OAAO;QACP,IAAI;QACJ,KAAK;QACL,GAAG;KACJ,CAAC,CAAC;AACL,CAAC"}

package/dist/cite.d.ts

@@ -0,0 +1,9 @@
+export interface CitationResult {
+    title: string;
+    url: string;
+    year?: string;
+    authors: string[];
+    venue?: string;
+    bibtex: string;
+}
+export declare function searchCitations(query: string, limit?: number, source?: string): Promise<CitationResult[]>;

package/dist/cite.js

@@ -0,0 +1,85 @@
+// @implements REQ-027
+import { infobrokerFetch } from "./http.js";
+import { getEnvVar } from "./config.js";
+import { citationFor } from "./bibtex.js";
+const ARXIV_API = "https://export.arxiv.org/api/query";
+const SS_API = "https://api.semanticscholar.org/graph/v1/paper/search";
+function tagContent(xml, tag) {
+    const re = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "i");
+    const m = xml.match(re);
+    return m ? (m[1] || "").replace(/<[^>]*>/g, "").trim() : "";
+}
+async function searchArxiv(query, limit) {
+    const params = new URLSearchParams({ search_query: query, max_results: String(limit) });
+    const resp = await infobrokerFetch(`${ARXIV_API}?${params.toString()}`, { providerSlug: "arxiv" });
+    if (!resp.ok)
+        return [];
+    const xml = await resp.text();
+    const out = [];
+    const entryRe = /<entry>([\s\S]*?)<\/entry>/g;
+    let m;
+    while ((m = entryRe.exec(xml)) !== null) {
+        const entry = m[1];
+        const title = tagContent(entry, "title");
+        const id = tagContent(entry, "id");
+        const published = tagContent(entry, "published");
+        const year = published.slice(0, 4);
+        const authors = [...entry.matchAll(/<name>([\s\S]*?)<\/name>/g)].map((a) => a[1].trim()).filter(Boolean);
+        if (!title || !id)
+            continue;
+        out.push({
+            title,
+            url: id,
+            year,
+            authors,
+            venue: "arXiv",
+            bibtex: citationFor(title, authors, year, "arXiv", id),
+        });
+    }
+    return out;
+}
+async function searchSemanticScholar(query, limit) {
+    const fields = ["title", "authors", "year", "venue", "externalIds", "url"].join(",");
+    const params = new URLSearchParams({ query, limit: String(limit), fields });
+    const headers = {};
+    const key = getEnvVar("semantic_scholar", "_API_KEY");
+    if (key)
+        headers["x-api-key"] = key;
+    const resp = await infobrokerFetch(`${SS_API}?${params.toString()}`, { providerSlug: "semantic_scholar", headers });
+    if (!resp.ok)
+        return [];
+    const data = (await resp.json());
+    return (data.data || []).map((item) => {
+        const year = item.year ? String(item.year) : undefined;
+        const authors = (item.authors || []).map((a) => a.name);
+        return {
+            title: item.title,
+            url: item.url || `https://api.semanticscholar.org/paper/${item.title}`,
+            year,
+            authors,
+            venue: item.venue,
+            bibtex: citationFor(item.title, authors, year, item.venue, undefined),
+        };
+    });
+}
+export async function searchCitations(query, limit = 8, source) {
+    const results = [];
+    const wanted = source ? [source] : ["arxiv", "semantic_scholar"];
+    for (const s of wanted) {
+        if (results.length >= limit)
+            break;
+        try {
+            const batch = s === "arxiv" ? await searchArxiv(query, limit) : await searchSemanticScholar(query, limit);
+            for (const r of batch) {
+                if (results.length >= limit)
+                    break;
+                results.push(r);
+            }
+        }
+        catch {
+            // source unavailable — continue to the next
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=cite.js.map

package/dist/cite.js.map

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

package/dist/config.js

@@ -152,6 +152,9 @@ function validateConfig(config) {
             }
         }
     }
+    if (config.corroboration?.kb_recall !== undefined && typeof config.corroboration.kb_recall !== "boolean") {
+        errors.push("corroboration.kb_recall must be a boolean");
+    }
     if (typeof config.output.fallback_depth !== "number" || config.output.fallback_depth < 1) {
         errors.push("output.fallback_depth must be a positive number");
     }
@@ -161,6 +164,54 @@ function validateConfig(config) {
     if (config.output.degraded_latency_ms !== undefined && (typeof config.output.degraded_latency_ms !== "number" || config.output.degraded_latency_ms < 0)) {
         errors.push("output.degraded_latency_ms must be a non-negative number");
     }
+    if (config.output.hedge_enabled !== undefined && typeof config.output.hedge_enabled !== "boolean") {
+        errors.push("output.hedge_enabled must be a boolean");
+    }
+    if (config.output.hedge_min_delay_ms !== undefined && (typeof config.output.hedge_min_delay_ms !== "number" || config.output.hedge_min_delay_ms < 0)) {
+        errors.push("output.hedge_min_delay_ms must be a non-negative number");
+    }
+    if (config.output.hedge_max_delay_ms !== undefined && (typeof config.output.hedge_max_delay_ms !== "number" || config.output.hedge_max_delay_ms < config.output.hedge_min_delay_ms)) {
+        errors.push("output.hedge_max_delay_ms must be a number no less than hedge_min_delay_ms");
+    }
+    if (config.output.hedge_grace_ms !== undefined && (typeof config.output.hedge_grace_ms !== "number" || config.output.hedge_grace_ms < 0)) {
+        errors.push("output.hedge_grace_ms must be a non-negative number");
+    }
+    if (config.fetch) {
+        if (config.fetch.passage_size !== undefined && (typeof config.fetch.passage_size !== "number" || config.fetch.passage_size < 1)) {
+            errors.push("fetch.passage_size must be a positive number");
+        }
+        if (config.fetch.max_passages !== undefined && (typeof config.fetch.max_passages !== "number" || config.fetch.max_passages < 1)) {
+            errors.push("fetch.max_passages must be a positive number");
+        }
+        if (config.fetch.detect_date !== undefined && typeof config.fetch.detect_date !== "boolean") {
+            errors.push("fetch.detect_date must be a boolean");
+        }
+    }
+    if (config.expand) {
+        if (config.expand.max_expansions !== undefined && (typeof config.expand.max_expansions !== "number" || config.expand.max_expansions < 1)) {
+            errors.push("expand.max_expansions must be a positive number");
+        }
+    }
+    if (config.deep) {
+        if (config.deep.max_pages !== undefined && (typeof config.deep.max_pages !== "number" || config.deep.max_pages < 1)) {
+            errors.push("deep.max_pages must be a positive number");
+        }
+        if (config.deep.max_total_pages !== undefined && (typeof config.deep.max_total_pages !== "number" || config.deep.max_total_pages < 1)) {
+            errors.push("deep.max_total_pages must be a positive number");
+        }
+        if (config.deep.concurrency !== undefined && (typeof config.deep.concurrency !== "number" || config.deep.concurrency < 1)) {
+            errors.push("deep.concurrency must be a positive number");
+        }
+        if (config.deep.early_exit_score !== undefined && (typeof config.deep.early_exit_score !== "number" || config.deep.early_exit_score < 0 || config.deep.early_exit_score > 1)) {
+            errors.push("deep.early_exit_score must be a number between 0 and 1");
+        }
+        if (config.deep.max_ms !== undefined && (typeof config.deep.max_ms !== "number" || config.deep.max_ms < 1)) {
+            errors.push("deep.max_ms must be a positive number");
+        }
+        if (config.deep.detect_date !== undefined && typeof config.deep.detect_date !== "boolean") {
+            errors.push("deep.detect_date must be a boolean");
+        }
+    }
     if (config.kb) {
         const kb = config.kb;
         if (typeof kb.chunk_size !== "number" || kb.chunk_size < 1) {