@konneal/engine 0.2.166 → 0.2.168

package/dist/ask-RUMLIO35.js

@@ -0,0 +1,16 @@
+import {
+  handleAsk
+} from "./chunk-AGL4NGXY.js";
+import "./chunk-ECOYO7EX.js";
+import "./chunk-PTY2OSC4.js";
+import "./chunk-LIZJLRXZ.js";
+import "./chunk-LU7VIMD7.js";
+import "./chunk-QY556RJM.js";
+import "./chunk-ETLSWSZ7.js";
+import "./chunk-Y7LWT24U.js";
+import "./chunk-4FZNJR5Q.js";
+import "./chunk-3FYJM7LH.js";
+import "./chunk-LSZTJI7V.js";
+export {
+  handleAsk
+};

package/dist/{chunk-FQYHT4VC.js → chunk-4FZNJR5Q.js}

@@ -92,7 +92,7 @@ var THRESHOLDS = {
   // when the in-code doc scope cuts the vector-level top-K to zero, the
   // re-query runs at this depth and scopes in code (the native filter is
   // dead — measured 2026-10-05)
-  denseStarveK: 1e3,
+  denseStarveK: 100,
   entailmentGate: true,
   entailmentBudgetMs: 6e3,
   entailmentSupportedFloor: 0.9,

package/dist/{chunk-2FME6R6J.js → chunk-AGL4NGXY.js}

@@ -32,7 +32,7 @@ import {
   tableRetyped,
   toolNote,
   verdictNote
-} from "./chunk-AP73VIHB.js";
+} from "./chunk-PTY2OSC4.js";
 import {
   NO_CONTEXT,
   STAGE_NAMES,
@@ -75,18 +75,18 @@ import {
   tokenBudget,
   understandQuery,
   usageTotal
-} from "./chunk-5AME76UW.js";
+} from "./chunk-LIZJLRXZ.js";
 import {
   embed,
   generateOnce
-} from "./chunk-5V2A3CAH.js";
+} from "./chunk-LU7VIMD7.js";
 import {
   corsHeaders,
   err,
   json,
   readJson,
   validateQuery
-} from "./chunk-TTEJQ5XA.js";
+} from "./chunk-QY556RJM.js";
 import {
   cacheableAnswer,
   canonicalRefusal,
@@ -99,7 +99,7 @@ import {
   requestSalt,
   resolveRequestScope,
   standardKeysFrom
-} from "./chunk-OLO45N6D.js";
+} from "./chunk-Y7LWT24U.js";
 import {
   LIMITS,
   MODELS,
@@ -110,7 +110,7 @@ import {
   requestEffort,
   roleModel,
   sha256Hex
-} from "./chunk-FQYHT4VC.js";
+} from "./chunk-4FZNJR5Q.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";

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

@@ -6,24 +6,24 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "./chunk-5AME76UW.js";
+} from "./chunk-LIZJLRXZ.js";
 import {
   corsHeaders,
   err,
   json,
   readJson,
   validateQuery
-} from "./chunk-TTEJQ5XA.js";
+} from "./chunk-QY556RJM.js";
 import {
   entitlementScope,
   standardKeysFrom
-} from "./chunk-OLO45N6D.js";
+} from "./chunk-Y7LWT24U.js";
 import {
   LIMITS,
   MODELS,
   num,
   sha256Hex
-} from "./chunk-FQYHT4VC.js";
+} from "./chunk-4FZNJR5Q.js";
 import {
   portModelRunner
 } from "./chunk-LSZTJI7V.js";

package/dist/{chunk-5AME76UW.js → chunk-LIZJLRXZ.js}

@@ -1,11 +1,11 @@
 import {
   embed,
   rerank
-} from "./chunk-5V2A3CAH.js";
+} from "./chunk-LU7VIMD7.js";
 import {
   bubbleConfirmPage,
   isAllowedBubbleOrigin
-} from "./chunk-TTEJQ5XA.js";
+} from "./chunk-QY556RJM.js";
 import {
   DATASETS,
   LIMITS,
@@ -15,7 +15,7 @@ import {
   processExpansion,
   sha256Hex,
   today
-} from "./chunk-FQYHT4VC.js";
+} from "./chunk-4FZNJR5Q.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";
@@ -22165,9 +22165,13 @@ var dense = {
       if (filters.edition) matches = matches.filter((m) => !m.metadata?.edition || String(m.metadata.edition) === filters.edition);
       console.log("dense scope (in code):", before, "\u2192", matches.length, "in doc", filters.doc_number, filters.edition ? `@${filters.edition}` : "");
       if (!matches.length) {
-        const wide = await env.VECTORIZE.query(vector, { ...q, topK: THRESHOLDS.denseStarveK });
-        matches = (wide.matches ?? []).filter((m) => matchesDocScope(m.metadata ?? {}, filters.doc_number));
-        console.log("dense scope starvation \u2192 deep re-query:", matches.length, "doc members in the top", THRESHOLDS.denseStarveK);
+        try {
+          const wide = await env.VECTORIZE.query(vector, { ...q, topK: THRESHOLDS.denseStarveK });
+          matches = (wide.matches ?? []).filter((m) => matchesDocScope(m.metadata ?? {}, filters.doc_number));
+          console.log("dense scope starvation \u2192 deep re-query:", matches.length, "doc members in the top", THRESHOLDS.denseStarveK);
+        } catch (e) {
+          console.log("dense scope starvation re-query failed:", String(e).slice(0, 120));
+        }
       }
       if (filters && filters.edition && matches.length < 3) {
         const docOnly = allMatches.filter((m) => matchesDocScope(m.metadata ?? {}, filters.doc_number));
@@ -22990,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",
@@ -23488,6 +23545,7 @@ var STAGES = [
   typedPin,
   sectionDescent,
   dedup,
+  figureSeat,
   vlmFigureRerank,
   windowFloor
 ];

package/dist/{chunk-5V2A3CAH.js → chunk-LU7VIMD7.js}

@@ -1,7 +1,7 @@
 import {
   answerEffort,
   effortBudget
-} from "./chunk-FQYHT4VC.js";
+} from "./chunk-4FZNJR5Q.js";
 
 // workers/worker_public/src/ai.ts
 var delay = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{chunk-AP73VIHB.js → chunk-PTY2OSC4.js}

@@ -1,12 +1,12 @@
 import {
   embed
-} from "./chunk-5V2A3CAH.js";
+} from "./chunk-LU7VIMD7.js";
 import {
   standardKeysFrom
-} from "./chunk-OLO45N6D.js";
+} from "./chunk-Y7LWT24U.js";
 import {
   THRESHOLDS
-} from "./chunk-FQYHT4VC.js";
+} from "./chunk-4FZNJR5Q.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";

package/dist/{chunk-TTEJQ5XA.js → chunk-QY556RJM.js}

@@ -1,7 +1,7 @@
 import {
   LIMITS,
   sha256Hex
-} from "./chunk-FQYHT4VC.js";
+} from "./chunk-4FZNJR5Q.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";

package/dist/{chunk-OLO45N6D.js → chunk-Y7LWT24U.js}

@@ -1,7 +1,7 @@
 import {
   DATASETS,
   datasetAllowed
-} from "./chunk-FQYHT4VC.js";
+} from "./chunk-4FZNJR5Q.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";

package/dist/config.d.ts

@@ -51,7 +51,7 @@ export declare const THRESHOLDS: {
      *  not only the source rung. Fails open (a slow or unparseable check
      *  leaves the source-rung note unchanged). */
     readonly compressShare: 0.6;
-    readonly denseStarveK: 1000;
+    readonly denseStarveK: 100;
     readonly entailmentGate: true;
     readonly entailmentBudgetMs: 6000;
     readonly entailmentSupportedFloor: 0.9;

package/dist/search-Y4Y46Y57.js

@@ -0,0 +1,14 @@
+import {
+  handleSearch
+} from "./chunk-BFOCWZ7U.js";
+import "./chunk-LIZJLRXZ.js";
+import "./chunk-LU7VIMD7.js";
+import "./chunk-QY556RJM.js";
+import "./chunk-ETLSWSZ7.js";
+import "./chunk-Y7LWT24U.js";
+import "./chunk-4FZNJR5Q.js";
+import "./chunk-3FYJM7LH.js";
+import "./chunk-LSZTJI7V.js";
+export {
+  handleSearch
+};

package/dist/{tools-PR7PFAV6.js → tools-3RP7DHGI.js}

@@ -4,10 +4,10 @@ import {
   parseToolCall,
   runTool,
   toolNote
-} from "./chunk-AP73VIHB.js";
-import "./chunk-5V2A3CAH.js";
-import "./chunk-OLO45N6D.js";
-import "./chunk-FQYHT4VC.js";
+} from "./chunk-PTY2OSC4.js";
+import "./chunk-LU7VIMD7.js";
+import "./chunk-Y7LWT24U.js";
+import "./chunk-4FZNJR5Q.js";
 import "./chunk-3FYJM7LH.js";
 import "./chunk-LSZTJI7V.js";
 export {

package/dist/worker_mcp/src/index.js

@@ -1,7 +1,7 @@
 import {
   authenticate
-} from "../../chunk-TTEJQ5XA.js";
-import "../../chunk-FQYHT4VC.js";
+} from "../../chunk-QY556RJM.js";
+import "../../chunk-4FZNJR5Q.js";
 import {
   P,
   setProfile

package/dist/worker_public/src/config.js

@@ -16,7 +16,7 @@ import {
   roleModel,
   sha256Hex,
   today
-} from "../../chunk-FQYHT4VC.js";
+} from "../../chunk-4FZNJR5Q.js";
 import "../../chunk-3FYJM7LH.js";
 export {
   DATASETS,

package/dist/worker_public/src/index.js

@@ -4,16 +4,16 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-2FME6R6J.js";
+} from "../../chunk-AGL4NGXY.js";
 import "../../chunk-ECOYO7EX.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
   modelGroundingBlock
-} from "../../chunk-AP73VIHB.js";
+} from "../../chunk-PTY2OSC4.js";
 import {
   handleSearch
-} from "../../chunk-SIT4XSD5.js";
+} from "../../chunk-BFOCWZ7U.js";
 import {
   buildMessages,
   citations,
@@ -38,11 +38,11 @@ import {
   sessionFrom,
   telemetry,
   understandQuery
-} from "../../chunk-5AME76UW.js";
+} from "../../chunk-LIZJLRXZ.js";
 import {
   embed,
   generateOnce
-} from "../../chunk-5V2A3CAH.js";
+} from "../../chunk-LU7VIMD7.js";
 import {
   authenticate,
   corsHeaders,
@@ -51,14 +51,14 @@ import {
   readJson,
   validateQuery,
   withCors
-} from "../../chunk-TTEJQ5XA.js";
+} from "../../chunk-QY556RJM.js";
 import {
   canonicalRefusal
 } from "../../chunk-ETLSWSZ7.js";
 import {
   entitlementScope,
   standardKeysFrom
-} from "../../chunk-OLO45N6D.js";
+} from "../../chunk-Y7LWT24U.js";
 import {
   LIMITS,
   MODELS,
@@ -69,7 +69,7 @@ import {
   roleModel,
   sha256Hex,
   today
-} from "../../chunk-FQYHT4VC.js";
+} from "../../chunk-4FZNJR5Q.js";
 import {
   P,
   setProfile
@@ -1119,13 +1119,13 @@ async function callToolOnce(env, ctx, _req, tier, key, name, args, t0) {
       // stream:false forces the JSON lane (anon defaults to SSE)
       body: JSON.stringify({ ...args, stream: false })
     });
-    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-PR7PFAV6.js");
+    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-3RP7DHGI.js");
     let payload;
     if (TOOLS_REGISTRY2.some((t) => t.name === name && t.audiences.includes("mcp"))) {
       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-XJOOMAXU.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-6KM4P2E5.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/dist/worker_public/src/requestScope.js

@@ -4,8 +4,8 @@ import {
   requestSalt,
   resolveRequestScope,
   standardKeysFrom
-} from "../../chunk-OLO45N6D.js";
-import "../../chunk-FQYHT4VC.js";
+} from "../../chunk-Y7LWT24U.js";
+import "../../chunk-4FZNJR5Q.js";
 import "../../chunk-3FYJM7LH.js";
 export {
   entitlementScope,

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.166",
+  "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/config.ts

@@ -89,7 +89,7 @@ export const THRESHOLDS = {
   // when the in-code doc scope cuts the vector-level top-K to zero, the
   // re-query runs at this depth and scopes in code (the native filter is
   // dead — measured 2026-10-05)
-  denseStarveK: 1000,
+  denseStarveK: 100,
   entailmentGate: true,
   entailmentBudgetMs: 6000,
   entailmentSupportedFloor: 0.9,

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

@@ -51,9 +51,16 @@ export const dense: Stage = {
       // reachable only through a wider net. Fires only when the scope
       // starves to zero — zero behavior when the scope matches.
       if (!matches.length) {
-        const wide: any = await env.VECTORIZE.query(vector, { ...q, topK: THRESHOLDS.denseStarveK });
-        matches = (wide.matches ?? []).filter((m: any) => matchesDocScope(m.metadata ?? {}, filters.doc_number!));
-        console.log("dense scope starvation → deep re-query:", matches.length, "doc members in the top", THRESHOLDS.denseStarveK);
+        try {
+          const wide: any = await env.VECTORIZE.query(vector, { ...q, topK: THRESHOLDS.denseStarveK });
+          matches = (wide.matches ?? []).filter((m: any) => matchesDocScope(m.metadata ?? {}, filters.doc_number!));
+          console.log("dense scope starvation → deep re-query:", matches.length, "doc members in the top", THRESHOLDS.denseStarveK);
+        } catch (e) {
+          // the deep net must never break the ask: a rejected re-query
+          // (topK above the platform cap, a transient index error)
+          // degrades to the pre-fallback state — other lanes' leftovers
+          console.log("dense scope starvation re-query failed:", String(e).slice(0, 120));
+        }
       }
       // an edition pin corroborated by (almost) nothing means the pin
       // was a guess — understanding emits editions for families it

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,
 ];

package/dist/ask-XJOOMAXU.js

@@ -1,16 +0,0 @@
-import {
-  handleAsk
-} from "./chunk-2FME6R6J.js";
-import "./chunk-ECOYO7EX.js";
-import "./chunk-AP73VIHB.js";
-import "./chunk-5AME76UW.js";
-import "./chunk-5V2A3CAH.js";
-import "./chunk-TTEJQ5XA.js";
-import "./chunk-ETLSWSZ7.js";
-import "./chunk-OLO45N6D.js";
-import "./chunk-FQYHT4VC.js";
-import "./chunk-3FYJM7LH.js";
-import "./chunk-LSZTJI7V.js";
-export {
-  handleAsk
-};

package/dist/search-6KM4P2E5.js

@@ -1,14 +0,0 @@
-import {
-  handleSearch
-} from "./chunk-SIT4XSD5.js";
-import "./chunk-5AME76UW.js";
-import "./chunk-5V2A3CAH.js";
-import "./chunk-TTEJQ5XA.js";
-import "./chunk-ETLSWSZ7.js";
-import "./chunk-OLO45N6D.js";
-import "./chunk-FQYHT4VC.js";
-import "./chunk-3FYJM7LH.js";
-import "./chunk-LSZTJI7V.js";
-export {
-  handleSearch
-};