npm - @alextis59/athena - Versions diffs - 1.0.0 - Mend

@alextis59/athena 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (201) hide show

package/LICENSE +15 -0
package/README.md +147 -0
package/dist/agent/ask.d.ts +7 -0
package/dist/agent/ask.d.ts.map +1 -0
package/dist/agent/ask.js +35 -0
package/dist/agent/ask.js.map +1 -0
package/dist/agent/citations.d.ts +27 -0
package/dist/agent/citations.d.ts.map +1 -0
package/dist/agent/citations.js +190 -0
package/dist/agent/citations.js.map +1 -0
package/dist/agent/fake-provider.d.ts +9 -0
package/dist/agent/fake-provider.d.ts.map +1 -0
package/dist/agent/fake-provider.js +51 -0
package/dist/agent/fake-provider.js.map +1 -0
package/dist/agent/index.d.ts +10 -0
package/dist/agent/index.d.ts.map +1 -0
package/dist/agent/index.js +6 -0
package/dist/agent/index.js.map +1 -0
package/dist/agent/loop.d.ts +11 -0
package/dist/agent/loop.d.ts.map +1 -0
package/dist/agent/loop.js +156 -0
package/dist/agent/loop.js.map +1 -0
package/dist/agent/providers.d.ts +17 -0
package/dist/agent/providers.d.ts.map +1 -0
package/dist/agent/providers.js +171 -0
package/dist/agent/providers.js.map +1 -0
package/dist/agent/tools.d.ts +8 -0
package/dist/agent/tools.d.ts.map +1 -0
package/dist/agent/tools.js +233 -0
package/dist/agent/tools.js.map +1 -0
package/dist/agent/types.d.ts +84 -0
package/dist/agent/types.d.ts.map +1 -0
package/dist/agent/types.js +2 -0
package/dist/agent/types.js.map +1 -0
package/dist/cli/help.d.ts +2 -0
package/dist/cli/help.d.ts.map +1 -0
package/dist/cli/help.js +28 -0
package/dist/cli/help.js.map +1 -0
package/dist/cli/main.d.ts +3 -0
package/dist/cli/main.d.ts.map +1 -0
package/dist/cli/main.js +5 -0
package/dist/cli/main.js.map +1 -0
package/dist/cli/options.d.ts +21 -0
package/dist/cli/options.d.ts.map +1 -0
package/dist/cli/options.js +97 -0
package/dist/cli/options.js.map +1 -0
package/dist/cli/run.d.ts +21 -0
package/dist/cli/run.d.ts.map +1 -0
package/dist/cli/run.js +144 -0
package/dist/cli/run.js.map +1 -0
package/dist/config/index.d.ts +4 -0
package/dist/config/index.d.ts.map +1 -0
package/dist/config/index.js +3 -0
package/dist/config/index.js.map +1 -0
package/dist/config/loader.d.ts +14 -0
package/dist/config/loader.d.ts.map +1 -0
package/dist/config/loader.js +352 -0
package/dist/config/loader.js.map +1 -0
package/dist/config/schema.d.ts +6 -0
package/dist/config/schema.d.ts.map +1 -0
package/dist/config/schema.js +72 -0
package/dist/config/schema.js.map +1 -0
package/dist/config/types.d.ts +53 -0
package/dist/config/types.d.ts.map +1 -0
package/dist/config/types.js +2 -0
package/dist/config/types.js.map +1 -0
package/dist/doctor/doctor.d.ts +47 -0
package/dist/doctor/doctor.d.ts.map +1 -0
package/dist/doctor/doctor.js +159 -0
package/dist/doctor/doctor.js.map +1 -0
package/dist/embeddings/index.d.ts +117 -0
package/dist/embeddings/index.d.ts.map +1 -0
package/dist/embeddings/index.js +515 -0
package/dist/embeddings/index.js.map +1 -0
package/dist/errors.d.ts +19 -0
package/dist/errors.d.ts.map +1 -0
package/dist/errors.js +37 -0
package/dist/errors.js.map +1 -0
package/dist/index.d.ts +17 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +9 -0
package/dist/index.js.map +1 -0
package/dist/indexer/discovery.d.ts +10 -0
package/dist/indexer/discovery.d.ts.map +1 -0
package/dist/indexer/discovery.js +38 -0
package/dist/indexer/discovery.js.map +1 -0
package/dist/indexer/hash.d.ts +3 -0
package/dist/indexer/hash.d.ts.map +1 -0
package/dist/indexer/hash.js +11 -0
package/dist/indexer/hash.js.map +1 -0
package/dist/indexer/index.d.ts +7 -0
package/dist/indexer/index.d.ts.map +1 -0
package/dist/indexer/index.js +5 -0
package/dist/indexer/index.js.map +1 -0
package/dist/indexer/kinds.d.ts +4 -0
package/dist/indexer/kinds.d.ts.map +1 -0
package/dist/indexer/kinds.js +38 -0
package/dist/indexer/kinds.js.map +1 -0
package/dist/indexer/run.d.ts +42 -0
package/dist/indexer/run.d.ts.map +1 -0
package/dist/indexer/run.js +563 -0
package/dist/indexer/run.js.map +1 -0
package/dist/logging/logger.d.ts +11 -0
package/dist/logging/logger.d.ts.map +1 -0
package/dist/logging/logger.js +18 -0
package/dist/logging/logger.js.map +1 -0
package/dist/mcp/index.d.ts +35 -0
package/dist/mcp/index.d.ts.map +1 -0
package/dist/mcp/index.js +392 -0
package/dist/mcp/index.js.map +1 -0
package/dist/parsers/chunking.d.ts +4 -0
package/dist/parsers/chunking.d.ts.map +1 -0
package/dist/parsers/chunking.js +112 -0
package/dist/parsers/chunking.js.map +1 -0
package/dist/parsers/index.d.ts +8 -0
package/dist/parsers/index.d.ts.map +1 -0
package/dist/parsers/index.js +5 -0
package/dist/parsers/index.js.map +1 -0
package/dist/parsers/line-parser.d.ts +13 -0
package/dist/parsers/line-parser.d.ts.map +1 -0
package/dist/parsers/line-parser.js +242 -0
package/dist/parsers/line-parser.js.map +1 -0
package/dist/parsers/normalize.d.ts +4 -0
package/dist/parsers/normalize.d.ts.map +1 -0
package/dist/parsers/normalize.js +17 -0
package/dist/parsers/normalize.js.map +1 -0
package/dist/parsers/parser.d.ts +14 -0
package/dist/parsers/parser.d.ts.map +1 -0
package/dist/parsers/parser.js +77 -0
package/dist/parsers/parser.js.map +1 -0
package/dist/parsers/pdf2llm.d.ts +14 -0
package/dist/parsers/pdf2llm.d.ts.map +1 -0
package/dist/parsers/pdf2llm.js +215 -0
package/dist/parsers/pdf2llm.js.map +1 -0
package/dist/parsers/types.d.ts +48 -0
package/dist/parsers/types.d.ts.map +1 -0
package/dist/parsers/types.js +2 -0
package/dist/parsers/types.js.map +1 -0
package/dist/retrieval/index.d.ts +4 -0
package/dist/retrieval/index.d.ts.map +1 -0
package/dist/retrieval/index.js +3 -0
package/dist/retrieval/index.js.map +1 -0
package/dist/retrieval/schemas.d.ts +127 -0
package/dist/retrieval/schemas.d.ts.map +1 -0
package/dist/retrieval/schemas.js +65 -0
package/dist/retrieval/schemas.js.map +1 -0
package/dist/retrieval/tools.d.ts +31 -0
package/dist/retrieval/tools.d.ts.map +1 -0
package/dist/retrieval/tools.js +803 -0
package/dist/retrieval/tools.js.map +1 -0
package/dist/retrieval/types.d.ts +104 -0
package/dist/retrieval/types.d.ts.map +1 -0
package/dist/retrieval/types.js +2 -0
package/dist/retrieval/types.js.map +1 -0
package/dist/server/index.d.ts +3 -0
package/dist/server/index.d.ts.map +1 -0
package/dist/server/index.js +2 -0
package/dist/server/index.js.map +1 -0
package/dist/server/server.d.ts +49 -0
package/dist/server/server.d.ts.map +1 -0
package/dist/server/server.js +517 -0
package/dist/server/server.js.map +1 -0
package/dist/shared/types.d.ts +98 -0
package/dist/shared/types.d.ts.map +1 -0
package/dist/shared/types.js +2 -0
package/dist/shared/types.js.map +1 -0
package/dist/storage/database.d.ts +18 -0
package/dist/storage/database.d.ts.map +1 -0
package/dist/storage/database.js +66 -0
package/dist/storage/database.js.map +1 -0
package/dist/storage/index.d.ts +8 -0
package/dist/storage/index.d.ts.map +1 -0
package/dist/storage/index.js +5 -0
package/dist/storage/index.js.map +1 -0
package/dist/storage/migrations.d.ts +15 -0
package/dist/storage/migrations.d.ts.map +1 -0
package/dist/storage/migrations.js +170 -0
package/dist/storage/migrations.js.map +1 -0
package/dist/storage/paths.d.ts +15 -0
package/dist/storage/paths.d.ts.map +1 -0
package/dist/storage/paths.js +27 -0
package/dist/storage/paths.js.map +1 -0
package/dist/storage/schema.d.ts +11 -0
package/dist/storage/schema.d.ts.map +1 -0
package/dist/storage/schema.js +40 -0
package/dist/storage/schema.js.map +1 -0
package/dist/ui/index.d.ts +2 -0
package/dist/ui/index.d.ts.map +1 -0
package/dist/ui/index.js +2 -0
package/dist/ui/index.js.map +1 -0
package/dist/ui/static-app.d.ts +2 -0
package/dist/ui/static-app.d.ts.map +1 -0
package/dist/ui/static-app.js +735 -0
package/dist/ui/static-app.js.map +1 -0
package/docs/adr/0001-sqlite-driver.md +23 -0
package/docs/agentic-rag-specifications.md +659 -0
package/docs/agentic-rag-study.md +1056 -0
package/docs/implementation-plan.md +1425 -0
package/docs/mcp-integration.md +154 -0
package/docs/validation-corpus.md +71 -0
package/package.json +79 -0

package/dist/ui/static-app.js ADDED Viewed

@@ -0,0 +1,735 @@
+export function renderAppHtml() {
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Athena</title>
+    <style>
+      :root {
+        color-scheme: light;
+        --bg: #f6f6f2;
+        --panel: #ffffff;
+        --ink: #1d2522;
+        --muted: #5d6863;
+        --line: #d8ded8;
+        --accent: #1d6f5f;
+        --accent-weak: #dceee9;
+        font-family:
+          Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
+          "Segoe UI", sans-serif;
+      }
+      * {
+        box-sizing: border-box;
+      }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        background: var(--bg);
+        color: var(--ink);
+      }
+      .shell {
+        display: grid;
+        grid-template-columns: minmax(220px, 280px) minmax(0, 1fr) minmax(280px, 420px);
+        min-height: 100vh;
+      }
+      aside,
+      main,
+      section {
+        min-width: 0;
+      }
+      aside {
+        border-right: 1px solid var(--line);
+        padding: 18px;
+        background: #eef3ef;
+      }
+      main {
+        padding: 18px;
+      }
+      section {
+        border-left: 1px solid var(--line);
+        padding: 18px;
+        background: #fbfbf8;
+      }
+      h1,
+      h2 {
+        margin: 0 0 12px;
+        font-size: 18px;
+        letter-spacing: 0;
+      }
+      h2 {
+        margin-top: 18px;
+        font-size: 14px;
+        color: var(--muted);
+        text-transform: uppercase;
+      }
+      .status,
+      .result,
+      .trace,
+      pre {
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        background: var(--panel);
+      }
+      .status,
+      .trace {
+        padding: 12px;
+      }
+      .status {
+        display: grid;
+        gap: 8px;
+      }
+      .status[data-status-state="ready"] {
+        border-color: #8bc4a9;
+      }
+      .status[data-status-state="stale"],
+      .status[data-status-state="indexing"] {
+        border-color: #c7a64a;
+      }
+      .status[data-status-state="error"] {
+        border-color: #cf7b72;
+      }
+      .status-head {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        font-weight: 700;
+      }
+      .status-dot {
+        width: 10px;
+        height: 10px;
+        border-radius: 999px;
+        background: #8b9691;
+        flex: 0 0 auto;
+      }
+      .status[data-status-state="ready"] .status-dot {
+        background: #1d6f5f;
+      }
+      .status[data-status-state="stale"] .status-dot {
+        background: #b17d11;
+      }
+      .status[data-status-state="indexing"] .status-dot {
+        background: #2864b4;
+      }
+      .status[data-status-state="error"] .status-dot {
+        background: #b43d32;
+      }
+      .status-detail {
+        color: var(--muted);
+        font-size: 12px;
+        line-height: 1.4;
+      }
+      .metric {
+        display: flex;
+        justify-content: space-between;
+        gap: 12px;
+        padding: 6px 0;
+        color: var(--muted);
+        font-size: 13px;
+      }
+      form {
+        display: flex;
+        gap: 8px;
+        margin-bottom: 14px;
+      }
+      label {
+        display: grid;
+        gap: 6px;
+        margin-bottom: 12px;
+        color: var(--muted);
+        font-size: 12px;
+      }
+      input,
+      select,
+      button {
+        height: 38px;
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        font: inherit;
+      }
+      input,
+      select {
+        flex: 1;
+        min-width: 0;
+        padding: 0 10px;
+        background: var(--panel);
+        color: var(--ink);
+      }
+      button {
+        padding: 0 14px;
+        background: var(--accent);
+        color: white;
+        border-color: var(--accent);
+        cursor: pointer;
+      }
+      .results {
+        display: grid;
+        gap: 10px;
+      }
+      .empty {
+        color: var(--muted);
+        padding: 14px 0;
+      }
+      .result {
+        padding: 12px;
+      }
+      .result-actions {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 8px;
+      }
+      .badges,
+      .asset-links {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 6px;
+        margin-top: 8px;
+      }
+      .badge {
+        border: 1px solid var(--line);
+        border-radius: 999px;
+        padding: 3px 8px;
+        background: #f8faf8;
+        color: var(--muted);
+        font-size: 12px;
+      }
+      .badge-warning {
+        border-color: #e0b85e;
+        background: #fff7df;
+        color: #7d540c;
+      }
+      .result button {
+        height: auto;
+        min-height: 32px;
+        margin-top: 8px;
+        background: var(--accent-weak);
+        border-color: var(--accent-weak);
+        color: var(--accent);
+      }
+      .path {
+        font-weight: 700;
+        overflow-wrap: anywhere;
+      }
+      .meta {
+        margin-top: 4px;
+        color: var(--muted);
+        font-size: 12px;
+      }
+      .snippet {
+        margin-top: 6px;
+        color: var(--muted);
+        line-height: 1.45;
+      }
+      pre {
+        min-height: 240px;
+        max-height: calc(100vh - 160px);
+        margin: 0;
+        overflow: auto;
+        padding: 12px;
+        white-space: pre-wrap;
+      }
+      .asset-links button {
+        height: auto;
+        min-height: 30px;
+        background: var(--accent-weak);
+        border-color: var(--accent-weak);
+        color: var(--accent);
+      }
+      @media (max-width: 900px) {
+        .shell {
+          grid-template-columns: 1fr;
+        }
+        aside,
+        section {
+          border: 0;
+          border-bottom: 1px solid var(--line);
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <div class="shell" data-athena-chat>
+      <aside>
+        <h1>Athena</h1>
+        <div class="status" id="status"></div>
+        <h2>Filters</h2>
+        <label>
+          Path prefix
+          <input id="path-prefix" autocomplete="off" placeholder="docs/" />
+        </label>
+        <label>
+          Source kind
+          <select id="kind">
+            <option value="">All kinds</option>
+            <option value="markdown">Markdown</option>
+            <option value="mdx">MDX</option>
+            <option value="text">Text</option>
+            <option value="rst">reStructuredText</option>
+            <option value="asciidoc">AsciiDoc</option>
+            <option value="html">HTML</option>
+            <option value="pdf">PDF</option>
+          </select>
+        </label>
+      </aside>
+      <main>
+        <h2>Search</h2>
+        <form id="search-form">
+          <input id="query" name="query" autocomplete="off" placeholder="Ask local docs" />
+          <button type="submit">Search</button>
+        </form>
+        <div class="results" id="results"></div>
+      </main>
+      <section>
+        <h2>Source</h2>
+        <pre id="preview"></pre>
+        <div class="asset-links" id="asset-links"></div>
+        <h2>Trace</h2>
+        <div class="trace" id="trace"></div>
+      </section>
+    </div>
+    <script>
+      const statusEl = document.querySelector("#status");
+      const resultsEl = document.querySelector("#results");
+      const previewEl = document.querySelector("#preview");
+      const assetLinksEl = document.querySelector("#asset-links");
+      const traceEl = document.querySelector("#trace");
+      const form = document.querySelector("#search-form");
+      const queryEl = document.querySelector("#query");
+      const pathPrefixEl = document.querySelector("#path-prefix");
+      const kindEl = document.querySelector("#kind");
+      let latestResults = [];
+      async function getJson(url) {
+        const response = await fetch(url);
+        const payload = await response.json();
+        if (!response.ok) {
+          throw new Error(payload.error || "Request failed");
+        }
+        return payload;
+      }
+      async function refreshStatus() {
+        const status = await getJson("/api/status");
+        renderStatus(status);
+      }
+      function renderStatus(status) {
+        const indicator = status.indicator || {
+          state: "error",
+          label: "Status unavailable",
+          detail: "The index status endpoint returned an unknown response.",
+          tone: "danger"
+        };
+        const head = document.createElement("div");
+        const dot = document.createElement("span");
+        const label = document.createElement("span");
+        const detail = document.createElement("div");
+        statusEl.replaceChildren();
+        statusEl.dataset.statusState = indicator.state;
+        statusEl.dataset.statusTone = indicator.tone;
+        head.className = "status-head";
+        dot.className = "status-dot";
+        dot.setAttribute("aria-hidden", "true");
+        label.textContent = indicator.label;
+        head.append(dot, label);
+        detail.className = "status-detail";
+        detail.textContent = indicator.detail;
+        statusEl.append(head, detail);
+        [
+          ["State", status.state],
+          ["Schema", status.database.schemaVersion ?? "missing"],
+          ["Sources", status.counts.sources],
+          ["Chunks", status.counts.chunks],
+          ["Last run", status.lastRun?.status ?? "none"]
+        ].forEach(([label, value]) => {
+          const row = document.createElement("div");
+          const name = document.createElement("span");
+          const strong = document.createElement("strong");
+          row.className = "metric";
+          name.textContent = label;
+          strong.textContent = String(value);
+          row.append(name, strong);
+          statusEl.append(row);
+        });
+      }
+      async function search(query) {
+        const params = new URLSearchParams({ q: query });
+        if (pathPrefixEl.value.trim()) {
+          params.set("pathPrefix", pathPrefixEl.value.trim());
+        }
+        if (kindEl.value) {
+          params.set("kind", kindEl.value);
+        }
+        const payload = await getJson("/api/search?" + params.toString());
+        latestResults = payload.results;
+        renderTrace(payload.trace);
+        renderResults(payload.results);
+      }
+      function renderResults(results) {
+        resultsEl.replaceChildren();
+        if (results.length === 0) {
+          const empty = document.createElement("div");
+          empty.className = "empty";
+          empty.textContent = "No indexed source matched this query.";
+          resultsEl.append(empty);
+          return;
+        }
+        for (const item of results) {
+          const node = document.createElement("article");
+          const pathNode = document.createElement("div");
+          const metaNode = document.createElement("div");
+          const badgesNode = document.createElement("div");
+          const snippetNode = document.createElement("div");
+          const actions = document.createElement("div");
+          const openButton = document.createElement("button");
+          const sourceButton = document.createElement("button");
+          const copyButton = document.createElement("button");
+          node.className = "result";
+          pathNode.className = "path";
+          metaNode.className = "meta";
+          badgesNode.className = "badges";
+          snippetNode.className = "snippet";
+          actions.className = "result-actions";
+          pathNode.textContent = item.path;
+          metaNode.textContent = resultMeta(item);
+          snippetNode.textContent = item.snippet;
+          renderLocatorBadges(item.locator, badgesNode);
+          openButton.type = "button";
+          openButton.textContent =
+            item.locator.type === "pdf" ? "Open PDF preview" : "Open lines";
+          openButton.addEventListener("click", async () => {
+            if (item.locator.type === "pdf") {
+              await openPdfPreview(item);
+              return;
+            }
+            await openTextRange(item);
+          });
+          sourceButton.type = "button";
+          sourceButton.textContent = "Open source";
+          sourceButton.disabled = item.locator.type === "pdf";
+          sourceButton.addEventListener("click", async () => {
+            const params = new URLSearchParams({ path: item.path });
+            const source = await getJson("/api/source?" + params.toString());
+            previewEl.textContent = source.text;
+            assetLinksEl.replaceChildren();
+          });
+          copyButton.type = "button";
+          copyButton.textContent = "Copy citation";
+          copyButton.addEventListener("click", async () => {
+            await writeClipboard(formatCopiedResult(item));
+          });
+          actions.append(openButton, sourceButton, copyButton);
+          node.append(pathNode, metaNode, badgesNode, snippetNode, actions);
+          resultsEl.append(node);
+        }
+      }
+      async function openTextRange(item) {
+        const params = new URLSearchParams({
+          path: item.path,
+          startLine: String(item.locator.startLine),
+          endLine: String(item.locator.endLine)
+        });
+        const source = await getJson("/api/read?" + params.toString());
+        previewEl.textContent = source.text;
+        assetLinksEl.replaceChildren();
+      }
+      async function openPdfPreview(item) {
+        const params = new URLSearchParams({
+          path: item.path,
+          page: String(item.locator.page)
+        });
+        if (item.locator.regionId) {
+          params.set("regionId", item.locator.regionId);
+        }
+        const payload = await getJson("/api/pdf?" + params.toString());
+        previewEl.textContent = formatPdfPreview(payload.pdf);
+        renderPdfAssets(payload.pdf.assets || []);
+        renderTrace(payload.trace);
+      }
+      function renderLocatorBadges(locator, target) {
+        target.replaceChildren();
+        if (locator.type !== "pdf") {
+          return;
+        }
+        if (isUncertainPdfLocator(locator)) {
+          target.append(createBadge("Uncertain", true));
+        }
+        if (typeof locator.confidence === "number") {
+          target.append(createBadge("Confidence " + formatPercent(locator.confidence), locator.confidence < 0.7));
+        }
+        if (Array.isArray(locator.warningCodes) && locator.warningCodes.length > 0) {
+          target.append(createBadge(locator.warningCodes.join(", "), true));
+        }
+        if (locator.regionId) {
+          target.append(createBadge("Region " + locator.regionId, false));
+        }
+      }
+      function createBadge(text, warning) {
+        const badge = document.createElement("span");
+        badge.className = warning ? "badge badge-warning" : "badge";
+        badge.textContent = text;
+        return badge;
+      }
+      function renderPdfAssets(assets) {
+        assetLinksEl.replaceChildren();
+        for (const asset of assets) {
+          if (!asset || typeof asset !== "object" || typeof asset.athenaBlobPath !== "string") {
+            continue;
+          }
+          const button = document.createElement("button");
+          button.type = "button";
+          button.textContent =
+            typeof asset.path === "string" ? asset.path : asset.athenaBlobPath;
+          button.addEventListener("click", async () => {
+            const params = new URLSearchParams({
+              blobPath: asset.athenaBlobPath
+            });
+            const payload = await getJson("/api/pdf-asset?" + params.toString());
+            previewEl.textContent = payload.text;
+          });
+          assetLinksEl.append(button);
+        }
+      }
+      function formatPdfPreview(pdf) {
+        const lines = [
+          pdf.path + " p." + pdf.page,
+          "Confidence: " + formatPdfConfidence(pdf),
+          "Warnings: " + formatPdfWarnings(pdf),
+          "Region: " + formatPdfRegion(pdf.locator && pdf.locator.region),
+          "",
+          pdf.markdown
+        ];
+        if (Array.isArray(pdf.assets) && pdf.assets.length > 0) {
+          lines.push("", "Assets:");
+          for (const asset of pdf.assets) {
+            if (asset && typeof asset === "object") {
+              lines.push("- " + (asset.path || asset.id || "asset"));
+            }
+          }
+        }
+        return lines.join("\\n");
+      }
+      function formatPdfConfidence(pdf) {
+        if (pdf.confidence && typeof pdf.confidence.overall === "number") {
+          return formatPercent(pdf.confidence.overall);
+        }
+        if (pdf.locator && typeof pdf.locator.confidence === "number") {
+          return formatPercent(pdf.locator.confidence);
+        }
+        return "unknown";
+      }
+      function formatPdfWarnings(pdf) {
+        const codes =
+          pdf.locator && Array.isArray(pdf.locator.warningCodes)
+            ? pdf.locator.warningCodes
+            : [];
+        if (codes.length > 0) {
+          return codes.join(", ");
+        }
+        if (Array.isArray(pdf.warnings) && pdf.warnings.length > 0) {
+          return pdf.warnings
+            .map((warning) => warning && typeof warning === "object" ? warning.code : "")
+            .filter(Boolean)
+            .join(", ");
+        }
+        return "none";
+      }
+      function formatPdfRegion(region) {
+        if (!region) {
+          return "none";
+        }
+        return [
+          "source " + region.source,
+          "x " + formatRegionNumber(region.x),
+          "y " + formatRegionNumber(region.y),
+          "w " + formatRegionNumber(region.width),
+          "h " + formatRegionNumber(region.height)
+        ].join(", ");
+      }
+      function formatRegionNumber(value) {
+        return typeof value === "number" ? String(value) : "unknown";
+      }
+      function resultMeta(item) {
+        const parts = [
+          item.kind,
+          locatorLabel(item.locator),
+          "score " + item.score.toFixed(3)
+        ];
+        if (item.locator.type === "pdf" && typeof item.locator.confidence === "number") {
+          parts.push("confidence " + formatPercent(item.locator.confidence));
+        }
+        return parts.join(" | ");
+      }
+      function renderTrace(trace) {
+        traceEl.textContent = JSON.stringify(
+          {
+            resultCount: latestResults.length,
+            seenChunkIds: trace.seenChunkIds,
+            searchScores: trace.searchScores,
+            readLocators: trace.readLocators
+          },
+          null,
+          2
+        );
+      }
+      function locatorLabel(locator) {
+        if (locator.type === "pdf") {
+          return "page " + locator.page + (locator.regionId ? " region" : "");
+        }
+        return "lines " + locator.startLine + "-" + locator.endLine;
+      }
+      function formatCitation(item) {
+        if (item.locator.type === "pdf") {
+          return (
+            item.path +
+            " p." +
+            item.locator.page +
+            (item.locator.regionId ? "#" + item.locator.regionId : "")
+          );
+        }
+        return item.path + ":" + item.locator.startLine + "-" + item.locator.endLine;
+      }
+      function isUncertainPdfLocator(locator) {
+        return (
+          locator.type === "pdf" &&
+          ((typeof locator.confidence === "number" && locator.confidence < 0.7) ||
+            (Array.isArray(locator.warningCodes) && locator.warningCodes.length > 0))
+        );
+      }
+      function formatPercent(value) {
+        return Math.round(value * 100) + "%";
+      }
+      function formatCitationLabel(item) {
+        return "[" + formatCitation(item) + "]";
+      }
+      function formatCopiedResult(item) {
+        const snippet = item.snippet.trim();
+        if (snippet === "") {
+          return formatCitationLabel(item);
+        }
+        return snippet + "\\n\\n" + formatCitationLabel(item);
+      }
+      async function writeClipboard(text) {
+        if (navigator.clipboard) {
+          await navigator.clipboard.writeText(text);
+        } else {
+          previewEl.textContent = text;
+        }
+      }
+      form.addEventListener("submit", (event) => {
+        event.preventDefault();
+        const query = queryEl.value.trim();
+        if (query) {
+          search(query).catch((error) => {
+            traceEl.textContent = String(error);
+          });
+        }
+      });
+      refreshStatus().catch((error) => {
+        statusEl.textContent = String(error);
+      });
+    </script>
+  </body>
+</html>`;
+}
+//# sourceMappingURL=static-app.js.map