@konneal/engine 0.2.167 → 0.2.169

package/dist/{ask-LV6WNGYK.js → ask-OZO3KHFV.js}

@@ -1,9 +1,9 @@
 import {
   handleAsk
-} from "./chunk-YWXLXXGH.js";
+} from "./chunk-NTZX65GT.js";
 import "./chunk-ECOYO7EX.js";
 import "./chunk-PTY2OSC4.js";
-import "./chunk-OD3KBF4I.js";
+import "./chunk-LIZJLRXZ.js";
 import "./chunk-LU7VIMD7.js";
 import "./chunk-QY556RJM.js";
 import "./chunk-ETLSWSZ7.js";

package/dist/{chunk-KD2AHOOQ.js → chunk-BFOCWZ7U.js}

@@ -6,7 +6,7 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "./chunk-OD3KBF4I.js";
+} from "./chunk-LIZJLRXZ.js";
 import {
   corsHeaders,
   err,

package/dist/{chunk-OD3KBF4I.js → chunk-LIZJLRXZ.js}

@@ -22994,6 +22994,59 @@ Which of these figures best answers the question? Reply with ONLY: {"pick": N} u
   }
 };
 
+// workers/worker_public/src/stages/figureSeat.ts
+var figureSeat = {
+  name: "figure-seat",
+  failure: "additive",
+  when: (c) => FIGURE_Q.test(c.query),
+  run: async (c) => {
+    try {
+      const counts = /* @__PURE__ */ new Map();
+      for (const h of c.finalHits.slice(0, 5)) {
+        const dn = String(h.metadata.doc_number ?? "");
+        if (dn) counts.set(dn, (counts.get(dn) ?? 0) + 1);
+      }
+      const docNumber = c.u?.doc_number ?? [...counts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0];
+      if (!docNumber) return;
+      const seated = new Set(
+        c.finalHits.filter((h) => h.metadata.block === "figure").map((h) => String(h.metadata.unit_id ?? h.id))
+      );
+      const rows = await portStore(c.env).prepare(
+        `SELECT id, doc_id, docidentifier, clause_anchor, clause_title, doc_number, edition, language, status, corpus, tier, text, unit_id
+           FROM chunks WHERE doc_number = ?1 AND block = 'figure' AND unit_id IS NOT NULL LIMIT 3`
+      ).bind(String(docNumber)).all();
+      const fresh = [];
+      for (const r of rows.results ?? []) {
+        if (seated.has(String(r.unit_id))) continue;
+        fresh.push({
+          id: String(r.id),
+          score: 0,
+          rerank_score: 0,
+          text: String(r.text ?? ""),
+          metadata: {
+            doc_id: String(r.doc_id ?? ""),
+            docidentifier: String(r.docidentifier ?? ""),
+            doc_number: String(r.doc_number ?? docNumber),
+            clause_anchor: r.clause_anchor ? String(r.clause_anchor) : void 0,
+            clause_title: r.clause_title ? String(r.clause_title) : void 0,
+            edition: r.edition ? String(r.edition) : void 0,
+            language: r.language ? String(r.language) : void 0,
+            status: r.status ? String(r.status) : void 0,
+            corpus: r.corpus ? String(r.corpus) : void 0,
+            tier: r.tier ? String(r.tier) : void 0,
+            block: "figure",
+            unit_id: String(r.unit_id)
+          }
+        });
+      }
+      if (!fresh.length) return;
+      c.finalHits = [...fresh, ...c.finalHits];
+      console.log("figure-seat: seated", fresh.length, "figure chunk(s) of doc", docNumber);
+    } catch {
+    }
+  }
+};
+
 // workers/worker_public/src/stages/termNudge.ts
 var termNudge = {
   name: "term-nudge",
@@ -23492,6 +23545,7 @@ var STAGES = [
   typedPin,
   sectionDescent,
   dedup,
+  figureSeat,
   vlmFigureRerank,
   windowFloor
 ];

package/dist/{chunk-YWXLXXGH.js → chunk-NTZX65GT.js}

@@ -75,7 +75,7 @@ import {
   tokenBudget,
   understandQuery,
   usageTotal
-} from "./chunk-OD3KBF4I.js";
+} from "./chunk-LIZJLRXZ.js";
 import {
   embed,
   generateOnce
@@ -2785,12 +2785,21 @@ Answer account questions from these records ONLY: name the record when you use i
         }
         const canonical0 = exciseMisplacedPin(canonicalRefusal(full.replace(/^TOOL [a-z_.]+.*$\n?/gm, "").replace(/^\n+/, ""), refusalScope(answerCites(full))), answerCites(full));
         const c2 = canonical0.includes(refusalAnswer()) ? { text: canonical0, blocks: [], dropped: [] } : await contractV2(env.DB, canonical0, usedHits);
+        let streamedCompletionBlocks = [];
+        if (!canonical0.includes(refusalAnswer())) {
+          try {
+            streamedCompletionBlocks = await completeTables(env.DB, canonical0, usedHits);
+            streamedCompletionBlocks.push(...await completeFigures(env.DB, canonical0, [...c2.blocks, ...streamedCompletionBlocks], usedHits, q2.query));
+            if (streamedCompletionBlocks.length) console.log("streamed completion:", streamedCompletionBlocks.length, "block(s) attached");
+          } catch {
+          }
+        }
         send({
           type: "done",
           model,
           query_hash: queryHash,
           follow_ups: refusalShaped(canonical0, refusalScope(answerCites(full))) ? [] : understanding?.follow_ups ?? [],
-          blocks: [...c2.blocks, ...verdictBlock ? [verdictBlock] : [], ...conditionBlock ? [conditionBlock] : [], ...aggregationBlock ? [aggregationBlock] : []],
+          blocks: [...c2.blocks, ...verdictBlock ? [verdictBlock] : [], ...conditionBlock ? [conditionBlock] : [], ...aggregationBlock ? [aggregationBlock] : [], ...streamedCompletionBlocks],
           context_applied: ctxApplied,
           read: readAs(),
           // the evidence view's ground truth: the exact passages this

package/dist/{search-ZQCAISQV.js → search-Y4Y46Y57.js}

@@ -1,7 +1,7 @@
 import {
   handleSearch
-} from "./chunk-KD2AHOOQ.js";
-import "./chunk-OD3KBF4I.js";
+} from "./chunk-BFOCWZ7U.js";
+import "./chunk-LIZJLRXZ.js";
 import "./chunk-LU7VIMD7.js";
 import "./chunk-QY556RJM.js";
 import "./chunk-ETLSWSZ7.js";

package/dist/worker_public/src/index.js

@@ -4,7 +4,7 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-YWXLXXGH.js";
+} from "../../chunk-NTZX65GT.js";
 import "../../chunk-ECOYO7EX.js";
 import {
   TOOLS_REGISTRY,
@@ -13,7 +13,7 @@ import {
 } from "../../chunk-PTY2OSC4.js";
 import {
   handleSearch
-} from "../../chunk-KD2AHOOQ.js";
+} from "../../chunk-BFOCWZ7U.js";
 import {
   buildMessages,
   citations,
@@ -38,7 +38,7 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "../../chunk-OD3KBF4I.js";
+} from "../../chunk-LIZJLRXZ.js";
 import {
   embed,
   generateOnce
@@ -1125,7 +1125,7 @@ async function callToolOnce(env, ctx, _req, tier, key, name, args, t0) {
       const r = await runTool({ ...env, DB: env.DB }, { name, args }, "mcp");
       payload = r ? { tool: r.name, query: r.query, result: r.output } : { error: { message: `tool ${name} returned nothing for the given arguments` } };
     } else {
-      const res = name === "ask" ? await (await import("../../ask-LV6WNGYK.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-ZQCAISQV.js")).handleSearch(env, ctx, inner, tier, key);
+      const res = name === "ask" ? await (await import("../../ask-OZO3KHFV.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-Y4Y46Y57.js")).handleSearch(env, ctx, inner, tier, key);
       payload = await res.json().catch(() => ({ error: { message: "tool transport failed", status: res.status } }));
     }
     telemetry(env, ctx, tier, `mcp:${name}`, null, !payload?.error, JSON.stringify(payload).length, await sha256Hex(`${name}:${JSON.stringify(args ?? {})}`), void 0, void 0, { durationMs: Date.now() - t0 });

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.167",
+  "version": "0.2.169",
   "description": "The Konneal engine: the publisher-agnostic build pipeline and API plane for standards intelligence (retrieval, answer contract, verdicts, evaluation).",
   "license": "BSD-3-Clause",
   "type": "module",

package/workers/worker_public/src/ask.ts

@@ -1702,7 +1702,19 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
           const c2 = canonical0.includes(refusalAnswer())
             ? { text: canonical0, blocks: [], dropped: [] as string[] }
             : await contractV2(env.DB, canonical0, usedHits);
-          send({ type: "done", model, query_hash: queryHash, follow_ups: refusalShaped(canonical0, refusalScope(answerCites(full))) ? [] : (understanding?.follow_ups ?? []), blocks: [...c2.blocks, ...(verdictBlock ? [verdictBlock] : []), ...(conditionBlock ? [conditionBlock] : []), ...(aggregationBlock ? [aggregationBlock] : [])], context_applied: ctxApplied, read: readAs(),
+          // the completions ride the streamed lane too (parity: the UI's
+          // bubble IS this lane — the table/figure blocks never reached it
+          // before): additive D1 reads after the tokens are out, refusal
+          // answers carry nothing to complete
+          let streamedCompletionBlocks: Awaited<ReturnType<typeof completeTables>> = [];
+          if (!canonical0.includes(refusalAnswer())) {
+            try {
+              streamedCompletionBlocks = await completeTables(env.DB, canonical0, usedHits);
+              streamedCompletionBlocks.push(...(await completeFigures(env.DB, canonical0, [...c2.blocks, ...streamedCompletionBlocks], usedHits, q.query)));
+              if (streamedCompletionBlocks.length) console.log("streamed completion:", streamedCompletionBlocks.length, "block(s) attached");
+            } catch { /* additive — the answer stands without the blocks */ }
+          }
+          send({ type: "done", model, query_hash: queryHash, follow_ups: refusalShaped(canonical0, refusalScope(answerCites(full))) ? [] : (understanding?.follow_ups ?? []), blocks: [...c2.blocks, ...(verdictBlock ? [verdictBlock] : []), ...(conditionBlock ? [conditionBlock] : []), ...(aggregationBlock ? [aggregationBlock] : []), ...streamedCompletionBlocks], context_applied: ctxApplied, read: readAs(),
             // the evidence view's ground truth: the exact passages this
             // answer was built from, compact — cache hits carry none,
             // because the cache stores the answer and never the passages

package/workers/worker_public/src/stages/figureSeat.ts

@@ -0,0 +1,69 @@
+// The figure seat (TODO.sota/18.3's completion — the guaranteed place):
+// a figure-SEEKING question deterministically seats the asked document's
+// own figure chunks in the window. No embedding contest, no variance —
+// the question names a figure; the document's figures get their places;
+// the VLM rerank then orders them by image and the seeking completion
+// attaches the block from the producer's payload. The D1 read is one
+// bounded query (doc_number + block, LIMIT 3), additive, ablatable like
+// any stage. Positioned BEFORE the VLM rerank so the rerank sees the
+// seated figures and can order them by image.
+import { FIGURE_Q } from "./vlmFigureRerank.ts";
+import { portStore } from "../env.ts";
+import type { Stage } from "./types.ts";
+import type { Hit } from "../../../shared/chunk";
+
+export const figureSeat: Stage = {
+  name: "figure-seat",
+  failure: "additive",
+  when: (c) => FIGURE_Q.test(c.query),
+  run: async (c) => {
+    try {
+      const counts = new Map<string, number>();
+      for (const h of c.finalHits.slice(0, 5)) {
+        const dn = String((h.metadata as any).doc_number ?? "");
+        if (dn) counts.set(dn, (counts.get(dn) ?? 0) + 1);
+      }
+      const docNumber = (c.u as any)?.doc_number ?? [...counts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0];
+      if (!docNumber) return;
+      const seated = new Set(
+        c.finalHits.filter((h: Hit) => (h.metadata as any).block === "figure").map((h: Hit) => String((h.metadata as any).unit_id ?? h.id)),
+      );
+      const rows = await portStore(c.env)
+        .prepare(
+          `SELECT id, doc_id, docidentifier, clause_anchor, clause_title, doc_number, edition, language, status, corpus, tier, text, unit_id
+           FROM chunks WHERE doc_number = ?1 AND block = 'figure' AND unit_id IS NOT NULL LIMIT 3`,
+        )
+        .bind(String(docNumber))
+        .all();
+      const fresh: Hit[] = [];
+      for (const r of (rows.results ?? []) as any[]) {
+        if (seated.has(String(r.unit_id))) continue;
+        fresh.push({
+          id: String(r.id),
+          score: 0,
+          rerank_score: 0,
+          text: String(r.text ?? ""),
+          metadata: {
+            doc_id: String(r.doc_id ?? ""),
+            docidentifier: String(r.docidentifier ?? ""),
+            doc_number: String(r.doc_number ?? docNumber),
+            clause_anchor: r.clause_anchor ? String(r.clause_anchor) : undefined,
+            clause_title: r.clause_title ? String(r.clause_title) : undefined,
+            edition: r.edition ? String(r.edition) : undefined,
+            language: r.language ? String(r.language) : undefined,
+            status: r.status ? String(r.status) : undefined,
+            corpus: r.corpus ? String(r.corpus) : undefined,
+            tier: r.tier ? String(r.tier) : undefined,
+            block: "figure",
+            unit_id: String(r.unit_id),
+          } as any,
+        });
+      }
+      if (!fresh.length) return;
+      c.finalHits = [...fresh, ...c.finalHits];
+      console.log("figure-seat: seated", fresh.length, "figure chunk(s) of doc", docNumber);
+    } catch {
+      // additive — the text ranking stands
+    }
+  },
+};

package/workers/worker_public/src/stages/index.ts

@@ -34,6 +34,7 @@ import { overviewDemote } from "./overviewDemote.ts";
 import { familyBoost } from "./familyBoost.ts";
 import { rerankStage, lexicalRrf } from "./rerank.ts";
 import { vlmFigureRerank } from "./vlmFigureRerank.ts";
+import { figureSeat } from "./figureSeat.ts";
 import { termNudge } from "./termNudge.ts";
 import { conceptSteer } from "./conceptSteer.ts";
 import { editionSteer } from "./editionSteer.ts";
@@ -76,6 +77,7 @@ export const STAGES: Stage[] = [
   typedPin,
   sectionDescent,
   dedup,
+  figureSeat,
   vlmFigureRerank,
   windowFloor,
 ];