@konneal/engine 0.2.67 → 0.2.69

package/dist/{ask-O2ZWIV2Y.js → ask-UC5IVQDH.js}

@@ -1,6 +1,6 @@
 import {
   handleAsk
-} from "./chunk-67VVH7CX.js";
+} from "./chunk-PENTOBUO.js";
 import "./chunk-TPV5GPY2.js";
 import "./chunk-SPKPH54J.js";
 import "./chunk-A3QHHUN5.js";

package/dist/{chunk-67VVH7CX.js → chunk-PENTOBUO.js}

@@ -1902,6 +1902,26 @@ function toolNote(r) {
 ${r.output}`;
 }
 
+// workers/worker_public/src/operations.ts
+function isOperationIntent(query) {
+  return /\b(operations?|endpoints?)\b/i.test(query);
+}
+function catalogNote(anchors) {
+  if (!anchors.length) return "";
+  return `The platform's indexed operations (the COMPLETE surface \u2014 every operation the system exposes; the answer must name the operation from this list when one matches the question):
+${anchors.map((a) => `- ${a}`).join("\n")}`;
+}
+async function operationsCatalogNote(db, query) {
+  if (!isOperationIntent(query)) return void 0;
+  try {
+    const rows = (await db.prepare("SELECT clause_anchor FROM chunks WHERE corpus = 'smart-ops' AND clause_anchor IS NOT NULL ORDER BY clause_anchor").all()).results ?? [];
+    const note = catalogNote(rows.map((r) => r.clause_anchor).filter(Boolean));
+    return note || void 0;
+  } catch {
+    return void 0;
+  }
+}
+
 // workers/worker_public/prompts/nameplate.md
 var nameplate_default = `You read instrument nameplates. From the photograph, extract the
 manufacturer's name exactly as printed and the model designation exactly
@@ -2319,6 +2339,7 @@ async function handleAsk(env, ctx, req, tier, key) {
   }
   console.log("register-search:", JSON.stringify({ shaped: !!register, tokens: register?.tokens ?? null, rows: register?.rows?.length ?? null, first: register?.rows?.[0]?.num ?? null }));
   const regNote = register ? [registerNote(register.rows), certificateLinks(register.rows)].filter(Boolean).join("\n") : void 0;
+  const opsCatalog = await operationsCatalogNote(env.DB, q.query);
   if (understanding?.intent === "conversational") {
     const queryHash2 = await sha256Hex(q.query);
     const messages2 = [
@@ -2665,11 +2686,12 @@ Answer account questions from these records ONLY: name the record when you use i
     q.lang,
     keptHistory,
     // stage-extracted graph facts (GraphRAG) ride the same note channel
-    [processNote, eNote, regNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...retrieved.notes ?? []].filter(Boolean).join("\n") || void 0,
+    [processNote, eNote, regNote, opsCatalog, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...retrieved.notes ?? []].filter(Boolean).join("\n") || void 0,
     summary,
     budget
   );
   await attachFigureImages(env, messages, usedHits, q.query);
+  const pendingTools = [];
   if (/certificate|certified|certification/i.test(q.query) && env.DB) {
     try {
       const probe = await env.AI.run(model, {
@@ -2685,6 +2707,7 @@ ${q.query}` }],
         const result = await runTool(env.DB, call);
         if (result) {
           messages.push({ role: "system", content: toolNote(result) });
+          pendingTools.push(result);
           console.log("agent-tool:", result.name, JSON.stringify(result.query), "->", result.output.slice(0, 80));
         }
       }
@@ -2718,6 +2741,12 @@ ${q.query}` }],
           const send = (obj) => controller.enqueue(encoder.encode(`data: ${JSON.stringify(obj)}
 
 `));
+          for (const t of pendingTools) {
+            try {
+              send({ type: "tool", name: t.name, query: t.query });
+            } catch {
+            }
+          }
           send({ type: "read", read: readAs() });
           const sourceQuality = answerQuality(cites.map((c) => c.quality));
           send({ type: "citations", citations: cites, context_applied: ctxApplied, ...sourceQuality ? { source_quality: sourceQuality, confidence_note: qualityNote(sourceQuality), ...sourceQuality === "ocr" ? { experimental_sources: experimentalSourceLabels(cites) } : {} } : {}, ...liveRecords ? { records: liveRecords } : {}, quota });

package/dist/operations.d.ts

@@ -0,0 +1,3 @@
+export declare function isOperationIntent(query: string): boolean;
+export declare function catalogNote(anchors: string[]): string;
+export declare function operationsCatalogNote(db: any, query: string): Promise<string | undefined>;

package/dist/worker_public/src/index.js

@@ -6,7 +6,7 @@ import {
   modelGroundingBlock,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-67VVH7CX.js";
+} from "../../chunk-PENTOBUO.js";
 import {
   handleSearch
 } from "../../chunk-FLNX4O7C.js";
@@ -959,7 +959,7 @@ async function handleMcp(env, ctx, req, tier, key) {
       // stream:false forces the JSON lane (anon defaults to SSE)
       body: JSON.stringify({ ...args, stream: false })
     });
-    const res = name === "ask" ? await (await import("../../ask-O2ZWIV2Y.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-PBOODCMQ.js")).handleSearch(env, ctx, inner, tier, key);
+    const res = name === "ask" ? await (await import("../../ask-UC5IVQDH.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-PBOODCMQ.js")).handleSearch(env, ctx, inner, tier, key);
     return res.json().catch(() => ({ error: { message: "tool transport failed", status: res.status } }));
   });
   if (out.ok && "accepted" in out) return new Response(null, { status: 202 });

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.67",
+  "version": "0.2.69",
   "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

@@ -41,6 +41,7 @@ import { clientIp, checkQuota, telemetry } from "./quota";
 import { graphExpand, editionNote } from "./graph";
 import { registerNote, searchRegister, certificateLinks } from "./certificates";
 import { TOOL_DECLARATION, parseToolCall, runTool, toolNote } from "./tools";
+import { operationsCatalogNote } from "./operations.ts";
 import { extractNameplate, nameplateRegisterQuery } from "./nameplate.ts";
 import { P } from "./profile.ts";
 
@@ -641,6 +642,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
   }
   console.log("register-search:", JSON.stringify({ shaped: !!register, tokens: register?.tokens ?? null, rows: register?.rows?.length ?? null, first: register?.rows?.[0]?.num ?? null }));
   const regNote = register ? [registerNote(register.rows), certificateLinks(register.rows)].filter(Boolean).join("\n") : undefined;
+  const opsCatalog = await operationsCatalogNote(env.DB, q.query);
 
   // Conversational route, decided by query UNDERSTANDING (any language, any
   // phrasing) — not string matching. No retrieval: nothing in the corpus
@@ -1146,7 +1148,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
     q.lang,
     keptHistory,
     // stage-extracted graph facts (GraphRAG) ride the same note channel
-    [processNote, eNote, regNote, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...(retrieved.notes ?? [])].filter(Boolean).join("\n") || undefined,
+    [processNote, eNote, regNote, opsCatalog, contextNote(declaredCtx, docScope), accountNote, modelNote, vocabNote, memNote, machineNote, conditionNote, aggregationNote, boundaryNote, licenseNote, ...(retrieved.notes ?? [])].filter(Boolean).join("\n") || undefined,
     summary,
     budget,
   );
@@ -1155,7 +1157,10 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
   // round, armed only where a tool can help. The model may call
   // register_search through the strict line protocol; the worker
   // executes it deterministically and the ATTRIBUTED result joins the
-  // messages — what the tool returned, for the string it asked.
+  // messages — what the tool returned, for the string it asked. The
+  // invocations record into pendingTools; the stream emits them as its
+  // first events (the UI shows what the agent consulted).
+  const pendingTools: { name: string; query: string; output: string }[] = [];
   if (/certificate|certified|certification/i.test(q.query) && env.DB) {
     try {
       const probe = await (env as any).AI.run(model, {
@@ -1169,6 +1174,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
         const result = await runTool(env.DB, call);
         if (result) {
           messages.push({ role: "system", content: toolNote(result) });
+          pendingTools.push(result);
           console.log("agent-tool:", result.name, JSON.stringify(result.query), "->", result.output.slice(0, 80));
         }
       }
@@ -1215,6 +1221,9 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
           const send = (obj: unknown) => controller.enqueue(encoder.encode(`data: ${JSON.stringify(obj)}\n\n`));
           // the reading arrives first: the interpretation that steered
           // retrieval, before a single token of the answer
+          for (const t of pendingTools) {
+            try { send({ type: "tool", name: t.name, query: t.query }); } catch { /* never block the answer */ }
+          }
           send({ type: "read", read: readAs() });
           const sourceQuality = answerQuality(cites.map((c: any) => c.quality));
           send({ type: "citations", citations: cites, context_applied: ctxApplied, ...(sourceQuality ? { source_quality: sourceQuality, confidence_note: qualityNote(sourceQuality), ...(sourceQuality === "ocr" ? { experimental_sources: experimentalSourceLabels(cites) } : {}) } : {}), ...(liveRecords ? { records: liveRecords } : {}), quota, });

package/workers/worker_public/src/operations.ts

@@ -0,0 +1,27 @@
+// The operations catalog lane (TODO.new-era/6's platform surface): the
+// smart-ops corpus is SMALL (169 operations) and name-addressable. When
+// a question is operation-intent, the ENTIRE operation-name index rides
+// the notes channel — the model matches "updates an entity record" to
+// putEntityRecord semantically from the complete surface, instead of
+// gambling on which sibling passage retrieval happens to surface.
+// Pure composition lives here; the D1 call is a thin wrapper.
+
+export function isOperationIntent(query: string): boolean {
+  return /\b(operations?|endpoints?)\b/i.test(query);
+}
+
+export function catalogNote(anchors: string[]): string {
+  if (!anchors.length) return "";
+  return `The platform's indexed operations (the COMPLETE surface — every operation the system exposes; the answer must name the operation from this list when one matches the question):\n${anchors.map((a) => `- ${a}`).join("\n")}`;
+}
+
+export async function operationsCatalogNote(db: any, query: string): Promise<string | undefined> {
+  if (!isOperationIntent(query)) return undefined;
+  try {
+    const rows = (await db.prepare("SELECT clause_anchor FROM chunks WHERE corpus = 'smart-ops' AND clause_anchor IS NOT NULL ORDER BY clause_anchor").all()).results ?? [];
+    const note = catalogNote((rows as any[]).map((r) => r.clause_anchor).filter(Boolean));
+    return note || undefined;
+  } catch {
+    return undefined; // the lane is optional
+  }
+}