@nhtio/adk 1.20260924.0 → 1.20260928.0

package/{toon-b-0pFKZ8.cjs.map → toon-DmLwZ6H1.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"toon-b-0pFKZ8.cjs","names":["#options","#resolveParsed","#hasParsed","#parsed","#loadToonModule","#formatToonError"],"sources":["../src/batteries/artifacts/toon/exceptions.ts","../src/batteries/artifacts/toon/index.ts"],"sourcesContent":["/**\n * Battery-scoped exceptions for the TOON artifact battery.\n *\n * @remarks\n * Internal sibling of the `@nhtio/adk/batteries/artifacts/toon` entry — re-exported from the\n * battery's own barrel per the battery-scoped-exceptions rule. These are the typed errors the\n * implementor-facing API throws; the agent-facing forge catches them and renders readable\n * failure strings the model can act on.\n */\n\nimport { createException } from '@nhtio/adk/factories'\n\n/**\n * Thrown when the TOON peer dependency cannot be loaded.\n *\n * @remarks\n * The @toon-format/toon package is an optional peer. If it is not installed, methods requiring\n * it throw this exception with installation instructions. The message template includes the package\n * name, a description of its purpose, the underlying error, and the exact install command, so the\n * consumer sees a complete, actionable message regardless of call site.\n */\nexport const E_TOON_PEER_MISSING = createException<[string]>(\n  'E_TOON_PEER_MISSING',\n  'the toon battery could not load its peer dependency \"@toon-format/toon\" (needed for TOON format artifact queries): %s — install it (pnpm add @toon-format/toon)',\n  'E_TOON_PEER_MISSING',\n  500\n)\n\n/**\n * Thrown when TOON decoding fails.\n *\n * @remarks\n * Wraps the underlying `ToonDecodeError` from the `@toon-format/toon` package, surfacing its\n * `line` and `source` properties so the model can self-correct.\n */\nexport const E_TOON_DECODE_FAILED = createException<[string]>(\n  'E_TOON_DECODE_FAILED',\n  'TOON decode error: %s',\n  'E_TOON_DECODE_FAILED',\n  422\n)\n","/**\n * TOON artifact battery — structured queries over TOON format artifacts.\n *\n * @module @nhtio/adk/batteries/artifacts/toon\n *\n * @remarks\n * Adds {@link SpooledToonArtifact}, a {@link @nhtio/adk!SpooledArtifact} specialisation for\n * structured TOON queries. TOON encodes the JSON data model in a compact text format; parsing\n * produces the same values as decoding JSON, so queries use {@link https://github.com/JSONPath-Plus/JSONPath JSONPath-Plus} for path navigation, exactly as {@link @nhtio/adk!SpooledJsonArtifact} does.\n *\n * Requires the optional peer `@toon-format/toon` (version `^4.1.1`). If it is not installed,\n * methods requiring it throw {@link E_TOON_PEER_MISSING} with installation instructions.\n *\n * Export note: {@link registerArtifactEncodables} must be called before any attempt to\n * `decode()` a spooled TOON artifact. Call it once at startup:\n *\n * ```ts\n * import { registerArtifactEncodables } from '@nhtio/adk/batteries/artifacts'\n * await registerArtifactEncodables()\n * ```\n */\n\nimport { v6 as uuidv6 } from 'uuid'\nimport { JSONPath } from 'jsonpath-plus'\nimport { validator } from '@nhtio/validation'\nimport { resolveSpoolReader } from '@nhtio/adk/common'\nimport { isInstanceOf, isObject } from '@nhtio/adk/guards'\nimport { E_TOON_PEER_MISSING, E_TOON_DECODE_FAILED } from './exceptions'\nimport {\n  ArtifactTool,\n  SpooledJsonArtifact,\n  Tool,\n  ToolRegistry,\n  ReaderDescriptor,\n} from '@nhtio/adk/common'\n\n// Well-known @nhtio/encoder contract keys, resolved through the global symbol registry.\n// These are identical to the symbols core uses, with no import edge on the optional peer.\nconst ENCODE_METHOD: unique symbol = Symbol.for('@nhtio/encoder:toEncoded')\nconst DECODE_METHOD: unique symbol = Symbol.for('@nhtio/encoder:fromEncoded')\n\n/**\n * Lazily-loaded TOON module, cached as a module-level promise.\n *\n * @remarks\n * Shared across all instances of SpooledToonArtifact. Once the promise resolves or rejects,\n * the same promise is reused for all subsequent calls, ensuring the in-flight promise and\n * any error state are preserved globally.\n */\nlet toonModulePromise: Promise<Record<string, unknown>> | undefined\nimport {\n  SpooledArtifact,\n  collectArtifactCompatibleIds,\n  resolveArtifactById,\n  defaultSerialise,\n} from '@nhtio/adk/spooled_artifact'\nimport type { SpoolReader, ToolMethodDescriptor, DispatchContext } from '@nhtio/adk/types'\n\n/** Snapshot payload for the encoder contract; the encoder treats it as opaque. */\ntype AdkEncodableSnapshot = unknown\n\n/**\n * TOON decode options.\n *\n * @remarks\n * Passed to the `@toon-format/toon` `decode` function.\n */\nexport interface ToonDecodeOptions {\n  /** The indent size used in the TOON encoding (default: 2). */\n  indentSize?: number\n  /** When `true`, reject non-standard TOON (default: `true`). */\n  strict?: boolean\n}\n\n/**\n * A {@link @nhtio/adk!SpooledArtifact} specialisation that adds TOON-aware read operations.\n *\n * @remarks\n * Construct with an optional `options` object to control decoding. When omitted, the TOON is\n * decoded with `strict: true` (default). Once decoded (on first access), the parsed value is\n * cached for the lifetime of the instance.\n *\n * All TOON methods are async, consistent with {@link @nhtio/adk!SpooledArtifact}.\n *\n * Path-based methods (`toon_get`, `toon_filter`, `toon_pluck`) use\n * [JSONPath-Plus](https://github.com/JSONPath-Plus/JSONPath) expressions. Full JSONPath syntax\n * is supported, including recursive descent (`..`), filter expressions (`[?(@.age > 18)]`),\n * and union selectors.\n */\nexport class SpooledToonArtifact extends SpooledArtifact {\n  #parsed: unknown\n  #hasParsed: boolean = false\n  #options: ToonDecodeOptions | undefined\n\n  /**\n   * @param reader - The backing store to read from.\n   * @param options - Optional TOON decode options.\n   */\n  constructor(reader: SpoolReader, options?: ToonDecodeOptions) {\n    super(reader)\n    this.#options = options\n  }\n\n  /**\n   * Returns `true` if `value` is a {@link SpooledToonArtifact} instance.\n   *\n   * @remarks\n   * Uses the cross-realm-safe {@link @nhtio/adk!isInstanceOf} guard: `instanceof` first, then\n   * `Symbol.hasInstance`, then a `constructor.name` fallback. Matches the pattern used by every\n   * other class guard in the ADK; safe against the dual-module-copy case where two distinct\n   * `SpooledToonArtifact` classes coexist in the same realm.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link SpooledToonArtifact} instance.\n   */\n  public static isSpooledToonArtifact(value: unknown): value is SpooledToonArtifact {\n    return isInstanceOf(value, 'SpooledToonArtifact', SpooledToonArtifact)\n  }\n\n  /**\n   * The TOON-specific artifact-query descriptors this class adds on top of the base set.\n   *\n   * @remarks\n   * Lists `artifact_toon_type`, `artifact_toon_keys`, `artifact_toon_length`,\n   * `artifact_toon_get`, `artifact_toon_filter`, `artifact_toon_slice`, `artifact_toon_pluck`.\n   * The base seven descriptors (`artifact_head`, etc.) are NOT included here — they are\n   * forged separately by {@link SpooledToonArtifact.forgeTools}, which calls\n   * `SpooledArtifact.forgeTools(ctx)` to produce the base-narrowed tools and then registers\n   * its own TOON tools on the result. Downstream consumers building custom subclasses\n   * should follow the same pattern: own only your own descriptors; override `forgeTools` to\n   * compose with the base output.\n   */\n  public static toolMethods: ReadonlyArray<ToolMethodDescriptor> = Object.freeze([\n    {\n      name: 'artifact_toon_type',\n      method: 'toon_type',\n      description: 'Return the format of a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({}),\n    },\n    {\n      name: 'artifact_toon_keys',\n      method: 'toon_keys',\n      description: 'Return the top-level keys of a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({}),\n    },\n    {\n      name: 'artifact_toon_length',\n      method: 'toon_length',\n      description:\n        'Return the element count of a TOON artifact produced earlier in this turn (1 if the root is not an array).',\n      argsSchema: validator.object({}),\n    },\n    {\n      name: 'artifact_toon_get',\n      method: 'toon_get',\n      description:\n        'Evaluate a JSONPath expression against a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({\n        path: validator.string().required().description(\"JSONPath expression, e.g. '$.user.name'.\"),\n      }),\n    },\n    {\n      name: 'artifact_toon_filter',\n      method: 'toon_filter',\n      description:\n        'Return elements of a TOON artifact (produced earlier in this turn) matched by a JSONPath filter.',\n      argsSchema: validator.object({\n        path: validator\n          .string()\n          .required()\n          .description(\"JSONPath filter expression, e.g. '$[?(@.age>18)]'.\"),\n      }),\n    },\n    {\n      name: 'artifact_toon_slice',\n      method: 'toon_slice',\n      description:\n        'Return a slice of elements by index range from a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({\n        start: validator\n          .number()\n          .integer()\n          .min(0)\n          .optional()\n          .description('Start index (inclusive).'),\n        end: validator.number().integer().min(0).optional().description('End index (exclusive).'),\n      }),\n    },\n    {\n      name: 'artifact_toon_pluck',\n      method: 'toon_pluck',\n      description:\n        'Return all values matched by a JSONPath expression across a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({\n        path: validator.string().required().description(\"JSONPath expression, e.g. '$..name'.\"),\n      }),\n    },\n  ])\n\n  /**\n   * Forges base-class tools plus TOON-specific tools narrowed to {@link SpooledToonArtifact}.\n   *\n   * @remarks\n   * Standard subclass extension pattern: call `SpooledArtifact.forgeTools(ctx)` to produce\n   * the base seven `artifact_*` tools narrowed to any `SpooledArtifact` in the turn, then\n   * register one `ArtifactTool` per TOON-specific descriptor narrowed to TOON artifacts.\n   * Downstream consumers building their own subclasses should follow the same shape.\n   */\n  public static override forgeTools(ctx: DispatchContext): ToolRegistry {\n    const registry = SpooledArtifact.forgeTools(ctx)\n    const requires = SpooledToonArtifact\n    const compatibleIds = collectArtifactCompatibleIds(ctx, requires)\n    if (compatibleIds.length === 0) return registry\n\n    for (const descriptor of this.toolMethods) {\n      const callIdSchema = validator\n        .string()\n        .valid(...compatibleIds)\n        .required()\n        .description('ToolCall id of the artifact to query.')\n\n      const argsSchema = (\n        descriptor.argsSchema ?? validator.object<Record<string, never>>({})\n      ).append({\n        callId: callIdSchema,\n      })\n\n      const tool = new ArtifactTool({\n        name: descriptor.name,\n        description: descriptor.description,\n        inputSchema: argsSchema,\n        ephemeral: true,\n        onCollision: 'replace',\n        handler: async (rawArgs, ctxInner) => {\n          const args = rawArgs as Record<string, unknown> & { callId: string }\n          const resolved = resolveArtifactById(ctxInner, args.callId, requires)\n          if (!resolved) return `Error: no artifact with id ${args.callId} in this turn`\n          const artifact = resolved.artifact\n          const methodArgs: unknown[] = []\n          if (\n            descriptor.method === 'toon_get' ||\n            descriptor.method === 'toon_filter' ||\n            descriptor.method === 'toon_pluck'\n          ) {\n            methodArgs.push(args.path as string)\n          } else if (descriptor.method === 'toon_slice') {\n            methodArgs.push(args.start as number | undefined, args.end as number | undefined)\n          }\n          const fn = (artifact as unknown as Record<string, (...a: unknown[]) => unknown>)[\n            descriptor.method\n          ]\n          if (typeof fn !== 'function') {\n            return `Error: artifact has no method ${descriptor.method}`\n          }\n          const result = await Promise.resolve(fn.apply(artifact, methodArgs))\n          const serialise = descriptor.serialise ?? defaultSerialise\n          return serialise(result)\n        },\n      })\n      registry.register(tool)\n    }\n    return registry\n  }\n\n  /**\n   * Parses and caches the TOON content.\n   *\n   * @remarks\n   * On first access, decodes the TOON source and caches the parsed value. Subsequent calls\n   * return the cached value without re-parsing.\n   *\n   * @returns The parsed TOON value.\n   */\n  async #resolveParsed(): Promise<unknown> {\n    if (this.#hasParsed) {\n      return this.#parsed\n    }\n    const toonModule = await this.#loadToonModule()\n    const text = await this.asString()\n    try {\n      const decode = toonModule.decode as (text: string, opts: Record<string, unknown>) => unknown\n      this.#parsed = decode(text, {\n        indentSize: this.#options?.indentSize ?? 2,\n        strict: this.#options?.strict ?? true,\n      })\n    } catch (err) {\n      const message = this.#formatToonError(err)\n      throw new E_TOON_DECODE_FAILED([message])\n    }\n    this.#hasParsed = true\n    return this.#parsed\n  }\n\n  /**\n   * Formats an error from the TOON decoder, including line number and source.\n   */\n  #formatToonError(err: unknown): string {\n    if (isObject(err) && (err as Record<string, unknown>).name === 'ToonDecodeError') {\n      const toonErr = err as { line?: number; source?: string; message?: string }\n      const line = toonErr.line ?? '?'\n      const source = toonErr.source ?? '(no source)'\n      return `line ${line}: ${source}`\n    }\n    return String((err as Record<string, unknown>).message ?? err)\n  }\n\n  /**\n   * Loads the TOON module lazily, with error handling.\n   *\n   * @remarks\n   * Uses the module-level `toonModulePromise` to ensure the in-flight promise and error state\n   * are shared across all instances of SpooledToonArtifact.\n   */\n  async #loadToonModule() {\n    toonModulePromise ??= import('@toon-format/toon').catch((err: unknown) => {\n      throw new E_TOON_PEER_MISSING([String(err)])\n    })\n    return (await toonModulePromise) as Record<string, unknown>\n  }\n\n  /**\n   * Returns the format of a TOON artifact.\n   *\n   * @remarks\n   * Reports only the format name. The delimiter is deliberately not reported: the TOON decoder\n   * exposes no delimiter information, and every method of inferring one from the source proved\n   * unreliable for some class of strict-valid document. Four distinct approaches were attempted,\n   * each defeated by its own edge case:\n   * - Lexical scanning for the delimiter character failed on unquoted pipes inside values\n   * - Anchored header regex requiring a word key failed on quoted keys and keyless root arrays\n   * - Widened regex accepting quoted keys failed on escaped quotes within the key (e.g., \"a\\\"b\")\n   * - Byte-exact round-trip re-encoding failed on non-canonical formatting (indentation, line\n   *   endings, trailing newlines)\n   *\n   * Delimiter inference is no longer attempted: nothing in the model's workflow needs it, and\n   * the TOON decoder is the source of truth for all document metadata.\n   *\n   * This result is cached after the first parse and returned identically on every call.\n   *\n   * @returns An object with `format: 'toon'`.\n   */\n  async toon_type(): Promise<{ format: string }> {\n    await this.#resolveParsed()\n    return { format: 'toon' }\n  }\n\n  /**\n   * Returns the top-level keys of the parsed TOON content.\n   *\n   * @remarks\n   * - If the root is an object, returns its keys.\n   * - If the root is not a plain object (e.g. an array or scalar), returns `undefined`.\n   *\n   * @returns Array of key strings, or `undefined` when the root is not an object.\n   */\n  async toon_keys(): Promise<string[] | undefined> {\n    const value = await this.#resolveParsed()\n    if (isObject(value)) {\n      return Object.keys(value as object)\n    }\n    return undefined\n  }\n\n  /**\n   * Returns the element count of the parsed TOON content.\n   *\n   * @remarks\n   * - If the root is an array, returns the array length.\n   * - Otherwise, returns `1` (the root is a single element).\n   *\n   * @returns The element count.\n   */\n  async toon_length(): Promise<number> {\n    const value = await this.#resolveParsed()\n    if (Array.isArray(value)) {\n      return value.length\n    }\n    return 1\n  }\n\n  /**\n   * Evaluates a JSONPath expression against the parsed TOON content.\n   *\n   * @remarks\n   * Uses [JSONPath-Plus](https://github.com/JSONPath-Plus/JSONPath). Full JSONPath syntax is\n   * supported: recursive descent (`$..*`), filter expressions (`$[?(@.age > 18)]`), union\n   * selectors, and more.\n   *\n   * @param path - A JSONPath expression (e.g. `'$.user.address.city'`, `'$..name'`).\n   * @returns Array of matched values. Empty array when no matches are found.\n   */\n  async toon_get(path: string): Promise<unknown[]> {\n    const value = await this.#resolveParsed()\n    return JSONPath({ path, json: value as object })\n  }\n\n  /**\n   * Returns elements matched by a JSONPath filter expression.\n   *\n   * @remarks\n   * Evaluates `path` against the root value and returns it in an array if matched.\n   *\n   * @param path - A JSONPath expression (e.g. `'$[?(@.status === \"active\")]'`).\n   * @returns Array of matching elements (at most one element, the root if matched).\n   */\n  async toon_filter(path: string): Promise<unknown[]> {\n    const value = await this.#resolveParsed()\n    const matches = JSONPath({ path, json: value as object })\n    return Array.isArray(matches) && matches.length > 0 ? [value] : []\n  }\n\n  /**\n   * Returns a slice of the parsed content by index range.\n   *\n   * @remarks\n   * - If the root is an array, behaves like `Array.prototype.slice`.\n   * - If the root is not an array, returns the entire root in an array.\n   *\n   * @param start - Start index (inclusive). Defaults to `0`.\n   * @param end - End index (exclusive). Defaults to the element count.\n   * @returns Array of sliced elements.\n   */\n  async toon_slice(start?: number, end?: number): Promise<unknown[]> {\n    const value = await this.#resolveParsed()\n    if (Array.isArray(value)) {\n      return value.slice(start, end)\n    }\n    return [value]\n  }\n\n  /**\n   * Returns all values matched by a JSONPath expression.\n   *\n   * @remarks\n   * Convenience over {@link SpooledToonArtifact.toon_get} with an identical signature — use\n   * whichever name better communicates intent at the call site. `toon_pluck` reads well for\n   * extracting a single field; `toon_get` reads well for structured queries.\n   *\n   * @param path - A JSONPath expression (e.g. `'$..name'`).\n   * @returns Array of matched values.\n   */\n  async toon_pluck(path: string): Promise<unknown[]> {\n    return this.toon_get(path)\n  }\n\n  /**\n   * Serialise this SpooledToonArtifact into an `@nhtio/encoder` snapshot — the reader **handle** plus\n   * the decode `options`.\n   *\n   * @remarks\n   * Overrides {@link SpooledArtifact.[ENCODE_METHOD]} to carry the constructor's `options` (the\n   * parsed-value cache is derived and not encoded). Round-trips via\n   * {@link SpooledToonArtifact.[DECODE_METHOD]}.\n   *\n   * @returns A snapshot consumed by {@link SpooledToonArtifact.[DECODE_METHOD]}.\n   */\n  [ENCODE_METHOD](): AdkEncodableSnapshot {\n    return { reader: this.readerDescriptor(), options: this.#options }\n  }\n\n  /**\n   * Reconstruct a {@link SpooledToonArtifact} from a {@link SpooledToonArtifact.[ENCODE_METHOD]}\n   * snapshot.\n   *\n   * @param data - The snapshot produced by {@link SpooledToonArtifact.[ENCODE_METHOD]}.\n   * @returns A fresh {@link SpooledToonArtifact}} backed by a freshly-resolved reader.\n   */\n  static [DECODE_METHOD](data: AdkEncodableSnapshot): SpooledToonArtifact {\n    const snapshot = data as {\n      reader: ReaderDescriptor\n      options?: ToonDecodeOptions\n    }\n    return new SpooledToonArtifact(resolveSpoolReader(snapshot.reader), snapshot.options)\n  }\n}\n\n/**\n * Converter tool: TOON to JSON.\n *\n * @remarks\n * Accepts either inline TOON text or a reference to an artifact produced earlier in this turn.\n * Converts to JSON and returns a new {@link @nhtio/adk!SpooledJsonArtifact}.\n *\n * This is a plain {@link @nhtio/adk!Tool}, not an {@link @nhtio/adk!ArtifactTool} — the handler\n * returns the new artifact directly, allowing the forge to discover and query it on the next\n * iteration without explicit wiring.\n */\nexport const toonToJsonTool: Tool = new Tool({\n  name: 'toon_to_json',\n  description: 'Convert inline TOON text or a TOON artifact to JSON.',\n  inputSchema: validator.object({\n    text: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('Inline TOON text. Provide this or call_id, not both.'),\n    call_id: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('ToolCall id of a TOON artifact produced earlier in this turn.'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (rawArgs: unknown, ctx: DispatchContext) => {\n    const args = rawArgs as { text?: string; call_id?: string }\n    const text = args.text ?? ''\n    const callId = args.call_id ?? ''\n\n    const hasText = text.length > 0\n    const hasCallId = callId.length > 0\n\n    if (!hasText && !hasCallId) {\n      return 'Error: provide either text or call_id, not neither'\n    }\n    if (hasText && hasCallId) {\n      return 'Error: provide either text or call_id, not both'\n    }\n\n    let toonContent: string\n    if (hasCallId) {\n      const resolved = resolveArtifactById(ctx, callId, SpooledToonArtifact)\n      if (!resolved) {\n        return `Error: no TOON artifact with id ${callId} in this turn`\n      }\n      toonContent = await resolved.artifact.asString()\n    } else {\n      toonContent = text\n    }\n\n    const toonModule = await import('@toon-format/toon').catch((err: unknown) => {\n      throw new E_TOON_PEER_MISSING([String(err)])\n    })\n\n    let parsed: unknown\n    try {\n      const decode = toonModule.decode as (text: string, opts: Record<string, unknown>) => unknown\n      parsed = decode(toonContent, { indentSize: 2, strict: true })\n    } catch (err) {\n      const message =\n        isObject(err) && (err as Record<string, unknown>).name === 'ToonDecodeError'\n          ? `line ${(err as { line?: number }).line ?? '?'}: ${(err as { source?: string }).source ?? '(no source)'}`\n          : String((err as Record<string, unknown>).message ?? err)\n      return `Error: failed to decode TOON: ${message}`\n    }\n\n    const json = JSON.stringify(parsed, null, 2)\n    const sourceId = hasCallId ? callId : uuidv6()\n    const reader = await ctx.storeRetrievableBytes(`${ctx.id}:toon_to_json:${sourceId}`, json)\n    return new SpooledJsonArtifact(reader)\n  },\n})\n\n/**\n * Converter tool: JSON to TOON.\n *\n * @remarks\n * Accepts either inline JSON text or a reference to a JSON artifact produced earlier in this turn.\n * Converts to TOON and returns a new {@link SpooledToonArtifact}.\n *\n * This is a plain {@link @nhtio/adk!Tool}, not an {@link @nhtio/adk!ArtifactTool} — the handler\n * returns the new artifact directly, allowing the forge to discover and query it on the next\n * iteration without explicit wiring.\n */\nexport const jsonToToonTool: Tool = new Tool({\n  name: 'json_to_toon',\n  description: 'Convert inline JSON text or a JSON artifact to TOON.',\n  inputSchema: validator.object({\n    text: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('Inline JSON text. Provide this or call_id, not both.'),\n    call_id: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('ToolCall id of a JSON artifact produced earlier in this turn.'),\n  }),\n  artifactConstructor: () => SpooledToonArtifact,\n  handler: async (rawArgs: unknown, ctx: DispatchContext) => {\n    const args = rawArgs as { text?: string; call_id?: string }\n    const text = args.text ?? ''\n    const callId = args.call_id ?? ''\n\n    const hasText = text.length > 0\n    const hasCallId = callId.length > 0\n\n    if (!hasText && !hasCallId) {\n      return 'Error: provide either text or call_id, not neither'\n    }\n    if (hasText && hasCallId) {\n      return 'Error: provide either text or call_id, not both'\n    }\n\n    let jsonContent: string\n    if (hasCallId) {\n      const resolved = resolveArtifactById(ctx, callId, SpooledJsonArtifact)\n      if (!resolved) {\n        return `Error: no JSON artifact with id ${callId} in this turn`\n      }\n      jsonContent = await resolved.artifact.asString()\n    } else {\n      jsonContent = text\n    }\n\n    let parsed: unknown\n    try {\n      parsed = JSON.parse(jsonContent)\n    } catch (err) {\n      return `Error: failed to parse JSON: ${String((err as Record<string, unknown>).message ?? err)}`\n    }\n\n    const toonModule = await import('@toon-format/toon').catch((err: unknown) => {\n      throw new E_TOON_PEER_MISSING([String(err)])\n    })\n\n    let toon: string\n    try {\n      const encode = toonModule.encode as (val: unknown, opts: Record<string, unknown>) => string\n      toon = encode(parsed, { indentSize: 2 })\n    } catch (err) {\n      return `Error: failed to encode TOON: ${String((err as Record<string, unknown>).message ?? err)}`\n    }\n\n    const sourceId = hasCallId ? callId : uuidv6()\n    const reader = await ctx.storeRetrievableBytes(`${ctx.id}:json_to_toon:${sourceId}`, toon)\n    return new SpooledToonArtifact(reader)\n  },\n})\n\n/**\n * Exports for the public barrel.\n */\nexport { E_TOON_PEER_MISSING, E_TOON_DECODE_FAILED } from './exceptions'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,sBAAsB,mBAAA,gBACjC,uBACA,qKACA,uBACA,GACF;;;;;;;;AASA,IAAa,uBAAuB,mBAAA,gBAClC,wBACA,yBACA,wBACA,GACF;;;;;;;;;;;;;;;;;;;;;;;;ACFA,IAAM,gBAA+B,OAAO,IAAI,0BAA0B;AAC1E,IAAM,gBAA+B,OAAO,IAAI,4BAA4B;;;;;;;;;AAU5E,IAAI;;;;;;;;;;;;;;;;AAwCJ,IAAa,sBAAb,MAAa,4BAA4B,yBAAA,gBAAgB;CACvD;CACA,aAAsB;CACtB;;;;;CAMA,YAAY,QAAqB,SAA6B;EAC5D,MAAM,MAAM;EACZ,KAAKA,WAAW;CAClB;;;;;;;;;;;;;CAcA,OAAc,sBAAsB,OAA8C;EAChF,OAAO,eAAA,aAAa,OAAO,uBAAuB,mBAAmB;CACvE;;;;;;;;;;;;;;CAeA,OAAc,cAAmD,OAAO,OAAO;EAC7E;GACE,MAAM;GACN,QAAQ;GACR,aAAa;GACb,YAAY,kBAAA,UAAU,OAAO,CAAC,CAAC;EACjC;EACA;GACE,MAAM;GACN,QAAQ;GACR,aAAa;GACb,YAAY,kBAAA,UAAU,OAAO,CAAC,CAAC;EACjC;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,CAAC,CAAC;EACjC;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,EAC3B,MAAM,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,0CAA0C,EAC5F,CAAC;EACH;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,EAC3B,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,YAAY,oDAAoD,EACrE,CAAC;EACH;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO;IAC3B,OAAO,kBAAA,UACJ,OAAO,EACP,QAAQ,EACR,IAAI,CAAC,EACL,SAAS,EACT,YAAY,0BAA0B;IACzC,KAAK,kBAAA,UAAU,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,wBAAwB;GAC1F,CAAC;EACH;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,EAC3B,MAAM,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,sCAAsC,EACxF,CAAC;EACH;CACF,CAAC;;;;;;;;;;CAWD,OAAuB,WAAW,KAAoC;EACpE,MAAM,WAAW,yBAAA,gBAAgB,WAAW,GAAG;EAC/C,MAAM,WAAW;EACjB,MAAM,gBAAgB,yBAAA,6BAA6B,KAAK,QAAQ;EAChE,IAAI,cAAc,WAAW,GAAG,OAAO;EAEvC,KAAK,MAAM,cAAc,KAAK,aAAa;GACzC,MAAM,eAAe,kBAAA,UAClB,OAAO,EACP,MAAM,GAAG,aAAa,EACtB,SAAS,EACT,YAAY,uCAAuC;GAEtD,MAAM,cACJ,WAAW,cAAc,kBAAA,UAAU,OAA8B,CAAC,CAAC,GACnE,OAAO,EACP,QAAQ,aACV,CAAC;GAED,MAAM,OAAO,IAAI,yBAAA,aAAa;IAC5B,MAAM,WAAW;IACjB,aAAa,WAAW;IACxB,aAAa;IACb,WAAW;IACX,aAAa;IACb,SAAS,OAAO,SAAS,aAAa;KACpC,MAAM,OAAO;KACb,MAAM,WAAW,yBAAA,oBAAoB,UAAU,KAAK,QAAQ,QAAQ;KACpE,IAAI,CAAC,UAAU,OAAO,8BAA8B,KAAK,OAAO;KAChE,MAAM,WAAW,SAAS;KAC1B,MAAM,aAAwB,CAAC;KAC/B,IACE,WAAW,WAAW,cACtB,WAAW,WAAW,iBACtB,WAAW,WAAW,cAEtB,WAAW,KAAK,KAAK,IAAc;UAC9B,IAAI,WAAW,WAAW,cAC/B,WAAW,KAAK,KAAK,OAA6B,KAAK,GAAyB;KAElF,MAAM,KAAM,SACV,WAAW;KAEb,IAAI,OAAO,OAAO,YAChB,OAAO,iCAAiC,WAAW;KAErD,MAAM,SAAS,MAAM,QAAQ,QAAQ,GAAG,MAAM,UAAU,UAAU,CAAC;KAEnE,QADkB,WAAW,aAAa,yBAAA,kBACzB,MAAM;IACzB;GACF,CAAC;GACD,SAAS,SAAS,IAAI;EACxB;EACA,OAAO;CACT;;;;;;;;;;CAWA,MAAMC,iBAAmC;EACvC,IAAI,KAAKC,YACP,OAAO,KAAKC;EAEd,MAAM,aAAa,MAAM,KAAKC,gBAAgB;EAC9C,MAAM,OAAO,MAAM,KAAK,SAAS;EACjC,IAAI;GACF,MAAM,SAAS,WAAW;GAC1B,KAAKD,UAAU,OAAO,MAAM;IAC1B,YAAY,KAAKH,UAAU,cAAc;IACzC,QAAQ,KAAKA,UAAU,UAAU;GACnC,CAAC;EACH,SAAS,KAAK;GAEZ,MAAM,IAAI,qBAAqB,CADf,KAAKK,iBAAiB,GACN,CAAO,CAAC;EAC1C;EACA,KAAKH,aAAa;EAClB,OAAO,KAAKC;CACd;;;;CAKA,iBAAiB,KAAsB;EACrC,IAAI,eAAA,SAAS,GAAG,KAAM,IAAgC,SAAS,mBAAmB;GAChF,MAAM,UAAU;GAGhB,OAAO,QAFM,QAAQ,QAAQ,IAET,IADL,QAAQ,UAAU;EAEnC;EACA,OAAO,OAAQ,IAAgC,WAAW,GAAG;CAC/D;;;;;;;;CASA,MAAMC,kBAAkB;EACtB,sBAAsB,OAAO,qBAAqB,OAAO,QAAiB;GACxE,MAAM,IAAI,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;EAC7C,CAAC;EACD,OAAQ,MAAM;CAChB;;;;;;;;;;;;;;;;;;;;;;CAuBA,MAAM,YAAyC;EAC7C,MAAM,KAAKH,eAAe;EAC1B,OAAO,EAAE,QAAQ,OAAO;CAC1B;;;;;;;;;;CAWA,MAAM,YAA2C;EAC/C,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,IAAI,eAAA,SAAS,KAAK,GAChB,OAAO,OAAO,KAAK,KAAe;CAGtC;;;;;;;;;;CAWA,MAAM,cAA+B;EACnC,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM;EAEf,OAAO;CACT;;;;;;;;;;;;CAaA,MAAM,SAAS,MAAkC;EAE/C,QAAA,GAAA,cAAA,UAAgB;GAAE;GAAM,MAAM,MADV,KAAKA,eAAe;EACM,CAAC;CACjD;;;;;;;;;;CAWA,MAAM,YAAY,MAAkC;EAClD,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,MAAM,WAAA,GAAA,cAAA,UAAmB;GAAE;GAAM,MAAM;EAAgB,CAAC;EACxD,OAAO,MAAM,QAAQ,OAAO,KAAK,QAAQ,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC;CACnE;;;;;;;;;;;;CAaA,MAAM,WAAW,OAAgB,KAAkC;EACjE,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM,MAAM,OAAO,GAAG;EAE/B,OAAO,CAAC,KAAK;CACf;;;;;;;;;;;;CAaA,MAAM,WAAW,MAAkC;EACjD,OAAO,KAAK,SAAS,IAAI;CAC3B;;;;;;;;;;;;CAaA,CAAC,iBAAuC;EACtC,OAAO;GAAE,QAAQ,KAAK,iBAAiB;GAAG,SAAS,KAAKD;EAAS;CACnE;;;;;;;;CASA,QAAQ,eAAe,MAAiD;EACtE,MAAM,WAAW;EAIjB,OAAO,IAAI,oBAAoB,yBAAA,mBAAmB,SAAS,MAAM,GAAG,SAAS,OAAO;CACtF;AACF;;;;;;;;;;;;AAaA,IAAa,iBAAuB,IAAI,yBAAA,KAAK;CAC3C,MAAM;CACN,aAAa;CACb,aAAa,kBAAA,UAAU,OAAO;EAC5B,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,sDAAsD;EACrE,SAAS,kBAAA,UACN,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,+DAA+D;CAChF,CAAC;CACD,2BAA2B,kCAAA;CAC3B,SAAS,OAAO,SAAkB,QAAyB;EACzD,MAAM,OAAO;EACb,MAAM,OAAO,KAAK,QAAQ;EAC1B,MAAM,SAAS,KAAK,WAAW;EAE/B,MAAM,UAAU,KAAK,SAAS;EAC9B,MAAM,YAAY,OAAO,SAAS;EAElC,IAAI,CAAC,WAAW,CAAC,WACf,OAAO;EAET,IAAI,WAAW,WACb,OAAO;EAGT,IAAI;EACJ,IAAI,WAAW;GACb,MAAM,WAAW,yBAAA,oBAAoB,KAAK,QAAQ,mBAAmB;GACrE,IAAI,CAAC,UACH,OAAO,mCAAmC,OAAO;GAEnD,cAAc,MAAM,SAAS,SAAS,SAAS;EACjD,OACE,cAAc;EAGhB,MAAM,aAAa,MAAM,OAAO,qBAAqB,OAAO,QAAiB;GAC3E,MAAM,IAAI,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;EAC7C,CAAC;EAED,IAAI;EACJ,IAAI;GACF,MAAM,SAAS,WAAW;GAC1B,SAAS,OAAO,aAAa;IAAE,YAAY;IAAG,QAAQ;GAAK,CAAC;EAC9D,SAAS,KAAK;GAKZ,OAAO,iCAHL,eAAA,SAAS,GAAG,KAAM,IAAgC,SAAS,oBACvD,QAAS,IAA0B,QAAQ,IAAI,IAAK,IAA4B,UAAU,kBAC1F,OAAQ,IAAgC,WAAW,GAAG;EAE9D;EAEA,MAAM,OAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;EAC3C,MAAM,WAAW,YAAY,UAAA,GAAA,KAAA,IAAgB;EAE7C,OAAO,IAAI,kCAAA,oBAAoB,MADV,IAAI,sBAAsB,GAAG,IAAI,GAAG,gBAAgB,YAAY,IAAI,CACpD;CACvC;AACF,CAAC;;;;;;;;;;;;AAaD,IAAa,iBAAuB,IAAI,yBAAA,KAAK;CAC3C,MAAM;CACN,aAAa;CACb,aAAa,kBAAA,UAAU,OAAO;EAC5B,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,sDAAsD;EACrE,SAAS,kBAAA,UACN,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,+DAA+D;CAChF,CAAC;CACD,2BAA2B;CAC3B,SAAS,OAAO,SAAkB,QAAyB;EACzD,MAAM,OAAO;EACb,MAAM,OAAO,KAAK,QAAQ;EAC1B,MAAM,SAAS,KAAK,WAAW;EAE/B,MAAM,UAAU,KAAK,SAAS;EAC9B,MAAM,YAAY,OAAO,SAAS;EAElC,IAAI,CAAC,WAAW,CAAC,WACf,OAAO;EAET,IAAI,WAAW,WACb,OAAO;EAGT,IAAI;EACJ,IAAI,WAAW;GACb,MAAM,WAAW,yBAAA,oBAAoB,KAAK,QAAQ,kCAAA,mBAAmB;GACrE,IAAI,CAAC,UACH,OAAO,mCAAmC,OAAO;GAEnD,cAAc,MAAM,SAAS,SAAS,SAAS;EACjD,OACE,cAAc;EAGhB,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,WAAW;EACjC,SAAS,KAAK;GACZ,OAAO,gCAAgC,OAAQ,IAAgC,WAAW,GAAG;EAC/F;EAEA,MAAM,aAAa,MAAM,OAAO,qBAAqB,OAAO,QAAiB;GAC3E,MAAM,IAAI,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;EAC7C,CAAC;EAED,IAAI;EACJ,IAAI;GACF,MAAM,SAAS,WAAW;GAC1B,OAAO,OAAO,QAAQ,EAAE,YAAY,EAAE,CAAC;EACzC,SAAS,KAAK;GACZ,OAAO,iCAAiC,OAAQ,IAAgC,WAAW,GAAG;EAChG;EAEA,MAAM,WAAW,YAAY,UAAA,GAAA,KAAA,IAAgB;EAE7C,OAAO,IAAI,oBAAoB,MADV,IAAI,sBAAsB,GAAG,IAAI,GAAG,gBAAgB,YAAY,IAAI,CACpD;CACvC;AACF,CAAC"}
+{"version":3,"file":"toon-DmLwZ6H1.cjs","names":["#options","#resolveParsed","#hasParsed","#parsed","#loadToonModule","#formatToonError"],"sources":["../src/batteries/artifacts/toon/exceptions.ts","../src/batteries/artifacts/toon/index.ts"],"sourcesContent":["/**\n * Battery-scoped exceptions for the TOON artifact battery.\n *\n * @remarks\n * Internal sibling of the `@nhtio/adk/batteries/artifacts/toon` entry — re-exported from the\n * battery's own barrel per the battery-scoped-exceptions rule. These are the typed errors the\n * implementor-facing API throws; the agent-facing forge catches them and renders readable\n * failure strings the model can act on.\n */\n\nimport { createException } from '@nhtio/adk/factories'\n\n/**\n * Thrown when the TOON peer dependency cannot be loaded.\n *\n * @remarks\n * The @toon-format/toon package is an optional peer. If it is not installed, methods requiring\n * it throw this exception with installation instructions. The message template includes the package\n * name, a description of its purpose, the underlying error, and the exact install command, so the\n * consumer sees a complete, actionable message regardless of call site.\n */\nexport const E_TOON_PEER_MISSING = createException<[string]>(\n  'E_TOON_PEER_MISSING',\n  'the toon battery could not load its peer dependency \"@toon-format/toon\" (needed for TOON format artifact queries): %s — install it (pnpm add @toon-format/toon)',\n  'E_TOON_PEER_MISSING',\n  500\n)\n\n/**\n * Thrown when TOON decoding fails.\n *\n * @remarks\n * Wraps the underlying `ToonDecodeError` from the `@toon-format/toon` package, surfacing its\n * `line` and `source` properties so the model can self-correct.\n */\nexport const E_TOON_DECODE_FAILED = createException<[string]>(\n  'E_TOON_DECODE_FAILED',\n  'TOON decode error: %s',\n  'E_TOON_DECODE_FAILED',\n  422\n)\n","/**\n * TOON artifact battery — structured queries over TOON format artifacts.\n *\n * @module @nhtio/adk/batteries/artifacts/toon\n *\n * @remarks\n * Adds {@link SpooledToonArtifact}, a {@link @nhtio/adk!SpooledArtifact} specialisation for\n * structured TOON queries. TOON encodes the JSON data model in a compact text format; parsing\n * produces the same values as decoding JSON, so queries use {@link https://github.com/JSONPath-Plus/JSONPath JSONPath-Plus} for path navigation, exactly as {@link @nhtio/adk!SpooledJsonArtifact} does.\n *\n * Requires the optional peer `@toon-format/toon` (version `^4.1.1`). If it is not installed,\n * methods requiring it throw {@link E_TOON_PEER_MISSING} with installation instructions.\n *\n * Export note: {@link registerArtifactEncodables} must be called before any attempt to\n * `decode()` a spooled TOON artifact. Call it once at startup:\n *\n * ```ts\n * import { registerArtifactEncodables } from '@nhtio/adk/batteries/artifacts'\n * await registerArtifactEncodables()\n * ```\n */\n\nimport { v6 as uuidv6 } from 'uuid'\nimport { JSONPath } from 'jsonpath-plus'\nimport { validator } from '@nhtio/validation'\nimport { resolveSpoolReader } from '@nhtio/adk/common'\nimport { isInstanceOf, isObject } from '@nhtio/adk/guards'\nimport { E_TOON_PEER_MISSING, E_TOON_DECODE_FAILED } from './exceptions'\nimport {\n  ArtifactTool,\n  SpooledJsonArtifact,\n  Tool,\n  ToolRegistry,\n  ReaderDescriptor,\n} from '@nhtio/adk/common'\n\n// Well-known @nhtio/encoder contract keys, resolved through the global symbol registry.\n// These are identical to the symbols core uses, with no import edge on the optional peer.\nconst ENCODE_METHOD: unique symbol = Symbol.for('@nhtio/encoder:toEncoded')\nconst DECODE_METHOD: unique symbol = Symbol.for('@nhtio/encoder:fromEncoded')\n\n/**\n * Lazily-loaded TOON module, cached as a module-level promise.\n *\n * @remarks\n * Shared across all instances of SpooledToonArtifact. Once the promise resolves or rejects,\n * the same promise is reused for all subsequent calls, ensuring the in-flight promise and\n * any error state are preserved globally.\n */\nlet toonModulePromise: Promise<Record<string, unknown>> | undefined\nimport {\n  SpooledArtifact,\n  collectArtifactCompatibleIds,\n  resolveArtifactById,\n  defaultSerialise,\n} from '@nhtio/adk/spooled_artifact'\nimport type { SpoolReader, ToolMethodDescriptor, DispatchContext } from '@nhtio/adk/types'\n\n/** Snapshot payload for the encoder contract; the encoder treats it as opaque. */\ntype AdkEncodableSnapshot = unknown\n\n/**\n * TOON decode options.\n *\n * @remarks\n * Passed to the `@toon-format/toon` `decode` function.\n */\nexport interface ToonDecodeOptions {\n  /** The indent size used in the TOON encoding (default: 2). */\n  indentSize?: number\n  /** When `true`, reject non-standard TOON (default: `true`). */\n  strict?: boolean\n}\n\n/**\n * A {@link @nhtio/adk!SpooledArtifact} specialisation that adds TOON-aware read operations.\n *\n * @remarks\n * Construct with an optional `options` object to control decoding. When omitted, the TOON is\n * decoded with `strict: true` (default). Once decoded (on first access), the parsed value is\n * cached for the lifetime of the instance.\n *\n * All TOON methods are async, consistent with {@link @nhtio/adk!SpooledArtifact}.\n *\n * Path-based methods (`toon_get`, `toon_filter`, `toon_pluck`) use\n * [JSONPath-Plus](https://github.com/JSONPath-Plus/JSONPath) expressions. Full JSONPath syntax\n * is supported, including recursive descent (`..`), filter expressions (`[?(@.age > 18)]`),\n * and union selectors.\n */\nexport class SpooledToonArtifact extends SpooledArtifact {\n  #parsed: unknown\n  #hasParsed: boolean = false\n  #options: ToonDecodeOptions | undefined\n\n  /**\n   * @param reader - The backing store to read from.\n   * @param options - Optional TOON decode options.\n   */\n  constructor(reader: SpoolReader, options?: ToonDecodeOptions) {\n    super(reader)\n    this.#options = options\n  }\n\n  /**\n   * Returns `true` if `value` is a {@link SpooledToonArtifact} instance.\n   *\n   * @remarks\n   * Uses the cross-realm-safe {@link @nhtio/adk!isInstanceOf} guard: `instanceof` first, then\n   * `Symbol.hasInstance`, then a `constructor.name` fallback. Matches the pattern used by every\n   * other class guard in the ADK; safe against the dual-module-copy case where two distinct\n   * `SpooledToonArtifact` classes coexist in the same realm.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link SpooledToonArtifact} instance.\n   */\n  public static isSpooledToonArtifact(value: unknown): value is SpooledToonArtifact {\n    return isInstanceOf(value, 'SpooledToonArtifact', SpooledToonArtifact)\n  }\n\n  /**\n   * The TOON-specific artifact-query descriptors this class adds on top of the base set.\n   *\n   * @remarks\n   * Lists `artifact_toon_type`, `artifact_toon_keys`, `artifact_toon_length`,\n   * `artifact_toon_get`, `artifact_toon_filter`, `artifact_toon_slice`, `artifact_toon_pluck`.\n   * The base seven descriptors (`artifact_head`, etc.) are NOT included here — they are\n   * forged separately by {@link SpooledToonArtifact.forgeTools}, which calls\n   * `SpooledArtifact.forgeTools(ctx)` to produce the base-narrowed tools and then registers\n   * its own TOON tools on the result. Downstream consumers building custom subclasses\n   * should follow the same pattern: own only your own descriptors; override `forgeTools` to\n   * compose with the base output.\n   */\n  public static toolMethods: ReadonlyArray<ToolMethodDescriptor> = Object.freeze([\n    {\n      name: 'artifact_toon_type',\n      method: 'toon_type',\n      description: 'Return the format of a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({}),\n    },\n    {\n      name: 'artifact_toon_keys',\n      method: 'toon_keys',\n      description: 'Return the top-level keys of a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({}),\n    },\n    {\n      name: 'artifact_toon_length',\n      method: 'toon_length',\n      description:\n        'Return the element count of a TOON artifact produced earlier in this turn (1 if the root is not an array).',\n      argsSchema: validator.object({}),\n    },\n    {\n      name: 'artifact_toon_get',\n      method: 'toon_get',\n      description:\n        'Evaluate a JSONPath expression against a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({\n        path: validator.string().required().description(\"JSONPath expression, e.g. '$.user.name'.\"),\n      }),\n    },\n    {\n      name: 'artifact_toon_filter',\n      method: 'toon_filter',\n      description:\n        'Return elements of a TOON artifact (produced earlier in this turn) matched by a JSONPath filter.',\n      argsSchema: validator.object({\n        path: validator\n          .string()\n          .required()\n          .description(\"JSONPath filter expression, e.g. '$[?(@.age>18)]'.\"),\n      }),\n    },\n    {\n      name: 'artifact_toon_slice',\n      method: 'toon_slice',\n      description:\n        'Return a slice of elements by index range from a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({\n        start: validator\n          .number()\n          .integer()\n          .min(0)\n          .optional()\n          .description('Start index (inclusive).'),\n        end: validator.number().integer().min(0).optional().description('End index (exclusive).'),\n      }),\n    },\n    {\n      name: 'artifact_toon_pluck',\n      method: 'toon_pluck',\n      description:\n        'Return all values matched by a JSONPath expression across a TOON artifact produced earlier in this turn.',\n      argsSchema: validator.object({\n        path: validator.string().required().description(\"JSONPath expression, e.g. '$..name'.\"),\n      }),\n    },\n  ])\n\n  /**\n   * Forges base-class tools plus TOON-specific tools narrowed to {@link SpooledToonArtifact}.\n   *\n   * @remarks\n   * Standard subclass extension pattern: call `SpooledArtifact.forgeTools(ctx)` to produce\n   * the base seven `artifact_*` tools narrowed to any `SpooledArtifact` in the turn, then\n   * register one `ArtifactTool` per TOON-specific descriptor narrowed to TOON artifacts.\n   * Downstream consumers building their own subclasses should follow the same shape.\n   */\n  public static override forgeTools(ctx: DispatchContext): ToolRegistry {\n    const registry = SpooledArtifact.forgeTools(ctx)\n    const requires = SpooledToonArtifact\n    const compatibleIds = collectArtifactCompatibleIds(ctx, requires)\n    if (compatibleIds.length === 0) return registry\n\n    for (const descriptor of this.toolMethods) {\n      const callIdSchema = validator\n        .string()\n        .valid(...compatibleIds)\n        .required()\n        .description('ToolCall id of the artifact to query.')\n\n      const argsSchema = (\n        descriptor.argsSchema ?? validator.object<Record<string, never>>({})\n      ).append({\n        callId: callIdSchema,\n      })\n\n      const tool = new ArtifactTool({\n        name: descriptor.name,\n        description: descriptor.description,\n        inputSchema: argsSchema,\n        ephemeral: true,\n        onCollision: 'replace',\n        handler: async (rawArgs, ctxInner) => {\n          const args = rawArgs as Record<string, unknown> & { callId: string }\n          const resolved = resolveArtifactById(ctxInner, args.callId, requires)\n          if (!resolved) return `Error: no artifact with id ${args.callId} in this turn`\n          const artifact = resolved.artifact\n          const methodArgs: unknown[] = []\n          if (\n            descriptor.method === 'toon_get' ||\n            descriptor.method === 'toon_filter' ||\n            descriptor.method === 'toon_pluck'\n          ) {\n            methodArgs.push(args.path as string)\n          } else if (descriptor.method === 'toon_slice') {\n            methodArgs.push(args.start as number | undefined, args.end as number | undefined)\n          }\n          const fn = (artifact as unknown as Record<string, (...a: unknown[]) => unknown>)[\n            descriptor.method\n          ]\n          if (typeof fn !== 'function') {\n            return `Error: artifact has no method ${descriptor.method}`\n          }\n          const result = await Promise.resolve(fn.apply(artifact, methodArgs))\n          const serialise = descriptor.serialise ?? defaultSerialise\n          return serialise(result)\n        },\n      })\n      registry.register(tool)\n    }\n    return registry\n  }\n\n  /**\n   * Parses and caches the TOON content.\n   *\n   * @remarks\n   * On first access, decodes the TOON source and caches the parsed value. Subsequent calls\n   * return the cached value without re-parsing.\n   *\n   * @returns The parsed TOON value.\n   */\n  async #resolveParsed(): Promise<unknown> {\n    if (this.#hasParsed) {\n      return this.#parsed\n    }\n    const toonModule = await this.#loadToonModule()\n    const text = await this.asString()\n    try {\n      const decode = toonModule.decode as (text: string, opts: Record<string, unknown>) => unknown\n      this.#parsed = decode(text, {\n        indentSize: this.#options?.indentSize ?? 2,\n        strict: this.#options?.strict ?? true,\n      })\n    } catch (err) {\n      const message = this.#formatToonError(err)\n      throw new E_TOON_DECODE_FAILED([message])\n    }\n    this.#hasParsed = true\n    return this.#parsed\n  }\n\n  /**\n   * Formats an error from the TOON decoder, including line number and source.\n   */\n  #formatToonError(err: unknown): string {\n    if (isObject(err) && (err as Record<string, unknown>).name === 'ToonDecodeError') {\n      const toonErr = err as { line?: number; source?: string; message?: string }\n      const line = toonErr.line ?? '?'\n      const source = toonErr.source ?? '(no source)'\n      return `line ${line}: ${source}`\n    }\n    return String((err as Record<string, unknown>).message ?? err)\n  }\n\n  /**\n   * Loads the TOON module lazily, with error handling.\n   *\n   * @remarks\n   * Uses the module-level `toonModulePromise` to ensure the in-flight promise and error state\n   * are shared across all instances of SpooledToonArtifact.\n   */\n  async #loadToonModule() {\n    toonModulePromise ??= import('@toon-format/toon').catch((err: unknown) => {\n      throw new E_TOON_PEER_MISSING([String(err)])\n    })\n    return (await toonModulePromise) as Record<string, unknown>\n  }\n\n  /**\n   * Returns the format of a TOON artifact.\n   *\n   * @remarks\n   * Reports only the format name. The delimiter is deliberately not reported: the TOON decoder\n   * exposes no delimiter information, and every method of inferring one from the source proved\n   * unreliable for some class of strict-valid document. Four distinct approaches were attempted,\n   * each defeated by its own edge case:\n   * - Lexical scanning for the delimiter character failed on unquoted pipes inside values\n   * - Anchored header regex requiring a word key failed on quoted keys and keyless root arrays\n   * - Widened regex accepting quoted keys failed on escaped quotes within the key (e.g., \"a\\\"b\")\n   * - Byte-exact round-trip re-encoding failed on non-canonical formatting (indentation, line\n   *   endings, trailing newlines)\n   *\n   * Delimiter inference is no longer attempted: nothing in the model's workflow needs it, and\n   * the TOON decoder is the source of truth for all document metadata.\n   *\n   * This result is cached after the first parse and returned identically on every call.\n   *\n   * @returns An object with `format: 'toon'`.\n   */\n  async toon_type(): Promise<{ format: string }> {\n    await this.#resolveParsed()\n    return { format: 'toon' }\n  }\n\n  /**\n   * Returns the top-level keys of the parsed TOON content.\n   *\n   * @remarks\n   * - If the root is an object, returns its keys.\n   * - If the root is not a plain object (e.g. an array or scalar), returns `undefined`.\n   *\n   * @returns Array of key strings, or `undefined` when the root is not an object.\n   */\n  async toon_keys(): Promise<string[] | undefined> {\n    const value = await this.#resolveParsed()\n    if (isObject(value)) {\n      return Object.keys(value as object)\n    }\n    return undefined\n  }\n\n  /**\n   * Returns the element count of the parsed TOON content.\n   *\n   * @remarks\n   * - If the root is an array, returns the array length.\n   * - Otherwise, returns `1` (the root is a single element).\n   *\n   * @returns The element count.\n   */\n  async toon_length(): Promise<number> {\n    const value = await this.#resolveParsed()\n    if (Array.isArray(value)) {\n      return value.length\n    }\n    return 1\n  }\n\n  /**\n   * Evaluates a JSONPath expression against the parsed TOON content.\n   *\n   * @remarks\n   * Uses [JSONPath-Plus](https://github.com/JSONPath-Plus/JSONPath). Full JSONPath syntax is\n   * supported: recursive descent (`$..*`), filter expressions (`$[?(@.age > 18)]`), union\n   * selectors, and more.\n   *\n   * @param path - A JSONPath expression (e.g. `'$.user.address.city'`, `'$..name'`).\n   * @returns Array of matched values. Empty array when no matches are found.\n   */\n  async toon_get(path: string): Promise<unknown[]> {\n    const value = await this.#resolveParsed()\n    return JSONPath({ path, json: value as object })\n  }\n\n  /**\n   * Returns elements matched by a JSONPath filter expression.\n   *\n   * @remarks\n   * Evaluates `path` against the root value and returns it in an array if matched.\n   *\n   * @param path - A JSONPath expression (e.g. `'$[?(@.status === \"active\")]'`).\n   * @returns Array of matching elements (at most one element, the root if matched).\n   */\n  async toon_filter(path: string): Promise<unknown[]> {\n    const value = await this.#resolveParsed()\n    const matches = JSONPath({ path, json: value as object })\n    return Array.isArray(matches) && matches.length > 0 ? [value] : []\n  }\n\n  /**\n   * Returns a slice of the parsed content by index range.\n   *\n   * @remarks\n   * - If the root is an array, behaves like `Array.prototype.slice`.\n   * - If the root is not an array, returns the entire root in an array.\n   *\n   * @param start - Start index (inclusive). Defaults to `0`.\n   * @param end - End index (exclusive). Defaults to the element count.\n   * @returns Array of sliced elements.\n   */\n  async toon_slice(start?: number, end?: number): Promise<unknown[]> {\n    const value = await this.#resolveParsed()\n    if (Array.isArray(value)) {\n      return value.slice(start, end)\n    }\n    return [value]\n  }\n\n  /**\n   * Returns all values matched by a JSONPath expression.\n   *\n   * @remarks\n   * Convenience over {@link SpooledToonArtifact.toon_get} with an identical signature — use\n   * whichever name better communicates intent at the call site. `toon_pluck` reads well for\n   * extracting a single field; `toon_get` reads well for structured queries.\n   *\n   * @param path - A JSONPath expression (e.g. `'$..name'`).\n   * @returns Array of matched values.\n   */\n  async toon_pluck(path: string): Promise<unknown[]> {\n    return this.toon_get(path)\n  }\n\n  /**\n   * Serialise this SpooledToonArtifact into an `@nhtio/encoder` snapshot — the reader **handle** plus\n   * the decode `options`.\n   *\n   * @remarks\n   * Overrides {@link SpooledArtifact.[ENCODE_METHOD]} to carry the constructor's `options` (the\n   * parsed-value cache is derived and not encoded). Round-trips via\n   * {@link SpooledToonArtifact.[DECODE_METHOD]}.\n   *\n   * @returns A snapshot consumed by {@link SpooledToonArtifact.[DECODE_METHOD]}.\n   */\n  [ENCODE_METHOD](): AdkEncodableSnapshot {\n    return { reader: this.readerDescriptor(), options: this.#options }\n  }\n\n  /**\n   * Reconstruct a {@link SpooledToonArtifact} from a {@link SpooledToonArtifact.[ENCODE_METHOD]}\n   * snapshot.\n   *\n   * @param data - The snapshot produced by {@link SpooledToonArtifact.[ENCODE_METHOD]}.\n   * @returns A fresh {@link SpooledToonArtifact}} backed by a freshly-resolved reader.\n   */\n  static [DECODE_METHOD](data: AdkEncodableSnapshot): SpooledToonArtifact {\n    const snapshot = data as {\n      reader: ReaderDescriptor\n      options?: ToonDecodeOptions\n    }\n    return new SpooledToonArtifact(resolveSpoolReader(snapshot.reader), snapshot.options)\n  }\n}\n\n/**\n * Converter tool: TOON to JSON.\n *\n * @remarks\n * Accepts either inline TOON text or a reference to an artifact produced earlier in this turn.\n * Converts to JSON and returns a new {@link @nhtio/adk!SpooledJsonArtifact}.\n *\n * This is a plain {@link @nhtio/adk!Tool}, not an {@link @nhtio/adk!ArtifactTool} — the handler\n * returns the new artifact directly, allowing the forge to discover and query it on the next\n * iteration without explicit wiring.\n */\nexport const toonToJsonTool: Tool = new Tool({\n  name: 'toon_to_json',\n  description: 'Convert inline TOON text or a TOON artifact to JSON.',\n  inputSchema: validator.object({\n    text: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('Inline TOON text. Provide this or call_id, not both.'),\n    call_id: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('ToolCall id of a TOON artifact produced earlier in this turn.'),\n  }),\n  artifactConstructor: () => SpooledJsonArtifact,\n  handler: async (rawArgs: unknown, ctx: DispatchContext) => {\n    const args = rawArgs as { text?: string; call_id?: string }\n    const text = args.text ?? ''\n    const callId = args.call_id ?? ''\n\n    const hasText = text.length > 0\n    const hasCallId = callId.length > 0\n\n    if (!hasText && !hasCallId) {\n      return 'Error: provide either text or call_id, not neither'\n    }\n    if (hasText && hasCallId) {\n      return 'Error: provide either text or call_id, not both'\n    }\n\n    let toonContent: string\n    if (hasCallId) {\n      const resolved = resolveArtifactById(ctx, callId, SpooledToonArtifact)\n      if (!resolved) {\n        return `Error: no TOON artifact with id ${callId} in this turn`\n      }\n      toonContent = await resolved.artifact.asString()\n    } else {\n      toonContent = text\n    }\n\n    const toonModule = await import('@toon-format/toon').catch((err: unknown) => {\n      throw new E_TOON_PEER_MISSING([String(err)])\n    })\n\n    let parsed: unknown\n    try {\n      const decode = toonModule.decode as (text: string, opts: Record<string, unknown>) => unknown\n      parsed = decode(toonContent, { indentSize: 2, strict: true })\n    } catch (err) {\n      const message =\n        isObject(err) && (err as Record<string, unknown>).name === 'ToonDecodeError'\n          ? `line ${(err as { line?: number }).line ?? '?'}: ${(err as { source?: string }).source ?? '(no source)'}`\n          : String((err as Record<string, unknown>).message ?? err)\n      return `Error: failed to decode TOON: ${message}`\n    }\n\n    const json = JSON.stringify(parsed, null, 2)\n    const sourceId = hasCallId ? callId : uuidv6()\n    const reader = await ctx.storeRetrievableBytes(`${ctx.id}:toon_to_json:${sourceId}`, json)\n    return new SpooledJsonArtifact(reader)\n  },\n})\n\n/**\n * Converter tool: JSON to TOON.\n *\n * @remarks\n * Accepts either inline JSON text or a reference to a JSON artifact produced earlier in this turn.\n * Converts to TOON and returns a new {@link SpooledToonArtifact}.\n *\n * This is a plain {@link @nhtio/adk!Tool}, not an {@link @nhtio/adk!ArtifactTool} — the handler\n * returns the new artifact directly, allowing the forge to discover and query it on the next\n * iteration without explicit wiring.\n */\nexport const jsonToToonTool: Tool = new Tool({\n  name: 'json_to_toon',\n  description: 'Convert inline JSON text or a JSON artifact to TOON.',\n  inputSchema: validator.object({\n    text: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('Inline JSON text. Provide this or call_id, not both.'),\n    call_id: validator\n      .string()\n      .optional()\n      .allow('')\n      .description('ToolCall id of a JSON artifact produced earlier in this turn.'),\n  }),\n  artifactConstructor: () => SpooledToonArtifact,\n  handler: async (rawArgs: unknown, ctx: DispatchContext) => {\n    const args = rawArgs as { text?: string; call_id?: string }\n    const text = args.text ?? ''\n    const callId = args.call_id ?? ''\n\n    const hasText = text.length > 0\n    const hasCallId = callId.length > 0\n\n    if (!hasText && !hasCallId) {\n      return 'Error: provide either text or call_id, not neither'\n    }\n    if (hasText && hasCallId) {\n      return 'Error: provide either text or call_id, not both'\n    }\n\n    let jsonContent: string\n    if (hasCallId) {\n      const resolved = resolveArtifactById(ctx, callId, SpooledJsonArtifact)\n      if (!resolved) {\n        return `Error: no JSON artifact with id ${callId} in this turn`\n      }\n      jsonContent = await resolved.artifact.asString()\n    } else {\n      jsonContent = text\n    }\n\n    let parsed: unknown\n    try {\n      parsed = JSON.parse(jsonContent)\n    } catch (err) {\n      return `Error: failed to parse JSON: ${String((err as Record<string, unknown>).message ?? err)}`\n    }\n\n    const toonModule = await import('@toon-format/toon').catch((err: unknown) => {\n      throw new E_TOON_PEER_MISSING([String(err)])\n    })\n\n    let toon: string\n    try {\n      const encode = toonModule.encode as (val: unknown, opts: Record<string, unknown>) => string\n      toon = encode(parsed, { indentSize: 2 })\n    } catch (err) {\n      return `Error: failed to encode TOON: ${String((err as Record<string, unknown>).message ?? err)}`\n    }\n\n    const sourceId = hasCallId ? callId : uuidv6()\n    const reader = await ctx.storeRetrievableBytes(`${ctx.id}:json_to_toon:${sourceId}`, toon)\n    return new SpooledToonArtifact(reader)\n  },\n})\n\n/**\n * Exports for the public barrel.\n */\nexport { E_TOON_PEER_MISSING, E_TOON_DECODE_FAILED } from './exceptions'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAa,sBAAsB,mBAAA,gBACjC,uBACA,qKACA,uBACA,GACF;;;;;;;;AASA,IAAa,uBAAuB,mBAAA,gBAClC,wBACA,yBACA,wBACA,GACF;;;;;;;;;;;;;;;;;;;;;;;;ACFA,IAAM,gBAA+B,OAAO,IAAI,0BAA0B;AAC1E,IAAM,gBAA+B,OAAO,IAAI,4BAA4B;;;;;;;;;AAU5E,IAAI;;;;;;;;;;;;;;;;AAwCJ,IAAa,sBAAb,MAAa,4BAA4B,yBAAA,gBAAgB;CACvD;CACA,aAAsB;CACtB;;;;;CAMA,YAAY,QAAqB,SAA6B;EAC5D,MAAM,MAAM;EACZ,KAAKA,WAAW;CAClB;;;;;;;;;;;;;CAcA,OAAc,sBAAsB,OAA8C;EAChF,OAAO,eAAA,aAAa,OAAO,uBAAuB,mBAAmB;CACvE;;;;;;;;;;;;;;CAeA,OAAc,cAAmD,OAAO,OAAO;EAC7E;GACE,MAAM;GACN,QAAQ;GACR,aAAa;GACb,YAAY,kBAAA,UAAU,OAAO,CAAC,CAAC;EACjC;EACA;GACE,MAAM;GACN,QAAQ;GACR,aAAa;GACb,YAAY,kBAAA,UAAU,OAAO,CAAC,CAAC;EACjC;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,CAAC,CAAC;EACjC;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,EAC3B,MAAM,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,0CAA0C,EAC5F,CAAC;EACH;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,EAC3B,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,YAAY,oDAAoD,EACrE,CAAC;EACH;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO;IAC3B,OAAO,kBAAA,UACJ,OAAO,EACP,QAAQ,EACR,IAAI,CAAC,EACL,SAAS,EACT,YAAY,0BAA0B;IACzC,KAAK,kBAAA,UAAU,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,wBAAwB;GAC1F,CAAC;EACH;EACA;GACE,MAAM;GACN,QAAQ;GACR,aACE;GACF,YAAY,kBAAA,UAAU,OAAO,EAC3B,MAAM,kBAAA,UAAU,OAAO,EAAE,SAAS,EAAE,YAAY,sCAAsC,EACxF,CAAC;EACH;CACF,CAAC;;;;;;;;;;CAWD,OAAuB,WAAW,KAAoC;EACpE,MAAM,WAAW,yBAAA,gBAAgB,WAAW,GAAG;EAC/C,MAAM,WAAW;EACjB,MAAM,gBAAgB,yBAAA,6BAA6B,KAAK,QAAQ;EAChE,IAAI,cAAc,WAAW,GAAG,OAAO;EAEvC,KAAK,MAAM,cAAc,KAAK,aAAa;GACzC,MAAM,eAAe,kBAAA,UAClB,OAAO,EACP,MAAM,GAAG,aAAa,EACtB,SAAS,EACT,YAAY,uCAAuC;GAEtD,MAAM,cACJ,WAAW,cAAc,kBAAA,UAAU,OAA8B,CAAC,CAAC,GACnE,OAAO,EACP,QAAQ,aACV,CAAC;GAED,MAAM,OAAO,IAAI,yBAAA,aAAa;IAC5B,MAAM,WAAW;IACjB,aAAa,WAAW;IACxB,aAAa;IACb,WAAW;IACX,aAAa;IACb,SAAS,OAAO,SAAS,aAAa;KACpC,MAAM,OAAO;KACb,MAAM,WAAW,yBAAA,oBAAoB,UAAU,KAAK,QAAQ,QAAQ;KACpE,IAAI,CAAC,UAAU,OAAO,8BAA8B,KAAK,OAAO;KAChE,MAAM,WAAW,SAAS;KAC1B,MAAM,aAAwB,CAAC;KAC/B,IACE,WAAW,WAAW,cACtB,WAAW,WAAW,iBACtB,WAAW,WAAW,cAEtB,WAAW,KAAK,KAAK,IAAc;UAC9B,IAAI,WAAW,WAAW,cAC/B,WAAW,KAAK,KAAK,OAA6B,KAAK,GAAyB;KAElF,MAAM,KAAM,SACV,WAAW;KAEb,IAAI,OAAO,OAAO,YAChB,OAAO,iCAAiC,WAAW;KAErD,MAAM,SAAS,MAAM,QAAQ,QAAQ,GAAG,MAAM,UAAU,UAAU,CAAC;KAEnE,QADkB,WAAW,aAAa,yBAAA,kBACzB,MAAM;IACzB;GACF,CAAC;GACD,SAAS,SAAS,IAAI;EACxB;EACA,OAAO;CACT;;;;;;;;;;CAWA,MAAMC,iBAAmC;EACvC,IAAI,KAAKC,YACP,OAAO,KAAKC;EAEd,MAAM,aAAa,MAAM,KAAKC,gBAAgB;EAC9C,MAAM,OAAO,MAAM,KAAK,SAAS;EACjC,IAAI;GACF,MAAM,SAAS,WAAW;GAC1B,KAAKD,UAAU,OAAO,MAAM;IAC1B,YAAY,KAAKH,UAAU,cAAc;IACzC,QAAQ,KAAKA,UAAU,UAAU;GACnC,CAAC;EACH,SAAS,KAAK;GAEZ,MAAM,IAAI,qBAAqB,CADf,KAAKK,iBAAiB,GACN,CAAO,CAAC;EAC1C;EACA,KAAKH,aAAa;EAClB,OAAO,KAAKC;CACd;;;;CAKA,iBAAiB,KAAsB;EACrC,IAAI,eAAA,SAAS,GAAG,KAAM,IAAgC,SAAS,mBAAmB;GAChF,MAAM,UAAU;GAGhB,OAAO,QAFM,QAAQ,QAAQ,IAET,IADL,QAAQ,UAAU;EAEnC;EACA,OAAO,OAAQ,IAAgC,WAAW,GAAG;CAC/D;;;;;;;;CASA,MAAMC,kBAAkB;EACtB,sBAAsB,OAAO,qBAAqB,OAAO,QAAiB;GACxE,MAAM,IAAI,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;EAC7C,CAAC;EACD,OAAQ,MAAM;CAChB;;;;;;;;;;;;;;;;;;;;;;CAuBA,MAAM,YAAyC;EAC7C,MAAM,KAAKH,eAAe;EAC1B,OAAO,EAAE,QAAQ,OAAO;CAC1B;;;;;;;;;;CAWA,MAAM,YAA2C;EAC/C,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,IAAI,eAAA,SAAS,KAAK,GAChB,OAAO,OAAO,KAAK,KAAe;CAGtC;;;;;;;;;;CAWA,MAAM,cAA+B;EACnC,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM;EAEf,OAAO;CACT;;;;;;;;;;;;CAaA,MAAM,SAAS,MAAkC;EAE/C,QAAA,GAAA,cAAA,UAAgB;GAAE;GAAM,MAAM,MADV,KAAKA,eAAe;EACM,CAAC;CACjD;;;;;;;;;;CAWA,MAAM,YAAY,MAAkC;EAClD,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,MAAM,WAAA,GAAA,cAAA,UAAmB;GAAE;GAAM,MAAM;EAAgB,CAAC;EACxD,OAAO,MAAM,QAAQ,OAAO,KAAK,QAAQ,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC;CACnE;;;;;;;;;;;;CAaA,MAAM,WAAW,OAAgB,KAAkC;EACjE,MAAM,QAAQ,MAAM,KAAKA,eAAe;EACxC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,MAAM,MAAM,OAAO,GAAG;EAE/B,OAAO,CAAC,KAAK;CACf;;;;;;;;;;;;CAaA,MAAM,WAAW,MAAkC;EACjD,OAAO,KAAK,SAAS,IAAI;CAC3B;;;;;;;;;;;;CAaA,CAAC,iBAAuC;EACtC,OAAO;GAAE,QAAQ,KAAK,iBAAiB;GAAG,SAAS,KAAKD;EAAS;CACnE;;;;;;;;CASA,QAAQ,eAAe,MAAiD;EACtE,MAAM,WAAW;EAIjB,OAAO,IAAI,oBAAoB,yBAAA,mBAAmB,SAAS,MAAM,GAAG,SAAS,OAAO;CACtF;AACF;;;;;;;;;;;;AAaA,IAAa,iBAAuB,IAAI,yBAAA,KAAK;CAC3C,MAAM;CACN,aAAa;CACb,aAAa,kBAAA,UAAU,OAAO;EAC5B,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,sDAAsD;EACrE,SAAS,kBAAA,UACN,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,+DAA+D;CAChF,CAAC;CACD,2BAA2B,kCAAA;CAC3B,SAAS,OAAO,SAAkB,QAAyB;EACzD,MAAM,OAAO;EACb,MAAM,OAAO,KAAK,QAAQ;EAC1B,MAAM,SAAS,KAAK,WAAW;EAE/B,MAAM,UAAU,KAAK,SAAS;EAC9B,MAAM,YAAY,OAAO,SAAS;EAElC,IAAI,CAAC,WAAW,CAAC,WACf,OAAO;EAET,IAAI,WAAW,WACb,OAAO;EAGT,IAAI;EACJ,IAAI,WAAW;GACb,MAAM,WAAW,yBAAA,oBAAoB,KAAK,QAAQ,mBAAmB;GACrE,IAAI,CAAC,UACH,OAAO,mCAAmC,OAAO;GAEnD,cAAc,MAAM,SAAS,SAAS,SAAS;EACjD,OACE,cAAc;EAGhB,MAAM,aAAa,MAAM,OAAO,qBAAqB,OAAO,QAAiB;GAC3E,MAAM,IAAI,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;EAC7C,CAAC;EAED,IAAI;EACJ,IAAI;GACF,MAAM,SAAS,WAAW;GAC1B,SAAS,OAAO,aAAa;IAAE,YAAY;IAAG,QAAQ;GAAK,CAAC;EAC9D,SAAS,KAAK;GAKZ,OAAO,iCAHL,eAAA,SAAS,GAAG,KAAM,IAAgC,SAAS,oBACvD,QAAS,IAA0B,QAAQ,IAAI,IAAK,IAA4B,UAAU,kBAC1F,OAAQ,IAAgC,WAAW,GAAG;EAE9D;EAEA,MAAM,OAAO,KAAK,UAAU,QAAQ,MAAM,CAAC;EAC3C,MAAM,WAAW,YAAY,UAAA,GAAA,KAAA,IAAgB;EAE7C,OAAO,IAAI,kCAAA,oBAAoB,MADV,IAAI,sBAAsB,GAAG,IAAI,GAAG,gBAAgB,YAAY,IAAI,CACpD;CACvC;AACF,CAAC;;;;;;;;;;;;AAaD,IAAa,iBAAuB,IAAI,yBAAA,KAAK;CAC3C,MAAM;CACN,aAAa;CACb,aAAa,kBAAA,UAAU,OAAO;EAC5B,MAAM,kBAAA,UACH,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,sDAAsD;EACrE,SAAS,kBAAA,UACN,OAAO,EACP,SAAS,EACT,MAAM,EAAE,EACR,YAAY,+DAA+D;CAChF,CAAC;CACD,2BAA2B;CAC3B,SAAS,OAAO,SAAkB,QAAyB;EACzD,MAAM,OAAO;EACb,MAAM,OAAO,KAAK,QAAQ;EAC1B,MAAM,SAAS,KAAK,WAAW;EAE/B,MAAM,UAAU,KAAK,SAAS;EAC9B,MAAM,YAAY,OAAO,SAAS;EAElC,IAAI,CAAC,WAAW,CAAC,WACf,OAAO;EAET,IAAI,WAAW,WACb,OAAO;EAGT,IAAI;EACJ,IAAI,WAAW;GACb,MAAM,WAAW,yBAAA,oBAAoB,KAAK,QAAQ,kCAAA,mBAAmB;GACrE,IAAI,CAAC,UACH,OAAO,mCAAmC,OAAO;GAEnD,cAAc,MAAM,SAAS,SAAS,SAAS;EACjD,OACE,cAAc;EAGhB,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,WAAW;EACjC,SAAS,KAAK;GACZ,OAAO,gCAAgC,OAAQ,IAAgC,WAAW,GAAG;EAC/F;EAEA,MAAM,aAAa,MAAM,OAAO,qBAAqB,OAAO,QAAiB;GAC3E,MAAM,IAAI,oBAAoB,CAAC,OAAO,GAAG,CAAC,CAAC;EAC7C,CAAC;EAED,IAAI;EACJ,IAAI;GACF,MAAM,SAAS,WAAW;GAC1B,OAAO,OAAO,QAAQ,EAAE,YAAY,EAAE,CAAC;EACzC,SAAS,KAAK;GACZ,OAAO,iCAAiC,OAAQ,IAAgC,WAAW,GAAG;EAChG;EAEA,MAAM,WAAW,YAAY,UAAA,GAAA,KAAA,IAAgB;EAE7C,OAAO,IAAI,oBAAoB,MADV,IAAI,sBAAsB,GAAG,IAAI,GAAG,gBAAgB,YAAY,IAAI,CACpD;CACvC;AACF,CAAC"}

package/{turn_runner-BmVXcBZ2.mjs → turn_runner-BHHD6h77.mjs}

@@ -1,10 +1,10 @@
 import { o as validateOrThrow } from "./exceptions-DRYLe-J4.mjs";
 import { n as isInstanceOf, r as isObject, t as isError } from "./guards-BEpY7lBI.mjs";
-import { B as E_TURN_GATE_TIMEOUT, E as E_INVALID_TURN_RUNNER_CONFIG, N as E_OUTPUT_PIPELINE_ERROR, P as E_PIPELINE_SHORT_CIRCUITED, T as E_INVALID_TURN_GATE_RESOLUTION, a as runWithEstimationWarnings, b as E_INVALID_INITIAL_TURN_GATE_VALUE, u as E_INPUT_PIPELINE_ERROR, z as E_TURN_GATE_ABORTED } from "./tokenizable-xPXj1AQX.mjs";
-import { f as Tool, g as ToolRegistry } from "./spooled_artifact-BkOe4-j-.mjs";
-import { r as TurnContext, t as DispatchRunner } from "./dispatch_runner-DO7jo_gl.mjs";
-import { DateTime } from "luxon";
+import { C as E_INVALID_TURN_GATE_RESOLUTION, L as E_TURN_GATE_ABORTED, M as E_PIPELINE_SHORT_CIRCUITED, R as E_TURN_GATE_TIMEOUT, a as runWithEstimationWarnings, c as E_INPUT_PIPELINE_ERROR, j as E_OUTPUT_PIPELINE_ERROR, v as E_INVALID_INITIAL_TURN_GATE_VALUE, w as E_INVALID_TURN_RUNNER_CONFIG } from "./tokenizable-VB4Av8GF.mjs";
+import { d as ToolRegistry, p as Tool } from "./spooled_artifact-Bw_7swIp.mjs";
+import { r as TurnContext, t as DispatchRunner } from "./dispatch_runner-BZDXUe0G.mjs";
 import { validator } from "@nhtio/validation";
+import { DateTime } from "luxon";
 import { Middleware } from "@nhtio/middleware";
 import { TypedEventEmitter } from "@nhtio/tiny-typed-emitter";
 //#region src/lib/classes/turn_gate.ts
@@ -626,4 +626,4 @@ var TurnRunner = class TurnRunner {
 //#endregion
 export { TurnGate as n, TurnRunner as t };
 
-//# sourceMappingURL=turn_runner-BmVXcBZ2.mjs.map
+//# sourceMappingURL=turn_runner-BHHD6h77.mjs.map

package/{turn_runner-BmVXcBZ2.mjs.map → turn_runner-BHHD6h77.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"turn_runner-BmVXcBZ2.mjs","names":["#id","#turnId","#reason","#payload","#createdAt","#settled","#schema","#controller","#promise","#resolve","#reject","#config","#inputPipeline","#outputPipeline","#functionalEmitter","#observabilityEmitter"],"sources":["../src/lib/classes/turn_gate.ts","../src/lib/contracts/turn_runner_config.ts","../src/lib/turn_runner.ts"],"sourcesContent":["import { DateTime } from 'luxon'\nimport { validator } from '@nhtio/validation'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError, isObject } from '../utils/guards'\nimport {\n  E_TURN_GATE_ABORTED,\n  E_TURN_GATE_TIMEOUT,\n  E_INVALID_TURN_GATE_RESOLUTION,\n  E_INVALID_INITIAL_TURN_GATE_VALUE,\n} from '../exceptions/runtime'\nimport type { Schema } from '@nhtio/validation'\n\n/**\n * Plain input object supplied to {@link TurnGate} at construction time.\n *\n * @remarks\n * `turnId` and `abortSignal` are injected by the runner — callers constructing a gate via\n * `ctx.waitFor()` never supply them directly.\n *\n * `abortSignal` is `AbortSignal` (not `AbortController`) because the gate reacts to turn-level\n * cancellation but cannot trigger it. The gate owns its own internal `AbortController` for\n * `gate.abort()`.\n */\nexport interface RawTurnGate {\n  /** Stable unique identifier for this gate. */\n  id: string\n  /** The ID of the turn that opened this gate. */\n  turnId: string\n  /** Human-readable label describing why this gate was opened (e.g. `'tool_approval'`). */\n  reason: string\n  /** Arbitrary data supplied to the gate opener; passed through to `turnGateOpen` listeners. */\n  payload: unknown\n  /** Optional validator schema for the resolution value. When present, `resolve()` validates before settling. */\n  schema?: Schema\n  /** Optional timeout in milliseconds. When elapsed the gate self-rejects with {@link @nhtio/adk!E_TURN_GATE_TIMEOUT}. */\n  timeout?: number\n  /** The turn's abort signal. When fired the gate self-rejects with {@link @nhtio/adk!E_TURN_GATE_ABORTED}. */\n  abortSignal?: AbortSignal\n  /** When this gate was created. */\n  createdAt: string | number | Date | DateTime\n}\n\n/**\n * Fully-resolved {@link RawTurnGate} after schema validation.\n *\n * @internal\n */\ninterface ResolvedTurnGate {\n  id: string\n  turnId: string\n  reason: string\n  payload: unknown\n  schema?: Schema\n  timeout?: number\n  abortSignal?: AbortSignal\n  createdAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawTurnGate} before constructing a {@link TurnGate}.\n *\n * @remarks\n * - `schema` and `abortSignal` are validated as opaque passthrough values.\n * - `timeout` must be a positive integer when provided.\n */\nconst rawTurnGateSchema = validator.object<RawTurnGate>({\n  id: validator.string().required(),\n  turnId: validator.string().required(),\n  reason: validator.string().required(),\n  payload: validator.any().required(),\n  schema: validator\n    .any()\n    .custom((value, helpers) => {\n      if (value === undefined || value === null) return undefined\n      if (typeof (value as any).validate === 'function') return value\n      return helpers.error('any.invalid')\n    })\n    .optional(),\n  timeout: validator.number().integer().min(1).optional(),\n  abortSignal: validator\n    .any()\n    .custom((value, helpers) => {\n      if (value === undefined || value === null) return undefined\n      // eslint-disable-next-line adk/use-is-instance-of -- native built-in; AbortSignal cross-realm is handled by the duck-type fallback below\n      if (typeof AbortSignal !== 'undefined' && value instanceof AbortSignal) return value\n      if (\n        isObject(value) &&\n        typeof (value as any).aborted === 'boolean' &&\n        typeof (value as any).addEventListener === 'function'\n      ) {\n        return value\n      }\n      return helpers.error('any.invalid')\n    })\n    .optional(),\n  createdAt: validator.datetime().required(),\n})\n\n/**\n * A cooperative suspension gate that blocks a turn's middleware pipeline until resolved, rejected,\n * aborted, or timed out.\n *\n * @typeParam T - The expected type of the resolution value.\n *\n * @remarks\n * Created exclusively via `ctx.waitFor()` — middleware never constructs a gate directly.\n * The gate emits `turnGateOpen` on the runner's observability bus at creation time and\n * `turnGateClosed` when it settles.\n *\n * Resolution is validated against an optional schema before the internal promise is settled.\n * A validation failure throws {@link @nhtio/adk!E_INVALID_TURN_GATE_RESOLUTION} **synchronously in the\n * caller's context** — the promise is NOT settled and the gate remains open.\n */\nexport class TurnGate<T = unknown> {\n  /**\n   * Validator schema that accepts a {@link RawTurnGate} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a gate entry.\n   */\n  public static schema = rawTurnGateSchema\n\n  /**\n   * Returns `true` if `value` is a {@link TurnGate} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link TurnGate} instance.\n   */\n  public static isTurnGate(value: unknown): value is TurnGate {\n    return isInstanceOf(value, 'TurnGate', TurnGate)\n  }\n\n  /** Unique identifier for this gate instance. */\n  declare readonly id: string\n  /** Id of the turn this gate belongs to. */\n  declare readonly turnId: string\n  /** Human-readable reason the gate was opened. */\n  declare readonly reason: string\n  /** Optional caller-supplied payload describing what the gate is waiting on. */\n  declare readonly payload: unknown\n  /** When the gate was created. */\n  declare readonly createdAt: DateTime\n  /** Whether the gate has been settled (resolved or rejected) and no longer blocks the turn. */\n  declare readonly isSettled: boolean\n\n  #id: string\n  #turnId: string\n  #reason: string\n  #payload: unknown\n  #createdAt: DateTime\n  #settled: boolean\n  #schema: Schema | undefined\n  #controller: AbortController\n  #resolve!: (value: T) => void\n  #reject!: (reason: unknown) => void\n  #promise: Promise<T>\n\n  /**\n   * @param raw - The raw gate input validated against `rawTurnGateSchema`.\n   * @throws {@link @nhtio/adk!E_INVALID_INITIAL_TURN_GATE_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawTurnGate) {\n    let resolved: ResolvedTurnGate\n    try {\n      resolved = validateOrThrow<ResolvedTurnGate>(rawTurnGateSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_TURN_GATE_VALUE({ cause: isError(err) ? err : undefined })\n    }\n\n    this.#id = resolved.id\n    this.#turnId = resolved.turnId\n    this.#reason = resolved.reason\n    this.#payload = resolved.payload\n    this.#createdAt = resolved.createdAt\n    this.#settled = false\n    this.#schema = resolved.schema\n    this.#controller = new AbortController()\n\n    this.#promise = new Promise<T>((resolve, reject) => {\n      this.#resolve = resolve\n      this.#reject = reject\n    })\n\n    // Wire the internal abort controller\n    const onAbort = () => {\n      if (!this.#settled) {\n        this.#settled = true\n        this.#reject(new E_TURN_GATE_ABORTED())\n      }\n    }\n\n    this.#controller.signal.addEventListener('abort', onAbort, { once: true })\n\n    // Wire the external turn abort signal\n    if (resolved.abortSignal) {\n      if (resolved.abortSignal.aborted) {\n        // Already aborted — reject immediately after construction\n        queueMicrotask(() => onAbort())\n      } else {\n        resolved.abortSignal.addEventListener('abort', onAbort, { once: true })\n        // Clean up the external listener once the gate settles via another path\n        this.#promise.then(\n          () => resolved.abortSignal!.removeEventListener('abort', onAbort),\n          () => resolved.abortSignal!.removeEventListener('abort', onAbort)\n        )\n      }\n    }\n\n    // Wire the timeout\n    if (resolved.timeout !== undefined) {\n      const timer = setTimeout(() => {\n        if (!this.#settled) {\n          this.#settled = true\n          this.#reject(new E_TURN_GATE_TIMEOUT())\n        }\n      }, resolved.timeout)\n\n      this.#promise.then(\n        () => clearTimeout(timer),\n        () => clearTimeout(timer)\n      )\n    }\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      turnId: {\n        get: () => this.#turnId,\n        enumerable: true,\n        configurable: false,\n      },\n      reason: {\n        get: () => this.#reason,\n        enumerable: true,\n        configurable: false,\n      },\n      payload: {\n        get: () => this.#payload,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      isSettled: {\n        get: () => this.#settled,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n\n  /**\n   * Resolves the gate with `value`, unblocking the awaiting middleware.\n   *\n   * @remarks\n   * If a schema was provided at construction, `value` is validated synchronously before the\n   * promise is settled. A validation failure throws {@link @nhtio/adk!E_INVALID_TURN_GATE_RESOLUTION}\n   * in the caller's context — the promise is NOT settled and the gate remains open.\n   *\n   * No-ops if the gate is already settled.\n   *\n   * @param value - The resolution value. Must satisfy the gate's schema when one was provided.\n   * @throws {@link @nhtio/adk!E_INVALID_TURN_GATE_RESOLUTION} when `value` fails schema validation.\n   */\n  resolve(value: unknown): void {\n    if (this.#settled) return\n    if (this.#schema !== undefined) {\n      try {\n        value = validateOrThrow(this.#schema, value, true)\n      } catch (err) {\n        throw new E_INVALID_TURN_GATE_RESOLUTION({\n          cause: isError(err) ? err : undefined,\n        })\n      }\n    }\n    this.#settled = true\n    this.#resolve(value as T)\n  }\n\n  /**\n   * Rejects the gate with `error`, unblocking the awaiting middleware with a rejection.\n   *\n   * @remarks\n   * No-ops if the gate is already settled.\n   *\n   * @param error - The rejection reason.\n   */\n  reject(error: Error): void {\n    if (this.#settled) return\n    this.#settled = true\n    this.#reject(error)\n  }\n\n  /**\n   * Aborts the gate by firing the internal `AbortController`, which rejects the promise with\n   * {@link @nhtio/adk!E_TURN_GATE_ABORTED}.\n   *\n   * @remarks\n   * No-ops if the gate is already settled. Distinct from the turn-level abort signal — this\n   * allows callers to cancel a specific gate without aborting the whole turn.\n   */\n  abort(): void {\n    if (this.#settled) return\n    this.#controller.abort()\n  }\n\n  /**\n   * Returns the internal promise. Called by `ctx.waitFor()` to block the middleware pipeline.\n   *\n   * @internal\n   */\n  _promise(): Promise<T> {\n    return this.#promise\n  }\n}\n","import { Tool } from '../classes/tool'\nimport { validator } from '@nhtio/validation'\nimport type { TurnPipelineMiddlewareFn } from '../types/turn_runner'\nimport type { DispatchPipelineMiddlewareFn, DispatchExecutorFn } from '../types/dispatch_runner'\nimport type {\n  MemoryRetrievalFn,\n  MessageRetrievalFn,\n  ThoughtRetrievalFn,\n  ToolCallRetrievalFn,\n  ToolsRetrievalFn,\n  StandingInstructionsRefreshFn,\n  StandingInstructionStoreFn,\n  StandingInstructionMutateFn,\n  StandingInstructionDeleteFn,\n  MemoryStoreFn,\n  MemoryMutateFn,\n  MemoryDeleteFn,\n  RetrievableRetrievalFn,\n  RetrievableStoreFn,\n  RetrievableMutateFn,\n  RetrievableDeleteFn,\n  MessageStoreFn,\n  MessageMutateFn,\n  MessageDeleteFn,\n  ThoughtStoreFn,\n  ThoughtMutateFn,\n  ThoughtDeleteFn,\n  ToolCallStoreFn,\n  ToolCallMutateFn,\n  ToolCallDeleteFn,\n  ToolCallGroupReplaceFn,\n  MediaBytesStoreFn,\n  RetrievableBytesStoreFn,\n} from './turn_runner_context'\n\n/**\n * Configuration supplied to {@link @nhtio/adk!TurnRunner} at construction time.\n *\n * @remarks\n * Validated against `turnRunnerConfigSchema` at construction — a misconfigured runner throws\n * immediately rather than failing on the first turn.\n *\n * All fetch and mutation callbacks are required: they are injected into each {@link @nhtio/adk!TurnContext}\n * so middleware can call fetch, refresh, and persistence methods directly on the context without\n * coupling to the runner.\n *\n * `tools` is optional at the caller level and defaults to `[]` after schema resolution — a runner\n * with no baseline tools is valid.\n */\nexport interface TurnRunnerConfig {\n  /** Performs the LLM API/SDK call for each iteration of the dispatch loop; receives the active {@link @nhtio/adk!DispatchContext} and an {@link @nhtio/adk!DispatchExecutorHelpers} object for managing per-id stream state. */\n  executorCallback: DispatchExecutorFn\n  /** Called once per turn to supply memories; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchMemoriesCallback: MemoryRetrievalFn\n  /** Called once per turn to supply conversation history; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchMessagesCallback: MessageRetrievalFn\n  /** Called once per turn to supply thought traces; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchThoughtsCallback: ThoughtRetrievalFn\n  /** Called once per turn to supply tool call records; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchToolCallsCallback: ToolCallRetrievalFn\n  /** Called to supply available tools; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchToolsCallback: ToolsRetrievalFn\n  /** Called to refresh and return standing instructions; receives the active {@link @nhtio/adk!TurnContext}. */\n  refreshStandingInstructionsCallback: StandingInstructionsRefreshFn\n  /** Persists a new standing instruction. */\n  storeStandingInstructionCallback: StandingInstructionStoreFn\n  /** Updates an existing standing instruction in the persistence layer. */\n  mutateStandingInstructionCallback: StandingInstructionMutateFn\n  /** Removes a standing instruction from the persistence layer. */\n  deleteStandingInstructionCallback: StandingInstructionDeleteFn\n  /** Persists a new memory. */\n  storeMemoryCallback: MemoryStoreFn\n  /** Updates an existing memory in the persistence layer. */\n  mutateMemoryCallback: MemoryMutateFn\n  /** Removes a memory from the persistence layer by ID. */\n  deleteMemoryCallback: MemoryDeleteFn\n  /** Called once per turn to supply retrievable (RAG) records; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchRetrievablesCallback: RetrievableRetrievalFn\n  /** Persists a new retrievable record. */\n  storeRetrievableCallback: RetrievableStoreFn\n  /** Updates an existing retrievable record in the persistence layer. */\n  mutateRetrievableCallback: RetrievableMutateFn\n  /** Removes a retrievable record from the persistence layer by ID. */\n  deleteRetrievableCallback: RetrievableDeleteFn\n  /** Persists a new message. */\n  storeMessageCallback: MessageStoreFn\n  /** Updates an existing message in the persistence layer. */\n  mutateMessageCallback: MessageMutateFn\n  /** Removes a message from the persistence layer by ID. */\n  deleteMessageCallback: MessageDeleteFn\n  /** Persists a new thought. */\n  storeThoughtCallback: ThoughtStoreFn\n  /** Updates an existing thought in the persistence layer. */\n  mutateThoughtCallback: ThoughtMutateFn\n  /** Removes a thought from the persistence layer by ID. */\n  deleteThoughtCallback: ThoughtDeleteFn\n  /** Persists a new tool call. */\n  storeToolCallCallback: ToolCallStoreFn\n  /** Updates an existing tool call in the persistence layer. */\n  mutateToolCallCallback: ToolCallMutateFn\n  /** Removes a tool call from the persistence layer by ID. */\n  deleteToolCallCallback: ToolCallDeleteFn\n  /** Optionally replaces a complete tool-call group atomically. */\n  replaceToolCallGroupCallback?: ToolCallGroupReplaceFn\n  /** Persists tool-generated media bytes into consumer storage; returns a `MediaReader`. */\n  storeMediaBytesCallback: MediaBytesStoreFn\n  /** Persists extracted retrievable text bytes into consumer storage; returns a `SpoolReader`. */\n  storeRetrievableBytesCallback: RetrievableBytesStoreFn\n  /** Baseline tools available on every turn. Middleware may trim or extend this per-turn via `ctx.tools`. Defaults to `[]`. */\n  tools?: Tool[]\n  /** Turn-level input middleware, executed in order against the {@link @nhtio/adk!TurnContext} before the LLM dispatch. Defaults to `[]`. */\n  turnInputPipeline?: TurnPipelineMiddlewareFn[]\n  /** Turn-level output middleware, executed in order against the {@link @nhtio/adk!TurnContext} after the LLM dispatch resolves successfully. Defaults to `[]`. */\n  turnOutputPipeline?: TurnPipelineMiddlewareFn[]\n  /** LLM-iteration input middleware, executed in order against the {@link @nhtio/adk!DispatchContext} before the executor on each iteration. Defaults to `[]`. */\n  dispatchInputPipeline?: DispatchPipelineMiddlewareFn[]\n  /** LLM-iteration output middleware, executed in order against the {@link @nhtio/adk!DispatchContext} after the executor on each iteration. Defaults to `[]`. */\n  dispatchOutputPipeline?: DispatchPipelineMiddlewareFn[]\n}\n\n/**\n * Fully-resolved {@link TurnRunnerConfig} after schema validation.\n *\n * @remarks\n * All optional fields are guaranteed present (e.g. `tools` defaults to `[]`). The runner stores\n * this type internally so field access never needs to guard for undefined.\n */\nexport type ResolvedTurnRunnerConfig = Required<TurnRunnerConfig>\n\n/**\n * Validator schema used to validate a {@link TurnRunnerConfig} at {@link @nhtio/adk!TurnRunner} construction time.\n *\n * @remarks\n * Validates that all callbacks are functions of the correct arity, and that `tools` — when\n * provided — is an array of valid {@link @nhtio/adk!Tool} instances. Defaults `tools` to `[]`.\n *\n * Throws {@link @nhtio/adk!E_INVALID_TURN_RUNNER_CONFIG} (via the {@link @nhtio/adk!TurnRunner} constructor) when\n * validation fails.\n */\nexport const turnRunnerConfigSchema = validator.object<TurnRunnerConfig>({\n  executorCallback: validator.function().required(),\n  fetchMemoriesCallback: validator.function().arity(1).required(),\n  fetchMessagesCallback: validator.function().arity(1).required(),\n  fetchThoughtsCallback: validator.function().arity(1).required(),\n  fetchToolCallsCallback: validator.function().arity(1).required(),\n  fetchToolsCallback: validator.function().arity(1).required(),\n  refreshStandingInstructionsCallback: validator.function().arity(1).required(),\n  storeStandingInstructionCallback: validator.function().arity(2).required(),\n  mutateStandingInstructionCallback: validator.function().arity(2).required(),\n  deleteStandingInstructionCallback: validator.function().arity(2).required(),\n  storeMemoryCallback: validator.function().arity(2).required(),\n  mutateMemoryCallback: validator.function().arity(2).required(),\n  deleteMemoryCallback: validator.function().arity(2).required(),\n  fetchRetrievablesCallback: validator.function().arity(1).required(),\n  storeRetrievableCallback: validator.function().arity(2).required(),\n  mutateRetrievableCallback: validator.function().arity(2).required(),\n  deleteRetrievableCallback: validator.function().arity(2).required(),\n  storeMessageCallback: validator.function().arity(2).required(),\n  mutateMessageCallback: validator.function().arity(2).required(),\n  deleteMessageCallback: validator.function().arity(2).required(),\n  storeThoughtCallback: validator.function().arity(2).required(),\n  mutateThoughtCallback: validator.function().arity(2).required(),\n  deleteThoughtCallback: validator.function().arity(2).required(),\n  storeToolCallCallback: validator.function().arity(2).required(),\n  mutateToolCallCallback: validator.function().arity(2).required(),\n  deleteToolCallCallback: validator.function().arity(2).required(),\n  replaceToolCallGroupCallback: validator.function().arity(3).optional(),\n  storeMediaBytesCallback: validator.function().arity(3).required(),\n  storeRetrievableBytesCallback: validator.function().arity(3).required(),\n  tools: validator\n    .array()\n    .items(\n      // `.optional()`, not `.required()`: this `.any()` is a type-argument inside `items(...)`,\n      // describing what a tool element looks like — it must NOT impose array cardinality. A\n      // `.required()` item turns the array into `array.includesRequiredUnknowns` (\"must contain\n      // ≥1 tool\"), which contradicts the contract above (`tools` is optional, defaults to `[]`).\n      // `.optional()` satisfies adk/require-validator-any-required by declaring disposition\n      // explicitly while leaving the empty-array default valid.\n      validator\n        .any()\n        .optional()\n        .custom((value: unknown, helpers: { error: (code: string) => unknown }) => {\n          if (Tool.isTool(value)) return value\n          return helpers.error('any.invalid')\n        })\n    )\n    .default([]),\n  turnInputPipeline: validator.array().items(validator.function()).default([]),\n  turnOutputPipeline: validator.array().items(validator.function()).default([]),\n  dispatchInputPipeline: validator.array().items(validator.function()).default([]),\n  dispatchOutputPipeline: validator.array().items(validator.function()).default([]),\n})\n","import { DateTime } from 'luxon'\nimport { Middleware } from '@nhtio/middleware'\nimport { TurnGate } from './classes/turn_gate'\nimport { DispatchRunner } from './dispatch_runner'\nimport { validateOrThrow } from './utils/validation'\nimport { ToolRegistry } from './classes/tool_registry'\nimport { isInstanceOf, isError } from './utils/guards'\nimport { TypedEventEmitter } from '@nhtio/tiny-typed-emitter'\nimport { runWithEstimationWarnings } from './utils/estimation_context'\nimport { turnRunnerConfigSchema } from './contracts/turn_runner_config'\nimport { TurnContext, RawTurnContext } from './contracts/turn_runner_context'\nimport {\n  E_INVALID_TURN_RUNNER_CONFIG,\n  E_INPUT_PIPELINE_ERROR,\n  E_OUTPUT_PIPELINE_ERROR,\n  E_PIPELINE_SHORT_CIRCUITED,\n} from './exceptions/runtime'\nimport type { RawTurnGate } from './classes/turn_gate'\nimport type { WarningEvent } from './types/dispatch_runner'\nimport type { EstimationWarning } from './utils/estimation_context'\nimport type { ResolvedTurnRunnerConfig, TurnRunnerConfig } from './contracts/turn_runner_config'\nimport type {\n  OpenGateFn,\n  TurnEvents,\n  TurnEvent,\n  TurnEventListener,\n  TurnPipelineMiddlewareFn,\n  TurnObservabilityEvents,\n  TurnObservabilityEvent,\n  TurnObservabilityEventListener,\n} from './types/turn_runner'\n\nexport type {\n  TurnPipelineMiddlewareFn,\n  TurnStreamableContent,\n  TurnToolCallContent,\n  TurnStartEvent,\n  TurnEndEvent,\n  TurnGateClosedEvent,\n  ToolExecutionStartEvent,\n  ToolExecutionEndEvent,\n  EmitMessageFn,\n  EmitThoughtFn,\n  EmitToolCallFn,\n  EmitToolExecutionStartFn,\n  EmitToolExecutionEndFn,\n  OpenGateFn,\n  TurnEvents,\n  TurnEvent,\n  TurnEventListener,\n  TurnObservabilityEvents,\n  TurnObservabilityEvent,\n  TurnObservabilityEventListener,\n} from './types/turn_runner'\n\n/**\n * Executes a single agent turn through paired input and output middleware pipelines.\n *\n * @remarks\n * Construction validates `config` eagerly and throws {@link @nhtio/adk!E_INVALID_TURN_RUNNER_CONFIG} if it\n * does not satisfy the schema — fail-fast so misconfiguration surfaces before any turn runs.\n *\n * Each call to {@link TurnRunner.run} threads a {@link @nhtio/adk!TurnContext} through the input pipeline,\n * invokes the model, then threads the result through the output pipeline. Middleware on each side\n * can read and mutate the context for pre- and post-processing (e.g. message normalisation, tool\n * call dispatch, response filtering).\n *\n * **Two event buses:**\n * - Functional bus (`on` / `off` / `once`): `message`, `thought`, `toolCall` — pipeline-affecting\n *   events that middleware raises throughout turn execution.\n * - Observability bus (`observe` / `unobserve` / `observeOnce`): `turnStart`, `turnEnd`,\n *   `turnGateOpen`, `turnGateClosed`, `error` — instrumentation-only events that monitor execution\n *   without participating in it.\n *\n * Streaming content is surfaced via `message` and `thought` events; tool call lifecycle via\n * `toolCall`; non-fatal pipeline errors via the observability `error` event; gate lifecycle via\n * `turnGateOpen` and `turnGateClosed` — all throughout execution.\n *\n * @example\n * ```ts\n * const runner = new TurnRunner({\n *   fetchMemoriesCallback: async (ctx) => memoryStore.query(ctx),\n *   fetchMessagesCallback: async (ctx) => messageStore.history(ctx),\n *   fetchThoughtsCallback: async (ctx) => thoughtStore.history(ctx),\n *   fetchToolCallsCallback: async (ctx) => toolCallStore.history(ctx),\n * })\n * // Functional bus — pipeline events\n * runner.on('message', (chunk) => process.stdout.write(chunk.aDelta))\n * // Observability bus — instrumentation\n * runner.observe('error', (err) => console.error(err.toString()))\n * runner.observe('turnStart', ({ turnId }) => console.log('turn started', turnId))\n * runner.observe('turnGateOpen', (gate) => {\n *   if (gate.reason === 'tool_approval') {\n *     gate.resolve(true) // approve immediately for this example\n *   }\n * })\n * await runner.run({\n *   turnAbortController: new AbortController(),\n *   systemPrompt: 'You are a helpful assistant.',\n *   standingInstructions: [],\n * })\n * ```\n */\nexport class TurnRunner {\n  /**\n   * Returns `true` if `value` is a {@link TurnRunner} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link TurnRunner} instance.\n   */\n  public static isTurnRunner(value: unknown): value is TurnRunner {\n    return isInstanceOf(value, 'TurnRunner', TurnRunner)\n  }\n\n  #config: ResolvedTurnRunnerConfig\n  #inputPipeline: Middleware<TurnPipelineMiddlewareFn>\n  #outputPipeline: Middleware<TurnPipelineMiddlewareFn>\n  #functionalEmitter: TypedEventEmitter<TurnEvents>\n  #observabilityEmitter: TypedEventEmitter<TurnObservabilityEvents>\n\n  /**\n   * @param config - Construction-time configuration validated against the turn-runner config schema.\n   * @throws {@link @nhtio/adk!E_INVALID_TURN_RUNNER_CONFIG} when `config` does not satisfy the schema.\n   */\n  constructor(config: TurnRunnerConfig) {\n    // Validate once, capturing the field-level error so the thrown exception can name the\n    // offending field(s) (e.g. a missing required callback) instead of failing opaquely.\n    const { error } = turnRunnerConfigSchema.validate(config, {\n      abortEarly: false,\n    })\n    if (error) {\n      const detail = error.details.map((d) => d.message).join('; ')\n      throw new E_INVALID_TURN_RUNNER_CONFIG([detail], { cause: error })\n    }\n    // Store the resolved config so optional fields (e.g. tools) are always present.\n    this.#config = validateOrThrow<ResolvedTurnRunnerConfig>(turnRunnerConfigSchema, config, true)\n    const turnInputPipeline = new Middleware<TurnPipelineMiddlewareFn>()\n    const turnOutputPipeline = new Middleware<TurnPipelineMiddlewareFn>()\n    const wrap =\n      (fn: TurnPipelineMiddlewareFn): TurnPipelineMiddlewareFn =>\n      (ctx, next) => {\n        // Skip downstream user middlewares once an abort has been signalled. The\n        // wrapper still calls next() so the pipeline reaches its terminal resolver\n        // (keeping the short-circuit detector quiet); the original middleware body\n        // does not run, so it has nothing to clean up.\n        if (ctx.aborted) return next()\n        return fn(ctx, next)\n      }\n    for (const fn of this.#config.turnInputPipeline) turnInputPipeline.add(wrap(fn))\n    for (const fn of this.#config.turnOutputPipeline) turnOutputPipeline.add(wrap(fn))\n    // Hold the Middleware; derive a fresh Runner per turn (a Runner's internal cursor never\n    // resets across .run() calls, so caching one here would only execute the pipeline once).\n    this.#inputPipeline = turnInputPipeline\n    this.#outputPipeline = turnOutputPipeline\n    this.#functionalEmitter = new TypedEventEmitter<TurnEvents>()\n    this.#observabilityEmitter = new TypedEventEmitter<TurnObservabilityEvents>()\n  }\n\n  // ── Functional bus ───────────────────────────────────────────────────────\n\n  /**\n   * Removes a previously registered functional listener for `event`.\n   *\n   * @param event - The event to stop listening to.\n   * @param listener - The listener function to remove.\n   * @returns `this` for chaining.\n   */\n  off<K>(event: TurnEvent<K>, listener: TurnEventListener<K>): this {\n    this.#functionalEmitter.off(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a persistent functional listener for `event`.\n   *\n   * @param event - The event to listen to.\n   * @param listener - The function to call on each emission.\n   * @returns `this` for chaining.\n   */\n  on<K>(event: TurnEvent<K>, listener: TurnEventListener<K>): this {\n    this.#functionalEmitter.on(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a one-time functional listener for `event` that is automatically removed after the\n   * first emission.\n   *\n   * @param event - The event to listen to.\n   * @param listener - The function to call on the next emission.\n   * @returns `this` for chaining.\n   */\n  once<K>(event: TurnEvent<K>, listener: TurnEventListener<K>): this {\n    this.#functionalEmitter.once(event, listener)\n    return this\n  }\n\n  // ── Observability bus ────────────────────────────────────────────────────\n\n  /**\n   * Removes a previously registered observability listener for `event`.\n   *\n   * @param event - The event to stop observing.\n   * @param listener - The listener function to remove.\n   * @returns `this` for chaining.\n   */\n  unobserve<K>(\n    event: TurnObservabilityEvent<K>,\n    listener: TurnObservabilityEventListener<K>\n  ): this {\n    this.#observabilityEmitter.off(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a persistent observability listener for `event`.\n   *\n   * @remarks\n   * Use the observability bus (`observe` / `unobserve` / `observeOnce`) for instrumentation:\n   * turn lifecycle, gate lifecycle, and non-fatal errors. Use the functional bus (`on` / `off` /\n   * `once`) for pipeline-affecting events: `message`, `thought`, `toolCall`.\n   *\n   * @param event - The event to observe.\n   * @param listener - The function to call on each emission.\n   * @returns `this` for chaining.\n   */\n  observe<K>(event: TurnObservabilityEvent<K>, listener: TurnObservabilityEventListener<K>): this {\n    this.#observabilityEmitter.on(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a one-time observability listener for `event` that is automatically removed after\n   * the first emission.\n   *\n   * @param event - The event to observe once.\n   * @param listener - The function to call on the next emission.\n   * @returns `this` for chaining.\n   */\n  observeOnce<K>(\n    event: TurnObservabilityEvent<K>,\n    listener: TurnObservabilityEventListener<K>\n  ): this {\n    this.#observabilityEmitter.once(event, listener)\n    return this\n  }\n\n  // ── Turn execution ───────────────────────────────────────────────────────\n\n  /**\n   * Executes a single agent turn against the provided raw context.\n   *\n   * @remarks\n   * Returns `Promise<void>` intentionally — all meaningful output surfaces via events, not return\n   * values. Register listeners before calling `run`: observability events (`turnStart`, `turnEnd`)\n   * bracket execution; functional events (`message`, `thought`, `toolCall`) fire throughout;\n   * observability `error` carries non-fatal pipeline failures; `turnGateOpen` and `turnGateClosed`\n   * fire when middleware suspends via `ctx.waitFor()`. Awaiting this method only tells you the\n   * pipeline has finished, not what it produced.\n   *\n   * Constructs a validated {@link @nhtio/adk!TurnContext} from `context` (throwing\n   * {@link @nhtio/adk!E_INVALID_TURN_CONTEXT} on failure), then runs the input middleware pipeline.\n   * Abort signals are silently swallowed.\n   *\n   * @param context - Raw input validated and wrapped into a {@link @nhtio/adk!TurnContext} before execution.\n   * @throws {@link @nhtio/adk!E_INVALID_TURN_CONTEXT} when `context` does not satisfy the schema.\n   */\n  async run(context: RawTurnContext): Promise<void> {\n    const abortController = context.turnAbortController ?? new AbortController()\n\n    // Forward declaration so openGate can reference turnContext.id before it is assigned.\n    let turnContextId: string\n\n    const openGate: OpenGateFn = <T>(raw: Omit<RawTurnGate, 'turnId' | 'abortSignal'>) => {\n      const gate = new TurnGate<T>({\n        ...raw,\n        turnId: turnContextId,\n        abortSignal: abortController.signal,\n      })\n      this.#observabilityEmitter.emit('turnGateOpen', gate)\n      const promise = gate._promise()\n      promise.then(\n        () => {\n          this.#observabilityEmitter.emit('turnGateClosed', {\n            gateId: gate.id,\n            turnId: gate.turnId,\n            result: 'resolved',\n            settledAt: DateTime.now(),\n          })\n        },\n        (err: unknown) => {\n          let result: 'rejected' | 'aborted' | 'timeout' = 'rejected'\n          if (isInstanceOf(err, 'E_TURN_GATE_ABORTED')) result = 'aborted'\n          else if (isInstanceOf(err, 'E_TURN_GATE_TIMEOUT')) result = 'timeout'\n          this.#observabilityEmitter.emit('turnGateClosed', {\n            gateId: gate.id,\n            turnId: gate.turnId,\n            result,\n            settledAt: DateTime.now(),\n          })\n        }\n      )\n      return promise\n    }\n\n    const tools = new ToolRegistry(this.#config.tools)\n\n    const turnContext = new TurnContext(\n      { ...context, turnAbortController: abortController },\n      {\n        fetchMemories: this.#config.fetchMemoriesCallback,\n        fetchMessages: this.#config.fetchMessagesCallback,\n        fetchThoughts: this.#config.fetchThoughtsCallback,\n        fetchToolCalls: this.#config.fetchToolCallsCallback,\n        fetchTools: this.#config.fetchToolsCallback,\n        refreshStandingInstructions: this.#config.refreshStandingInstructionsCallback,\n        storeStandingInstruction: this.#config.storeStandingInstructionCallback,\n        mutateStandingInstruction: this.#config.mutateStandingInstructionCallback,\n        deleteStandingInstruction: this.#config.deleteStandingInstructionCallback,\n        storeMemory: this.#config.storeMemoryCallback,\n        mutateMemory: this.#config.mutateMemoryCallback,\n        deleteMemory: this.#config.deleteMemoryCallback,\n        fetchRetrievables: this.#config.fetchRetrievablesCallback,\n        storeRetrievable: this.#config.storeRetrievableCallback,\n        mutateRetrievable: this.#config.mutateRetrievableCallback,\n        deleteRetrievable: this.#config.deleteRetrievableCallback,\n        storeMessage: this.#config.storeMessageCallback,\n        mutateMessage: this.#config.mutateMessageCallback,\n        deleteMessage: this.#config.deleteMessageCallback,\n        storeThought: this.#config.storeThoughtCallback,\n        mutateThought: this.#config.mutateThoughtCallback,\n        deleteThought: this.#config.deleteThoughtCallback,\n        storeToolCall: this.#config.storeToolCallCallback,\n        mutateToolCall: this.#config.mutateToolCallCallback,\n        deleteToolCall: this.#config.deleteToolCallCallback,\n        replaceToolCallGroup: this.#config.replaceToolCallGroupCallback,\n        storeMediaBytes: this.#config.storeMediaBytesCallback,\n        storeRetrievableBytes: this.#config.storeRetrievableBytesCallback,\n        emitMessage: (content) => this.#functionalEmitter.emit('message', content),\n        emitThought: (content) => this.#functionalEmitter.emit('thought', content),\n        emitToolCall: (content) => this.#functionalEmitter.emit('toolCall', content),\n        emitToolExecutionStart: (event) =>\n          this.#observabilityEmitter.emit('toolExecutionStart', event),\n        emitToolExecutionEnd: (event) => this.#observabilityEmitter.emit('toolExecutionEnd', event),\n        openGate,\n        tools,\n      }\n    )\n\n    turnContextId = turnContext.id\n\n    // Publish a turn-level warn-sink for the duration of the run so a token estimation done directly in a\n    // TURN pipeline (outside any dispatch) can degrade-and-warn instead of throwing. A nested\n    // DispatchRunner.dispatch() pushes its own sink on top (see estimation_context), so estimations inside\n    // a dispatch route to the richer dispatch-scoped sink and this turn-level one is the fallback. No\n    // dispatchId/iteration here — those belong to a dispatch scope, not the turn.\n    const emitEstimationWarning = (w: EstimationWarning): void => {\n      const event: WarningEvent = {\n        emittedAt: DateTime.now(),\n        source: 'turn-runner',\n        kind: 'token-estimation-degraded',\n        message: `token estimation for encoding \"${String(w.encoding)}\" failed; fell back to a char-based estimate`,\n        error: w.error,\n        payload: { encoding: w.encoding, textPreview: w.textPreview },\n      }\n      this.#observabilityEmitter.emit('warning', event)\n    }\n\n    await runWithEstimationWarnings(emitEstimationWarning, async () => {\n      const startedAt = DateTime.now()\n      this.#observabilityEmitter.emit('turnStart', {\n        turnId: turnContext.id,\n        startedAt,\n      })\n\n      const emitTurnEnd = () => {\n        const endedAt = DateTime.now()\n        this.#observabilityEmitter.emit('turnEnd', {\n          turnId: turnContext.id,\n          startedAt,\n          endedAt,\n          durationMs: endedAt.diff(startedAt).milliseconds,\n        })\n      }\n\n      // 1. Input pipeline\n      let inputFailed = false\n      let inputReached = false\n      await this.#inputPipeline\n        .runner()\n        .errorHandler(async (error) => {\n          if (!isError(error) || !isInstanceOf(error, 'AbortError')) {\n            inputFailed = true\n            const err = new E_INPUT_PIPELINE_ERROR({\n              cause: isError(error) ? error : undefined,\n            })\n            this.#observabilityEmitter.emit('error', err)\n          }\n        })\n        .finalHandler(async () => {\n          inputReached = true\n        })\n        .run((fn, next) => Promise.resolve(fn(turnContext, next)))\n\n      if (!inputReached && !inputFailed && !turnContext.aborted) {\n        inputFailed = true\n        const err = new E_PIPELINE_SHORT_CIRCUITED(['turn-input'])\n        this.#observabilityEmitter.emit('error', err)\n      }\n\n      if (inputFailed || turnContext.aborted) {\n        emitTurnEnd()\n        return\n      }\n\n      // 2. LLM execution dispatch\n      let dispatchFailed = false\n      try {\n        await DispatchRunner.dispatch({\n          source: turnContext,\n          executor: this.#config.executorCallback,\n          turnInputPipeline: this.#config.dispatchInputPipeline,\n          turnOutputPipeline: this.#config.dispatchOutputPipeline,\n          observers: {\n            dispatchStart: [\n              (e) => {\n                this.#observabilityEmitter.emit('dispatchStart', e)\n              },\n            ],\n            dispatchEnd: [\n              (e) => {\n                this.#observabilityEmitter.emit('dispatchEnd', e)\n              },\n            ],\n            iterationStart: [\n              (e) => {\n                this.#observabilityEmitter.emit('iterationStart', e)\n              },\n            ],\n            iterationEnd: [\n              (e) => {\n                this.#observabilityEmitter.emit('iterationEnd', e)\n              },\n            ],\n            log: [\n              (e) => {\n                this.#observabilityEmitter.emit('log', e)\n              },\n            ],\n            // Re-forward a DispatchRunner-emitted `warning` (e.g. token-estimation degraded) up to the turn\n            // bus, so a consumer subscribed only to the TurnRunner still sees it — mirrors the log/dispatch*\n            // bridges above. Non-fatal; the dispatch continues.\n            warning: [\n              (e) => {\n                this.#observabilityEmitter.emit('warning', e)\n              },\n            ],\n          },\n        })\n      } catch (err) {\n        dispatchFailed = true\n        const wrapped = isInstanceOf(err, 'BaseException')\n          ? (err as InstanceType<typeof Error>)\n          : err\n        this.#observabilityEmitter.emit('error', wrapped as any)\n      }\n\n      if (dispatchFailed || turnContext.aborted) {\n        emitTurnEnd()\n        return\n      }\n\n      // 3. Output pipeline\n      let outputFailed = false\n      let outputReached = false\n      await this.#outputPipeline\n        .runner()\n        .errorHandler(async (error) => {\n          if (!isError(error) || !isInstanceOf(error, 'AbortError')) {\n            outputFailed = true\n            const err = new E_OUTPUT_PIPELINE_ERROR({\n              cause: isError(error) ? error : undefined,\n            })\n            this.#observabilityEmitter.emit('error', err)\n          }\n        })\n        .finalHandler(async () => {\n          outputReached = true\n        })\n        .run((fn, next) => Promise.resolve(fn(turnContext, next)))\n\n      if (!outputReached && !outputFailed && !turnContext.aborted) {\n        const err = new E_PIPELINE_SHORT_CIRCUITED(['turn-output'])\n        this.#observabilityEmitter.emit('error', err)\n      }\n\n      emitTurnEnd()\n    })\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"turn_runner-BHHD6h77.mjs","names":["#id","#turnId","#reason","#payload","#createdAt","#settled","#schema","#controller","#promise","#resolve","#reject","#config","#inputPipeline","#outputPipeline","#functionalEmitter","#observabilityEmitter"],"sources":["../src/lib/classes/turn_gate.ts","../src/lib/contracts/turn_runner_config.ts","../src/lib/turn_runner.ts"],"sourcesContent":["import { DateTime } from 'luxon'\nimport { validator } from '@nhtio/validation'\nimport { validateOrThrow } from '../utils/validation'\nimport { isInstanceOf, isError, isObject } from '../utils/guards'\nimport {\n  E_TURN_GATE_ABORTED,\n  E_TURN_GATE_TIMEOUT,\n  E_INVALID_TURN_GATE_RESOLUTION,\n  E_INVALID_INITIAL_TURN_GATE_VALUE,\n} from '../exceptions/runtime'\nimport type { Schema } from '@nhtio/validation'\n\n/**\n * Plain input object supplied to {@link TurnGate} at construction time.\n *\n * @remarks\n * `turnId` and `abortSignal` are injected by the runner — callers constructing a gate via\n * `ctx.waitFor()` never supply them directly.\n *\n * `abortSignal` is `AbortSignal` (not `AbortController`) because the gate reacts to turn-level\n * cancellation but cannot trigger it. The gate owns its own internal `AbortController` for\n * `gate.abort()`.\n */\nexport interface RawTurnGate {\n  /** Stable unique identifier for this gate. */\n  id: string\n  /** The ID of the turn that opened this gate. */\n  turnId: string\n  /** Human-readable label describing why this gate was opened (e.g. `'tool_approval'`). */\n  reason: string\n  /** Arbitrary data supplied to the gate opener; passed through to `turnGateOpen` listeners. */\n  payload: unknown\n  /** Optional validator schema for the resolution value. When present, `resolve()` validates before settling. */\n  schema?: Schema\n  /** Optional timeout in milliseconds. When elapsed the gate self-rejects with {@link @nhtio/adk!E_TURN_GATE_TIMEOUT}. */\n  timeout?: number\n  /** The turn's abort signal. When fired the gate self-rejects with {@link @nhtio/adk!E_TURN_GATE_ABORTED}. */\n  abortSignal?: AbortSignal\n  /** When this gate was created. */\n  createdAt: string | number | Date | DateTime\n}\n\n/**\n * Fully-resolved {@link RawTurnGate} after schema validation.\n *\n * @internal\n */\ninterface ResolvedTurnGate {\n  id: string\n  turnId: string\n  reason: string\n  payload: unknown\n  schema?: Schema\n  timeout?: number\n  abortSignal?: AbortSignal\n  createdAt: DateTime\n}\n\n/**\n * Validator schema used to validate a {@link RawTurnGate} before constructing a {@link TurnGate}.\n *\n * @remarks\n * - `schema` and `abortSignal` are validated as opaque passthrough values.\n * - `timeout` must be a positive integer when provided.\n */\nconst rawTurnGateSchema = validator.object<RawTurnGate>({\n  id: validator.string().required(),\n  turnId: validator.string().required(),\n  reason: validator.string().required(),\n  payload: validator.any().required(),\n  schema: validator\n    .any()\n    .custom((value, helpers) => {\n      if (value === undefined || value === null) return undefined\n      if (typeof (value as any).validate === 'function') return value\n      return helpers.error('any.invalid')\n    })\n    .optional(),\n  timeout: validator.number().integer().min(1).optional(),\n  abortSignal: validator\n    .any()\n    .custom((value, helpers) => {\n      if (value === undefined || value === null) return undefined\n      // eslint-disable-next-line adk/use-is-instance-of -- native built-in; AbortSignal cross-realm is handled by the duck-type fallback below\n      if (typeof AbortSignal !== 'undefined' && value instanceof AbortSignal) return value\n      if (\n        isObject(value) &&\n        typeof (value as any).aborted === 'boolean' &&\n        typeof (value as any).addEventListener === 'function'\n      ) {\n        return value\n      }\n      return helpers.error('any.invalid')\n    })\n    .optional(),\n  createdAt: validator.datetime().required(),\n})\n\n/**\n * A cooperative suspension gate that blocks a turn's middleware pipeline until resolved, rejected,\n * aborted, or timed out.\n *\n * @typeParam T - The expected type of the resolution value.\n *\n * @remarks\n * Created exclusively via `ctx.waitFor()` — middleware never constructs a gate directly.\n * The gate emits `turnGateOpen` on the runner's observability bus at creation time and\n * `turnGateClosed` when it settles.\n *\n * Resolution is validated against an optional schema before the internal promise is settled.\n * A validation failure throws {@link @nhtio/adk!E_INVALID_TURN_GATE_RESOLUTION} **synchronously in the\n * caller's context** — the promise is NOT settled and the gate remains open.\n */\nexport class TurnGate<T = unknown> {\n  /**\n   * Validator schema that accepts a {@link RawTurnGate} object.\n   *\n   * @remarks\n   * Reusable fragment for any schema that needs to validate or nest a gate entry.\n   */\n  public static schema = rawTurnGateSchema\n\n  /**\n   * Returns `true` if `value` is a {@link TurnGate} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link TurnGate} instance.\n   */\n  public static isTurnGate(value: unknown): value is TurnGate {\n    return isInstanceOf(value, 'TurnGate', TurnGate)\n  }\n\n  /** Unique identifier for this gate instance. */\n  declare readonly id: string\n  /** Id of the turn this gate belongs to. */\n  declare readonly turnId: string\n  /** Human-readable reason the gate was opened. */\n  declare readonly reason: string\n  /** Optional caller-supplied payload describing what the gate is waiting on. */\n  declare readonly payload: unknown\n  /** When the gate was created. */\n  declare readonly createdAt: DateTime\n  /** Whether the gate has been settled (resolved or rejected) and no longer blocks the turn. */\n  declare readonly isSettled: boolean\n\n  #id: string\n  #turnId: string\n  #reason: string\n  #payload: unknown\n  #createdAt: DateTime\n  #settled: boolean\n  #schema: Schema | undefined\n  #controller: AbortController\n  #resolve!: (value: T) => void\n  #reject!: (reason: unknown) => void\n  #promise: Promise<T>\n\n  /**\n   * @param raw - The raw gate input validated against `rawTurnGateSchema`.\n   * @throws {@link @nhtio/adk!E_INVALID_INITIAL_TURN_GATE_VALUE} when `raw` does not satisfy the schema.\n   */\n  constructor(raw: RawTurnGate) {\n    let resolved: ResolvedTurnGate\n    try {\n      resolved = validateOrThrow<ResolvedTurnGate>(rawTurnGateSchema, raw, true)\n    } catch (err) {\n      throw new E_INVALID_INITIAL_TURN_GATE_VALUE({ cause: isError(err) ? err : undefined })\n    }\n\n    this.#id = resolved.id\n    this.#turnId = resolved.turnId\n    this.#reason = resolved.reason\n    this.#payload = resolved.payload\n    this.#createdAt = resolved.createdAt\n    this.#settled = false\n    this.#schema = resolved.schema\n    this.#controller = new AbortController()\n\n    this.#promise = new Promise<T>((resolve, reject) => {\n      this.#resolve = resolve\n      this.#reject = reject\n    })\n\n    // Wire the internal abort controller\n    const onAbort = () => {\n      if (!this.#settled) {\n        this.#settled = true\n        this.#reject(new E_TURN_GATE_ABORTED())\n      }\n    }\n\n    this.#controller.signal.addEventListener('abort', onAbort, { once: true })\n\n    // Wire the external turn abort signal\n    if (resolved.abortSignal) {\n      if (resolved.abortSignal.aborted) {\n        // Already aborted — reject immediately after construction\n        queueMicrotask(() => onAbort())\n      } else {\n        resolved.abortSignal.addEventListener('abort', onAbort, { once: true })\n        // Clean up the external listener once the gate settles via another path\n        this.#promise.then(\n          () => resolved.abortSignal!.removeEventListener('abort', onAbort),\n          () => resolved.abortSignal!.removeEventListener('abort', onAbort)\n        )\n      }\n    }\n\n    // Wire the timeout\n    if (resolved.timeout !== undefined) {\n      const timer = setTimeout(() => {\n        if (!this.#settled) {\n          this.#settled = true\n          this.#reject(new E_TURN_GATE_TIMEOUT())\n        }\n      }, resolved.timeout)\n\n      this.#promise.then(\n        () => clearTimeout(timer),\n        () => clearTimeout(timer)\n      )\n    }\n\n    Object.defineProperties(this, {\n      id: {\n        get: () => this.#id,\n        enumerable: true,\n        configurable: false,\n      },\n      turnId: {\n        get: () => this.#turnId,\n        enumerable: true,\n        configurable: false,\n      },\n      reason: {\n        get: () => this.#reason,\n        enumerable: true,\n        configurable: false,\n      },\n      payload: {\n        get: () => this.#payload,\n        enumerable: true,\n        configurable: false,\n      },\n      createdAt: {\n        get: () => this.#createdAt,\n        enumerable: true,\n        configurable: false,\n      },\n      isSettled: {\n        get: () => this.#settled,\n        enumerable: true,\n        configurable: false,\n      },\n    })\n  }\n\n  /**\n   * Resolves the gate with `value`, unblocking the awaiting middleware.\n   *\n   * @remarks\n   * If a schema was provided at construction, `value` is validated synchronously before the\n   * promise is settled. A validation failure throws {@link @nhtio/adk!E_INVALID_TURN_GATE_RESOLUTION}\n   * in the caller's context — the promise is NOT settled and the gate remains open.\n   *\n   * No-ops if the gate is already settled.\n   *\n   * @param value - The resolution value. Must satisfy the gate's schema when one was provided.\n   * @throws {@link @nhtio/adk!E_INVALID_TURN_GATE_RESOLUTION} when `value` fails schema validation.\n   */\n  resolve(value: unknown): void {\n    if (this.#settled) return\n    if (this.#schema !== undefined) {\n      try {\n        value = validateOrThrow(this.#schema, value, true)\n      } catch (err) {\n        throw new E_INVALID_TURN_GATE_RESOLUTION({\n          cause: isError(err) ? err : undefined,\n        })\n      }\n    }\n    this.#settled = true\n    this.#resolve(value as T)\n  }\n\n  /**\n   * Rejects the gate with `error`, unblocking the awaiting middleware with a rejection.\n   *\n   * @remarks\n   * No-ops if the gate is already settled.\n   *\n   * @param error - The rejection reason.\n   */\n  reject(error: Error): void {\n    if (this.#settled) return\n    this.#settled = true\n    this.#reject(error)\n  }\n\n  /**\n   * Aborts the gate by firing the internal `AbortController`, which rejects the promise with\n   * {@link @nhtio/adk!E_TURN_GATE_ABORTED}.\n   *\n   * @remarks\n   * No-ops if the gate is already settled. Distinct from the turn-level abort signal — this\n   * allows callers to cancel a specific gate without aborting the whole turn.\n   */\n  abort(): void {\n    if (this.#settled) return\n    this.#controller.abort()\n  }\n\n  /**\n   * Returns the internal promise. Called by `ctx.waitFor()` to block the middleware pipeline.\n   *\n   * @internal\n   */\n  _promise(): Promise<T> {\n    return this.#promise\n  }\n}\n","import { Tool } from '../classes/tool'\nimport { validator } from '@nhtio/validation'\nimport type { TurnPipelineMiddlewareFn } from '../types/turn_runner'\nimport type { DispatchPipelineMiddlewareFn, DispatchExecutorFn } from '../types/dispatch_runner'\nimport type {\n  MemoryRetrievalFn,\n  MessageRetrievalFn,\n  ThoughtRetrievalFn,\n  ToolCallRetrievalFn,\n  ToolsRetrievalFn,\n  StandingInstructionsRefreshFn,\n  StandingInstructionStoreFn,\n  StandingInstructionMutateFn,\n  StandingInstructionDeleteFn,\n  MemoryStoreFn,\n  MemoryMutateFn,\n  MemoryDeleteFn,\n  RetrievableRetrievalFn,\n  RetrievableStoreFn,\n  RetrievableMutateFn,\n  RetrievableDeleteFn,\n  MessageStoreFn,\n  MessageMutateFn,\n  MessageDeleteFn,\n  ThoughtStoreFn,\n  ThoughtMutateFn,\n  ThoughtDeleteFn,\n  ToolCallStoreFn,\n  ToolCallMutateFn,\n  ToolCallDeleteFn,\n  ToolCallGroupReplaceFn,\n  MediaBytesStoreFn,\n  RetrievableBytesStoreFn,\n} from './turn_runner_context'\n\n/**\n * Configuration supplied to {@link @nhtio/adk!TurnRunner} at construction time.\n *\n * @remarks\n * Validated against `turnRunnerConfigSchema` at construction — a misconfigured runner throws\n * immediately rather than failing on the first turn.\n *\n * All fetch and mutation callbacks are required: they are injected into each {@link @nhtio/adk!TurnContext}\n * so middleware can call fetch, refresh, and persistence methods directly on the context without\n * coupling to the runner.\n *\n * `tools` is optional at the caller level and defaults to `[]` after schema resolution — a runner\n * with no baseline tools is valid.\n */\nexport interface TurnRunnerConfig {\n  /** Performs the LLM API/SDK call for each iteration of the dispatch loop; receives the active {@link @nhtio/adk!DispatchContext} and an {@link @nhtio/adk!DispatchExecutorHelpers} object for managing per-id stream state. */\n  executorCallback: DispatchExecutorFn\n  /** Called once per turn to supply memories; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchMemoriesCallback: MemoryRetrievalFn\n  /** Called once per turn to supply conversation history; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchMessagesCallback: MessageRetrievalFn\n  /** Called once per turn to supply thought traces; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchThoughtsCallback: ThoughtRetrievalFn\n  /** Called once per turn to supply tool call records; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchToolCallsCallback: ToolCallRetrievalFn\n  /** Called to supply available tools; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchToolsCallback: ToolsRetrievalFn\n  /** Called to refresh and return standing instructions; receives the active {@link @nhtio/adk!TurnContext}. */\n  refreshStandingInstructionsCallback: StandingInstructionsRefreshFn\n  /** Persists a new standing instruction. */\n  storeStandingInstructionCallback: StandingInstructionStoreFn\n  /** Updates an existing standing instruction in the persistence layer. */\n  mutateStandingInstructionCallback: StandingInstructionMutateFn\n  /** Removes a standing instruction from the persistence layer. */\n  deleteStandingInstructionCallback: StandingInstructionDeleteFn\n  /** Persists a new memory. */\n  storeMemoryCallback: MemoryStoreFn\n  /** Updates an existing memory in the persistence layer. */\n  mutateMemoryCallback: MemoryMutateFn\n  /** Removes a memory from the persistence layer by ID. */\n  deleteMemoryCallback: MemoryDeleteFn\n  /** Called once per turn to supply retrievable (RAG) records; receives the active {@link @nhtio/adk!TurnContext}. */\n  fetchRetrievablesCallback: RetrievableRetrievalFn\n  /** Persists a new retrievable record. */\n  storeRetrievableCallback: RetrievableStoreFn\n  /** Updates an existing retrievable record in the persistence layer. */\n  mutateRetrievableCallback: RetrievableMutateFn\n  /** Removes a retrievable record from the persistence layer by ID. */\n  deleteRetrievableCallback: RetrievableDeleteFn\n  /** Persists a new message. */\n  storeMessageCallback: MessageStoreFn\n  /** Updates an existing message in the persistence layer. */\n  mutateMessageCallback: MessageMutateFn\n  /** Removes a message from the persistence layer by ID. */\n  deleteMessageCallback: MessageDeleteFn\n  /** Persists a new thought. */\n  storeThoughtCallback: ThoughtStoreFn\n  /** Updates an existing thought in the persistence layer. */\n  mutateThoughtCallback: ThoughtMutateFn\n  /** Removes a thought from the persistence layer by ID. */\n  deleteThoughtCallback: ThoughtDeleteFn\n  /** Persists a new tool call. */\n  storeToolCallCallback: ToolCallStoreFn\n  /** Updates an existing tool call in the persistence layer. */\n  mutateToolCallCallback: ToolCallMutateFn\n  /** Removes a tool call from the persistence layer by ID. */\n  deleteToolCallCallback: ToolCallDeleteFn\n  /** Optionally replaces a complete tool-call group atomically. */\n  replaceToolCallGroupCallback?: ToolCallGroupReplaceFn\n  /** Persists tool-generated media bytes into consumer storage; returns a `MediaReader`. */\n  storeMediaBytesCallback: MediaBytesStoreFn\n  /** Persists extracted retrievable text bytes into consumer storage; returns a `SpoolReader`. */\n  storeRetrievableBytesCallback: RetrievableBytesStoreFn\n  /** Baseline tools available on every turn. Middleware may trim or extend this per-turn via `ctx.tools`. Defaults to `[]`. */\n  tools?: Tool[]\n  /** Turn-level input middleware, executed in order against the {@link @nhtio/adk!TurnContext} before the LLM dispatch. Defaults to `[]`. */\n  turnInputPipeline?: TurnPipelineMiddlewareFn[]\n  /** Turn-level output middleware, executed in order against the {@link @nhtio/adk!TurnContext} after the LLM dispatch resolves successfully. Defaults to `[]`. */\n  turnOutputPipeline?: TurnPipelineMiddlewareFn[]\n  /** LLM-iteration input middleware, executed in order against the {@link @nhtio/adk!DispatchContext} before the executor on each iteration. Defaults to `[]`. */\n  dispatchInputPipeline?: DispatchPipelineMiddlewareFn[]\n  /** LLM-iteration output middleware, executed in order against the {@link @nhtio/adk!DispatchContext} after the executor on each iteration. Defaults to `[]`. */\n  dispatchOutputPipeline?: DispatchPipelineMiddlewareFn[]\n}\n\n/**\n * Fully-resolved {@link TurnRunnerConfig} after schema validation.\n *\n * @remarks\n * All optional fields are guaranteed present (e.g. `tools` defaults to `[]`). The runner stores\n * this type internally so field access never needs to guard for undefined.\n */\nexport type ResolvedTurnRunnerConfig = Required<TurnRunnerConfig>\n\n/**\n * Validator schema used to validate a {@link TurnRunnerConfig} at {@link @nhtio/adk!TurnRunner} construction time.\n *\n * @remarks\n * Validates that all callbacks are functions of the correct arity, and that `tools` — when\n * provided — is an array of valid {@link @nhtio/adk!Tool} instances. Defaults `tools` to `[]`.\n *\n * Throws {@link @nhtio/adk!E_INVALID_TURN_RUNNER_CONFIG} (via the {@link @nhtio/adk!TurnRunner} constructor) when\n * validation fails.\n */\nexport const turnRunnerConfigSchema = validator.object<TurnRunnerConfig>({\n  executorCallback: validator.function().required(),\n  fetchMemoriesCallback: validator.function().arity(1).required(),\n  fetchMessagesCallback: validator.function().arity(1).required(),\n  fetchThoughtsCallback: validator.function().arity(1).required(),\n  fetchToolCallsCallback: validator.function().arity(1).required(),\n  fetchToolsCallback: validator.function().arity(1).required(),\n  refreshStandingInstructionsCallback: validator.function().arity(1).required(),\n  storeStandingInstructionCallback: validator.function().arity(2).required(),\n  mutateStandingInstructionCallback: validator.function().arity(2).required(),\n  deleteStandingInstructionCallback: validator.function().arity(2).required(),\n  storeMemoryCallback: validator.function().arity(2).required(),\n  mutateMemoryCallback: validator.function().arity(2).required(),\n  deleteMemoryCallback: validator.function().arity(2).required(),\n  fetchRetrievablesCallback: validator.function().arity(1).required(),\n  storeRetrievableCallback: validator.function().arity(2).required(),\n  mutateRetrievableCallback: validator.function().arity(2).required(),\n  deleteRetrievableCallback: validator.function().arity(2).required(),\n  storeMessageCallback: validator.function().arity(2).required(),\n  mutateMessageCallback: validator.function().arity(2).required(),\n  deleteMessageCallback: validator.function().arity(2).required(),\n  storeThoughtCallback: validator.function().arity(2).required(),\n  mutateThoughtCallback: validator.function().arity(2).required(),\n  deleteThoughtCallback: validator.function().arity(2).required(),\n  storeToolCallCallback: validator.function().arity(2).required(),\n  mutateToolCallCallback: validator.function().arity(2).required(),\n  deleteToolCallCallback: validator.function().arity(2).required(),\n  replaceToolCallGroupCallback: validator.function().arity(3).optional(),\n  storeMediaBytesCallback: validator.function().arity(3).required(),\n  storeRetrievableBytesCallback: validator.function().arity(3).required(),\n  tools: validator\n    .array()\n    .items(\n      // `.optional()`, not `.required()`: this `.any()` is a type-argument inside `items(...)`,\n      // describing what a tool element looks like — it must NOT impose array cardinality. A\n      // `.required()` item turns the array into `array.includesRequiredUnknowns` (\"must contain\n      // ≥1 tool\"), which contradicts the contract above (`tools` is optional, defaults to `[]`).\n      // `.optional()` satisfies adk/require-validator-any-required by declaring disposition\n      // explicitly while leaving the empty-array default valid.\n      validator\n        .any()\n        .optional()\n        .custom((value: unknown, helpers: { error: (code: string) => unknown }) => {\n          if (Tool.isTool(value)) return value\n          return helpers.error('any.invalid')\n        })\n    )\n    .default([]),\n  turnInputPipeline: validator.array().items(validator.function()).default([]),\n  turnOutputPipeline: validator.array().items(validator.function()).default([]),\n  dispatchInputPipeline: validator.array().items(validator.function()).default([]),\n  dispatchOutputPipeline: validator.array().items(validator.function()).default([]),\n})\n","import { DateTime } from 'luxon'\nimport { Middleware } from '@nhtio/middleware'\nimport { TurnGate } from './classes/turn_gate'\nimport { DispatchRunner } from './dispatch_runner'\nimport { validateOrThrow } from './utils/validation'\nimport { ToolRegistry } from './classes/tool_registry'\nimport { isInstanceOf, isError } from './utils/guards'\nimport { TypedEventEmitter } from '@nhtio/tiny-typed-emitter'\nimport { runWithEstimationWarnings } from './utils/estimation_context'\nimport { turnRunnerConfigSchema } from './contracts/turn_runner_config'\nimport { TurnContext, RawTurnContext } from './contracts/turn_runner_context'\nimport {\n  E_INVALID_TURN_RUNNER_CONFIG,\n  E_INPUT_PIPELINE_ERROR,\n  E_OUTPUT_PIPELINE_ERROR,\n  E_PIPELINE_SHORT_CIRCUITED,\n} from './exceptions/runtime'\nimport type { RawTurnGate } from './classes/turn_gate'\nimport type { WarningEvent } from './types/dispatch_runner'\nimport type { EstimationWarning } from './utils/estimation_context'\nimport type { ResolvedTurnRunnerConfig, TurnRunnerConfig } from './contracts/turn_runner_config'\nimport type {\n  OpenGateFn,\n  TurnEvents,\n  TurnEvent,\n  TurnEventListener,\n  TurnPipelineMiddlewareFn,\n  TurnObservabilityEvents,\n  TurnObservabilityEvent,\n  TurnObservabilityEventListener,\n} from './types/turn_runner'\n\nexport type {\n  TurnPipelineMiddlewareFn,\n  TurnStreamableContent,\n  TurnToolCallContent,\n  TurnStartEvent,\n  TurnEndEvent,\n  TurnGateClosedEvent,\n  ToolExecutionStartEvent,\n  ToolExecutionEndEvent,\n  EmitMessageFn,\n  EmitThoughtFn,\n  EmitToolCallFn,\n  EmitToolExecutionStartFn,\n  EmitToolExecutionEndFn,\n  OpenGateFn,\n  TurnEvents,\n  TurnEvent,\n  TurnEventListener,\n  TurnObservabilityEvents,\n  TurnObservabilityEvent,\n  TurnObservabilityEventListener,\n} from './types/turn_runner'\n\n/**\n * Executes a single agent turn through paired input and output middleware pipelines.\n *\n * @remarks\n * Construction validates `config` eagerly and throws {@link @nhtio/adk!E_INVALID_TURN_RUNNER_CONFIG} if it\n * does not satisfy the schema — fail-fast so misconfiguration surfaces before any turn runs.\n *\n * Each call to {@link TurnRunner.run} threads a {@link @nhtio/adk!TurnContext} through the input pipeline,\n * invokes the model, then threads the result through the output pipeline. Middleware on each side\n * can read and mutate the context for pre- and post-processing (e.g. message normalisation, tool\n * call dispatch, response filtering).\n *\n * **Two event buses:**\n * - Functional bus (`on` / `off` / `once`): `message`, `thought`, `toolCall` — pipeline-affecting\n *   events that middleware raises throughout turn execution.\n * - Observability bus (`observe` / `unobserve` / `observeOnce`): `turnStart`, `turnEnd`,\n *   `turnGateOpen`, `turnGateClosed`, `error` — instrumentation-only events that monitor execution\n *   without participating in it.\n *\n * Streaming content is surfaced via `message` and `thought` events; tool call lifecycle via\n * `toolCall`; non-fatal pipeline errors via the observability `error` event; gate lifecycle via\n * `turnGateOpen` and `turnGateClosed` — all throughout execution.\n *\n * @example\n * ```ts\n * const runner = new TurnRunner({\n *   fetchMemoriesCallback: async (ctx) => memoryStore.query(ctx),\n *   fetchMessagesCallback: async (ctx) => messageStore.history(ctx),\n *   fetchThoughtsCallback: async (ctx) => thoughtStore.history(ctx),\n *   fetchToolCallsCallback: async (ctx) => toolCallStore.history(ctx),\n * })\n * // Functional bus — pipeline events\n * runner.on('message', (chunk) => process.stdout.write(chunk.aDelta))\n * // Observability bus — instrumentation\n * runner.observe('error', (err) => console.error(err.toString()))\n * runner.observe('turnStart', ({ turnId }) => console.log('turn started', turnId))\n * runner.observe('turnGateOpen', (gate) => {\n *   if (gate.reason === 'tool_approval') {\n *     gate.resolve(true) // approve immediately for this example\n *   }\n * })\n * await runner.run({\n *   turnAbortController: new AbortController(),\n *   systemPrompt: 'You are a helpful assistant.',\n *   standingInstructions: [],\n * })\n * ```\n */\nexport class TurnRunner {\n  /**\n   * Returns `true` if `value` is a {@link TurnRunner} instance.\n   *\n   * @remarks\n   * Uses {@link @nhtio/adk!isInstanceOf} for cross-realm safety.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is a {@link TurnRunner} instance.\n   */\n  public static isTurnRunner(value: unknown): value is TurnRunner {\n    return isInstanceOf(value, 'TurnRunner', TurnRunner)\n  }\n\n  #config: ResolvedTurnRunnerConfig\n  #inputPipeline: Middleware<TurnPipelineMiddlewareFn>\n  #outputPipeline: Middleware<TurnPipelineMiddlewareFn>\n  #functionalEmitter: TypedEventEmitter<TurnEvents>\n  #observabilityEmitter: TypedEventEmitter<TurnObservabilityEvents>\n\n  /**\n   * @param config - Construction-time configuration validated against the turn-runner config schema.\n   * @throws {@link @nhtio/adk!E_INVALID_TURN_RUNNER_CONFIG} when `config` does not satisfy the schema.\n   */\n  constructor(config: TurnRunnerConfig) {\n    // Validate once, capturing the field-level error so the thrown exception can name the\n    // offending field(s) (e.g. a missing required callback) instead of failing opaquely.\n    const { error } = turnRunnerConfigSchema.validate(config, {\n      abortEarly: false,\n    })\n    if (error) {\n      const detail = error.details.map((d) => d.message).join('; ')\n      throw new E_INVALID_TURN_RUNNER_CONFIG([detail], { cause: error })\n    }\n    // Store the resolved config so optional fields (e.g. tools) are always present.\n    this.#config = validateOrThrow<ResolvedTurnRunnerConfig>(turnRunnerConfigSchema, config, true)\n    const turnInputPipeline = new Middleware<TurnPipelineMiddlewareFn>()\n    const turnOutputPipeline = new Middleware<TurnPipelineMiddlewareFn>()\n    const wrap =\n      (fn: TurnPipelineMiddlewareFn): TurnPipelineMiddlewareFn =>\n      (ctx, next) => {\n        // Skip downstream user middlewares once an abort has been signalled. The\n        // wrapper still calls next() so the pipeline reaches its terminal resolver\n        // (keeping the short-circuit detector quiet); the original middleware body\n        // does not run, so it has nothing to clean up.\n        if (ctx.aborted) return next()\n        return fn(ctx, next)\n      }\n    for (const fn of this.#config.turnInputPipeline) turnInputPipeline.add(wrap(fn))\n    for (const fn of this.#config.turnOutputPipeline) turnOutputPipeline.add(wrap(fn))\n    // Hold the Middleware; derive a fresh Runner per turn (a Runner's internal cursor never\n    // resets across .run() calls, so caching one here would only execute the pipeline once).\n    this.#inputPipeline = turnInputPipeline\n    this.#outputPipeline = turnOutputPipeline\n    this.#functionalEmitter = new TypedEventEmitter<TurnEvents>()\n    this.#observabilityEmitter = new TypedEventEmitter<TurnObservabilityEvents>()\n  }\n\n  // ── Functional bus ───────────────────────────────────────────────────────\n\n  /**\n   * Removes a previously registered functional listener for `event`.\n   *\n   * @param event - The event to stop listening to.\n   * @param listener - The listener function to remove.\n   * @returns `this` for chaining.\n   */\n  off<K>(event: TurnEvent<K>, listener: TurnEventListener<K>): this {\n    this.#functionalEmitter.off(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a persistent functional listener for `event`.\n   *\n   * @param event - The event to listen to.\n   * @param listener - The function to call on each emission.\n   * @returns `this` for chaining.\n   */\n  on<K>(event: TurnEvent<K>, listener: TurnEventListener<K>): this {\n    this.#functionalEmitter.on(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a one-time functional listener for `event` that is automatically removed after the\n   * first emission.\n   *\n   * @param event - The event to listen to.\n   * @param listener - The function to call on the next emission.\n   * @returns `this` for chaining.\n   */\n  once<K>(event: TurnEvent<K>, listener: TurnEventListener<K>): this {\n    this.#functionalEmitter.once(event, listener)\n    return this\n  }\n\n  // ── Observability bus ────────────────────────────────────────────────────\n\n  /**\n   * Removes a previously registered observability listener for `event`.\n   *\n   * @param event - The event to stop observing.\n   * @param listener - The listener function to remove.\n   * @returns `this` for chaining.\n   */\n  unobserve<K>(\n    event: TurnObservabilityEvent<K>,\n    listener: TurnObservabilityEventListener<K>\n  ): this {\n    this.#observabilityEmitter.off(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a persistent observability listener for `event`.\n   *\n   * @remarks\n   * Use the observability bus (`observe` / `unobserve` / `observeOnce`) for instrumentation:\n   * turn lifecycle, gate lifecycle, and non-fatal errors. Use the functional bus (`on` / `off` /\n   * `once`) for pipeline-affecting events: `message`, `thought`, `toolCall`.\n   *\n   * @param event - The event to observe.\n   * @param listener - The function to call on each emission.\n   * @returns `this` for chaining.\n   */\n  observe<K>(event: TurnObservabilityEvent<K>, listener: TurnObservabilityEventListener<K>): this {\n    this.#observabilityEmitter.on(event, listener)\n    return this\n  }\n\n  /**\n   * Registers a one-time observability listener for `event` that is automatically removed after\n   * the first emission.\n   *\n   * @param event - The event to observe once.\n   * @param listener - The function to call on the next emission.\n   * @returns `this` for chaining.\n   */\n  observeOnce<K>(\n    event: TurnObservabilityEvent<K>,\n    listener: TurnObservabilityEventListener<K>\n  ): this {\n    this.#observabilityEmitter.once(event, listener)\n    return this\n  }\n\n  // ── Turn execution ───────────────────────────────────────────────────────\n\n  /**\n   * Executes a single agent turn against the provided raw context.\n   *\n   * @remarks\n   * Returns `Promise<void>` intentionally — all meaningful output surfaces via events, not return\n   * values. Register listeners before calling `run`: observability events (`turnStart`, `turnEnd`)\n   * bracket execution; functional events (`message`, `thought`, `toolCall`) fire throughout;\n   * observability `error` carries non-fatal pipeline failures; `turnGateOpen` and `turnGateClosed`\n   * fire when middleware suspends via `ctx.waitFor()`. Awaiting this method only tells you the\n   * pipeline has finished, not what it produced.\n   *\n   * Constructs a validated {@link @nhtio/adk!TurnContext} from `context` (throwing\n   * {@link @nhtio/adk!E_INVALID_TURN_CONTEXT} on failure), then runs the input middleware pipeline.\n   * Abort signals are silently swallowed.\n   *\n   * @param context - Raw input validated and wrapped into a {@link @nhtio/adk!TurnContext} before execution.\n   * @throws {@link @nhtio/adk!E_INVALID_TURN_CONTEXT} when `context` does not satisfy the schema.\n   */\n  async run(context: RawTurnContext): Promise<void> {\n    const abortController = context.turnAbortController ?? new AbortController()\n\n    // Forward declaration so openGate can reference turnContext.id before it is assigned.\n    let turnContextId: string\n\n    const openGate: OpenGateFn = <T>(raw: Omit<RawTurnGate, 'turnId' | 'abortSignal'>) => {\n      const gate = new TurnGate<T>({\n        ...raw,\n        turnId: turnContextId,\n        abortSignal: abortController.signal,\n      })\n      this.#observabilityEmitter.emit('turnGateOpen', gate)\n      const promise = gate._promise()\n      promise.then(\n        () => {\n          this.#observabilityEmitter.emit('turnGateClosed', {\n            gateId: gate.id,\n            turnId: gate.turnId,\n            result: 'resolved',\n            settledAt: DateTime.now(),\n          })\n        },\n        (err: unknown) => {\n          let result: 'rejected' | 'aborted' | 'timeout' = 'rejected'\n          if (isInstanceOf(err, 'E_TURN_GATE_ABORTED')) result = 'aborted'\n          else if (isInstanceOf(err, 'E_TURN_GATE_TIMEOUT')) result = 'timeout'\n          this.#observabilityEmitter.emit('turnGateClosed', {\n            gateId: gate.id,\n            turnId: gate.turnId,\n            result,\n            settledAt: DateTime.now(),\n          })\n        }\n      )\n      return promise\n    }\n\n    const tools = new ToolRegistry(this.#config.tools)\n\n    const turnContext = new TurnContext(\n      { ...context, turnAbortController: abortController },\n      {\n        fetchMemories: this.#config.fetchMemoriesCallback,\n        fetchMessages: this.#config.fetchMessagesCallback,\n        fetchThoughts: this.#config.fetchThoughtsCallback,\n        fetchToolCalls: this.#config.fetchToolCallsCallback,\n        fetchTools: this.#config.fetchToolsCallback,\n        refreshStandingInstructions: this.#config.refreshStandingInstructionsCallback,\n        storeStandingInstruction: this.#config.storeStandingInstructionCallback,\n        mutateStandingInstruction: this.#config.mutateStandingInstructionCallback,\n        deleteStandingInstruction: this.#config.deleteStandingInstructionCallback,\n        storeMemory: this.#config.storeMemoryCallback,\n        mutateMemory: this.#config.mutateMemoryCallback,\n        deleteMemory: this.#config.deleteMemoryCallback,\n        fetchRetrievables: this.#config.fetchRetrievablesCallback,\n        storeRetrievable: this.#config.storeRetrievableCallback,\n        mutateRetrievable: this.#config.mutateRetrievableCallback,\n        deleteRetrievable: this.#config.deleteRetrievableCallback,\n        storeMessage: this.#config.storeMessageCallback,\n        mutateMessage: this.#config.mutateMessageCallback,\n        deleteMessage: this.#config.deleteMessageCallback,\n        storeThought: this.#config.storeThoughtCallback,\n        mutateThought: this.#config.mutateThoughtCallback,\n        deleteThought: this.#config.deleteThoughtCallback,\n        storeToolCall: this.#config.storeToolCallCallback,\n        mutateToolCall: this.#config.mutateToolCallCallback,\n        deleteToolCall: this.#config.deleteToolCallCallback,\n        replaceToolCallGroup: this.#config.replaceToolCallGroupCallback,\n        storeMediaBytes: this.#config.storeMediaBytesCallback,\n        storeRetrievableBytes: this.#config.storeRetrievableBytesCallback,\n        emitMessage: (content) => this.#functionalEmitter.emit('message', content),\n        emitThought: (content) => this.#functionalEmitter.emit('thought', content),\n        emitToolCall: (content) => this.#functionalEmitter.emit('toolCall', content),\n        emitToolExecutionStart: (event) =>\n          this.#observabilityEmitter.emit('toolExecutionStart', event),\n        emitToolExecutionEnd: (event) => this.#observabilityEmitter.emit('toolExecutionEnd', event),\n        openGate,\n        tools,\n      }\n    )\n\n    turnContextId = turnContext.id\n\n    // Publish a turn-level warn-sink for the duration of the run so a token estimation done directly in a\n    // TURN pipeline (outside any dispatch) can degrade-and-warn instead of throwing. A nested\n    // DispatchRunner.dispatch() pushes its own sink on top (see estimation_context), so estimations inside\n    // a dispatch route to the richer dispatch-scoped sink and this turn-level one is the fallback. No\n    // dispatchId/iteration here — those belong to a dispatch scope, not the turn.\n    const emitEstimationWarning = (w: EstimationWarning): void => {\n      const event: WarningEvent = {\n        emittedAt: DateTime.now(),\n        source: 'turn-runner',\n        kind: 'token-estimation-degraded',\n        message: `token estimation for encoding \"${String(w.encoding)}\" failed; fell back to a char-based estimate`,\n        error: w.error,\n        payload: { encoding: w.encoding, textPreview: w.textPreview },\n      }\n      this.#observabilityEmitter.emit('warning', event)\n    }\n\n    await runWithEstimationWarnings(emitEstimationWarning, async () => {\n      const startedAt = DateTime.now()\n      this.#observabilityEmitter.emit('turnStart', {\n        turnId: turnContext.id,\n        startedAt,\n      })\n\n      const emitTurnEnd = () => {\n        const endedAt = DateTime.now()\n        this.#observabilityEmitter.emit('turnEnd', {\n          turnId: turnContext.id,\n          startedAt,\n          endedAt,\n          durationMs: endedAt.diff(startedAt).milliseconds,\n        })\n      }\n\n      // 1. Input pipeline\n      let inputFailed = false\n      let inputReached = false\n      await this.#inputPipeline\n        .runner()\n        .errorHandler(async (error) => {\n          if (!isError(error) || !isInstanceOf(error, 'AbortError')) {\n            inputFailed = true\n            const err = new E_INPUT_PIPELINE_ERROR({\n              cause: isError(error) ? error : undefined,\n            })\n            this.#observabilityEmitter.emit('error', err)\n          }\n        })\n        .finalHandler(async () => {\n          inputReached = true\n        })\n        .run((fn, next) => Promise.resolve(fn(turnContext, next)))\n\n      if (!inputReached && !inputFailed && !turnContext.aborted) {\n        inputFailed = true\n        const err = new E_PIPELINE_SHORT_CIRCUITED(['turn-input'])\n        this.#observabilityEmitter.emit('error', err)\n      }\n\n      if (inputFailed || turnContext.aborted) {\n        emitTurnEnd()\n        return\n      }\n\n      // 2. LLM execution dispatch\n      let dispatchFailed = false\n      try {\n        await DispatchRunner.dispatch({\n          source: turnContext,\n          executor: this.#config.executorCallback,\n          turnInputPipeline: this.#config.dispatchInputPipeline,\n          turnOutputPipeline: this.#config.dispatchOutputPipeline,\n          observers: {\n            dispatchStart: [\n              (e) => {\n                this.#observabilityEmitter.emit('dispatchStart', e)\n              },\n            ],\n            dispatchEnd: [\n              (e) => {\n                this.#observabilityEmitter.emit('dispatchEnd', e)\n              },\n            ],\n            iterationStart: [\n              (e) => {\n                this.#observabilityEmitter.emit('iterationStart', e)\n              },\n            ],\n            iterationEnd: [\n              (e) => {\n                this.#observabilityEmitter.emit('iterationEnd', e)\n              },\n            ],\n            log: [\n              (e) => {\n                this.#observabilityEmitter.emit('log', e)\n              },\n            ],\n            // Re-forward a DispatchRunner-emitted `warning` (e.g. token-estimation degraded) up to the turn\n            // bus, so a consumer subscribed only to the TurnRunner still sees it — mirrors the log/dispatch*\n            // bridges above. Non-fatal; the dispatch continues.\n            warning: [\n              (e) => {\n                this.#observabilityEmitter.emit('warning', e)\n              },\n            ],\n          },\n        })\n      } catch (err) {\n        dispatchFailed = true\n        const wrapped = isInstanceOf(err, 'BaseException')\n          ? (err as InstanceType<typeof Error>)\n          : err\n        this.#observabilityEmitter.emit('error', wrapped as any)\n      }\n\n      if (dispatchFailed || turnContext.aborted) {\n        emitTurnEnd()\n        return\n      }\n\n      // 3. Output pipeline\n      let outputFailed = false\n      let outputReached = false\n      await this.#outputPipeline\n        .runner()\n        .errorHandler(async (error) => {\n          if (!isError(error) || !isInstanceOf(error, 'AbortError')) {\n            outputFailed = true\n            const err = new E_OUTPUT_PIPELINE_ERROR({\n              cause: isError(error) ? error : undefined,\n            })\n            this.#observabilityEmitter.emit('error', err)\n          }\n        })\n        .finalHandler(async () => {\n          outputReached = true\n        })\n        .run((fn, next) => Promise.resolve(fn(turnContext, next)))\n\n      if (!outputReached && !outputFailed && !turnContext.aborted) {\n        const err = new E_PIPELINE_SHORT_CIRCUITED(['turn-output'])\n        this.#observabilityEmitter.emit('error', err)\n      }\n\n      emitTurnEnd()\n    })\n  }\n}\n"],"mappings":"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"}

package/{turn_runner-DX-3s3ih.cjs → turn_runner-Dj7JsUTQ.cjs}

@@ -1,10 +1,10 @@
 const require_exceptions = require("./exceptions-DrHnAGQz.cjs");
 const require_guards = require("./guards-5-XmJgD2.cjs");
-const require_tokenizable = require("./tokenizable-DDIdXbJN.cjs");
-const require_spooled_artifact = require("./spooled_artifact-BLgbGT8b.cjs");
-const require_dispatch_runner = require("./dispatch_runner-FlriTyoq.cjs");
-let luxon = require("luxon");
+const require_tokenizable = require("./tokenizable-BcodRtoW.cjs");
+const require_spooled_artifact = require("./spooled_artifact---DmicFW.cjs");
+const require_dispatch_runner = require("./dispatch_runner-DDUxXJC3.cjs");
 let _nhtio_validation = require("@nhtio/validation");
+let luxon = require("luxon");
 let _nhtio_middleware = require("@nhtio/middleware");
 let _nhtio_tiny_typed_emitter = require("@nhtio/tiny-typed-emitter");
 //#region src/lib/classes/turn_gate.ts
@@ -637,4 +637,4 @@ Object.defineProperty(exports, "TurnRunner", {
 	}
 });
 
-//# sourceMappingURL=turn_runner-DX-3s3ih.cjs.map
+//# sourceMappingURL=turn_runner-Dj7JsUTQ.cjs.map