@cuylabs/agent-core 4.9.0 → 5.0.0

package/dist/execution/turn/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/turn/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,EACd,yBAAyB,EACzB,cAAc,EACd,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,qCAAqC,EACrC,6BAA6B,EAC7B,8BAA8B,EAC9B,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,6BAA6B,EAC7B,qCAAqC,GACtC,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACrB,MAAM,4BAA4B,CAAC"}

package/dist/execution/turn/index.js

@@ -0,0 +1,52 @@
+import {
+  AgentTurnEngine,
+  ContextOverflowError,
+  DoomLoopError,
+  commitOutput,
+  commitStep,
+  createAgentTurnEngine,
+  createAgentTurnStepCommitBatch,
+  prepareModelStep,
+  processStepStream,
+  runModelStep,
+  runToolBatch
+} from "../../chunk-346FIYKT.js";
+import {
+  AgentTurnStateConflictError,
+  advanceAgentTurnState,
+  createAgentTurnState,
+  failAgentTurnState,
+  getCurrentAgentTurnStepRecord,
+  mergeAgentTurnStateProgress
+} from "../../chunk-E66PKKDL.js";
+import "../../chunk-DYZGHHDB.js";
+import "../../chunk-CGP6UNCQ.js";
+import "../../chunk-K453AFTL.js";
+import "../../chunk-STDJYXYK.js";
+import "../../chunk-JUIL2NJC.js";
+import "../../chunk-AHDCR7SX.js";
+import "../../chunk-W6LWIMIX.js";
+import "../../chunk-CNM6OROH.js";
+import "../../chunk-I6PKJ7XQ.js";
+import "../../chunk-T33MQXUP.js";
+import "../../chunk-FII65CN7.js";
+import "../../chunk-S6AKEPAX.js";
+export {
+  AgentTurnEngine,
+  AgentTurnStateConflictError,
+  ContextOverflowError,
+  DoomLoopError,
+  advanceAgentTurnState,
+  commitOutput,
+  commitStep,
+  createAgentTurnEngine,
+  createAgentTurnState,
+  createAgentTurnStepCommitBatch,
+  failAgentTurnState,
+  getCurrentAgentTurnStepRecord,
+  mergeAgentTurnStateProgress,
+  prepareModelStep,
+  processStepStream,
+  runModelStep,
+  runToolBatch
+};

package/dist/execution/turn/runner/commit.d.ts

@@ -0,0 +1,11 @@
+import type { AgentEvent } from "../../../types/events.js";
+import type { CommitOutputOptions, CommitStepOptions } from "./types.js";
+/**
+ * Persist the assistant tool-call message and tool-result messages for a step.
+ */
+export declare function commitStep(options: CommitStepOptions): AsyncGenerator<AgentEvent, boolean>;
+/**
+ * Persist the final assistant output for a turn.
+ */
+export declare function commitOutput(options: CommitOutputOptions): AsyncGenerator<AgentEvent, boolean>;
+//# sourceMappingURL=commit.d.ts.map

package/dist/execution/turn/runner/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/runner/commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,wBAAuB,UAAU,CAC/B,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAqBrC;AAED;;GAEG;AACH,wBAAuB,YAAY,CACjC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAoBrC"}

package/dist/execution/turn/runner/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Turn runner module.
+ *
+ * Split by execution phase:
+ * - `types` defines the runtime contracts for one turn step
+ * - `prepare` translates committed messages into one model-step input
+ * - `stream-step` executes a single streamed model/tool step
+ * - `tool-batch` executes planned tool calls outside the SDK loop
+ * - `commit` persists step/output commits back into message history
+ */
+export type { AgentTurnCommitApplier, AgentTurnCommitOptions, AgentTurnStepRuntimeConfig, AgentTurnToolResultRecord, CommitOutputOptions, CommitStepOptions, PreparedAgentModelStep, PrepareModelStepOptions, RunModelStepOptions, RunToolBatchOptions, RunToolBatchResult, } from "./types.js";
+export { prepareModelStep } from "./prepare.js";
+export { runModelStep } from "./stream-step.js";
+export { runToolBatch } from "./tool-batch.js";
+export { commitOutput, commitStep } from "./commit.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/turn/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/runner/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/execution/turn/runner/prepare.d.ts

@@ -0,0 +1,6 @@
+import type { PrepareModelStepOptions, PreparedAgentModelStep } from "./types.js";
+/**
+ * Prepare the next model step from the current committed messages.
+ */
+export declare function prepareModelStep(options: PrepareModelStepOptions): PreparedAgentModelStep;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/execution/turn/runner/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/runner/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CAmDxB"}

package/dist/execution/turn/runner/stream-step.d.ts

@@ -0,0 +1,8 @@
+import type { AgentEvent } from "../../../types/events.js";
+import { type StepProcessingOutput } from "../step-processing/index.js";
+import type { RunModelStepOptions } from "./types.js";
+/**
+ * Execute exactly one model/tool step and stream its events.
+ */
+export declare function runModelStep(options: RunModelStepOptions): AsyncGenerator<AgentEvent, StepProcessingOutput>;
+//# sourceMappingURL=stream-step.d.ts.map

package/dist/execution/turn/runner/stream-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-step.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/runner/stream-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAG3D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AASrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAyBtD;;GAEG;AACH,wBAAuB,YAAY,CACjC,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAiJlD"}

package/dist/execution/turn/runner/tool-batch.d.ts

@@ -0,0 +1,13 @@
+import type { RunToolBatchOptions, RunToolBatchResult } from "./types.js";
+/**
+ * Execute planned tool calls outside the AI SDK loop.
+ *
+ * When multiple tool calls are pending, the batch is partitioned:
+ *  - Tools that declare `capabilities.parallelSafe` run concurrently
+ *  - All other tools run serially (in original order)
+ *
+ * Serial tools always run after the parallel batch completes, preserving
+ * the invariant that non-parallel-safe tools never overlap with anything.
+ */
+export declare function runToolBatch(options: RunToolBatchOptions): Promise<RunToolBatchResult>;
+//# sourceMappingURL=tool-batch.d.ts.map

package/dist/execution/turn/runner/tool-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-batch.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/runner/tool-batch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAoKpB;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA2F7B"}

package/dist/execution/turn/runner/types.d.ts

@@ -0,0 +1,111 @@
+import type { ModelMessage, ToolSet } from "ai";
+import type { TelemetryOptions } from "ai";
+import type { Tool } from "../../../tool/tool.js";
+import type { ToolHost } from "../../../tool/host/types.js";
+import type { HumanInputController } from "../../../human/controller.js";
+import type { MiddlewareRunner } from "../../../middleware/runner.js";
+import type { InterventionController } from "../../../intervention/intervention.js";
+import type { ReasoningLevel } from "../../../models/reasoning/index.js";
+import type { AgentEvent } from "../../../types/events.js";
+import type { Message } from "../../../types/messages.js";
+import type { DoomLoopHandler } from "../../../types/doom-loop.js";
+import type { TurnTrackerContext } from "../../../types/tool.js";
+import type { AgentConfig } from "../../../agent/types/index.js";
+import type { StepProcessingOutput } from "../step-processing/index.js";
+import type { AgentTurnCommitBatch, AgentTurnEngine, AgentTurnStepCommitSnapshot, AgentTurnStepCommitToolResult } from "../engine/index.js";
+import type { AgentTurnState } from "../state.js";
+import type { ToolExecutionMode } from "../../../inference/index.js";
+import type { InferenceStreamInput } from "../../../inference/index.js";
+import type { ModelContextAssemblyReport } from "../../../context/assembly/index.js";
+export interface AgentTurnCommitOptions {
+    emitMessages?: boolean;
+}
+export type AgentTurnCommitApplier = (batch: AgentTurnCommitBatch, options?: AgentTurnCommitOptions) => AsyncGenerator<AgentEvent>;
+/**
+ * Narrowed runtime config for a single agent turn step.
+ *
+ * Derived via `Pick` from `AgentConfig` so that field additions
+ * propagate automatically and types cannot drift.
+ */
+export type AgentTurnStepRuntimeConfig = Required<Pick<AgentConfig, "model" | "cwd" | "maxSteps">> & Pick<AgentConfig, "temperature" | "topP" | "maxOutputTokens" | "doomLoopThreshold" | "enforceDoomLoop" | "onDoomLoop" | "contextWindow" | "streamProvider"> & {
+    reserveTokens?: number;
+    telemetry?: TelemetryOptions;
+};
+export interface PrepareModelStepOptions {
+    sessionId: string;
+    turnId?: string;
+    step: number;
+    systemPrompts: string[];
+    messages: Message[];
+    contextReport?: ModelContextAssemblyReport;
+    toModelMessages: (messages: Message[]) => ModelMessage[];
+    abort: AbortSignal;
+    tools: Record<string, Tool.Info>;
+    mcpTools?: ToolSet;
+    config: AgentTurnStepRuntimeConfig;
+    host?: ToolHost;
+    humanInputController?: HumanInputController;
+    turnTracker?: TurnTrackerContext;
+    intervention?: InterventionController;
+    middleware?: MiddlewareRunner;
+    reasoningLevel?: ReasoningLevel;
+    toolExecutionMode?: ToolExecutionMode;
+}
+export interface PreparedAgentModelStep {
+    step: number;
+    messages: Message[];
+    contextReport?: ModelContextAssemblyReport;
+    modelMessages: ModelMessage[];
+    inferenceInput: InferenceStreamInput;
+    stepProcessing: {
+        maxSteps: number;
+        doomLoopThreshold?: number;
+        enforceDoomLoop?: boolean;
+        onDoomLoop?: DoomLoopHandler;
+        contextTokenLimit?: number;
+    };
+}
+export interface RunModelStepOptions {
+    preparedStep: PreparedAgentModelStep;
+    turnEngine: AgentTurnEngine;
+    applyCommitBatch: AgentTurnCommitApplier;
+    rememberedDoomLoopTools?: Set<string>;
+    deferErrorEvent?: (error: Error) => boolean;
+}
+export interface CommitStepOptions {
+    step: number;
+    finishReason?: string;
+    turnEngine: AgentTurnEngine;
+    applyCommitBatch: AgentTurnCommitApplier;
+}
+export interface CommitOutputOptions {
+    text: string;
+    usage?: StepProcessingOutput["usage"];
+    turnEngine: AgentTurnEngine;
+    applyCommitBatch: AgentTurnCommitApplier;
+}
+export interface RunToolBatchOptions {
+    sessionId: string;
+    snapshot: AgentTurnStepCommitSnapshot;
+    tools: Record<string, Tool.Info>;
+    cwd: string;
+    abort: AbortSignal;
+    host?: ToolHost;
+    humanInputController?: HumanInputController;
+    turnTracker?: TurnTrackerContext;
+    middleware?: MiddlewareRunner;
+    turnState?: AgentTurnState;
+    /**
+     * When provided, the batch runner checks for pending interventions
+     * between tool executions. Tools with `onInterrupt: "cancel"` will
+     * be aborted when a user message arrives mid-batch.
+     */
+    intervention?: InterventionController;
+}
+export interface RunToolBatchResult {
+    snapshot: AgentTurnStepCommitSnapshot;
+    turnState?: AgentTurnState;
+    events: AgentEvent[];
+}
+export type AgentTurnToolResultRecord = Map<string, AgentTurnStepCommitToolResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/turn/runner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/runner/types.ts"],"names":[],"mappings":"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"}

package/dist/execution/turn/state.d.ts

@@ -0,0 +1,110 @@
+import type { AgentEvent, AgentTurnBoundaryKind } from "../../types/events.js";
+import type { TokenUsage } from "../../types/messages.js";
+import type { NormalizedToolReplayPolicy, ToolMetadata } from "../../types/tool.js";
+import { type AgentTurnStepRecord, type AgentTurnStepToolResultCaptureOptions } from "./step-ledger.js";
+export type AgentTurnPhase = "initializing" | "committing-input" | "running-model" | "running-tools" | "committing-step" | "committing-output" | "completed" | "failed";
+export interface AgentTurnBoundarySnapshot {
+    kind: AgentTurnBoundaryKind;
+    createdAt: string;
+    step?: number;
+    messageRole?: "system" | "user" | "assistant" | "tool";
+    pendingToolCallCount?: number;
+}
+export interface AgentTurnActiveToolCall {
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    startedAt: string;
+    replayPolicy?: NormalizedToolReplayPolicy;
+}
+export interface AgentTurnResolvedToolCall {
+    toolCallId: string;
+    toolName: string;
+    outcome: "result" | "error";
+    value: unknown;
+    metadata?: ToolMetadata;
+    resolvedAt: string;
+    replayPolicy?: NormalizedToolReplayPolicy;
+}
+/**
+ * Neutral state model for a single in-flight agent turn.
+ *
+ * This is intentionally infrastructure-agnostic. Runtime adapters can persist
+ * or inspect it without coupling `agent-core` to Dapr, queues, or workflow
+ * engines. The current shape is suitable for durable tracking and forms the
+ * basis for future workflow-level resume support.
+ */
+export interface AgentTurnState {
+    sessionId: string;
+    phase: AgentTurnPhase;
+    step: number;
+    maxSteps?: number;
+    response: string;
+    usage: TokenUsage;
+    eventCount: number;
+    activeToolCalls: AgentTurnActiveToolCall[];
+    resolvedToolCalls: AgentTurnResolvedToolCall[];
+    /**
+     * Per-step execution ledger used by direct and durable runtimes to explain
+     * what happened at each model/tool/commit boundary. Older persisted
+     * snapshots may not have this field.
+     */
+    stepLedger?: AgentTurnStepRecord[];
+    lastFinishReason?: string;
+    lastBoundary?: AgentTurnBoundarySnapshot;
+    lastEvent?: AgentEvent;
+    error?: string;
+    startedAt: string;
+    updatedAt: string;
+}
+export interface CreateAgentTurnStateOptions {
+    sessionId: string;
+    startedAt: string;
+    /**
+     * Optional prior state to restore from. When provided, the turn starts
+     * with accumulated response, usage, step, and event counters from a
+     * previous execution rather than zero.
+     *
+     * This is used by runtime providers for direct-path crash recovery.
+     */
+    restoreFrom?: {
+        response: string;
+        usage: TokenUsage;
+        step: number;
+        eventCount: number;
+    };
+}
+export interface AgentTurnStateAdvanceOptions {
+    toolReplayPolicy?: NormalizedToolReplayPolicy;
+    toolResultCapture?: AgentTurnStepToolResultCaptureOptions;
+}
+/**
+ * Create the initial neutral state for a single agent turn.
+ */
+export declare function createAgentTurnState(options: CreateAgentTurnStateOptions): AgentTurnState;
+/**
+ * Advance neutral turn state from a streamed `AgentEvent`.
+ *
+ * This reducer deliberately models coarse but deterministic boundaries:
+ * step start, tool activity, step finish, completion, and failure. Runtime
+ * adapters can persist the resulting state now, and future resume-capable
+ * engines can build on the same state transitions.
+ */
+export declare function advanceAgentTurnState(state: AgentTurnState, event: AgentEvent, updatedAt: string, options?: AgentTurnStateAdvanceOptions): AgentTurnState;
+/**
+ * Mark the turn as failed when execution aborts without a terminal `error`
+ * event. This covers exceptions thrown by the stream itself or runtime
+ * wrappers around the loop.
+ */
+export declare function failAgentTurnState(state: AgentTurnState, error: Error, updatedAt: string): AgentTurnState;
+/**
+ * Merge two turn-state snapshots that advanced from the same prior step.
+ *
+ * Durable runtimes can execute tool-call activities in parallel. Each activity
+ * may return a `turnState` derived from the same pre-tool snapshot, so blindly
+ * replacing the workflow state would lose tool results recorded by sibling
+ * activities. This helper keeps the latest scalar state from `incoming` while
+ * unioning tool progress and step-ledger entries.
+ */
+export declare function mergeAgentTurnStateProgress(previous: AgentTurnState | undefined, incoming: AgentTurnState): AgentTurnState;
+//# sourceMappingURL=state.d.ts.map

package/dist/execution/turn/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/execution/turn/state.ts"],"names":[],"mappings":"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"}

package/dist/execution/turn/step-ledger.d.ts

@@ -0,0 +1,89 @@
+import type { AgentEvent } from "../../types/events.js";
+import type { TokenUsage } from "../../types/messages.js";
+import type { NormalizedToolReplayPolicy, ToolMetadata } from "../../types/tool.js";
+export type AgentTurnStepStatus = "running" | "waiting-tools" | "completed" | "committing" | "committed" | "failed";
+export type AgentTurnStepToolStatus = "requested" | "succeeded" | "failed" | "denied";
+export type AgentTurnStepCommitKind = "step" | "output";
+export type AgentTurnStepCommitStatus = "committing" | "committed";
+export type AgentTurnStepToolResultFormat = "text" | "json" | "primitive" | "undefined" | "unserializable";
+export type AgentTurnStepToolResultCaptureMode = "preview" | "small" | "full";
+export interface AgentTurnStepToolResultCaptureOptions {
+    /**
+     * `preview` stores only bounded execution evidence. `small` also stores the
+     * raw result when its serialized representation is within
+     * `maxRawResultChars`. `full` stores the raw result without a size guard.
+     */
+    mode?: AgentTurnStepToolResultCaptureMode;
+    maxPreviewChars?: number;
+    maxRawResultChars?: number;
+}
+export interface AgentTurnStepToolResultSummary {
+    resultPreview?: string;
+    resultCharLength?: number;
+    resultTruncated?: boolean;
+    resultFormat?: AgentTurnStepToolResultFormat;
+    result?: unknown;
+}
+export interface AgentTurnStateConflict {
+    kind: "tool-result";
+    step: number;
+    toolCallId: string;
+    toolName: string;
+    previousStatus: AgentTurnStepToolStatus;
+    incomingStatus: AgentTurnStepToolStatus;
+    reason: string;
+}
+export declare class AgentTurnStateConflictError extends Error {
+    readonly conflict: AgentTurnStateConflict;
+    constructor(conflict: AgentTurnStateConflict);
+}
+export interface AgentTurnStepToolRecord {
+    toolCallId: string;
+    toolName: string;
+    args?: unknown;
+    status: AgentTurnStepToolStatus;
+    requestedAt?: string;
+    resolvedAt?: string;
+    /**
+     * Bounded execution evidence. Full model-visible tool output belongs in the
+     * session transcript or step-commit snapshot, not in the ledger by default.
+     */
+    resultPreview?: string;
+    resultCharLength?: number;
+    resultTruncated?: boolean;
+    resultFormat?: AgentTurnStepToolResultFormat;
+    result?: unknown;
+    error?: string;
+    metadata?: ToolMetadata;
+    replayPolicy?: NormalizedToolReplayPolicy;
+}
+export interface AgentTurnStepCommitRecord {
+    kind: AgentTurnStepCommitKind;
+    status: AgentTurnStepCommitStatus;
+    startedAt?: string;
+    finishedAt?: string;
+    messageRole?: "system" | "user" | "assistant" | "tool";
+    pendingToolCallCount?: number;
+}
+export interface AgentTurnStepRecord {
+    step: number;
+    status: AgentTurnStepStatus;
+    startedAt: string;
+    updatedAt: string;
+    text: string;
+    toolCalls: AgentTurnStepToolRecord[];
+    usage?: TokenUsage;
+    finishReason?: string;
+    commit?: AgentTurnStepCommitRecord;
+}
+export interface AgentTurnStepLedgerAdvanceOptions {
+    currentStep?: number;
+    toolReplayPolicy?: NormalizedToolReplayPolicy;
+    toolResultCapture?: AgentTurnStepToolResultCaptureOptions;
+}
+export declare function cloneAgentTurnStepLedger(ledger?: readonly AgentTurnStepRecord[]): AgentTurnStepRecord[];
+export declare function mergeAgentTurnStepLedgers(previous?: readonly AgentTurnStepRecord[], incoming?: readonly AgentTurnStepRecord[]): AgentTurnStepRecord[];
+export declare function getCurrentAgentTurnStepRecord(ledger: readonly AgentTurnStepRecord[] | undefined): AgentTurnStepRecord | undefined;
+export declare function advanceAgentTurnStepLedger(ledger: readonly AgentTurnStepRecord[] | undefined, event: AgentEvent, updatedAt: string, options?: AgentTurnStepLedgerAdvanceOptions): AgentTurnStepRecord[];
+export declare function failAgentTurnStepLedger(ledger: readonly AgentTurnStepRecord[] | undefined, error: Error, updatedAt: string, currentStep?: number): AgentTurnStepRecord[];
+//# sourceMappingURL=step-ledger.d.ts.map

package/dist/execution/turn/step-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-ledger.d.ts","sourceRoot":"","sources":["../../../src/execution/turn/step-ledger.ts"],"names":[],"mappings":"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"}

package/dist/execution/turn/step-processing/doom-loop.d.ts

@@ -0,0 +1,28 @@
+import type { AgentEvent } from "../../../types/events.js";
+import type { StepProcessingOptions } from "./types.js";
+/** Default threshold for doom loop detection. */
+export declare const DEFAULT_DOOM_LOOP_THRESHOLD = 3;
+/**
+ * Doom loop error thrown when repeated tool calls are detected.
+ */
+export declare class DoomLoopError extends Error {
+    readonly toolName: string;
+    readonly repeatCount: number;
+    readonly input: unknown;
+    constructor(toolName: string, repeatCount: number, input: unknown);
+}
+interface ToolCallTracker {
+    toolName: string;
+    inputHash: string;
+}
+export declare function recordToolCallAndCheckDoomLoop(options: {
+    recentToolCalls: Array<ToolCallTracker>;
+    toolName: string;
+    input: unknown;
+    processorOptions: StepProcessingOptions;
+    threshold: number;
+    emitEvent: (event: AgentEvent) => void | Promise<void>;
+    warn?: (message: string) => void;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=doom-loop.d.ts.map

package/dist/execution/turn/step-processing/doom-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doom-loop.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/step-processing/doom-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,iDAAiD;AACjD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CASlE;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEhB"}

package/dist/execution/turn/step-processing/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Turn step-processing module.
+ *
+ * Split by responsibility:
+ * - `types` defines the public step-processing contracts
+ * - `doom-loop` owns repeated tool-call detection
+ * - `overflow` owns context-window overflow signalling
+ * - `process` walks the full stream and emits agent events
+ */
+export type { StepProcessingOptions, StepProcessingOutput } from "./types.js";
+export { DoomLoopError } from "./doom-loop.js";
+export { ContextOverflowError } from "./overflow.js";
+export { processStepStream } from "./process.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/turn/step-processing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/step-processing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/execution/turn/step-processing/overflow.d.ts

@@ -0,0 +1,17 @@
+import type { AgentEvent } from "../../../types/events.js";
+import type { TokenUsage } from "../../../types/index.js";
+import type { StepProcessingOptions } from "./types.js";
+/**
+ * Context overflow error.
+ */
+export declare class ContextOverflowError extends Error {
+    readonly inputTokens: number;
+    readonly limit: number;
+    constructor(inputTokens: number, limit: number);
+}
+export declare function handleContextOverflow(options: {
+    usage: TokenUsage | undefined;
+    processorOptions: StepProcessingOptions;
+    emitEvent: (event: AgentEvent) => void | Promise<void>;
+}): Promise<void>;
+//# sourceMappingURL=overflow.d.ts.map

package/dist/execution/turn/step-processing/overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/step-processing/overflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAM/C;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB"}

package/dist/execution/turn/step-processing/process.d.ts

@@ -0,0 +1,7 @@
+import type { AnyInferenceResult } from "../../../inference/index.js";
+import type { StepProcessingOptions, StepProcessingOutput } from "./types.js";
+/**
+ * Process an inference stream into runtime step events.
+ */
+export declare function processStepStream(stream: AnyInferenceResult, options: StepProcessingOptions): Promise<StepProcessingOutput>;
+//# sourceMappingURL=process.d.ts.map

package/dist/execution/turn/step-processing/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/step-processing/process.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAQtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA0B9E;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAkN/B"}

package/dist/execution/turn/step-processing/types.d.ts

@@ -0,0 +1,65 @@
+import type { AgentEvent, DoomLoopHandler, StepProcessingResult, TokenUsage } from "../../../types/index.js";
+import type { ToolMetadata } from "../../../types/tool.js";
+import type { Logger } from "../../../logger/types.js";
+/**
+ * Options for processing a streamed model result.
+ */
+export interface StepProcessingOptions {
+    /** Session ID (optional - for tracking purposes) */
+    sessionID?: string;
+    /** Abort signal */
+    abort: AbortSignal;
+    /** Normalize provider/runtime errors before emitting them as events */
+    normalizeError?: (error: unknown) => Error;
+    /**
+     * Return true to let the caller handle a normalized error without emitting
+     * the usual status:error and error events from the stream processor.
+     */
+    deferErrorEvent?: (error: Error) => boolean;
+    /** Event callback */
+    onEvent: (event: AgentEvent) => void | Promise<void>;
+    /** Doom loop threshold (default: 3) */
+    doomLoopThreshold?: number;
+    /** Enforce doom loop (throw error vs warn) when no handler is provided */
+    enforceDoomLoop?: boolean;
+    /**
+     * Handler for doom loop detection.
+     * Allows user choice: allow, deny, or remember.
+     */
+    onDoomLoop?: DoomLoopHandler;
+    /** Tools that are "remembered" (allowed without asking) */
+    rememberedDoomLoopTools?: Set<string>;
+    /** Token limit for context overflow detection */
+    contextTokenLimit?: number;
+    /** Callback for context overflow */
+    onContextOverflow?: (tokens: number, limit: number) => void | Promise<void>;
+    /** Current step number */
+    currentStep?: number;
+    /** Max steps */
+    maxSteps?: number;
+    /** Logger for diagnostic output */
+    logger?: Logger;
+}
+/**
+ * Result of stream processing.
+ */
+export interface StepProcessingOutput {
+    /** Processing result */
+    result: StepProcessingResult;
+    /** Accumulated text */
+    text: string;
+    /** Tool results */
+    toolResults: Array<{
+        toolName: string;
+        toolCallId: string;
+        result: unknown;
+        metadata?: ToolMetadata;
+    }>;
+    /** Final usage */
+    usage?: TokenUsage;
+    /** Finish reason reported by the most recent completed step */
+    finishReason?: string;
+    /** Error if any */
+    error?: Error;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/turn/step-processing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/step-processing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,UAAU,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;IAC3C;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAC5C,qBAAqB;IACrB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,2DAA2D;IAC3D,uBAAuB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,WAAW,EAAE,KAAK,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;KACzB,CAAC,CAAC;IACH,kBAAkB;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}