@konneal/engine 0.2.89 → 0.2.90

package/dist/{ask-OYW3QMOW.js → ask-D6JV2R2R.js}

@@ -1,7 +1,7 @@
 import {
   handleAsk
-} from "./chunk-NGPUMFYQ.js";
-import "./chunk-HVT2ZTWW.js";
+} from "./chunk-KZV4I7ET.js";
+import "./chunk-A7QS2X3J.js";
 import "./chunk-3BL223VD.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-SPKPH54J.js";

package/dist/{chunk-HVT2ZTWW.js → chunk-A7QS2X3J.js}

@@ -78,7 +78,7 @@ var slug = (docidentifier) => docidentifier.toLowerCase().replace(/[^a-z0-9]+/g,
 var unitsGet = {
   name: "units.get",
   description: "Fetch typed Recommendation content \u2014 a table, formula or figure as structured data (columns, rows, MathML, caption), by its unit id. The machine-consumable form of a Recommendation's content, for computing with rather than reading.",
-  params: [{ key: "unit_id", required: true, description: "the unit id, e.g. u:table-1 or u:form-3 (ids appear in answers' [[u:\u2026]] references)" }],
+  params: [{ key: "unit_id", required: true, description: "the unit id exactly as an answer's [[u:\u2026]] reference spells it" }],
   audiences: ["mcp"],
   handler: async (env, args) => {
     const unit_id = String(args?.unit_id ?? "").trim().replace(/^\[?\[?u:/, "u:").replace(/]?\]?$/, "");
@@ -156,6 +156,30 @@ var docsSection = {
     }
   }
 };
+var documentsFamily = {
+  name: "documents.family",
+  description: "Look up the publication registry for a family: every edition with its derived status (in-force/superseded), which edition is ACTIVE (terminal of the successor chain), and supersession links. Use for current/latest-edition and edition-history questions.",
+  params: [{ key: "family", required: true, description: "the family key, e.g. R-60 (series letter and number)" }],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const family = String(args?.family ?? "").trim().toUpperCase();
+    if (!/^[A-Z]-\d{1,3}$/.test(family)) return null;
+    try {
+      const rows = await env.DB.prepare(
+        "SELECT d.docidentifier, d.derived_status, d.active, s.docidentifier AS succ FROM documents d LEFT JOIN documents s ON d.superseded_by = s.canonical_id WHERE d.family = ?1 ORDER BY d.part, d.edition"
+      ).bind(family).all();
+      const lines = (rows.results ?? []).map(
+        (r) => `${r.docidentifier} \u2014 ${r.derived_status}${r.active ? " [ACTIVE]" : ""}${r.succ ? ` \u2192 superseded by ${r.succ}` : ""}`
+      );
+      if (!lines.length) {
+        return { name: "documents.family", query: family, output: `No editions are registered for the family ${family}. State this plainly.` };
+      }
+      return { name: "documents.family", query: family, output: lines.join("\n") };
+    } catch {
+      return null;
+    }
+  }
+};
 var glossaryLookup = {
   name: "glossary.lookup",
   description: "Look up a defined term in the terminology datasets \u2014 the concept's definition and its defining publication. Bind everyday words to the defined term before interpreting a question.",
@@ -224,7 +248,7 @@ var certificatesSearch = {
     return { name: "certificates.search", query, output };
   }
 };
-var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup];
+var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily];
 var TOOL_DECLARATION = [
   "You may use one tool before answering, by writing a single line:",
   ...TOOLS_REGISTRY.filter((t) => t.audiences.includes("agent")).map((t) => {

package/dist/{chunk-NGPUMFYQ.js → chunk-KZV4I7ET.js}

@@ -6,7 +6,7 @@ import {
   runTool,
   tableRetyped,
   toolNote
-} from "./chunk-HVT2ZTWW.js";
+} from "./chunk-A7QS2X3J.js";
 import {
   NO_CONTEXT,
   answerQuality,

package/dist/{tools-MVAWZZS2.js → tools-26IJZX5M.js}

@@ -4,7 +4,7 @@ import {
   parseToolCall,
   runTool,
   toolNote
-} from "./chunk-HVT2ZTWW.js";
+} from "./chunk-A7QS2X3J.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-2PCUAJJO.js";
 import "./chunk-3FYJM7LH.js";

package/dist/tools-content.d.ts

@@ -2,4 +2,5 @@ import type { ToolSpec } from "./tools.ts";
 export declare const unitsGet: ToolSpec;
 export declare const graphCites: ToolSpec;
 export declare const docsSection: ToolSpec;
+export declare const documentsFamily: ToolSpec;
 export declare const glossaryLookup: ToolSpec;

package/dist/worker_public/src/index.js

@@ -6,10 +6,10 @@ import {
   modelGroundingBlock,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-NGPUMFYQ.js";
+} from "../../chunk-KZV4I7ET.js";
 import {
   TOOLS_REGISTRY
-} from "../../chunk-HVT2ZTWW.js";
+} from "../../chunk-A7QS2X3J.js";
 import {
   handleSearch
 } from "../../chunk-TJTEBS4S.js";
@@ -973,12 +973,12 @@ 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 { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-MVAWZZS2.js");
+    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-26IJZX5M.js");
     if (TOOLS_REGISTRY2.some((t) => t.name === name && t.audiences.includes("mcp"))) {
       const r = await runTool({ ...env, DB: env.DB }, { name, args }, "mcp");
       return r ? { tool: r.name, query: r.query, result: r.output } : { error: { message: `tool ${name} returned nothing for the given arguments` } };
     }
-    const res = name === "ask" ? await (await import("../../ask-OYW3QMOW.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-G76DK4AF.js")).handleSearch(env, ctx, inner, tier, key);
+    const res = name === "ask" ? await (await import("../../ask-D6JV2R2R.js")).handleAsk(env, ctx, inner, tier, key) : await (await import("../../search-G76DK4AF.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.89",
+  "version": "0.2.90",
   "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/tools-content.ts

@@ -21,7 +21,7 @@ export const unitsGet: ToolSpec = {
   name: "units.get",
   description:
     "Fetch typed Recommendation content — a table, formula or figure as structured data (columns, rows, MathML, caption), by its unit id. The machine-consumable form of a Recommendation's content, for computing with rather than reading.",
-  params: [{ key: "unit_id", required: true, description: "the unit id, e.g. u:table-1 or u:form-3 (ids appear in answers' [[u:…]] references)" }],
+  params: [{ key: "unit_id", required: true, description: "the unit id exactly as an answer's [[u:…]] reference spells it" }],
   audiences: ["mcp"],
   handler: async (env, args) => {
     const unit_id = String(args?.unit_id ?? "").trim().replace(/^\[?\[?u:/, "u:").replace(/]?\]?$/, "");
@@ -109,6 +109,34 @@ export const docsSection: ToolSpec = {
   },
 };
 
+export const documentsFamily: ToolSpec = {
+  name: "documents.family",
+  description:
+    "Look up the publication registry for a family: every edition with its derived status (in-force/superseded), which edition is ACTIVE (terminal of the successor chain), and supersession links. Use for current/latest-edition and edition-history questions.",
+  params: [{ key: "family", required: true, description: "the family key, e.g. R-60 (series letter and number)" }],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const family = String(args?.family ?? "").trim().toUpperCase();
+    if (!/^[A-Z]-\d{1,3}$/.test(family)) return null;
+    try {
+      const rows = await env.DB.prepare(
+        "SELECT d.docidentifier, d.derived_status, d.active, s.docidentifier AS succ FROM documents d LEFT JOIN documents s ON d.superseded_by = s.canonical_id WHERE d.family = ?1 ORDER BY d.part, d.edition",
+      )
+        .bind(family)
+        .all();
+      const lines = ((rows.results ?? []) as { docidentifier: string; derived_status: string; active: number; succ: string | null }[]).map(
+        (r) => `${r.docidentifier} — ${r.derived_status}${r.active ? " [ACTIVE]" : ""}${r.succ ? ` → superseded by ${r.succ}` : ""}`,
+      );
+      if (!lines.length) {
+        return { name: "documents.family", query: family, output: `No editions are registered for the family ${family}. State this plainly.` };
+      }
+      return { name: "documents.family", query: family, output: lines.join("\n") };
+    } catch {
+      return null;
+    }
+  },
+};
+
 export const glossaryLookup: ToolSpec = {
   name: "glossary.lookup",
   description:

package/workers/worker_public/src/tools.ts

@@ -64,9 +64,9 @@ const certificatesSearch: ToolSpec = {
   },
 };
 
-import { unitsGet, graphCites, docsSection, glossaryLookup } from "./tools-content.ts";
+import { unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily } from "./tools-content.ts";
 
-export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup];
+export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily];
 
 /** The agent loop's protocol declaration, GENERATED from the registry —
  *  the model's tool vocabulary is always the registry's, never a