@konneal/engine 0.2.92 → 0.2.93

package/dist/{ask-UG5UYRJV.js → ask-RP2Z7CIV.js}

@@ -1,7 +1,7 @@
 import {
   handleAsk
-} from "./chunk-EHABW23I.js";
-import "./chunk-QBWZ6HVP.js";
+} from "./chunk-WZKLWK7E.js";
+import "./chunk-PE2D5MFD.js";
 import "./chunk-3BL223VD.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-SPKPH54J.js";

package/dist/{chunk-QBWZ6HVP.js → chunk-PE2D5MFD.js}

@@ -851,6 +851,63 @@ var conditionsCheck = {
     }
   }
 };
+var bibEntry = {
+  name: "bib.entry",
+  description: "Fetch the bibliographic registry record for a citation label: every edition document under it with derived status (in-force/superseded, the ACTIVE flag), the relation edges (successor, amends, variant), and its outgoing citations. Use after graph.cites to resolve a cited label to its own record.",
+  params: [
+    { key: "label", required: true, description: "the citation label exactly as graph.cites returns it, e.g. ISO 8601" }
+  ],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const label = String(args?.label ?? "").trim();
+    if (label.length < 2) return null;
+    try {
+      const rows = await env.DB.prepare(
+        "SELECT id, kind, label FROM graph_nodes WHERE label = ?1 COLLATE NOCASE LIMIT 5"
+      ).bind(label).all();
+      const nodes = rows.results ?? [];
+      if (!nodes.length) {
+        return { name: "bib.entry", query: label, output: `No registry node carries the label "${label}". State this plainly.` };
+      }
+      const out = [];
+      for (const n of nodes) {
+        const entry = { label: n.label, kind: n.kind };
+        if (n.kind === "doc") {
+          const d = await env.DB.prepare(
+            "SELECT docidentifier, family, part, edition, derived_status, active, superseded_by, title FROM documents WHERE canonical_id = ?1"
+          ).bind(n.id).all();
+          const doc = (d.results ?? [])[0];
+          if (doc) {
+            entry.document = {
+              docidentifier: doc.docidentifier,
+              family: doc.family,
+              part: doc.part,
+              edition: doc.edition,
+              status: doc.derived_status,
+              active: !!doc.active,
+              superseded_by: doc.superseded_by,
+              title: doc.title
+            };
+          }
+        }
+        const rel = await env.DB.prepare(
+          "SELECT e.kind, n.label AS target FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 LIMIT 25"
+        ).bind(n.id).all();
+        const relations = rel.results ?? [];
+        if (relations.length) entry.relations = relations;
+        const cites = await env.DB.prepare(
+          "SELECT n.label AS cited FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 AND e.kind = 'cites' LIMIT 40"
+        ).bind(n.id).all();
+        const cited = (cites.results ?? []).map((r) => r.cited).filter(Boolean);
+        if (cited.length) entry.cites = cited;
+        out.push(entry);
+      }
+      return { name: "bib.entry", query: label, output: JSON.stringify(out) };
+    } 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.",
@@ -919,7 +976,7 @@ var certificatesSearch = {
     return { name: "certificates.search", query, output };
   }
 };
-var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck];
+var TOOLS_REGISTRY = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry];
 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-EHABW23I.js → chunk-WZKLWK7E.js}

@@ -18,7 +18,7 @@ import {
   tableRetyped,
   toolNote,
   verdictNote
-} from "./chunk-QBWZ6HVP.js";
+} from "./chunk-PE2D5MFD.js";
 import {
   NO_CONTEXT,
   answerQuality,

package/dist/{tools-PI7IXAL4.js → tools-SVP6MKBR.js}

@@ -4,7 +4,7 @@ import {
   parseToolCall,
   runTool,
   toolNote
-} from "./chunk-QBWZ6HVP.js";
+} from "./chunk-PE2D5MFD.js";
 import "./chunk-LOBYXEVD.js";
 import "./chunk-LVZTWUVJ.js";
 import "./chunk-2PCUAJJO.js";

package/dist/tools-content.d.ts

@@ -6,4 +6,5 @@ export declare const documentsFamily: ToolSpec;
 export declare const licensedSection: ToolSpec;
 export declare const verdictEvaluate: ToolSpec;
 export declare const conditionsCheck: ToolSpec;
+export declare const bibEntry: ToolSpec;
 export declare const glossaryLookup: ToolSpec;

package/dist/worker_public/src/index.js

@@ -4,12 +4,12 @@ import {
   handleMemories,
   scoreFaithfulness,
   scoreJudge
-} from "../../chunk-EHABW23I.js";
+} from "../../chunk-WZKLWK7E.js";
 import {
   TOOLS_REGISTRY,
   bindModelNode,
   modelGroundingBlock
-} from "../../chunk-QBWZ6HVP.js";
+} from "../../chunk-PE2D5MFD.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-PI7IXAL4.js");
+    const { runTool, TOOLS_REGISTRY: TOOLS_REGISTRY2 } = await import("../../tools-SVP6MKBR.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-UG5UYRJV.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-RP2Z7CIV.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.92",
+  "version": "0.2.93",
   "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

@@ -339,6 +339,79 @@ export const conditionsCheck: ToolSpec = {
   },
 };
 
+
+// The bibliography record (the owner's 2026-10-04 direction): the full
+// registry entry for one citation label — what documents exist under
+// it, their derived status, the successor/amends/variant edges, and
+// what it cites and is cited by. graph.cites names the labels; this is
+// the record behind the label, for agents that cite properly.
+export const bibEntry: ToolSpec = {
+  name: "bib.entry",
+  description:
+    "Fetch the bibliographic registry record for a citation label: every edition document under it with derived status (in-force/superseded, the ACTIVE flag), the relation edges (successor, amends, variant), and its outgoing citations. Use after graph.cites to resolve a cited label to its own record.",
+  params: [
+    { key: "label", required: true, description: "the citation label exactly as graph.cites returns it, e.g. ISO 8601" },
+  ],
+  audiences: ["mcp"],
+  handler: async (env, args) => {
+    const label = String(args?.label ?? "").trim();
+    if (label.length < 2) return null;
+    try {
+      const rows = await env.DB.prepare(
+        "SELECT id, kind, label FROM graph_nodes WHERE label = ?1 COLLATE NOCASE LIMIT 5",
+      )
+        .bind(label)
+        .all();
+      const nodes = ((rows.results ?? []) as { id: string; kind: string; label: string }[]);
+      if (!nodes.length) {
+        return { name: "bib.entry", query: label, output: `No registry node carries the label "${label}". State this plainly.` };
+      }
+      const out: unknown[] = [];
+      for (const n of nodes) {
+        const entry: Record<string, unknown> = { label: n.label, kind: n.kind };
+        if (n.kind === "doc") {
+          const d = await env.DB.prepare(
+            "SELECT docidentifier, family, part, edition, derived_status, active, superseded_by, title FROM documents WHERE canonical_id = ?1",
+          )
+            .bind(n.id)
+            .all();
+          const doc = (d.results ?? [])[0] as Record<string, unknown> | undefined;
+          if (doc) {
+            entry.document = {
+              docidentifier: doc.docidentifier,
+              family: doc.family,
+              part: doc.part,
+              edition: doc.edition,
+              status: doc.derived_status,
+              active: !!doc.active,
+              superseded_by: doc.superseded_by,
+              title: doc.title,
+            };
+          }
+        }
+        const rel = await env.DB.prepare(
+          "SELECT e.kind, n.label AS target FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 LIMIT 25",
+        )
+          .bind(n.id)
+          .all();
+        const relations = ((rel.results ?? []) as { kind: string; target: string }[]);
+        if (relations.length) entry.relations = relations;
+        const cites = await env.DB.prepare(
+          "SELECT n.label AS cited FROM graph_edges e JOIN graph_nodes n ON e.dst = n.id WHERE e.src = ?1 AND e.kind = 'cites' LIMIT 40",
+        )
+          .bind(n.id)
+          .all();
+        const cited = ((cites.results ?? []) as { cited: string }[]).map((r) => r.cited).filter(Boolean);
+        if (cited.length) entry.cites = cited;
+        out.push(entry);
+      }
+      return { name: "bib.entry", query: label, output: JSON.stringify(out) };
+    } 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, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck } from "./tools-content.ts";
+import { unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry } from "./tools-content.ts";
 
-export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck];
+export const TOOLS_REGISTRY: ToolSpec[] = [certificatesSearch, unitsGet, graphCites, docsSection, glossaryLookup, documentsFamily, licensedSection, verdictEvaluate, conditionsCheck, bibEntry];
 
 /** The agent loop's protocol declaration, GENERATED from the registry —
  *  the model's tool vocabulary is always the registry's, never a