@konneal/engine 0.2.167 → 0.2.168

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

@@ -1,9 +1,9 @@
 import {
   handleAsk
-} from "./chunk-YWXLXXGH.js";
+} from "./chunk-AGL4NGXY.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-YWXLXXGH.js → chunk-AGL4NGXY.js}

@@ -75,7 +75,7 @@ import {
   tokenBudget,
   understandQuery,
   usageTotal
-} from "./chunk-OD3KBF4I.js";
+} from "./chunk-LIZJLRXZ.js";
 import {
   embed,
   generateOnce

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/{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-AGL4NGXY.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-RUMLIO35.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.168",
   "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/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,
 ];