@nhtio/adk 0.1.0-master-f0aa531d

package/batteries/tools/parsing.mjs

@@ -0,0 +1,185 @@
+import { o as isError } from "../../tool_registry-DqLOyGyG.mjs";
+import "../../common-DeZaonK1.mjs";
+import { t as Tool } from "../../tool-D2WB1EA1.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-BpUJol0W.mjs";
+import "../../guards.mjs";
+import { validator } from "@nhtio/validation";
+import { load } from "js-yaml";
+import Papa from "papaparse";
+//#region src/batteries/tools/parsing/index.ts
+/**
+* Pre-constructed tools for parsing CSV, TSV, JSON, YAML, and other structured text formats.
+*
+* @module @nhtio/adk/batteries/tools/parsing
+*
+* @remarks
+* Pre-constructed bundled tools for the `parsing` category. Import individually, the whole
+* category, or import every tool via `@nhtio/adk/batteries`.
+*/
+/**
+* Parse a CSV or TSV string into a JSON array.
+*
+* @remarks
+* With `has_header: true` (default), each row becomes an object keyed by column name. Without a
+* header, rows are returned as positional arrays. `delimiter` auto-detects when omitted; pass
+* `"\t"` for TSV. Rows are clipped to `limit` (default 1000, max 10000). Parse warnings are
+* prepended to the output.
+*/
+var parseCsvTool = new Tool({
+	name: "parse_csv",
+	description: "Parse a CSV or TSV string into a JSON array. With a header row, returns objects keyed by column name. Without, returns arrays of values.",
+	inputSchema: validator.object({
+		text: validator.string().required().description("CSV or TSV text to parse"),
+		has_header: validator.boolean().default(true).description("First row is a header row (default: true)"),
+		delimiter: validator.string().default("").allow("").description("Field delimiter — auto-detected if omitted. Use \"\\t\" for TSV."),
+		limit: validator.number().default(1e3).description("Maximum rows to return (default: 1000)")
+	}),
+	artifactConstructor: () => SpooledJsonArtifact,
+	handler: async (args) => {
+		const { text, has_header: hasHeader, delimiter, limit: rawLimit } = args;
+		const limit = Math.min(1e4, Math.max(1, Math.floor(rawLimit)));
+		try {
+			const result = Papa.parse(text.trim(), {
+				header: hasHeader,
+				delimiter: delimiter || void 0,
+				skipEmptyLines: true,
+				dynamicTyping: true
+			});
+			const rows = result.data.slice(0, limit);
+			const warnings = result.errors.length > 0 ? `Parse warnings: ${result.errors.slice(0, 3).map((e) => e.message).join("; ")}\n\n` : "";
+			const truncated = result.data.length > limit ? `\n\n(Showing ${limit} of ${result.data.length} rows)` : "";
+			return warnings + JSON.stringify(rows, null, 2) + truncated;
+		} catch (err) {
+			return `Error: ${isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Parse a YAML string into JSON.
+*
+* @remarks
+* Returns a pretty-printed JSON representation of the parsed YAML document. Invalid YAML
+* returns an error string.
+*/
+var parseYamlTool = new Tool({
+	name: "parse_yaml",
+	description: "Parse a YAML string and return the equivalent JSON.",
+	inputSchema: validator.object({ text: validator.string().required().description("YAML text to parse") }),
+	artifactConstructor: () => SpooledJsonArtifact,
+	handler: async (args) => {
+		const { text } = args;
+		try {
+			const parsed = load(text);
+			return JSON.stringify(parsed, null, 2);
+		} catch (err) {
+			return `Error: Invalid YAML — ${isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Extract key-value pairs from text.
+*
+* @remarks
+* Handles `.env` files, config files, and query strings. `kv_delimiter` chooses the
+* key→value separator (`=`, `:`, or `auto`); `pair_delimiter` selects how pairs are separated
+* (`newline`, `comma`, `semicolon`, `ampersand`). Surrounding single or double quotes around
+* values are stripped. Comment lines starting with `#` are skipped by default.
+*/
+var parseKvTool = new Tool({
+	name: "parse_kv",
+	description: "Extract key-value pairs from text (e.g. .env files, config files, query strings). Returns a JSON object.",
+	inputSchema: validator.object({
+		text: validator.string().required().description("Text containing key-value pairs"),
+		kv_delimiter: validator.string().valid("=", ":", "auto").default("auto").description("Separator between key and value (default: auto-detect)"),
+		pair_delimiter: validator.string().valid("newline", "comma", "semicolon", "ampersand").default("newline").description("Separator between pairs (default: newline)"),
+		skip_comments: validator.boolean().default(true).description("Skip lines starting with # (default: true)")
+	}),
+	artifactConstructor: () => SpooledJsonArtifact,
+	handler: async (args) => {
+		const { text, kv_delimiter: kvDelim, pair_delimiter: pairDelimKey, skip_comments: skipComments } = args;
+		const pairDelim = {
+			newline: "\n",
+			comma: ",",
+			semicolon: ";",
+			ampersand: "&"
+		}[pairDelimKey] ?? "\n";
+		const result = {};
+		for (const raw of text.split(pairDelim)) {
+			const line = raw.trim();
+			if (line === "") continue;
+			if (skipComments && line.startsWith("#")) continue;
+			const delim = kvDelim === "auto" ? line.includes("=") ? "=" : line.includes(":") ? ":" : null : kvDelim;
+			if (!delim) continue;
+			const sepIdx = line.indexOf(delim);
+			if (sepIdx === -1) continue;
+			const key = line.slice(0, sepIdx).trim();
+			let value = line.slice(sepIdx + delim.length).trim();
+			if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+			if (key) result[key] = value;
+		}
+		return JSON.stringify(result, null, 2);
+	}
+});
+/**
+* Detect the most likely field delimiter in a CSV-like text sample.
+*
+* @remarks
+* Tries comma, tab, semicolon, pipe, and colon. Scores each by mean field count divided by
+* variance (so consistent row widths beat noisy splits). Looks at up to the first 20 lines of
+* the first 5000 characters.
+*/
+var detectDelimiterTool = new Tool({
+	name: "detect_delimiter",
+	description: "Detect the most likely field delimiter in a CSV-like text sample.",
+	inputSchema: validator.object({ text: validator.string().required().description("Sample of the delimited text to analyze") }),
+	handler: async (args) => {
+		const { text } = args;
+		const lines = text.slice(0, 5e3).split("\n").map((l) => l.trim()).filter((l) => l.length > 0).slice(0, 20);
+		if (lines.length === 0) return "Error: No lines to analyze.";
+		const candidates = [
+			{
+				delim: ",",
+				name: "comma"
+			},
+			{
+				delim: "	",
+				name: "tab"
+			},
+			{
+				delim: ";",
+				name: "semicolon"
+			},
+			{
+				delim: "|",
+				name: "pipe"
+			},
+			{
+				delim: ":",
+				name: "colon"
+			}
+		];
+		let best = {
+			name: "comma",
+			delim: ",",
+			score: -1,
+			avgFields: 0
+		};
+		for (const { delim, name } of candidates) {
+			const counts = lines.map((l) => l.split(delim).length - 1);
+			const avg = counts.reduce((a, b) => a + b, 0) / counts.length;
+			if (avg === 0) continue;
+			const score = avg / (1 + counts.reduce((a, b) => a + (b - avg) ** 2, 0) / counts.length);
+			if (score > best.score) best = {
+				name,
+				delim,
+				score,
+				avgFields: Number.parseFloat((avg + 1).toFixed(1))
+			};
+		}
+		return `Detected delimiter: ${best.name} ("${best.delim === "	" ? "\\t" : best.delim}") — ~${best.avgFields} fields per row`;
+	}
+});
+//#endregion
+export { detectDelimiterTool, parseCsvTool, parseKvTool, parseYamlTool };
+
+//# sourceMappingURL=parsing.mjs.map

package/batteries/tools/parsing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.mjs","names":[],"sources":["../../../src/batteries/tools/parsing/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for parsing CSV, TSV, JSON, YAML, and other structured text formats.\n *\n * @module @nhtio/adk/batteries/tools/parsing\n *\n * @remarks\n * Pre-constructed bundled tools for the `parsing` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { load as parseYaml } from 'js-yaml'\nimport { default as Papa } from 'papaparse'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\nimport { Tool, SpooledJsonArtifact } from '@nhtio/adk/common'\n\n/**\n * Parse a CSV or TSV string into a JSON array.\n *\n * @remarks\n * With `has_header: true` (default), each row becomes an object keyed by column name. Without a\n * header, rows are returned as positional arrays. `delimiter` auto-detects when omitted; pass\n * `\"\\t\"` for TSV. Rows are clipped to `limit` (default 1000, max 10000). Parse warnings are\n * prepended to the output.\n */\nexport const parseCsvTool = new Tool({\n  name: 'parse_csv',\n  description:\n    'Parse a CSV or TSV string into a JSON array. With a header row, returns objects keyed by column name. Without, returns arrays of values.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('CSV or TSV text to parse'),\n    has_header: validator\n      .boolean()\n      .default(true)\n      .description('First row is a header row (default: true)'),\n    delimiter: validator\n      .string()\n      .default('')\n      .allow('')\n      .description('Field delimiter — auto-detected if omitted. Use \"\\\\t\" for TSV.'),\n    limit: validator.number().default(1000).description('Maximum rows to return (default: 1000)'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (args) => {\n    const {\n      text,\n      has_header: hasHeader,\n      delimiter,\n      limit: rawLimit,\n    } = args as {\n      text: string\n      has_header: boolean\n      delimiter: string\n      limit: number\n    }\n    const limit = Math.min(10_000, Math.max(1, Math.floor(rawLimit)))\n\n    try {\n      const result = Papa.parse<unknown>(text.trim(), {\n        header: hasHeader,\n        delimiter: delimiter || undefined,\n        skipEmptyLines: true,\n        dynamicTyping: true,\n      })\n\n      const rows = (result.data as unknown[]).slice(0, limit)\n      const warnings =\n        result.errors.length > 0\n          ? `Parse warnings: ${result.errors\n              .slice(0, 3)\n              .map((e) => e.message)\n              .join('; ')}\\n\\n`\n          : ''\n      const truncated =\n        result.data.length > limit ? `\\n\\n(Showing ${limit} of ${result.data.length} rows)` : ''\n\n      return warnings + JSON.stringify(rows, null, 2) + truncated\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Parse a YAML string into JSON.\n *\n * @remarks\n * Returns a pretty-printed JSON representation of the parsed YAML document. Invalid YAML\n * returns an error string.\n */\nexport const parseYamlTool = new Tool({\n  name: 'parse_yaml',\n  description: 'Parse a YAML string and return the equivalent JSON.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('YAML text to parse'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (args) => {\n    const { text } = args as { text: string }\n    try {\n      const parsed = parseYaml(text)\n      return JSON.stringify(parsed, null, 2)\n    } catch (err) {\n      return `Error: Invalid YAML — ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Extract key-value pairs from text.\n *\n * @remarks\n * Handles `.env` files, config files, and query strings. `kv_delimiter` chooses the\n * key→value separator (`=`, `:`, or `auto`); `pair_delimiter` selects how pairs are separated\n * (`newline`, `comma`, `semicolon`, `ampersand`). Surrounding single or double quotes around\n * values are stripped. Comment lines starting with `#` are skipped by default.\n */\nexport const parseKvTool = new Tool({\n  name: 'parse_kv',\n  description:\n    'Extract key-value pairs from text (e.g. .env files, config files, query strings). Returns a JSON object.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Text containing key-value pairs'),\n    kv_delimiter: validator\n      .string()\n      .valid('=', ':', 'auto')\n      .default('auto')\n      .description('Separator between key and value (default: auto-detect)'),\n    pair_delimiter: validator\n      .string()\n      .valid('newline', 'comma', 'semicolon', 'ampersand')\n      .default('newline')\n      .description('Separator between pairs (default: newline)'),\n    skip_comments: validator\n      .boolean()\n      .default(true)\n      .description('Skip lines starting with # (default: true)'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (args) => {\n    const {\n      text,\n      kv_delimiter: kvDelim,\n      pair_delimiter: pairDelimKey,\n      skip_comments: skipComments,\n    } = args as {\n      text: string\n      kv_delimiter: string\n      pair_delimiter: string\n      skip_comments: boolean\n    }\n\n    const pairDelimMap: Record<string, string> = {\n      newline: '\\n',\n      comma: ',',\n      semicolon: ';',\n      ampersand: '&',\n    }\n    const pairDelim = pairDelimMap[pairDelimKey] ?? '\\n'\n\n    const result: Record<string, string> = {}\n\n    for (const raw of text.split(pairDelim)) {\n      const line = raw.trim()\n      if (line === '') continue\n      if (skipComments && line.startsWith('#')) continue\n\n      const delim =\n        kvDelim === 'auto' ? (line.includes('=') ? '=' : line.includes(':') ? ':' : null) : kvDelim\n      if (!delim) continue\n\n      const sepIdx = line.indexOf(delim)\n      if (sepIdx === -1) continue\n\n      const key = line.slice(0, sepIdx).trim()\n      let value = line.slice(sepIdx + delim.length).trim()\n\n      if (\n        (value.startsWith('\"') && value.endsWith('\"')) ||\n        (value.startsWith(\"'\") && value.endsWith(\"'\"))\n      ) {\n        value = value.slice(1, -1)\n      }\n\n      if (key) result[key] = value\n    }\n\n    return JSON.stringify(result, null, 2)\n  },\n})\n\n/**\n * Detect the most likely field delimiter in a CSV-like text sample.\n *\n * @remarks\n * Tries comma, tab, semicolon, pipe, and colon. Scores each by mean field count divided by\n * variance (so consistent row widths beat noisy splits). Looks at up to the first 20 lines of\n * the first 5000 characters.\n */\nexport const detectDelimiterTool = new Tool({\n  name: 'detect_delimiter',\n  description: 'Detect the most likely field delimiter in a CSV-like text sample.',\n  inputSchema: validator.object({\n    text: validator.string().required().description('Sample of the delimited text to analyze'),\n  }),\n  handler: async (args) => {\n    const { text } = args as { text: string }\n    const sample = text.slice(0, 5000)\n    const lines = sample\n      .split('\\n')\n      .map((l) => l.trim())\n      .filter((l) => l.length > 0)\n      .slice(0, 20)\n\n    if (lines.length === 0) return 'Error: No lines to analyze.'\n\n    const candidates: Array<{ delim: string; name: string }> = [\n      { delim: ',', name: 'comma' },\n      { delim: '\\t', name: 'tab' },\n      { delim: ';', name: 'semicolon' },\n      { delim: '|', name: 'pipe' },\n      { delim: ':', name: 'colon' },\n    ]\n\n    let best = { name: 'comma', delim: ',', score: -1, avgFields: 0 }\n\n    for (const { delim, name } of candidates) {\n      const counts = lines.map((l) => l.split(delim).length - 1)\n      const avg = counts.reduce((a, b) => a + b, 0) / counts.length\n      if (avg === 0) continue\n      const fieldVariance = counts.reduce((a, b) => a + (b - avg) ** 2, 0) / counts.length\n      const score = avg / (1 + fieldVariance)\n      if (score > best.score) {\n        best = { name, delim, score, avgFields: Number.parseFloat((avg + 1).toFixed(1)) }\n      }\n    }\n\n    return `Detected delimiter: ${best.name} (\"${best.delim === '\\t' ? '\\\\t' : best.delim}\") — ~${best.avgFields} fields per row`\n  },\n})\n"],"mappings":"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"}

package/batteries/tools/retrievables/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Pre-constructed CRUD tools for model-visible retrievable and RAG-record management.
+ *
+ * @module @nhtio/adk/batteries/tools/retrievables
+ *
+ * @remarks
+ * Pre-constructed CRUD tools that expose the ADK's {@link @nhtio/adk!Retrievable} surface to the
+ * model. Each tool delegates to the corresponding callback on the active
+ * {@link @nhtio/adk!DispatchContext} (`fetchRetrievables`, `storeRetrievable`, `mutateRetrievable`,
+ * `deleteRetrievable`) — the persistence layer is whatever the consumer wired into the
+ * runner.
+ *
+ * Retrievables are RAG records and carry an explicit `trustTier` that drives the LLM
+ * battery's rendering envelope. Exposing these CRUD tools to the model is a deliberate
+ * deployer decision; the trust tier the model declares when creating or updating a record
+ * is honoured verbatim by the persistence layer. The deployer is responsible for choosing
+ * whether to register all four tools, only the read-only `list_retrievables`, or any subset
+ * thereof — that registration choice is exactly the trust boundary documented in the
+ * Retrievable battery contract.
+ *
+ * Output is JSON for every tool so consumers can parse the result without re-tokenising —
+ * the artifact constructor is set to {@link @nhtio/adk!SpooledJsonArtifact}.
+ *
+ * Tools:
+ * - {@link listRetrievablesTool} — read-only list of every retrievable currently held by
+ *   the context.
+ * - {@link storeRetrievableTool} — create a new retrievable record (auto-generates `id` /
+ *   `createdAt` / `updatedAt` unless explicit values are supplied).
+ * - {@link updateRetrievableTool} — replace an existing retrievable by `id`. Bumps
+ *   `updatedAt`.
+ * - {@link deleteRetrievableTool} — remove a retrievable by `id`.
+ */
+import { SpooledJsonArtifact, Tool } from "../../../common";
+/**
+ * List every retrievable record currently held by the active execution context.
+ *
+ * @remarks
+ * Delegates to `ctx.fetchRetrievables()`. Returns a JSON-encoded array of retrievable records
+ * (id, content, trustTier, source, kind, score, createdAt, updatedAt).
+ */
+export declare const listRetrievablesTool: Tool<SpooledJsonArtifact<unknown>>;
+/**
+ * Create a new {@link @nhtio/adk!Retrievable} record and persist it via the context's `storeRetrievable`
+ * callback.
+ *
+ * @remarks
+ * When `id` is omitted, a UUID v6 is generated. When `createdAt` / `updatedAt` are omitted,
+ * the current time is used. The model must declare `trustTier` explicitly — there is no
+ * default; the choice is consciously the model's, exposed by the deployer's decision to
+ * register this tool.
+ */
+export declare const storeRetrievableTool: Tool<SpooledJsonArtifact<unknown>>;
+/**
+ * Replace an existing {@link @nhtio/adk!Retrievable} by `id`.
+ *
+ * @remarks
+ * The model supplies `id` plus any subset of `content` / `trustTier` / `source` / `kind` /
+ * `score`; omitted fields retain their prior values. `updatedAt` is always bumped;
+ * `createdAt` is preserved. Returns an error when no retrievable with the supplied `id` is
+ * found.
+ */
+export declare const updateRetrievableTool: Tool<SpooledJsonArtifact<unknown>>;
+/**
+ * Remove an existing {@link @nhtio/adk!Retrievable} by `id`.
+ *
+ * @remarks
+ * Delegates to `ctx.deleteRetrievable(id)`. Returns `{ ok: true, id }` on success regardless
+ * of whether a retrievable was actually present — `deleteRetrievable` is idempotent at the
+ * ADK level.
+ */
+export declare const deleteRetrievableTool: Tool<SpooledJsonArtifact<unknown>>;
+/**
+ * Convenience tuple of every retrievable CRUD tool. Spread into a {@link @nhtio/adk!ToolRegistry} to
+ * register the entire category at once.
+ */
+export declare const retrievableTools: readonly [
+    Tool<SpooledJsonArtifact<unknown>>,
+    Tool<SpooledJsonArtifact<unknown>>,
+    Tool<SpooledJsonArtifact<unknown>>,
+    Tool<SpooledJsonArtifact<unknown>>
+];

package/batteries/tools/retrievables.cjs

@@ -0,0 +1,215 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-KmRHZBOW.js");
+const require_tool_registry = require("../../tool_registry-Dkfprsck.js");
+const require_common = require("../../common-Od8edUXU.js");
+const require_tool = require("../../tool-COSeH8I6.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-RRB113sy.js");
+require("../../guards.cjs");
+let _nhtio_validation = require("@nhtio/validation");
+let uuid = require("uuid");
+let luxon = require("luxon");
+//#region src/batteries/tools/retrievables/index.ts
+/**
+* Pre-constructed CRUD tools for model-visible retrievable and RAG-record management.
+*
+* @module @nhtio/adk/batteries/tools/retrievables
+*
+* @remarks
+* Pre-constructed CRUD tools that expose the ADK's {@link @nhtio/adk!Retrievable} surface to the
+* model. Each tool delegates to the corresponding callback on the active
+* {@link @nhtio/adk!DispatchContext} (`fetchRetrievables`, `storeRetrievable`, `mutateRetrievable`,
+* `deleteRetrievable`) — the persistence layer is whatever the consumer wired into the
+* runner.
+*
+* Retrievables are RAG records and carry an explicit `trustTier` that drives the LLM
+* battery's rendering envelope. Exposing these CRUD tools to the model is a deliberate
+* deployer decision; the trust tier the model declares when creating or updating a record
+* is honoured verbatim by the persistence layer. The deployer is responsible for choosing
+* whether to register all four tools, only the read-only `list_retrievables`, or any subset
+* thereof — that registration choice is exactly the trust boundary documented in the
+* Retrievable battery contract.
+*
+* Output is JSON for every tool so consumers can parse the result without re-tokenising —
+* the artifact constructor is set to {@link @nhtio/adk!SpooledJsonArtifact}.
+*
+* Tools:
+* - {@link listRetrievablesTool} — read-only list of every retrievable currently held by
+*   the context.
+* - {@link storeRetrievableTool} — create a new retrievable record (auto-generates `id` /
+*   `createdAt` / `updatedAt` unless explicit values are supplied).
+* - {@link updateRetrievableTool} — replace an existing retrievable by `id`. Bumps
+*   `updatedAt`.
+* - {@link deleteRetrievableTool} — remove a retrievable by `id`.
+*/
+var TRUST_TIERS = [
+	"first-party",
+	"third-party-public",
+	"third-party-private"
+];
+var serialiseRetrievable = (r) => ({
+	id: r.id,
+	content: r.content.toString(),
+	trustTier: r.trustTier,
+	source: r.source,
+	kind: r.kind,
+	score: r.score,
+	createdAt: r.createdAt.toISO(),
+	updatedAt: r.updatedAt.toISO()
+});
+/**
+* List every retrievable record currently held by the active execution context.
+*
+* @remarks
+* Delegates to `ctx.fetchRetrievables()`. Returns a JSON-encoded array of retrievable records
+* (id, content, trustTier, source, kind, score, createdAt, updatedAt).
+*/
+var listRetrievablesTool = new require_tool.Tool({
+	name: "list_retrievables",
+	description: "List every retrievable record currently available to the agent. Returns a JSON array of records with id, content, trustTier, source, kind, score, createdAt, and updatedAt.",
+	inputSchema: _nhtio_validation.validator.object({}),
+	artifactConstructor: () => require_spooled_markdown_artifact.SpooledJsonArtifact,
+	handler: async (_args, ctx) => {
+		try {
+			const retrievables = await ctx.fetchRetrievables();
+			return JSON.stringify(retrievables.map(serialiseRetrievable), null, 2);
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Create a new {@link @nhtio/adk!Retrievable} record and persist it via the context's `storeRetrievable`
+* callback.
+*
+* @remarks
+* When `id` is omitted, a UUID v6 is generated. When `createdAt` / `updatedAt` are omitted,
+* the current time is used. The model must declare `trustTier` explicitly — there is no
+* default; the choice is consciously the model's, exposed by the deployer's decision to
+* register this tool.
+*/
+var storeRetrievableTool = new require_tool.Tool({
+	name: "store_retrievable",
+	description: "Store a new retrievable (RAG) record. The trustTier MUST be one of 'first-party' (deployer-vetted), 'third-party-public' (open-web), or 'third-party-private' (user uploads). id and timestamps are auto-generated if omitted.",
+	inputSchema: _nhtio_validation.validator.object({
+		content: _nhtio_validation.validator.string().required().description("The retrievable content as a plain string."),
+		trustTier: _nhtio_validation.validator.string().valid(...TRUST_TIERS).required().description("Trust tier: 'first-party' for deployer-vetted material, 'third-party-public' for open-web or public APIs, 'third-party-private' for user uploads or partner APIs."),
+		source: _nhtio_validation.validator.string().optional().description("Optional provenance string: URL, document path, KB id, etc."),
+		kind: _nhtio_validation.validator.string().optional().description("Optional semantic label: 'policy', 'reference', 'web-page', 'pdf', etc."),
+		score: _nhtio_validation.validator.number().min(0).max(1).optional().description("Optional relevance / similarity score in [0, 1]."),
+		id: _nhtio_validation.validator.string().optional().description("Optional stable id. Auto-generated when absent.")
+	}),
+	artifactConstructor: () => require_spooled_markdown_artifact.SpooledJsonArtifact,
+	handler: async (args, ctx) => {
+		const { content, trustTier, source, kind, score, id } = args;
+		try {
+			const now = luxon.DateTime.now();
+			const retrievable = new require_common.Retrievable({
+				id: id ?? (0, uuid.v6)(),
+				content,
+				trustTier,
+				source,
+				kind,
+				score,
+				createdAt: now,
+				updatedAt: now
+			});
+			await ctx.storeRetrievable(retrievable);
+			return JSON.stringify({
+				ok: true,
+				retrievable: serialiseRetrievable(retrievable)
+			}, null, 2);
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Replace an existing {@link @nhtio/adk!Retrievable} by `id`.
+*
+* @remarks
+* The model supplies `id` plus any subset of `content` / `trustTier` / `source` / `kind` /
+* `score`; omitted fields retain their prior values. `updatedAt` is always bumped;
+* `createdAt` is preserved. Returns an error when no retrievable with the supplied `id` is
+* found.
+*/
+var updateRetrievableTool = new require_tool.Tool({
+	name: "update_retrievable",
+	description: "Update an existing retrievable by id. Supply any subset of content / trustTier / source / kind / score — omitted fields retain their prior values. updatedAt is always refreshed.",
+	inputSchema: _nhtio_validation.validator.object({
+		id: _nhtio_validation.validator.string().required().description("Id of the retrievable to update."),
+		content: _nhtio_validation.validator.string().optional().description("Replacement content."),
+		trustTier: _nhtio_validation.validator.string().valid(...TRUST_TIERS).optional().description("Replacement trust tier."),
+		source: _nhtio_validation.validator.string().optional().description("Replacement provenance string."),
+		kind: _nhtio_validation.validator.string().optional().description("Replacement semantic label."),
+		score: _nhtio_validation.validator.number().min(0).max(1).optional().description("Replacement score in [0, 1].")
+	}),
+	artifactConstructor: () => require_spooled_markdown_artifact.SpooledJsonArtifact,
+	handler: async (args, ctx) => {
+		const { id, content, trustTier, source, kind, score } = args;
+		try {
+			const existing = (await ctx.fetchRetrievables()).find((r) => r.id === id);
+			if (!existing) return `Error: No retrievable found with id "${id}".`;
+			const updated = new require_common.Retrievable({
+				id: existing.id,
+				content: content ?? existing.content,
+				trustTier: trustTier ?? existing.trustTier,
+				source: source ?? existing.source,
+				kind: kind ?? existing.kind,
+				score: score ?? existing.score,
+				createdAt: existing.createdAt,
+				updatedAt: luxon.DateTime.now()
+			});
+			await ctx.mutateRetrievable(updated);
+			return JSON.stringify({
+				ok: true,
+				retrievable: serialiseRetrievable(updated)
+			}, null, 2);
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Remove an existing {@link @nhtio/adk!Retrievable} by `id`.
+*
+* @remarks
+* Delegates to `ctx.deleteRetrievable(id)`. Returns `{ ok: true, id }` on success regardless
+* of whether a retrievable was actually present — `deleteRetrievable` is idempotent at the
+* ADK level.
+*/
+var deleteRetrievableTool = new require_tool.Tool({
+	name: "delete_retrievable",
+	description: "Delete a retrievable by id.",
+	inputSchema: _nhtio_validation.validator.object({ id: _nhtio_validation.validator.string().required().description("Id of the retrievable to delete.") }),
+	artifactConstructor: () => require_spooled_markdown_artifact.SpooledJsonArtifact,
+	handler: async (args, ctx) => {
+		const { id } = args;
+		try {
+			await ctx.deleteRetrievable(id);
+			return JSON.stringify({
+				ok: true,
+				id
+			}, null, 2);
+		} catch (err) {
+			return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+		}
+	}
+});
+/**
+* Convenience tuple of every retrievable CRUD tool. Spread into a {@link @nhtio/adk!ToolRegistry} to
+* register the entire category at once.
+*/
+var retrievableTools = [
+	listRetrievablesTool,
+	storeRetrievableTool,
+	updateRetrievableTool,
+	deleteRetrievableTool
+];
+//#endregion
+exports.deleteRetrievableTool = deleteRetrievableTool;
+exports.listRetrievablesTool = listRetrievablesTool;
+exports.retrievableTools = retrievableTools;
+exports.storeRetrievableTool = storeRetrievableTool;
+exports.updateRetrievableTool = updateRetrievableTool;
+
+//# sourceMappingURL=retrievables.cjs.map

package/batteries/tools/retrievables.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrievables.cjs","names":[],"sources":["../../../src/batteries/tools/retrievables/index.ts"],"sourcesContent":["/**\n * Pre-constructed CRUD tools for model-visible retrievable and RAG-record management.\n *\n * @module @nhtio/adk/batteries/tools/retrievables\n *\n * @remarks\n * Pre-constructed CRUD tools that expose the ADK's {@link @nhtio/adk!Retrievable} surface to the\n * model. Each tool delegates to the corresponding callback on the active\n * {@link @nhtio/adk!DispatchContext} (`fetchRetrievables`, `storeRetrievable`, `mutateRetrievable`,\n * `deleteRetrievable`) — the persistence layer is whatever the consumer wired into the\n * runner.\n *\n * Retrievables are RAG records and carry an explicit `trustTier` that drives the LLM\n * battery's rendering envelope. Exposing these CRUD tools to the model is a deliberate\n * deployer decision; the trust tier the model declares when creating or updating a record\n * is honoured verbatim by the persistence layer. The deployer is responsible for choosing\n * whether to register all four tools, only the read-only `list_retrievables`, or any subset\n * thereof — that registration choice is exactly the trust boundary documented in the\n * Retrievable battery contract.\n *\n * Output is JSON for every tool so consumers can parse the result without re-tokenising —\n * the artifact constructor is set to {@link @nhtio/adk!SpooledJsonArtifact}.\n *\n * Tools:\n * - {@link listRetrievablesTool} — read-only list of every retrievable currently held by\n *   the context.\n * - {@link storeRetrievableTool} — create a new retrievable record (auto-generates `id` /\n *   `createdAt` / `updatedAt` unless explicit values are supplied).\n * - {@link updateRetrievableTool} — replace an existing retrievable by `id`. Bumps\n *   `updatedAt`.\n * - {@link deleteRetrievableTool} — remove a retrievable by `id`.\n */\n\nimport { DateTime } from 'luxon'\nimport { v6 as uuidv6 } from 'uuid'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\nimport { Retrievable, SpooledJsonArtifact, Tool } from '@nhtio/adk/common'\n\nconst TRUST_TIERS = ['first-party', 'third-party-public', 'third-party-private'] as const\ntype TrustTier = (typeof TRUST_TIERS)[number]\n\nconst serialiseRetrievable = (r: Retrievable): Record<string, unknown> => ({\n  id: r.id,\n  content: r.content.toString(),\n  trustTier: r.trustTier,\n  source: r.source,\n  kind: r.kind,\n  score: r.score,\n  createdAt: r.createdAt.toISO(),\n  updatedAt: r.updatedAt.toISO(),\n})\n\n/**\n * List every retrievable record currently held by the active execution context.\n *\n * @remarks\n * Delegates to `ctx.fetchRetrievables()`. Returns a JSON-encoded array of retrievable records\n * (id, content, trustTier, source, kind, score, createdAt, updatedAt).\n */\nexport const listRetrievablesTool = new Tool({\n  name: 'list_retrievables',\n  description:\n    'List every retrievable record currently available to the agent. Returns a JSON array of records with id, content, trustTier, source, kind, score, createdAt, and updatedAt.',\n  inputSchema: validator.object({}),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (_args, ctx) => {\n    try {\n      const retrievables = await ctx.fetchRetrievables()\n      return JSON.stringify(retrievables.map(serialiseRetrievable), null, 2)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Create a new {@link @nhtio/adk!Retrievable} record and persist it via the context's `storeRetrievable`\n * callback.\n *\n * @remarks\n * When `id` is omitted, a UUID v6 is generated. When `createdAt` / `updatedAt` are omitted,\n * the current time is used. The model must declare `trustTier` explicitly — there is no\n * default; the choice is consciously the model's, exposed by the deployer's decision to\n * register this tool.\n */\nexport const storeRetrievableTool = new Tool({\n  name: 'store_retrievable',\n  description:\n    \"Store a new retrievable (RAG) record. The trustTier MUST be one of 'first-party' (deployer-vetted), 'third-party-public' (open-web), or 'third-party-private' (user uploads). id and timestamps are auto-generated if omitted.\",\n  inputSchema: validator.object({\n    content: validator\n      .string()\n      .required()\n      .description('The retrievable content as a plain string.'),\n    trustTier: validator\n      .string()\n      .valid(...TRUST_TIERS)\n      .required()\n      .description(\n        \"Trust tier: 'first-party' for deployer-vetted material, 'third-party-public' for open-web or public APIs, 'third-party-private' for user uploads or partner APIs.\"\n      ),\n    source: validator\n      .string()\n      .optional()\n      .description('Optional provenance string: URL, document path, KB id, etc.'),\n    kind: validator\n      .string()\n      .optional()\n      .description(\"Optional semantic label: 'policy', 'reference', 'web-page', 'pdf', etc.\"),\n    score: validator\n      .number()\n      .min(0)\n      .max(1)\n      .optional()\n      .description('Optional relevance / similarity score in [0, 1].'),\n    id: validator\n      .string()\n      .optional()\n      .description('Optional stable id. Auto-generated when absent.'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (args, ctx) => {\n    const { content, trustTier, source, kind, score, id } = args as {\n      content: string\n      trustTier: TrustTier\n      source?: string\n      kind?: string\n      score?: number\n      id?: string\n    }\n    try {\n      const now = DateTime.now()\n      const retrievable = new Retrievable({\n        id: id ?? uuidv6(),\n        content,\n        trustTier,\n        source,\n        kind,\n        score,\n        createdAt: now,\n        updatedAt: now,\n      })\n      await ctx.storeRetrievable(retrievable)\n      return JSON.stringify({ ok: true, retrievable: serialiseRetrievable(retrievable) }, null, 2)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Replace an existing {@link @nhtio/adk!Retrievable} by `id`.\n *\n * @remarks\n * The model supplies `id` plus any subset of `content` / `trustTier` / `source` / `kind` /\n * `score`; omitted fields retain their prior values. `updatedAt` is always bumped;\n * `createdAt` is preserved. Returns an error when no retrievable with the supplied `id` is\n * found.\n */\nexport const updateRetrievableTool = new Tool({\n  name: 'update_retrievable',\n  description:\n    'Update an existing retrievable by id. Supply any subset of content / trustTier / source / kind / score — omitted fields retain their prior values. updatedAt is always refreshed.',\n  inputSchema: validator.object({\n    id: validator.string().required().description('Id of the retrievable to update.'),\n    content: validator.string().optional().description('Replacement content.'),\n    trustTier: validator\n      .string()\n      .valid(...TRUST_TIERS)\n      .optional()\n      .description('Replacement trust tier.'),\n    source: validator.string().optional().description('Replacement provenance string.'),\n    kind: validator.string().optional().description('Replacement semantic label.'),\n    score: validator.number().min(0).max(1).optional().description('Replacement score in [0, 1].'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (args, ctx) => {\n    const { id, content, trustTier, source, kind, score } = args as {\n      id: string\n      content?: string\n      trustTier?: TrustTier\n      source?: string\n      kind?: string\n      score?: number\n    }\n    try {\n      const retrievables = await ctx.fetchRetrievables()\n      const existing = retrievables.find((r) => r.id === id)\n      if (!existing) {\n        return `Error: No retrievable found with id \"${id}\".`\n      }\n      const updated = new Retrievable({\n        id: existing.id,\n        content: content ?? existing.content,\n        trustTier: trustTier ?? existing.trustTier,\n        source: source ?? existing.source,\n        kind: kind ?? existing.kind,\n        score: score ?? existing.score,\n        createdAt: existing.createdAt,\n        updatedAt: DateTime.now(),\n      })\n      await ctx.mutateRetrievable(updated)\n      return JSON.stringify({ ok: true, retrievable: serialiseRetrievable(updated) }, null, 2)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Remove an existing {@link @nhtio/adk!Retrievable} by `id`.\n *\n * @remarks\n * Delegates to `ctx.deleteRetrievable(id)`. Returns `{ ok: true, id }` on success regardless\n * of whether a retrievable was actually present — `deleteRetrievable` is idempotent at the\n * ADK level.\n */\nexport const deleteRetrievableTool = new Tool({\n  name: 'delete_retrievable',\n  description: 'Delete a retrievable by id.',\n  inputSchema: validator.object({\n    id: validator.string().required().description('Id of the retrievable to delete.'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (args, ctx) => {\n    const { id } = args as { id: string }\n    try {\n      await ctx.deleteRetrievable(id)\n      return JSON.stringify({ ok: true, id }, null, 2)\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Convenience tuple of every retrievable CRUD tool. Spread into a {@link @nhtio/adk!ToolRegistry} to\n * register the entire category at once.\n */\nexport const retrievableTools = [\n  listRetrievablesTool,\n  storeRetrievableTool,\n  updateRetrievableTool,\n  deleteRetrievableTool,\n] as const\n"],"mappings":"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"}