@kindgi/agents 0.0.0-bootstrap.0 → 0.1.0

package/dist/handlers/dispatch-tools.js

@@ -0,0 +1,511 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { WaitpointCancelledError } from '@kindgi/handler';
+import { stricterToolHitlRule } from '@kindgi/policy-contract';
+import { invokeTool } from '@kindgi/tools';
+import { emitTurnEvent } from '../streaming.js';
+import { throwAgentTurnFailure, } from './errors.js';
+import { effectiveToolErrorPolicy, toolErrorKindOf, toolErrorResult, toolRetriesSoFar, } from './tool-errors.js';
+import { computeToolCallWaitToken, hashToolArgs } from './tool-hitl.js';
+/**
+ * Resolves the effective HITL mode + reviewer role for a specific
+ * tool from the pre-resolved effective policy. Mirrors the standalone
+ * `resolveToolHitl(agent, tool)` in tool-hitl.ts but consumes the
+ * resolver's output.
+ */
+function resolveEffectiveToolHitl(effective, tool) {
+    const gate = agentToolHitl(effective, tool);
+    // The tenant's floor for this tool, when it names one: the stricter wins.
+    const floor = effective.toolFloors?.get(tool.id);
+    if (floor === undefined)
+        return gate;
+    const stricter = stricterToolHitlRule(gate, floor);
+    return { mode: stricter.mode, requiredRole: stricter.requiredRole ?? gate.requiredRole };
+}
+/** The agent's own gate for `tool`. */
+function agentToolHitl(effective, tool) {
+    const toolsPolicy = effective.tools;
+    const defaultRole = effective.defaultReviewerRole;
+    // Opt-in: no `hitl.tools` block → never gate.
+    if (toolsPolicy === undefined) {
+        return { mode: 'never_ask', requiredRole: defaultRole };
+    }
+    const rawOverride = toolsPolicy.overrides.get(tool.id);
+    if (rawOverride !== undefined) {
+        const rule = typeof rawOverride === 'string'
+            ? { mode: rawOverride }
+            : rawOverride;
+        return {
+            mode: rule.mode,
+            requiredRole: rule.requiredRole ?? defaultRole,
+        };
+    }
+    if (toolsPolicy.default !== undefined) {
+        return { mode: toolsPolicy.default, requiredRole: defaultRole };
+    }
+    // Per-tool default from Tool.mutating (opt-in scope only).
+    const mode = tool.mutating === false ? 'never_ask' : 'ask_on_first_use';
+    return { mode, requiredRole: defaultRole };
+}
+/**
+ * Loop-body node #2. If the model returned `finishReason='tool-use'`
+ * with a non-empty tool-call list, persist the assistant tool-call
+ * message + dispatch every tool + persist every tool result. Update
+ * `nextMessages` so the next iteration's model call sees the tool
+ * outputs.
+ *
+ * When the model returned a terminal `finishReason` (or `tool-use`
+ * with no calls), pass through unchanged so
+ * `budget-check` marks the iteration finished.
+ */
+export function buildDispatchToolsHandler(ctx) {
+    return async (input, kctx) => {
+        if (ctx.tools === undefined) {
+            throwAgentTurnFailure({
+                code: 'model-invocation-failed',
+                message: 'dispatch-tools invoked before setup completed',
+                cause: null,
+            });
+        }
+        const partial = input;
+        const assistantMsg = partial.message;
+        const hasToolCalls = partial.finishReason === 'tool-use' &&
+            assistantMsg.toolCalls !== undefined &&
+            assistantMsg.toolCalls.length > 0;
+        if (!hasToolCalls) {
+            // No tool calls this iteration — pass through. `budget-check`
+            // will finalize with `finishedTurn=true` and the loop exits.
+            const forwarded = {
+                step: partial.step,
+                finishReason: partial.finishReason,
+                message: assistantMsg,
+                iterationAppended: [],
+                iterationUsage: partial.iterationUsage,
+                provider: partial.provider,
+                nextMessages: partial.nextMessages,
+                hasToolCalls: false,
+            };
+            return forwarded;
+        }
+        const iterationAppended = [
+            await persistToolCallMessage(ctx, assistantMsg, partial.step),
+        ];
+        let nextMessages = [...partial.nextMessages, assistantMsg];
+        for (const call of assistantMsg.toolCalls ?? []) {
+            // Resumed after an approval further down this list: a call that
+            // already ran keeps the result it stored.
+            const stored = takeStoredBeforePark(ctx, (m) => m.role === 'tool' && m.toolCall?.invocationId === call.id);
+            if (stored !== undefined) {
+                iterationAppended.push(stored);
+                nextMessages = [...nextMessages, toolMessageOf(stored, call.id)];
+                continue;
+            }
+            // Look up the resolved binding before emitting `tool.started` so
+            // the event can carry `toolVersion` + `toolVersionRange` alongside
+            // the id. Model-requested tools the
+            // agent didn't declare emit a bare `tool.failed` with no version.
+            const binding = ctx.tools.byName.get(call.name);
+            if (binding === undefined) {
+                const unresolved = {
+                    code: 'unresolved-tool',
+                    message: `Model requested tool "${call.name}" not registered for agent "${ctx.input.agent.id}"`,
+                    toolId: call.name,
+                };
+                await emitTurnEvent(ctx.bindings.onEvent, {
+                    kind: 'tool.failed',
+                    step: partial.step,
+                    toolId: call.name,
+                    invocationId: call.id,
+                    error: { code: unresolved.code, message: unresolved.message },
+                });
+                nextMessages = await retryOrFail(ctx, call, unresolved, undefined, {
+                    toolId: call.name,
+                    nextMessages,
+                    iterationAppended,
+                });
+                continue;
+            }
+            const { tool, resolvedVersion, requestedRange } = binding;
+            // Tool-level HITL gate. Resolves the effective mode
+            // for this (agent, tool) pair via the effective-policy
+            // resolver (framework defaults → agent → tenant cap), then parks +
+            // enqueues an approval when required BEFORE dispatch. On reject,
+            // returns a synthetic negative tool result so the LLM can adapt
+            // without terminating the run. Same run, same conversation, same
+            // provenance record across the park-and-resume — the same
+            // framework guarantee as the session-level gate.
+            //
+            // Kernel replay: within one run, waitForToken with the same
+            // deterministic tokenId returns the resolved decision from the
+            // journal — no re-park. Cross-turn `ask_on_first_use` caching
+            // (via conversation metadata) is not implemented.
+            const effectiveHitl = ctx.hitlPolicy;
+            if (effectiveHitl === undefined) {
+                throwAgentTurnFailure({
+                    code: 'model-invocation-failed',
+                    message: 'dispatch-tools invoked before the turn resolved its approval rules',
+                    cause: null,
+                });
+            }
+            const resolvedHitl = resolveEffectiveToolHitl(effectiveHitl, tool);
+            let toolRejectionPayload = null;
+            if (resolvedHitl.mode !== 'never_ask') {
+                const argsHash = hashToolArgs(call.arguments);
+                const waitTokenId = computeToolCallWaitToken({
+                    runId: kctx.runId,
+                    callId: call.id,
+                    argsHash,
+                });
+                const timeoutMs = effectiveHitl.timeoutMs;
+                const expiresAt = new Date(Date.now() + timeoutMs).toISOString();
+                if (ctx.bindings.hitl?.enqueue !== undefined) {
+                    try {
+                        await ctx.bindings.hitl.enqueue({
+                            tenantId: ctx.input.tenantId,
+                            subjectKind: 'tool-call:pending',
+                            subjectRef: {
+                                conversationId: ctx.input.conversationId,
+                                agentId: ctx.input.agent.id,
+                                agentVersion: ctx.input.agent.version,
+                                toolId: tool.id,
+                                toolVersion: resolvedVersion,
+                                callId: call.id,
+                                argsHash,
+                                arguments: call.arguments,
+                            },
+                            requiredRole: resolvedHitl.requiredRole,
+                            title: `HITL review: ${call.name}`,
+                            description: `Tool call ${call.name} awaiting reviewer approval before dispatch.`,
+                            waitTokenId,
+                            provenanceRef: { runId: kctx.runId },
+                            expiresAt: expiresAt,
+                        });
+                    }
+                    catch {
+                        // Enqueue failure is soft — waitForToken parks either way.
+                    }
+                }
+                try {
+                    const decision = await kctx.waitForToken(waitTokenId, {
+                        timeoutMs,
+                    });
+                    if (decision.decided === 'reject') {
+                        toolRejectionPayload =
+                            decision.rationale !== undefined ? { rationale: decision.rationale } : {};
+                    }
+                    // approve → fall through to dispatch
+                }
+                catch (cause) {
+                    if (cause instanceof WaitpointCancelledError) {
+                        throwAgentTurnFailure({
+                            code: 'hitl-cancelled',
+                            message: `Tool-call HITL cancelled for ${call.name}: ${cause.reason}`,
+                            reason: cause.reason,
+                        });
+                    }
+                    throw cause;
+                }
+            }
+            const toolStarted = Date.now();
+            await emitTurnEvent(ctx.bindings.onEvent, {
+                kind: 'tool.started',
+                step: partial.step,
+                toolId: call.name,
+                toolVersion: resolvedVersion,
+                toolVersionRange: requestedRange,
+                invocationId: call.id,
+                arguments: call.arguments,
+            });
+            // If the reviewer rejected, synthesize a tool-result message
+            // carrying the rationale — the LLM reads it in the next
+            // iteration and can adapt (retry with different args, ask the
+            // user, apologize). NOT a run failure — reject is feedback, not
+            // termination.
+            if (toolRejectionPayload !== null) {
+                const rejectResult = {
+                    status: 'rejected',
+                    ...(toolRejectionPayload.rationale !== undefined && {
+                        rationale: toolRejectionPayload.rationale,
+                    }),
+                };
+                nextMessages = await appendToolResult(ctx, call, rejectResult, {
+                    toolId: tool.id,
+                    nextMessages,
+                    iterationAppended,
+                });
+                await emitTurnEvent(ctx.bindings.onEvent, {
+                    kind: 'tool.completed',
+                    step: partial.step,
+                    toolId: call.name,
+                    toolVersion: resolvedVersion,
+                    toolVersionRange: requestedRange,
+                    invocationId: call.id,
+                    output: rejectResult,
+                    durationMs: Date.now() - toolStarted,
+                });
+                continue;
+            }
+            const dispatched = await dispatchOne(ctx, tool, call, kctx.runId);
+            if (dispatched.kind === 'err') {
+                await emitTurnEvent(ctx.bindings.onEvent, {
+                    kind: 'tool.failed',
+                    step: partial.step,
+                    toolId: call.name,
+                    invocationId: call.id,
+                    error: {
+                        code: dispatched.error.code,
+                        message: dispatched.error.message,
+                    },
+                });
+                nextMessages = await retryOrFail(ctx, call, dispatched.error, dispatched.error.validationIssues, { toolId: tool.id, nextMessages, iterationAppended });
+                continue;
+            }
+            ctx.appended.push(dispatched.value.persisted);
+            iterationAppended.push(dispatched.value.persisted);
+            nextMessages = [...nextMessages, dispatched.value.toolMessage];
+            await emitTurnEvent(ctx.bindings.onEvent, {
+                kind: 'tool.completed',
+                step: partial.step,
+                toolId: call.name,
+                toolVersion: resolvedVersion,
+                toolVersionRange: requestedRange,
+                invocationId: call.id,
+                output: dispatched.value.persisted.content,
+                durationMs: Date.now() - toolStarted,
+            });
+            if (ctx.provenance !== undefined) {
+                const modelCallNodeId = `model-call:${partial.step}`;
+                const toolCallNodeId = `tool-call:${call.id}`;
+                const toolResultNodeId = `tool-result:${call.id}`;
+                ctx.provenance.addNode({
+                    id: toolCallNodeId,
+                    kind: 'tool-call',
+                    timestamp: dispatched.value.persisted.createdAt,
+                    attributes: {
+                        toolId: call.name,
+                        invocationId: call.id,
+                        // Capture the exact version the
+                        // registry picked at run start + the range the agent asked
+                        // for, so a replay can pin against the same version.
+                        toolVersion: resolvedVersion,
+                        toolVersionRange: requestedRange,
+                    },
+                });
+                ctx.provenance.addNode({
+                    id: toolResultNodeId,
+                    kind: 'tool-result',
+                    timestamp: dispatched.value.persisted.createdAt,
+                });
+                ctx.provenance.addEdge({
+                    from: toolCallNodeId,
+                    to: modelCallNodeId,
+                    kind: 'invoked',
+                });
+                ctx.provenance.addEdge({
+                    from: toolResultNodeId,
+                    to: toolCallNodeId,
+                    kind: 'produced',
+                });
+            }
+        }
+        const forwarded = {
+            step: partial.step,
+            finishReason: partial.finishReason,
+            message: assistantMsg,
+            iterationAppended,
+            iterationUsage: partial.iterationUsage,
+            provider: partial.provider,
+            nextMessages,
+            hasToolCalls: true,
+        };
+        return forwarded;
+    };
+}
+/**
+ * Store the assistant message that makes the calls — or, resumed after a
+ * park in this step, take the one stored before the park.
+ */
+async function persistToolCallMessage(ctx, assistantMsg, step) {
+    const callIds = (assistantMsg.toolCalls ?? []).map((tc) => tc.id);
+    const stored = takeStoredBeforePark(ctx, (m) => m.role === 'agent' && sameCalls(m, callIds));
+    if (stored !== undefined)
+        return stored;
+    const persisted = await ctx.bindings.conversationBinding.appendMessage({
+        tenantId: ctx.input.tenantId,
+        conversationId: ctx.input.conversationId,
+        role: 'agent',
+        content: {
+            text: assistantMsg.content,
+            toolCalls: (assistantMsg.toolCalls ?? []).map((tc) => ({ ...tc })),
+        },
+        actor: ctx.input.agent.id,
+        isIntermediate: true,
+    });
+    if (persisted.kind === 'err')
+        throwAgentTurnFailure(persisted.error);
+    ctx.appended.push(persisted.value);
+    await emitTurnEvent(ctx.bindings.onEvent, {
+        kind: 'agent.message',
+        step,
+        isFinal: false,
+        message: persisted.value,
+    });
+    return persisted.value;
+}
+/** Take the first message stored before the park that matches. */
+function takeStoredBeforePark(ctx, matches) {
+    const index = ctx.storedBeforePark?.findIndex(matches) ?? -1;
+    if (index < 0)
+        return undefined;
+    return ctx.storedBeforePark?.splice(index, 1)[0];
+}
+function sameCalls(m, callIds) {
+    const calls = m.content
+        .toolCalls;
+    return (Array.isArray(calls) &&
+        calls.length === callIds.length &&
+        calls.every((c, i) => c.id === callIds[i]));
+}
+/** A stored tool result, as the model sees it. */
+function toolMessageOf(stored, callId) {
+    return {
+        role: 'tool',
+        content: typeof stored.content === 'string' ? stored.content : JSON.stringify(stored.content),
+        toolCallId: callId,
+    };
+}
+/**
+ * Record a result the framework writes for a call (a rejection, a failed
+ * call sent back to the model) the way a tool's own result is recorded:
+ * persisted to the conversation with the call it answers, and added to
+ * the messages the next model call sees.
+ */
+async function appendToolResult(ctx, call, output, target) {
+    const persisted = await ctx.bindings.conversationBinding.appendMessage({
+        tenantId: ctx.input.tenantId,
+        conversationId: ctx.input.conversationId,
+        role: 'tool',
+        content: output,
+        toolCall: { toolId: target.toolId, invocationId: call.id },
+    });
+    if (persisted.kind === 'err')
+        throwAgentTurnFailure(persisted.error);
+    ctx.appended.push(persisted.value);
+    target.iterationAppended.push(persisted.value);
+    return [
+        ...target.nextMessages,
+        { role: 'tool', content: JSON.stringify(output), toolCallId: call.id },
+    ];
+}
+/**
+ * A failed call the turn's policy retries goes back to the model as its
+ * result, while retries are left; anything else fails the turn, with the
+ * retries it took when the kind is one the policy retries.
+ */
+async function retryOrFail(ctx, call, error, issues, target) {
+    const policy = ctx.toolErrorPolicy ?? effectiveToolErrorPolicy(ctx.input.agent.toolErrors, undefined);
+    const kind = toolErrorKindOf(error);
+    const used = toolRetriesSoFar(target.nextMessages);
+    if (!policy.retryOn.has(kind))
+        throwAgentTurnFailure(error);
+    if (used >= policy.maxRetries)
+        throwAgentTurnFailure({ ...error, toolRetries: used });
+    return appendToolResult(ctx, call, toolErrorResult(kind, error.message, issues), target);
+}
+async function dispatchOne(ctx, tool, call, runId) {
+    const toolCtx = {
+        tenantId: ctx.input.tenantId,
+        runId,
+        requestId: call.id,
+        abortSignal: ctx.turnAbort.signal,
+        // HTTP tools built via defineTool({spec: {kind: 'http'}}) resolve declared
+        // secret_refs at invoke time. Present iff the caller wired
+        // `bindings.resolveSecret` from a tenant-scoped `SecretBinding`.
+        ...(ctx.bindings.resolveSecret !== undefined && { resolveSecret: ctx.bindings.resolveSecret }),
+    };
+    const result = await invokeTool(tool, call.arguments, toolCtx);
+    if (result.kind === 'err') {
+        // Hoist AJV validation detail from the inner error so it survives
+        // `toWireError` (which filters `cause` to avoid Error-instance /
+        // cycle hazards). Two validation paths emit different field names
+        // for the AJV array:
+        //   - `packages/handler-runtime/src/handler-runner.ts` (pack code,
+        //     run by the pack service) → `issues`
+        //   - `packages/tools/src/invoke.ts` (in-process dispatch) → `errors`
+        // Accept either. If neither shape is present, no hoisting —
+        // the outer `tool-invocation-failed` stays minimal.
+        const inner = result.error;
+        const rawIssues = Array.isArray(inner.issues)
+            ? inner.issues
+            : Array.isArray(inner.errors)
+                ? inner.errors
+                : undefined;
+        const isValidationFailure = inner.code === 'input-validation-failed' && rawIssues !== undefined;
+        return {
+            kind: 'err',
+            error: {
+                code: 'tool-invocation-failed',
+                message: result.error.message,
+                toolId: call.name,
+                cause: result.error,
+                ...(isValidationFailure && {
+                    validationIssues: rawIssues,
+                    receivedInput: truncateForWire(call.arguments),
+                }),
+            },
+        };
+    }
+    const persist = await ctx.bindings.conversationBinding.appendMessage({
+        tenantId: ctx.input.tenantId,
+        conversationId: ctx.input.conversationId,
+        role: 'tool',
+        content: result.value ?? '',
+        toolCall: { toolId: tool.id, invocationId: call.id },
+    });
+    if (persist.kind === 'err') {
+        // A DB failure persisting the tool result surfaces as the more
+        // generic invocation-failed to keep the caller's error shape stable.
+        return {
+            kind: 'err',
+            error: {
+                code: 'tool-invocation-failed',
+                message: persist.error.message,
+                toolId: tool.id,
+                cause: persist.error,
+            },
+        };
+    }
+    return {
+        kind: 'ok',
+        value: {
+            persisted: persist.value,
+            toolMessage: {
+                role: 'tool',
+                content: typeof result.value === 'string' ? result.value : JSON.stringify(result.value),
+                toolCallId: call.id,
+            },
+        },
+    };
+}
+/**
+ * Cap `receivedInput` on validation errors so a huge tool-arg blob
+ * doesn't bloat the wire response body. 4 KiB stringified is
+ * comfortably larger than a typical LLM tool-call payload
+ * (place-name, query, message) but small enough that a
+ * pathological array/document truncates rather than round-trips
+ * megabytes. Truncated payloads land as a string with a trailing
+ * marker so callers can tell the value was elided.
+ */
+function truncateForWire(input, maxBytes = 4096) {
+    let serialized;
+    try {
+        serialized = JSON.stringify(input);
+    }
+    catch {
+        return '<unserializable input>';
+    }
+    if (Buffer.byteLength(serialized, 'utf8') <= maxBytes)
+        return input;
+    return `${serialized.slice(0, maxBytes)}… (truncated at ${maxBytes} bytes)`;
+}
+//# sourceMappingURL=dispatch-tools.js.map

package/dist/handlers/dispatch-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-tools.js","sourceRoot":"","sources":["../../src/handlers/dispatch-tools.ts"],"names":[],"mappings":"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"}

package/dist/handlers/errors.d.ts

@@ -0,0 +1,133 @@
+import type { EvaluationResult } from '@kindgi/guardrails';
+import type { PolicyKind } from '@kindgi/policy-contract';
+import type { AgentError } from '../errors.js';
+import type { GuardrailViolationError, HitlRequiredError, UnresolvedGuardrailError } from '../guardrails-gate.js';
+/** Structured error returned to the caller when an agent turn fails. */
+export type InvokeAgentError = AgentError | UnresolvedToolError | ToolVersionUnresolvableError | CapabilityRoutingError | ModelInvocationError | ToolInvocationError | BudgetExceededError | AgentTurnAbortedError | HitlRequiredError | GuardrailViolationError | UnresolvedGuardrailError | OutputSchemaViolationError | TenantPolicyUnavailableError;
+/**
+ * A tenant policy the turn must apply couldn't be: its spec doesn't
+ * validate, or the policy registry failed. The turn doesn't run without
+ * it — skipping a tenant's `hitl` policy would skip its approvals.
+ */
+export interface TenantPolicyUnavailableError {
+    readonly code: 'tenant-policy-unavailable';
+    readonly message: string;
+    readonly policyKind: PolicyKind;
+}
+export interface UnresolvedToolError {
+    readonly code: 'unresolved-tool';
+    readonly message: string;
+    readonly toolId: string;
+    /**
+     * Failed tool calls sent back to the model this turn before this one
+     * ended it (see `Agent.toolErrors`). Present when the failure is a
+     * kind the turn retries and its retries ran out.
+     */
+    readonly toolRetries?: number;
+}
+/**
+ * The agent references a tool that is registered but whose semver range
+ * does not match any registered version, or whose range is grammatically
+ * broken. Distinct from `unresolved-tool` (no id registered).
+ */
+export interface ToolVersionUnresolvableError {
+    readonly code: 'tool-version-unresolvable';
+    readonly message: string;
+    readonly toolId: string;
+    readonly requestedRange: string;
+    readonly availableVersions?: readonly string[];
+}
+export interface CapabilityRoutingError {
+    readonly code: 'capability-routing-failed';
+    readonly message: string;
+    readonly cause: unknown;
+}
+export interface ModelInvocationError {
+    readonly code: 'model-invocation-failed';
+    readonly message: string;
+    readonly cause: unknown;
+}
+export interface ToolInvocationError {
+    readonly code: 'tool-invocation-failed';
+    readonly message: string;
+    readonly toolId: string;
+    readonly cause: unknown;
+    /**
+     * When the inner failure was an AJV input-schema validation, the
+     * validator's `errors[]` array. Hoisted from `cause` to the top
+     * level so it survives `toWireError` (which filters `cause` to
+     * avoid Error-instance / cycle serialization hazards). Consumers
+     * inspecting *which* field failed *how* read this; `fromWire` in
+     * `@kindgi/client` projects it back onto the client-side error.
+     */
+    readonly validationIssues?: readonly Readonly<Record<string, unknown>>[];
+    /**
+     * The exact payload the model produced that failed validation.
+     * Included so authors debugging LLM-tool-arg drift can see whether
+     * the model sent `{}`, `{ location: "" }`, `{ city: "…" }`
+     * (wrong field name), etc. without instrumenting their handler.
+     * Size-capped at ~4KiB stringified — larger payloads truncate
+     * with a trailing `…`; sensitive tools should sanitize inputs
+     * upstream.
+     */
+    readonly receivedInput?: unknown;
+    /**
+     * Failed tool calls sent back to the model this turn before this one
+     * ended it (see `Agent.toolErrors`). Present when the failure is a
+     * kind the turn retries and its retries ran out.
+     */
+    readonly toolRetries?: number;
+}
+export interface BudgetExceededError {
+    readonly code: 'budget-exceeded';
+    readonly message: string;
+    readonly kind: 'steps' | 'cost' | 'wall-time';
+    readonly limit: number;
+    readonly observed: number;
+}
+/**
+ * The agent declares an `output` schema and its final answer still
+ * didn't fit after the allowed repairs. `errors` lists the last
+ * attempt's problems; `attempts` counts the answers checked.
+ */
+export interface OutputSchemaViolationError {
+    readonly code: 'output-schema-violation';
+    readonly message: string;
+    readonly errors: readonly string[];
+    readonly attempts: number;
+}
+export interface AgentTurnAbortedError {
+    readonly code: 'agent-turn-aborted';
+    readonly message: string;
+    readonly reason: 'external' | 'timeout';
+}
+/**
+ * Thrown by a node handler when a precondition fails or a runtime step
+ * short-circuits with a structured error. The kernel captures
+ * `Error.message` into `step.failed.payload.message`; we serialize the
+ * full structured error as JSON so `projectRunResult` can recover the
+ * discriminated union shape on the way out.
+ *
+ * Deliberately narrowed to `Error` subclass so `cause` becomes a plain
+ * property (JSON-round-trippable) instead of the native ErrorOptions
+ * behavior.
+ */
+export declare class AgentTurnFailure extends Error {
+    readonly payload: InvokeAgentError;
+    constructor(payload: InvokeAgentError);
+}
+/**
+ * Attempt to reconstruct a structured `InvokeAgentError` from a run's
+ * `failureMessage`. Returns `undefined` when the message is not one of
+ * ours (e.g. a raw kernel-level exception message).
+ */
+export declare function parseFailureMessage(raw: string | undefined): InvokeAgentError | undefined;
+/** Helper for handlers to short-circuit with a structured error. */
+export declare function throwAgentTurnFailure(error: InvokeAgentError): never;
+/**
+ * Placeholder to satisfy TS-strict "declared but unused" on
+ * `EvaluationResult` in ambient imports elsewhere; the type is used
+ * transitively via `GuardrailViolationError`.
+ */
+export type _EvaluationResultAlias = EvaluationResult;
+//# sourceMappingURL=errors.d.ts.map