@askalf/deepdive 0.13.2 → 0.14.0

package/dist/dates.js

@@ -0,0 +1,195 @@
+// Published-date extraction. Given a page's HTML, find when it was published
+// so the source table can annotate recency and the synthesizer can weigh fresh
+// sources over stale ones. Pure over the HTML string; no DOM, no deps.
+//
+// Precedence (first valid wins): JSON-LD datePublished -> publication-oriented
+// <meta> tags -> <time datetime> -> JSON-LD dateModified -> modified <meta>
+// tags. "published" beats "modified" everywhere because the question deepdive
+// answers is usually "how current is this claim", and the original publication
+// is the honest answer to that.
+// Returns the published date as epoch milliseconds, or undefined when no
+// trustworthy date is present. Dates outside a sane range (before 1990 or more
+// than ~2 days into the future) are rejected as parse noise.
+export function extractPublishedDate(html, now = Date.now()) {
+    const candidates = [];
+    const ld = jsonLdDates(html);
+    if (ld.published)
+        candidates.push(ld.published);
+    const metas = metaTags(html);
+    for (const key of PUBLISHED_META_KEYS) {
+        const hit = metas.get(key);
+        if (hit)
+            candidates.push(hit);
+    }
+    // First <time> element that carries a datetime attribute. Match the open tag
+    // with a single linear [^>]*, then read the attr from the bounded attribute
+    // string, so adversarial HTML can't trigger polynomial backtracking.
+    const timeRe = /<time\b([^>]*)>/gi;
+    let tm;
+    while ((tm = timeRe.exec(html)) !== null) {
+        const dt = attr(tm[1], "datetime");
+        if (dt) {
+            candidates.push(dt);
+            break;
+        }
+    }
+    if (ld.modified)
+        candidates.push(ld.modified);
+    for (const key of MODIFIED_META_KEYS) {
+        const hit = metas.get(key);
+        if (hit)
+            candidates.push(hit);
+    }
+    for (const c of candidates) {
+        const t = toEpoch(c, now);
+        if (t !== undefined)
+            return t;
+    }
+    return undefined;
+}
+// Publication-oriented meta keys, highest-trust first. Compared lowercased.
+const PUBLISHED_META_KEYS = [
+    "article:published_time",
+    "og:article:published_time",
+    "datepublished",
+    "parsely-pub-date",
+    "sailthru.date",
+    "pubdate",
+    "publishdate",
+    "publish-date",
+    "publication_date",
+    "dc.date.issued",
+    "dcterms.issued",
+    "dc.date",
+    "date",
+];
+const MODIFIED_META_KEYS = [
+    "article:modified_time",
+    "og:updated_time",
+    "datemodified",
+    "lastmod",
+];
+// Exported for unit tests. Parses every <meta> into a key->content map, keyed
+// by the lowercased name/property/itemprop. First occurrence of a key wins.
+export function metaTags(html) {
+    const out = new Map();
+    const re = /<meta\b([^>]*?)\/?>/gi;
+    let m;
+    while ((m = re.exec(html)) !== null) {
+        const attrs = m[1];
+        const key = (attr(attrs, "property") ??
+            attr(attrs, "name") ??
+            attr(attrs, "itemprop"))?.toLowerCase();
+        const content = attr(attrs, "content");
+        if (key && content && !out.has(key))
+            out.set(key, content);
+    }
+    return out;
+}
+function attr(attrs, name) {
+    const m = new RegExp(`\\b${name}\\s*=\\s*["']([^"']*)["']`, "i").exec(attrs);
+    return m ? m[1] : undefined;
+}
+// Exported for unit tests. Pulls datePublished / dateModified out of any
+// JSON-LD <script> block, walking arrays and @graph. Malformed JSON is skipped.
+export function jsonLdDates(html) {
+    const result = {};
+    // Match only the OPEN tag with a regex (single, linear [^>]*), then find the
+    // matching close with indexOf. A single regex spanning to the close tag can't
+    // be both complete (handle `</script foo>`) and linear — the literal-then-
+    // class shape backtracks polynomially on adversarial HTML (CodeQL). indexOf
+    // is linear and accepts every close-tag variant a browser does.
+    const openRe = /<script\b([^>]*)>/gi;
+    const typeRe = /type\s*=\s*["']application\/ld\+json["']/i;
+    // Lowercase once, not per close-tag scan — recomputing it inside the loop
+    // turns the whole pass O(n²) on a page with many <script> tags.
+    const lower = html.toLowerCase();
+    let m;
+    // Real pages carry a handful of JSON-LD blocks near the top; cap the number
+    // of <script> tags inspected so a malformed page with thousands of unclosed
+    // tags can't drive the close-tag scan into O(n²).
+    let scanned = 0;
+    while ((m = openRe.exec(html)) !== null) {
+        if (++scanned > 256)
+            break;
+        const contentStart = m.index + m[0].length;
+        const closeStart = findScriptClose(html, lower, contentStart);
+        if (closeStart !== -1) {
+            const gt = html.indexOf(">", closeStart + 8);
+            openRe.lastIndex = gt === -1 ? html.length : gt + 1;
+        }
+        if (!typeRe.test(m[1]))
+            continue;
+        const body = closeStart === -1 ? html.slice(contentStart) : html.slice(contentStart, closeStart);
+        let data;
+        try {
+            data = JSON.parse(body.trim());
+        }
+        catch {
+            continue;
+        }
+        walk(data, result);
+        if (result.published)
+            break; // best signal found
+    }
+    return result;
+}
+// Linear scan for the START index of the next `</script…>` close tag at or
+// after `from`. Accepts `</script>`, `</script >`, `</script foo>` — every form
+// a browser treats as a script end tag — but not `</scriptx>`. Returns -1 when
+// no close tag exists.
+function findScriptClose(html, lower, from) {
+    let i = lower.indexOf("</script", from);
+    while (i !== -1) {
+        const after = html[i + 8];
+        if (after === ">" || after === "/" || after === undefined || /\s/.test(after)) {
+            return i;
+        }
+        i = lower.indexOf("</script", i + 8);
+    }
+    return -1;
+}
+function walk(node, out) {
+    if (!node || typeof node !== "object")
+        return;
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            walk(item, out);
+            if (out.published)
+                return;
+        }
+        return;
+    }
+    const obj = node;
+    if (!out.published && typeof obj.datePublished === "string") {
+        out.published = obj.datePublished;
+    }
+    if (!out.modified && typeof obj.dateModified === "string") {
+        out.modified = obj.dateModified;
+    }
+    for (const v of Object.values(obj)) {
+        if (out.published)
+            return;
+        if (v && typeof v === "object")
+            walk(v, out);
+    }
+}
+// Exported for unit tests. Parse a date string to epoch ms, rejecting values
+// outside [1990-01-01, now + 2 days]. Bare YYYY / YYYY-MM are accepted.
+export function toEpoch(s, now = Date.now()) {
+    const trimmed = s.trim();
+    if (!trimmed)
+        return undefined;
+    // Reject pure-noise short strings that Date.parse would coerce oddly.
+    if (!/\d{4}/.test(trimmed))
+        return undefined;
+    const t = Date.parse(trimmed);
+    if (Number.isNaN(t))
+        return undefined;
+    const MIN = Date.UTC(1990, 0, 1);
+    const MAX = now + 2 * 86_400_000;
+    if (t < MIN || t > MAX)
+        return undefined;
+    return t;
+}
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

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

package/dist/diff.d.ts

@@ -0,0 +1,46 @@
+import type { SessionRecord } from "./sessions.js";
+import type { SourceWithContent } from "./synthesize.js";
+export interface SourceRef {
+    url: string;
+    title: string;
+}
+export type LineKind = "same" | "add" | "del";
+export interface DiffLine {
+    kind: LineKind;
+    text: string;
+}
+export interface SessionSide {
+    id: string;
+    question: string;
+    createdAt: number;
+    model: string;
+    sourceCount: number;
+    rounds: number;
+    costUsd: number;
+}
+export interface SessionDiff {
+    a: SessionSide;
+    b: SessionSide;
+    sources: {
+        added: SourceRef[];
+        removed: SourceRef[];
+        shared: SourceRef[];
+    };
+    answer: {
+        lines: DiffLine[];
+        added: number;
+        removed: number;
+        unchanged: number;
+    };
+}
+export declare function diffSessions(a: SessionRecord, b: SessionRecord): SessionDiff;
+export declare function diffSources(a: SourceWithContent[], b: SourceWithContent[]): SessionDiff["sources"];
+export declare function diffLines(a: string[], b: string[]): SessionDiff["answer"];
+export interface RenderDiffOptions {
+    color?: boolean;
+    context?: number;
+}
+export declare function renderDiffText(diff: SessionDiff, opts?: RenderDiffOptions): string;
+export declare const DIFF_NARRATE_SYSTEM = "You compare two research answers to the same (or a closely related) question, produced at different times. Summarize what substantively changed between the OLDER answer (A) and the NEWER answer (B).\n\nRules:\n- Focus on changes in facts, conclusions, numbers, and recommendations \u2014 not wording.\n- Lead with the single most important change.\n- Call out new claims in B, claims dropped from A, and any reversals.\n- If the two answers are materially the same, say so in one sentence.\n- Be concise: a short paragraph or a few bullets. No preamble.";
+export declare function buildDiffNarrateUser(a: SessionRecord, b: SessionRecord): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,WAAW,CAAC;IACf,CAAC,EAAE,WAAW,CAAC;IACf,OAAO,EAAE;QACP,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,OAAO,EAAE,SAAS,EAAE,CAAC;QACrB,MAAM,EAAE,SAAS,EAAE,CAAC;KACrB,CAAC;IACF,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,WAAW,CAO5E;AAgBD,wBAAgB,WAAW,CACzB,CAAC,EAAE,iBAAiB,EAAE,EACtB,CAAC,EAAE,iBAAiB,EAAE,GACrB,WAAW,CAAC,SAAS,CAAC,CAkBxB;AAYD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CA+CzE;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAyEtF;AA+DD,eAAO,MAAM,mBAAmB,8iBAO+B,CAAC;AAEhE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAQ/E"}

package/dist/diff.js

@@ -0,0 +1,227 @@
+// Session diff — compare two saved research sessions and show how the answer
+// (and the source set behind it) changed between them. The longitudinal use
+// case hosted tools structurally can't serve: "I asked this last month; what's
+// different now?" — answered entirely from your own local history.
+//
+// Pure over two SessionRecords. The LLM narration path (`--narrate`) only
+// builds the prompt here; the CLI owns the network call, keeping this module
+// I/O-free and unit-testable.
+import { dedupeKey } from "./url-util.js";
+export function diffSessions(a, b) {
+    return {
+        a: sideOf(a),
+        b: sideOf(b),
+        sources: diffSources(a.sources, b.sources),
+        answer: diffLines(splitLines(a.answer), splitLines(b.answer)),
+    };
+}
+function sideOf(r) {
+    return {
+        id: r.id,
+        question: r.question,
+        createdAt: r.createdAt,
+        model: r.llm?.model ?? "(unknown)",
+        sourceCount: r.sources.length,
+        rounds: r.rounds.length,
+        costUsd: typeof r.cost?.amountUsd === "number" ? r.cost.amountUsd : 0,
+    };
+}
+// Exported for unit tests. Source-set delta keyed on the normalized URL so
+// trailing slashes / fragments don't read as "different source".
+export function diffSources(a, b) {
+    const aKeys = new Map();
+    for (const s of a)
+        aKeys.set(dedupeKey(s.url), s);
+    const bKeys = new Map();
+    for (const s of b)
+        bKeys.set(dedupeKey(s.url), s);
+    const added = [];
+    const removed = [];
+    const shared = [];
+    for (const [k, s] of bKeys) {
+        if (aKeys.has(k))
+            shared.push(ref(s));
+        else
+            added.push(ref(s));
+    }
+    for (const [k, s] of aKeys) {
+        if (!bKeys.has(k))
+            removed.push(ref(s));
+    }
+    return { added, removed, shared };
+}
+function ref(s) {
+    return { url: s.url, title: s.title };
+}
+function splitLines(s) {
+    return s.replace(/\r\n/g, "\n").trimEnd().split("\n");
+}
+// Exported for unit tests. Standard LCS line diff. Answers are short (hundreds
+// of lines at most), so the O(n·m) DP table is well within budget.
+export function diffLines(a, b) {
+    const n = a.length;
+    const m = b.length;
+    // lcs[i][j] = length of LCS of a[i:] and b[j:].
+    const lcs = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            lcs[i][j] =
+                a[i] === b[j]
+                    ? lcs[i + 1][j + 1] + 1
+                    : Math.max(lcs[i + 1][j], lcs[i][j + 1]);
+        }
+    }
+    const lines = [];
+    let added = 0;
+    let removed = 0;
+    let unchanged = 0;
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (a[i] === b[j]) {
+            lines.push({ kind: "same", text: a[i] });
+            unchanged++;
+            i++;
+            j++;
+        }
+        else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+            lines.push({ kind: "del", text: a[i] });
+            removed++;
+            i++;
+        }
+        else {
+            lines.push({ kind: "add", text: b[j] });
+            added++;
+            j++;
+        }
+    }
+    while (i < n) {
+        lines.push({ kind: "del", text: a[i++] });
+        removed++;
+    }
+    while (j < m) {
+        lines.push({ kind: "add", text: b[j++] });
+        added++;
+    }
+    return { lines, added, removed, unchanged };
+}
+// Exported for unit tests. Terminal-friendly rendering of a SessionDiff.
+export function renderDiffText(diff, opts = {}) {
+    const color = opts.color ?? false;
+    const ctx = opts.context ?? 2;
+    const g = (s) => (color ? `\x1b[32m${s}\x1b[0m` : s);
+    const r = (s) => (color ? `\x1b[31m${s}\x1b[0m` : s);
+    const dim = (s) => (color ? `\x1b[2m${s}\x1b[0m` : s);
+    const out = [];
+    out.push(`diff  ${diff.a.id}  →  ${diff.b.id}`);
+    out.push(dim(`      ${ageBetween(diff.a.createdAt, diff.b.createdAt)} apart` +
+        ` · ${fmtDate(diff.a.createdAt)} → ${fmtDate(diff.b.createdAt)}`));
+    if (diff.a.question !== diff.b.question) {
+        out.push("");
+        out.push(`  question  ${r("- " + diff.a.question)}`);
+        out.push(`            ${g("+ " + diff.b.question)}`);
+    }
+    out.push("");
+    out.push("  metadata");
+    out.push(metaRow("model", diff.a.model, diff.b.model, g, r));
+    out.push(metaRow("sources", String(diff.a.sourceCount), String(diff.b.sourceCount), g, r));
+    out.push(metaRow("rounds", String(diff.a.rounds), String(diff.b.rounds), g, r));
+    out.push(metaRow("cost", `$${diff.a.costUsd.toFixed(4)}`, `$${diff.b.costUsd.toFixed(4)}`, g, r));
+    out.push("");
+    const { added, removed, shared } = diff.sources;
+    out.push(`  sources   ${g("+" + added.length)} / ${r("-" + removed.length)} / ${shared.length} shared`);
+    for (const s of added)
+        out.push("    " + g(`+ ${s.url}`));
+    for (const s of removed)
+        out.push("    " + r(`- ${s.url}`));
+    out.push("");
+    out.push(`  answer    ${g("+" + diff.answer.added)} / ${r("-" + diff.answer.removed)} lines` +
+        ` (${diff.answer.unchanged} unchanged)`);
+    if (diff.answer.added === 0 && diff.answer.removed === 0) {
+        out.push(dim("    (answer text identical)"));
+    }
+    else {
+        out.push("");
+        for (const block of collapseContext(diff.answer.lines, ctx)) {
+            if (block.kind === "gap") {
+                out.push(dim(`    … ${block.count} unchanged line${block.count === 1 ? "" : "s"} …`));
+                continue;
+            }
+            const prefix = block.line.kind === "add" ? g("  + ") : block.line.kind === "del" ? r("  - ") : "    ";
+            const text = block.line.kind === "add"
+                ? g(block.line.text)
+                : block.line.kind === "del"
+                    ? r(block.line.text)
+                    : block.line.text;
+            out.push(prefix + text);
+        }
+    }
+    return out.join("\n");
+}
+// Collapse long runs of unchanged lines, keeping `ctx` lines of context on
+// either side of each change.
+function collapseContext(lines, ctx) {
+    const keep = new Array(lines.length).fill(false);
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].kind !== "same") {
+            for (let k = Math.max(0, i - ctx); k <= Math.min(lines.length - 1, i + ctx); k++) {
+                keep[k] = true;
+            }
+        }
+    }
+    const blocks = [];
+    let gap = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (keep[i]) {
+            if (gap > 0) {
+                blocks.push({ kind: "gap", count: gap });
+                gap = 0;
+            }
+            blocks.push({ kind: "line", line: lines[i] });
+        }
+        else {
+            gap++;
+        }
+    }
+    if (gap > 0)
+        blocks.push({ kind: "gap", count: gap });
+    return blocks;
+}
+function metaRow(label, a, b, g, r) {
+    if (a === b)
+        return `    ${label.padEnd(9)} ${a}`;
+    return `    ${label.padEnd(9)} ${r(a)} → ${g(b)}`;
+}
+function fmtDate(ms) {
+    const d = new Date(ms);
+    return Number.isNaN(d.getTime()) ? "?" : d.toISOString().slice(0, 10);
+}
+function ageBetween(a, b) {
+    const ms = Math.abs(b - a);
+    const days = Math.floor(ms / 86_400_000);
+    if (days >= 1)
+        return `${days}d`;
+    const hours = Math.floor(ms / 3_600_000);
+    if (hours >= 1)
+        return `${hours}h`;
+    const mins = Math.floor(ms / 60_000);
+    return `${mins}m`;
+}
+// ── LLM narration (--narrate) ────────────────────────────────────────────────
+// diff.ts stays I/O-free: it only builds the prompt. The CLI runs the call.
+export const DIFF_NARRATE_SYSTEM = `You compare two research answers to the same (or a closely related) question, produced at different times. Summarize what substantively changed between the OLDER answer (A) and the NEWER answer (B).
+
+Rules:
+- Focus on changes in facts, conclusions, numbers, and recommendations — not wording.
+- Lead with the single most important change.
+- Call out new claims in B, claims dropped from A, and any reversals.
+- If the two answers are materially the same, say so in one sentence.
+- Be concise: a short paragraph or a few bullets. No preamble.`;
+export function buildDiffNarrateUser(a, b) {
+    return (`Question (A, older — ${fmtDate(a.createdAt)}): ${a.question}\n` +
+        `Question (B, newer — ${fmtDate(b.createdAt)}): ${b.question}\n\n` +
+        `=== ANSWER A (older) ===\n${a.answer}\n\n` +
+        `=== ANSWER B (newer) ===\n${b.answer}\n\n` +
+        `Summarize what changed from A to B.`);
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/html-export.d.ts

@@ -0,0 +1,6 @@
+import type { SessionRecord } from "./sessions.js";
+export interface HtmlReportOptions {
+    footer?: string;
+}
+export declare function renderHtmlReport(record: SessionRecord, opts?: HtmlReportOptions): string;
+//# sourceMappingURL=html-export.d.ts.map

package/dist/html-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-export.d.ts","sourceRoot":"","sources":["../src/html-export.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAKnD,MAAM,WAAW,iBAAiB;IAGhC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,iBAAsB,GAC3B,MAAM,CAgCR"}

package/dist/html-export.js

@@ -0,0 +1,146 @@
+// HTML export — turn a saved session into a single, self-contained,
+// shareable HTML document. No external assets, no scripts, inline CSS only,
+// so the file works offline, opens in any browser, and can be emailed or
+// committed as an artifact. Pure over a SessionRecord.
+//
+// This is the "polished artifact" that hosted research tools produce and the
+// terminal markdown doesn't: the thing you hand to a colleague. The answer's
+// markdown is rendered via the hand-rolled src/markdown.ts so there's still
+// zero runtime dependency.
+import { markdownToHtml, escapeHtml } from "./markdown.js";
+const CITATION_ANCHOR_PREFIX = "source-";
+const DEFAULT_FOOTER = 'Generated by <a href="https://github.com/askalf/deepdive" rel="noopener noreferrer">deepdive</a>' +
+    ' — a local research agent from <a href="https://sprayberrylabs.com" rel="noopener noreferrer">Sprayberry Labs</a>.';
+export function renderHtmlReport(record, opts = {}) {
+    const title = escapeHtml(oneLine(record.question)) || "deepdive report";
+    const body = markdownToHtml(record.answer, {
+        citationAnchorPrefix: CITATION_ANCHOR_PREFIX,
+    });
+    const meta = renderMetaLine(record);
+    const sources = renderSourcesHtml(record);
+    const footer = opts.footer === undefined ? DEFAULT_FOOTER : opts.footer;
+    const footerHtml = footer ? `\n  <footer>${footer}</footer>` : "";
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="generator" content="deepdive">
+<title>${title}</title>
+<style>${STYLE}</style>
+</head>
+<body>
+<main>
+  <h1>${title}</h1>
+  ${meta}
+  <article>
+${body}
+  </article>
+${sources}${footerHtml}
+</main>
+</body>
+</html>
+`;
+}
+function renderMetaLine(record) {
+    const parts = [];
+    const created = new Date(record.createdAt);
+    if (!Number.isNaN(created.getTime())) {
+        parts.push(`<time datetime="${created.toISOString()}">${created.toISOString().slice(0, 10)}</time>`);
+    }
+    if (record.llm?.model)
+        parts.push(escapeHtml(record.llm.model));
+    const n = record.sources.length;
+    parts.push(`${n} source${n === 1 ? "" : "s"}`);
+    if (record.rounds.length > 0) {
+        parts.push(`${record.rounds.length} round${record.rounds.length === 1 ? "" : "s"}`);
+    }
+    const cost = record.cost?.amountUsd;
+    if (typeof cost === "number" && Number.isFinite(cost) && cost > 0) {
+        parts.push(`~$${cost.toFixed(cost < 0.01 ? 4 : 2)}`);
+    }
+    return `<p class="meta">${parts.join(" &middot; ")}</p>`;
+}
+function renderSourcesHtml(record) {
+    if (record.sources.length === 0)
+        return "";
+    const items = record.sources
+        .map((s) => {
+        const date = new Date(s.fetchedAt);
+        const fetched = Number.isNaN(date.getTime())
+            ? ""
+            : `fetched ${date.toISOString().slice(0, 10)}`;
+        const pub = typeof s.publishedAt === "number"
+            ? `published ${new Date(s.publishedAt).toISOString().slice(0, 10)}`
+            : "";
+        const metaBits = [pub, fetched].filter(Boolean).join(" · ");
+        const dateStr = metaBits ? ` <span class="fetched">${metaBits}</span>` : "";
+        const safeUrl = escapeHtml(s.url);
+        const label = escapeHtml(oneLine(s.title)) || safeUrl;
+        const safeHref = isSafeHref(s.url) ? safeUrl : "#";
+        return `    <li id="${CITATION_ANCHOR_PREFIX}${s.id}"><a href="${safeHref}" rel="noopener noreferrer">${label}</a>${dateStr}</li>`;
+    })
+        .join("\n");
+    return `  <section class="sources">\n    <h2>Sources</h2>\n    <ol>\n${items}\n    </ol>\n  </section>`;
+}
+function isSafeHref(url) {
+    return /^(https?:|mailto:|file:)/i.test(url);
+}
+function oneLine(s) {
+    return s.replace(/\s+/g, " ").trim();
+}
+// Inline stylesheet — readable typography, light/dark aware, print-friendly.
+const STYLE = `
+:root { color-scheme: light dark; }
+* { box-sizing: border-box; }
+body {
+  margin: 0;
+  font: 16px/1.65 -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+  color: #1a1a1a;
+  background: #fbfbfa;
+}
+main { max-width: 46rem; margin: 0 auto; padding: 3rem 1.25rem 4rem; }
+h1 { font-size: 1.85rem; line-height: 1.25; margin: 0 0 0.5rem; letter-spacing: -0.01em; }
+h2 { font-size: 1.3rem; margin: 2rem 0 0.75rem; }
+h3 { font-size: 1.1rem; margin: 1.5rem 0 0.5rem; }
+h4, h5, h6 { margin: 1.25rem 0 0.5rem; }
+p { margin: 0 0 1rem; }
+a { color: #1a56db; text-decoration: none; }
+a:hover { text-decoration: underline; }
+.meta { color: #6b7280; font-size: 0.85rem; margin: 0 0 2rem; }
+article { font-size: 1.02rem; }
+ul, ol { padding-left: 1.5rem; margin: 0 0 1rem; }
+li { margin: 0.3rem 0; }
+blockquote { margin: 0 0 1rem; padding: 0.4rem 1rem; border-left: 3px solid #d1d5db; color: #4b5563; }
+code { font: 0.88em ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; background: #f0f0ef; padding: 0.1em 0.35em; border-radius: 4px; }
+pre { background: #f0f0ef; padding: 1rem; border-radius: 8px; overflow-x: auto; margin: 0 0 1rem; }
+pre code { background: none; padding: 0; }
+table { border-collapse: collapse; width: 100%; margin: 0 0 1.25rem; font-size: 0.95rem; }
+th, td { border: 1px solid #e5e7eb; padding: 0.5rem 0.7rem; text-align: left; vertical-align: top; }
+th { background: #f3f4f6; font-weight: 600; }
+hr { border: none; border-top: 1px solid #e5e7eb; margin: 2rem 0; }
+sup.cite { font-size: 0.7em; line-height: 0; }
+sup.cite a { padding: 0 0.1em; }
+.sources { margin-top: 2.5rem; border-top: 1px solid #e5e7eb; padding-top: 1rem; }
+.sources li { margin: 0.45rem 0; }
+.sources .fetched { color: #9ca3af; font-size: 0.82rem; }
+:target { background: #fff3bf; scroll-margin-top: 1rem; }
+footer { margin-top: 3rem; padding-top: 1.25rem; border-top: 1px solid #e5e7eb; color: #9ca3af; font-size: 0.82rem; }
+@media (prefers-color-scheme: dark) {
+  body { color: #e5e7eb; background: #18181b; }
+  a { color: #7aa7ff; }
+  .meta, footer { color: #9ca3af; }
+  blockquote { border-left-color: #3f3f46; color: #a1a1aa; }
+  code, pre { background: #27272a; }
+  th { background: #27272a; }
+  th, td { border-color: #3f3f46; }
+  hr, .sources, footer { border-color: #3f3f46; }
+  :target { background: #422006; }
+}
+@media print {
+  body { background: #fff; }
+  main { max-width: none; padding: 0; }
+  a { color: inherit; }
+}
+`.trim();
+//# sourceMappingURL=html-export.js.map