eddie-jekyll 0.2.3 → 0.4.0

data/assets/eddie-widget.js

@@ -1,61 +1,694 @@
 // SPDX-License-Identifier: GPL-3.0-only
+// Generated by widget/build.sh from widget/src/eddie-widget.js and widget/src/lib/*.js; edit those instead.
+(function () {
+"use strict";
+const EddieLib = {};
+// SPDX-License-Identifier: GPL-3.0-only
 
-// Eddie search widget
-//
-// Self-contained vanilla JS widget using Shadow DOM for style isolation.
-// Embeds a search modal that communicates with a Web Worker running
-// WASM-based semantic + keyword search.
+// Widget configuration: parse the data-* attributes of the <script> tag.
+// Pure; `get(name)` returns the attribute string or null.
+
+(function (factory) {
+  const api = factory();
+  if (typeof module === "object" && module && module.exports) {
+    module.exports = api;
+  } else if (typeof EddieLib === "object" && EddieLib) {
+    Object.assign(EddieLib, api);
+  } else {
+    globalThis.EddieLib = Object.assign(globalThis.EddieLib || {}, api);
+  }
+})(function () {
+  "use strict";
 
-"use strict";
+  const POSITIONS = new Set(["top-left", "top-right", "bottom-left", "bottom-right"]);
 
-(function () {
-  const scriptEl = document.currentScript;
-  if (!scriptEl) return;
+  function oneOf(raw, allowed, fallback) {
+    const value = (raw || "").trim().toLowerCase();
+    return allowed.includes(value) ? value : fallback;
+  }
+
+  function intAttr(raw, fallback) {
+    if (raw == null || raw === "") return fallback;
+    const value = Number.parseInt(raw, 10);
+    return Number.isFinite(value) && value > 0 ? value : fallback;
+  }
 
-  function parseOffsetPx(attrName) {
-    const raw = scriptEl.getAttribute(attrName);
+  function offsetAttr(raw) {
     if (raw == null || raw === "") return 0;
     const value = Number(raw);
     return Number.isFinite(value) ? Math.trunc(value) : 0;
   }
 
-  function parseIntAttr(attrName, fallback) {
-    const raw = scriptEl.getAttribute(attrName);
-    if (raw == null || raw === "") return fallback;
-    const value = Number.parseInt(raw, 10);
-    return Number.isFinite(value) && value > 0 ? value : fallback;
+  /**
+   * Parse the widget configuration from a `get(attributeName)` accessor.
+   * Every value is validated; unknown values fall back to the documented default.
+   */
+  function parseWidgetConfig(get) {
+    const agentModelRaw = (get("data-agent-model") || "").trim();
+    return {
+      indexUrl: (get("data-index-url") || "").trim(),
+      position: (function () {
+        const v = (get("data-position") || "").trim().toLowerCase();
+        return POSITIONS.has(v) ? v : "bottom-right";
+      })(),
+      theme: oneOf(get("data-theme"), ["auto", "light", "dark"], "auto"),
+      offsetX: offsetAttr(get("data-offset-x")),
+      offsetY: offsetAttr(get("data-offset-y")),
+      qaMode: oneOf(get("data-qa-mode"), ["off", "auto", "always"], "auto"),
+      qaSubject: (get("data-qa-subject") || "").trim(),
+      topK: intAttr(get("data-top-k"), 8),
+      answerTopK: intAttr(get("data-answer-top-k"), 5),
+      agentMode: oneOf(get("data-agent-mode"), ["off", "auto"], "auto"),
+      agentModel: agentModelRaw === "" ? "auto" : agentModelRaw,
+      denseRuntime: oneOf(get("data-dense-runtime"), ["auto", "wasm", "webgpu"], "auto"),
+      consentText: (get("data-consent-text") || "").trim(),
+    };
+  }
+
+  return { parseWidgetConfig };
+});
+
+// SPDX-License-Identifier: GPL-3.0-only
+
+// URL, version and cache-key helpers shared by the widget and the worker.
+
+(function (factory) {
+  const api = factory();
+  if (typeof module === "object" && module && module.exports) {
+    module.exports = api;
+  } else if (typeof EddieLib === "object" && EddieLib) {
+    Object.assign(EddieLib, api);
+  } else {
+    globalThis.EddieLib = Object.assign(globalThis.EddieLib || {}, api);
+  }
+})(function () {
+  "use strict";
+
+  const HF_HOST = "https://huggingface.co";
+
+  /** Directory of an absolute URL, without query or hash, with a trailing slash. */
+  function baseUrlOf(href) {
+    const u = new URL(href);
+    u.search = "";
+    u.hash = "";
+    const s = u.href;
+    return s.substring(0, s.lastIndexOf("/") + 1);
+  }
+
+  /** The `v` query parameter of a URL (absolute or relative), or null. */
+  function versionOf(href) {
+    if (!href) return null;
+    const q = href.indexOf("?");
+    if (q < 0) return null;
+    const params = new URLSearchParams(href.substring(q + 1).split("#")[0]);
+    const v = params.get("v");
+    return v ? v : null;
+  }
+
+  /** Append `?v=<version>` unless the URL already carries a `v` parameter. */
+  function withVersion(url, version) {
+    if (!version || versionOf(url)) return url;
+    const hashAt = url.indexOf("#");
+    const hash = hashAt >= 0 ? url.substring(hashAt) : "";
+    const body = hashAt >= 0 ? url.substring(0, hashAt) : url;
+    const sep = body.includes("?") ? (body.endsWith("?") || body.endsWith("&") ? "" : "&") : "?";
+    return body + sep + "v=" + encodeURIComponent(version) + hash;
+  }
+
+  /** Runtime asset next to the widget script, version-busted when a version is known. */
+  function assetUrl(baseUrl, name, version) {
+    const base = baseUrl ? baseUrl.replace(/\/?$/, "/") : "";
+    return withVersion(base + name, version);
+  }
+
+  /** `https://huggingface.co/<repo>/resolve/<revision>/<file>` */
+  function hfFileUrl(repo, revision, file) {
+    const rev = encodeURIComponent(revision || "main");
+    const path = String(file).split("/").map(encodeURIComponent).join("/");
+    return `${HF_HOST}/${repo}/resolve/${rev}/${path}`;
+  }
+
+  /** IndexedDB key for a cached model file. */
+  function cacheKey(repo, revision, file) {
+    return `${repo}@${revision || "main"}/${file}`;
+  }
+
+  const HF_RESOLVE_RE = /^https:\/\/huggingface\.co\/([^/]+\/[^/]+)\/resolve\/([^/]+)\/([^?#]+)/;
+
+  /** The `cacheKey` of an `hfFileUrl`-shaped URL, or null for any other URL. */
+  function cacheKeyFromUrl(url) {
+    const m = HF_RESOLVE_RE.exec(String(url || ""));
+    if (!m) return null;
+    return cacheKey(m[1], decodeURIComponent(m[2]), m[3].split("/").map(decodeURIComponent).join("/"));
+  }
+
+  function isWeightsFile(file) {
+    return /\.(safetensors|onnx|onnx_data|bin|data|pt|gguf)$/i.test(String(file));
+  }
+
+  /** Per-file fetch timeout: 10 minutes for weights, 60 seconds for everything else. */
+  function timeoutForFile(file) {
+    return isWeightsFile(file) ? 600000 : 60000;
+  }
+
+  return {
+    HF_HOST,
+    baseUrlOf,
+    versionOf,
+    withVersion,
+    assetUrl,
+    hfFileUrl,
+    cacheKey,
+    cacheKeyFromUrl,
+    isWeightsFile,
+    timeoutForFile,
+  };
+});
+
+// SPDX-License-Identifier: GPL-3.0-only
+
+// Dense-lane selection, download sizes, consent copy and degraded-arm notices.
+// Pure functions over the index manifest (see src/manifest.rs).
+
+(function (factory) {
+  const api = factory();
+  if (typeof module === "object" && module && module.exports) {
+    module.exports = api;
+  } else if (typeof EddieLib === "object" && EddieLib) {
+    Object.assign(EddieLib, api);
+  } else {
+    globalThis.EddieLib = Object.assign(globalThis.EddieLib || {}, api);
+  }
+})(function () {
+  "use strict";
+
+  const DEFAULT_WASM_FILES = ["config.json", "tokenizer.json", "model.safetensors"];
+
+  // Approximate download sizes (bytes) keyed by lower-cased HuggingFace repo.
+  const DOWNLOAD_SIZES = {
+    "sentence-transformers/multi-qa-minilm-l6-cos-v1": 91e6,
+    "sentence-transformers/all-minilm-l6-v2": 91e6,
+    "sentence-transformers/all-minilm-l12-v2": 134e6,
+    "sentence-transformers/paraphrase-multilingual-minilm-l12-v2": 471e6,
+    "baai/bge-small-en-v1.5": 134e6,
+    "baai/bge-base-en-v1.5": 438e6,
+    "onnx-community/qwen3-embedding-0.6b-onnx": 900e6,
+    "onnx-community/harrier-oss-v1-0.6b-onnx": 400e6,
+    "xenova/bge-m3": 570e6,
+  };
+
+  function laneKind(lane) {
+    return lane && lane.runtime ? lane.runtime.kind : null;
+  }
+
+  function isWasmLane(lane) {
+    return laneKind(lane) === "wasm-candle";
+  }
+
+  function isWebGpuLane(lane) {
+    return laneKind(lane) === "webgpu-onnx";
+  }
+
+  /** Repo the runtime downloads from. */
+  function laneRepo(lane) {
+    if (isWebGpuLane(lane)) return lane.runtime.repo;
+    return lane.model;
+  }
+
+  /**
+   * HuggingFace revision for the runtime's downloads. `lane.revision` pins
+   * `lane.model` (the repo the indexer used); a webgpu-onnx lane downloads
+   * from a different repo (`runtime.repo`) that the manifest does not pin.
+   */
+  function laneRevision(lane) {
+    if (isWebGpuLane(lane)) return "main";
+    return lane.revision || "main";
+  }
+
+  /** Files a wasm-candle lane needs (config, tokenizer, weights). */
+  function laneFiles(lane) {
+    if (!isWasmLane(lane)) return [];
+    const files = Array.isArray(lane.runtime.files) ? lane.runtime.files : [];
+    return files.length ? files.slice() : DEFAULT_WASM_FILES.slice();
+  }
+
+  function isWeightsFile(file) {
+    return /\.(safetensors|bin|pt|gguf|onnx)$/i.test(String(file));
+  }
+
+  /**
+   * Why the WASM loader (init_dense_wasm) cannot run a wasm-candle lane, or
+   * null when it can: it accepts BERT-family lanes with config.json,
+   * tokenizer.json and exactly one unsharded model.safetensors.
+   */
+  function wasmLaneProblem(lane) {
+    if (!isWasmLane(lane)) return "not a wasm-candle lane";
+    if (lane.family && lane.family !== "bert") return `family ${lane.family} is not supported in WASM`;
+    const files = laneFiles(lane);
+    for (const need of ["config.json", "tokenizer.json"]) {
+      if (!files.includes(need)) return `runtime.files lacks ${need}`;
+    }
+    const weights = files.filter(isWeightsFile);
+    if (weights.length === 1 && weights[0] === "model.safetensors") return null;
+    if (weights.length === 0) return "runtime.files lists no weights file";
+    return `WASM needs a single model.safetensors, not ${weights.join(", ")}`;
+  }
+
+  /**
+   * Ordered dense-lane candidates for this browser, plus the lanes skipped
+   * because this runtime cannot load them (`skipped: [{lane, reason}]`).
+   * `denseRuntime`: "auto" | "wasm" | "webgpu"; `hasWebGpu`: an adapter was obtained.
+   */
+  function chooseDenseLanes(manifest, opts) {
+    const lanes = (manifest && Array.isArray(manifest.dense)) ? manifest.dense : [];
+    const runtime = (opts && opts.denseRuntime) || "auto";
+    const hasWebGpu = !!(opts && opts.hasWebGpu);
+    const webgpu = lanes.filter(isWebGpuLane);
+    const skipped = [];
+    const wasm = lanes.filter(isWasmLane).filter((lane) => {
+      const problem = wasmLaneProblem(lane);
+      if (problem) skipped.push({ lane, reason: problem });
+      return !problem;
+    });
+    if (lanes.length === 0) {
+      return { candidates: [], skipped, reason: "index has no dense lane" };
+    }
+    let candidates;
+    if (runtime === "wasm") {
+      candidates = wasm;
+    } else if (runtime === "webgpu") {
+      candidates = hasWebGpu ? webgpu : [];
+    } else {
+      candidates = hasWebGpu ? webgpu.concat(wasm) : wasm;
+    }
+    let reason = null;
+    if (candidates.length === 0) {
+      if (runtime === "wasm") reason = skipped.length ? "no wasm-candle lane the WASM loader can run" : "index has no wasm-candle lane";
+      else if (!hasWebGpu && webgpu.length && !wasm.length) reason = "no WebGPU adapter";
+      else if (runtime === "webgpu" && !hasWebGpu) reason = "no WebGPU adapter";
+      else if (runtime === "webgpu") reason = "index has no webgpu-onnx lane";
+      else reason = "no runnable dense lane";
+    }
+    return { candidates, skipped, reason };
+  }
+
+  /** transformers.js dtype for a webgpu-onnx lane on this adapter. */
+  function pickDtype(runtime, hasF16) {
+    if (hasF16 && runtime.dtype_f16) return runtime.dtype_f16;
+    return runtime.dtype || "fp32";
+  }
+
+  /** Approximate bytes a lane downloads on first use, or null when unknown. */
+  function laneDownloadBytes(lane) {
+    const repo = (laneRepo(lane) || "").toLowerCase();
+    return Object.prototype.hasOwnProperty.call(DOWNLOAD_SIZES, repo) ? DOWNLOAD_SIZES[repo] : null;
+  }
+
+  function formatBytes(n) {
+    if (n == null || !Number.isFinite(n)) return "unknown size";
+    if (n >= 1e9) {
+      const g = n / 1e9;
+      return (g >= 10 ? Math.round(g) : Math.round(g * 10) / 10) + " GB";
+    }
+    if (n >= 1e6) return Math.round(n / 1e6) + " MB";
+    if (n >= 1e3) return Math.round(n / 1e3) + " KB";
+    return n + " B";
+  }
+
+  /**
+   * Consent card copy for a model download. `consentText` (site override) may
+   * contain `{size}` and `{model}` placeholders.
+   */
+  function consentCopy(opts) {
+    const size = formatBytes(opts.sizeBytes);
+    const model = opts.model || "the search model";
+    if (opts.consentText) {
+      return opts.consentText.replace(/\{size\}/g, size).replace(/\{model\}/g, model);
+    }
+    const sized = opts.sizeBytes == null ? "a one-time download (size unknown)" : `a one-time ${size} download`;
+    let text = `Semantic search runs a language model in your browser. That needs ${sized} of ${model}, kept in your browser's cache for next time.`;
+    if (opts.saveData) {
+      text = "Data saver is on. " + text;
+    }
+    return text;
+  }
+
+  /**
+   * Drop degraded notes that describe the index design rather than a failure
+   * (an index without a dense lane or sparse arm is not "degraded").
+   */
+  function filterDesignDegraded(degraded) {
+    return (degraded || []).filter((d) => !/index has no (dense lane|sparse arm)/.test(d));
+  }
+
+  /** Human notice when a semantic arm is missing, or null when nothing to say. */
+  function degradedNotice(arms, degraded) {
+    const named = filterDesignDegraded(degraded).filter((d) => /^(dense|sparse)\b/.test(d));
+    if (named.length === 0) return null;
+    const a = arms || {};
+    if (!a.dense && !a.sparse) {
+      return "Keyword-only results: the semantic model isn't available.";
+    }
+    if (!a.dense) {
+      return "Keyword and sparse results only: the dense model isn't available.";
+    }
+    return "Results without the learned-sparse arm.";
+  }
+
+  return {
+    DEFAULT_WASM_FILES,
+    DOWNLOAD_SIZES,
+    laneKind,
+    isWasmLane,
+    isWebGpuLane,
+    laneRepo,
+    laneRevision,
+    laneFiles,
+    isWeightsFile,
+    wasmLaneProblem,
+    chooseDenseLanes,
+    pickDtype,
+    laneDownloadBytes,
+    formatBytes,
+    consentCopy,
+    filterDesignDegraded,
+    degradedNotice,
+  };
+});
+
+// SPDX-License-Identifier: GPL-3.0-only
+
+// Agent helpers shared by the widget and the agent worker: model selection,
+// prompts, plan parsing, evidence assembly and answer post-processing.
+// Pure functions; no WebLLM, no DOM.
+
+(function (factory) {
+  const api = factory();
+  if (typeof module === "object" && module && module.exports) {
+    module.exports = api;
+  } else if (typeof EddieLib === "object" && EddieLib) {
+    Object.assign(EddieLib, api);
+  } else {
+    globalThis.EddieLib = Object.assign(globalThis.EddieLib || {}, api);
+  }
+})(function () {
+  "use strict";
+
+  const NOHIT = "The site doesn't cover that.";
+  const NOHIT_RE = /\bthe site (?:doesn['’]t|does not|didn['’]t|did not) cover (?:that|this|it)\.?/gi;
+
+  const AGENT_MODEL_SIZES = {
+    "Qwen3.5-0.8B": 0.4e9,
+    "Qwen3.5-2B": 1.2e9,
+    "Qwen3.5-4B": 2.3e9,
+  };
+  const TWO_GIB = 2 * 1024 * 1024 * 1024;
+
+  const PLAN_SCHEMA = {
+    type: "object",
+    properties: {
+      queries: { type: "array", items: { type: "string" }, minItems: 1, maxItems: 3 },
+    },
+    required: ["queries"],
+  };
+
+  function planPrompt(site) {
+    return `You write search queries for a site search engine. The site is ${site}. Reply with JSON only: {"queries": ["..."]}. Give 1 to 3 different short keyword queries (2 to 5 words each, no punctuation) that a site search engine would match against page text. Each query must be different. Do not answer the question.`;
+  }
+
+  function answerPrompt(site) {
+    return `You answer visitor questions about ${site} using only the numbered sources below the question. Answer the question directly in the first sentence. Write 1 to 3 sentences in your own words; never repeat a source's wording. End each sentence with the numbers of the sources it comes from, like [2] or [1][3]. Never cite a number that is not in the list. Do not add calculations or inferences that are not in the sources. If no source answers the question, your entire reply is: ${NOHIT} Never mix that sentence with an answer. Never use outside knowledge.`;
+  }
+
+  /** Strip the WebLLM variant suffix to get the family name shown to visitors. */
+  function baseModelId(id) {
+    return String(id).replace(/-q\d+f(16|32)_\d+-MLC$/i, "");
+  }
+
+  function agentModelBytes(id) {
+    const base = baseModelId(id);
+    return Object.prototype.hasOwnProperty.call(AGENT_MODEL_SIZES, base) ? AGENT_MODEL_SIZES[base] : null;
+  }
+
+  /**
+   * Choose the WebLLM model id.
+   * opts: { mode: "auto"|"quality"|<id>, maxBufferSize, isMobile, hasF16 }
+   */
+  function selectAgentModel(opts) {
+    const o = opts || {};
+    const mode = (o.mode || "auto").trim();
+    const suffix = o.hasF16 ? "-q4f16_1-MLC" : "-q4f32_1-MLC";
+    let base;
+    if (mode === "auto") {
+      const big = Number(o.maxBufferSize) >= TWO_GIB && !o.isMobile;
+      base = big ? "Qwen3.5-2B" : "Qwen3.5-0.8B";
+    } else if (mode === "quality") {
+      base = "Qwen3.5-2B";
+    } else {
+      return { id: mode, base: baseModelId(mode), sizeBytes: agentModelBytes(mode), explicit: true };
+    }
+    const id = base + suffix;
+    return { id, base, sizeBytes: AGENT_MODEL_SIZES[base], explicit: false };
+  }
+
+  function isMobileDevice(nav) {
+    const n = nav || {};
+    if (n.userAgentData && typeof n.userAgentData.mobile === "boolean") {
+      return n.userAgentData.mobile;
+    }
+    return /Mobi|Android|iPhone|iPad|iPod|Windows Phone/i.test(n.userAgent || "");
+  }
+
+  /** Remove <think>…</think> blocks; a dangling <think> loses only the tag. */
+  function stripThink(text) {
+    if (!text) return "";
+    let out = String(text).replace(/<think>[\s\S]*?<\/think>/g, "");
+    out = out.replace(/<think>/g, "").replace(/<\/think>/g, "");
+    return out.trim();
+  }
+
+  /**
+   * Display text for a partial stream: complete think blocks removed, and
+   * anything after an unclosed <think> hidden until it closes.
+   */
+  function visibleStreamText(partial) {
+    if (!partial) return "";
+    let out = String(partial).replace(/<think>[\s\S]*?<\/think>/g, "");
+    const open = out.indexOf("<think>");
+    if (open >= 0) out = out.substring(0, open);
+    return out.replace(/^\s+/, "");
+  }
+
+  function extractJsonObject(text) {
+    const s = String(text);
+    const start = s.indexOf("{");
+    const end = s.lastIndexOf("}");
+    if (start < 0 || end <= start) return null;
+    try {
+      return JSON.parse(s.substring(start, end + 1));
+    } catch (_) {
+      return null;
+    }
   }
 
-  function normalizeQaMode(raw) {
-    const value = (raw || "").toLowerCase();
-    if (value === "off" || value === "always" || value === "auto") {
-      return value;
+  function cleanQuery(q) {
+    return String(q)
+      .replace(/\/?no_think/gi, "")
+      .replace(/[\s"'`*]+$/g, "")
+      .replace(/^[\s"'`*\-\d.)]+/g, "")
+      .replace(/\s+/g, " ")
+      .trim();
+  }
+
+  /** Parse the planner reply into 1..3 distinct queries; falls back to the question. */
+  function parsePlan(text, question) {
+    const cleaned = stripThink(text);
+    const obj = extractJsonObject(cleaned);
+    const raw = obj && Array.isArray(obj.queries) ? obj.queries : [];
+    const seen = new Set();
+    const out = [];
+    for (const item of raw) {
+      if (typeof item !== "string") continue;
+      const q = cleanQuery(item);
+      if (q.length < 2 || q.length > 80) continue;
+      const key = q.toLowerCase();
+      if (seen.has(key)) continue;
+      seen.add(key);
+      out.push(q);
+      if (out.length === 3) break;
+    }
+    if (out.length === 0 && question && question.trim()) {
+      out.push(question.trim());
+    }
+    return out;
+  }
+
+  function urlKey(url) {
+    return String(url || "").replace(/#.*$/, "").replace(/\/+$/, "").toLowerCase();
+  }
+
+  /**
+   * Round-robin merge of several result lists, deduplicated by URL, at most
+   * `max` items. Each result keeps its own fields.
+   */
+  function mergeEvidence(lists, max) {
+    const limit = max == null ? 6 : max;
+    const seen = new Set();
+    const out = [];
+    const arrays = (lists || []).map((l) => (Array.isArray(l) ? l : []));
+    const longest = arrays.reduce((n, l) => Math.max(n, l.length), 0);
+    for (let i = 0; i < longest && out.length < limit; i++) {
+      for (const list of arrays) {
+        if (out.length >= limit) break;
+        const r = list[i];
+        if (!r || !r.url) continue;
+        const key = urlKey(r.url);
+        if (seen.has(key)) continue;
+        seen.add(key);
+        out.push(r);
+      }
     }
-    return "auto";
+    return out;
+  }
+
+  /** Cut to `max` characters at a word boundary, with an ellipsis. */
+  function truncateText(text, max) {
+    const limit = max == null ? 700 : max;
+    const s = String(text || "").replace(/\s+/g, " ").trim();
+    if (s.length <= limit) return s;
+    const cut = s.lastIndexOf(" ", limit - 1);
+    return s.substring(0, cut > limit * 0.6 ? cut : limit - 1).trim() + "…";
+  }
+
+  /** `[n] title (url)\ntext` blocks joined by blank lines. */
+  function formatEvidence(items, maxChars) {
+    return (items || [])
+      .map((e, i) => `[${i + 1}] ${e.title || e.url} (${e.url})\n${truncateText(e.text || e.snippet || "", maxChars)}`)
+      .join("\n\n");
+  }
+
+  function sourcesPrompt(items, question, maxChars) {
+    return `Sources:\n\n${formatEvidence(items, maxChars)}\n\nQuestion: ${question}`;
   }
 
-  function normalizePosition(raw) {
-    const value = (raw || "").toLowerCase();
-    const allowed = new Set([
-      "top-left",
-      "top-right",
-      "bottom-left",
-      "bottom-right",
-    ]);
-    return allowed.has(value) ? value : "bottom-right";
+  /**
+   * Post-process a raw model answer against the evidence list.
+   * Returns { answer, citations: [{n, url, title}], nohit }.
+   */
+  function postProcessAnswer(raw, evidence) {
+    const ev = Array.isArray(evidence) ? evidence : [];
+    let text = stripThink(raw);
+    // **[1]** -> [1]
+    text = text.replace(/\*\*\s*((?:\[\s*\d+(?:\s*,\s*\d+)*\s*\]\s*)+)\*\*/g, "$1");
+    // Lines that are only citation markers belong to the previous line.
+    const lines = text.split(/\r?\n/);
+    const merged = [];
+    for (const line of lines) {
+      const t = line.trim();
+      if (t && /^(?:\[\s*\d+(?:\s*,\s*\d+)*\s*\]\s*)+$/.test(t)) {
+        let j = merged.length - 1;
+        while (j >= 0 && merged[j].trim() === "") j--;
+        if (j >= 0) {
+          // Append only markers the previous line does not already carry.
+          const prev = merged[j];
+          const fresh = (t.match(/\[\s*\d+(?:\s*,\s*\d+)*\s*\]/g) || []).filter((m) => !prev.includes(m.replace(/\s+/g, "")));
+          merged.length = j + 1;
+          if (fresh.length) merged[j] = prev.replace(/\s+$/, "") + " " + fresh.join("");
+          continue;
+        }
+      }
+      merged.push(line);
+    }
+    text = merged.join("\n");
+
+    // Drop the fallback sentence when anything else remains.
+    const withoutFallback = text.replace(NOHIT_RE, "").replace(/[ \t]+\n/g, "\n").trim();
+    const residue = withoutFallback
+      .replace(/\[\s*\d+(?:\s*,\s*\d+)*\s*\]/g, "")
+      .replace(/^\s*(?:yes|no)\b/i, "")
+      .replace(/[\s.,;:!?'"*-]+/g, "");
+    const onlyFallback = residue === "";
+    if (onlyFallback) {
+      return { answer: NOHIT, citations: [], nohit: true };
+    }
+    text = withoutFallback;
+
+    // Map [n] citations to evidence; drop out-of-range ones.
+    const cited = [];
+    const seen = new Set();
+    text = text.replace(/\[\s*(\d+(?:\s*,\s*\d+)*)\s*\]/g, (_, body) => {
+      const nums = body.split(",").map((x) => Number(x.trim()));
+      let out = "";
+      for (const n of nums) {
+        if (n >= 1 && n <= ev.length) {
+          out += `[${n}]`;
+          if (!seen.has(n)) {
+            seen.add(n);
+            cited.push(n);
+          }
+        }
+      }
+      return out;
+    });
+    // Collapse duplicate adjacent markers ("[1][1]") and tidy whitespace.
+    text = text.replace(/(\[\d+\])(?:\s*\1)+/g, "$1");
+    text = text.replace(/[ \t]{2,}/g, " ").replace(/ +([.,;:!?])/g, "$1").replace(/\n{3,}/g, "\n\n").trim();
+    const citations = cited
+      .sort((a, b) => a - b)
+      .map((n) => ({ n, url: ev[n - 1].url, title: ev[n - 1].title || ev[n - 1].url }));
+    return { answer: text, citations, nohit: text === "" };
   }
 
-  const config = {
-    indexUrl: scriptEl.getAttribute("data-index-url") || "/eddie/index.ed",
-    position: normalizePosition(scriptEl.getAttribute("data-position")),
-    theme: scriptEl.getAttribute("data-theme") || "auto",
-    offsetY: parseOffsetPx("data-offset-y"),
-    offsetX: parseOffsetPx("data-offset-x"),
-    qaMode: normalizeQaMode(scriptEl.getAttribute("data-qa-mode")),
-    qaSubject: (scriptEl.getAttribute("data-qa-subject") || "").toLowerCase(),
-    resultTopK: parseIntAttr("data-top-k", 8),
-    answerTopK: parseIntAttr("data-answer-top-k", 5),
+  return {
+    NOHIT,
+    AGENT_MODEL_SIZES,
+    PLAN_SCHEMA,
+    planPrompt,
+    answerPrompt,
+    sourcesPrompt,
+    baseModelId,
+    agentModelBytes,
+    selectAgentModel,
+    isMobileDevice,
+    stripThink,
+    visibleStreamText,
+    parsePlan,
+    mergeEvidence,
+    truncateText,
+    formatEvidence,
+    postProcessAnswer,
   };
+});
+
+// SPDX-License-Identifier: GPL-3.0-only
+
+// Eddie search widget
+//
+// Self-contained vanilla JS widget in a closed Shadow DOM. Talks to the
+// search worker (eddie-worker.js) for retrieval and, on demand, to the agent
+// worker (eddie-agent-worker.js) for a streamed, cited answer.
+//
+// widget/build.sh concatenates widget/src/lib/*.js ahead of this file inside
+// one IIFE, so the pure helpers are available as `EddieLib` without leaking a
+// global.
+
+"use strict";
+
+(function () {
+  const scriptEl = document.currentScript;
+  if (!scriptEl) return;
+  const lib = EddieLib;
+
+  const config = lib.parseWidgetConfig((name) => scriptEl.getAttribute(name));
+  const scriptHref = new URL(scriptEl.src, location.href).href;
+  const baseUrl = lib.baseUrlOf(scriptHref);
+  const indexUrl = config.indexUrl
+    ? new URL(config.indexUrl, location.href).href
+    : new URL("index.ed", baseUrl).href;
+  const version = lib.versionOf(scriptHref) || lib.versionOf(indexUrl);
+  const siteName = config.qaSubject || location.hostname;
+  const reducedMotion = !!(window.matchMedia && window.matchMedia("(prefers-reduced-motion: reduce)").matches);
+  const saveData = !!(navigator.connection && navigator.connection.saveData);
 
   const HEART_SPRITES = [
     [".11111.", "1222221", "1222221", ".12221."], // solid
@@ -63,40 +696,63 @@
     [".13331.", "1344431", "1244421", ".12221."], // beveled
     [".13131.", "1344431", "12.4.21", ".12221."], // gear-ish
   ];
-
-  const HEART_PALETTE = {
-    "1": "#f2c94c",
-    "2": "#e0b63f",
-    "3": "#f8dda1",
-    "4": "#b78e28",
-  };
-
-  // Resolve asset URLs relative to this script's location
-  const scriptSrc = new URL(scriptEl.src, location.href);
-  const baseUrl = scriptSrc.href.substring(0, scriptSrc.href.lastIndexOf("/") + 1);
-
-  function resolveAsset(name) {
-    return baseUrl + name;
-  }
+  const HEART_PALETTE = { 1: "#f2c94c", 2: "#e0b63f", 3: "#f8dda1", 4: "#b78e28" };
+  const HIDDEN_SECTIONS = /^(summary|summary lane|semantic segment)$/i;
+  const AGENT_CONSENT_KEY = "eddie.agent.consent";
 
   // -- State --
   let worker = null;
-  let searchRequestId = 0;
+  let workerState = "idle"; // idle | loading | index_ready | awaiting_consent | ready | error | dead
+  let searchable = false;
+  let requestSeq = 0;
+  const pending = new Map(); // requestId -> { resolve, reject }
+  let activeSearchId = 0;
   let isOpen = false;
   let selectedIndex = -1;
   let currentResults = [];
-  let currentAnswer = null;
-  let engineState = "idle"; // idle | loading | ready | error
   let lastHeartIndex = -1;
-  let activeRequestId = 0;
-  let searchPending = false;
+  let consentDeclined = false;
+  let lastDegradedNotice = null;
+  let lastAnnouncedQuarter = -1;
+  let manifestInfo = null;
+  let searchTimer = null;
+  let lastSearchedQuery = "";
+
+  let agentInfo = null; // null (unknown) | false | { maxBufferSize, hasF16 }
+  let agentWorker = null;
+  let agentModel = null; // { id, base, sizeBytes }
+  let agentLoaded = false;
+  let agentLoading = null; // Promise while a load is in flight
+  let agentRun = null; // { requestId, question, text, aborted }
+  let agentPendingLoad = null; // { resolve, reject }
 
   // -- DOM setup --
   const host = document.createElement("div");
   host.id = "eddie-host";
+  host.dataset.theme = config.theme;
+  host.dataset.state = workerState;
   const shadow = host.attachShadow({ mode: "closed" });
 
-  // -- Styles --
+  /** The worker state is mirrored on the host as `data-state` (readable by the page). */
+  function setWorkerState(next) {
+    workerState = next;
+    host.dataset.state = next;
+  }
+
+  const DARK_TOKENS = `
+      --sa-bg: #1a1a1a;
+      --sa-bg-elevated: #252525;
+      --sa-text: #e8e8e8;
+      --sa-text-muted: #a3a3a3;
+      --sa-border: #333333;
+      --sa-accent: #60a5fa;
+      --sa-accent-soft: rgba(96, 165, 250, 0.12);
+      --sa-backdrop: rgba(0, 0, 0, 0.6);
+      --sa-shadow: 0 16px 48px rgba(0, 0, 0, 0.4), 0 2px 8px rgba(0, 0, 0, 0.2);
+      --sa-error: #f87171;
+      --sa-error-bg: rgba(248, 113, 113, 0.1);
+  `;
+
   const style = document.createElement("style");
   style.textContent = `
     :host {
@@ -105,12 +761,14 @@
       --sa-bg: #ffffff;
       --sa-bg-elevated: #f6f6f6;
       --sa-text: #1a1a1a;
-      --sa-text-muted: #6b6b6b;
+      --sa-text-muted: #5f5f5f;
       --sa-border: #e0e0e0;
       --sa-accent: #2563eb;
       --sa-accent-soft: rgba(37, 99, 235, 0.08);
       --sa-backdrop: rgba(0, 0, 0, 0.4);
       --sa-shadow: 0 16px 48px rgba(0, 0, 0, 0.12), 0 2px 8px rgba(0, 0, 0, 0.08);
+      --sa-error: #b91c1c;
+      --sa-error-bg: rgba(185, 28, 28, 0.06);
       --sa-radius: 12px;
       --sa-radius-sm: 6px;
       --sa-trigger-size: 48px;
@@ -120,25 +778,21 @@
       position: fixed;
       z-index: 999999;
     }
-
+    :host([data-theme="dark"]) { ${DARK_TOKENS} }
     @media (prefers-color-scheme: dark) {
-      :host {
-        --sa-bg: #1a1a1a;
-        --sa-bg-elevated: #252525;
-        --sa-text: #e8e8e8;
-        --sa-text-muted: #999999;
-        --sa-border: #333333;
-        --sa-accent: #60a5fa;
-        --sa-accent-soft: rgba(96, 165, 250, 0.1);
-        --sa-backdrop: rgba(0, 0, 0, 0.6);
-        --sa-shadow: 0 16px 48px rgba(0, 0, 0, 0.4), 0 2px 8px rgba(0, 0, 0, 0.2);
-      }
+      :host([data-theme="auto"]) { ${DARK_TOKENS} }
     }
 
-    *, *::before, *::after {
-      box-sizing: border-box;
-      margin: 0;
-      padding: 0;
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+    .sa-visually-hidden {
+      position: absolute !important;
+      width: 1px; height: 1px;
+      padding: 0; margin: -1px;
+      overflow: hidden;
+      clip: rect(0, 0, 0, 0);
+      white-space: nowrap;
+      border: 0;
     }
 
     .sa-trigger {
@@ -156,27 +810,14 @@
       box-shadow: 0 2px 12px rgba(0,0,0,0.1);
       transition: transform 0.15s ease, box-shadow 0.15s ease;
     }
-    .sa-trigger:hover {
-      transform: scale(1.06);
-      box-shadow: 0 4px 16px rgba(0,0,0,0.15);
-    }
-    .sa-trigger:active {
-      transform: scale(0.96);
-    }
-    .sa-trigger svg {
-      width: 20px;
-      height: 20px;
-      stroke: currentColor;
-      fill: none;
-      stroke-width: 2;
-      stroke-linecap: round;
-      stroke-linejoin: round;
+    .sa-trigger:hover { transform: scale(1.06); box-shadow: 0 4px 16px rgba(0,0,0,0.15); }
+    .sa-trigger:active { transform: scale(0.96); }
+    .sa-trigger:focus-visible, .sa-close:focus-visible, .sa-btn:focus-visible,
+    .sa-result:focus-visible, .sa-cite:focus-visible, .sa-answer-cite:focus-visible {
+      outline: 2px solid var(--sa-accent);
+      outline-offset: 2px;
     }
-
-    .sa-pos-bottom-right { right: 24px; bottom: 24px; }
-    .sa-pos-bottom-left  { left: 24px; bottom: 24px; }
-    .sa-pos-top-right    { right: 24px; top: 24px; }
-    .sa-pos-top-left     { left: 24px; top: 24px; }
+    .sa-trigger svg { width: 20px; height: 20px; stroke: currentColor; fill: none; stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; }
 
     .sa-backdrop {
       position: fixed;
@@ -187,18 +828,17 @@
       justify-content: center;
       padding-top: 12vh;
     }
-    .sa-backdrop.sa-open {
-      display: flex;
-    }
+    .sa-backdrop.sa-open { display: flex; }
 
     .sa-modal {
       background: var(--sa-bg);
+      color: var(--sa-text);
       border: 1px solid var(--sa-border);
       border-radius: var(--sa-radius);
       box-shadow: var(--sa-shadow);
       width: 100%;
-      max-width: 600px;
-      max-height: 72vh;
+      max-width: 620px;
+      max-height: 76vh;
       display: flex;
       flex-direction: column;
       overflow: hidden;
@@ -212,24 +852,14 @@
     .sa-header {
       display: flex;
       align-items: center;
-      padding: 16px;
-      gap: 12px;
+      padding: 12px 16px;
+      gap: 10px;
       border-bottom: 1px solid var(--sa-border);
     }
-
-    .sa-search-icon {
-      flex-shrink: 0;
-      width: 18px;
-      height: 18px;
-      stroke: var(--sa-text-muted);
-      fill: none;
-      stroke-width: 2;
-      stroke-linecap: round;
-      stroke-linejoin: round;
-    }
-
+    .sa-search-icon { flex-shrink: 0; width: 18px; height: 18px; stroke: var(--sa-text-muted); fill: none; stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; }
     .sa-input {
       flex: 1;
+      min-width: 0;
       border: none;
       background: none;
       font-family: var(--sa-font);
@@ -237,14 +867,33 @@
       color: var(--sa-text);
       outline: none;
     }
-    .sa-input::placeholder {
-      color: var(--sa-text-muted);
+    .sa-input::placeholder { color: var(--sa-text-muted); }
+
+    .sa-btn {
+      flex-shrink: 0;
+      border-radius: var(--sa-radius-sm);
+      border: 1px solid var(--sa-border);
+      background: var(--sa-bg-elevated);
+      color: var(--sa-text);
+      cursor: pointer;
+      font-family: var(--sa-font);
+      font-size: 12px;
+      padding: 5px 10px;
+      line-height: 1.2;
+      transition: border-color 0.1s;
     }
+    .sa-btn:hover { border-color: var(--sa-text-muted); }
+    .sa-btn:disabled { opacity: 0.5; cursor: default; }
+    .sa-btn-primary { background: var(--sa-accent); border-color: var(--sa-accent); color: #fff; }
+    .sa-btn-primary:hover { filter: brightness(1.08); border-color: var(--sa-accent); }
+    .sa-ask { font-weight: 600; }
+    .sa-ask[hidden] { display: none; }
 
     .sa-close {
       flex-shrink: 0;
-      width: 28px;
       height: 28px;
+      min-width: 28px;
+      padding: 0 6px;
       border-radius: var(--sa-radius-sm);
       border: 1px solid var(--sa-border);
       background: var(--sa-bg-elevated);
@@ -258,22 +907,12 @@
       line-height: 1;
       transition: border-color 0.1s;
     }
-    .sa-close:hover {
-      border-color: var(--sa-text-muted);
-    }
+    .sa-close:hover { border-color: var(--sa-text-muted); }
 
-    .sa-heart {
-      flex-shrink: 0;
-      width: 14px;
-      height: 8px;
-      image-rendering: pixelated;
-      image-rendering: crisp-edges;
-      opacity: 0.95;
-      display: block;
-    }
+    .sa-heart { flex-shrink: 0; width: 14px; height: 8px; image-rendering: pixelated; image-rendering: crisp-edges; opacity: 0.95; display: block; }
 
     .sa-status {
-      padding: 12px 16px;
+      padding: 10px 16px;
       font-size: 13px;
       color: var(--sa-text-muted);
       display: none;
@@ -281,80 +920,84 @@
       gap: 10px;
       border-bottom: 1px solid var(--sa-border);
     }
-    .sa-status.sa-visible {
-      display: flex;
-    }
-
-    .sa-progress-bar {
-      flex: 1;
-      height: 3px;
-      background: var(--sa-bg-elevated);
-      border-radius: 2px;
-      overflow: hidden;
-    }
-    .sa-progress-fill {
-      height: 100%;
-      background: var(--sa-accent);
-      border-radius: 2px;
-      width: 0%;
-      transition: width 0.2s ease;
-    }
-    .sa-progress-indeterminate .sa-progress-fill {
-      width: 40%;
-      animation: sa-indeterminate 1.2s ease-in-out infinite;
-    }
+    .sa-status.sa-visible { display: flex; }
+    .sa-status-text { flex-shrink: 0; }
+    .sa-progress-bar { flex: 1; height: 3px; background: var(--sa-bg-elevated); border-radius: 2px; overflow: hidden; }
+    .sa-progress-fill { height: 100%; background: var(--sa-accent); border-radius: 2px; width: 0%; transition: width 0.2s ease; }
+    .sa-progress-indeterminate .sa-progress-fill { width: 40%; animation: sa-indeterminate 1.2s ease-in-out infinite; }
     @keyframes sa-indeterminate {
       0%   { transform: translateX(-100%); }
       100% { transform: translateX(350%); }
     }
 
-    .sa-results {
-      flex: 1;
-      overflow-y: auto;
-      list-style: none;
-    }
-
-    .sa-answer {
+    .sa-card {
       display: none;
       border-bottom: 1px solid var(--sa-border);
       background: var(--sa-bg-elevated);
       padding: 12px 16px;
-      gap: 6px;
       flex-direction: column;
+      gap: 8px;
+      font-size: 13px;
+      line-height: 1.45;
+      color: var(--sa-text);
     }
-    .sa-answer.sa-visible {
-      display: flex;
-    }
-    .sa-answer-label {
+    .sa-card.sa-visible { display: flex; }
+    .sa-card-label {
       font-size: 11px;
       letter-spacing: 0.08em;
       text-transform: uppercase;
       color: var(--sa-text-muted);
       font-family: var(--sa-font-mono);
-    }
-    .sa-answer-text {
-      font-size: 14px;
-      line-height: 1.45;
-      color: var(--sa-text);
-    }
-    .sa-answer-cites {
       display: flex;
-      flex-wrap: wrap;
+      align-items: center;
       gap: 8px;
-      margin-top: 2px;
-    }
-    .sa-answer-cite {
-      font-size: 11px;
-      color: var(--sa-accent);
-      text-decoration: none;
-      border: 1px solid var(--sa-border);
-      border-radius: 999px;
-      padding: 2px 8px;
+      flex-wrap: wrap;
     }
-    .sa-answer-cite:hover {
-      border-color: var(--sa-accent);
+    .sa-card-label .sa-model { text-transform: none; letter-spacing: 0; }
+    .sa-card-actions { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; }
+    .sa-muted { color: var(--sa-text-muted); }
+
+    .sa-error {
+      padding: 10px 16px;
+      font-size: 13px;
+      color: var(--sa-error);
+      background: var(--sa-error-bg);
+      border-bottom: 1px solid var(--sa-border);
+      display: none;
+      align-items: center;
+      gap: 10px;
+      flex-wrap: wrap;
     }
+    .sa-error.sa-visible { display: flex; }
+    .sa-error .sa-btn { color: var(--sa-text); }
 
+    .sa-notice {
+      padding: 6px 16px;
+      font-size: 12px;
+      color: var(--sa-text-muted);
+      border-bottom: 1px solid var(--sa-border);
+      display: none;
+    }
+    .sa-notice.sa-visible { display: block; }
+
+    .sa-answer-text:not(.sa-visible), .sa-sources:not(.sa-visible), .sa-answer-progress:not(.sa-visible) { display: none; }
+    .sa-answer-text { font-size: 14px; line-height: 1.5; color: var(--sa-text); white-space: pre-wrap; }
+    .sa-answer-text.sa-nohit { color: var(--sa-text-muted); font-style: italic; }
+    .sa-answer-cite { color: var(--sa-accent); text-decoration: none; font-family: var(--sa-font-mono); font-size: 12px; }
+    .sa-answer-cite:hover { text-decoration: underline; }
+    .sa-caret { display: inline-block; width: 0.5em; height: 1em; vertical-align: text-bottom; background: var(--sa-accent); animation: sa-blink 1s steps(2) infinite; margin-left: 2px; }
+    @keyframes sa-blink { to { opacity: 0; } }
+    .sa-sources { list-style: none; display: flex; flex-direction: column; gap: 3px; }
+    .sa-sources li { font-size: 12px; }
+    .sa-cite { color: var(--sa-accent); text-decoration: none; }
+    .sa-cite:hover { text-decoration: underline; }
+    .sa-cite-n { font-family: var(--sa-font-mono); color: var(--sa-text-muted); margin-right: 6px; }
+    .sa-faq-q { font-weight: 600; }
+
+    .sa-results { flex: 1; overflow-y: auto; list-style: none; }
+    .sa-empty { padding: 32px 16px; text-align: center; color: var(--sa-text-muted); font-size: 14px; display: none; }
+    .sa-empty.sa-visible { display: block; }
+    .sa-option { list-style: none; }
     .sa-result {
       display: block;
       padding: 12px 16px;
@@ -364,61 +1007,23 @@
       color: inherit;
       transition: background 0.08s;
     }
-    .sa-result:last-child {
-      border-bottom: none;
-    }
-    .sa-result:hover,
-    .sa-result[aria-selected="true"] {
-      background: var(--sa-accent-soft);
-    }
-    .sa-result-title {
-      font-size: 14px;
-      font-weight: 600;
-      color: var(--sa-text);
-      margin-bottom: 2px;
-    }
-    .sa-result-url {
-      font-family: var(--sa-font-mono);
-      font-size: 11px;
-      color: var(--sa-accent);
-      margin-bottom: 4px;
-    }
-    .sa-result-section {
-      font-size: 11px;
-      color: var(--sa-text-muted);
-      margin-bottom: 4px;
-    }
-    .sa-result-snippet {
-      font-size: 13px;
-      color: var(--sa-text-muted);
-      line-height: 1.45;
-    }
-
-    .sa-empty {
-      padding: 32px 16px;
-      text-align: center;
-      color: var(--sa-text-muted);
-      font-size: 14px;
-    }
-
-    .sa-error {
-      padding: 12px 16px;
-      font-size: 13px;
-      color: #dc2626;
-      display: none;
-    }
-    .sa-error.sa-visible {
-      display: block;
-    }
-
-    .sa-footer {
-      padding: 8px 16px;
-      border-top: 1px solid var(--sa-border);
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
+    .sa-option:last-child .sa-result { border-bottom: none; }
+    .sa-result:hover, .sa-option[aria-selected="true"] .sa-result { background: var(--sa-accent-soft); }
+    .sa-result-title { font-size: 14px; font-weight: 600; color: var(--sa-text); margin-bottom: 2px; }
+    .sa-result-url { font-family: var(--sa-font-mono); font-size: 11px; color: var(--sa-accent); margin-bottom: 4px; word-break: break-all; }
+    .sa-result-section { font-size: 11px; color: var(--sa-text-muted); margin-bottom: 4px; }
+    .sa-result-snippet { font-size: 13px; color: var(--sa-text-muted); line-height: 1.45; }
+
+    .sa-footer {
+      padding: 8px 16px;
+      border-top: 1px solid var(--sa-border);
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
       font-size: 11px;
       color: var(--sa-text-muted);
+      gap: 8px;
+      flex-wrap: wrap;
     }
     .sa-footer kbd {
       display: inline-block;
@@ -430,15 +1035,7 @@
       background: var(--sa-bg-elevated);
       margin: 0 2px;
     }
-
-    .sa-brand {
-      display: inline-flex;
-      align-items: center;
-      gap: 6px;
-      letter-spacing: 0.08em;
-      font-weight: 600;
-    }
-
+    .sa-brand { display: inline-flex; align-items: center; gap: 6px; letter-spacing: 0.08em; font-weight: 600; }
     .sa-brand-link {
       color: var(--sa-text-muted);
       text-decoration: none;
@@ -447,28 +1044,19 @@
       padding: 2px 8px;
       transition: border-color 0.12s ease, color 0.12s ease, background 0.12s ease;
     }
-    .sa-brand-link:hover {
-      border-color: var(--sa-text-muted);
-      color: var(--sa-text);
-      background: var(--sa-bg-elevated);
-    }
-    .sa-brand-link:focus-visible {
-      outline: 1px solid var(--sa-accent);
-      outline-offset: 2px;
+    .sa-brand-link:hover { border-color: var(--sa-text-muted); color: var(--sa-text); background: var(--sa-bg-elevated); }
+    .sa-brand-link:focus-visible { outline: 1px solid var(--sa-accent); outline-offset: 2px; }
+
+    @media (prefers-reduced-motion: reduce) {
+      .sa-modal { animation: none; }
+      .sa-trigger, .sa-progress-fill, .sa-result, .sa-btn, .sa-close, .sa-brand-link { transition: none; }
+      .sa-progress-indeterminate .sa-progress-fill { animation: none; width: 100%; opacity: 0.5; }
+      .sa-caret { animation: none; }
     }
 
-    /* Mobile: bottom sheet */
     @media (max-width: 640px) {
-      .sa-backdrop {
-        padding-top: 0;
-        align-items: flex-end;
-      }
-      .sa-modal {
-        max-width: 100%;
-        max-height: 85vh;
-        border-radius: var(--sa-radius) var(--sa-radius) 0 0;
-        animation-name: sa-slide-up;
-      }
+      .sa-backdrop { padding-top: 0; align-items: flex-end; }
+      .sa-modal { max-width: 100%; max-height: 85vh; border-radius: var(--sa-radius) var(--sa-radius) 0 0; animation-name: sa-slide-up; }
       @keyframes sa-slide-up {
         from { opacity: 0; transform: translateY(40px); }
         to   { opacity: 1; transform: translateY(0); }
@@ -477,11 +1065,27 @@
   `;
   shadow.appendChild(style);
 
-  // -- SVG helper --
+  // -- Element helpers --
+  function el(tag, className, text) {
+    const node = document.createElement(tag);
+    if (className) node.className = className;
+    if (text != null) node.textContent = text;
+    return node;
+  }
+
+  function button(className, text, onClick, attrs) {
+    const b = el("button", className, text);
+    b.type = "button";
+    if (onClick) b.addEventListener("click", onClick);
+    if (attrs) Object.keys(attrs).forEach((k) => b.setAttribute(k, attrs[k]));
+    return b;
+  }
+
   function createSearchSvg(className) {
     const ns = "http://www.w3.org/2000/svg";
     const svg = document.createElementNS(ns, "svg");
     svg.setAttribute("viewBox", "0 0 24 24");
+    svg.setAttribute("aria-hidden", "true");
     if (className) svg.setAttribute("class", className);
     const circle = document.createElementNS(ns, "circle");
     circle.setAttribute("cx", "11");
@@ -498,49 +1102,51 @@
   }
 
   // -- Trigger button --
-  const trigger = document.createElement("button");
-  trigger.className = `sa-trigger sa-pos-${config.position}`;
-  trigger.setAttribute("aria-label", "Search");
+  const trigger = button(`sa-trigger sa-pos-${config.position}`, null, openModal, { "aria-label": "Search" });
   trigger.appendChild(createSearchSvg());
-  trigger.addEventListener("click", openModal);
   applyTriggerOffsets();
   shadow.appendChild(trigger);
 
-  // -- Backdrop --
-  const backdrop = document.createElement("div");
-  backdrop.className = "sa-backdrop";
+  // -- Backdrop + modal --
+  const backdrop = el("div", "sa-backdrop");
   backdrop.addEventListener("click", (e) => {
     if (e.target === backdrop) closeModal();
   });
   shadow.appendChild(backdrop);
 
-  // -- Modal --
-  const modal = document.createElement("div");
-  modal.className = "sa-modal";
+  const modal = el("div", "sa-modal");
   modal.setAttribute("role", "dialog");
   modal.setAttribute("aria-modal", "true");
   modal.setAttribute("aria-label", "Search");
   backdrop.appendChild(modal);
 
   // Header
-  const header = document.createElement("div");
-  header.className = "sa-header";
+  const header = el("div", "sa-header");
   header.appendChild(createSearchSvg("sa-search-icon"));
   modal.appendChild(header);
 
-  const input = document.createElement("input");
-  input.className = "sa-input";
+  const input = el("input", "sa-input");
   input.type = "text";
-  input.setAttribute("role", "searchbox");
+  input.setAttribute("role", "combobox");
   input.setAttribute("aria-label", "Search query");
-  input.placeholder = "Search\u2026";
+  input.setAttribute("aria-autocomplete", "list");
+  input.setAttribute("aria-haspopup", "listbox");
+  input.setAttribute("aria-expanded", "false");
+  input.setAttribute("aria-controls", "sa-results");
+  input.setAttribute("autocomplete", "off");
+  input.setAttribute("spellcheck", "false");
+  input.placeholder = "Search…";
   header.appendChild(input);
 
-  const closeBtn = document.createElement("button");
-  closeBtn.className = "sa-close";
-  closeBtn.setAttribute("aria-label", "Close");
-  closeBtn.textContent = "esc";
-  closeBtn.addEventListener("click", closeModal);
+  const askBtn = button("sa-btn sa-ask", "Ask", () => askQuestion(input.value.trim()), {
+    "aria-label": "Ask a question about this site (Shift+Enter)",
+    title: "Ask (Shift+Enter)",
+  });
+  askBtn.hidden = true;
+  header.appendChild(askBtn);
+
+  const closeBtn = button("sa-close", "esc", closeModal, { "aria-label": "Close (Esc)" });
+  header.appendChild(closeBtn);
 
   const heart = document.createElement("canvas");
   heart.className = "sa-heart";
@@ -548,81 +1154,150 @@
   heart.height = 4;
   heart.setAttribute("aria-hidden", "true");
   drawHeartSprite(0);
-  header.appendChild(closeBtn);
 
-  // Status bar
-  const status = document.createElement("div");
-  status.className = "sa-status";
-  modal.appendChild(status);
+  // Live region for screen readers (loading, progress, counts, answers)
+  const liveRegion = el("div", "sa-visually-hidden");
+  liveRegion.setAttribute("role", "status");
+  liveRegion.setAttribute("aria-live", "polite");
+  liveRegion.setAttribute("aria-atomic", "true");
+  modal.appendChild(liveRegion);
 
-  const statusText = document.createElement("span");
+  // Status bar (visible progress)
+  const status = el("div", "sa-status");
+  const statusText = el("span", "sa-status-text");
   status.appendChild(statusText);
-
-  const progressBar = document.createElement("div");
-  progressBar.className = "sa-progress-bar";
-  const progressFill = document.createElement("div");
-  progressFill.className = "sa-progress-fill";
+  const progressBar = el("div", "sa-progress-bar");
+  progressBar.setAttribute("role", "progressbar");
+  progressBar.setAttribute("aria-label", "Loading progress");
+  progressBar.setAttribute("aria-valuemin", "0");
+  progressBar.setAttribute("aria-valuemax", "100");
+  const progressFill = el("div", "sa-progress-fill");
   progressBar.appendChild(progressFill);
   status.appendChild(progressBar);
+  modal.appendChild(status);
+
+  // Download consent card
+  const consentCard = el("div", "sa-card");
+  const consentLabel = el("div", "sa-card-label", "Download the search model?");
+  const consentText = el("div");
+  const consentActions = el("div", "sa-card-actions");
+  const consentAccept = button("sa-btn sa-btn-primary", "Download", acceptConsent);
+  const consentDecline = button("sa-btn", "Keyword search only", declineConsent);
+  consentActions.appendChild(consentAccept);
+  consentActions.appendChild(consentDecline);
+  consentCard.appendChild(consentLabel);
+  consentCard.appendChild(consentText);
+  consentCard.appendChild(consentActions);
+  modal.appendChild(consentCard);
 
   // Error area
-  const errorEl = document.createElement("div");
-  errorEl.className = "sa-error";
+  const errorEl = el("div", "sa-error");
+  errorEl.setAttribute("role", "alert");
+  const errorText = el("span");
+  const retryBtn = button("sa-btn", "Retry", retryInit);
+  errorEl.appendChild(errorText);
+  errorEl.appendChild(retryBtn);
   modal.appendChild(errorEl);
 
-  // Answer area (experimental factual mode)
-  const answerEl = document.createElement("div");
-  answerEl.className = "sa-answer";
-  modal.appendChild(answerEl);
+  // Degraded notice
+  const noticeEl = el("div", "sa-notice");
+  modal.appendChild(noticeEl);
+
+  // Answer card (agent)
+  const answerCard = el("div", "sa-card sa-answer");
+  const answerLabel = el("div", "sa-card-label");
+  const answerLabelText = el("span", null, "Answer");
+  const answerModel = el("span", "sa-model");
+  answerLabel.appendChild(answerLabelText);
+  answerLabel.appendChild(answerModel);
+  const answerProgress = el("div", "sa-answer-progress sa-muted");
+  const answerText = el("div", "sa-answer-text");
+  const answerSources = el("ol", "sa-sources");
+  const answerActions = el("div", "sa-card-actions");
+  const stopBtn = button("sa-btn", "Stop", () => abortAgent("stopped"));
+  // The three agent buttons get a fresh `onclick` each time they are shown.
+  const answerRetryBtn = button("sa-btn", "Retry", null);
+  const agentConsentAccept = button("sa-btn sa-btn-primary", "Download and answer", null);
+  const agentConsentCancel = button("sa-btn", "Cancel", null);
+  agentConsentCancel.onclick = hideAnswerCard;
+  answerCard.appendChild(answerLabel);
+  answerCard.appendChild(answerProgress);
+  answerCard.appendChild(answerText);
+  answerCard.appendChild(answerSources);
+  answerCard.appendChild(answerActions);
+  modal.appendChild(answerCard);
+
+  // FAQ card (qa_lookup hits)
+  const faqCard = el("div", "sa-card");
+  faqCard.appendChild(el("div", "sa-card-label", "From the FAQ"));
+  const faqQ = el("div", "sa-faq-q");
+  const faqA = el("div");
+  const faqSrc = el("div");
+  faqCard.appendChild(faqQ);
+  faqCard.appendChild(faqA);
+  faqCard.appendChild(faqSrc);
+  modal.appendChild(faqCard);
+
+  // Empty state (outside the listbox)
+  const emptyEl = el("div", "sa-empty", "No results found.");
+  modal.appendChild(emptyEl);
 
   // Results
-  const resultsList = document.createElement("ul");
-  resultsList.className = "sa-results";
+  const resultsList = el("ul", "sa-results");
+  resultsList.id = "sa-results";
   resultsList.setAttribute("role", "listbox");
+  resultsList.setAttribute("aria-label", "Search results");
   modal.appendChild(resultsList);
 
-  // Footer (built with DOM, not innerHTML)
-  const footer = document.createElement("div");
-  footer.className = "sa-footer";
-
-  const footerNav = document.createElement("span");
-  const keys = [
-    ["\u2191", ""],
-    ["\u2193", " navigate "],
-    ["enter", " open"],
-  ];
+  // Footer
+  const footer = el("div", "sa-footer");
+  const footerNav = el("span");
+  const keys = [["↑", ""], ["↓", " navigate "], ["enter", " open"]];
   keys.forEach(([key, after]) => {
-    const kbd = document.createElement("kbd");
-    kbd.textContent = key;
+    const kbd = el("kbd", null, key);
     footerNav.appendChild(kbd);
     if (after) footerNav.appendChild(document.createTextNode(after));
   });
+  const askHint = el("span");
+  askHint.hidden = true;
+  askHint.appendChild(document.createTextNode(" "));
+  askHint.appendChild(el("kbd", null, "shift+enter"));
+  askHint.appendChild(document.createTextNode(" ask"));
+  footerNav.appendChild(askHint);
   footer.appendChild(footerNav);
 
-  const footerBrandLink = document.createElement("a");
-  footerBrandLink.className = "sa-brand-link";
+  const footerBrandLink = el("a", "sa-brand-link");
   footerBrandLink.href = "https://github.com/jt55401/eddie";
   footerBrandLink.target = "_blank";
   footerBrandLink.rel = "noopener noreferrer";
   footerBrandLink.setAttribute("aria-label", "Eddie on GitHub (opens in a new tab)");
-
-  const footerBrand = document.createElement("span");
-  footerBrand.className = "sa-brand";
+  const footerBrand = el("span", "sa-brand");
   footerBrand.appendChild(document.createTextNode("EDDIE"));
   footerBrand.appendChild(heart);
   footerBrandLink.appendChild(footerBrand);
   footer.appendChild(footerBrandLink);
-
   modal.appendChild(footer);
 
   // -- Keyboard handling --
   input.addEventListener("keydown", (e) => {
     if (e.key === "Enter") {
       e.preventDefault();
+      const q = input.value.trim();
+      if (e.shiftKey) {
+        if (q && !askBtn.hidden) {
+          // Flush the pending search-as-you-type run so it neither races the
+          // answer nor fires 200 ms later and cancels it.
+          clearTimeout(searchTimer);
+          if (lastSearchedQuery !== q) doSearch(q, true);
+          askQuestion(q);
+        }
+        return;
+      }
       if (selectedIndex >= 0 && selectedIndex < currentResults.length) {
-        navigateToResult(currentResults[selectedIndex]);
-      } else if (input.value.trim()) {
-        doSearch(input.value.trim());
+        navigateTo(currentResults[selectedIndex].url);
+      } else if (q) {
+        clearTimeout(searchTimer);
+        doSearch(q, true);
       }
     } else if (e.key === "ArrowDown") {
       e.preventDefault();
@@ -630,25 +1305,22 @@
     } else if (e.key === "ArrowUp") {
       e.preventDefault();
       moveSelection(-1);
-    } else if (e.key === "Escape") {
-      e.preventDefault();
-      closeModal();
     }
   });
 
-  // Debounced search-as-you-type
-  let searchTimer = null;
+  // Search-as-you-type: retrieval only, never the agent.
   input.addEventListener("input", () => {
     clearTimeout(searchTimer);
     const q = input.value.trim();
-    if (q.length >= 2 && engineState === "ready") {
-      searchTimer = setTimeout(() => doSearch(q), 200);
+    setSelected(-1);
+    if (q.length >= 2) {
+      searchTimer = setTimeout(() => doSearch(q, false), 200);
     } else if (q.length === 0) {
       clearResults();
     }
   });
 
-  // Focus trap
+  // Esc closes; Tab cycles through everything focusable in the modal.
   modal.addEventListener("keydown", (e) => {
     if (e.key === "Escape") {
       e.preventDefault();
@@ -656,264 +1328,830 @@
       return;
     }
     if (e.key !== "Tab") return;
-
-    const focusable = [input, closeBtn];
+    const focusable = Array.from(modal.querySelectorAll("input, button, a[href]")).filter(isVisible);
+    if (focusable.length === 0) return;
     const first = focusable[0];
     const last = focusable[focusable.length - 1];
-
-    if (e.shiftKey) {
-      if (shadow.activeElement === first) {
-        e.preventDefault();
-        last.focus();
-      }
-    } else {
-      if (shadow.activeElement === last) {
-        e.preventDefault();
-        first.focus();
-      }
+    const current = shadow.activeElement;
+    if (e.shiftKey && (current === first || !focusable.includes(current))) {
+      e.preventDefault();
+      last.focus();
+    } else if (!e.shiftKey && current === last) {
+      e.preventDefault();
+      first.focus();
     }
   });
 
-  // -- Worker communication --
-  function ensureWorker() {
-    if (worker) return;
-
-    worker = new Worker(resolveAsset("eddie-worker.js"));
-    worker.onmessage = (e) => {
-      const msg = e.data;
+  function isVisible(node) {
+    if (node.hidden || node.disabled) return false;
+    let n = node;
+    while (n && n !== modal) {
+      if (n.hidden) return false;
+      const cs = getComputedStyle(n);
+      if (cs.display === "none" || cs.visibility === "hidden") return false;
+      n = n.parentElement;
+    }
+    return true;
+  }
 
-      if (msg.type === "status") {
-        handleStatus(msg);
-      } else if (msg.type === "search_result") {
-        handleSearchResult(msg);
-      } else if (msg.type === "error") {
-        handleError(msg);
-      }
+  // -- Search worker --
+  function ensureWorker() {
+    if (worker) {
+      if (workerState === "error") retryInit();
+      return;
+    }
+    try {
+      worker = new Worker(lib.assetUrl(baseUrl, "eddie-worker.js", version));
+    } catch (err) {
+      showInitError("Couldn't start the search worker: " + (err && err.message ? err.message : err), false);
+      return;
+    }
+    worker.onmessage = (e) => onWorkerMessage(e.data || {});
+    worker.onerror = (e) => {
+      // An uncaught error in the worker script (a 404, a syntax error, an
+      // exception outside a handler): start a fresh worker on Retry.
+      const message = e && e.message ? e.message : "search worker failed to load";
+      setWorkerState("dead");
+      searchable = false;
+      showStatus(false);
+      showInitError(message, true);
+      failAllPending(new Error(message));
     };
+    postInit(false);
+  }
 
-    engineState = "loading";
+  function postInit(consent) {
+    setWorkerState("loading");
+    hide(errorEl);
     worker.postMessage({
       type: "init",
-      indexUrl: new URL(config.indexUrl, location.href).href,
-      baseUrl: baseUrl,
+      indexUrl,
+      baseUrl,
+      version,
+      denseRuntime: config.denseRuntime,
+      consent: !!consent,
     });
   }
 
-  function handleStatus(msg) {
-    const stateLabels = {
-      loading_wasm: "Loading search engine\u2026",
-      loading_index: "Loading index\u2026",
-      checking_cache: "Checking model cache\u2026",
-      downloading_model: "Downloading model\u2026",
-      initializing: "Initializing\u2026",
-      ready: "Ready",
-    };
-
-    if (msg.state === "ready") {
-      engineState = "ready";
-      showStatus(false);
-      // If there's already a query waiting, run it
-      if (input.value.trim().length >= 2) {
-        doSearch(input.value.trim());
-      }
+  function retryInit() {
+    hide(errorEl);
+    if (!worker || workerState === "dead") {
+      if (worker) worker.terminate();
+      worker = null;
+      searchable = false;
+      setWorkerState("idle");
+      ensureWorker();
       return;
     }
+    postInit(false);
+  }
 
-    if (msg.state === "error") {
-      engineState = "error";
-      showError(msg.error || "Failed to initialize");
-      showStatus(false);
-      return;
-    }
+  function callWorker(type, payload) {
+    return new Promise((resolve, reject) => {
+      if (!worker) {
+        reject(new Error("search worker not running"));
+        return;
+      }
+      const requestId = ++requestSeq;
+      pending.set(requestId, { resolve, reject });
+      worker.postMessage(Object.assign({ type, requestId }, payload || {}));
+    });
+  }
 
-    engineState = "loading";
-    statusText.textContent = stateLabels[msg.state] || msg.state;
-    showStatus(true);
+  function failAllPending(err) {
+    pending.forEach((p) => p.reject(err));
+    pending.clear();
+  }
 
-    if (msg.state === "downloading_model" && msg.progress != null) {
-      progressBar.classList.remove("sa-progress-indeterminate");
-      progressFill.style.width = Math.round(msg.progress * 100) + "%";
-      statusText.textContent =
-        "Downloading " + (msg.file || "model") + "\u2026 " +
-        Math.round(msg.progress * 100) + "%";
-    } else {
-      progressBar.classList.add("sa-progress-indeterminate");
-      progressFill.style.width = "";
+  function onWorkerMessage(msg) {
+    if (msg.requestId != null && pending.has(msg.requestId)) {
+      const p = pending.get(msg.requestId);
+      pending.delete(msg.requestId);
+      if (msg.type === "error") {
+        const err = new Error(msg.message || "request failed");
+        err.fatal = !!msg.fatal;
+        p.reject(err);
+        if (msg.fatal) onFatal(msg.message);
+      } else {
+        p.resolve(msg);
+      }
+      return;
+    }
+    switch (msg.type) {
+      case "status":
+        handleStatus(msg);
+        break;
+      case "ready":
+        handleReady(msg);
+        break;
+      case "error":
+        if (msg.fatal) onFatal(msg.message);
+        else showInitError(msg.message || "Search failed", false);
+        break;
+      default:
+        break;
     }
   }
 
-  function handleSearchResult(msg) {
-    if (msg.requestId !== activeRequestId) return;
-    currentResults = msg.results || [];
-    currentAnswer = msg.answer || null;
-    searchPending = false;
-    maybeFinalizeQuery();
+  function onFatal(message) {
+    setWorkerState("dead");
+    searchable = false;
+    showStatus(false);
+    showInitError(message || "The search engine crashed.", true);
   }
 
-  function maybeFinalizeQuery() {
-    if (searchPending) {
-      return;
+  function handleStatus(msg) {
+    switch (msg.state) {
+      case "loading_wasm":
+        setWorkerState("loading");
+        setStatus("Loading search engine…", null);
+        announce("Loading search engine");
+        break;
+      case "loading_index":
+        setStatus("Loading index…", msg.progress);
+        break;
+      case "index_ready":
+        manifestInfo = msg.manifest || null;
+        setWorkerState("index_ready");
+        searchable = true;
+        setStatus("Loading search model…", null);
+        rerunQuery();
+        break;
+      case "consent_required":
+        setWorkerState("awaiting_consent");
+        showStatus(false);
+        if (consentDeclined) break;
+        showConsent(msg);
+        break;
+      case "downloading_model": {
+        const pct = msg.progress == null ? null : Math.round(msg.progress * 100);
+        const file = msg.file || "model";
+        setStatus(`Downloading ${file}…` + (pct == null ? "" : ` ${pct}%`), msg.progress);
+        if (pct != null) {
+          const quarter = Math.floor(pct / 25);
+          if (quarter !== lastAnnouncedQuarter && pct < 100) {
+            lastAnnouncedQuarter = quarter;
+            announce(`Downloading model, ${pct}%`);
+          }
+        }
+        break;
+      }
+      case "loading_model":
+        setStatus(msg.file === "transformers.js" ? "Loading WebGPU runtime…" : "Loading model…", null);
+        break;
+      case "error":
+        setWorkerState(msg.fatal ? "dead" : "error");
+        showStatus(false);
+        showInitError(msg.message || "Failed to initialise search", !msg.unsupported);
+        break;
+      default:
+        break;
     }
+  }
 
-    selectedIndex = -1;
+  function handleReady(msg) {
+    setWorkerState("ready");
+    searchable = true;
+    manifestInfo = msg.manifest || manifestInfo;
+    const arms = msg.arms || {};
+    host.dataset.arms = Object.keys(arms).filter((k) => arms[k]).join(",");
+    host.dataset.lane = msg.lane || "";
+    host.dataset.runtime = msg.runtime || "";
     showStatus(false);
-    renderResults();
+    hide(consentCard);
+    lastDegradedNotice = lib.degradedNotice(msg.arms, msg.degraded);
+    announce(lastDegradedNotice ? "Search ready. " + lastDegradedNotice : "Search ready");
+    rerunQuery();
   }
 
-  function handleError(msg) {
-    if (msg.requestId && msg.requestId !== activeRequestId) return;
-    showError(msg.error || "Search failed");
+  function rerunQuery() {
+    const q = input.value.trim();
+    if (isOpen && q.length >= 2) doSearch(q, false);
   }
 
-  function doSearch(query) {
-    if (!worker || engineState !== "ready") return;
-    searchRequestId += 1;
-    activeRequestId = searchRequestId;
-    currentResults = [];
-    currentAnswer = null;
-    const answerMode = shouldUseAnswerMode(query);
-    searchPending = true;
+  // -- Consent --
+  function showConsent(msg) {
+    const lane = msg.lane || {};
+    const model = lane.model || lane.repo || "the search model";
+    const short = String(model).split("/").pop();
+    consentText.textContent = lib.consentCopy({
+      sizeBytes: msg.sizeBytes,
+      model: short,
+      saveData: saveData || !!msg.saveData,
+      consentText: config.consentText,
+    });
+    consentAccept.textContent = msg.sizeBytes == null ? "Download" : `Download ${lib.formatBytes(msg.sizeBytes)}`;
+    show(consentCard);
+    announce("Semantic search needs a model download. " + consentText.textContent);
+  }
 
-    if (answerMode) {
-      statusText.textContent = "Searching and grounding answer...";
-      progressBar.classList.add("sa-progress-indeterminate");
-      progressFill.style.width = "";
-      showStatus(true);
-    }
+  function acceptConsent() {
+    hide(consentCard);
+    if (!worker) return;
+    setWorkerState("loading");
+    worker.postMessage({ type: "init", indexUrl, baseUrl, version, denseRuntime: config.denseRuntime, consent: true });
+    input.focus();
+  }
 
+  function declineConsent() {
+    consentDeclined = true;
+    hide(consentCard);
+    lastDegradedNotice = "Keyword-only results: the semantic model wasn't downloaded.";
+    renderNotice();
+    input.focus();
+  }
+
+  // -- Searching --
+  function looksFactualQuery(query) {
+    const q = query.toLowerCase().trim();
+    if (!q) return false;
+    if (q.includes("?")) return true;
+    if (/^(who|what|when|where|why|how|does|do|is|are|can|could|should)\b/.test(q)) return true;
+    return q.split(/\s+/).length >= 5;
+  }
+
+  function wantQa(query) {
+    if (config.qaMode === "off") return false;
+    if (!manifestInfo || !Array.isArray(manifestInfo.sections) || !manifestInfo.sections.includes("qa")) return false;
+    if (config.qaMode === "always") return true;
+    return looksFactualQuery(query);
+  }
+
+  async function doSearch(query, explicit) {
+    if (!searchable || !worker) return;
+    // A different query cancels a running answer; re-searching the question
+    // being answered (a late debounce, a re-run after init) does not.
+    if (agentRun && !agentRun.done && query !== agentRun.question) abortAgent("new search");
+    lastSearchedQuery = query;
+    const requestId = ++requestSeq;
+    activeSearchId = requestId;
+    pending.set(requestId, {
+      resolve: (msg) => {
+        if (requestId !== activeSearchId) return;
+        renderSearchResult(msg, query);
+      },
+      reject: (err) => {
+        if (requestId !== activeSearchId) return;
+        showSearchError(err.message || "Search failed");
+      },
+    });
     worker.postMessage({
       type: "search",
-      requestId: activeRequestId,
-      query: query,
-      topK: config.resultTopK,
-      answerTopK: config.answerTopK,
-      answerMode: answerMode,
-      qaSubject: config.qaSubject || "",
+      requestId,
+      query,
+      topK: config.topK,
       mode: "hybrid",
+      qa: wantQa(query) ? Math.max(1, Math.min(config.answerTopK, 3)) : 0,
+      explicit: !!explicit,
     });
   }
 
-  // -- Rendering --
-  function renderResults() {
+  function renderSearchResult(msg, query) {
+    hide(errorEl);
+    currentResults = msg.results || [];
+    setSelected(-1);
+    // A missing arm is only worth a notice once loading is over (or the
+    // visitor declined the download); while the model loads the status bar
+    // already says so.
+    if (workerState === "ready") {
+      lastDegradedNotice = lib.degradedNotice(msg.arms, msg.degraded);
+    } else if (!consentDeclined) {
+      lastDegradedNotice = null;
+    }
+    renderNotice();
+    renderFaq(msg.qa);
+    renderResults();
+    const n = currentResults.length;
+    announce(n === 0 ? `No results for ${query}` : `${n} result${n === 1 ? "" : "s"} for ${query}. Use the arrow keys to browse.`);
+  }
+
+  function showSearchError(message) {
     resultsList.textContent = "";
-    errorEl.classList.remove("sa-visible");
-    renderAnswer();
-
-    if (currentResults.length === 0 && input.value.trim()) {
-      const empty = document.createElement("div");
-      empty.className = "sa-empty";
-      empty.textContent = "No results found.";
-      resultsList.appendChild(empty);
+    hide(emptyEl);
+    input.setAttribute("aria-expanded", "false");
+    errorText.textContent = message;
+    retryBtn.hidden = workerState !== "error" && workerState !== "dead";
+    show(errorEl);
+  }
+
+  function showInitError(message, canRetry) {
+    errorText.textContent = message;
+    retryBtn.hidden = !canRetry;
+    show(errorEl);
+    showStatus(false);
+  }
+
+  function renderNotice() {
+    if (lastDegradedNotice) {
+      noticeEl.textContent = lastDegradedNotice;
+      show(noticeEl);
+    } else {
+      hide(noticeEl);
+    }
+  }
+
+  function renderFaq(hits) {
+    faqQ.textContent = "";
+    faqA.textContent = "";
+    faqSrc.textContent = "";
+    if (!Array.isArray(hits) || hits.length === 0) {
+      hide(faqCard);
+      return;
+    }
+    const best = hits[0];
+    const threshold = config.qaMode === "always" ? 0 : 0.5;
+    if (!best || typeof best.score !== "number" || best.score < threshold) {
+      hide(faqCard);
       return;
     }
+    faqQ.textContent = best.question;
+    faqA.textContent = best.answer;
+    if (best.source_url) {
+      const a = el("a", "sa-cite", best.source_title || best.source_url);
+      a.href = best.source_url;
+      a.addEventListener("click", (e) => {
+        e.preventDefault();
+        navigateTo(best.source_url);
+      });
+      faqSrc.appendChild(document.createTextNode("Source: "));
+      faqSrc.appendChild(a);
+    }
+    show(faqCard);
+  }
 
+  function renderResults() {
+    resultsList.textContent = "";
+    if (currentResults.length === 0) {
+      input.setAttribute("aria-expanded", "false");
+      if (input.value.trim()) show(emptyEl);
+      else hide(emptyEl);
+      return;
+    }
+    hide(emptyEl);
+    input.setAttribute("aria-expanded", "true");
     currentResults.forEach((r, i) => {
-      const li = document.createElement("a");
-      li.className = "sa-result";
-      li.href = r.url;
+      const li = el("li", "sa-option");
+      li.id = `sa-opt-${i}`;
       li.setAttribute("role", "option");
       li.setAttribute("aria-selected", i === selectedIndex ? "true" : "false");
 
-      const titleEl = document.createElement("div");
-      titleEl.className = "sa-result-title";
-      titleEl.textContent = r.title;
-      li.appendChild(titleEl);
-
-      const urlEl = document.createElement("div");
-      urlEl.className = "sa-result-url";
-      urlEl.textContent = r.url;
-      li.appendChild(urlEl);
-
-      if (
-        r.section &&
-        r.section !== "Semantic Segment" &&
-        r.section !== "Summary Lane"
-      ) {
-        const sectionEl = document.createElement("div");
-        sectionEl.className = "sa-result-section";
-        sectionEl.textContent = r.section;
-        li.appendChild(sectionEl);
+      const a = el("a", "sa-result");
+      a.href = r.url;
+      a.tabIndex = -1;
+      a.appendChild(el("div", "sa-result-title", r.title || r.url));
+      a.appendChild(el("div", "sa-result-url", r.url));
+      if (r.section && !HIDDEN_SECTIONS.test(String(r.section).trim())) {
+        a.appendChild(el("div", "sa-result-section", r.section));
       }
-
       if (r.snippet) {
-        const snippetEl = document.createElement("div");
-        snippetEl.className = "sa-result-snippet";
-        snippetEl.textContent = r.snippet;
-        li.appendChild(snippetEl);
+        a.appendChild(el("div", "sa-result-snippet", r.snippet));
       }
-
-      li.addEventListener("click", (e) => {
+      a.addEventListener("click", (e) => {
         e.preventDefault();
-        navigateToResult(r);
+        navigateTo(r.url);
       });
-
+      a.addEventListener("focus", () => setSelected(i));
+      li.appendChild(a);
       resultsList.appendChild(li);
     });
+    // Result links are Tab-reachable once rendered.
+    resultsList.querySelectorAll(".sa-result").forEach((a) => {
+      a.tabIndex = 0;
+    });
+  }
+
+  function setSelected(index) {
+    selectedIndex = index;
+    const items = resultsList.querySelectorAll(".sa-option");
+    items.forEach((li, i) => li.setAttribute("aria-selected", i === selectedIndex ? "true" : "false"));
+    if (selectedIndex >= 0 && items[selectedIndex]) {
+      input.setAttribute("aria-activedescendant", items[selectedIndex].id);
+    } else {
+      input.removeAttribute("aria-activedescendant");
+    }
   }
 
   function moveSelection(delta) {
     if (currentResults.length === 0) return;
-
-    selectedIndex += delta;
-    if (selectedIndex < 0) selectedIndex = currentResults.length - 1;
-    if (selectedIndex >= currentResults.length) selectedIndex = 0;
-
-    const items = resultsList.querySelectorAll(".sa-result");
-    items.forEach((el, i) => {
-      el.setAttribute("aria-selected", i === selectedIndex ? "true" : "false");
-    });
-
-    // Scroll selected into view
+    let next = selectedIndex + delta;
+    if (next < 0) next = currentResults.length - 1;
+    if (next >= currentResults.length) next = 0;
+    setSelected(next);
+    const items = resultsList.querySelectorAll(".sa-option");
     const selected = items[selectedIndex];
-    if (selected) {
-      selected.scrollIntoView({ block: "nearest" });
-    }
+    if (selected) selected.scrollIntoView({ block: "nearest" });
   }
 
-  function navigateToResult(r) {
+  function navigateTo(url) {
     closeModal();
-    window.location.href = r.url;
+    window.location.href = url;
   }
 
   function clearResults() {
+    lastSearchedQuery = "";
     currentResults = [];
-    currentAnswer = null;
-    selectedIndex = -1;
-    searchPending = false;
+    activeSearchId = 0;
+    setSelected(-1);
     resultsList.textContent = "";
-    answerEl.classList.remove("sa-visible");
+    hide(emptyEl);
+    hide(faqCard);
+    input.setAttribute("aria-expanded", "false");
   }
 
-  function applyTriggerOffsets() {
-    const baseInset = 24;
-    const vertical = `${baseInset + config.offsetY}px`;
-    const horizontal = `${baseInset + config.offsetX}px`;
+  // -- Agent --
+  async function detectAgent() {
+    if (agentInfo !== null) return agentInfo;
+    agentInfo = false;
+    if (config.agentMode === "off" || !navigator.gpu || typeof navigator.gpu.requestAdapter !== "function") {
+      return agentInfo;
+    }
+    try {
+      const adapter = await navigator.gpu.requestAdapter();
+      if (adapter) {
+        agentInfo = {
+          maxBufferSize: adapter.limits ? adapter.limits.maxBufferSize : 0,
+          hasF16: !!(adapter.features && adapter.features.has("shader-f16")),
+        };
+      }
+    } catch (err) {
+      console.warn("eddie: WebGPU adapter probe failed", err);
+    }
+    if (agentInfo) {
+      agentModel = lib.selectAgentModel({
+        mode: config.agentModel,
+        maxBufferSize: agentInfo.maxBufferSize,
+        isMobile: lib.isMobileDevice(navigator),
+        hasF16: agentInfo.hasF16,
+      });
+      askBtn.hidden = false;
+      askHint.hidden = false;
+    }
+    return agentInfo;
+  }
 
-    trigger.style.top = "";
-    trigger.style.bottom = "";
-    trigger.style.left = "";
-    trigger.style.right = "";
+  function agentConsentGiven() {
+    try {
+      return localStorage.getItem(AGENT_CONSENT_KEY) === agentModel.id;
+    } catch (_) {
+      return false;
+    }
+  }
 
-    switch (config.position) {
-      case "top-left":
-        trigger.style.top = vertical;
-        trigger.style.left = horizontal;
+  function rememberAgentConsent() {
+    try {
+      localStorage.setItem(AGENT_CONSENT_KEY, agentModel.id);
+    } catch (_) {
+      // storage unavailable: ask again next time
+    }
+  }
+
+  function resetAnswerCard() {
+    answerProgress.textContent = "";
+    answerText.textContent = "";
+    answerText.classList.remove("sa-nohit");
+    answerSources.textContent = "";
+    clearAnswerActions();
+    answerModel.textContent = agentModel ? `${agentModel.base} · runs in your browser` : "";
+    hide(answerText);
+    hide(answerSources);
+    hide(answerProgress);
+  }
+
+  /** Remove the answer card's buttons; if one of them had focus, return it to the input. */
+  function clearAnswerActions() {
+    const active = shadow.activeElement;
+    answerActions.textContent = "";
+    if (active && !active.isConnected) input.focus();
+  }
+
+  function hideAnswerCard() {
+    hide(answerCard);
+    input.focus();
+  }
+
+  function showAnswerError(message, question) {
+    resetAnswerCard();
+    answerProgress.textContent = "Couldn't generate an answer" + (message ? ` (${message})` : "") + ".";
+    answerProgress.style.color = "var(--sa-error)";
+    show(answerProgress);
+    answerActions.appendChild(answerRetryBtn);
+    answerActions.appendChild(agentConsentCancel);
+    answerRetryBtn.onclick = () => askQuestion(question);
+    agentConsentCancel.onclick = hideAnswerCard;
+    show(answerCard);
+    announce("Couldn't generate an answer.");
+  }
+
+  async function askQuestion(question) {
+    if (!question) {
+      input.focus();
+      return;
+    }
+    if (!(await detectAgent())) return;
+    if (agentRun && !agentRun.done) abortAgent("new question");
+    resetAnswerCard();
+    answerProgress.style.color = "";
+    show(answerCard);
+
+    if (saveData) {
+      answerProgress.textContent = `Answers are off while Data Saver is on: the answer model is a ${lib.formatBytes(agentModel.sizeBytes)} download.`;
+      show(answerProgress);
+      agentConsentCancel.onclick = hideAnswerCard;
+      answerActions.appendChild(agentConsentCancel);
+      return;
+    }
+
+    if (!agentLoaded && !agentConsentGiven()) {
+      const consented = await requestAgentConsent();
+      if (!consented) return;
+    }
+
+    const run = { requestId: ++requestSeq, question, text: "", aborted: false, done: false, evidence: [], started: performance.now() };
+    agentRun = run;
+    answerProgress.textContent = "";
+    show(answerProgress);
+    answerActions.appendChild(stopBtn);
+    try {
+      await loadAgent(run);
+      if (run.aborted) return;
+      answerProgress.textContent = "Planning…";
+      const plan = await agentCall("plan", { requestId: run.requestId, question, site: siteName });
+      if (run.aborted) return;
+      const queries = Array.from(new Set((plan.queries || []).concat([question])));
+      answerProgress.textContent = "Searching: " + queries.join(" · ");
+      const lists = await Promise.all(
+        queries.map((q) => callWorker("search", { query: q, topK: 6, mode: "hybrid", evidence: true }).then((m) => m.results || []).catch(() => []))
+      );
+      if (run.aborted) return;
+      const evidence = lib.mergeEvidence(lists, 6);
+      await expandShortEvidence(evidence);
+      if (run.aborted) return;
+      run.evidence = evidence.map((r) => ({ title: r.title, url: r.url, text: r.text || r.snippet || "" }));
+      answerProgress.textContent = "Answering…";
+      await streamAnswer(run);
+    } catch (err) {
+      if (run.aborted) return;
+      console.warn("eddie agent:", err);
+      showAnswerError(err && err.message ? err.message : String(err), question);
+    }
+  }
+
+  function requestAgentConsent() {
+    return new Promise((resolve) => {
+      const size = lib.formatBytes(agentModel.sizeBytes);
+      answerProgress.textContent = config.consentText
+        ? config.consentText.replace(/\{size\}/g, size).replace(/\{model\}/g, agentModel.base)
+        : `Answers come from ${agentModel.base}, a language model that runs in your browser. Download it once (about ${size})? It stays in your browser's cache.`;
+      show(answerProgress);
+      clearAnswerActions();
+      agentConsentAccept.textContent = `Download ${size} and answer`;
+      agentConsentAccept.onclick = () => {
+        rememberAgentConsent();
+        clearAnswerActions();
+        resolve(true);
+      };
+      agentConsentCancel.onclick = () => {
+        hideAnswerCard();
+        resolve(false);
+      };
+      answerActions.appendChild(agentConsentAccept);
+      answerActions.appendChild(agentConsentCancel);
+      announce(answerProgress.textContent);
+      agentConsentAccept.focus();
+    });
+  }
+
+  function ensureAgentWorker() {
+    if (agentWorker) return;
+    agentWorker = new Worker(lib.assetUrl(baseUrl, "eddie-agent-worker.js", version), { type: "module" });
+    agentWorker.onmessage = (e) => onAgentMessage(e.data || {});
+    agentWorker.onerror = (e) => {
+      const message = e && e.message ? e.message : "agent worker failed to load";
+      if (agentPendingLoad) {
+        agentPendingLoad.reject(new Error(message));
+        agentPendingLoad = null;
+      }
+      if (agentRun && !agentRun.done) {
+        agentRun.done = true;
+        showAnswerError(message, agentRun.question);
+      }
+    };
+  }
+
+  function loadAgent(run) {
+    if (agentLoaded) return Promise.resolve();
+    if (agentLoading) return agentLoading;
+    ensureAgentWorker();
+    agentLoading = new Promise((resolve, reject) => {
+      agentPendingLoad = { resolve, reject };
+      answerProgress.textContent = `Loading ${agentModel.base}…`;
+      announce(`Loading the answer model, ${agentModel.base}`);
+      agentWorker.postMessage({ type: "load", model: agentModel.id });
+    }).finally(() => {
+      agentLoading = null;
+    });
+    return agentLoading;
+  }
+
+  const agentPending = new Map();
+  function agentCall(type, payload) {
+    return new Promise((resolve, reject) => {
+      agentPending.set(payload.requestId, { resolve, reject });
+      agentWorker.postMessage(Object.assign({ type }, payload));
+    });
+  }
+
+  function streamAnswer(run) {
+    return new Promise((resolve, reject) => {
+      run.resolveStream = resolve;
+      run.rejectStream = reject;
+      run.text = "";
+      run.lastPaint = 0;
+      answerText.textContent = "";
+      show(answerText);
+      const caret = el("span", "sa-caret");
+      caret.setAttribute("aria-hidden", "true");
+      run.caret = caret;
+      answerText.appendChild(caret);
+      agentWorker.postMessage({ type: "ask", requestId: run.requestId, question: run.question, site: siteName, evidence: run.evidence });
+    });
+  }
+
+  function paintStream(run, force) {
+    const now = performance.now();
+    if (!force && reducedMotion && now - run.lastPaint < 600) return;
+    run.lastPaint = now;
+    answerText.textContent = lib.visibleStreamText(run.text);
+    if (!run.done && run.caret) answerText.appendChild(run.caret);
+  }
+
+  function onAgentMessage(msg) {
+    if (msg.type !== "token" && msg.type !== "progress") {
+      console.debug("eddie agent event " + msg.type + " " + (msg.requestId == null ? "" : msg.requestId) + (msg.message ? " " + msg.message : ""));
+    }
+    switch (msg.type) {
+      case "progress":
+        if (agentRun && !agentRun.done) {
+          const pct = typeof msg.progress === "number" ? Math.round(msg.progress * 100) : null;
+          answerProgress.textContent = `Loading ${agentModel.base}…` + (pct != null ? ` ${pct}%` : "");
+          if (pct != null && pct % 25 === 0) announce(`Loading the answer model, ${pct}%`);
+        }
         break;
-      case "top-right":
-        trigger.style.top = vertical;
-        trigger.style.right = horizontal;
+      case "loaded":
+        agentLoaded = true;
+        if (agentPendingLoad) {
+          agentPendingLoad.resolve(msg);
+          agentPendingLoad = null;
+        }
         break;
-      case "bottom-left":
-        trigger.style.bottom = vertical;
-        trigger.style.left = horizontal;
+      case "plan_result":
+        resolveAgent(msg);
+        break;
+      case "token":
+        if (agentRun && msg.requestId === agentRun.requestId && !agentRun.done) {
+          agentRun.text += msg.text;
+          paintStream(agentRun, false);
+        }
+        break;
+      case "done":
+        if (agentRun && msg.requestId === agentRun.requestId) finishAnswer(agentRun, msg);
+        break;
+      case "aborted":
+        if (agentRun && msg.requestId === agentRun.requestId) {
+          agentRun.done = true;
+          if (agentRun.resolveStream) agentRun.resolveStream();
+        }
+        break;
+      case "error":
+        if (msg.requestId != null && agentPending.has(msg.requestId)) {
+          const p = agentPending.get(msg.requestId);
+          agentPending.delete(msg.requestId);
+          p.reject(new Error(msg.message || "agent request failed"));
+        } else if (agentPendingLoad) {
+          agentPendingLoad.reject(new Error(msg.message || "model load failed"));
+          agentPendingLoad = null;
+        } else if (agentRun && !agentRun.done && (msg.requestId == null || msg.requestId === agentRun.requestId)) {
+          agentRun.done = true;
+          if (agentRun.rejectStream) agentRun.rejectStream(new Error(msg.message || "answer failed"));
+        }
         break;
       default:
-        trigger.style.bottom = vertical;
-        trigger.style.right = horizontal;
         break;
     }
   }
 
+  function resolveAgent(msg) {
+    const p = agentPending.get(msg.requestId);
+    if (!p) return;
+    agentPending.delete(msg.requestId);
+    p.resolve(msg);
+  }
+
+  function finishAnswer(run, msg) {
+    run.done = true;
+    clearAnswerActions();
+    hide(answerProgress);
+    answerText.textContent = "";
+    if (msg.nohit) {
+      answerText.classList.add("sa-nohit");
+      answerText.textContent = msg.answer || lib.NOHIT;
+      hide(answerSources);
+    } else {
+      renderAnswerText(msg.answer, msg.citations);
+      answerSources.textContent = "";
+      (msg.citations || []).forEach((c) => {
+        const li = el("li");
+        li.appendChild(el("span", "sa-cite-n", `[${c.n}]`));
+        const a = el("a", "sa-cite", c.title || c.url);
+        a.href = c.url;
+        a.addEventListener("click", (e) => {
+          e.preventDefault();
+          navigateTo(c.url);
+        });
+        li.appendChild(a);
+        answerSources.appendChild(li);
+      });
+      if (msg.citations && msg.citations.length) show(answerSources);
+      else hide(answerSources);
+    }
+    show(answerText);
+    const usage = msg.usage || {};
+    run.usage = usage;
+    announce(msg.nohit ? "No answer: the site doesn't cover that." : "Answer ready. " + msg.answer);
+    if (run.resolveStream) run.resolveStream();
+    console.info("eddie agent " + JSON.stringify({
+      question: run.question,
+      model: agentModel ? agentModel.id : null,
+      evidence: run.evidence.length,
+      citations: (msg.citations || []).length,
+      nohit: !!msg.nohit,
+      ttftMs: usage.ttftMs,
+      totalMs: usage.totalMs,
+      tps: usage.tps,
+      sinceAskMs: Math.round(performance.now() - run.started),
+    }));
+  }
+
+  function renderAnswerText(text, citations) {
+    const byN = new Map((citations || []).map((c) => [c.n, c]));
+    const parts = String(text || "").split(/(\[\d+\])/g);
+    parts.forEach((part) => {
+      const m = /^\[(\d+)\]$/.exec(part);
+      const c = m ? byN.get(Number(m[1])) : null;
+      if (c) {
+        const a = el("a", "sa-answer-cite", part);
+        a.href = c.url;
+        a.setAttribute("aria-label", `Source ${c.n}: ${c.title || c.url}`);
+        a.addEventListener("click", (e) => {
+          e.preventDefault();
+          navigateTo(c.url);
+        });
+        answerText.appendChild(a);
+      } else if (part) {
+        answerText.appendChild(document.createTextNode(part));
+      }
+    });
+  }
+
+  function abortAgent(reason) {
+    const run = agentRun;
+    if (!run || run.done) return;
+    console.debug("eddie agent abort " + reason + " " + run.requestId);
+    run.aborted = true;
+    run.done = true;
+    if (agentWorker) agentWorker.postMessage({ type: "abort", requestId: run.requestId });
+    agentPending.forEach((p) => p.reject(new Error("aborted")));
+    agentPending.clear();
+    if (run.resolveStream) run.resolveStream();
+    if (reason === "stopped") {
+      paintStream(run, true);
+      clearAnswerActions();
+      answerProgress.textContent = "Stopped.";
+      show(answerProgress);
+    } else {
+      hide(answerCard);
+    }
+  }
+
+  async function expandShortEvidence(items) {
+    for (const item of items) {
+      if ((item.text || "").length >= 200 || !item.url) continue;
+      try {
+        const res = await callWorker("page", { url: item.url });
+        const chunks = (res.page && res.page.chunks) || [];
+        const i = chunks.findIndex((c) => c.id === item.chunk);
+        if (i < 0) continue;
+        const parts = [];
+        for (let j = Math.max(0, i - 1); j <= Math.min(chunks.length - 1, i + 1); j++) {
+          if (chunks[j].text) parts.push(chunks[j].text);
+        }
+        item.text = parts.join(" ");
+      } catch (_) {
+        // keep the snippet
+      }
+    }
+  }
+
   // -- Modal open/close --
   function openModal() {
     isOpen = true;
@@ -921,21 +2159,53 @@
     backdrop.classList.add("sa-open");
     trigger.style.display = "none";
     input.value = "";
+    liveRegion.textContent = "";
     clearResults();
+    hide(answerCard);
     ensureWorker();
-    // Focus after animation frame so the browser paints first
+    detectAgent();
     requestAnimationFrame(() => input.focus());
   }
 
   function closeModal() {
+    if (!isOpen) return;
     isOpen = false;
+    clearTimeout(searchTimer);
+    abortAgent("closed");
     backdrop.classList.remove("sa-open");
     trigger.style.display = "";
     trigger.focus();
   }
 
+  function applyTriggerOffsets() {
+    const baseInset = 24;
+    const vertical = `${baseInset + config.offsetY}px`;
+    const horizontal = `${baseInset + config.offsetX}px`;
+    trigger.style.top = "";
+    trigger.style.bottom = "";
+    trigger.style.left = "";
+    trigger.style.right = "";
+    switch (config.position) {
+      case "top-left":
+        trigger.style.top = vertical;
+        trigger.style.left = horizontal;
+        break;
+      case "top-right":
+        trigger.style.top = vertical;
+        trigger.style.right = horizontal;
+        break;
+      case "bottom-left":
+        trigger.style.bottom = vertical;
+        trigger.style.left = horizontal;
+        break;
+      default:
+        trigger.style.bottom = vertical;
+        trigger.style.right = horizontal;
+        break;
+    }
+  }
+
   function rotateHeartSprite() {
-    if (HEART_SPRITES.length === 0) return;
     let idx = Math.floor(Math.random() * HEART_SPRITES.length);
     if (HEART_SPRITES.length > 1 && idx === lastHeartIndex) {
       idx = (idx + 1) % HEART_SPRITES.length;
@@ -949,13 +2219,10 @@
     const ctx = heart.getContext("2d");
     if (!sprite || !ctx) return;
     ctx.clearRect(0, 0, heart.width, heart.height);
-
     for (let y = 0; y < sprite.length; y++) {
       const row = sprite[y];
       for (let x = 0; x < row.length; x++) {
-        const key = row[x];
-        if (key === ".") continue;
-        const color = HEART_PALETTE[key];
+        const color = HEART_PALETTE[row[x]];
         if (!color) continue;
         ctx.fillStyle = color;
         ctx.fillRect(x, y, 1, 1);
@@ -963,81 +2230,65 @@
     }
   }
 
-  // -- Helpers --
-  function showStatus(visible) {
-    status.classList.toggle("sa-visible", visible);
+  // -- Status helpers --
+  function show(node) {
+    node.classList.add("sa-visible");
   }
 
-  function showError(message) {
-    errorEl.textContent = message;
-    errorEl.classList.add("sa-visible");
+  function hide(node) {
+    node.classList.remove("sa-visible");
   }
 
-  function shouldUseAnswerMode(query) {
-    if (config.qaMode === "off") return false;
-    if (config.qaMode === "always") return true;
-    return looksFactualQuery(query);
+  function showStatus(visible) {
+    status.classList.toggle("sa-visible", visible);
   }
 
-  function looksFactualQuery(query) {
-    const q = query.toLowerCase().trim();
-    if (!q) return false;
-    if (q.includes("?")) return true;
-    if (/^(who|what|when|where|why|how|does|do|is|are|can|could|should)\b/i.test(q)) {
-      return true;
+  function setStatus(text, progress) {
+    statusText.textContent = text;
+    showStatus(true);
+    if (progress == null) {
+      progressBar.classList.add("sa-progress-indeterminate");
+      progressBar.removeAttribute("aria-valuenow");
+      progressBar.setAttribute("aria-busy", "true");
+      progressFill.style.width = "";
+    } else {
+      const pct = Math.max(0, Math.min(100, Math.round(progress * 100)));
+      progressBar.classList.remove("sa-progress-indeterminate");
+      progressBar.setAttribute("aria-valuenow", String(pct));
+      progressBar.removeAttribute("aria-busy");
+      progressFill.style.width = pct + "%";
     }
-    return q.split(/\s+/).length >= 5;
   }
 
-  function renderAnswer() {
-    answerEl.textContent = "";
-    if (!currentAnswer || !currentAnswer.text) {
-      answerEl.classList.remove("sa-visible");
-      return;
-    }
-
-    const label = document.createElement("div");
-    label.className = "sa-answer-label";
-    label.textContent = "Experimental Answer";
-    answerEl.appendChild(label);
-
-    const text = document.createElement("div");
-    text.className = "sa-answer-text";
-    text.textContent = currentAnswer.text;
-    answerEl.appendChild(text);
-
-    if (currentAnswer.citations && currentAnswer.citations.length > 0) {
-      const cites = document.createElement("div");
-      cites.className = "sa-answer-cites";
-      currentAnswer.citations.slice(0, 3).forEach((url) => {
-        const a = document.createElement("a");
-        a.className = "sa-answer-cite";
-        a.href = url;
-        a.textContent = "source";
-        a.addEventListener("click", (e) => {
-          e.preventDefault();
-          navigateToResult({ url: url });
-        });
-        cites.appendChild(a);
-      });
-      answerEl.appendChild(cites);
-    }
-
-    answerEl.classList.add("sa-visible");
+  let announceToggle = false;
+  function announce(text) {
+    announceToggle = !announceToggle;
+    liveRegion.textContent = text + (announceToggle ? "" : "​");
   }
 
   // -- Global keyboard shortcut: Ctrl+K or Cmd+K --
+  function isEditable(node) {
+    if (!node || node.nodeType !== 1) return false;
+    if (node.isContentEditable) return true;
+    const tag = node.tagName;
+    return tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT";
+  }
+
   document.addEventListener("keydown", (e) => {
-    if ((e.ctrlKey || e.metaKey) && e.key === "k") {
+    if (!(e.ctrlKey || e.metaKey) || e.altKey) return;
+    if (typeof e.key !== "string" || e.key.toLowerCase() !== "k") return;
+    if (isOpen) {
       e.preventDefault();
-      if (isOpen) {
-        closeModal();
-      } else {
-        openModal();
-      }
+      closeModal();
+      return;
     }
+    const target = e.composedPath ? e.composedPath()[0] : e.target;
+    if (isEditable(target)) return;
+    e.preventDefault();
+    openModal();
   });
 
   // -- Mount --
   document.body.appendChild(host);
 })();
+})();