@konneal/engine 0.2.54 → 0.2.56

package/dist/{ask-3TAC56RC.js → ask-5XMD22SJ.js}

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

package/dist/{chunk-OPJXHEZU.js → chunk-ZVMQHCNL.js}

@@ -1866,7 +1866,7 @@ function exactCacheKey(indexVersion, gen, ns, queryHash) {
 
 // workers/worker_public/src/certificates.ts
 function isRegisterShaped(query) {
-  return /\bcertif(ied|icates?|ication)s?\b/i.test(query) && /\b(is|are|still|currently|valid|status|suspended|revoked|was|were)\b/i.test(query);
+  return /\bcertif(ied|icates?|ication)s?\b/i.test(query) && /\b(is|are|still|currently|valid|status|suspended|revoked|was|were|have|has|hold|holds|possess|carry|got)\b/i.test(query);
 }
 function queryFamily(query) {
   const m = /\b([RDMB])\s?-?(\d{2,3})\b/i.exec(query);
@@ -1979,6 +1979,53 @@ function registerNote(rows) {
   ].join("\n");
 }
 
+// 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
+as printed. Answer with ONLY a JSON object on one line:
+
+{"manufacturer": "\u2026", "model": "\u2026"}
+
+If the photograph shows no manufacturer or no model, use null for the
+missing value. Never guess beyond what is printed.
+`;
+
+// workers/worker_public/src/nameplate-parse.ts
+function parseNameplate(text) {
+  const m = /\{[^{}]*\}/.exec(String(text ?? ""));
+  if (!m) return null;
+  try {
+    const j = JSON.parse(m[0]);
+    const clean = (v) => typeof v === "string" && v.trim() ? v.trim().slice(0, 80) : null;
+    const out = { manufacturer: clean(j.manufacturer), model: clean(j.model) };
+    return out.manufacturer || out.model ? out : null;
+  } catch {
+    return null;
+  }
+}
+function nameplateRegisterQuery(np, question) {
+  const fam = /\b([RDMB])\s?-?(\d{2,3})\b/i.exec(question);
+  return [np.manufacturer, np.model, fam ? `${fam[1]} ${fam[2]}` : null].filter(Boolean).join(" ");
+}
+
+// workers/worker_public/src/nameplate.ts
+async function extractNameplate(ai, model, image) {
+  try {
+    const res = await ai.run(model, {
+      messages: [
+        { role: "system", content: nameplate_default.trimEnd() },
+        { role: "user", content: [{ type: "image_url", image_url: { url: image } }] }
+      ],
+      max_tokens: 512,
+      reasoning_effort: "low"
+    });
+    const text = typeof res?.response === "string" ? res.response : res?.choices?.[0]?.message?.content;
+    return parseNameplate(text ?? "");
+  } catch {
+    return null;
+  }
+}
+
 // workers/worker_public/src/ask.ts
 function userImageDataUrl(body) {
   const img = body?.image;
@@ -2222,20 +2269,22 @@ async function handleAsk(env, ctx, req, tier, key) {
   const warmQuery = retrievalQuery(q.query, prev);
   const warmEmbed = embedWarm(env, warmQuery);
   const conversationId = typeof body?.conversation_id === "string" && /^[A-Za-z0-9_-]{8,64}$/.test(body.conversation_id) ? body.conversation_id : null;
-  if (!effectiveImage && !attachIds.length && conversationId && env.DB && member) {
-    const prior = await env.DB.prepare(
-      "SELECT m.attachment_id AS aid, a.mime, a.r2_key FROM messages m JOIN attachments a ON a.id = m.attachment_id WHERE m.conversation_id = ?1 AND m.role = 'user' AND m.attachment_id IS NOT NULL ORDER BY m.created_at DESC LIMIT 1"
-    ).bind(conversationId, member.sub).first();
-    if (prior) {
-      try {
+  try {
+    if (!effectiveImage && !attachIds.length && conversationId && env.DB && member) {
+      const prior = await env.DB.prepare(
+        "SELECT m.attachment_id AS aid, a.mime, a.r2_key FROM messages m JOIN attachments a ON a.id = m.attachment_id JOIN conversations c ON c.id = m.conversation_id AND c.sub = ?2 WHERE m.conversation_id = ?1 AND m.role = 'user' AND m.attachment_id IS NOT NULL ORDER BY m.created_at DESC LIMIT 1"
+      ).bind(conversationId, member.sub).first();
+      if (prior) {
         const obj = await env.CHAT_UPLOADS.get(prior.r2_key);
         if (obj) {
-          const b64 = btoa(String.fromCharCode(...new Uint8Array(await obj.arrayBuffer())));
-          storedImage = `data:${prior.mime};base64,${b64}`;
+          const bytes = new Uint8Array(await obj.arrayBuffer());
+          let bin = "";
+          for (let i = 0; i < bytes.length; i += 32768) bin += String.fromCharCode(...bytes.subarray(i, i + 32768));
+          storedImage = `data:${prior.mime};base64,${btoa(bin)}`;
         }
-      } catch {
       }
     }
+  } catch {
   }
   let convEntities = [];
   if (conversationId) {
@@ -2330,7 +2379,17 @@ async function handleAsk(env, ctx, req, tier, key) {
   console.log("understand:", understanding?.intent ?? "null", understanding?.doc_number ? `doc#${understanding.doc_number}${understanding.edition ? "@" + understanding.edition : ""}` : "nodoc", "|", q.query.slice(0, 50));
   const graphDocNumbers = await graphExpand(env, understanding);
   const eNote = await editionNote(env, understanding);
-  const register = await searchRegister(env.DB, q.query);
+  let register = await searchRegister(env.DB, q.query);
+  if (withImage && !register?.rows?.length && /certificate|certified|certification/i.test(q.query)) {
+    const np = await extractNameplate(env.AI, MODELS.member, withImage);
+    if (np?.manufacturer) {
+      const bridged = await searchRegister(env.DB, nameplateRegisterQuery(np, q.query));
+      if (bridged?.rows?.length) {
+        register = bridged;
+        console.log("nameplate-bridge:", np.manufacturer, np.model ?? "", "\u2192", bridged.rows.length, "register rows");
+      }
+    }
+  }
   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) : void 0;
   if (understanding?.intent === "conversational") {

package/dist/nameplate-parse.d.ts

@@ -0,0 +1,8 @@
+export interface Nameplate {
+    manufacturer: string | null;
+    model: string | null;
+}
+export declare function parseNameplate(text: string): Nameplate | null;
+/** The register query the extraction feeds: the nameplate's tokens lead,
+ *  the question's family (if named) scopes. */
+export declare function nameplateRegisterQuery(np: Nameplate, question: string): string;

package/dist/nameplate.d.ts

@@ -0,0 +1,5 @@
+import { nameplateRegisterQuery, type Nameplate } from "./nameplate-parse.ts";
+export type { Nameplate };
+export { nameplateRegisterQuery };
+export declare function extractNameplate(ai: any, model: string, image: string): Promise<Nameplate | null>;
+export declare const nameplateModel: () => "@cf/zai-org/glm-5.3-flash";

package/dist/prompts/nameplate.md

@@ -0,0 +1,8 @@
+You read instrument nameplates. From the photograph, extract the
+manufacturer's name exactly as printed and the model designation exactly
+as printed. Answer with ONLY a JSON object on one line:
+
+{"manufacturer": "…", "model": "…"}
+
+If the photograph shows no manufacturer or no model, use null for the
+missing value. Never guess beyond what is printed.

package/dist/worker_public/src/index.js

@@ -9,7 +9,7 @@ import {
   modelGroundingBlock,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-OPJXHEZU.js";
+} from "../../chunk-ZVMQHCNL.js";
 import {
   buildMessages,
   cfBlobs,
@@ -958,7 +958,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-3TAC56RC.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-5XMD22SJ.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.54",
+  "version": "0.2.56",
   "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/prompts/nameplate.md

@@ -0,0 +1,8 @@
+You read instrument nameplates. From the photograph, extract the
+manufacturer's name exactly as printed and the model designation exactly
+as printed. Answer with ONLY a JSON object on one line:
+
+{"manufacturer": "…", "model": "…"}
+
+If the photograph shows no manufacturer or no model, use null for the
+missing value. Never guess beyond what is printed.

package/workers/worker_public/src/ask.ts

@@ -40,6 +40,7 @@ import { json, err, corsHeaders, readJson, validateQuery, type ApiKey } from "./
 import { clientIp, checkQuota, telemetry } from "./quota";
 import { graphExpand, editionNote } from "./graph";
 import { registerNote, searchRegister } from "./certificates";
+import { extractNameplate, nameplateRegisterQuery } from "./nameplate.ts";
 import { P } from "./profile.ts";
 
 /** User-uploaded image for multimodal questions: a data URL
@@ -452,24 +453,30 @@ async function handleAsk(
   const conversationId = typeof body?.conversation_id === "string" && /^[A-Za-z0-9_-]{8,64}$/.test(body.conversation_id) ? body.conversation_id : null;
 
   // Tier-2 continuation: no new image, but the conversation carries one —
-  // its most recent stored image re-attaches to this question
-  if (!effectiveImage && !attachIds.length && conversationId && env.DB && member) {
-    const prior = await env.DB.prepare(
-      "SELECT m.attachment_id AS aid, a.mime, a.r2_key FROM messages m JOIN attachments a ON a.id = m.attachment_id WHERE m.conversation_id = ?1 AND m.role = 'user' AND m.attachment_id IS NOT NULL ORDER BY m.created_at DESC LIMIT 1",
-    ).bind(conversationId, member.sub).first<{ aid: string; mime: string; r2_key: string }>();
-    if (prior) {
-      try {
-        const obj = await (env as any).CHAT_UPLOADS.get(prior.r2_key);
-        if (obj) {
-          const b64 = btoa(String.fromCharCode(...new Uint8Array(await obj.arrayBuffer())));
-          storedImage = `data:${prior.mime};base64,${b64}`;
-        }
-      } catch {
-        /* the object's gone */
+  // its most recent stored image re-attaches to this question. The query
+  // scopes by the CONVERSATION'S OWNER (the messages table carries no
+  // sub; ownership rides the conversation row) and the whole resolution
+  // fails open: an optional feature never takes the ask down.
+  try {
+    if (!effectiveImage && !attachIds.length && conversationId && env.DB && member) {
+      const prior = await env.DB.prepare(
+        "SELECT m.attachment_id AS aid, a.mime, a.r2_key FROM messages m JOIN attachments a ON a.id = m.attachment_id JOIN conversations c ON c.id = m.conversation_id AND c.sub = ?2 WHERE m.conversation_id = ?1 AND m.role = 'user' AND m.attachment_id IS NOT NULL ORDER BY m.created_at DESC LIMIT 1",
+      ).bind(conversationId, member.sub).first<{ aid: string; mime: string; r2_key: string }>();
+      if (prior) {
+          const obj = await (env as any).CHAT_UPLOADS.get(prior.r2_key);
+          if (obj) {
+            const bytes = new Uint8Array(await obj.arrayBuffer());
+            let bin = "";
+            for (let i = 0; i < bytes.length; i += 0x8000) bin += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+            storedImage = `data:${prior.mime};base64,${btoa(bin)}`;
+          }
       }
     }
+  } catch {
+    /* the reuse path is optional — the ask answers without the image */
   }
-  let convEntities: Array<{ entity: string; kind: string }> = [];
+
+let convEntities: Array<{ entity: string; kind: string }> = [];
   if (conversationId) {
     try {
       const rows = await env.DB.prepare("SELECT entity, kind FROM conversation_entities WHERE conversation_id = ?1 LIMIT 12").bind(conversationId).all();
@@ -613,7 +620,21 @@ async function handleAsk(
   // register-shaped question queries the D1 table directly and the rows
   // join the prompt as an authoritative note — exact matches, never a
   // similarity guess about certification standing
-  const register = await searchRegister(env.DB, q.query);
+  let register = await searchRegister(env.DB, q.query);
+  // the nameplate bridge (TODO.new-era/6's image lane): a certificate
+  // question WITH a photograph carries its manufacturer in the pixels —
+  // one vision call extracts it, and those tokens re-query the register
+  // so the answer cites the actual certificate rows
+  if (withImage && !register?.rows?.length && /certificate|certified|certification/i.test(q.query)) {
+    const np = await extractNameplate((env as any).AI, MODELS.member, withImage);
+    if (np?.manufacturer) {
+      const bridged = await searchRegister(env.DB, nameplateRegisterQuery(np, q.query));
+      if (bridged?.rows?.length) {
+        register = bridged;
+        console.log("nameplate-bridge:", np.manufacturer, np.model ?? "", "→", bridged.rows.length, "register rows");
+      }
+    }
+  }
   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) : undefined;
 

package/workers/worker_public/src/certificates.ts

@@ -22,7 +22,7 @@ export interface RegisterRow {
  *  trigger the citation-graph notes already use (query-shaped notes,
  *  never a router). */
 export function isRegisterShaped(query: string): boolean {
-  return /\bcertif(ied|icates?|ication)s?\b/i.test(query) && /\b(is|are|still|currently|valid|status|suspended|revoked|was|were)\b/i.test(query);
+  return /\bcertif(ied|icates?|ication)s?\b/i.test(query) && /\b(is|are|still|currently|valid|status|suspended|revoked|was|were|have|has|hold|holds|possess|carry|got)\b/i.test(query);
 }
 
 /** Search tokens: words that can identify a holder or a model — words of

package/workers/worker_public/src/nameplate-parse.ts

@@ -0,0 +1,29 @@
+// The nameplate bridge's pure half (TODO.new-era/6's image lane): parse
+// the vision call's answer into {manufacturer, model}. Lives apart from
+// the AI-call module so the plain-node suites can exercise it (the
+// prompt is a bundled .md, which only esbuild can load).
+
+export interface Nameplate {
+  manufacturer: string | null;
+  model: string | null;
+}
+
+export function parseNameplate(text: string): Nameplate | null {
+  const m = /\{[^{}]*\}/.exec(String(text ?? ""));
+  if (!m) return null;
+  try {
+    const j = JSON.parse(m[0]) as { manufacturer?: unknown; model?: unknown };
+    const clean = (v: unknown) => (typeof v === "string" && v.trim() ? v.trim().slice(0, 80) : null);
+    const out = { manufacturer: clean(j.manufacturer), model: clean(j.model) };
+    return out.manufacturer || out.model ? out : null;
+  } catch {
+    return null;
+  }
+}
+
+/** The register query the extraction feeds: the nameplate's tokens lead,
+ *  the question's family (if named) scopes. */
+export function nameplateRegisterQuery(np: Nameplate, question: string): string {
+  const fam = /\b([RDMB])\s?-?(\d{2,3})\b/i.exec(question);
+  return [np.manufacturer, np.model, fam ? `${fam[1]} ${fam[2]}` : null].filter(Boolean).join(" ");
+}

package/workers/worker_public/src/nameplate.ts

@@ -0,0 +1,33 @@
+// The nameplate bridge (TODO.new-era/6, the image lane): a certificate
+// question that arrives WITH a photograph carries its manufacturer only
+// in the pixels. A single low-effort vision call extracts the printed
+// manufacturer and model, and those tokens feed the certificate
+// register's D1 lane — so "does this load cell's manufacturer hold the
+// certificate" answers with the actual register rows instead of advice.
+// The shape rules are the 2026-09-09 multimodal findings: the image
+// rides its OWN short user message, never a long passage.
+import nameplatePrompt from "../prompts/nameplate.md";
+import { parseNameplate, nameplateRegisterQuery, type Nameplate } from "./nameplate-parse.ts";
+import { MODELS } from "./config.ts";
+
+export type { Nameplate };
+export { nameplateRegisterQuery };
+
+export async function extractNameplate(ai: any, model: string, image: string): Promise<Nameplate | null> {
+  try {
+    const res: any = await ai.run(model, {
+      messages: [
+        { role: "system", content: nameplatePrompt.trimEnd() },
+        { role: "user", content: [{ type: "image_url", image_url: { url: image } }] },
+      ],
+      max_tokens: 512,
+      reasoning_effort: "low",
+    });
+    const text = typeof res?.response === "string" ? res.response : res?.choices?.[0]?.message?.content;
+    return parseNameplate(text ?? "");
+  } catch {
+    return null; // the bridge is optional — the ask never depends on it
+  }
+}
+
+export const nameplateModel = () => MODELS.member;