@nhtio/adk 0.1.0-master-463eb577 → 0.1.0-master-44ebe1d2

package/batteries/tools/math.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"math.mjs","names":[],"sources":["../../../src/batteries/tools/math/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for safe arithmetic, expression evaluation, and numeric operations.\n *\n * @module @nhtio/adk/batteries/tools/math\n *\n * @remarks\n * Pre-constructed bundled tools for the `math` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { create, all } from 'mathjs'\nimport { Tool } from '@nhtio/adk/common'\nimport { isError } from '@nhtio/adk/guards'\nimport { validator } from '@nhtio/validation'\n\nconst math = create(all)\n\nconst BLOCKED_FUNCTIONS = [\n  'import',\n  'createUnit',\n  'simplify',\n  'derivative',\n  'compile',\n  'chain',\n  'reviver',\n  'replacer',\n]\n\nfor (const fn of BLOCKED_FUNCTIONS) {\n  if (fn in math) {\n    ;(math as any)[fn] = undefined\n  }\n}\n\nconst MAX_EXPRESSION_LENGTH = 1000\n\nfunction validateExpression(expr: string): string | undefined {\n  if (expr.length > MAX_EXPRESSION_LENGTH) {\n    return `Expression too long (max ${MAX_EXPRESSION_LENGTH} characters).`\n  }\n  return undefined\n}\n\n/**\n * Convert common LaTeX/KaTeX notation to a mathjs-evaluable expression.\n */\nfunction latexToMathjs(latex: string): string {\n  let expr = latex.trim()\n\n  expr = expr.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  expr = expr.replace(/^\\\\[[(]|\\\\[\\])]$/g, '')\n\n  for (let i = 0; i < 10; i++) {\n    const before = expr\n    expr = expr.replace(/\\\\frac\\s*\\{([^{}]*)\\}\\s*\\{([^{}]*)\\}/g, '(($1)/($2))')\n    if (expr === before) break\n  }\n\n  expr = expr.replace(/\\\\sqrt\\[([^\\]]+)\\]\\s*\\{([^{}]*)\\}/g, 'nthRoot($2, $1)')\n  expr = expr.replace(/\\\\sqrt\\s*\\{([^{}]*)\\}/g, 'sqrt($1)')\n\n  expr = expr.replace(\n    /\\\\(sin|cos|tan|cot|sec|csc|arcsin|arccos|arctan|sinh|cosh|tanh|ln|log|exp|abs|det)/g,\n    '$1'\n  )\n\n  expr = expr.replace(/log_\\{?(\\w+)\\}?\\s*\\(([^)]+)\\)/g, 'log($2, $1)')\n  expr = expr.replace(/\\^{([^{}]*)}/g, '^($1)')\n  expr = expr.replace(/_\\{[^{}]*\\}/g, '')\n  expr = expr.replace(/_\\w/g, '')\n\n  expr = expr.replace(/\\\\pi/g, 'pi')\n  expr = expr.replace(\n    /\\\\(alpha|beta|gamma|delta|epsilon|theta|lambda|mu|sigma|tau|phi|omega)/g,\n    '$1'\n  )\n\n  expr = expr.replace(/\\\\cdot/g, '*')\n  expr = expr.replace(/\\\\times/g, '*')\n  expr = expr.replace(/\\\\div/g, '/')\n  expr = expr.replace(/\\\\infty/g, 'Infinity')\n  expr = expr.replace(/\\\\left\\s*([([{|])/g, '$1')\n  expr = expr.replace(/\\\\right\\s*([)\\]}|])/g, '$1')\n  expr = expr.replace(/\\\\sum/g, 'sum')\n  expr = expr.replace(/\\\\prod/g, 'prod')\n  expr = expr.replace(/\\\\,/g, ' ')\n  expr = expr.replace(/\\\\;/g, ' ')\n  expr = expr.replace(/\\\\quad/g, ' ')\n  expr = expr.replace(/\\\\qquad/g, ' ')\n  expr = expr.replace(/\\\\text\\{([^{}]*)\\}/g, '')\n  expr = expr.replace(/(\\d)([a-zA-Z(])/g, '$1*$2')\n  expr = expr.replace(/\\)\\s*\\(/g, ')*(')\n  expr = expr.replace(/\\s+/g, ' ').trim()\n\n  return expr\n}\n\n/**\n * Evaluates a mathjs-syntax expression and returns the numeric result alongside the KaTeX\n * representation of the parsed expression.\n *\n * @remarks\n * Supports arithmetic, trigonometric, logarithmic, exponential, factorial, matrix, and unit\n * operations via `mathjs`. The mathjs instance is hardened: dangerous functions (`import`,\n * `createUnit`, `simplify`, `derivative`, `compile`, `chain`, `reviver`, `replacer`) are\n * disabled to prevent interpreter-surface exposure.\n *\n * Expressions over 1000 characters are rejected with an error string (not thrown). Parse and\n * evaluation errors are also returned as error strings — the tool surfaces math errors as\n * content rather than exceptions, so the model can react to them in-line.\n */\nexport const calculateTool = new Tool({\n  name: 'calculate',\n  description:\n    'Evaluate a math expression. Supports arithmetic, trig, log, sqrt, factorial, matrices.',\n  inputSchema: validator.object({\n    expression: validator.string().required().description('Math expression, e.g. \"sin(pi/4) + 5!\"'),\n  }),\n  handler: async (args) => {\n    const { expression } = args as { expression: string }\n\n    const lengthError = validateExpression(expression)\n    if (lengthError) return lengthError\n\n    try {\n      const result = math.evaluate!(expression)\n      const node = math.parse!(expression)\n      const katex = node.toTex()\n      return `Result: ${result}\\nKaTeX: $${katex} = ${result}$`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Translates a LaTeX/KaTeX expression into mathjs syntax, evaluates it, and returns the result.\n *\n * @remarks\n * Translates common LaTeX constructs (`\\frac{a}{b}`, `\\sqrt{...}`, `\\cdot`, `\\times`, Greek\n * macros like `\\pi`, `\\left`/`\\right` delimiters, `\\text{...}`, subscripts, etc.) into their\n * mathjs equivalents before evaluation. Both the source and the translated mathjs expression\n * are subject to the 1000-character length cap.\n *\n * Parse and evaluation errors are returned as error strings rather than thrown.\n */\nexport const evaluateKatexTool = new Tool({\n  name: 'evaluate_katex',\n  description: 'Evaluate a KaTeX/LaTeX math expression and return the numeric result.',\n  inputSchema: validator.object({\n    katex: validator\n      .string()\n      .required()\n      .description('LaTeX expression, e.g. \"\\\\frac{1}{2} + \\\\sqrt{9}\"'),\n  }),\n  handler: async (args) => {\n    const { katex } = args as { katex: string }\n\n    const lengthError = validateExpression(katex)\n    if (lengthError) return lengthError\n\n    try {\n      const mathjsExpr = latexToMathjs(katex)\n\n      const translatedLengthError = validateExpression(mathjsExpr)\n      if (translatedLengthError) return translatedLengthError\n\n      const result = math.evaluate!(mathjsExpr)\n      return `Converted: ${mathjsExpr}\\nResult: ${result}`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"math.mjs","names":[],"sources":["../../../src/batteries/tools/math/index.ts"],"sourcesContent":["/**\n * Pre-constructed tools for safe arithmetic, expression evaluation, and numeric operations.\n *\n * @module @nhtio/adk/batteries/tools/math\n *\n * @remarks\n * Pre-constructed bundled tools for the `math` category. Import individually, the whole\n * category, or import every tool via `@nhtio/adk/batteries`.\n */\n\nimport { create, all } from 'mathjs'\nimport { Tool } from '@nhtio/adk/common'\nimport { validator } from '@nhtio/validation'\nimport { isError, isInstanceOf } from '@nhtio/adk/guards'\n\nconst math = create(all)\n\nconst BLOCKED_FUNCTIONS = [\n  'import',\n  'createUnit',\n  'simplify',\n  'derivative',\n  'compile',\n  'chain',\n  'reviver',\n  'replacer',\n]\n\nfor (const fn of BLOCKED_FUNCTIONS) {\n  if (fn in math) {\n    ;(math as any)[fn] = undefined\n  }\n}\n\nconst MAX_EXPRESSION_LENGTH = 1000\n\nfunction validateExpression(expr: string): string | undefined {\n  if (expr.length > MAX_EXPRESSION_LENGTH) {\n    return `Expression too long (max ${MAX_EXPRESSION_LENGTH} characters).`\n  }\n  return undefined\n}\n\n/**\n * Convert common LaTeX/KaTeX notation to a mathjs-evaluable expression.\n */\nfunction latexToMathjs(latex: string): string {\n  let expr = latex.trim()\n\n  expr = expr.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  expr = expr.replace(/^\\\\[[(]|\\\\[\\])]$/g, '')\n\n  for (let i = 0; i < 10; i++) {\n    const before = expr\n    expr = expr.replace(/\\\\frac\\s*\\{([^{}]*)\\}\\s*\\{([^{}]*)\\}/g, '(($1)/($2))')\n    if (expr === before) break\n  }\n\n  expr = expr.replace(/\\\\sqrt\\[([^\\]]+)\\]\\s*\\{([^{}]*)\\}/g, 'nthRoot($2, $1)')\n  expr = expr.replace(/\\\\sqrt\\s*\\{([^{}]*)\\}/g, 'sqrt($1)')\n\n  // Inverse trig: mathjs spells these asin/acos/atan, not arcsin/arccos/arctan.\n  expr = expr.replace(/\\\\arcsin/g, 'asin')\n  expr = expr.replace(/\\\\arccos/g, 'acos')\n  expr = expr.replace(/\\\\arctan/g, 'atan')\n\n  expr = expr.replace(/\\\\(sin|cos|tan|cot|sec|csc|sinh|cosh|tanh|ln|log|exp|abs|det)/g, '$1')\n\n  expr = expr.replace(/log_\\{?(\\w+)\\}?\\s*\\(([^)]+)\\)/g, 'log($2, $1)')\n  expr = expr.replace(/\\^{([^{}]*)}/g, '^($1)')\n  expr = expr.replace(/_\\{[^{}]*\\}/g, '')\n  expr = expr.replace(/_\\w/g, '')\n\n  expr = expr.replace(/\\\\pi/g, 'pi')\n  expr = expr.replace(\n    /\\\\(alpha|beta|gamma|delta|epsilon|theta|lambda|mu|sigma|tau|phi|omega)/g,\n    '$1'\n  )\n\n  expr = expr.replace(/\\\\cdot/g, '*')\n  expr = expr.replace(/\\\\times/g, '*')\n  expr = expr.replace(/\\\\div/g, '/')\n  expr = expr.replace(/\\\\infty/g, 'Infinity')\n  expr = expr.replace(/\\\\left\\s*([([{|])/g, '$1')\n  expr = expr.replace(/\\\\right\\s*([)\\]}|])/g, '$1')\n  expr = expr.replace(/\\\\sum/g, 'sum')\n  expr = expr.replace(/\\\\prod/g, 'prod')\n  expr = expr.replace(/\\\\,/g, ' ')\n  expr = expr.replace(/\\\\;/g, ' ')\n  expr = expr.replace(/\\\\quad/g, ' ')\n  expr = expr.replace(/\\\\qquad/g, ' ')\n  expr = expr.replace(/\\\\text\\{([^{}]*)\\}/g, '')\n  expr = expr.replace(/(\\d)([a-zA-Z(])/g, '$1*$2')\n  expr = expr.replace(/\\)\\s*\\(/g, ')*(')\n  expr = expr.replace(/\\s+/g, ' ').trim()\n\n  return expr\n}\n\n// ─── Numeric calculus ─────────────────────────────────────────────────────────\n//\n// `evaluate_katex` is a numeric evaluator. mathjs has no symbolic integration, and its symbolic\n// `derivative` is intentionally blocklisted above, so calculus is computed NUMERICALLY: definite\n// integrals via composite Simpson quadrature, derivatives via central finite differences, and limits\n// via a two-sided approach. These are approximations (correct to ~1e-9 for the smooth expressions a\n// model emits), surfaced under a `Result (numeric):` label so the distinction is explicit.\n//\n// Detection runs on the RAW LaTeX, before `latexToMathjs` flattens it — its subscript stripping\n// would otherwise destroy integral bounds (`\\int_{0}^{1}` → `\\int^(1)`) and limit targets. The\n// extracted sub-expressions (integrand, bounds, body, point) are then translated by the existing\n// `latexToMathjs` and evaluated per-point with a scope, which works under the security blocklist.\n\n/** A tagged error whose message is surfaced to the model verbatim (caught by {@link tryCalculus}). */\nclass CalculusError extends Error {}\n\n/** Evaluate a mathjs expression at a single point, guarding against non-finite results. */\nfunction evalAt(expr: string, varName: string, x: number): number {\n  const y = math.evaluate!(expr, { [varName]: x })\n  if (typeof y !== 'number' || !Number.isFinite(y)) {\n    throw new CalculusError('NON_FINITE')\n  }\n  return y\n}\n\n/** Composite Simpson's rule over a finite interval. Throws {@link CalculusError} on a singularity. */\nfunction simpson(fn: (x: number) => number, a: number, b: number, n = 1000): number {\n  if (n % 2 === 1) n++\n  const h = (b - a) / n\n  let sum = fn(a) + fn(b)\n  for (let i = 1; i < n; i++) {\n    sum += (i % 2 === 1 ? 4 : 2) * fn(a + i * h)\n  }\n  const result = (h / 3) * sum\n  if (!Number.isFinite(result)) throw new CalculusError('NON_FINITE')\n  return result\n}\n\n/** Round numeric output to 12 significant digits, collapsing floating-point noise. */\nfunction formatNumeric(n: number): string {\n  // Snap values that are zero-to-within-tolerance to exactly 0 (e.g. lim_{x->inf} 1/x ≈ 1e-8).\n  if (Math.abs(n) < 1e-9) return '0'\n  return math.format!(n, { precision: 12 })\n}\n\n/**\n * Reads a single `_`/`^` script starting at `i`, supporting braced (`_{0}`, `^{\\pi}`), command\n * (`^\\pi`), and bare-token (`_0`, `^1`) forms. Returns the mark, its raw-LaTeX value, and the next\n * index, or `null` when there is no script at `i`.\n */\nfunction readScript(s: string, i: number): { mark: '_' | '^'; val: string; next: number } | null {\n  while (s[i] === ' ') i++\n  const mark = s[i]\n  if (mark !== '_' && mark !== '^') return null\n  i++\n  while (s[i] === ' ') i++\n  if (s[i] === '{') {\n    let depth = 0\n    const start = ++i\n    for (; i < s.length; i++) {\n      if (s[i] === '{') depth++\n      else if (s[i] === '}') {\n        if (depth === 0) break\n        depth--\n      }\n    }\n    return { mark, val: s.slice(start, i), next: i + 1 }\n  }\n  if (s[i] === '\\\\') {\n    const m = /^\\\\[a-zA-Z]+/.exec(s.slice(i))\n    if (!m) return null\n    return { mark, val: m[0], next: i + m[0].length }\n  }\n  const m = /^[A-Za-z0-9.]+/.exec(s.slice(i))\n  if (!m) return null\n  return { mark, val: m[0], next: i + m[0].length }\n}\n\n/** Translate a raw-LaTeX bound/target fragment and evaluate it to a finite number. */\nfunction evalBound(latex: string): number {\n  const trimmed = latex.trim()\n  if (/\\\\infty/.test(trimmed)) throw new CalculusError('INFINITE_BOUND')\n  const mathjsExpr = latexToMathjs(trimmed)\n  const value = math.evaluate!(mathjsExpr)\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new CalculusError('BAD_BOUND')\n  }\n  return value\n}\n\n/** Evaluate a definite integral `\\int_{a}^{b} f \\,dx` by Simpson quadrature. */\nfunction evalIntegral(s: string): string {\n  // Strip the operator (\\int, optionally with \\limits).\n  const m = /\\\\int(?:\\\\limits)?/.exec(s)\n  if (!m) throw new CalculusError('NOT_INTEGRAL')\n  let i = m.index + m[0].length\n\n  // Read up to two scripts (bounds), in either order.\n  const scripts: Record<'_' | '^', string | undefined> = { '_': undefined, '^': undefined }\n  for (let k = 0; k < 2; k++) {\n    const sc = readScript(s, i)\n    if (!sc) break\n    scripts[sc.mark] = sc.val\n    i = sc.next\n  }\n  if (scripts._ === undefined || scripts['^'] === undefined) {\n    throw new CalculusError('INDEFINITE')\n  }\n\n  // The remainder is `integrand … d<var>`. Pull the trailing differential off the end.\n  const rest = s.slice(i)\n  const diff = /\\\\?,?\\s*\\bd\\s*([a-zA-Z])\\s*$/.exec(rest)\n  if (!diff) throw new CalculusError('NO_DIFFERENTIAL')\n  const variable = diff[1]\n  const integrandLatex = rest.slice(0, diff.index)\n  if (integrandLatex.trim().length === 0) throw new CalculusError('NO_INTEGRAND')\n\n  const a = evalBound(scripts._)\n  const b = evalBound(scripts['^'])\n  const integrand = latexToMathjs(integrandLatex)\n  const fn = (x: number) => evalAt(integrand, variable, x)\n\n  let result: number\n  if (a === b) result = 0\n  else if (a < b) result = simpson(fn, a, b)\n  else result = -simpson(fn, b, a)\n\n  return `Converted: ∫(${integrand}) d${variable} from ${formatNumeric(a)} to ${formatNumeric(b)}\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Evaluate a derivative `\\frac{d}{dx} f \\big|_{x=a}` at a point via central finite difference. */\nfunction evalDerivative(s: string): string {\n  // Operator + variable: \\frac{d}{dx} … or bare d/dx ….\n  let variable: string | undefined\n  let body = s\n  const fracOp = /\\\\frac\\s*\\{\\s*d\\s*\\}\\s*\\{\\s*d\\s*([a-zA-Z])\\s*\\}/.exec(s)\n  if (fracOp) {\n    variable = fracOp[1]\n    body = s.slice(fracOp.index + fracOp[0].length)\n  } else {\n    const bareOp = /(?:^|[^a-zA-Z])d\\s*\\/\\s*d([a-zA-Z])/.exec(s)\n    if (bareOp) {\n      variable = bareOp[1]\n      body = s.slice(bareOp.index + bareOp[0].length)\n    }\n  }\n  if (!variable) throw new CalculusError('NOT_DERIVATIVE')\n\n  // Remove pure \\left. / \\right. delimiters.\n  body = body.replace(/\\\\left\\.?/g, '').replace(/\\\\right\\.?/g, '')\n\n  // Evaluation bar + point at the end: …|_{x=3} (optionally \\Big| etc.).\n  const bar = /\\\\?(?:Big|big|bigg|Bigg)?\\s*\\|\\s*_\\s*\\{?\\s*([a-zA-Z])\\s*=\\s*([^}]+?)\\s*\\}?\\s*$/.exec(\n    body\n  )\n  if (!bar) throw new CalculusError('NO_POINT')\n  const point = evalBound(bar[2])\n  let fnLatex = body.slice(0, bar.index).trim()\n\n  // Strip one layer of wrapping parentheses/brackets around the function body.\n  fnLatex = fnLatex\n    .replace(/^\\\\?\\(([\\s\\S]*)\\\\?\\)$/, '$1')\n    .replace(/^\\[([\\s\\S]*)\\]$/, '$1')\n    .trim()\n  if (fnLatex.length === 0) throw new CalculusError('NO_FUNCTION')\n\n  const expr = latexToMathjs(fnLatex)\n  const h = 1e-6\n  const fn = (x: number) => evalAt(expr, variable, x)\n  const result = (fn(point + h) - fn(point - h)) / (2 * h)\n  if (!Number.isFinite(result)) throw new CalculusError('NON_FINITE')\n\n  return `Converted: d/d${variable}(${expr}) at ${variable}=${formatNumeric(point)}\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Evaluate a limit `\\lim_{x \\to a} f(x)` by a two-sided numeric approach. */\nfunction evalLimit(s: string): string {\n  const head = /\\\\lim\\s*_\\s*\\{\\s*([a-zA-Z])\\s*\\\\to\\s*([\\s\\S]+?)\\s*\\}/.exec(s)\n  if (!head) throw new CalculusError('NOT_LIMIT')\n  const variable = head[1]\n  let targetLatex = head[2].trim()\n  const bodyLatex = s.slice(head.index + head[0].length).trim()\n  if (bodyLatex.length === 0) throw new CalculusError('NO_FUNCTION')\n\n  // One-sided markers (0^+, 0^-, 0^{+}) — record the side, strip the marker.\n  let side: 'both' | 'plus' | 'minus' = 'both'\n  const oneSided = /\\^\\s*\\{?\\s*([+-])\\s*\\}?\\s*$/.exec(targetLatex)\n  if (oneSided) {\n    side = oneSided[1] === '+' ? 'plus' : 'minus'\n    targetLatex = targetLatex.slice(0, oneSided.index).trim()\n  }\n\n  const expr = latexToMathjs(bodyLatex)\n  const fn = (x: number) => evalAt(expr, variable, x)\n  const eps = 1e-6\n\n  // Infinite targets via large-magnitude substitution.\n  let result: number\n  let targetLabel: string\n  if (/^-\\s*\\\\infty$/.test(targetLatex)) {\n    result = fn(-1e8)\n    targetLabel = '-∞'\n  } else if (/^\\\\infty$/.test(targetLatex)) {\n    result = fn(1e8)\n    targetLabel = '∞'\n  } else {\n    const target = evalBound(targetLatex)\n    targetLabel = formatNumeric(target)\n    if (side === 'plus') {\n      result = fn(target + eps)\n    } else if (side === 'minus') {\n      result = fn(target - eps)\n    } else {\n      const lo = fn(target - eps)\n      const hi = fn(target + eps)\n      const avg = (lo + hi) / 2\n      if (Math.abs(hi - lo) > 1e-3 * Math.max(1, Math.abs(avg))) {\n        throw new CalculusError('LIMIT_MISMATCH')\n      }\n      result = avg\n    }\n  }\n  if (!Number.isFinite(result)) throw new CalculusError('LIMIT_UNBOUNDED')\n\n  // Infinite-target substitution (±1e8) and the eps offset leave more residue than Simpson or the\n  // derivative difference, so snap a limit result to a nearby round value before formatting:\n  // 0.99999998 → 1, 1e-8 → 0. The tolerance is loose enough to absorb the substitution error yet\n  // far tighter than the divergence check that already rejected genuinely non-convergent limits.\n  const nearest = Math.round(result)\n  if (Math.abs(result - nearest) < 1e-6) result = nearest\n\n  return `Converted: lim ${variable}→${targetLabel} of (${expr})\\nResult (numeric): ${formatNumeric(result)}`\n}\n\n/** Human-readable, model-actionable message for each {@link CalculusError} tag. */\nfunction calculusErrorMessage(tag: string): string {\n  switch (tag) {\n    case 'INDEFINITE':\n      return 'Cannot evaluate an indefinite integral numerically. Provide bounds, e.g. \\\\int_{0}^{1} x dx.'\n    case 'NO_DIFFERENTIAL':\n      return \"Could not find the integration variable. Expected a trailing differential like 'dx'.\"\n    case 'NO_INTEGRAND':\n      return 'The integral has no integrand to evaluate.'\n    case 'INFINITE_BOUND':\n      return 'Infinite integration bounds are not supported. Provide finite numeric bounds, e.g. \\\\int_{0}^{1} f dx.'\n    case 'BAD_BOUND':\n      return 'Could not evaluate the integration bounds to numbers.'\n    case 'NO_POINT':\n      return 'Cannot evaluate a derivative numerically without a point. Specify where, e.g. \\\\frac{d}{dx}(x^2)\\\\Big|_{x=3}.'\n    case 'NO_FUNCTION':\n      return 'Could not find the function to evaluate.'\n    case 'LIMIT_MISMATCH':\n      return 'The limit may not exist (left and right values disagree).'\n    case 'LIMIT_UNBOUNDED':\n      return 'The limit appears to diverge (function is unbounded near the target).'\n    case 'NON_FINITE':\n      return 'The expression is not finite over the requested range (possible singularity); cannot evaluate numerically.'\n    default:\n      return 'Could not evaluate the calculus expression.'\n  }\n}\n\n/**\n * Detects a calculus construct in raw LaTeX and routes it to the matching numeric handler. Returns\n * the result/error string, or `null` when the input is not a calculus expression (so the caller\n * falls through to the scalar evaluation path unchanged).\n */\nfunction tryCalculus(latex: string): string | null {\n  let s = latex.trim()\n  s = s.replace(/^\\$\\$?|\\$\\$?$/g, '')\n  s = s.replace(/^\\\\[[(]|\\\\[\\])]$/g, '').trim()\n\n  let handler: ((expr: string) => string) | undefined\n  if (/\\\\int/.test(s)) handler = evalIntegral\n  else if (/\\\\lim/.test(s)) handler = evalLimit\n  else if (\n    /\\\\frac\\s*\\{\\s*d\\s*\\}\\s*\\{\\s*d\\s*[a-zA-Z]\\s*\\}/.test(s) ||\n    /(?:^|[^a-zA-Z])d\\s*\\/\\s*d[a-zA-Z]/.test(s)\n  )\n    handler = evalDerivative\n  if (!handler) return null\n\n  try {\n    return handler(s)\n  } catch (err) {\n    if (isInstanceOf(err, 'CalculusError', CalculusError)) {\n      return `Error: ${calculusErrorMessage(err.message)}`\n    }\n    return `Error: ${isError(err) ? err.message : String(err)}`\n  }\n}\n\n/**\n * Evaluates a mathjs-syntax expression and returns the numeric result alongside the KaTeX\n * representation of the parsed expression.\n *\n * @remarks\n * Supports arithmetic, trigonometric, logarithmic, exponential, factorial, matrix, and unit\n * operations via `mathjs`. The mathjs instance is hardened: dangerous functions (`import`,\n * `createUnit`, `simplify`, `derivative`, `compile`, `chain`, `reviver`, `replacer`) are\n * disabled to prevent interpreter-surface exposure.\n *\n * Expressions over 1000 characters are rejected with an error string (not thrown). Parse and\n * evaluation errors are also returned as error strings — the tool surfaces math errors as\n * content rather than exceptions, so the model can react to them in-line.\n */\nexport const calculateTool = new Tool({\n  name: 'calculate',\n  description:\n    'Evaluate a math expression. Supports arithmetic, trig, log, sqrt, factorial, matrices.',\n  inputSchema: validator.object({\n    expression: validator.string().required().description('Math expression, e.g. \"sin(pi/4) + 5!\"'),\n  }),\n  handler: async (args) => {\n    const { expression } = args as { expression: string }\n\n    const lengthError = validateExpression(expression)\n    if (lengthError) return lengthError\n\n    try {\n      const result = math.evaluate!(expression)\n      const node = math.parse!(expression)\n      const katex = node.toTex()\n      return `Result: ${result}\\nKaTeX: $${katex} = ${result}$`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n\n/**\n * Translates a LaTeX/KaTeX expression into mathjs syntax, evaluates it, and returns the result.\n *\n * @remarks\n * Translates common LaTeX constructs (`\\frac{a}{b}`, `\\sqrt{...}`, `\\cdot`, `\\times`, Greek\n * macros like `\\pi`, inverse trig `\\arcsin`/`\\arccos`/`\\arctan`, `\\left`/`\\right` delimiters,\n * `\\text{...}`, subscripts, etc.) into their mathjs equivalents before evaluation. Both the source\n * and the translated mathjs expression are subject to the 1000-character length cap.\n *\n * Also evaluates three calculus constructs **numerically** (mathjs has no symbolic integration, and\n * its symbolic `derivative` is blocklisted here for safety):\n * - Definite integrals — `\\int_{a}^{b} f \\,dx` via composite Simpson quadrature.\n * - Derivatives at a point — `\\frac{d}{dx} f \\big|_{x=a}` via central finite difference.\n * - Limits — `\\lim_{x \\to a} f` (including `a = \\pm\\infty`) via a two-sided numeric approach.\n *\n * Numeric results are rounded with `math.format(..., { precision: 12 })` and labelled\n * `Result (numeric):` to flag that they are approximations. Constructs that cannot be evaluated\n * numerically (indefinite integrals, derivatives without a point, infinite integration bounds,\n * singular integrands, divergent limits) return a specific, guiding error string.\n *\n * Parse and evaluation errors are returned as error strings rather than thrown.\n */\nexport const evaluateKatexTool = new Tool({\n  name: 'evaluate_katex',\n  description:\n    'Evaluate a KaTeX/LaTeX math expression and return the numeric result. Supports arithmetic, trig, logs, roots, and numeric calculus: definite integrals (\\\\int_{a}^{b} f dx), derivatives at a point (\\\\frac{d}{dx} f|_{x=a}), and limits (\\\\lim_{x \\\\to a} f).',\n  inputSchema: validator.object({\n    katex: validator\n      .string()\n      .required()\n      .description('LaTeX expression, e.g. \"\\\\frac{1}{2} + \\\\sqrt{9}\" or \"\\\\int_{0}^{1} x^2 dx\"'),\n  }),\n  handler: async (args) => {\n    const { katex } = args as { katex: string }\n\n    const lengthError = validateExpression(katex)\n    if (lengthError) return lengthError\n\n    try {\n      // Calculus (\\int, \\lim, d/dx) is detected on the raw LaTeX and evaluated numerically before\n      // the scalar flattening path, which would otherwise mangle bounds/targets. Returns null for\n      // non-calculus input, falling through to the scalar evaluator below unchanged.\n      const calculus = tryCalculus(katex)\n      if (calculus !== null) return calculus\n\n      const mathjsExpr = latexToMathjs(katex)\n\n      const translatedLengthError = validateExpression(mathjsExpr)\n      if (translatedLengthError) return translatedLengthError\n\n      const result = math.evaluate!(mathjsExpr)\n      return `Converted: ${mathjsExpr}\\nResult: ${result}`\n    } catch (err) {\n      return `Error: ${isError(err) ? err.message : String(err)}`\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,IAAM,OAAO,OAAO,GAAG;AAavB,KAAK,MAAM,MAAM;CAVf;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AAGe,GACf,IAAI,MAAM,MACP,KAAc,MAAM,KAAA;AAIzB,IAAM,wBAAwB;AAE9B,SAAS,mBAAmB,MAAkC;CAC5D,IAAI,KAAK,SAAS,uBAChB,OAAO,4BAA4B,sBAAsB;AAG7D;;;;AAKA,SAAS,cAAc,OAAuB;CAC5C,IAAI,OAAO,MAAM,KAAK;CAEtB,OAAO,KAAK,QAAQ,kBAAkB,EAAE;CACxC,OAAO,KAAK,QAAQ,qBAAqB,EAAE;CAE3C,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC3B,MAAM,SAAS;EACf,OAAO,KAAK,QAAQ,yCAAyC,aAAa;EAC1E,IAAI,SAAS,QAAQ;CACvB;CAEA,OAAO,KAAK,QAAQ,sCAAsC,iBAAiB;CAC3E,OAAO,KAAK,QAAQ,0BAA0B,UAAU;CAGxD,OAAO,KAAK,QAAQ,aAAa,MAAM;CACvC,OAAO,KAAK,QAAQ,aAAa,MAAM;CACvC,OAAO,KAAK,QAAQ,aAAa,MAAM;CAEvC,OAAO,KAAK,QAAQ,kEAAkE,IAAI;CAE1F,OAAO,KAAK,QAAQ,kCAAkC,aAAa;CACnE,OAAO,KAAK,QAAQ,iBAAiB,OAAO;CAC5C,OAAO,KAAK,QAAQ,gBAAgB,EAAE;CACtC,OAAO,KAAK,QAAQ,QAAQ,EAAE;CAE9B,OAAO,KAAK,QAAQ,SAAS,IAAI;CACjC,OAAO,KAAK,QACV,2EACA,IACF;CAEA,OAAO,KAAK,QAAQ,WAAW,GAAG;CAClC,OAAO,KAAK,QAAQ,YAAY,GAAG;CACnC,OAAO,KAAK,QAAQ,UAAU,GAAG;CACjC,OAAO,KAAK,QAAQ,YAAY,UAAU;CAC1C,OAAO,KAAK,QAAQ,sBAAsB,IAAI;CAC9C,OAAO,KAAK,QAAQ,wBAAwB,IAAI;CAChD,OAAO,KAAK,QAAQ,UAAU,KAAK;CACnC,OAAO,KAAK,QAAQ,WAAW,MAAM;CACrC,OAAO,KAAK,QAAQ,QAAQ,GAAG;CAC/B,OAAO,KAAK,QAAQ,QAAQ,GAAG;CAC/B,OAAO,KAAK,QAAQ,WAAW,GAAG;CAClC,OAAO,KAAK,QAAQ,YAAY,GAAG;CACnC,OAAO,KAAK,QAAQ,uBAAuB,EAAE;CAC7C,OAAO,KAAK,QAAQ,oBAAoB,OAAO;CAC/C,OAAO,KAAK,QAAQ,YAAY,KAAK;CACrC,OAAO,KAAK,QAAQ,QAAQ,GAAG,EAAE,KAAK;CAEtC,OAAO;AACT;;AAgBA,IAAM,gBAAN,cAA4B,MAAM,CAAC;;AAGnC,SAAS,OAAO,MAAc,SAAiB,GAAmB;CAChE,MAAM,IAAI,KAAK,SAAU,MAAM,GAAG,UAAU,EAAE,CAAC;CAC/C,IAAI,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC,GAC7C,MAAM,IAAI,cAAc,YAAY;CAEtC,OAAO;AACT;;AAGA,SAAS,QAAQ,IAA2B,GAAW,GAAW,IAAI,KAAc;CAClF,IAAI,IAAI,MAAM,GAAG;CACjB,MAAM,KAAK,IAAI,KAAK;CACpB,IAAI,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC;CACtB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KACrB,QAAQ,IAAI,MAAM,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC;CAE7C,MAAM,SAAU,IAAI,IAAK;CACzB,IAAI,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,cAAc,YAAY;CAClE,OAAO;AACT;;AAGA,SAAS,cAAc,GAAmB;CAExC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,OAAO;CAC/B,OAAO,KAAK,OAAQ,GAAG,EAAE,WAAW,GAAG,CAAC;AAC1C;;;;;;AAOA,SAAS,WAAW,GAAW,GAAkE;CAC/F,OAAO,EAAE,OAAO,KAAK;CACrB,MAAM,OAAO,EAAE;CACf,IAAI,SAAS,OAAO,SAAS,KAAK,OAAO;CACzC;CACA,OAAO,EAAE,OAAO,KAAK;CACrB,IAAI,EAAE,OAAO,KAAK;EAChB,IAAI,QAAQ;EACZ,MAAM,QAAQ,EAAE;EAChB,OAAO,IAAI,EAAE,QAAQ,KACnB,IAAI,EAAE,OAAO,KAAK;OACb,IAAI,EAAE,OAAO,KAAK;GACrB,IAAI,UAAU,GAAG;GACjB;EACF;EAEF,OAAO;GAAE;GAAM,KAAK,EAAE,MAAM,OAAO,CAAC;GAAG,MAAM,IAAI;EAAE;CACrD;CACA,IAAI,EAAE,OAAO,MAAM;EACjB,MAAM,IAAI,eAAe,KAAK,EAAE,MAAM,CAAC,CAAC;EACxC,IAAI,CAAC,GAAG,OAAO;EACf,OAAO;GAAE;GAAM,KAAK,EAAE;GAAI,MAAM,IAAI,EAAE,GAAG;EAAO;CAClD;CACA,MAAM,IAAI,iBAAiB,KAAK,EAAE,MAAM,CAAC,CAAC;CAC1C,IAAI,CAAC,GAAG,OAAO;CACf,OAAO;EAAE;EAAM,KAAK,EAAE;EAAI,MAAM,IAAI,EAAE,GAAG;CAAO;AAClD;;AAGA,SAAS,UAAU,OAAuB;CACxC,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,UAAU,KAAK,OAAO,GAAG,MAAM,IAAI,cAAc,gBAAgB;CACrE,MAAM,aAAa,cAAc,OAAO;CACxC,MAAM,QAAQ,KAAK,SAAU,UAAU;CACvC,IAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GACrD,MAAM,IAAI,cAAc,WAAW;CAErC,OAAO;AACT;;AAGA,SAAS,aAAa,GAAmB;CAEvC,MAAM,IAAI,qBAAqB,KAAK,CAAC;CACrC,IAAI,CAAC,GAAG,MAAM,IAAI,cAAc,cAAc;CAC9C,IAAI,IAAI,EAAE,QAAQ,EAAE,GAAG;CAGvB,MAAM,UAAiD;EAAE,KAAK,KAAA;EAAW,KAAK,KAAA;CAAU;CACxF,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,KAAK,WAAW,GAAG,CAAC;EAC1B,IAAI,CAAC,IAAI;EACT,QAAQ,GAAG,QAAQ,GAAG;EACtB,IAAI,GAAG;CACT;CACA,IAAI,QAAQ,MAAM,KAAA,KAAa,QAAQ,SAAS,KAAA,GAC9C,MAAM,IAAI,cAAc,YAAY;CAItC,MAAM,OAAO,EAAE,MAAM,CAAC;CACtB,MAAM,OAAO,+BAA+B,KAAK,IAAI;CACrD,IAAI,CAAC,MAAM,MAAM,IAAI,cAAc,iBAAiB;CACpD,MAAM,WAAW,KAAK;CACtB,MAAM,iBAAiB,KAAK,MAAM,GAAG,KAAK,KAAK;CAC/C,IAAI,eAAe,KAAK,EAAE,WAAW,GAAG,MAAM,IAAI,cAAc,cAAc;CAE9E,MAAM,IAAI,UAAU,QAAQ,CAAC;CAC7B,MAAM,IAAI,UAAU,QAAQ,IAAI;CAChC,MAAM,YAAY,cAAc,cAAc;CAC9C,MAAM,MAAM,MAAc,OAAO,WAAW,UAAU,CAAC;CAEvD,IAAI;CACJ,IAAI,MAAM,GAAG,SAAS;MACjB,IAAI,IAAI,GAAG,SAAS,QAAQ,IAAI,GAAG,CAAC;MACpC,SAAS,CAAC,QAAQ,IAAI,GAAG,CAAC;CAE/B,OAAO,gBAAgB,UAAU,KAAK,SAAS,QAAQ,cAAc,CAAC,EAAE,MAAM,cAAc,CAAC,EAAE,sBAAsB,cAAc,MAAM;AAC3I;;AAGA,SAAS,eAAe,GAAmB;CAEzC,IAAI;CACJ,IAAI,OAAO;CACX,MAAM,SAAS,kDAAkD,KAAK,CAAC;CACvE,IAAI,QAAQ;EACV,WAAW,OAAO;EAClB,OAAO,EAAE,MAAM,OAAO,QAAQ,OAAO,GAAG,MAAM;CAChD,OAAO;EACL,MAAM,SAAS,sCAAsC,KAAK,CAAC;EAC3D,IAAI,QAAQ;GACV,WAAW,OAAO;GAClB,OAAO,EAAE,MAAM,OAAO,QAAQ,OAAO,GAAG,MAAM;EAChD;CACF;CACA,IAAI,CAAC,UAAU,MAAM,IAAI,cAAc,gBAAgB;CAGvD,OAAO,KAAK,QAAQ,cAAc,EAAE,EAAE,QAAQ,eAAe,EAAE;CAG/D,MAAM,MAAM,iFAAiF,KAC3F,IACF;CACA,IAAI,CAAC,KAAK,MAAM,IAAI,cAAc,UAAU;CAC5C,MAAM,QAAQ,UAAU,IAAI,EAAE;CAC9B,IAAI,UAAU,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,KAAK;CAG5C,UAAU,QACP,QAAQ,yBAAyB,IAAI,EACrC,QAAQ,mBAAmB,IAAI,EAC/B,KAAK;CACR,IAAI,QAAQ,WAAW,GAAG,MAAM,IAAI,cAAc,aAAa;CAE/D,MAAM,OAAO,cAAc,OAAO;CAClC,MAAM,IAAI;CACV,MAAM,MAAM,MAAc,OAAO,MAAM,UAAU,CAAC;CAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,IAAI;CACtD,IAAI,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,cAAc,YAAY;CAElE,OAAO,iBAAiB,SAAS,GAAG,KAAK,OAAO,SAAS,GAAG,cAAc,KAAK,EAAE,sBAAsB,cAAc,MAAM;AAC7H;;AAGA,SAAS,UAAU,GAAmB;CACpC,MAAM,OAAO,uDAAuD,KAAK,CAAC;CAC1E,IAAI,CAAC,MAAM,MAAM,IAAI,cAAc,WAAW;CAC9C,MAAM,WAAW,KAAK;CACtB,IAAI,cAAc,KAAK,GAAG,KAAK;CAC/B,MAAM,YAAY,EAAE,MAAM,KAAK,QAAQ,KAAK,GAAG,MAAM,EAAE,KAAK;CAC5D,IAAI,UAAU,WAAW,GAAG,MAAM,IAAI,cAAc,aAAa;CAGjE,IAAI,OAAkC;CACtC,MAAM,WAAW,8BAA8B,KAAK,WAAW;CAC/D,IAAI,UAAU;EACZ,OAAO,SAAS,OAAO,MAAM,SAAS;EACtC,cAAc,YAAY,MAAM,GAAG,SAAS,KAAK,EAAE,KAAK;CAC1D;CAEA,MAAM,OAAO,cAAc,SAAS;CACpC,MAAM,MAAM,MAAc,OAAO,MAAM,UAAU,CAAC;CAClD,MAAM,MAAM;CAGZ,IAAI;CACJ,IAAI;CACJ,IAAI,gBAAgB,KAAK,WAAW,GAAG;EACrC,SAAS,GAAG,IAAI;EAChB,cAAc;CAChB,OAAO,IAAI,YAAY,KAAK,WAAW,GAAG;EACxC,SAAS,GAAG,GAAG;EACf,cAAc;CAChB,OAAO;EACL,MAAM,SAAS,UAAU,WAAW;EACpC,cAAc,cAAc,MAAM;EAClC,IAAI,SAAS,QACX,SAAS,GAAG,SAAS,GAAG;OACnB,IAAI,SAAS,SAClB,SAAS,GAAG,SAAS,GAAG;OACnB;GACL,MAAM,KAAK,GAAG,SAAS,GAAG;GAC1B,MAAM,KAAK,GAAG,SAAS,GAAG;GAC1B,MAAM,OAAO,KAAK,MAAM;GACxB,IAAI,KAAK,IAAI,KAAK,EAAE,IAAI,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,CAAC,GACtD,MAAM,IAAI,cAAc,gBAAgB;GAE1C,SAAS;EACX;CACF;CACA,IAAI,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,cAAc,iBAAiB;CAMvE,MAAM,UAAU,KAAK,MAAM,MAAM;CACjC,IAAI,KAAK,IAAI,SAAS,OAAO,IAAI,MAAM,SAAS;CAEhD,OAAO,kBAAkB,SAAS,GAAG,YAAY,OAAO,KAAK,uBAAuB,cAAc,MAAM;AAC1G;;AAGA,SAAS,qBAAqB,KAAqB;CACjD,QAAQ,KAAR;EACE,KAAK,cACH,OAAO;EACT,KAAK,mBACH,OAAO;EACT,KAAK,gBACH,OAAO;EACT,KAAK,kBACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,KAAK,YACH,OAAO;EACT,KAAK,eACH,OAAO;EACT,KAAK,kBACH,OAAO;EACT,KAAK,mBACH,OAAO;EACT,KAAK,cACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;AAOA,SAAS,YAAY,OAA8B;CACjD,IAAI,IAAI,MAAM,KAAK;CACnB,IAAI,EAAE,QAAQ,kBAAkB,EAAE;CAClC,IAAI,EAAE,QAAQ,qBAAqB,EAAE,EAAE,KAAK;CAE5C,IAAI;CACJ,IAAI,QAAQ,KAAK,CAAC,GAAG,UAAU;MAC1B,IAAI,QAAQ,KAAK,CAAC,GAAG,UAAU;MAC/B,IACH,gDAAgD,KAAK,CAAC,KACtD,oCAAoC,KAAK,CAAC,GAE1C,UAAU;CACZ,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI;EACF,OAAO,QAAQ,CAAC;CAClB,SAAS,KAAK;EACZ,IAAI,aAAa,KAAK,iBAAiB,aAAa,GAClD,OAAO,UAAU,qBAAqB,IAAI,OAAO;EAEnD,OAAO,UAAU,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;CAC1D;AACF;;;;;;;;;;;;;;;AAgBA,IAAa,gBAAgB,IAAI,KAAK;CACpC,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO,EAC5B,YAAY,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,0CAAwC,EAChG,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,eAAe;EAEvB,MAAM,cAAc,mBAAmB,UAAU;EACjD,IAAI,aAAa,OAAO;EAExB,IAAI;GACF,MAAM,SAAS,KAAK,SAAU,UAAU;GAGxC,OAAO,WAAW,OAAO,YAFZ,KAAK,MAAO,UACX,EAAK,MACkB,EAAM,KAAK,OAAO;EACzD,SAAS,KAAK;GACZ,OAAO,UAAU,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;EAC1D;CACF;AACF,CAAC;;;;;;;;;;;;;;;;;;;;;;;AAwBD,IAAa,oBAAoB,IAAI,KAAK;CACxC,MAAM;CACN,aACE;CACF,aAAa,UAAU,OAAO,EAC5B,OAAO,UACJ,OAAO,EACP,SAAS,EACT,YAAY,iFAA6E,EAC9F,CAAC;CACD,SAAS,OAAO,SAAS;EACvB,MAAM,EAAE,UAAU;EAElB,MAAM,cAAc,mBAAmB,KAAK;EAC5C,IAAI,aAAa,OAAO;EAExB,IAAI;GAIF,MAAM,WAAW,YAAY,KAAK;GAClC,IAAI,aAAa,MAAM,OAAO;GAE9B,MAAM,aAAa,cAAc,KAAK;GAEtC,MAAM,wBAAwB,mBAAmB,UAAU;GAC3D,IAAI,uBAAuB,OAAO;GAGlC,OAAO,cAAc,WAAW,YADjB,KAAK,SAAU,UACc;EAC9C,SAAS,KAAK;GACZ,OAAO,UAAU,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;EAC1D;CACF;AACF,CAAC"}

package/batteries/tools/memory.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-BQVQtiJ5.js");
-const require_thought = require("../../thought-D4Urt3-j.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-yno0AFt2.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
+const require_thought = require("../../thought-BD6AkkOr.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-DQX0RCdI.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 let luxon = require("luxon");

package/batteries/tools/memory.mjs

@@ -1,8 +1,8 @@
-import { o as isError } from "../../tool_registry-CiNgQfJR.mjs";
-import { r as Memory } from "../../thought-C5M4KlGw.mjs";
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
-import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CSMXhajY.mjs";
+import { o as isError } from "../../tool_registry-BGHg6KTq.mjs";
+import { r as Memory } from "../../thought-B_P8LiB6.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CNle4jXN.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 import { DateTime } from "luxon";

package/batteries/tools/parsing.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-BQVQtiJ5.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-yno0AFt2.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-DQX0RCdI.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 let js_yaml = require("js-yaml");

package/batteries/tools/parsing.mjs

@@ -1,7 +1,7 @@
-import { o as isError } from "../../tool_registry-CiNgQfJR.mjs";
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
-import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CSMXhajY.mjs";
+import { o as isError } from "../../tool_registry-BGHg6KTq.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CNle4jXN.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 import { load } from "js-yaml";

package/batteries/tools/retrievables.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-BQVQtiJ5.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-const require_common = require("../../common-GPkVZ_S_.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-yno0AFt2.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+const require_common = require("../../common-D_e5zYsG.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-DQX0RCdI.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 let luxon = require("luxon");

package/batteries/tools/retrievables.mjs

@@ -1,7 +1,7 @@
-import { o as isError } from "../../tool_registry-CiNgQfJR.mjs";
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import { o as Retrievable } from "../../common-DaOXYsz4.mjs";
-import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CSMXhajY.mjs";
+import { o as isError } from "../../tool_registry-BGHg6KTq.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import { o as Retrievable } from "../../common-lMrnzoyn.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CNle4jXN.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 import { DateTime } from "luxon";

package/batteries/tools/standing_instructions.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-BQVQtiJ5.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-yno0AFt2.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-DQX0RCdI.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/standing_instructions/index.ts

package/batteries/tools/standing_instructions.mjs

@@ -1,7 +1,7 @@
-import { o as isError } from "../../tool_registry-CiNgQfJR.mjs";
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
-import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CSMXhajY.mjs";
+import { o as isError } from "../../tool_registry-BGHg6KTq.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CNle4jXN.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/standing_instructions/index.ts

package/batteries/tools/statistics.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-BQVQtiJ5.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-yno0AFt2.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-DQX0RCdI.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 let simple_statistics = require("simple-statistics");

package/batteries/tools/statistics.mjs

@@ -1,7 +1,7 @@
-import { o as isError } from "../../tool_registry-CiNgQfJR.mjs";
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
-import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CSMXhajY.mjs";
+import { o as isError } from "../../tool_registry-BGHg6KTq.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CNle4jXN.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 import { equalIntervalBreaks, interquartileRange, max, mean, median, min, mode, quantile, sampleCorrelation, standardDeviation, sum, variance, zScore } from "simple-statistics";

package/batteries/tools/string_processing.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-BQVQtiJ5.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 let case_anything = require("case-anything");

package/batteries/tools/string_processing.mjs

@@ -1,6 +1,6 @@
-import { o as isError } from "../../tool_registry-CiNgQfJR.mjs";
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
+import { o as isError } from "../../tool_registry-BGHg6KTq.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 import { camelCase, capitalCase, kebabCase, pascalCase, snakeCase, trainCase } from "case-anything";

package/batteries/tools/structured_data.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-BQVQtiJ5.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
 require("../../guards.cjs");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/structured_data/index.ts

package/batteries/tools/structured_data.mjs

@@ -1,6 +1,6 @@
-import { o as isError } from "../../tool_registry-CiNgQfJR.mjs";
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
+import { o as isError } from "../../tool_registry-BGHg6KTq.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
 import "../../guards.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/structured_data/index.ts

package/batteries/tools/text_analysis.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
-const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-yno0AFt2.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
+const require_spooled_markdown_artifact = require("../../spooled_markdown_artifact-DQX0RCdI.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/text_analysis/index.ts
 /**

package/batteries/tools/text_analysis.mjs

@@ -1,6 +1,6 @@
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
-import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CSMXhajY.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
+import { n as SpooledJsonArtifact } from "../../spooled_markdown_artifact-CNle4jXN.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/text_analysis/index.ts
 /**

package/batteries/tools/text_comparison.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
 let _nhtio_validation = require("@nhtio/validation");
 let diff = require("diff");
 let fastest_levenshtein = require("fastest-levenshtein");

package/batteries/tools/text_comparison.mjs

@@ -1,5 +1,5 @@
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
 import { validator } from "@nhtio/validation";
 import { diffLines, diffWords } from "diff";
 import { distance } from "fastest-levenshtein";

package/batteries/tools/time.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
 let _nhtio_validation = require("@nhtio/validation");
 let luxon = require("luxon");
 //#region src/batteries/tools/time/index.ts

package/batteries/tools/time.mjs

@@ -1,5 +1,5 @@
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
 import { validator } from "@nhtio/validation";
 import { DateTime, IANAZone } from "luxon";
 //#region src/batteries/tools/time/index.ts

package/batteries/tools/unit_conversion.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
-const require_tool = require("../../tool-BwV8Zwpx.js");
-require("../../common-GPkVZ_S_.js");
+const require_tool = require("../../tool-CX9vNHAw.js");
+require("../../common-D_e5zYsG.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/batteries/tools/unit_conversion/index.ts
 /**

package/batteries/tools/unit_conversion.mjs

@@ -1,5 +1,5 @@
-import { t as Tool } from "../../tool-DDqsPmsX.mjs";
-import "../../common-DaOXYsz4.mjs";
+import { t as Tool } from "../../tool-CRZSUcdP.mjs";
+import "../../common-lMrnzoyn.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/batteries/tools/unit_conversion/index.ts
 /**

package/{common-GPkVZ_S_.js → common-D_e5zYsG.js}

@@ -1,12 +1,12 @@
 require("./chunk-Ble4zEEl.js");
 const require_exceptions = require("./exceptions-CitH5wZI.js");
-const require_runtime = require("./runtime-DQ9CcNdt.js");
-const require_tool_registry = require("./tool_registry-BQVQtiJ5.js");
-require("./thought-D4Urt3-j.js");
-require("./tool-BwV8Zwpx.js");
-const require_spooled_artifact = require("./spooled_artifact-7A9-TJeb.js");
-require("./tool_call-_5_kLSni.js");
-require("./spooled_markdown_artifact-yno0AFt2.js");
+const require_tool_registry = require("./tool_registry-CtCQ4Xoz.js");
+const require_runtime = require("./runtime-MFFcJrRv.js");
+require("./thought-BD6AkkOr.js");
+require("./tool-CX9vNHAw.js");
+const require_spooled_artifact = require("./spooled_artifact-B8gIIn9h.js");
+require("./tool_call--7ti-frB.js");
+require("./spooled_markdown_artifact-DQX0RCdI.js");
 let _nhtio_validation = require("@nhtio/validation");
 //#region src/lib/classes/retrievable.ts
 /**
@@ -307,4 +307,4 @@ Object.defineProperty(exports, "inMemoryMediaReader", {
 	}
 });
 
-//# sourceMappingURL=common-GPkVZ_S_.js.map
+//# sourceMappingURL=common-D_e5zYsG.js.map

package/{common-GPkVZ_S_.js.map → common-D_e5zYsG.js.map}

@@ -1 +1 @@
-{"version":3,"file":"common-GPkVZ_S_.js","names":["#id","#content","#trustTier","#source","#kind","#score","#createdAt","#updatedAt"],"sources":["../src/lib/classes/retrievable.ts","../src/lib/contracts/byte_store.ts","../src/lib/helpers/media_readers.ts"],"sourcesContent":["import { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { SpooledArtifact } from './spooled_artifact'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_RETRIEVABLE_VALUE } from '../exceptions/runtime'\nimport type { DateTime } from 'luxon'\nimport type { TokenEncoding } from './tokenizable'\n\n/**\n * Trust-tier discriminator declared by the retrieval middleware at construction time. Drives\n * which envelope the LLM battery wraps the record in.\n *\n * @remarks\n * Vocabulary deliberately mirrors the published security-research taxonomy (\"first-party /\n * third-party\" per *Hidden-in-Plain-Text* WWW '26 and *When AI Meets the Web* IEEE S&P 2026)\n * and explicitly avoids the words \"user\" or \"system\" so the names cannot leak into the model's\n * OpenAI-Model-Spec role-tier authority resolution.\n *\n * - `'first-party'` — deployer-vetted corpora (signed internal docs, policy KBs, curated\n *   reference material). Rendered as a `<retrieved_corpus>` parent with per-record nonce-keyed\n *   `<retrieved>` children. The label \"first-party\" never appears in the envelope itself.\n * - `'third-party-public'` — open-web scrapes, search results, public APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-public'`.\n * - `'third-party-private'` — user uploads, pasted attachments, partner APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-private'`.\n */\nexport type RetrievableTrustTier = 'first-party' | 'third-party-public' | 'third-party-private'\n\n/**\n * Plain input object supplied to {@link Retrievable} at construction time.\n *\n * @remarks\n * Validated against `rawRetrievableSchema` before the `Retrievable` instance is created.\n * Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,\n * `Date` objects, or existing `DateTime` instances.\n */\nexport interface RawRetrievable {\n  /**\n   * Stable unique identifier for this retrieved record. Used as the closing-tag nonce in the\n   * rendered envelope, so it must be unguessable from the payload.\n   */\n  id: string\n  /**\n   * The retrieved content. A plain `string` or {@link @nhtio/adk!Tokenizable} for small inline text, or a\n   * {@link @nhtio/adk!SpooledArtifact} when the extracted text is large and lives in a consumer\n   * {@link @nhtio/adk!ByteStore} (persist it via {@link @nhtio/adk!DispatchContext.storeRetrievableBytes}, wrap\n   * the returned reader in a `SpooledArtifact`, and pass it here). Reader-backed content keeps the\n   * body out of the permanent heap, but token estimation and render still materialise it\n   * transiently (see {@link Retrievable.estimateTokens}).\n   */\n  content: string | Tokenizable | SpooledArtifact\n  /**\n   * Trust tier declared by the retrieval middleware at construction time. Required — there is\n   * NO default. The decision must be conscious. See {@link RetrievableTrustTier}.\n   */\n  trustTier: RetrievableTrustTier\n  /** Optional provenance string: URL, document path, knowledge-base id, etc. */\n  source?: string\n  /** Optional semantic label: 'policy' | 'reference' | 'web-page' | 'pdf' | etc. */\n  kind?: string\n  /** Optional relevance / similarity score in `[0, 1]` from the retrieval middleware. */\n  score?: number\n  /** When the source record was created (publication date, upload date, etc.). */\n  createdAt: string | number | Date | DateTime\n  /** When the source record was last modified. */\n  updatedAt: string | number | Date | DateTime\n}\n\n/**\n * A fully-resolved {@link RawRetrievable} where all fields have been validated and temporal\n * values normalised to Luxon `DateTime` instances.\n */\ninterface ResolvedRetrievable {\n  id: string\n  content: Tokenizable | SpooledArtifact\n  trustTier: RetrievableTrustTier\n  source?: string\n  kind?: string\n  score?: number\n  createdAt: DateTime\n  updatedAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawRetrievable} before constructing a\n * {@link Retrievable}.\n *\n * @remarks\n * - `id` — required non-empty string.\n * - `content` — required {@link @nhtio/adk!Tokenizable.schema}.\n * - `trustTier` — required, one of `'first-party'`, `'third-party-public'`,\n *   `'third-party-private'`. Unknown / missing values reject.\n * - `source` / `kind` — optional strings.\n * - `score` — optional number in `[0, 1]`.\n * - `createdAt` / `updatedAt` — required datetime-parseable values.\n *\n * Throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} (via the {@link Retrievable} constructor)\n * when validation fails.\n */\nconst contentSchema = validator.alternatives(\n  validator.string(),\n  validator.custom((value, helpers) => {\n    if (Tokenizable.isTokenizable(value) || SpooledArtifact.isSpooledArtifact(value)) {\n      return value\n    }\n    return helpers.error('any.invalid')\n  })\n)\n\nconst rawRetrievableSchema = validator.object<RawRetrievable>({\n  id: validator.string().required(),\n  content: contentSchema.required(),\n  trustTier: validator\n    .string()\n    .valid('first-party', 'third-party-public', 'third-party-private')\n    .required(),\n  source: validator.string().optional(),\n  kind: validator.string().optional(),\n  score: validator.number().min(0).max(1).optional(),\n  createdAt: validator.datetime().required(),\n  updatedAt: validator.datetime().required(),\n})\n\n/**\n * An immutable, validated retrieved record (RAG content) held by the agent.\n *\n * @remarks\n * Peer of {@link @nhtio/adk!Memory} / `Message` / `Thought` / `ToolCall`. Carries an explicit `trustTier`\n * that LLM batteries branch on to choose the rendering envelope. The retrieval middleware that\n * produced the record is the only party that knows its provenance — batteries MUST NOT\n * auto-classify or infer the tier from `source`.\n */\nexport class Retrievable {\n  /**\n   * Validator schema that accepts a {@link RawRetrievable} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a retrievable record.\n   */\n  public static schema = rawRetrievableSchema\n\n  /**\n   * Returns `true` if `value` is a {@link Retrievable} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   */\n  public static isRetrievable(value: unknown): value is Retrievable {\n    return isInstanceOf(value, 'Retrievable', Retrievable)\n  }\n\n  /** Stable unique identifier for this retrieved record. */\n  declare readonly id: string\n  /**\n   * The retrieved content: a {@link @nhtio/adk!Tokenizable} (inline text) or a\n   * {@link @nhtio/adk!SpooledArtifact} (reader-backed, large text living in a consumer store). Use\n   * {@link Retrievable.estimateTokens} for budgeting and {@link Retrievable.contentString} to\n   * materialise the body at render time.\n   */\n  declare readonly content: Tokenizable | SpooledArtifact\n  /** Trust tier declared by the retrieval middleware. */\n  declare readonly trustTier: RetrievableTrustTier\n  /** Optional provenance string. */\n  declare readonly source: string | undefined\n  /** Optional semantic label. */\n  declare readonly kind: string | undefined\n  /** Optional relevance / similarity score in `[0, 1]`. */\n  declare readonly score: number | undefined\n  /** When the source record was created. */\n  declare readonly createdAt: DateTime\n  /** When the source record was last modified. */\n  declare readonly updatedAt: DateTime\n\n  #id: string\n  #content: Tokenizable | SpooledArtifact\n  #trustTier: RetrievableTrustTier\n  #source: string | undefined\n  #kind: string | undefined\n  #score: number | undefined\n  #createdAt: DateTime\n  #updatedAt: DateTime\n\n  /**\n   * @param raw - The raw retrievable input validated against `rawRetrievableSchema`.\n   * @throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawRetrievable) {\n    let resolved: ResolvedRetrievable\n    try {\n      resolved = validateOrThrow<ResolvedRetrievable>(rawRetrievableSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_RETRIEVABLE_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#id = resolved.id\n    this.#content =\n      Tokenizable.isTokenizable(resolved.content) ||\n      SpooledArtifact.isSpooledArtifact(resolved.content)\n        ? resolved.content\n        : new Tokenizable(resolved.content)\n    this.#trustTier = resolved.trustTier\n    this.#source = resolved.source\n    this.#kind = resolved.kind\n    this.#score = resolved.score\n    this.#createdAt = resolved.createdAt\n    this.#updatedAt = resolved.updatedAt\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      content: {\n        get: () => this.#content,\n        enumerable: true,\n        configurable: false,\n      },\n      trustTier: {\n        get: () => this.#trustTier,\n        enumerable: true,\n        configurable: false,\n      },\n      source: {\n        get: () => this.#source,\n        enumerable: true,\n        configurable: false,\n      },\n      kind: {\n        get: () => this.#kind,\n        enumerable: true,\n        configurable: false,\n      },\n      score: {\n        get: () => this.#score,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      updatedAt: {\n        get: () => this.#updatedAt,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n\n  /**\n   * Estimates the token count of the content under `encoding`.\n   *\n   * @remarks\n   * Delegates to the content's own `estimateTokens`: synchronous for a {@link @nhtio/adk!Tokenizable}\n   * (returns `number`), asynchronous for a {@link @nhtio/adk!SpooledArtifact} (returns\n   * `Promise<number>`, reading the bytes from the backing store on demand). Both shapes satisfy the\n   * adapter's token-budget path, which already awaits estimates.\n   *\n   * Note: the `SpooledArtifact` branch materialises the full decoded string transiently to count\n   * tokens — reader-backing keeps the body off the *permanent* heap, but does not eliminate the\n   * transient allocation at budgeting time.\n   *\n   * @param encoding - The encoding identifier to use for counting.\n   * @returns The estimated token count.\n   */\n  estimateTokens(encoding: TokenEncoding): number | Promise<number> {\n    return this.#content.estimateTokens(encoding)\n  }\n\n  /**\n   * Returns the content body as a single string.\n   *\n   * @remarks\n   * For a {@link @nhtio/adk!Tokenizable} this is synchronous in effect (resolved immediately); for a\n   * {@link @nhtio/adk!SpooledArtifact} it reads the full body from the backing store via\n   * {@link @nhtio/adk!SpooledArtifact.asString}. Always returns a `Promise` so callers have one\n   * code path; render helpers `await` it at the point the trust-tier envelope is built.\n   *\n   * @returns The full content body as a string.\n   */\n  async contentString(): Promise<string> {\n    return SpooledArtifact.isSpooledArtifact(this.#content)\n      ? this.#content.asString()\n      : this.#content.toString()\n  }\n}\n","import { validator } from '@nhtio/validation'\nimport { passesSchema } from '../utils/validation'\nimport type { SpoolReader } from './spool_reader'\nimport type { MediaReader } from './media_reader'\n\n/**\n * Unified \"give bytes, get a reader\" persistence contract.\n *\n * @remarks\n * For the purposes of storage there is no meaningful distinction between text and binary — bytes\n * are bytes. `ByteStore` is the single low-level shape every ADK storage layer implements: hand it\n * bytes under an `id`, get back a replayable reader `R`; read or delete by the same `id` later. The\n * generic `R` is the reader the store hands out — different reader contracts (line-indexed\n * {@link @nhtio/adk!SpoolReader} vs binary-streamed {@link @nhtio/adk!MediaReader}) are\n * distinguished by the `R` instantiation, not by separate store interfaces. See the {@link SpoolStore}\n * and {@link MediaStore} aliases for the two concrete semantics.\n *\n * `write` accepts a `string`, a `Uint8Array`, or a `ReadableStream<Uint8Array>`. The stream form is\n * the point of the contract: a durable store can persist an arbitrarily large payload straight to\n * disk/object storage without first materializing it in memory. **String input is encoded as\n * UTF-8.** The returned reader is only guaranteed readable once the `write` result has resolved.\n *\n * All three methods may be synchronous or asynchronous so that in-memory implementations are not\n * forced to pay promise overhead while I/O-backed implementations stay async. Note that any\n * implementation accepting a `ReadableStream` must return a `Promise` for that input — draining a\n * stream cannot be synchronous.\n */\nexport interface ByteStore<R> {\n  /**\n   * Persists `bytes` under `id` and returns a reader over them.\n   *\n   * @remarks\n   * Re-writing the same `id` replaces the prior entry. `string` input is encoded as UTF-8;\n   * `Uint8Array` and `ReadableStream<Uint8Array>` are stored byte-faithfully. Stream input\n   * necessarily resolves asynchronously.\n   *\n   * @param id - Identifier used to retrieve or delete the bytes later.\n   * @param bytes - The payload, as a `string`, `Uint8Array`, or `ReadableStream<Uint8Array>`.\n   * @returns A reader over the stored bytes (or a `Promise` of one).\n   */\n  write(id: string, bytes: string | Uint8Array | ReadableStream<Uint8Array>): R | Promise<R>\n\n  /**\n   * Returns a reader over the bytes previously written under `id`, or `undefined` if no entry\n   * exists.\n   *\n   * @param id - Identifier supplied to a prior {@link ByteStore.write} call.\n   * @returns A reader over the stored bytes, `undefined`, or a `Promise` of either.\n   */\n  read(id: string): R | undefined | Promise<R | undefined>\n\n  /**\n   * Removes the entry under `id`.\n   *\n   * @param id - Identifier whose entry should be removed.\n   * @returns `true` if an entry existed and was removed; `false` otherwise (or a `Promise` of one).\n   */\n  delete(id: string): boolean | Promise<boolean>\n}\n\n/**\n * A {@link ByteStore} that hands out line-indexed text readers ({@link @nhtio/adk!SpoolReader}).\n *\n * @remarks\n * The store backing tool-output artifacts. Stored bytes are decoded as UTF-8 text for line-oriented\n * reads; binary input is stored byte-faithfully but `SpoolReader.readAll()` interprets it as text,\n * so opaque binary belongs in a {@link MediaStore} / `Media`, not here.\n */\nexport type SpoolStore = ByteStore<SpoolReader>\n\n/**\n * A {@link ByteStore} that hands out binary-streamed readers ({@link @nhtio/adk!MediaReader}).\n *\n * @remarks\n * The store backing persisted media bytes. Stored bytes are opaque and replayable via\n * `MediaReader.stream()`; no text decoding is implied.\n */\nexport type MediaStore = ByteStore<MediaReader>\n\n/**\n * Validator schema used to validate a {@link ByteStore} value.\n *\n * @remarks\n * Because `ByteStore` is a structural interface with no associated constructor, validation is\n * duck-typed: the value must be non-null with `write`, `read`, and `delete` present as callable\n * properties. Arity is not enforced — implementations may add optional parameters beyond the\n * contract. The reader type `R` cannot be checked structurally here; conformance of the reader is\n * the caller's concern at the point of use.\n */\nexport const byteStoreSchema = validator.any().custom((value, helpers) => {\n  if (\n    value !== null &&\n    value !== undefined &&\n    typeof (value as any).write === 'function' &&\n    typeof (value as any).read === 'function' &&\n    typeof (value as any).delete === 'function'\n  ) {\n    return value\n  }\n  return helpers.error('any.invalid')\n})\n\n/**\n * Returns `true` if `value` implements the {@link ByteStore} interface.\n *\n * @remarks\n * Duck-typed: checks that `value` is non-null with `write`, `read`, and `delete` as callable\n * functions. Does not use `instanceof` — there is no `ByteStore` constructor.\n *\n * @param value - The value to test.\n * @returns `true` when `value` conforms to the {@link ByteStore} interface.\n */\nexport const implementsByteStore = <R = unknown>(value: unknown): value is ByteStore<R> => {\n  return passesSchema(byteStoreSchema, value)\n}\n","import type { MediaReader } from '../contracts/media_reader'\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by an in-memory `Uint8Array`.\n *\n * @remarks\n * Each `stream()` call returns a fresh single-chunk `ReadableStream` over the same buffer. The\n * reader is re-openable by construction — call `stream()` as many times as needed.\n *\n * @param bytes - The buffer to serve.\n * @returns A {@link @nhtio/adk!MediaReader} that re-reads `bytes` on every call.\n */\nexport const inMemoryMediaReader = (bytes: Uint8Array): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(bytes)\n          controller.close()\n        },\n      })\n    },\n    byteLength(): number {\n      return bytes.byteLength\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a fetch call.\n *\n * @remarks\n * Each `stream()` call re-issues the fetch. Tool authors whose underlying source is rate-limited\n * or expensive must cache locally before constructing the reader — the framework cannot make\n * that decision for them.\n *\n * `byteLength()` returns `undefined` because most remote sources do not promise it without an\n * extra HEAD request; consumers that need a byte size should resolve it out-of-band.\n *\n * @param url - The URL to fetch on each call.\n * @param init - Optional `fetch` init forwarded verbatim.\n * @returns A {@link @nhtio/adk!MediaReader} that re-issues `fetch(url, init)` on every call.\n */\nexport const fromFetch = (url: string | URL, init?: RequestInit): MediaReader => {\n  return {\n    async stream(): Promise<ReadableStream<Uint8Array>> {\n      const response = await fetch(url, init)\n      if (!response.ok) {\n        throw new Error(`fromFetch: fetch failed with status ${response.status}`)\n      }\n      if (!response.body) {\n        throw new Error('fromFetch: response has no body')\n      }\n      return response.body as ReadableStream<Uint8Array>\n    },\n    byteLength(): undefined {\n      return undefined\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a browser `File` or `Blob`.\n *\n * @remarks\n * Each `stream()` call re-streams the underlying File via `File.stream()`. `byteLength()`\n * resolves from `file.size`.\n *\n * @param file - The browser `File` or `Blob` to stream.\n * @returns A {@link @nhtio/adk!MediaReader} that re-streams `file` on every call.\n */\nexport const fromWebFile = (file: Blob): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return file.stream() as ReadableStream<Uint8Array>\n    },\n    byteLength(): number {\n      return file.size\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"common-D_e5zYsG.js","names":["#id","#content","#trustTier","#source","#kind","#score","#createdAt","#updatedAt"],"sources":["../src/lib/classes/retrievable.ts","../src/lib/contracts/byte_store.ts","../src/lib/helpers/media_readers.ts"],"sourcesContent":["import { Tokenizable } from './tokenizable'\nimport { validator } from '@nhtio/validation'\nimport { SpooledArtifact } from './spooled_artifact'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError } from '../utils/guards'\nimport { E_INVALID_INITIAL_RETRIEVABLE_VALUE } from '../exceptions/runtime'\nimport type { DateTime } from 'luxon'\nimport type { TokenEncoding } from './tokenizable'\n\n/**\n * Trust-tier discriminator declared by the retrieval middleware at construction time. Drives\n * which envelope the LLM battery wraps the record in.\n *\n * @remarks\n * Vocabulary deliberately mirrors the published security-research taxonomy (\"first-party /\n * third-party\" per *Hidden-in-Plain-Text* WWW '26 and *When AI Meets the Web* IEEE S&P 2026)\n * and explicitly avoids the words \"user\" or \"system\" so the names cannot leak into the model's\n * OpenAI-Model-Spec role-tier authority resolution.\n *\n * - `'first-party'` — deployer-vetted corpora (signed internal docs, policy KBs, curated\n *   reference material). Rendered as a `<retrieved_corpus>` parent with per-record nonce-keyed\n *   `<retrieved>` children. The label \"first-party\" never appears in the envelope itself.\n * - `'third-party-public'` — open-web scrapes, search results, public APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-public'`.\n * - `'third-party-private'` — user uploads, pasted attachments, partner APIs. Rendered through\n *   the untrusted-content envelope with `kind: 'retrieved-third-party-private'`.\n */\nexport type RetrievableTrustTier = 'first-party' | 'third-party-public' | 'third-party-private'\n\n/**\n * Plain input object supplied to {@link Retrievable} at construction time.\n *\n * @remarks\n * Validated against `rawRetrievableSchema` before the `Retrievable` instance is created.\n * Temporal fields accept any value that Luxon can parse — ISO strings, Unix timestamps,\n * `Date` objects, or existing `DateTime` instances.\n */\nexport interface RawRetrievable {\n  /**\n   * Stable unique identifier for this retrieved record. Used as the closing-tag nonce in the\n   * rendered envelope, so it must be unguessable from the payload.\n   */\n  id: string\n  /**\n   * The retrieved content. A plain `string` or {@link @nhtio/adk!Tokenizable} for small inline text, or a\n   * {@link @nhtio/adk!SpooledArtifact} when the extracted text is large and lives in a consumer\n   * {@link @nhtio/adk!ByteStore} (persist it via {@link @nhtio/adk!DispatchContext.storeRetrievableBytes}, wrap\n   * the returned reader in a `SpooledArtifact`, and pass it here). Reader-backed content keeps the\n   * body out of the permanent heap, but token estimation and render still materialise it\n   * transiently (see {@link Retrievable.estimateTokens}).\n   */\n  content: string | Tokenizable | SpooledArtifact\n  /**\n   * Trust tier declared by the retrieval middleware at construction time. Required — there is\n   * NO default. The decision must be conscious. See {@link RetrievableTrustTier}.\n   */\n  trustTier: RetrievableTrustTier\n  /** Optional provenance string: URL, document path, knowledge-base id, etc. */\n  source?: string\n  /** Optional semantic label: 'policy' | 'reference' | 'web-page' | 'pdf' | etc. */\n  kind?: string\n  /** Optional relevance / similarity score in `[0, 1]` from the retrieval middleware. */\n  score?: number\n  /** When the source record was created (publication date, upload date, etc.). */\n  createdAt: string | number | Date | DateTime\n  /** When the source record was last modified. */\n  updatedAt: string | number | Date | DateTime\n}\n\n/**\n * A fully-resolved {@link RawRetrievable} where all fields have been validated and temporal\n * values normalised to Luxon `DateTime` instances.\n */\ninterface ResolvedRetrievable {\n  id: string\n  content: Tokenizable | SpooledArtifact\n  trustTier: RetrievableTrustTier\n  source?: string\n  kind?: string\n  score?: number\n  createdAt: DateTime\n  updatedAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawRetrievable} before constructing a\n * {@link Retrievable}.\n *\n * @remarks\n * - `id` — required non-empty string.\n * - `content` — required {@link @nhtio/adk!Tokenizable.schema}.\n * - `trustTier` — required, one of `'first-party'`, `'third-party-public'`,\n *   `'third-party-private'`. Unknown / missing values reject.\n * - `source` / `kind` — optional strings.\n * - `score` — optional number in `[0, 1]`.\n * - `createdAt` / `updatedAt` — required datetime-parseable values.\n *\n * Throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} (via the {@link Retrievable} constructor)\n * when validation fails.\n */\nconst contentSchema = validator.alternatives(\n  validator.string(),\n  validator.custom((value, helpers) => {\n    if (Tokenizable.isTokenizable(value) || SpooledArtifact.isSpooledArtifact(value)) {\n      return value\n    }\n    return helpers.error('any.invalid')\n  })\n)\n\nconst rawRetrievableSchema = validator.object<RawRetrievable>({\n  id: validator.string().required(),\n  content: contentSchema.required(),\n  trustTier: validator\n    .string()\n    .valid('first-party', 'third-party-public', 'third-party-private')\n    .required(),\n  source: validator.string().optional(),\n  kind: validator.string().optional(),\n  score: validator.number().min(0).max(1).optional(),\n  createdAt: validator.datetime().required(),\n  updatedAt: validator.datetime().required(),\n})\n\n/**\n * An immutable, validated retrieved record (RAG content) held by the agent.\n *\n * @remarks\n * Peer of {@link @nhtio/adk!Memory} / `Message` / `Thought` / `ToolCall`. Carries an explicit `trustTier`\n * that LLM batteries branch on to choose the rendering envelope. The retrieval middleware that\n * produced the record is the only party that knows its provenance — batteries MUST NOT\n * auto-classify or infer the tier from `source`.\n */\nexport class Retrievable {\n  /**\n   * Validator schema that accepts a {@link RawRetrievable} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a retrievable record.\n   */\n  public static schema = rawRetrievableSchema\n\n  /**\n   * Returns `true` if `value` is a {@link Retrievable} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   */\n  public static isRetrievable(value: unknown): value is Retrievable {\n    return isInstanceOf(value, 'Retrievable', Retrievable)\n  }\n\n  /** Stable unique identifier for this retrieved record. */\n  declare readonly id: string\n  /**\n   * The retrieved content: a {@link @nhtio/adk!Tokenizable} (inline text) or a\n   * {@link @nhtio/adk!SpooledArtifact} (reader-backed, large text living in a consumer store). Use\n   * {@link Retrievable.estimateTokens} for budgeting and {@link Retrievable.contentString} to\n   * materialise the body at render time.\n   */\n  declare readonly content: Tokenizable | SpooledArtifact\n  /** Trust tier declared by the retrieval middleware. */\n  declare readonly trustTier: RetrievableTrustTier\n  /** Optional provenance string. */\n  declare readonly source: string | undefined\n  /** Optional semantic label. */\n  declare readonly kind: string | undefined\n  /** Optional relevance / similarity score in `[0, 1]`. */\n  declare readonly score: number | undefined\n  /** When the source record was created. */\n  declare readonly createdAt: DateTime\n  /** When the source record was last modified. */\n  declare readonly updatedAt: DateTime\n\n  #id: string\n  #content: Tokenizable | SpooledArtifact\n  #trustTier: RetrievableTrustTier\n  #source: string | undefined\n  #kind: string | undefined\n  #score: number | undefined\n  #createdAt: DateTime\n  #updatedAt: DateTime\n\n  /**\n   * @param raw - The raw retrievable input validated against `rawRetrievableSchema`.\n   * @throws {@link @nhtio/adk/exceptions!E_INVALID_INITIAL_RETRIEVABLE_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawRetrievable) {\n    let resolved: ResolvedRetrievable\n    try {\n      resolved = validateOrThrow<ResolvedRetrievable>(rawRetrievableSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_RETRIEVABLE_VALUE({ cause: isError(err) ? err : undefined })\n    }\n    this.#id = resolved.id\n    this.#content =\n      Tokenizable.isTokenizable(resolved.content) ||\n      SpooledArtifact.isSpooledArtifact(resolved.content)\n        ? resolved.content\n        : new Tokenizable(resolved.content)\n    this.#trustTier = resolved.trustTier\n    this.#source = resolved.source\n    this.#kind = resolved.kind\n    this.#score = resolved.score\n    this.#createdAt = resolved.createdAt\n    this.#updatedAt = resolved.updatedAt\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      content: {\n        get: () => this.#content,\n        enumerable: true,\n        configurable: false,\n      },\n      trustTier: {\n        get: () => this.#trustTier,\n        enumerable: true,\n        configurable: false,\n      },\n      source: {\n        get: () => this.#source,\n        enumerable: true,\n        configurable: false,\n      },\n      kind: {\n        get: () => this.#kind,\n        enumerable: true,\n        configurable: false,\n      },\n      score: {\n        get: () => this.#score,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      updatedAt: {\n        get: () => this.#updatedAt,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n\n  /**\n   * Estimates the token count of the content under `encoding`.\n   *\n   * @remarks\n   * Delegates to the content's own `estimateTokens`: synchronous for a {@link @nhtio/adk!Tokenizable}\n   * (returns `number`), asynchronous for a {@link @nhtio/adk!SpooledArtifact} (returns\n   * `Promise<number>`, reading the bytes from the backing store on demand). Both shapes satisfy the\n   * adapter's token-budget path, which already awaits estimates.\n   *\n   * Note: the `SpooledArtifact` branch materialises the full decoded string transiently to count\n   * tokens — reader-backing keeps the body off the *permanent* heap, but does not eliminate the\n   * transient allocation at budgeting time.\n   *\n   * @param encoding - The encoding identifier to use for counting.\n   * @returns The estimated token count.\n   */\n  estimateTokens(encoding: TokenEncoding): number | Promise<number> {\n    return this.#content.estimateTokens(encoding)\n  }\n\n  /**\n   * Returns the content body as a single string.\n   *\n   * @remarks\n   * For a {@link @nhtio/adk!Tokenizable} this is synchronous in effect (resolved immediately); for a\n   * {@link @nhtio/adk!SpooledArtifact} it reads the full body from the backing store via\n   * {@link @nhtio/adk!SpooledArtifact.asString}. Always returns a `Promise` so callers have one\n   * code path; render helpers `await` it at the point the trust-tier envelope is built.\n   *\n   * @returns The full content body as a string.\n   */\n  async contentString(): Promise<string> {\n    return SpooledArtifact.isSpooledArtifact(this.#content)\n      ? this.#content.asString()\n      : this.#content.toString()\n  }\n}\n","import { validator } from '@nhtio/validation'\nimport { passesSchema } from '../utils/validation'\nimport type { SpoolReader } from './spool_reader'\nimport type { MediaReader } from './media_reader'\n\n/**\n * Unified \"give bytes, get a reader\" persistence contract.\n *\n * @remarks\n * For the purposes of storage there is no meaningful distinction between text and binary — bytes\n * are bytes. `ByteStore` is the single low-level shape every ADK storage layer implements: hand it\n * bytes under an `id`, get back a replayable reader `R`; read or delete by the same `id` later. The\n * generic `R` is the reader the store hands out — different reader contracts (line-indexed\n * {@link @nhtio/adk!SpoolReader} vs binary-streamed {@link @nhtio/adk!MediaReader}) are\n * distinguished by the `R` instantiation, not by separate store interfaces. See the {@link SpoolStore}\n * and {@link MediaStore} aliases for the two concrete semantics.\n *\n * `write` accepts a `string`, a `Uint8Array`, or a `ReadableStream<Uint8Array>`. The stream form is\n * the point of the contract: a durable store can persist an arbitrarily large payload straight to\n * disk/object storage without first materializing it in memory. **String input is encoded as\n * UTF-8.** The returned reader is only guaranteed readable once the `write` result has resolved.\n *\n * All three methods may be synchronous or asynchronous so that in-memory implementations are not\n * forced to pay promise overhead while I/O-backed implementations stay async. Note that any\n * implementation accepting a `ReadableStream` must return a `Promise` for that input — draining a\n * stream cannot be synchronous.\n */\nexport interface ByteStore<R> {\n  /**\n   * Persists `bytes` under `id` and returns a reader over them.\n   *\n   * @remarks\n   * Re-writing the same `id` replaces the prior entry. `string` input is encoded as UTF-8;\n   * `Uint8Array` and `ReadableStream<Uint8Array>` are stored byte-faithfully. Stream input\n   * necessarily resolves asynchronously.\n   *\n   * @param id - Identifier used to retrieve or delete the bytes later.\n   * @param bytes - The payload, as a `string`, `Uint8Array`, or `ReadableStream<Uint8Array>`.\n   * @returns A reader over the stored bytes (or a `Promise` of one).\n   */\n  write(id: string, bytes: string | Uint8Array | ReadableStream<Uint8Array>): R | Promise<R>\n\n  /**\n   * Returns a reader over the bytes previously written under `id`, or `undefined` if no entry\n   * exists.\n   *\n   * @param id - Identifier supplied to a prior {@link ByteStore.write} call.\n   * @returns A reader over the stored bytes, `undefined`, or a `Promise` of either.\n   */\n  read(id: string): R | undefined | Promise<R | undefined>\n\n  /**\n   * Removes the entry under `id`.\n   *\n   * @param id - Identifier whose entry should be removed.\n   * @returns `true` if an entry existed and was removed; `false` otherwise (or a `Promise` of one).\n   */\n  delete(id: string): boolean | Promise<boolean>\n}\n\n/**\n * A {@link ByteStore} that hands out line-indexed text readers ({@link @nhtio/adk!SpoolReader}).\n *\n * @remarks\n * The store backing tool-output artifacts. Stored bytes are decoded as UTF-8 text for line-oriented\n * reads; binary input is stored byte-faithfully but `SpoolReader.readAll()` interprets it as text,\n * so opaque binary belongs in a {@link MediaStore} / `Media`, not here.\n */\nexport type SpoolStore = ByteStore<SpoolReader>\n\n/**\n * A {@link ByteStore} that hands out binary-streamed readers ({@link @nhtio/adk!MediaReader}).\n *\n * @remarks\n * The store backing persisted media bytes. Stored bytes are opaque and replayable via\n * `MediaReader.stream()`; no text decoding is implied.\n */\nexport type MediaStore = ByteStore<MediaReader>\n\n/**\n * Validator schema used to validate a {@link ByteStore} value.\n *\n * @remarks\n * Because `ByteStore` is a structural interface with no associated constructor, validation is\n * duck-typed: the value must be non-null with `write`, `read`, and `delete` present as callable\n * properties. Arity is not enforced — implementations may add optional parameters beyond the\n * contract. The reader type `R` cannot be checked structurally here; conformance of the reader is\n * the caller's concern at the point of use.\n */\nexport const byteStoreSchema = validator.any().custom((value, helpers) => {\n  if (\n    value !== null &&\n    value !== undefined &&\n    typeof (value as any).write === 'function' &&\n    typeof (value as any).read === 'function' &&\n    typeof (value as any).delete === 'function'\n  ) {\n    return value\n  }\n  return helpers.error('any.invalid')\n})\n\n/**\n * Returns `true` if `value` implements the {@link ByteStore} interface.\n *\n * @remarks\n * Duck-typed: checks that `value` is non-null with `write`, `read`, and `delete` as callable\n * functions. Does not use `instanceof` — there is no `ByteStore` constructor.\n *\n * @param value - The value to test.\n * @returns `true` when `value` conforms to the {@link ByteStore} interface.\n */\nexport const implementsByteStore = <R = unknown>(value: unknown): value is ByteStore<R> => {\n  return passesSchema(byteStoreSchema, value)\n}\n","import type { MediaReader } from '../contracts/media_reader'\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by an in-memory `Uint8Array`.\n *\n * @remarks\n * Each `stream()` call returns a fresh single-chunk `ReadableStream` over the same buffer. The\n * reader is re-openable by construction — call `stream()` as many times as needed.\n *\n * @param bytes - The buffer to serve.\n * @returns A {@link @nhtio/adk!MediaReader} that re-reads `bytes` on every call.\n */\nexport const inMemoryMediaReader = (bytes: Uint8Array): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(bytes)\n          controller.close()\n        },\n      })\n    },\n    byteLength(): number {\n      return bytes.byteLength\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a fetch call.\n *\n * @remarks\n * Each `stream()` call re-issues the fetch. Tool authors whose underlying source is rate-limited\n * or expensive must cache locally before constructing the reader — the framework cannot make\n * that decision for them.\n *\n * `byteLength()` returns `undefined` because most remote sources do not promise it without an\n * extra HEAD request; consumers that need a byte size should resolve it out-of-band.\n *\n * @param url - The URL to fetch on each call.\n * @param init - Optional `fetch` init forwarded verbatim.\n * @returns A {@link @nhtio/adk!MediaReader} that re-issues `fetch(url, init)` on every call.\n */\nexport const fromFetch = (url: string | URL, init?: RequestInit): MediaReader => {\n  return {\n    async stream(): Promise<ReadableStream<Uint8Array>> {\n      const response = await fetch(url, init)\n      if (!response.ok) {\n        throw new Error(`fromFetch: fetch failed with status ${response.status}`)\n      }\n      if (!response.body) {\n        throw new Error('fromFetch: response has no body')\n      }\n      return response.body as ReadableStream<Uint8Array>\n    },\n    byteLength(): undefined {\n      return undefined\n    },\n  }\n}\n\n/**\n * Constructs a {@link @nhtio/adk!MediaReader} backed by a browser `File` or `Blob`.\n *\n * @remarks\n * Each `stream()` call re-streams the underlying File via `File.stream()`. `byteLength()`\n * resolves from `file.size`.\n *\n * @param file - The browser `File` or `Blob` to stream.\n * @returns A {@link @nhtio/adk!MediaReader} that re-streams `file` on every call.\n */\nexport const fromWebFile = (file: Blob): MediaReader => {\n  return {\n    stream(): ReadableStream<Uint8Array> {\n      return file.stream() as ReadableStream<Uint8Array>\n    },\n    byteLength(): number {\n      return file.size\n    },\n  }\n}\n"],"mappings":"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"}

package/{common-DaOXYsz4.mjs → common-lMrnzoyn.mjs}

@@ -1,11 +1,11 @@
 import { a as validateOrThrow, i as passesSchema } from "./exceptions-BeWH2FwP.mjs";
-import { c as E_INVALID_INITIAL_RETRIEVABLE_VALUE } from "./runtime-DZ892Rht.mjs";
-import { a as Tokenizable, o as isError, s as isInstanceOf } from "./tool_registry-CiNgQfJR.mjs";
-import "./thought-C5M4KlGw.mjs";
-import "./tool-DDqsPmsX.mjs";
-import { t as SpooledArtifact } from "./spooled_artifact-D_K8dkI5.mjs";
-import "./tool_call-DdqI6Lv7.mjs";
-import "./spooled_markdown_artifact-CSMXhajY.mjs";
+import { a as Tokenizable, o as isError, s as isInstanceOf } from "./tool_registry-BGHg6KTq.mjs";
+import { c as E_INVALID_INITIAL_RETRIEVABLE_VALUE } from "./runtime-j92CNi5z.mjs";
+import "./thought-B_P8LiB6.mjs";
+import "./tool-CRZSUcdP.mjs";
+import { t as SpooledArtifact } from "./spooled_artifact-CWoKUDEm.mjs";
+import "./tool_call-BUeMuCc6.mjs";
+import "./spooled_markdown_artifact-CNle4jXN.mjs";
 import { validator } from "@nhtio/validation";
 //#region src/lib/classes/retrievable.ts
 /**
@@ -271,4 +271,4 @@ var fromWebFile = (file) => {
 //#endregion
 export { implementsByteStore as a, byteStoreSchema as i, fromWebFile as n, Retrievable as o, inMemoryMediaReader as r, fromFetch as t };
 
-//# sourceMappingURL=common-DaOXYsz4.mjs.map
+//# sourceMappingURL=common-lMrnzoyn.mjs.map