@konneal/engine 0.2.82 → 0.2.84

package/dist/{ask-QLY2CODU.js → ask-GVU5PYC4.js}

@@ -1,12 +1,12 @@
 import {
   handleAsk
-} from "./chunk-DH3WDTZX.js";
+} from "./chunk-D24PQPDK.js";
 import "./chunk-7HWJOFTQ.js";
 import "./chunk-SPKPH54J.js";
 import "./chunk-A3QHHUN5.js";
 import "./chunk-LVZTWUVJ.js";
 import "./chunk-2PCUAJJO.js";
-import "./chunk-7AQM3GSO.js";
+import "./chunk-JZFXSTYX.js";
 import "./chunk-3FYJM7LH.js";
 export {
   handleAsk

package/dist/{certificates-YFL4K7O3.js → certificates-CO7KX2S2.js}

@@ -7,7 +7,7 @@ import {
   registerNote,
   registerTokens,
   searchRegister
-} from "./chunk-7AQM3GSO.js";
+} from "./chunk-JZFXSTYX.js";
 import "./chunk-3FYJM7LH.js";
 export {
   buildRegisterQuery,

package/dist/{chunk-DH3WDTZX.js → chunk-D24PQPDK.js}

@@ -72,7 +72,7 @@ import {
   certificateLinks,
   registerNote,
   searchRegister
-} from "./chunk-7AQM3GSO.js";
+} from "./chunk-JZFXSTYX.js";
 import {
   P
 } from "./chunk-3FYJM7LH.js";
@@ -1896,7 +1896,7 @@ async function runTool(db, call) {
   if (call.name !== "register_search") return null;
   const query = String(call.args?.query ?? "").trim().slice(0, 160);
   if (!query) return null;
-  const { searchRegister: searchRegister2, registerNote: registerNote2 } = await import("./certificates-YFL4K7O3.js");
+  const { searchRegister: searchRegister2, registerNote: registerNote2 } = await import("./certificates-CO7KX2S2.js");
   const reg = await searchRegister2(db, query, true);
   const output = reg?.rows?.length ? registerNote2(reg.rows) : `No certificate was found for "${query}" in the certificates database (the register snapshot). State this as the search's result, with the searched string visible.`;
   return { name: call.name, query, output };
@@ -2310,6 +2310,11 @@ async function handleAsk(env, ctx, req, tier, key) {
   if (await env.CACHE.get("sys:generation") === "off") {
     return err(503, "generation_disabled", "Generation is temporarily paused; search remains available.");
   }
+  const agentSteps = [];
+  const mark = (step) => {
+    agentSteps.push(step);
+    console.log(`agent-step: ${step}`);
+  };
   const service = env.INTERNAL_SERVICE;
   const fedAuth = {
     cookie: req.headers.get("cookie") ?? "",
@@ -2488,6 +2493,7 @@ async function handleAsk(env, ctx, req, tier, key) {
   let register = await searchRegister(env.DB, q.query);
   const bridgeImage = userImage ?? storedImage;
   if (bridgeImage && /certificate|certified|certification/i.test(q.query)) {
+    mark("Reading the nameplate photograph");
     const np = await extractNameplate(env.AI, MODELS.member, bridgeImage);
     if (np?.manufacturer) {
       const bridged = await searchRegister(env.DB, nameplateRegisterQuery(np, q.query), true);
@@ -2878,9 +2884,10 @@ Answer account questions from these records ONLY: name the record when you use i
   if (/certificate|certified|certification/i.test(q.query) && env.DB) {
     try {
       const imageTurn = typeof withImage === "string";
+      if (imageTurn) mark("Reading the photograph to identify the instrument");
       const probeMessages = [...messages.slice(0, -1), { role: "user", content: `${TOOL_DECLARATION}
 
-${imageTurn ? "A photograph of the instrument is attached after this message. Transcribe the maker, model and any printed certificate number you can read, then emit the TOOL line with those tokens as the query \u2014 never invented." : ""}
+${imageTurn ? "A photograph of the instrument is attached after this message. Transcribe the maker, model and any printed certificate number you can read FROM THE PHOTOGRAPH ITSELF, then emit the TOOL line with those tokens as the query \u2014 never invented, and never tokens taken from any register content elsewhere in the context (a register row's holder is not the plate's maker; observed live 2026-10-04)." : ""}
 
 ${q.query}`.replace("\n\n\n\n", "\n\n") }];
       if (imageTurn) probeMessages.push({ role: "user", content: [{ type: "image_url", image_url: { url: withImage } }] });
@@ -2892,6 +2899,7 @@ ${q.query}`.replace("\n\n\n\n", "\n\n") }];
       const probeText = typeof probe?.response === "string" ? probe.response : probe?.choices?.[0]?.message?.content ?? "";
       const call = parseToolCall(probeText);
       if (call) {
+        mark(`Searching the certificate register for \u201C${String(call.args?.query ?? "")}\u201D`);
         const result = await runTool(env.DB, call);
         if (result) {
           messages.push({ role: "system", content: toolNote(result) });
@@ -2926,6 +2934,12 @@ ${q.query}`.replace("\n\n\n\n", "\n\n") }];
           const send = (obj) => controller.enqueue(encoder.encode(`data: ${JSON.stringify(obj)}
 
 `));
+          for (const step of agentSteps) {
+            try {
+              send({ type: "agent", step });
+            } catch {
+            }
+          }
           for (const t of pendingTools) {
             try {
               send({ type: "tool", name: t.name, query: t.query });
@@ -3085,6 +3099,7 @@ ${q.query}`.replace("\n\n\n\n", "\n\n") }];
   completionBlocks.push(...await completeFigures(env.DB, answer, [...c2ns.blocks, ...completionBlocks], used));
   if (withImage && register?.rows?.length && answer.includes(refusalAnswer())) {
     console.log("blind-answer: the register note carried rows but the answer refused \u2014 regenerating once");
+    mark("Re-answering from the register results");
     const regen = await generateOnce(env, model, [
       ...messages.slice(0, -1),
       { role: "user", content: "The photograph was attached and the register note lists actual matching certificate rows. Present those rows \u2014 number, holder, model, status, and every document link \u2014 as the answer. Do not claim that nothing was provided." },

package/dist/{chunk-7AQM3GSO.js → chunk-JZFXSTYX.js}

@@ -139,8 +139,13 @@ function registerNote(rows) {
 }
 function certificateLinks(rows) {
   const links = rows.filter((r) => r.pdf_key).map((r) => `- ${r.num}: https://www.oimlsmart.org/cert-pdf/${r.pdf_key}`);
-  return links.length ? `The certificates' documents:
-${links.join("\n")}` : "";
+  const absent = rows.filter((r) => !r.pdf_key && r.num).slice(0, 6).map((r) => `- ${r.num}: no document on file in this snapshot`);
+  const parts = [];
+  if (links.length) parts.push(`Documents on file:
+${links.join("\n")}`);
+  if (absent.length) parts.push(`No document on file (do NOT construct a link for these):
+${absent.join("\n")}`);
+  return parts.join("\n");
 }
 
 export {

package/dist/worker_public/src/index.js

@@ -6,7 +6,7 @@ import {
   modelGroundingBlock,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-DH3WDTZX.js";
+} from "../../chunk-D24PQPDK.js";
 import {
   handleSearch
 } from "../../chunk-KO6DRI7C.js";
@@ -63,7 +63,7 @@ import {
   sha256Hex,
   today
 } from "../../chunk-2PCUAJJO.js";
-import "../../chunk-7AQM3GSO.js";
+import "../../chunk-JZFXSTYX.js";
 import {
   P,
   setProfile
@@ -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-QLY2CODU.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-LVUQLA3C.js")).handleSearch(env, ctx, inner, tier, key);
+    const res = name === "ask" ? await (await import("../../ask-GVU5PYC4.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-LVUQLA3C.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.82",
+  "version": "0.2.84",
   "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

@@ -364,6 +364,16 @@ async function handleAsk(
     return err(503, "generation_disabled", "Generation is temporarily paused; search remains available.");
   }
 
+  // the agent's rounds, visible to the user as they happen: each step the
+  // assistant takes before and during the answer streams as an event (the
+  // owner's 2026-10-04 direction — the user must see the system-to-model
+  // questioning sessions, not stare at a spinner)
+  const agentSteps: string[] = [];
+  const mark = (step: string) => {
+    agentSteps.push(step);
+    console.log(`agent-step: ${step}`);
+  };
+
   // Members get federated retrieval (OIML + ISO/IEC) merged into the same
   // pipeline via the service binding; rag-public never touches the
   // internal index itself, and generation/rerank stay in ONE pipeline.
@@ -666,6 +676,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
   // holder, and the photograph's own reading is authoritative over them.
   const bridgeImage = userImage ?? storedImage;
   if (bridgeImage && /certificate|certified|certification/i.test(q.query)) {
+    mark("Reading the nameplate photograph");
     const np = await extractNameplate((env as any).AI, MODELS.member, bridgeImage);
     if (np?.manufacturer) {
       const bridged = await searchRegister(env.DB, nameplateRegisterQuery(np, q.query), true);
@@ -1230,7 +1241,8 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
   if (/certificate|certified|certification/i.test(q.query) && env.DB) {
     try {
       const imageTurn = typeof withImage === "string";
-      const probeMessages: any[] = [...messages.slice(0, -1), { role: "user", content: `${TOOL_DECLARATION}\n\n${imageTurn ? "A photograph of the instrument is attached after this message. Transcribe the maker, model and any printed certificate number you can read, then emit the TOOL line with those tokens as the query — never invented." : ""}\n\n${q.query}`.replace("\n\n\n\n", "\n\n") }];
+      if (imageTurn) mark("Reading the photograph to identify the instrument");
+      const probeMessages: any[] = [...messages.slice(0, -1), { role: "user", content: `${TOOL_DECLARATION}\n\n${imageTurn ? "A photograph of the instrument is attached after this message. Transcribe the maker, model and any printed certificate number you can read FROM THE PHOTOGRAPH ITSELF, then emit the TOOL line with those tokens as the query — never invented, and never tokens taken from any register content elsewhere in the context (a register row's holder is not the plate's maker; observed live 2026-10-04)." : ""}\n\n${q.query}`.replace("\n\n\n\n", "\n\n") }];
       if (imageTurn) probeMessages.push({ role: "user", content: [{ type: "image_url", image_url: { url: withImage } }] });
       const probe = await (env as any).AI.run(model, {
         messages: probeMessages,
@@ -1240,6 +1252,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
       const probeText = typeof probe?.response === "string" ? probe.response : probe?.choices?.[0]?.message?.content ?? "";
       const call = parseToolCall(probeText);
       if (call) {
+        mark(`Searching the certificate register for “${String(call.args?.query ?? "")}”`);
         const result = await runTool(env.DB, call);
         if (result) {
           messages.push({ role: "system", content: toolNote(result) });
@@ -1292,8 +1305,12 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
       const sse = new ReadableStream({
         async start(controller) {
           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
+          // the agent trace arrives first: every questioning round the
+          // assistant ran — the photograph read, the register search, any
+          // re-answer — so the user watched what happened, not a spinner
+          for (const step of agentSteps) {
+            try { send({ type: "agent", step }); } catch { /* never block the answer */ }
+          }
           for (const t of pendingTools) {
             try { send({ type: "tool", name: t.name, query: t.query }); } catch { /* never block the answer */ }
           }
@@ -1522,6 +1539,7 @@ let convEntities: Array<{ entity: string; kind: string }> = [];
   // that exact signature; the retry carries a sterner ground instruction.
   if (withImage && register?.rows?.length && answer.includes(refusalAnswer())) {
     console.log("blind-answer: the register note carried rows but the answer refused — regenerating once");
+    mark("Re-answering from the register results");
     const regen = await generateOnce(env, model, [
       ...messages.slice(0, -1),
       { role: "user", content: "The photograph was attached and the register note lists actual matching certificate rows. Present those rows — number, holder, model, status, and every document link — as the answer. Do not claim that nothing was provided." },

package/workers/worker_public/src/certificates.ts

@@ -163,6 +163,13 @@ export function registerNote(rows: RegisterRow[]): string {
  *  the fact. */
 export function certificateLinks(rows: RegisterRow[]): string {
   const links = rows.filter((r) => r.pdf_key).map((r) => `- ${r.num}: https://www.oimlsmart.org/cert-pdf/${r.pdf_key}`);
-  return links.length ? `The certificates' documents:\n${links.join("\n")}` : "";
+  // absence is stated per row: an unmarked gap invited the model to
+  // generalize the URL pattern to a document-less row (a fabricated 404
+  // link, observed live 2026-10-04)
+  const absent = rows.filter((r) => !r.pdf_key && r.num).slice(0, 6).map((r) => `- ${r.num}: no document on file in this snapshot`);
+  const parts: string[] = [];
+  if (links.length) parts.push(`Documents on file:\n${links.join("\n")}`);
+  if (absent.length) parts.push(`No document on file (do NOT construct a link for these):\n${absent.join("\n")}`);
+  return parts.join("\n");
 }