@askalf/deepdive 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { type CLIFlags } from "./config.js";
+interface ParsedArgs {
+    question?: string;
+    outPath?: string;
+    flags: CLIFlags;
+    help: boolean;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAaA,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AA+B3D,UAAU,UAAU;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsEpD"}

package/dist/cli.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+// deepdive CLI entry.
+//
+//   deepdive "how does claude's rate limiter work"
+//   deepdive "..." --model=claude-opus-4-7 --search=brave --out=report.md
+//   deepdive --help
+//
+// Prints the cited markdown report to stdout. Progress events go to stderr
+// when --verbose is set or DEEPDIVE_VERBOSE=1.
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveConfig } from "./config.js";
+import { resolveSearchAdapter } from "./search.js";
+import { runAgent } from "./agent.js";
+const USAGE = `deepdive — local research agent
+
+Usage:
+  deepdive "<question>" [flags]
+
+Flags:
+  --base-url=<url>              LLM endpoint. Default: http://localhost:3456 (dario)
+  --api-key=<key>               LLM API key. Default: dario
+  --model=<name>                Model to use. Default: claude-sonnet-4-6
+  --max-tokens=<n>              Output max tokens per LLM call. Default: 4096
+  --search=<adapter>            Search adapter: duckduckgo | searxng | brave | tavily
+                                Default: duckduckgo (no key required)
+  --results-per-query=<n>       Results per sub-query. Default: 5
+  --max-sources=<n>             Total sources to fetch. Default: 12
+  --max-words-per-source=<n>    Per-source content cap before synthesis. Default: 2000
+  --timeout-ms=<ms>             Per-fetch timeout. Default: 30000
+  --out=<path>                  Write markdown to a file (also prints to stdout)
+  --verbose, -v                 Stream progress events to stderr
+  --help, -h                    Show this help
+
+Environment:
+  DEEPDIVE_BASE_URL, DEEPDIVE_API_KEY, DEEPDIVE_MODEL, DEEPDIVE_SEARCH,
+  DEEPDIVE_SEARXNG_URL, DEEPDIVE_BRAVE_KEY, DEEPDIVE_TAVILY_KEY,
+  DEEPDIVE_MAX_SOURCES, DEEPDIVE_FETCH_TIMEOUT_MS, DEEPDIVE_HEADED,
+  DEEPDIVE_VERBOSE
+`;
+// Exported for unit tests.
+export function parseArgs(argv) {
+    const flags = {};
+    let question;
+    let outPath;
+    let help = false;
+    for (const a of argv) {
+        if (a === "--help" || a === "-h") {
+            help = true;
+            continue;
+        }
+        if (a === "--verbose" || a === "-v") {
+            flags.verbose = true;
+            continue;
+        }
+        const m = /^--([a-z0-9-]+)=(.*)$/.exec(a);
+        if (m) {
+            const [, key, rawValue] = m;
+            const value = rawValue.trim();
+            switch (key) {
+                case "base-url":
+                    flags.baseUrl = value;
+                    break;
+                case "api-key":
+                    flags.apiKey = value;
+                    break;
+                case "model":
+                    flags.model = value;
+                    break;
+                case "max-tokens":
+                    flags.maxTokens = parsePositiveInt(value);
+                    break;
+                case "search":
+                    flags.search = value.toLowerCase();
+                    break;
+                case "results-per-query":
+                    flags.resultsPerQuery = parsePositiveInt(value);
+                    break;
+                case "max-sources":
+                    flags.maxSources = parsePositiveInt(value);
+                    break;
+                case "max-words-per-source":
+                    flags.maxWordsPerSource = parsePositiveInt(value);
+                    break;
+                case "timeout-ms":
+                    flags.timeoutMs = parsePositiveInt(value);
+                    break;
+                case "out":
+                    outPath = value;
+                    break;
+                default:
+                    throw new Error(`unknown flag: --${key}`);
+            }
+            continue;
+        }
+        if (a.startsWith("--")) {
+            throw new Error(`flags must be in --key=value form (got: ${a}). See --help.`);
+        }
+        if (question === undefined) {
+            question = a;
+            continue;
+        }
+        throw new Error(`unexpected positional argument: ${JSON.stringify(a)}. Wrap the question in quotes.`);
+    }
+    return { question, outPath, flags, help };
+}
+function parsePositiveInt(s) {
+    if (!/^\d+$/.test(s))
+        return undefined;
+    const n = Number(s);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+function renderEvent(e) {
+    switch (e.type) {
+        case "plan.start":
+            return `  plan    planning sub-queries for: ${ellipsize(e.question, 60)}`;
+        case "plan.done":
+            return `  plan    ${e.plan.queries.length} sub-queries`;
+        case "search.start":
+            return `  search  ${e.query}`;
+        case "search.done":
+            return `          ${e.count} result${e.count === 1 ? "" : "s"}`;
+        case "fetch.start":
+            return `  fetch   ${e.url}`;
+        case "fetch.done":
+            return `          ${e.ok ? "OK " : "!! "}${e.status} · ${e.words} words`;
+        case "synthesize.start":
+            return `  synth   synthesizing from ${e.sourceCount} source${e.sourceCount === 1 ? "" : "s"}`;
+        case "synthesize.done":
+            return `  synth   done`;
+    }
+}
+function ellipsize(s, max) {
+    return s.length <= max ? s : s.slice(0, max - 1) + "…";
+}
+async function main(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`deepdive: ${err.message}\n\n${USAGE}`);
+        return 2;
+    }
+    if (parsed.help) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    if (!parsed.question) {
+        process.stderr.write(`deepdive: missing question.\n\n${USAGE}`);
+        return 2;
+    }
+    const config = resolveConfig(parsed.flags, process.env);
+    const search = await resolveSearchAdapter(config.searchAdapter, process.env);
+    const ac = new AbortController();
+    const sigint = () => ac.abort();
+    process.on("SIGINT", sigint);
+    process.on("SIGTERM", sigint);
+    try {
+        const result = await runAgent(parsed.question, {
+            llm: config.llm,
+            search,
+            browser: config.browser,
+            resultsPerQuery: config.resultsPerQuery,
+            maxSources: config.maxSources,
+            maxWordsPerSource: config.maxWordsPerSource,
+            onEvent: (e) => {
+                if (config.verbose)
+                    process.stderr.write(renderEvent(e) + "\n");
+            },
+        }, ac.signal);
+        process.stdout.write(result.markdown);
+        if (!result.markdown.endsWith("\n"))
+            process.stdout.write("\n");
+        if (parsed.outPath) {
+            const path = resolve(parsed.outPath);
+            writeFileSync(path, result.markdown, "utf-8");
+            process.stderr.write(`\nwrote ${path}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`deepdive: ${err.message}\n`);
+        return 1;
+    }
+    finally {
+        process.off("SIGINT", sigint);
+        process.off("SIGTERM", sigint);
+    }
+}
+// Only run main() when invoked as a script, not when imported (e.g. by tests
+// that exercise `parseArgs` in isolation).
+const isEntryPoint = process.argv[1] !== undefined &&
+    (() => {
+        try {
+            return process.argv[1] === fileURLToPath(import.meta.url);
+        }
+        catch {
+            return false;
+        }
+    })();
+if (isEntryPoint) {
+    main(process.argv.slice(2)).then((code) => process.exit(code));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+import type { LLMConfig } from "./llm.js";
+import type { BrowserOptions } from "./browser.js";
+export interface RuntimeConfig {
+    llm: LLMConfig;
+    browser: BrowserOptions;
+    searchAdapter: string;
+    resultsPerQuery: number;
+    maxSources: number;
+    maxWordsPerSource: number;
+    verbose: boolean;
+}
+export interface CLIFlags {
+    baseUrl?: string;
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+    search?: string;
+    resultsPerQuery?: number;
+    maxSources?: number;
+    maxWordsPerSource?: number;
+    timeoutMs?: number;
+    verbose?: boolean;
+}
+export declare function resolveConfig(flags: CLIFlags, env: Record<string, string | undefined>): RuntimeConfig;
+export declare function parsePositiveInt(s: string | undefined): number | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAeD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,aAAa,CA+Cf;AAGD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAO1E"}

package/dist/config.js

@@ -0,0 +1,63 @@
+// Config resolution — merges CLI flags, env vars, and defaults.
+// No config file in v0.1.0: keep the surface small. Env vars are prefixed
+// DEEPDIVE_* to avoid collisions with other tools in the user's shell.
+const DEFAULTS = {
+    baseUrl: "http://localhost:3456",
+    apiKey: "dario",
+    model: "claude-sonnet-4-6",
+    maxTokens: 4096,
+    searchAdapter: "duckduckgo",
+    resultsPerQuery: 5,
+    maxSources: 12,
+    maxWordsPerSource: 2000,
+    timeoutMs: 30000,
+    maxBytesPerFetch: 2_000_000,
+};
+export function resolveConfig(flags, env) {
+    const baseUrl = flags.baseUrl ?? env.DEEPDIVE_BASE_URL ?? DEFAULTS.baseUrl;
+    const apiKey = flags.apiKey ?? env.DEEPDIVE_API_KEY ?? DEFAULTS.apiKey;
+    const model = flags.model ?? env.DEEPDIVE_MODEL ?? DEFAULTS.model;
+    const maxTokens = flags.maxTokens ??
+        parsePositiveInt(env.DEEPDIVE_MAX_TOKENS) ??
+        DEFAULTS.maxTokens;
+    const searchAdapter = flags.search ?? env.DEEPDIVE_SEARCH ?? DEFAULTS.searchAdapter;
+    const resultsPerQuery = flags.resultsPerQuery ??
+        parsePositiveInt(env.DEEPDIVE_RESULTS_PER_QUERY) ??
+        DEFAULTS.resultsPerQuery;
+    const maxSources = flags.maxSources ??
+        parsePositiveInt(env.DEEPDIVE_MAX_SOURCES) ??
+        DEFAULTS.maxSources;
+    const maxWordsPerSource = flags.maxWordsPerSource ??
+        parsePositiveInt(env.DEEPDIVE_MAX_WORDS_PER_SOURCE) ??
+        DEFAULTS.maxWordsPerSource;
+    const timeoutMs = flags.timeoutMs ??
+        parsePositiveInt(env.DEEPDIVE_FETCH_TIMEOUT_MS) ??
+        DEFAULTS.timeoutMs;
+    const verbose = flags.verbose ?? env.DEEPDIVE_VERBOSE === "1";
+    return {
+        llm: { baseUrl, apiKey, model, maxTokens },
+        browser: {
+            headless: env.DEEPDIVE_HEADED === "1" ? false : true,
+            timeoutMs,
+            maxBytes: DEFAULTS.maxBytesPerFetch,
+        },
+        searchAdapter,
+        resultsPerQuery,
+        maxSources,
+        maxWordsPerSource,
+        verbose,
+    };
+}
+// Exported for unit tests.
+export function parsePositiveInt(s) {
+    if (!s)
+        return undefined;
+    const trimmed = s.trim();
+    if (!/^\d+$/.test(trimmed))
+        return undefined;
+    const n = Number(trimmed);
+    if (!Number.isFinite(n) || n <= 0)
+        return undefined;
+    return n;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,0EAA0E;AAC1E,uEAAuE;AA4BvE,MAAM,QAAQ,GAAG;IACf,OAAO,EAAE,uBAAuB;IAChC,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,mBAAmB;IAC1B,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,YAAY;IAC3B,eAAe,EAAE,CAAC;IAClB,UAAU,EAAE,EAAE;IACd,iBAAiB,EAAE,IAAI;IACvB,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,SAAS;CAC5B,CAAC;AAEF,MAAM,UAAU,aAAa,CAC3B,KAAe,EACf,GAAuC;IAEvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,iBAAiB,IAAI,QAAQ,CAAC,OAAO,CAAC;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,gBAAgB,IAAI,QAAQ,CAAC,MAAM,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC,KAAK,CAAC;IAClE,MAAM,SAAS,GACb,KAAK,CAAC,SAAS;QACf,gBAAgB,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACzC,QAAQ,CAAC,SAAS,CAAC;IAErB,MAAM,aAAa,GACjB,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC,aAAa,CAAC;IAEhE,MAAM,eAAe,GACnB,KAAK,CAAC,eAAe;QACrB,gBAAgB,CAAC,GAAG,CAAC,0BAA0B,CAAC;QAChD,QAAQ,CAAC,eAAe,CAAC;IAE3B,MAAM,UAAU,GACd,KAAK,CAAC,UAAU;QAChB,gBAAgB,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC1C,QAAQ,CAAC,UAAU,CAAC;IAEtB,MAAM,iBAAiB,GACrB,KAAK,CAAC,iBAAiB;QACvB,gBAAgB,CAAC,GAAG,CAAC,6BAA6B,CAAC;QACnD,QAAQ,CAAC,iBAAiB,CAAC;IAE7B,MAAM,SAAS,GACb,KAAK,CAAC,SAAS;QACf,gBAAgB,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAC/C,QAAQ,CAAC,SAAS,CAAC;IAErB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,gBAAgB,KAAK,GAAG,CAAC;IAE9D,OAAO;QACL,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;QAC1C,OAAO,EAAE;YACP,QAAQ,EAAE,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACpD,SAAS;YACT,QAAQ,EAAE,QAAQ,CAAC,gBAAgB;SACpC;QACD,aAAa;QACb,eAAe;QACf,UAAU;QACV,iBAAiB;QACjB,OAAO;KACR,CAAC;AACJ,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,gBAAgB,CAAC,CAAqB;IACpD,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/extract.d.ts

@@ -0,0 +1,10 @@
+export interface ExtractedContent {
+    title: string;
+    text: string;
+    wordCount: number;
+    truncated: boolean;
+}
+export declare function extractContent(rawText: string, rawTitle: string, maxWords: number): ExtractedContent;
+export declare function normalizeWhitespace(s: string): string;
+export declare function isMeaningfulParagraph(p: string): boolean;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAoBlB;AAGD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASrD;AAGD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAcxD"}

package/dist/extract.js

@@ -0,0 +1,52 @@
+// Lightweight content extraction — strips boilerplate (nav, footer, scripts),
+// keeps main content. Intentionally hand-rolled so deepdive has zero
+// extraction dependencies. For quality-sensitive use cases, swap in
+// @mozilla/readability via a custom extractor.
+export function extractContent(rawText, rawTitle, maxWords) {
+    const normalized = normalizeWhitespace(rawText);
+    const paragraphs = normalized
+        .split(/\n{2,}|\r\n{2,}|(?:\r?\n\s*){2,}/g)
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+    const meaningful = paragraphs.filter(isMeaningfulParagraph);
+    const joined = meaningful.join("\n\n");
+    const words = joined.split(/\s+/).filter(Boolean);
+    const truncated = words.length > maxWords;
+    const clamped = truncated ? words.slice(0, maxWords).join(" ") + " …" : joined;
+    return {
+        title: rawTitle.trim(),
+        text: clamped,
+        wordCount: truncated ? maxWords : words.length,
+        truncated,
+    };
+}
+// Exported for unit tests.
+export function normalizeWhitespace(s) {
+    return s
+        .replace(/\r\n/g, "\n")
+        .replace(/\t/g, " ")
+        .replace(/\u00a0/g, " ")
+        .replace(/[ \f\v]+/g, " ")
+        .replace(/ *\n */g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+// Exported for unit tests.
+export function isMeaningfulParagraph(p) {
+    if (p.length < 40)
+        return false;
+    const words = p.split(/\s+/).filter(Boolean);
+    if (words.length < 8)
+        return false;
+    // Drop lines that are mostly links or UI chrome.
+    const linkyRatio = (p.match(/https?:\/\/|www\./g)?.length ?? 0) /
+        Math.max(1, words.length / 10);
+    if (linkyRatio > 1)
+        return false;
+    // Drop cookie banners and nav lists.
+    const chromeRe = /\b(cookie|cookies|privacy|sign in|sign up|log in|subscribe now|menu|navigation|skip to content)\b/i;
+    if (chromeRe.test(p) && words.length < 25)
+        return false;
+    return true;
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,oEAAoE;AACpE,+CAA+C;AAS/C,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,QAAgB,EAChB,QAAgB;IAEhB,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,UAAU;SAC1B,KAAK,CAAC,mCAAmC,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE/B,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAE/E,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM;QAC9C,SAAS;KACV,CAAC;AACJ,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,mBAAmB,CAAC,CAAS;IAC3C,OAAO,CAAC;SACL,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC;SACzB,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,qBAAqB,CAAC,CAAS;IAC7C,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,iDAAiD;IACjD,MAAM,UAAU,GACd,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACjC,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,qCAAqC;IACrC,MAAM,QAAQ,GACZ,oGAAoG,CAAC;IACvG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { runAgent, type AgentConfig, type AgentEvent, type AgentResult } from "./agent.js";
+export { planQueries, parsePlan, type Plan } from "./plan.js";
+export { resolveSearchAdapter, dedupeByUrl, type SearchAdapter, type SearchResult, } from "./search.js";
+export { BrowserSession, type BrowserOptions, type FetchedPage } from "./browser.js";
+export { extractContent, type ExtractedContent } from "./extract.js";
+export { synthesize, type SourceWithContent } from "./synthesize.js";
+export { buildSourceTable, renderAnswerMarkdown, renderSourcesMarkdown, type Source, } from "./citations.js";
+export { callLLM, type LLMConfig, type LLMMessage, type LLMResult } from "./llm.js";
+export { resolveConfig, type RuntimeConfig, type CLIFlags } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,MAAM,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Library exports for programmatic use.
+export { runAgent } from "./agent.js";
+export { planQueries, parsePlan } from "./plan.js";
+export { resolveSearchAdapter, dedupeByUrl, } from "./search.js";
+export { BrowserSession } from "./browser.js";
+export { extractContent } from "./extract.js";
+export { synthesize } from "./synthesize.js";
+export { buildSourceTable, renderAnswerMarkdown, renderSourcesMarkdown, } from "./citations.js";
+export { callLLM } from "./llm.js";
+export { resolveConfig } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,QAAQ,EAAuD,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,SAAS,EAAa,MAAM,WAAW,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAyC,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,cAAc,EAAyB,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,OAAO,EAAmD,MAAM,UAAU,CAAC;AACpF,OAAO,EAAE,aAAa,EAAqC,MAAM,aAAa,CAAC"}

package/dist/llm.d.ts

@@ -0,0 +1,19 @@
+export interface LLMConfig {
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    maxTokens: number;
+}
+export interface LLMMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export interface LLMResult {
+    text: string;
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+export declare function callLLM(messages: LLMMessage[], system: string, config: LLMConfig, signal?: AbortSignal): Promise<LLMResult>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,UAAU,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC,CAoCpB"}

package/dist/llm.js

@@ -0,0 +1,33 @@
+// Minimal Anthropic Messages-compatible client.
+// Default target is dario at http://localhost:3456, but any Anthropic-compat
+// endpoint works. The only header dario cares about is Authorization / x-api-key.
+export async function callLLM(messages, system, config, signal) {
+    const url = `${config.baseUrl.replace(/\/+$/, "")}/v1/messages`;
+    const body = {
+        model: config.model,
+        max_tokens: config.maxTokens,
+        system,
+        messages,
+    };
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "anthropic-version": "2023-06-01",
+            "x-api-key": config.apiKey,
+        },
+        body: JSON.stringify(body),
+        signal,
+    });
+    if (!res.ok) {
+        const detail = await res.text().catch(() => "");
+        throw new Error(`LLM ${res.status} ${res.statusText}: ${detail.slice(0, 500)}`);
+    }
+    const json = (await res.json());
+    const text = json.content
+        .filter((b) => b.type === "text" && typeof b.text === "string")
+        .map((b) => b.text)
+        .join("");
+    return { text, usage: json.usage };
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,6EAA6E;AAC7E,kFAAkF;AAmBlF,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAsB,EACtB,MAAc,EACd,MAAiB,EACjB,MAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC;IAChE,MAAM,IAAI,GAAG;QACX,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,MAAM;QACN,QAAQ;KACT,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,mBAAmB,EAAE,YAAY;YACjC,WAAW,EAAE,MAAM,CAAC,MAAM;SAC3B;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;SAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC;SACnB,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/plan.d.ts

@@ -0,0 +1,8 @@
+import { type LLMConfig } from "./llm.js";
+export interface Plan {
+    queries: string[];
+    reasoning: string;
+}
+export declare function planQueries(question: string, config: LLMConfig, signal?: AbortSignal): Promise<Plan>;
+export declare function parsePlan(raw: string): Plan;
+//# sourceMappingURL=plan.d.ts.map

package/dist/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../src/plan.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAQf;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiB3C"}

package/dist/plan.js

@@ -0,0 +1,72 @@
+// Query planning — decompose a user question into 3–5 sub-queries suitable
+// for web search. Pure over its inputs; wraps one LLM call.
+import { callLLM } from "./llm.js";
+const PLANNER_SYSTEM = `You are a research planner. Given a user's question, produce 3-5 specific, searchable sub-queries that together will gather the evidence needed to answer it well.
+
+Rules:
+- Each sub-query must be a concrete phrase someone would type into a search engine.
+- Cover distinct facets of the question (definition, how it works, pros/cons, recent changes, alternatives, etc.) — do not list near-duplicates.
+- Prefer specific terminology over vague phrasing.
+- Do not include the user's exact question verbatim unless it is already search-engine-shaped.
+
+Output FORMAT (strict): one JSON object, no prose before or after, matching:
+{"reasoning": "<1-2 sentences on your decomposition>", "queries": ["q1", "q2", ...]}`;
+export async function planQueries(question, config, signal) {
+    const { text } = await callLLM([{ role: "user", content: question }], PLANNER_SYSTEM, config, signal);
+    return parsePlan(text);
+}
+// Exported for unit tests.
+export function parsePlan(raw) {
+    const json = extractFirstJsonObject(raw);
+    if (!json)
+        throw new Error(`planner did not return JSON: ${raw.slice(0, 200)}`);
+    const parsed = JSON.parse(json);
+    if (!Array.isArray(parsed.queries) || parsed.queries.length === 0) {
+        throw new Error(`planner returned no queries: ${raw.slice(0, 200)}`);
+    }
+    const queries = parsed.queries
+        .filter((q) => typeof q === "string")
+        .map((q) => q.trim())
+        .filter((q) => q.length > 0)
+        .slice(0, 8);
+    if (queries.length === 0)
+        throw new Error("planner queries were all empty");
+    return {
+        queries,
+        reasoning: typeof parsed.reasoning === "string" ? parsed.reasoning : "",
+    };
+}
+function extractFirstJsonObject(s) {
+    const start = s.indexOf("{");
+    if (start === -1)
+        return null;
+    let depth = 0;
+    let inString = false;
+    let escape = false;
+    for (let i = start; i < s.length; i++) {
+        const c = s[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (c === "\\" && inString) {
+            escape = true;
+            continue;
+        }
+        if (c === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (c === "{")
+            depth++;
+        else if (c === "}") {
+            depth--;
+            if (depth === 0)
+                return s.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=plan.js.map

package/dist/plan.js.map

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

package/dist/search/brave.d.ts

@@ -0,0 +1,8 @@
+import type { SearchAdapter, SearchResult } from "../search.js";
+export declare class BraveSearch implements SearchAdapter {
+    private readonly key;
+    readonly name = "brave";
+    constructor(key: string);
+    search(query: string, limit: number, signal?: AbortSignal): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=brave.d.ts.map

package/dist/search/brave.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.d.ts","sourceRoot":"","sources":["../../src/search/brave.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE,qBAAa,WAAY,YAAW,aAAa;IAEnC,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,QAAQ,CAAC,IAAI,WAAW;gBACK,GAAG,EAAE,MAAM;IAElC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAuB1F"}

package/dist/search/brave.js

@@ -0,0 +1,31 @@
+// Brave Search API adapter. Requires DEEPDIVE_BRAVE_KEY.
+export class BraveSearch {
+    key;
+    name = "brave";
+    constructor(key) {
+        this.key = key;
+    }
+    async search(query, limit, signal) {
+        const url = new URL("https://api.search.brave.com/res/v1/web/search");
+        url.searchParams.set("q", query);
+        url.searchParams.set("count", String(Math.min(limit, 20)));
+        const res = await fetch(url, {
+            headers: {
+                accept: "application/json",
+                "x-subscription-token": this.key,
+            },
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`brave ${res.status} ${res.statusText}`);
+        const json = (await res.json());
+        const items = json.web?.results ?? [];
+        return items.map((r, i) => ({
+            url: r.url,
+            title: r.title ?? "",
+            snippet: r.description ?? "",
+            rank: i + 1,
+        }));
+    }
+}
+//# sourceMappingURL=brave.js.map