@nhtio/adk 1.20260607.2 → 1.20260609.0

package/{runtime-j92CNi5z.mjs → runtime-Bz5zA8wc.mjs}

@@ -1,4 +1,4 @@
-import { t as createException } from "./exceptions-BeWH2FwP.mjs";
+import { t as createException } from "./exceptions-BDhN0Xzr.mjs";
 //#region src/lib/exceptions/runtime.ts
 /**
 * Thrown by {@link @nhtio/adk!TurnRunner} when the supplied config object fails schema validation at
@@ -347,4 +347,4 @@ var E_LLM_EXECUTION_EXECUTOR_ERROR = createException("E_LLM_EXECUTION_EXECUTOR_E
 //#endregion
 export { E_NOT_A_SPOOL_READER as C, E_TOOL_DOWNSTREAM_ERROR as D, E_TOOL_ALREADY_REGISTERED as E, E_TURN_GATE_ABORTED as O, E_NOT_A_MEDIA_READER as S, E_PIPELINE_SHORT_CIRCUITED as T, E_INVALID_TURN_GATE_RESOLUTION as _, E_INVALID_INITIAL_MEMORY_VALUE as a, E_LLM_EXECUTION_EXECUTOR_ERROR as b, E_INVALID_INITIAL_RETRIEVABLE_VALUE as c, E_INVALID_INITIAL_TOOL_VALUE as d, E_INVALID_INITIAL_TURN_GATE_VALUE as f, E_INVALID_TURN_CONTEXT as g, E_INVALID_TOOL_ARGS as h, E_INVALID_INITIAL_MEDIA_VALUE as i, E_TURN_GATE_TIMEOUT as k, E_INVALID_INITIAL_THOUGHT_VALUE as l, E_INVALID_LLM_EXECUTION_CONTEXT as m, E_INPUT_PIPELINE_ERROR as n, E_INVALID_INITIAL_MESSAGE_VALUE as o, E_INVALID_LLM_DISPATCH_INPUT as p, E_INVALID_INITIAL_IDENTITY_VALUE as r, E_INVALID_INITIAL_REGISTRY_VALUE as s, E_DISPATCH_PIPELINE_ERROR as t, E_INVALID_INITIAL_TOOL_CALL_VALUE as u, E_INVALID_TURN_RUNNER_CONFIG as v, E_OUTPUT_PIPELINE_ERROR as w, E_LLM_EXECUTION_GATE_NOT_SUPPORTED as x, E_LLM_EXECUTION_ALREADY_SIGNALLED as y };
 
-//# sourceMappingURL=runtime-j92CNi5z.mjs.map
+//# sourceMappingURL=runtime-Bz5zA8wc.mjs.map

package/{runtime-j92CNi5z.mjs.map → runtime-Bz5zA8wc.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"runtime-j92CNi5z.mjs","names":[],"sources":["../src/lib/exceptions/runtime.ts"],"sourcesContent":["import { createException } from '../utils/exceptions'\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the supplied config object fails schema validation at\n * construction time.\n *\n * @remarks\n * Marked fatal — a misconfigured runner must not be allowed to execute turns.\n *\n * The single printf argument carries the validator's field-level detail (e.g.\n * `\"storeMediaBytesCallback is required\"`) so a misconfiguration names the offending field\n * instead of failing opaquely. The underlying `ValidationError` is also attached on `cause`.\n *\n * @group Turn Runner Construction\n */\nexport const E_INVALID_TURN_RUNNER_CONFIG = createException<[string]>(\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  'The turn runner cannot be instantiated with the provided configuration: %s',\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  529,\n  true\n)\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the {@link @nhtio/adk!TurnContext} supplied to `run` fails schema\n * validation.\n *\n * @remarks\n * Marked fatal — an invalid context indicates a programming error in the caller, not a\n * recoverable runtime condition. Thrown synchronously out of `run()` before `turnStart` is\n * emitted.\n *\n * @group Turn Input Validation\n */\nexport const E_INVALID_TURN_CONTEXT = createException(\n  'E_INVALID_TURN_CONTEXT',\n  'The turn runner received an invalid context object.',\n  'E_INVALID_TURN_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the input\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. Dispatch\n * and output middleware are skipped; `turnEnd` still fires.\n *\n * @group Pipelines\n */\nexport const E_INPUT_PIPELINE_ERROR = createException(\n  'E_INPUT_PIPELINE_ERROR',\n  'An error occurred in the input pipeline.',\n  'E_INPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the output\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. `turnEnd`\n * still fires.\n *\n * @group Pipelines\n */\nexport const E_OUTPUT_PIPELINE_ERROR = createException(\n  'E_OUTPUT_PIPELINE_ERROR',\n  'An error occurred in the output pipeline.',\n  'E_OUTPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a middleware pipeline resolves without reaching its\n * terminal handler and without the turn being aborted. Indicates that some middleware\n * returned without calling `next` and without signalling a deliberate refusal via the turn's\n * abort controller.\n *\n * @remarks\n * Not fatal — the runner emits this on the `error` event so the failure is observable, then\n * proceeds to short-circuit the remainder of the turn the same way any other pipeline error\n * would. The constructor takes a single positional argument identifying the pipeline that\n * short-circuited: one of `'turn-input'`, `'turn-output'`, `'dispatch-input'`, or `'dispatch-output'`.\n *\n * Deliberate refusals should call `ctx.abort(reason)`, which sets the `'aborted'` outcome\n * instead of emitting this error.\n *\n * @warning\n * This is a **detection condition**, not a thrown exception. The runner constructs and emits\n * the code itself when it detects a missing `next()` on the unwind — nothing in user code\n * throws it. Upstream post-steps still run normally.\n *\n * @example\n * ```ts\n * throw new E_PIPELINE_SHORT_CIRCUITED(['turn-input'])\n * ```\n *\n * @group Pipelines\n */\nexport const E_PIPELINE_SHORT_CIRCUITED = createException<[string]>(\n  'E_PIPELINE_SHORT_CIRCUITED',\n  \"The '%s' middleware pipeline short-circuited without calling next or aborting the turn.\",\n  'E_PIPELINE_SHORT_CIRCUITED',\n  500,\n  false\n)\n\n/**\n * Thrown when a registry is initialised with a value that is defined but not a plain object.\n *\n * @remarks\n * Registries expect either `undefined` (empty start) or a plain object as their initial value.\n * Passing a primitive, array, class instance, or other non-object signals a programming error\n * in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_REGISTRY_VALUE = createException(\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  'Attempted to initialize a registry with a defined non-object value.',\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Memory} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Memory` requires all fields — `id`, `content`, `confidence`, `importance`, `createdAt`,\n * `updatedAt` — to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MEMORY_VALUE = createException(\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  'Attempted to initialize a memory with an invalid value.',\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Retrievable} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Retrievable` requires `id`, `content`, `trustTier`, `createdAt`, and `updatedAt` to be present\n * and of the correct type, and `trustTier` must be one of `'first-party'`, `'third-party-public'`,\n * or `'third-party-private'`. The `trustTier` decision must be made consciously by the retrieval\n * middleware at construction time — there is no default. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_RETRIEVABLE_VALUE = createException(\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  'Invalid initial value supplied to Retrievable constructor.',\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Message} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Message` requires `id`, `role` (`user` or `assistant`), `content`, `createdAt`, and\n * `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MESSAGE_VALUE = createException(\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  'Attempted to initialize a message with an invalid value.',\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when an {@link @nhtio/adk!Identity} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Identity` requires both `identifier` (string or number) and `representation` (string or\n * {@link @nhtio/adk!Tokenizable}) to be present and of the correct type. Passing an incomplete or\n * incorrectly typed object signals a programming error in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_IDENTITY_VALUE = createException(\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  'Attempted to initialize an identity with an invalid value.',\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Thought} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Thought` requires `id`, `content`, `createdAt`, and `updatedAt` to be present and of the\n * correct type. Passing an incomplete or incorrectly typed object signals a programming error\n * in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_THOUGHT_VALUE = createException(\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  'Attempted to initialize a thought with an invalid value.',\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!TurnGate} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Gates\n */\nexport const E_INVALID_INITIAL_TURN_GATE_VALUE = createException(\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  'Attempted to initialize a turn gate with an invalid value.',\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously in the caller's context when {@link @nhtio/adk!TurnGate.resolve} is called with a\n * value that fails the gate's schema.\n *\n * @remarks\n * Fatal — passing the wrong type to `resolve()` is a programming error. The internal promise is\n * NOT settled when this is thrown; the gate remains open.\n *\n * @group Gates\n */\nexport const E_INVALID_TURN_GATE_RESOLUTION = createException(\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  'The value supplied to TurnGate.resolve() failed schema validation.',\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  500,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} times out before being resolved.\n *\n * @remarks\n * Not fatal — a timeout is a recoverable runtime condition; the caller may retry or surface it\n * to the user.\n *\n * @warning\n * A timeout does **not** cancel the external event or clear any remote queue. The gate closes\n * locally, but whatever external system was expected to call `gate.resolve()` may still fire\n * later. Orphaned external state must be handled by the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_TIMEOUT = createException(\n  'E_TURN_GATE_TIMEOUT',\n  'The turn gate timed out before being resolved.',\n  'E_TURN_GATE_TIMEOUT',\n  408,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} is aborted — either because the turn's\n * `AbortSignal` fired or because {@link @nhtio/adk!TurnGate.abort} was called directly.\n *\n * @remarks\n * Not fatal — abort is an intentional cancellation, not an error in the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_ABORTED = createException(\n  'E_TURN_GATE_ABORTED',\n  'The turn gate was aborted before being resolved.',\n  'E_TURN_GATE_ABORTED',\n  499,\n  false\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!SpooledArtifact} is constructed with a value that does not implement the\n * {@link @nhtio/adk!SpoolReader} interface.\n *\n * @remarks\n * Validated at construction time via {@link @nhtio/adk!implementsSpoolReader}. Passing anything that lacks\n * `line`, `byteLength`, or `lineCount` as callable functions signals a programming error in the\n * caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_SPOOL_READER = createException(\n  'E_NOT_A_SPOOL_READER',\n  'The provided value does not implement the SpoolReader interface.',\n  'E_NOT_A_SPOOL_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is constructed with a value that does not implement the MediaReader\n * interface.\n *\n * @remarks\n * Validated at construction time. Passing anything that lacks `stream` or `byteLength` as\n * callable functions signals a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_MEDIA_READER = createException(\n  'E_NOT_A_MEDIA_READER',\n  'The provided value does not implement the MediaReader interface.',\n  'E_NOT_A_MEDIA_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is initialised with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_INVALID_INITIAL_MEDIA_VALUE = createException(\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  'Attempted to initialize a media with an invalid value.',\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!ToolCall} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `ToolCall` requires `id`, `tool`, `args`, `checksum`, `isComplete`, `isError`, `createdAt`,\n * and `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_TOOL_CALL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  'Attempted to initialize a tool call with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Tool} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Tools\n */\nexport const E_INVALID_INITIAL_TOOL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  'Attempted to initialize a tool with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously when {@link @nhtio/adk!Tool.validate} is called with arguments that fail the tool's\n * input schema.\n *\n * @remarks\n * Not fatal — an arg validation failure in the tool call loop is a caller mistake that can be\n * surfaced as an error response. The tool handler is NOT called when this is thrown.\n *\n * @group Tools\n */\nexport const E_INVALID_TOOL_ARGS = createException(\n  'E_INVALID_TOOL_ARGS',\n  'The arguments supplied to the tool failed input schema validation.',\n  'E_INVALID_TOOL_ARGS',\n  422,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!Tool}'s handler throws during execution.\n *\n * @remarks\n * Not fatal — a downstream tool failure is a recoverable runtime condition. The tool call loop\n * catches this error specifically to report the failure back to the model rather than crashing\n * the pipeline.\n *\n * @group Tools\n */\nexport const E_TOOL_DOWNSTREAM_ERROR = createException(\n  'E_TOOL_DOWNSTREAM_ERROR',\n  'The tool handler threw an error during execution.',\n  'E_TOOL_DOWNSTREAM_ERROR',\n  500,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!ToolRegistry.register} is called for a tool name that is already registered\n * and `overwrite` is not `true`.\n *\n * @remarks\n * Fatal — accidentally overwriting a registered tool indicates a programming error. Pass\n * `overwrite: true` to replace an existing tool intentionally.\n *\n * @group Tools\n */\nexport const E_TOOL_ALREADY_REGISTERED = createException(\n  'E_TOOL_ALREADY_REGISTERED',\n  'A tool with this name is already registered. Pass overwrite: true to replace it.',\n  'E_TOOL_ALREADY_REGISTERED',\n  409,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_EXECUTION_CONTEXT = createException(\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  'The LLM execution context cannot be instantiated with the provided value.',\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when {@link @nhtio/adk!DispatchContext.waitFor} is called on a\n * standalone context that was constructed without a `waitFor` function.\n *\n * @remarks\n * Not fatal — the caller can catch this and handle the case where gate suspension is not\n * supported for this execution context.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_GATE_NOT_SUPPORTED = createException(\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  'waitFor was called on a standalone DispatchContext with no gate function provided.',\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  501,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext.ack} or {@link @nhtio/adk!DispatchContext.nack} is called on a\n * context that has already been signalled.\n *\n * @remarks\n * Fatal — signalling twice is a programming error in the caller. The first signal wins; the\n * second call is rejected loudly so callers cannot accidentally race between ack and nack.\n *\n * @danger\n * Signalling is **not** silently idempotent. The first `ack()` or `nack()` wins; the second\n * throws immediately. Guard with `if (!ctx.isSignalled)` when more than one seam may signal.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_ALREADY_SIGNALLED = createException(\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  'ack() or nack() was called on an DispatchContext that has already been signalled.',\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  500,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchRunner.dispatch} receives an input that fails schema validation.\n *\n * @remarks\n * Fatal — invalid dispatch input indicates a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_DISPATCH_INPUT = createException(\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  'The LLM execution runner received an invalid dispatch input.',\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when a non-abort error propagates\n * out of the input or output middleware pipeline during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — pipeline errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch. Both `dispatchInputPipeline` and\n * `dispatchOutputPipeline` share this one code — the runner does not split input vs. output at\n * this layer.\n *\n * @group Pipelines\n */\nexport const E_DISPATCH_PIPELINE_ERROR = createException(\n  'E_DISPATCH_PIPELINE_ERROR',\n  'An error occurred in an LLM execution pipeline.',\n  'E_DISPATCH_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when the user-supplied executor\n * callback throws during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — executor errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_EXECUTOR_ERROR = createException(\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  'The LLM execution executor callback threw an error.',\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  500,\n  false\n)\n"],"mappings":";;;;;;;;;;;;;;;AAeA,IAAa,+BAA+B,gBAC1C,gCACA,8EACA,gCACA,KACA,IACF;;;;;;;;;;;;AAaA,IAAa,yBAAyB,gBACpC,0BACA,uDACA,0BACA,KACA,IACF;;;;;;;;;;;;AAaA,IAAa,yBAAyB,gBACpC,0BACA,4CACA,0BACA,KACA,KACF;;;;;;;;;;;;AAaA,IAAa,0BAA0B,gBACrC,2BACA,6CACA,2BACA,KACA,KACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,6BAA6B,gBACxC,8BACA,2FACA,8BACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,mCAAmC,gBAC9C,oCACA,uEACA,oCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,iCAAiC,gBAC5C,kCACA,2DACA,kCACA,KACA,IACF;;;;;;;;;;;;;AAcA,IAAa,sCAAsC,gBACjD,uCACA,8DACA,uCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,kCAAkC,gBAC7C,mCACA,4DACA,mCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,mCAAmC,gBAC9C,oCACA,8DACA,oCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,kCAAkC,gBAC7C,mCACA,4DACA,mCACA,KACA,IACF;;;;;;;;;AAUA,IAAa,oCAAoC,gBAC/C,qCACA,8DACA,qCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,iCAAiC,gBAC5C,kCACA,sEACA,kCACA,KACA,IACF;;;;;;;;;;;;;;;AAgBA,IAAa,sBAAsB,gBACjC,uBACA,kDACA,uBACA,KACA,KACF;;;;;;;;;;AAWA,IAAa,sBAAsB,gBACjC,uBACA,oDACA,uBACA,KACA,KACF;;;;;;;;;;;;AAaA,IAAa,uBAAuB,gBAClC,wBACA,oEACA,wBACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,uBAAuB,gBAClC,wBACA,oEACA,wBACA,KACA,IACF;;;;;;;;;AAUA,IAAa,gCAAgC,gBAC3C,iCACA,0DACA,iCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,oCAAoC,gBAC/C,qCACA,8DACA,qCACA,KACA,IACF;;;;;;;;;AAUA,IAAa,+BAA+B,gBAC1C,gCACA,yDACA,gCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,sBAAsB,gBACjC,uBACA,sEACA,uBACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,0BAA0B,gBACrC,2BACA,qDACA,2BACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,4BAA4B,gBACvC,6BACA,oFACA,6BACA,KACA,IACF;;;;;;;;;AAUA,IAAa,kCAAkC,gBAC7C,mCACA,6EACA,mCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,qCAAqC,gBAChD,sCACA,sFACA,sCACA,KACA,KACF;;;;;;;;;;;;;;;AAgBA,IAAa,oCAAoC,gBAC/C,qCACA,qFACA,qCACA,KACA,IACF;;;;;;;;;AAUA,IAAa,+BAA+B,gBAC1C,gCACA,gEACA,gCACA,KACA,IACF;;;;;;;;;;;;;AAcA,IAAa,4BAA4B,gBACvC,6BACA,mDACA,6BACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,iCAAiC,gBAC5C,kCACA,uDACA,kCACA,KACA,KACF"}
+{"version":3,"file":"runtime-Bz5zA8wc.mjs","names":[],"sources":["../src/lib/exceptions/runtime.ts"],"sourcesContent":["import { createException } from '../utils/exceptions'\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the supplied config object fails schema validation at\n * construction time.\n *\n * @remarks\n * Marked fatal — a misconfigured runner must not be allowed to execute turns.\n *\n * The single printf argument carries the validator's field-level detail (e.g.\n * `\"storeMediaBytesCallback is required\"`) so a misconfiguration names the offending field\n * instead of failing opaquely. The underlying `ValidationError` is also attached on `cause`.\n *\n * @group Turn Runner Construction\n */\nexport const E_INVALID_TURN_RUNNER_CONFIG = createException<[string]>(\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  'The turn runner cannot be instantiated with the provided configuration: %s',\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  529,\n  true\n)\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the {@link @nhtio/adk!TurnContext} supplied to `run` fails schema\n * validation.\n *\n * @remarks\n * Marked fatal — an invalid context indicates a programming error in the caller, not a\n * recoverable runtime condition. Thrown synchronously out of `run()` before `turnStart` is\n * emitted.\n *\n * @group Turn Input Validation\n */\nexport const E_INVALID_TURN_CONTEXT = createException(\n  'E_INVALID_TURN_CONTEXT',\n  'The turn runner received an invalid context object.',\n  'E_INVALID_TURN_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the input\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. Dispatch\n * and output middleware are skipped; `turnEnd` still fires.\n *\n * @group Pipelines\n */\nexport const E_INPUT_PIPELINE_ERROR = createException(\n  'E_INPUT_PIPELINE_ERROR',\n  'An error occurred in the input pipeline.',\n  'E_INPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the output\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. `turnEnd`\n * still fires.\n *\n * @group Pipelines\n */\nexport const E_OUTPUT_PIPELINE_ERROR = createException(\n  'E_OUTPUT_PIPELINE_ERROR',\n  'An error occurred in the output pipeline.',\n  'E_OUTPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a middleware pipeline resolves without reaching its\n * terminal handler and without the turn being aborted. Indicates that some middleware\n * returned without calling `next` and without signalling a deliberate refusal via the turn's\n * abort controller.\n *\n * @remarks\n * Not fatal — the runner emits this on the `error` event so the failure is observable, then\n * proceeds to short-circuit the remainder of the turn the same way any other pipeline error\n * would. The constructor takes a single positional argument identifying the pipeline that\n * short-circuited: one of `'turn-input'`, `'turn-output'`, `'dispatch-input'`, or `'dispatch-output'`.\n *\n * Deliberate refusals should call `ctx.abort(reason)`, which sets the `'aborted'` outcome\n * instead of emitting this error.\n *\n * @warning\n * This is a **detection condition**, not a thrown exception. The runner constructs and emits\n * the code itself when it detects a missing `next()` on the unwind — nothing in user code\n * throws it. Upstream post-steps still run normally.\n *\n * @example\n * ```ts\n * throw new E_PIPELINE_SHORT_CIRCUITED(['turn-input'])\n * ```\n *\n * @group Pipelines\n */\nexport const E_PIPELINE_SHORT_CIRCUITED = createException<[string]>(\n  'E_PIPELINE_SHORT_CIRCUITED',\n  \"The '%s' middleware pipeline short-circuited without calling next or aborting the turn.\",\n  'E_PIPELINE_SHORT_CIRCUITED',\n  500,\n  false\n)\n\n/**\n * Thrown when a registry is initialised with a value that is defined but not a plain object.\n *\n * @remarks\n * Registries expect either `undefined` (empty start) or a plain object as their initial value.\n * Passing a primitive, array, class instance, or other non-object signals a programming error\n * in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_REGISTRY_VALUE = createException(\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  'Attempted to initialize a registry with a defined non-object value.',\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Memory} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Memory` requires all fields — `id`, `content`, `confidence`, `importance`, `createdAt`,\n * `updatedAt` — to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MEMORY_VALUE = createException(\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  'Attempted to initialize a memory with an invalid value.',\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Retrievable} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Retrievable` requires `id`, `content`, `trustTier`, `createdAt`, and `updatedAt` to be present\n * and of the correct type, and `trustTier` must be one of `'first-party'`, `'third-party-public'`,\n * or `'third-party-private'`. The `trustTier` decision must be made consciously by the retrieval\n * middleware at construction time — there is no default. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_RETRIEVABLE_VALUE = createException(\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  'Invalid initial value supplied to Retrievable constructor.',\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Message} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Message` requires `id`, `role` (`user` or `assistant`), `content`, `createdAt`, and\n * `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MESSAGE_VALUE = createException(\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  'Attempted to initialize a message with an invalid value.',\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when an {@link @nhtio/adk!Identity} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Identity` requires both `identifier` (string or number) and `representation` (string or\n * {@link @nhtio/adk!Tokenizable}) to be present and of the correct type. Passing an incomplete or\n * incorrectly typed object signals a programming error in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_IDENTITY_VALUE = createException(\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  'Attempted to initialize an identity with an invalid value.',\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Thought} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Thought` requires `id`, `content`, `createdAt`, and `updatedAt` to be present and of the\n * correct type. Passing an incomplete or incorrectly typed object signals a programming error\n * in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_THOUGHT_VALUE = createException(\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  'Attempted to initialize a thought with an invalid value.',\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!TurnGate} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Gates\n */\nexport const E_INVALID_INITIAL_TURN_GATE_VALUE = createException(\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  'Attempted to initialize a turn gate with an invalid value.',\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously in the caller's context when {@link @nhtio/adk!TurnGate.resolve} is called with a\n * value that fails the gate's schema.\n *\n * @remarks\n * Fatal — passing the wrong type to `resolve()` is a programming error. The internal promise is\n * NOT settled when this is thrown; the gate remains open.\n *\n * @group Gates\n */\nexport const E_INVALID_TURN_GATE_RESOLUTION = createException(\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  'The value supplied to TurnGate.resolve() failed schema validation.',\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  500,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} times out before being resolved.\n *\n * @remarks\n * Not fatal — a timeout is a recoverable runtime condition; the caller may retry or surface it\n * to the user.\n *\n * @warning\n * A timeout does **not** cancel the external event or clear any remote queue. The gate closes\n * locally, but whatever external system was expected to call `gate.resolve()` may still fire\n * later. Orphaned external state must be handled by the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_TIMEOUT = createException(\n  'E_TURN_GATE_TIMEOUT',\n  'The turn gate timed out before being resolved.',\n  'E_TURN_GATE_TIMEOUT',\n  408,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} is aborted — either because the turn's\n * `AbortSignal` fired or because {@link @nhtio/adk!TurnGate.abort} was called directly.\n *\n * @remarks\n * Not fatal — abort is an intentional cancellation, not an error in the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_ABORTED = createException(\n  'E_TURN_GATE_ABORTED',\n  'The turn gate was aborted before being resolved.',\n  'E_TURN_GATE_ABORTED',\n  499,\n  false\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!SpooledArtifact} is constructed with a value that does not implement the\n * {@link @nhtio/adk!SpoolReader} interface.\n *\n * @remarks\n * Validated at construction time via {@link @nhtio/adk!implementsSpoolReader}. Passing anything that lacks\n * `line`, `byteLength`, or `lineCount` as callable functions signals a programming error in the\n * caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_SPOOL_READER = createException(\n  'E_NOT_A_SPOOL_READER',\n  'The provided value does not implement the SpoolReader interface.',\n  'E_NOT_A_SPOOL_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is constructed with a value that does not implement the MediaReader\n * interface.\n *\n * @remarks\n * Validated at construction time. Passing anything that lacks `stream` or `byteLength` as\n * callable functions signals a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_MEDIA_READER = createException(\n  'E_NOT_A_MEDIA_READER',\n  'The provided value does not implement the MediaReader interface.',\n  'E_NOT_A_MEDIA_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is initialised with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_INVALID_INITIAL_MEDIA_VALUE = createException(\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  'Attempted to initialize a media with an invalid value.',\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!ToolCall} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `ToolCall` requires `id`, `tool`, `args`, `checksum`, `isComplete`, `isError`, `createdAt`,\n * and `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_TOOL_CALL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  'Attempted to initialize a tool call with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Tool} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Tools\n */\nexport const E_INVALID_INITIAL_TOOL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  'Attempted to initialize a tool with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously when {@link @nhtio/adk!Tool.validate} is called with arguments that fail the tool's\n * input schema.\n *\n * @remarks\n * Not fatal — an arg validation failure in the tool call loop is a caller mistake that can be\n * surfaced as an error response. The tool handler is NOT called when this is thrown.\n *\n * @group Tools\n */\nexport const E_INVALID_TOOL_ARGS = createException(\n  'E_INVALID_TOOL_ARGS',\n  'The arguments supplied to the tool failed input schema validation.',\n  'E_INVALID_TOOL_ARGS',\n  422,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!Tool}'s handler throws during execution.\n *\n * @remarks\n * Not fatal — a downstream tool failure is a recoverable runtime condition. The tool call loop\n * catches this error specifically to report the failure back to the model rather than crashing\n * the pipeline.\n *\n * @group Tools\n */\nexport const E_TOOL_DOWNSTREAM_ERROR = createException(\n  'E_TOOL_DOWNSTREAM_ERROR',\n  'The tool handler threw an error during execution.',\n  'E_TOOL_DOWNSTREAM_ERROR',\n  500,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!ToolRegistry.register} is called for a tool name that is already registered\n * and `overwrite` is not `true`.\n *\n * @remarks\n * Fatal — accidentally overwriting a registered tool indicates a programming error. Pass\n * `overwrite: true` to replace an existing tool intentionally.\n *\n * @group Tools\n */\nexport const E_TOOL_ALREADY_REGISTERED = createException(\n  'E_TOOL_ALREADY_REGISTERED',\n  'A tool with this name is already registered. Pass overwrite: true to replace it.',\n  'E_TOOL_ALREADY_REGISTERED',\n  409,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_EXECUTION_CONTEXT = createException(\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  'The LLM execution context cannot be instantiated with the provided value.',\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when {@link @nhtio/adk!DispatchContext.waitFor} is called on a\n * standalone context that was constructed without a `waitFor` function.\n *\n * @remarks\n * Not fatal — the caller can catch this and handle the case where gate suspension is not\n * supported for this execution context.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_GATE_NOT_SUPPORTED = createException(\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  'waitFor was called on a standalone DispatchContext with no gate function provided.',\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  501,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext.ack} or {@link @nhtio/adk!DispatchContext.nack} is called on a\n * context that has already been signalled.\n *\n * @remarks\n * Fatal — signalling twice is a programming error in the caller. The first signal wins; the\n * second call is rejected loudly so callers cannot accidentally race between ack and nack.\n *\n * @danger\n * Signalling is **not** silently idempotent. The first `ack()` or `nack()` wins; the second\n * throws immediately. Guard with `if (!ctx.isSignalled)` when more than one seam may signal.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_ALREADY_SIGNALLED = createException(\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  'ack() or nack() was called on an DispatchContext that has already been signalled.',\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  500,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchRunner.dispatch} receives an input that fails schema validation.\n *\n * @remarks\n * Fatal — invalid dispatch input indicates a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_DISPATCH_INPUT = createException(\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  'The LLM execution runner received an invalid dispatch input.',\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when a non-abort error propagates\n * out of the input or output middleware pipeline during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — pipeline errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch. Both `dispatchInputPipeline` and\n * `dispatchOutputPipeline` share this one code — the runner does not split input vs. output at\n * this layer.\n *\n * @group Pipelines\n */\nexport const E_DISPATCH_PIPELINE_ERROR = createException(\n  'E_DISPATCH_PIPELINE_ERROR',\n  'An error occurred in an LLM execution pipeline.',\n  'E_DISPATCH_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when the user-supplied executor\n * callback throws during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — executor errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_EXECUTOR_ERROR = createException(\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  'The LLM execution executor callback threw an error.',\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  500,\n  false\n)\n"],"mappings":";;;;;;;;;;;;;;;AAeA,IAAa,+BAA+B,gBAC1C,gCACA,8EACA,gCACA,KACA,IACF;;;;;;;;;;;;AAaA,IAAa,yBAAyB,gBACpC,0BACA,uDACA,0BACA,KACA,IACF;;;;;;;;;;;;AAaA,IAAa,yBAAyB,gBACpC,0BACA,4CACA,0BACA,KACA,KACF;;;;;;;;;;;;AAaA,IAAa,0BAA0B,gBACrC,2BACA,6CACA,2BACA,KACA,KACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,6BAA6B,gBACxC,8BACA,2FACA,8BACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,mCAAmC,gBAC9C,oCACA,uEACA,oCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,iCAAiC,gBAC5C,kCACA,2DACA,kCACA,KACA,IACF;;;;;;;;;;;;;AAcA,IAAa,sCAAsC,gBACjD,uCACA,8DACA,uCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,kCAAkC,gBAC7C,mCACA,4DACA,mCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,mCAAmC,gBAC9C,oCACA,8DACA,oCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,kCAAkC,gBAC7C,mCACA,4DACA,mCACA,KACA,IACF;;;;;;;;;AAUA,IAAa,oCAAoC,gBAC/C,qCACA,8DACA,qCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,iCAAiC,gBAC5C,kCACA,sEACA,kCACA,KACA,IACF;;;;;;;;;;;;;;;AAgBA,IAAa,sBAAsB,gBACjC,uBACA,kDACA,uBACA,KACA,KACF;;;;;;;;;;AAWA,IAAa,sBAAsB,gBACjC,uBACA,oDACA,uBACA,KACA,KACF;;;;;;;;;;;;AAaA,IAAa,uBAAuB,gBAClC,wBACA,oEACA,wBACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,uBAAuB,gBAClC,wBACA,oEACA,wBACA,KACA,IACF;;;;;;;;;AAUA,IAAa,gCAAgC,gBAC3C,iCACA,0DACA,iCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,oCAAoC,gBAC/C,qCACA,8DACA,qCACA,KACA,IACF;;;;;;;;;AAUA,IAAa,+BAA+B,gBAC1C,gCACA,yDACA,gCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,sBAAsB,gBACjC,uBACA,sEACA,uBACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,0BAA0B,gBACrC,2BACA,qDACA,2BACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,4BAA4B,gBACvC,6BACA,oFACA,6BACA,KACA,IACF;;;;;;;;;AAUA,IAAa,kCAAkC,gBAC7C,mCACA,6EACA,mCACA,KACA,IACF;;;;;;;;;;;AAYA,IAAa,qCAAqC,gBAChD,sCACA,sFACA,sCACA,KACA,KACF;;;;;;;;;;;;;;;AAgBA,IAAa,oCAAoC,gBAC/C,qCACA,qFACA,qCACA,KACA,IACF;;;;;;;;;AAUA,IAAa,+BAA+B,gBAC1C,gCACA,gEACA,gCACA,KACA,IACF;;;;;;;;;;;;;AAcA,IAAa,4BAA4B,gBACvC,6BACA,mDACA,6BACA,KACA,KACF;;;;;;;;;;;AAYA,IAAa,iCAAiC,gBAC5C,kCACA,uDACA,kCACA,KACA,KACF"}

package/{runtime-MFFcJrRv.js → runtime-DslE1aBw.js}

@@ -1,4 +1,4 @@
-const require_exceptions = require("./exceptions-CitH5wZI.js");
+const require_exceptions = require("./exceptions-BRXrUKiW.js");
 //#region src/lib/exceptions/runtime.ts
 /**
 * Thrown by {@link @nhtio/adk!TurnRunner} when the supplied config object fails schema validation at
@@ -520,4 +520,4 @@ Object.defineProperty(exports, "E_TURN_GATE_TIMEOUT", {
 	}
 });
 
-//# sourceMappingURL=runtime-MFFcJrRv.js.map
+//# sourceMappingURL=runtime-DslE1aBw.js.map

package/{runtime-MFFcJrRv.js.map → runtime-DslE1aBw.js.map}

@@ -1 +1 @@
-{"version":3,"file":"runtime-MFFcJrRv.js","names":[],"sources":["../src/lib/exceptions/runtime.ts"],"sourcesContent":["import { createException } from '../utils/exceptions'\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the supplied config object fails schema validation at\n * construction time.\n *\n * @remarks\n * Marked fatal — a misconfigured runner must not be allowed to execute turns.\n *\n * The single printf argument carries the validator's field-level detail (e.g.\n * `\"storeMediaBytesCallback is required\"`) so a misconfiguration names the offending field\n * instead of failing opaquely. The underlying `ValidationError` is also attached on `cause`.\n *\n * @group Turn Runner Construction\n */\nexport const E_INVALID_TURN_RUNNER_CONFIG = createException<[string]>(\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  'The turn runner cannot be instantiated with the provided configuration: %s',\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  529,\n  true\n)\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the {@link @nhtio/adk!TurnContext} supplied to `run` fails schema\n * validation.\n *\n * @remarks\n * Marked fatal — an invalid context indicates a programming error in the caller, not a\n * recoverable runtime condition. Thrown synchronously out of `run()` before `turnStart` is\n * emitted.\n *\n * @group Turn Input Validation\n */\nexport const E_INVALID_TURN_CONTEXT = createException(\n  'E_INVALID_TURN_CONTEXT',\n  'The turn runner received an invalid context object.',\n  'E_INVALID_TURN_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the input\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. Dispatch\n * and output middleware are skipped; `turnEnd` still fires.\n *\n * @group Pipelines\n */\nexport const E_INPUT_PIPELINE_ERROR = createException(\n  'E_INPUT_PIPELINE_ERROR',\n  'An error occurred in the input pipeline.',\n  'E_INPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the output\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. `turnEnd`\n * still fires.\n *\n * @group Pipelines\n */\nexport const E_OUTPUT_PIPELINE_ERROR = createException(\n  'E_OUTPUT_PIPELINE_ERROR',\n  'An error occurred in the output pipeline.',\n  'E_OUTPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a middleware pipeline resolves without reaching its\n * terminal handler and without the turn being aborted. Indicates that some middleware\n * returned without calling `next` and without signalling a deliberate refusal via the turn's\n * abort controller.\n *\n * @remarks\n * Not fatal — the runner emits this on the `error` event so the failure is observable, then\n * proceeds to short-circuit the remainder of the turn the same way any other pipeline error\n * would. The constructor takes a single positional argument identifying the pipeline that\n * short-circuited: one of `'turn-input'`, `'turn-output'`, `'dispatch-input'`, or `'dispatch-output'`.\n *\n * Deliberate refusals should call `ctx.abort(reason)`, which sets the `'aborted'` outcome\n * instead of emitting this error.\n *\n * @warning\n * This is a **detection condition**, not a thrown exception. The runner constructs and emits\n * the code itself when it detects a missing `next()` on the unwind — nothing in user code\n * throws it. Upstream post-steps still run normally.\n *\n * @example\n * ```ts\n * throw new E_PIPELINE_SHORT_CIRCUITED(['turn-input'])\n * ```\n *\n * @group Pipelines\n */\nexport const E_PIPELINE_SHORT_CIRCUITED = createException<[string]>(\n  'E_PIPELINE_SHORT_CIRCUITED',\n  \"The '%s' middleware pipeline short-circuited without calling next or aborting the turn.\",\n  'E_PIPELINE_SHORT_CIRCUITED',\n  500,\n  false\n)\n\n/**\n * Thrown when a registry is initialised with a value that is defined but not a plain object.\n *\n * @remarks\n * Registries expect either `undefined` (empty start) or a plain object as their initial value.\n * Passing a primitive, array, class instance, or other non-object signals a programming error\n * in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_REGISTRY_VALUE = createException(\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  'Attempted to initialize a registry with a defined non-object value.',\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Memory} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Memory` requires all fields — `id`, `content`, `confidence`, `importance`, `createdAt`,\n * `updatedAt` — to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MEMORY_VALUE = createException(\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  'Attempted to initialize a memory with an invalid value.',\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Retrievable} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Retrievable` requires `id`, `content`, `trustTier`, `createdAt`, and `updatedAt` to be present\n * and of the correct type, and `trustTier` must be one of `'first-party'`, `'third-party-public'`,\n * or `'third-party-private'`. The `trustTier` decision must be made consciously by the retrieval\n * middleware at construction time — there is no default. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_RETRIEVABLE_VALUE = createException(\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  'Invalid initial value supplied to Retrievable constructor.',\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Message} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Message` requires `id`, `role` (`user` or `assistant`), `content`, `createdAt`, and\n * `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MESSAGE_VALUE = createException(\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  'Attempted to initialize a message with an invalid value.',\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when an {@link @nhtio/adk!Identity} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Identity` requires both `identifier` (string or number) and `representation` (string or\n * {@link @nhtio/adk!Tokenizable}) to be present and of the correct type. Passing an incomplete or\n * incorrectly typed object signals a programming error in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_IDENTITY_VALUE = createException(\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  'Attempted to initialize an identity with an invalid value.',\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Thought} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Thought` requires `id`, `content`, `createdAt`, and `updatedAt` to be present and of the\n * correct type. Passing an incomplete or incorrectly typed object signals a programming error\n * in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_THOUGHT_VALUE = createException(\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  'Attempted to initialize a thought with an invalid value.',\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!TurnGate} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Gates\n */\nexport const E_INVALID_INITIAL_TURN_GATE_VALUE = createException(\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  'Attempted to initialize a turn gate with an invalid value.',\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously in the caller's context when {@link @nhtio/adk!TurnGate.resolve} is called with a\n * value that fails the gate's schema.\n *\n * @remarks\n * Fatal — passing the wrong type to `resolve()` is a programming error. The internal promise is\n * NOT settled when this is thrown; the gate remains open.\n *\n * @group Gates\n */\nexport const E_INVALID_TURN_GATE_RESOLUTION = createException(\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  'The value supplied to TurnGate.resolve() failed schema validation.',\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  500,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} times out before being resolved.\n *\n * @remarks\n * Not fatal — a timeout is a recoverable runtime condition; the caller may retry or surface it\n * to the user.\n *\n * @warning\n * A timeout does **not** cancel the external event or clear any remote queue. The gate closes\n * locally, but whatever external system was expected to call `gate.resolve()` may still fire\n * later. Orphaned external state must be handled by the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_TIMEOUT = createException(\n  'E_TURN_GATE_TIMEOUT',\n  'The turn gate timed out before being resolved.',\n  'E_TURN_GATE_TIMEOUT',\n  408,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} is aborted — either because the turn's\n * `AbortSignal` fired or because {@link @nhtio/adk!TurnGate.abort} was called directly.\n *\n * @remarks\n * Not fatal — abort is an intentional cancellation, not an error in the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_ABORTED = createException(\n  'E_TURN_GATE_ABORTED',\n  'The turn gate was aborted before being resolved.',\n  'E_TURN_GATE_ABORTED',\n  499,\n  false\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!SpooledArtifact} is constructed with a value that does not implement the\n * {@link @nhtio/adk!SpoolReader} interface.\n *\n * @remarks\n * Validated at construction time via {@link @nhtio/adk!implementsSpoolReader}. Passing anything that lacks\n * `line`, `byteLength`, or `lineCount` as callable functions signals a programming error in the\n * caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_SPOOL_READER = createException(\n  'E_NOT_A_SPOOL_READER',\n  'The provided value does not implement the SpoolReader interface.',\n  'E_NOT_A_SPOOL_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is constructed with a value that does not implement the MediaReader\n * interface.\n *\n * @remarks\n * Validated at construction time. Passing anything that lacks `stream` or `byteLength` as\n * callable functions signals a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_MEDIA_READER = createException(\n  'E_NOT_A_MEDIA_READER',\n  'The provided value does not implement the MediaReader interface.',\n  'E_NOT_A_MEDIA_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is initialised with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_INVALID_INITIAL_MEDIA_VALUE = createException(\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  'Attempted to initialize a media with an invalid value.',\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!ToolCall} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `ToolCall` requires `id`, `tool`, `args`, `checksum`, `isComplete`, `isError`, `createdAt`,\n * and `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_TOOL_CALL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  'Attempted to initialize a tool call with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Tool} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Tools\n */\nexport const E_INVALID_INITIAL_TOOL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  'Attempted to initialize a tool with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously when {@link @nhtio/adk!Tool.validate} is called with arguments that fail the tool's\n * input schema.\n *\n * @remarks\n * Not fatal — an arg validation failure in the tool call loop is a caller mistake that can be\n * surfaced as an error response. The tool handler is NOT called when this is thrown.\n *\n * @group Tools\n */\nexport const E_INVALID_TOOL_ARGS = createException(\n  'E_INVALID_TOOL_ARGS',\n  'The arguments supplied to the tool failed input schema validation.',\n  'E_INVALID_TOOL_ARGS',\n  422,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!Tool}'s handler throws during execution.\n *\n * @remarks\n * Not fatal — a downstream tool failure is a recoverable runtime condition. The tool call loop\n * catches this error specifically to report the failure back to the model rather than crashing\n * the pipeline.\n *\n * @group Tools\n */\nexport const E_TOOL_DOWNSTREAM_ERROR = createException(\n  'E_TOOL_DOWNSTREAM_ERROR',\n  'The tool handler threw an error during execution.',\n  'E_TOOL_DOWNSTREAM_ERROR',\n  500,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!ToolRegistry.register} is called for a tool name that is already registered\n * and `overwrite` is not `true`.\n *\n * @remarks\n * Fatal — accidentally overwriting a registered tool indicates a programming error. Pass\n * `overwrite: true` to replace an existing tool intentionally.\n *\n * @group Tools\n */\nexport const E_TOOL_ALREADY_REGISTERED = createException(\n  'E_TOOL_ALREADY_REGISTERED',\n  'A tool with this name is already registered. Pass overwrite: true to replace it.',\n  'E_TOOL_ALREADY_REGISTERED',\n  409,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_EXECUTION_CONTEXT = createException(\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  'The LLM execution context cannot be instantiated with the provided value.',\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when {@link @nhtio/adk!DispatchContext.waitFor} is called on a\n * standalone context that was constructed without a `waitFor` function.\n *\n * @remarks\n * Not fatal — the caller can catch this and handle the case where gate suspension is not\n * supported for this execution context.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_GATE_NOT_SUPPORTED = createException(\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  'waitFor was called on a standalone DispatchContext with no gate function provided.',\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  501,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext.ack} or {@link @nhtio/adk!DispatchContext.nack} is called on a\n * context that has already been signalled.\n *\n * @remarks\n * Fatal — signalling twice is a programming error in the caller. The first signal wins; the\n * second call is rejected loudly so callers cannot accidentally race between ack and nack.\n *\n * @danger\n * Signalling is **not** silently idempotent. The first `ack()` or `nack()` wins; the second\n * throws immediately. Guard with `if (!ctx.isSignalled)` when more than one seam may signal.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_ALREADY_SIGNALLED = createException(\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  'ack() or nack() was called on an DispatchContext that has already been signalled.',\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  500,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchRunner.dispatch} receives an input that fails schema validation.\n *\n * @remarks\n * Fatal — invalid dispatch input indicates a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_DISPATCH_INPUT = createException(\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  'The LLM execution runner received an invalid dispatch input.',\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when a non-abort error propagates\n * out of the input or output middleware pipeline during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — pipeline errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch. Both `dispatchInputPipeline` and\n * `dispatchOutputPipeline` share this one code — the runner does not split input vs. output at\n * this layer.\n *\n * @group Pipelines\n */\nexport const E_DISPATCH_PIPELINE_ERROR = createException(\n  'E_DISPATCH_PIPELINE_ERROR',\n  'An error occurred in an LLM execution pipeline.',\n  'E_DISPATCH_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when the user-supplied executor\n * callback throws during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — executor errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_EXECUTOR_ERROR = createException(\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  'The LLM execution executor callback threw an error.',\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  500,\n  false\n)\n"],"mappings":"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"}
+{"version":3,"file":"runtime-DslE1aBw.js","names":[],"sources":["../src/lib/exceptions/runtime.ts"],"sourcesContent":["import { createException } from '../utils/exceptions'\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the supplied config object fails schema validation at\n * construction time.\n *\n * @remarks\n * Marked fatal — a misconfigured runner must not be allowed to execute turns.\n *\n * The single printf argument carries the validator's field-level detail (e.g.\n * `\"storeMediaBytesCallback is required\"`) so a misconfiguration names the offending field\n * instead of failing opaquely. The underlying `ValidationError` is also attached on `cause`.\n *\n * @group Turn Runner Construction\n */\nexport const E_INVALID_TURN_RUNNER_CONFIG = createException<[string]>(\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  'The turn runner cannot be instantiated with the provided configuration: %s',\n  'E_INVALID_TURN_RUNNER_CONFIG',\n  529,\n  true\n)\n\n/**\n * Thrown by {@link @nhtio/adk!TurnRunner} when the {@link @nhtio/adk!TurnContext} supplied to `run` fails schema\n * validation.\n *\n * @remarks\n * Marked fatal — an invalid context indicates a programming error in the caller, not a\n * recoverable runtime condition. Thrown synchronously out of `run()` before `turnStart` is\n * emitted.\n *\n * @group Turn Input Validation\n */\nexport const E_INVALID_TURN_CONTEXT = createException(\n  'E_INVALID_TURN_CONTEXT',\n  'The turn runner received an invalid context object.',\n  'E_INVALID_TURN_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the input\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. Dispatch\n * and output middleware are skipped; `turnEnd` still fires.\n *\n * @group Pipelines\n */\nexport const E_INPUT_PIPELINE_ERROR = createException(\n  'E_INPUT_PIPELINE_ERROR',\n  'An error occurred in the input pipeline.',\n  'E_INPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a non-abort error propagates out of the output\n * middleware pipeline during {@link @nhtio/adk!TurnRunner.run}.\n *\n * @remarks\n * Not fatal — the turn runner emits this on the `error` event rather than throwing, so\n * registered listeners can handle or log the failure without crashing the pipeline. `turnEnd`\n * still fires.\n *\n * @group Pipelines\n */\nexport const E_OUTPUT_PIPELINE_ERROR = createException(\n  'E_OUTPUT_PIPELINE_ERROR',\n  'An error occurred in the output pipeline.',\n  'E_OUTPUT_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the `error` event) when a middleware pipeline resolves without reaching its\n * terminal handler and without the turn being aborted. Indicates that some middleware\n * returned without calling `next` and without signalling a deliberate refusal via the turn's\n * abort controller.\n *\n * @remarks\n * Not fatal — the runner emits this on the `error` event so the failure is observable, then\n * proceeds to short-circuit the remainder of the turn the same way any other pipeline error\n * would. The constructor takes a single positional argument identifying the pipeline that\n * short-circuited: one of `'turn-input'`, `'turn-output'`, `'dispatch-input'`, or `'dispatch-output'`.\n *\n * Deliberate refusals should call `ctx.abort(reason)`, which sets the `'aborted'` outcome\n * instead of emitting this error.\n *\n * @warning\n * This is a **detection condition**, not a thrown exception. The runner constructs and emits\n * the code itself when it detects a missing `next()` on the unwind — nothing in user code\n * throws it. Upstream post-steps still run normally.\n *\n * @example\n * ```ts\n * throw new E_PIPELINE_SHORT_CIRCUITED(['turn-input'])\n * ```\n *\n * @group Pipelines\n */\nexport const E_PIPELINE_SHORT_CIRCUITED = createException<[string]>(\n  'E_PIPELINE_SHORT_CIRCUITED',\n  \"The '%s' middleware pipeline short-circuited without calling next or aborting the turn.\",\n  'E_PIPELINE_SHORT_CIRCUITED',\n  500,\n  false\n)\n\n/**\n * Thrown when a registry is initialised with a value that is defined but not a plain object.\n *\n * @remarks\n * Registries expect either `undefined` (empty start) or a plain object as their initial value.\n * Passing a primitive, array, class instance, or other non-object signals a programming error\n * in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_REGISTRY_VALUE = createException(\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  'Attempted to initialize a registry with a defined non-object value.',\n  'E_INVALID_INITIAL_REGISTRY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Memory} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Memory` requires all fields — `id`, `content`, `confidence`, `importance`, `createdAt`,\n * `updatedAt` — to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MEMORY_VALUE = createException(\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  'Attempted to initialize a memory with an invalid value.',\n  'E_INVALID_INITIAL_MEMORY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Retrievable} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Retrievable` requires `id`, `content`, `trustTier`, `createdAt`, and `updatedAt` to be present\n * and of the correct type, and `trustTier` must be one of `'first-party'`, `'third-party-public'`,\n * or `'third-party-private'`. The `trustTier` decision must be made consciously by the retrieval\n * middleware at construction time — there is no default. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_RETRIEVABLE_VALUE = createException(\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  'Invalid initial value supplied to Retrievable constructor.',\n  'E_INVALID_INITIAL_RETRIEVABLE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Message} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Message` requires `id`, `role` (`user` or `assistant`), `content`, `createdAt`, and\n * `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_MESSAGE_VALUE = createException(\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  'Attempted to initialize a message with an invalid value.',\n  'E_INVALID_INITIAL_MESSAGE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when an {@link @nhtio/adk!Identity} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Identity` requires both `identifier` (string or number) and `representation` (string or\n * {@link @nhtio/adk!Tokenizable}) to be present and of the correct type. Passing an incomplete or\n * incorrectly typed object signals a programming error in the caller.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_IDENTITY_VALUE = createException(\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  'Attempted to initialize an identity with an invalid value.',\n  'E_INVALID_INITIAL_IDENTITY_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Thought} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `Thought` requires `id`, `content`, `createdAt`, and `updatedAt` to be present and of the\n * correct type. Passing an incomplete or incorrectly typed object signals a programming error\n * in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_THOUGHT_VALUE = createException(\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  'Attempted to initialize a thought with an invalid value.',\n  'E_INVALID_INITIAL_THOUGHT_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!TurnGate} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Gates\n */\nexport const E_INVALID_INITIAL_TURN_GATE_VALUE = createException(\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  'Attempted to initialize a turn gate with an invalid value.',\n  'E_INVALID_INITIAL_TURN_GATE_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously in the caller's context when {@link @nhtio/adk!TurnGate.resolve} is called with a\n * value that fails the gate's schema.\n *\n * @remarks\n * Fatal — passing the wrong type to `resolve()` is a programming error. The internal promise is\n * NOT settled when this is thrown; the gate remains open.\n *\n * @group Gates\n */\nexport const E_INVALID_TURN_GATE_RESOLUTION = createException(\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  'The value supplied to TurnGate.resolve() failed schema validation.',\n  'E_INVALID_TURN_GATE_RESOLUTION',\n  500,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} times out before being resolved.\n *\n * @remarks\n * Not fatal — a timeout is a recoverable runtime condition; the caller may retry or surface it\n * to the user.\n *\n * @warning\n * A timeout does **not** cancel the external event or clear any remote queue. The gate closes\n * locally, but whatever external system was expected to call `gate.resolve()` may still fire\n * later. Orphaned external state must be handled by the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_TIMEOUT = createException(\n  'E_TURN_GATE_TIMEOUT',\n  'The turn gate timed out before being resolved.',\n  'E_TURN_GATE_TIMEOUT',\n  408,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!TurnGate} is aborted — either because the turn's\n * `AbortSignal` fired or because {@link @nhtio/adk!TurnGate.abort} was called directly.\n *\n * @remarks\n * Not fatal — abort is an intentional cancellation, not an error in the caller.\n *\n * @group Gates\n */\nexport const E_TURN_GATE_ABORTED = createException(\n  'E_TURN_GATE_ABORTED',\n  'The turn gate was aborted before being resolved.',\n  'E_TURN_GATE_ABORTED',\n  499,\n  false\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!SpooledArtifact} is constructed with a value that does not implement the\n * {@link @nhtio/adk!SpoolReader} interface.\n *\n * @remarks\n * Validated at construction time via {@link @nhtio/adk!implementsSpoolReader}. Passing anything that lacks\n * `line`, `byteLength`, or `lineCount` as callable functions signals a programming error in the\n * caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_SPOOL_READER = createException(\n  'E_NOT_A_SPOOL_READER',\n  'The provided value does not implement the SpoolReader interface.',\n  'E_NOT_A_SPOOL_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is constructed with a value that does not implement the MediaReader\n * interface.\n *\n * @remarks\n * Validated at construction time. Passing anything that lacks `stream` or `byteLength` as\n * callable functions signals a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_NOT_A_MEDIA_READER = createException(\n  'E_NOT_A_MEDIA_READER',\n  'The provided value does not implement the MediaReader interface.',\n  'E_NOT_A_MEDIA_READER',\n  500,\n  true\n)\n\n/**\n * Thrown when a Media is initialised with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Artifacts\n */\nexport const E_INVALID_INITIAL_MEDIA_VALUE = createException(\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  'Attempted to initialize a media with an invalid value.',\n  'E_INVALID_INITIAL_MEDIA_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!ToolCall} is initialised with a value that fails schema validation.\n *\n * @remarks\n * `ToolCall` requires `id`, `tool`, `args`, `checksum`, `isComplete`, `isError`, `createdAt`,\n * and `updatedAt` to be present and of the correct type. Passing an incomplete or incorrectly\n * typed object signals a programming error in the caller, not a recoverable runtime condition.\n *\n * @group Primitive Validation\n */\nexport const E_INVALID_INITIAL_TOOL_CALL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  'Attempted to initialize a tool call with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_CALL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown when a {@link @nhtio/adk!Tool} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Tools\n */\nexport const E_INVALID_INITIAL_TOOL_VALUE = createException(\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  'Attempted to initialize a tool with an invalid value.',\n  'E_INVALID_INITIAL_TOOL_VALUE',\n  500,\n  true\n)\n\n/**\n * Thrown synchronously when {@link @nhtio/adk!Tool.validate} is called with arguments that fail the tool's\n * input schema.\n *\n * @remarks\n * Not fatal — an arg validation failure in the tool call loop is a caller mistake that can be\n * surfaced as an error response. The tool handler is NOT called when this is thrown.\n *\n * @group Tools\n */\nexport const E_INVALID_TOOL_ARGS = createException(\n  'E_INVALID_TOOL_ARGS',\n  'The arguments supplied to the tool failed input schema validation.',\n  'E_INVALID_TOOL_ARGS',\n  422,\n  false\n)\n\n/**\n * Thrown (as a rejection reason) when a {@link @nhtio/adk!Tool}'s handler throws during execution.\n *\n * @remarks\n * Not fatal — a downstream tool failure is a recoverable runtime condition. The tool call loop\n * catches this error specifically to report the failure back to the model rather than crashing\n * the pipeline.\n *\n * @group Tools\n */\nexport const E_TOOL_DOWNSTREAM_ERROR = createException(\n  'E_TOOL_DOWNSTREAM_ERROR',\n  'The tool handler threw an error during execution.',\n  'E_TOOL_DOWNSTREAM_ERROR',\n  500,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!ToolRegistry.register} is called for a tool name that is already registered\n * and `overwrite` is not `true`.\n *\n * @remarks\n * Fatal — accidentally overwriting a registered tool indicates a programming error. Pass\n * `overwrite: true` to replace an existing tool intentionally.\n *\n * @group Tools\n */\nexport const E_TOOL_ALREADY_REGISTERED = createException(\n  'E_TOOL_ALREADY_REGISTERED',\n  'A tool with this name is already registered. Pass overwrite: true to replace it.',\n  'E_TOOL_ALREADY_REGISTERED',\n  409,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext} is constructed with a value that fails schema validation.\n *\n * @remarks\n * Fatal — bad construction arguments indicate a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_EXECUTION_CONTEXT = createException(\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  'The LLM execution context cannot be instantiated with the provided value.',\n  'E_INVALID_LLM_EXECUTION_CONTEXT',\n  529,\n  true\n)\n\n/**\n * Thrown (as a rejection reason) when {@link @nhtio/adk!DispatchContext.waitFor} is called on a\n * standalone context that was constructed without a `waitFor` function.\n *\n * @remarks\n * Not fatal — the caller can catch this and handle the case where gate suspension is not\n * supported for this execution context.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_GATE_NOT_SUPPORTED = createException(\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  'waitFor was called on a standalone DispatchContext with no gate function provided.',\n  'E_LLM_EXECUTION_GATE_NOT_SUPPORTED',\n  501,\n  false\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchContext.ack} or {@link @nhtio/adk!DispatchContext.nack} is called on a\n * context that has already been signalled.\n *\n * @remarks\n * Fatal — signalling twice is a programming error in the caller. The first signal wins; the\n * second call is rejected loudly so callers cannot accidentally race between ack and nack.\n *\n * @danger\n * Signalling is **not** silently idempotent. The first `ack()` or `nack()` wins; the second\n * throws immediately. Guard with `if (!ctx.isSignalled)` when more than one seam may signal.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_ALREADY_SIGNALLED = createException(\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  'ack() or nack() was called on an DispatchContext that has already been signalled.',\n  'E_LLM_EXECUTION_ALREADY_SIGNALLED',\n  500,\n  true\n)\n\n/**\n * Thrown when {@link @nhtio/adk!DispatchRunner.dispatch} receives an input that fails schema validation.\n *\n * @remarks\n * Fatal — invalid dispatch input indicates a programming error in the caller.\n *\n * @group Dispatch\n */\nexport const E_INVALID_LLM_DISPATCH_INPUT = createException(\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  'The LLM execution runner received an invalid dispatch input.',\n  'E_INVALID_LLM_DISPATCH_INPUT',\n  529,\n  true\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when a non-abort error propagates\n * out of the input or output middleware pipeline during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — pipeline errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch. Both `dispatchInputPipeline` and\n * `dispatchOutputPipeline` share this one code — the runner does not split input vs. output at\n * this layer.\n *\n * @group Pipelines\n */\nexport const E_DISPATCH_PIPELINE_ERROR = createException(\n  'E_DISPATCH_PIPELINE_ERROR',\n  'An error occurred in an LLM execution pipeline.',\n  'E_DISPATCH_PIPELINE_ERROR',\n  500,\n  false\n)\n\n/**\n * Emitted (via the observability `error` hook) and re-thrown when the user-supplied executor\n * callback throws during {@link @nhtio/adk!DispatchRunner.dispatch}.\n *\n * @remarks\n * Not fatal — executor errors are recoverable runtime conditions. `dispatch()` rejects with this\n * exception so callers can handle the failure via try/catch.\n *\n * @group Dispatch\n */\nexport const E_LLM_EXECUTION_EXECUTOR_ERROR = createException(\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  'The LLM execution executor callback threw an error.',\n  'E_LLM_EXECUTION_EXECUTOR_ERROR',\n  500,\n  false\n)\n"],"mappings":"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"}

package/searxng-Bkrwhwhw.js

@@ -0,0 +1,269 @@
+require("./chunk-Ble4zEEl.js");
+const require_exceptions = require("./exceptions-BRXrUKiW.js");
+const require_tool_registry = require("./tool_registry-CKJPze3j.js");
+const require_tool = require("./tool-D5WGVIcI.js");
+require("./common-DZl3ADJs.js");
+const require_spooled_markdown_artifact = require("./spooled_markdown_artifact-ClX72lek.js");
+require("./factories.cjs");
+require("./guards.cjs");
+let _nhtio_validation = require("@nhtio/validation");
+let _nhtio_middleware = require("@nhtio/middleware");
+//#region src/batteries/tools/searxng/exceptions.ts
+/**
+* Battery-scoped exception constructors for the SearXNG search tool.
+*
+* @remarks
+* Battery-scoped exception classes owned by the SearXNG tool battery (not the ADK core). Minted
+* via `createException` from `@nhtio/adk/factories` and re-exported from the battery's barrel
+* (`@nhtio/adk/batteries/tools/searxng`). This file intentionally carries **no** `@module` tag:
+* it is an internal sibling relative-imported by `index.ts`, so it does not mint its own
+* `…/searxng/exceptions` entrypoint (whose `exceptions` leaf basename would collide with sibling
+* batteries under the `vite-plugin-dts` rolled-up `.d.ts` rule).
+*/
+/**
+* Thrown when {@link createSearxngSearchTool} receives invalid configuration.
+*
+* @remarks
+* Fatal: config bugs (missing or unparseable `instanceUrl`) fail loud at factory-call time
+* rather than at the first search.
+*/
+var E_INVALID_SEARXNG_CONFIG = require_exceptions.createException("E_INVALID_SEARXNG_CONFIG", "Invalid SearXNG tool config: %s", "E_INVALID_SEARXNG_CONFIG", 529, true);
+//#endregion
+//#region src/batteries/tools/searxng/index.ts
+/**
+* Factory for a configured SearXNG metasearch tool.
+*
+* @module @nhtio/adk/batteries/tools/searxng
+*
+* @remarks
+* Unlike the other bundled tool categories — every one of which exports a ready-made,
+* stateless `Tool` constant — the SearXNG battery exports a **factory**,
+* {@link createSearxngSearchTool}. A search tool has to talk to a *specific* SearXNG instance,
+* usually behind custom authentication, so it needs per-deployment configuration (a base URL
+* and headers) that cannot be baked in at module load.
+*
+* Because this module exports a factory rather than a `Tool` instance, it MUST NOT be
+* bulk-registered via `Object.values(batteries)`. Call the factory first, then register the
+* returned tool: `new ToolRegistry([createSearxngSearchTool({ instanceUrl })])`.
+*
+* @see https://docs.searxng.org/dev/search_api.html
+*/
+var DEFAULT_NAME = "searxng_search";
+var DEFAULT_TIMEOUT = 1e4;
+var DEFAULT_DESCRIPTION = "Search the web via a SearXNG metasearch instance. Returns aggregated results (title, url, snippet, source engine) plus any answers, infoboxes, and suggestions.";
+/** Internal sentinel a short-circuiting input stage throws to unwind the pipeline immediately. */
+var SHORT_CIRCUIT = Symbol("searxng.shortCircuit");
+var isShortCircuit = (value) => require_tool_registry.isObject(value) && value[SHORT_CIRCUIT] === true;
+/** Normalise a loose SearXNG result item into a {@link SearxngResult}. */
+var normaliseResult = (raw) => {
+	const r = raw ?? {};
+	const out = {};
+	if (typeof r.title === "string") out.title = r.title;
+	if (typeof r.url === "string") out.url = r.url;
+	if (typeof r.content === "string") out.content = r.content;
+	if (typeof r.engine === "string") out.engine = r.engine;
+	if (typeof r.score === "number") out.score = r.score;
+	if (typeof r.publishedDate === "string") out.publishedDate = r.publishedDate;
+	return out;
+};
+/** Resolve the configured headers (static object or resolver) for a single request. */
+var resolveHeaders = async (headers) => {
+	if (typeof headers === "function") return { ...await headers() };
+	return { ...headers ?? {} };
+};
+/**
+* Create a configured SearXNG search {@link Tool}.
+*
+* @remarks
+* The handler always requests `format=json`. Note that SearXNG ships with JSON output
+* **disabled** by default (it is abused by bots); an instance that has not enabled
+* `search.formats: [json]` in its `settings.yml` answers with HTTP 403, which the tool returns
+* as a graceful `Error:` string naming the setting.
+*
+* @warning
+* Do not trust the `number_of_results` field for a result count — SearXNG frequently reports `0`
+* in JSON output even when `results` is non-empty. This is a long-standing upstream quirk, not a
+* tool defect (see {@link https://github.com/searxng/searxng/issues/2987 | searxng#2987} and
+* {@link https://github.com/searxng/searxng/issues/2457 | searxng#2457}). The tool passes the
+* field through verbatim; use `results.length` as the authoritative count.
+*
+* @param config - The instance URL, optional custom headers, output-format policy, artifact
+*   type, and input/output middleware pipelines. See {@link SearxngToolConfig}.
+* @returns A `Tool` ready to register in a `ToolRegistry`.
+* @throws {@link E_INVALID_SEARXNG_CONFIG} when `instanceUrl` is missing or unparseable.
+*/
+var createSearxngSearchTool = (config) => {
+	if (typeof config?.instanceUrl !== "string" || config.instanceUrl.trim() === "") throw new E_INVALID_SEARXNG_CONFIG(["instanceUrl is required"]);
+	try {
+		new URL(config.instanceUrl);
+	} catch {
+		throw new E_INVALID_SEARXNG_CONFIG([`instanceUrl is not a valid URL: ${config.instanceUrl}`]);
+	}
+	const instanceUrl = config.instanceUrl.replace(/\/+$/, "");
+	const timeout = config.timeout ?? DEFAULT_TIMEOUT;
+	const resultFormat = config.resultFormat ?? "either";
+	const toolName = config.name ?? DEFAULT_NAME;
+	const artifactConstructor = config.artifactConstructor ?? (() => require_spooled_markdown_artifact.SpooledJsonArtifact);
+	const inputMw = new _nhtio_middleware.Middleware();
+	for (const fn of config.inputPipeline ?? []) inputMw.add(fn);
+	const outputMw = new _nhtio_middleware.Middleware();
+	for (const fn of config.outputPipeline ?? []) outputMw.add(fn);
+	const hasInput = (config.inputPipeline ?? []).length > 0;
+	const hasOutput = (config.outputPipeline ?? []).length > 0;
+	const schemaShape = {
+		query: _nhtio_validation.validator.string().required().description("The search query."),
+		categories: _nhtio_validation.validator.string().optional().description("Comma-separated SearXNG categories (e.g. \"general,news\")."),
+		engines: _nhtio_validation.validator.string().optional().description("Comma-separated SearXNG engines (e.g. \"google,duckduckgo\")."),
+		language: _nhtio_validation.validator.string().optional().description("Language code (e.g. \"en\", \"de\")."),
+		pageno: _nhtio_validation.validator.number().min(1).default(1).description("Result page number (1-based)."),
+		time_range: _nhtio_validation.validator.string().valid("day", "month", "year").optional().description("Restrict results to a time range."),
+		safesearch: _nhtio_validation.validator.number().valid(0, 1, 2).optional().description("Safe-search level: 0 (off), 1 (moderate), 2 (strict).")
+	};
+	if (resultFormat === "either") schemaShape.format = _nhtio_validation.validator.string().valid("normalized", "raw").default("normalized").description("Output shape: \"normalized\" (trimmed) or \"raw\" (full SearXNG JSON).");
+	const inputSchema = _nhtio_validation.validator.object(schemaShape);
+	return new require_tool.Tool({
+		name: toolName,
+		description: config.description ?? DEFAULT_DESCRIPTION,
+		inputSchema,
+		artifactConstructor,
+		handler: async (args) => {
+			const a = args;
+			try {
+				const format = resultFormat === "either" ? a.format ?? "normalized" : resultFormat;
+				const headers = {
+					"Accept": "application/json",
+					"User-Agent": "adk-searxng-tool",
+					...await resolveHeaders(config.headers)
+				};
+				const params = {};
+				if (a.categories) params.categories = a.categories;
+				if (a.engines) params.engines = a.engines;
+				if (a.language) params.language = a.language;
+				if (a.pageno && a.pageno !== 1) params.pageno = String(a.pageno);
+				if (a.time_range) params.time_range = a.time_range;
+				if (typeof a.safesearch === "number") params.safesearch = String(a.safesearch);
+				const stash = /* @__PURE__ */ new Map();
+				const requestCtx = {
+					toolName,
+					query: a.query,
+					params,
+					headers,
+					instanceUrl,
+					stash,
+					shortCircuit: (result) => {
+						throw {
+							[SHORT_CIRCUIT]: true,
+							result
+						};
+					}
+				};
+				if (hasInput) {
+					const short = await runInputPipeline(inputMw, requestCtx);
+					if (short !== void 0) return short;
+				}
+				const url = new URL("/search", instanceUrl + "/");
+				url.searchParams.set("q", requestCtx.query);
+				for (const [k, v] of Object.entries(requestCtx.params)) url.searchParams.set(k, v);
+				url.searchParams.set("format", "json");
+				const controller = new AbortController();
+				const timer = setTimeout(() => controller.abort(), timeout);
+				let response;
+				try {
+					response = await fetch(url, {
+						method: "GET",
+						headers: requestCtx.headers,
+						signal: controller.signal
+					});
+				} finally {
+					clearTimeout(timer);
+				}
+				if (!response.ok) {
+					if (response.status === 403) return "Error: SearXNG returned 403 Forbidden. The instance likely has the JSON output format disabled — enable it under \"search.formats: [json]\" in its settings.yml.";
+					return `Error: SearXNG returned HTTP ${response.status} ${response.statusText}.`;
+				}
+				const body = await response.json();
+				const responseCtx = {
+					toolName,
+					request: requestCtx,
+					raw: body,
+					results: Array.isArray(body.results) ? body.results.map(normaliseResult) : [],
+					format,
+					stash
+				};
+				if (hasOutput) await runOutputPipeline(outputMw, responseCtx);
+				if (typeof responseCtx.output === "string") return responseCtx.output;
+				if (responseCtx.format === "raw") return JSON.stringify(responseCtx.raw, null, 2);
+				return JSON.stringify(buildNormalisedPayload(responseCtx), null, 2);
+			} catch (err) {
+				if (isShortCircuit(err)) return err.result;
+				return `Error: ${require_tool_registry.isError(err) ? err.message : String(err)}`;
+			}
+		}
+	});
+};
+/** Assemble the trimmed normalised payload, dropping empty aggregate arrays. */
+var buildNormalisedPayload = (ctx) => {
+	const raw = ctx.raw ?? {};
+	const payload = {
+		query: typeof raw.query === "string" ? raw.query : ctx.request.query,
+		results: ctx.results
+	};
+	if (typeof raw.number_of_results === "number") payload.number_of_results = raw.number_of_results;
+	for (const key of [
+		"answers",
+		"infoboxes",
+		"suggestions",
+		"corrections"
+	]) {
+		const value = raw[key];
+		if (Array.isArray(value) && value.length > 0) payload[key] = value;
+	}
+	return payload;
+};
+/**
+* Run the input pipeline. Returns the short-circuit string when a stage short-circuited, or
+* `undefined` when the pipeline reached its terminal handler. A non-terminal pipeline (a stage
+* that neither called `next()` nor short-circuited) is surfaced as a thrown Error so the handler
+* converts it to an `Error:` string.
+*/
+var runInputPipeline = async (mw, ctx) => {
+	let reached = false;
+	let shortResult;
+	let caught;
+	await mw.runner().errorHandler(async (error) => {
+		caught = error;
+	}).finalHandler(async () => {
+		reached = true;
+	}).run((fn, next) => Promise.resolve(fn(ctx, next)));
+	if (caught !== void 0) if (isShortCircuit(caught)) shortResult = caught.result;
+	else throw caught;
+	else if (!reached) throw new Error("SearXNG input pipeline did not call next() and did not short-circuit.");
+	return shortResult;
+};
+/** Run the output pipeline; rethrow any stage error to the handler's try/catch. */
+var runOutputPipeline = async (mw, ctx) => {
+	let reached = false;
+	let caught;
+	await mw.runner().errorHandler(async (error) => {
+		caught = error;
+	}).finalHandler(async () => {
+		reached = true;
+	}).run((fn, next) => Promise.resolve(fn(ctx, next)));
+	if (caught !== void 0) throw caught;
+	if (!reached) throw new Error("SearXNG output pipeline did not call next().");
+};
+//#endregion
+Object.defineProperty(exports, "E_INVALID_SEARXNG_CONFIG", {
+	enumerable: true,
+	get: function() {
+		return E_INVALID_SEARXNG_CONFIG;
+	}
+});
+Object.defineProperty(exports, "createSearxngSearchTool", {
+	enumerable: true,
+	get: function() {
+		return createSearxngSearchTool;
+	}
+});
+
+//# sourceMappingURL=searxng-Bkrwhwhw.js.map

package/searxng-Bkrwhwhw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searxng-Bkrwhwhw.js","names":[],"sources":["../src/batteries/tools/searxng/exceptions.ts","../src/batteries/tools/searxng/index.ts"],"sourcesContent":["/**\n * Battery-scoped exception constructors for the SearXNG search tool.\n *\n * @remarks\n * Battery-scoped exception classes owned by the SearXNG tool battery (not the ADK core). Minted\n * via `createException` from `@nhtio/adk/factories` and re-exported from the battery's barrel\n * (`@nhtio/adk/batteries/tools/searxng`). This file intentionally carries **no** `@module` tag:\n * it is an internal sibling relative-imported by `index.ts`, so it does not mint its own\n * `…/searxng/exceptions` entrypoint (whose `exceptions` leaf basename would collide with sibling\n * batteries under the `vite-plugin-dts` rolled-up `.d.ts` rule).\n */\n\nimport { createException } from '@nhtio/adk/factories'\n\n/**\n * Thrown when {@link createSearxngSearchTool} receives invalid configuration.\n *\n * @remarks\n * Fatal: config bugs (missing or unparseable `instanceUrl`) fail loud at factory-call time\n * rather than at the first search.\n */\nexport const E_INVALID_SEARXNG_CONFIG = createException<[string]>(\n  'E_INVALID_SEARXNG_CONFIG',\n  'Invalid SearXNG tool config: %s',\n  'E_INVALID_SEARXNG_CONFIG',\n  529,\n  true\n)\n","/**\n * Factory for a configured SearXNG metasearch tool.\n *\n * @module @nhtio/adk/batteries/tools/searxng\n *\n * @remarks\n * Unlike the other bundled tool categories — every one of which exports a ready-made,\n * stateless `Tool` constant — the SearXNG battery exports a **factory**,\n * {@link createSearxngSearchTool}. A search tool has to talk to a *specific* SearXNG instance,\n * usually behind custom authentication, so it needs per-deployment configuration (a base URL\n * and headers) that cannot be baked in at module load.\n *\n * Because this module exports a factory rather than a `Tool` instance, it MUST NOT be\n * bulk-registered via `Object.values(batteries)`. Call the factory first, then register the\n * returned tool: `new ToolRegistry([createSearxngSearchTool({ instanceUrl })])`.\n *\n * @see https://docs.searxng.org/dev/search_api.html\n */\n\nimport { validator } from '@nhtio/validation'\nimport { Middleware } from '@nhtio/middleware'\nimport { isError, isObject } from '@nhtio/adk/guards'\nimport { E_INVALID_SEARXNG_CONFIG } from './exceptions'\nimport { Tool, SpooledJsonArtifact, type ArtifactConstructorResolver } from '@nhtio/adk/common'\nimport type { Schema } from '@nhtio/validation'\nimport type { NextFn } from '@nhtio/middleware'\n\nexport { E_INVALID_SEARXNG_CONFIG } from './exceptions'\n\n/** A static set of request headers (used for custom authentication). */\nexport type SearxngHeaders = Record<string, string>\n\n/**\n * A resolver returning request headers, sync or async. Use this form when the auth token is\n * refreshable — the resolver runs on every search, so a fresh token can be minted per call.\n */\nexport type SearxngHeadersResolver = () => SearxngHeaders | Promise<SearxngHeaders>\n\n/** The output shape the tool serialises. `either` lets the model pick per call. */\nexport type SearxngResultFormat = 'normalized' | 'raw' | 'either'\n\n/**\n * A single normalised SearXNG result. SearXNG result items are deliberately untyped upstream,\n * so every field except a best-effort `title`/`url` is optional.\n */\nexport interface SearxngResult {\n  /** Result title, when the source engine provided one. */\n  title?: string\n  /** Result URL, when the source engine provided one. */\n  url?: string\n  /** Snippet / summary text for the result. */\n  content?: string\n  /** The SearXNG engine that produced this result (e.g. `google`, `duckduckgo`). */\n  engine?: string\n  /** Relevance score as reported by SearXNG (higher is more relevant). */\n  score?: number\n  /** Publication date, when the source engine exposed one (ISO-ish string, engine-dependent). */\n  publishedDate?: string\n}\n\n/**\n * Mutable context handed to each input-pipeline stage **before** the HTTP request is sent.\n *\n * @remarks\n * Stages mutate this in place (onion `(ctx, next)` style) to adjust the outgoing request —\n * inject or rotate auth headers, force a language, rewrite the query — or call\n * {@link SearxngRequestContext.shortCircuit} to skip the fetch entirely (e.g. a cache hit).\n */\nexport interface SearxngRequestContext {\n  /** The tool's name (read-only). */\n  readonly toolName: string\n  /** The search query. Mutable. */\n  query: string\n  /** Extra SearXNG query parameters (`categories`, `engines`, `language`, …). Mutable. */\n  params: Record<string, string>\n  /** Resolved request headers. Mutable — inject, redact, or rotate auth here. */\n  headers: SearxngHeaders\n  /** The target instance base URL (read-only). */\n  readonly instanceUrl: string\n  /** Cross-stage scratch space; also carried onto the response context. */\n  readonly stash: Map<string, unknown>\n  /** Skip the fetch and return `result` verbatim as the tool's output. */\n  shortCircuit(result: string): void\n}\n\n/**\n * Mutable context handed to each output-pipeline stage **after** the response JSON is parsed.\n *\n * @remarks\n * Stages reshape, redact, enrich, or re-rank {@link SearxngResponseContext.results}, mutate the\n * raw body, or set {@link SearxngResponseContext.output} to override the serialised string\n * verbatim (e.g. to render markdown that matches a markdown `artifactConstructor`).\n */\nexport interface SearxngResponseContext {\n  /** The tool's name (read-only). */\n  readonly toolName: string\n  /** The request context as it was sent (post-input-pipeline). */\n  readonly request: SearxngRequestContext\n  /** The parsed SearXNG JSON body. Mutable (used when `format` is `raw`). */\n  raw: unknown\n  /** The normalised result list. Mutable — filter, redact, or re-rank. */\n  results: SearxngResult[]\n  /** The effective payload shape for this call. */\n  format: 'normalized' | 'raw'\n  /** When set, used verbatim as the tool's output (overrides serialisation). */\n  output?: string\n  /** Cross-stage scratch space; carried over from the request context. */\n  readonly stash: Map<string, unknown>\n}\n\n/** An input-pipeline stage. Onion middleware over {@link SearxngRequestContext}. */\nexport type SearxngInputMiddlewareFn = (\n  ctx: SearxngRequestContext,\n  next: NextFn\n) => void | Promise<void>\n\n/** An output-pipeline stage. Onion middleware over {@link SearxngResponseContext}. */\nexport type SearxngOutputMiddlewareFn = (\n  ctx: SearxngResponseContext,\n  next: NextFn\n) => void | Promise<void>\n\n/** Configuration for {@link createSearxngSearchTool}. */\nexport interface SearxngToolConfig {\n  /** Base URL of the SearXNG instance, e.g. `https://searx.example.org`. Required. */\n  instanceUrl: string\n  /** Custom request headers — a static object or a (sync/async) resolver for refreshable auth. */\n  headers?: SearxngHeaders | SearxngHeadersResolver\n  /** Request timeout in milliseconds. Default `10_000`. */\n  timeout?: number\n  /**\n   * Output shape. `normalized`/`raw` pin the shape (the model cannot change it); `either`\n   * (default) exposes a `format` argument so the model chooses per call.\n   */\n  resultFormat?: SearxngResultFormat\n  /** Tool name. Default `searxng_search`. */\n  name?: string\n  /** Tool description override. */\n  description?: string\n  /**\n   * Spool artifact constructor for the tool's output. Default `() => SpooledJsonArtifact`.\n   * Pass `() => SpooledMarkdownArtifact` (paired with an output stage that renders markdown into\n   * `ctx.output`) or `() => SpooledArtifact` for plain text.\n   */\n  artifactConstructor?: ArtifactConstructorResolver\n  /** Stages run before the HTTP request. See {@link SearxngRequestContext}. */\n  inputPipeline?: SearxngInputMiddlewareFn[]\n  /** Stages run after the response is parsed. See {@link SearxngResponseContext}. */\n  outputPipeline?: SearxngOutputMiddlewareFn[]\n}\n\nconst DEFAULT_NAME = 'searxng_search'\nconst DEFAULT_TIMEOUT = 10_000\nconst DEFAULT_DESCRIPTION =\n  'Search the web via a SearXNG metasearch instance. Returns aggregated results (title, url, ' +\n  'snippet, source engine) plus any answers, infoboxes, and suggestions.'\n\n/** Internal sentinel a short-circuiting input stage throws to unwind the pipeline immediately. */\nconst SHORT_CIRCUIT = Symbol('searxng.shortCircuit')\n\ninterface ShortCircuitSignal {\n  [SHORT_CIRCUIT]: true\n  result: string\n}\n\nconst isShortCircuit = (value: unknown): value is ShortCircuitSignal =>\n  isObject(value) && (value as Record<symbol, unknown>)[SHORT_CIRCUIT] === true\n\n/** Normalise a loose SearXNG result item into a {@link SearxngResult}. */\nconst normaliseResult = (raw: unknown): SearxngResult => {\n  const r = (raw ?? {}) as Record<string, unknown>\n  const out: SearxngResult = {}\n  if (typeof r.title === 'string') out.title = r.title\n  if (typeof r.url === 'string') out.url = r.url\n  if (typeof r.content === 'string') out.content = r.content\n  if (typeof r.engine === 'string') out.engine = r.engine\n  if (typeof r.score === 'number') out.score = r.score\n  if (typeof r.publishedDate === 'string') out.publishedDate = r.publishedDate\n  return out\n}\n\n/** Resolve the configured headers (static object or resolver) for a single request. */\nconst resolveHeaders = async (headers: SearxngToolConfig['headers']): Promise<SearxngHeaders> => {\n  if (typeof headers === 'function') return { ...(await headers()) }\n  return { ...(headers ?? {}) }\n}\n\n/**\n * Create a configured SearXNG search {@link Tool}.\n *\n * @remarks\n * The handler always requests `format=json`. Note that SearXNG ships with JSON output\n * **disabled** by default (it is abused by bots); an instance that has not enabled\n * `search.formats: [json]` in its `settings.yml` answers with HTTP 403, which the tool returns\n * as a graceful `Error:` string naming the setting.\n *\n * @warning\n * Do not trust the `number_of_results` field for a result count — SearXNG frequently reports `0`\n * in JSON output even when `results` is non-empty. This is a long-standing upstream quirk, not a\n * tool defect (see {@link https://github.com/searxng/searxng/issues/2987 | searxng#2987} and\n * {@link https://github.com/searxng/searxng/issues/2457 | searxng#2457}). The tool passes the\n * field through verbatim; use `results.length` as the authoritative count.\n *\n * @param config - The instance URL, optional custom headers, output-format policy, artifact\n *   type, and input/output middleware pipelines. See {@link SearxngToolConfig}.\n * @returns A `Tool` ready to register in a `ToolRegistry`.\n * @throws {@link E_INVALID_SEARXNG_CONFIG} when `instanceUrl` is missing or unparseable.\n */\nexport const createSearxngSearchTool = (config: SearxngToolConfig): Tool => {\n  if (typeof config?.instanceUrl !== 'string' || config.instanceUrl.trim() === '') {\n    throw new E_INVALID_SEARXNG_CONFIG(['instanceUrl is required'])\n  }\n  try {\n    // Parse-validate only; the normalised string below is what we actually use.\n    new URL(config.instanceUrl)\n  } catch {\n    throw new E_INVALID_SEARXNG_CONFIG([`instanceUrl is not a valid URL: ${config.instanceUrl}`])\n  }\n  // Normalise away a trailing slash so `new URL('/search', base)` resolves cleanly.\n  const instanceUrl = config.instanceUrl.replace(/\\/+$/, '')\n\n  const timeout = config.timeout ?? DEFAULT_TIMEOUT\n  const resultFormat: SearxngResultFormat = config.resultFormat ?? 'either'\n  const toolName = config.name ?? DEFAULT_NAME\n  const artifactConstructor: ArtifactConstructorResolver =\n    config.artifactConstructor ?? (() => SpooledJsonArtifact)\n\n  // Stages are fixed at factory time; build the Middleware shells once. A fresh `.runner()` is\n  // minted per invocation inside the handler (runners are single-use).\n  const inputMw = new Middleware<SearxngInputMiddlewareFn>()\n  for (const fn of config.inputPipeline ?? []) inputMw.add(fn)\n  const outputMw = new Middleware<SearxngOutputMiddlewareFn>()\n  for (const fn of config.outputPipeline ?? []) outputMw.add(fn)\n  const hasInput = (config.inputPipeline ?? []).length > 0\n  const hasOutput = (config.outputPipeline ?? []).length > 0\n\n  // Build the input schema, conditionally exposing `format` only when the factory is neutral.\n  const schemaShape: Record<string, Schema> = {\n    query: validator.string().required().description('The search query.'),\n    categories: validator\n      .string()\n      .optional()\n      .description('Comma-separated SearXNG categories (e.g. \"general,news\").'),\n    engines: validator\n      .string()\n      .optional()\n      .description('Comma-separated SearXNG engines (e.g. \"google,duckduckgo\").'),\n    language: validator.string().optional().description('Language code (e.g. \"en\", \"de\").'),\n    pageno: validator.number().min(1).default(1).description('Result page number (1-based).'),\n    time_range: validator\n      .string()\n      .valid('day', 'month', 'year')\n      .optional()\n      .description('Restrict results to a time range.'),\n    safesearch: validator\n      .number()\n      .valid(0, 1, 2)\n      .optional()\n      .description('Safe-search level: 0 (off), 1 (moderate), 2 (strict).'),\n  }\n  if (resultFormat === 'either') {\n    schemaShape.format = validator\n      .string()\n      .valid('normalized', 'raw')\n      .default('normalized')\n      .description('Output shape: \"normalized\" (trimmed) or \"raw\" (full SearXNG JSON).')\n  }\n  const inputSchema = validator.object(schemaShape)\n\n  return new Tool({\n    name: toolName,\n    description: config.description ?? DEFAULT_DESCRIPTION,\n    inputSchema,\n    artifactConstructor,\n    handler: async (args) => {\n      const a = args as {\n        query: string\n        categories?: string\n        engines?: string\n        language?: string\n        pageno?: number\n        time_range?: string\n        safesearch?: number\n        format?: 'normalized' | 'raw'\n      }\n\n      try {\n        // 1. Effective output format: a pinned factory format wins; else the model's choice.\n        const format: 'normalized' | 'raw' =\n          resultFormat === 'either' ? (a.format ?? 'normalized') : resultFormat\n\n        // 2. Resolve headers, merged over portable defaults (caller headers win).\n        const headers: SearxngHeaders = {\n          'Accept': 'application/json',\n          'User-Agent': 'adk-searxng-tool',\n          ...(await resolveHeaders(config.headers)),\n        }\n\n        // 3. Assemble the SearXNG query params from validated args.\n        const params: Record<string, string> = {}\n        if (a.categories) params.categories = a.categories\n        if (a.engines) params.engines = a.engines\n        if (a.language) params.language = a.language\n        if (a.pageno && a.pageno !== 1) params.pageno = String(a.pageno)\n        if (a.time_range) params.time_range = a.time_range\n        if (typeof a.safesearch === 'number') params.safesearch = String(a.safesearch)\n\n        const stash = new Map<string, unknown>()\n\n        // 4. Run the input pipeline (fresh runner) over a mutable request context.\n        const requestCtx: SearxngRequestContext = {\n          toolName,\n          query: a.query,\n          params,\n          headers,\n          instanceUrl,\n          stash,\n          shortCircuit: (result: string) => {\n            const signal: ShortCircuitSignal = { [SHORT_CIRCUIT]: true, result }\n            throw signal\n          },\n        }\n\n        if (hasInput) {\n          const short = await runInputPipeline(inputMw, requestCtx)\n          if (short !== undefined) return short\n        }\n\n        // 5. Build the request URL from the (possibly mutated) query + params.\n        const url = new URL('/search', instanceUrl + '/')\n        url.searchParams.set('q', requestCtx.query)\n        for (const [k, v] of Object.entries(requestCtx.params)) url.searchParams.set(k, v)\n        url.searchParams.set('format', 'json')\n\n        // 6. Fetch with an AbortController timeout.\n        const controller = new AbortController()\n        const timer = setTimeout(() => controller.abort(), timeout)\n        let response: Response\n        try {\n          response = await fetch(url, {\n            method: 'GET',\n            headers: requestCtx.headers,\n            signal: controller.signal,\n          })\n        } finally {\n          clearTimeout(timer)\n        }\n\n        if (!response.ok) {\n          if (response.status === 403) {\n            return (\n              `Error: SearXNG returned 403 Forbidden. The instance likely has the JSON output ` +\n              `format disabled — enable it under \"search.formats: [json]\" in its settings.yml.`\n            )\n          }\n          return `Error: SearXNG returned HTTP ${response.status} ${response.statusText}.`\n        }\n\n        const body = (await response.json()) as Record<string, unknown>\n\n        // 7. Run the output pipeline (fresh runner) over a mutable response context.\n        const responseCtx: SearxngResponseContext = {\n          toolName,\n          request: requestCtx,\n          raw: body,\n          results: Array.isArray(body.results) ? body.results.map(normaliseResult) : [],\n          format,\n          stash,\n        }\n\n        if (hasOutput) await runOutputPipeline(outputMw, responseCtx)\n\n        // 8. Serialise and return.\n        if (typeof responseCtx.output === 'string') return responseCtx.output\n        if (responseCtx.format === 'raw') return JSON.stringify(responseCtx.raw, null, 2)\n        return JSON.stringify(buildNormalisedPayload(responseCtx), null, 2)\n      } catch (err) {\n        if (isShortCircuit(err)) return err.result\n        return `Error: ${isError(err) ? err.message : String(err)}`\n      }\n    },\n  })\n}\n\n/** Assemble the trimmed normalised payload, dropping empty aggregate arrays. */\nconst buildNormalisedPayload = (ctx: SearxngResponseContext): Record<string, unknown> => {\n  const raw = (ctx.raw ?? {}) as Record<string, unknown>\n  const payload: Record<string, unknown> = {\n    query: typeof raw.query === 'string' ? raw.query : ctx.request.query,\n    results: ctx.results,\n  }\n  // NOTE: SearXNG's `number_of_results` is frequently `0` in JSON output even when `results`\n  // is non-empty — a long-standing upstream quirk, not a tool bug (see\n  // https://github.com/searxng/searxng/issues/2987 and\n  // https://github.com/searxng/searxng/issues/2457). We pass through whatever the instance\n  // reports; treat `results.length` as the authoritative count, not this field.\n  if (typeof raw.number_of_results === 'number') payload.number_of_results = raw.number_of_results\n  for (const key of ['answers', 'infoboxes', 'suggestions', 'corrections'] as const) {\n    const value = raw[key]\n    if (Array.isArray(value) && value.length > 0) payload[key] = value\n  }\n  return payload\n}\n\n/**\n * Run the input pipeline. Returns the short-circuit string when a stage short-circuited, or\n * `undefined` when the pipeline reached its terminal handler. A non-terminal pipeline (a stage\n * that neither called `next()` nor short-circuited) is surfaced as a thrown Error so the handler\n * converts it to an `Error:` string.\n */\nconst runInputPipeline = async (\n  mw: Middleware<SearxngInputMiddlewareFn>,\n  ctx: SearxngRequestContext\n): Promise<string | undefined> => {\n  let reached = false\n  let shortResult: string | undefined\n  let caught: unknown\n  await mw\n    .runner()\n    .errorHandler(async (error: unknown) => {\n      caught = error\n    })\n    .finalHandler(async () => {\n      reached = true\n    })\n    .run((fn, next) => Promise.resolve(fn(ctx, next)))\n\n  if (caught !== undefined) {\n    if (isShortCircuit(caught)) {\n      shortResult = caught.result\n    } else {\n      throw caught\n    }\n  } else if (!reached) {\n    throw new Error('SearXNG input pipeline did not call next() and did not short-circuit.')\n  }\n  return shortResult\n}\n\n/** Run the output pipeline; rethrow any stage error to the handler's try/catch. */\nconst runOutputPipeline = async (\n  mw: Middleware<SearxngOutputMiddlewareFn>,\n  ctx: SearxngResponseContext\n): Promise<void> => {\n  let reached = false\n  let caught: unknown\n  await mw\n    .runner()\n    .errorHandler(async (error: unknown) => {\n      caught = error\n    })\n    .finalHandler(async () => {\n      reached = true\n    })\n    .run((fn, next) => Promise.resolve(fn(ctx, next)))\n\n  if (caught !== undefined) throw caught\n  if (!reached) {\n    throw new Error('SearXNG output pipeline did not call next().')\n  }\n}\n"],"mappings":"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"}