@cuylabs/agent-core 4.9.0 → 5.0.0

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

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

package/dist/execution/index.js

@@ -1,54 +1,74 @@
+import {
+  createAgentTaskRunner,
+  defaultAgentTaskCheckpointStrategy
+} from "../chunk-JFH6HBUG.js";
 import {
   AgentTurnEngine,
   ContextOverflowError,
   DoomLoopError,
-  advanceAgentTurnState,
+  commitOutput,
+  commitStep,
+  createAgentTurnEngine,
+  createAgentTurnStepCommitBatch,
+  prepareModelStep,
+  processStepStream,
+  runModelStep,
+  runToolBatch
+} from "../chunk-346FIYKT.js";
+import {
   applyAgentWorkflowCommitResult,
+  applyAgentWorkflowContextCompactionResult,
   applyAgentWorkflowModelStepResult,
   applyAgentWorkflowToolBatchResult,
   applyAgentWorkflowToolCallResult,
   applyWorkflowInterventions,
   cloneAgentWorkflowTurnState,
-  commitOutput,
-  commitStep,
-  createAgentTaskRunner,
-  createAgentTurnEngine,
-  createAgentTurnState,
-  createAgentTurnStepCommitBatch,
   createAgentWorkflowTurnState,
-  defaultAgentTaskCheckpointStrategy,
   drainWorkflowInterventions,
-  failAgentTurnState,
   failAgentWorkflowTurnState,
   planNextAgentWorkflowOperation,
-  prepareModelStep,
-  processStepStream,
   queueWorkflowFollowUps,
   recordAgentWorkflowReplayDecision,
   restoreAgentWorkflowMessage,
   restoreAgentWorkflowMessages,
-  runModelStep,
-  runToolBatch,
   snapshotAgentWorkflowMessage,
   snapshotAgentWorkflowMessages
-} from "../chunk-V6ETEYST.js";
+} from "../chunk-MJRZ2ZRI.js";
+import {
+  AgentTurnStateConflictError,
+  advanceAgentTurnState,
+  createAgentTurnState,
+  failAgentTurnState,
+  getCurrentAgentTurnStepRecord,
+  mergeAgentTurnStateProgress
+} from "../chunk-E66PKKDL.js";
+import "../chunk-DYZGHHDB.js";
+import "../chunk-CGP6UNCQ.js";
 import {
   convertAgentMessagesToModelMessages
-} from "../chunk-NS7D7JJU.js";
-import "../chunk-MWPU2EVV.js";
+} from "../chunk-K453AFTL.js";
 import "../chunk-STDJYXYK.js";
-import "../chunk-GJFP5L2V.js";
-import "../chunk-CJI7PVS2.js";
+import "../chunk-JUIL2NJC.js";
+import {
+  currentScope,
+  restoreScope,
+  snapshotScope,
+  withinScope
+} from "../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,
   applyAgentWorkflowCommitResult,
+  applyAgentWorkflowContextCompactionResult,
   applyAgentWorkflowModelStepResult,
   applyAgentWorkflowToolBatchResult,
   applyAgentWorkflowToolCallResult,
@@ -62,10 +82,13 @@ export {
   createAgentTurnState,
   createAgentTurnStepCommitBatch,
   createAgentWorkflowTurnState,
+  currentScope,
   defaultAgentTaskCheckpointStrategy,
   drainWorkflowInterventions,
   failAgentTurnState,
   failAgentWorkflowTurnState,
+  getCurrentAgentTurnStepRecord,
+  mergeAgentTurnStateProgress,
   planNextAgentWorkflowOperation,
   prepareModelStep,
   processStepStream,
@@ -73,8 +96,11 @@ export {
   recordAgentWorkflowReplayDecision,
   restoreAgentWorkflowMessage,
   restoreAgentWorkflowMessages,
+  restoreScope,
   runModelStep,
   runToolBatch,
   snapshotAgentWorkflowMessage,
-  snapshotAgentWorkflowMessages
+  snapshotAgentWorkflowMessages,
+  snapshotScope,
+  withinScope
 };

package/dist/execution/scope/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Execution scope helpers for nested in-process execution context.
+ *
+ * A scope carries ambient execution metadata for the current task, turn, model
+ * step, tool call, or other operation. Middleware can read scope snapshots,
+ * but scope itself does not change execution behavior.
+ */
+export type { ScopeSnapshot } from "./types.js";
+export { currentScope, restoreScope, snapshotScope, withinScope, } from "./run.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/scope/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,UAAU,CAAC"}

package/dist/execution/scope/index.js

@@ -0,0 +1,12 @@
+import {
+  currentScope,
+  restoreScope,
+  snapshotScope,
+  withinScope
+} from "../../chunk-AHDCR7SX.js";
+export {
+  currentScope,
+  restoreScope,
+  snapshotScope,
+  withinScope
+};

package/dist/execution/scope/run.d.ts

@@ -0,0 +1,8 @@
+import type { Scope, ScopeOptions, ScopeSnapshot } from "./types.js";
+export declare function currentScope(): Scope | undefined;
+export declare function snapshotScope(scope?: Scope | undefined): ScopeSnapshot | undefined;
+export declare function createScope(options: ScopeOptions): Scope;
+export declare function withinScope<T>(options: ScopeOptions, fn: () => T | Promise<T>): Promise<T>;
+export declare function restoreScope<T>(snapshot: ScopeSnapshot | undefined, fn: () => T | Promise<T>): Promise<T>;
+export declare function streamWithinScope<T, TReturn = void>(options: ScopeOptions, iterable: AsyncGenerator<T, TReturn> | AsyncIterable<T>): AsyncGenerator<T, TReturn>;
+//# sourceMappingURL=run.d.ts.map

package/dist/execution/scope/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/execution/scope/run.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAErE,wBAAgB,YAAY,IAAI,KAAK,GAAG,SAAS,CAGhD;AAED,wBAAgB,aAAa,CAC3B,KAAK,oBAAmB,GACvB,aAAa,GAAG,SAAS,CAE3B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAExD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED,wBAAuB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,EACxD,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GACtD,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAoB5B"}

package/dist/execution/scope/store.d.ts

@@ -0,0 +1,6 @@
+import type { Scope, ScopeOptions, ScopeSnapshot } from "./types.js";
+export declare function cloneScope(scope: ScopeSnapshot): Scope;
+export declare function getStoredScope(): Scope | undefined;
+export declare function buildScope(options: ScopeOptions, current?: ScopeSnapshot): Scope;
+export declare function runWithScope<T>(scope: Scope, fn: () => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=store.d.ts.map

package/dist/execution/scope/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/execution/scope/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,KAAK,EAEL,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAQpB,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAKtD;AAED,wBAAgB,cAAc,IAAI,KAAK,GAAG,SAAS,CAElD;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,KAAK,CAkBP;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/execution/scope/types.d.ts

@@ -0,0 +1,28 @@
+export type ScopeKind = "task" | "turn" | "model" | "tool" | "commit" | "sub-agent" | "activity";
+export type ScopeAttributeValue = string | number | boolean | null;
+export type ScopeAttributes = Record<string, ScopeAttributeValue | undefined>;
+export interface Scope {
+    id: string;
+    rootId: string;
+    kind: ScopeKind;
+    name: string;
+    parentId?: string;
+    depth: number;
+    startedAt: string;
+    sessionId?: string;
+    taskId?: string;
+    step?: number;
+    attributes: ScopeAttributes;
+}
+export type ScopeSnapshot = Scope;
+export interface ScopeOptions {
+    id?: string;
+    kind: ScopeKind;
+    name: string;
+    parent?: ScopeSnapshot | null;
+    sessionId?: string;
+    taskId?: string;
+    step?: number;
+    attributes?: ScopeAttributes;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/scope/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/execution/scope/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAEnE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAAC;AAE9E,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAElC,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B"}

package/dist/execution/shared/usage.d.ts

@@ -0,0 +1,9 @@
+import type { TokenUsage } from "../../types/messages.js";
+/**
+ * Shallow-clone a `TokenUsage` value.
+ *
+ * Shared across turn-state and workflow-state to avoid duplicating the
+ * same trivial helper in multiple files.
+ */
+export declare function cloneUsage(usage: TokenUsage): TokenUsage;
+//# sourceMappingURL=usage.d.ts.map

package/dist/execution/shared/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/execution/shared/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAExD"}

package/dist/execution/task/index.d.ts

@@ -0,0 +1,6 @@
+export type { AgentTaskChatAdapter, AgentTaskPayload, AgentTaskExecutionContext, AgentTaskResumeSnapshot, AgentTaskResult, AgentTaskRunner, } from "./types.js";
+export type { AgentTaskCheckpointReason, AgentTaskCheckpointStrategy, AgentTaskCheckpointStrategyInput, AgentTaskExecutionCheckpoint, AgentTaskExecutionRun, AgentTaskExecutionSnapshot, AgentTaskObserver, } from "./observer.js";
+export type { AgentTaskRunnerOptions } from "./runner.js";
+export { defaultAgentTaskCheckpointStrategy } from "./observer.js";
+export { createAgentTaskRunner } from "./runner.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/task/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,gCAAgC,EAChC,4BAA4B,EAC5B,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,kCAAkC,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/execution/task/observer.d.ts

@@ -0,0 +1,80 @@
+import type { AgentEvent } from "../../types/events.js";
+import type { TokenUsage } from "../../types/messages.js";
+import type { AgentTaskExecutionContext, AgentTaskPayload, AgentTaskResult } from "./types.js";
+import type { ScopeSnapshot } from "../scope/types.js";
+import type { AgentTurnState } from "../turn/index.js";
+export type AgentTaskCheckpointReason = "task-start" | "input-commit-start" | "input-commit-finish" | "intervention-commit-start" | "intervention-commit-finish" | "context-compaction-finish" | "step-finish" | "step-commit-start" | "step-commit-finish" | "tool-result" | "tool-error" | "output-commit-start" | "output-commit-finish" | "task-complete" | "task-error";
+export interface AgentTaskExecutionRun<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+    payload: Readonly<TPayload>;
+    context: Readonly<AgentTaskExecutionContext>;
+    sessionId: string;
+    executionId: string;
+    startedAt: string;
+    scope?: ScopeSnapshot;
+}
+export interface AgentTaskExecutionSnapshot {
+    sessionId: string;
+    response: string;
+    usage: TokenUsage;
+    toolCalls: Array<{
+        name: string;
+        result: unknown;
+    }>;
+    eventCount: number;
+    activeStep?: number;
+    lastEvent?: AgentEvent;
+    error?: string;
+    startedAt: string;
+    updatedAt: string;
+    turnState: AgentTurnState;
+    scope?: ScopeSnapshot;
+}
+export interface AgentTaskExecutionCheckpoint<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+    run: AgentTaskExecutionRun<TPayload>;
+    reason: AgentTaskCheckpointReason;
+    snapshot: AgentTaskExecutionSnapshot;
+    event?: AgentEvent;
+    createdAt: string;
+}
+export interface AgentTaskObserver<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+    onTaskStart?(run: AgentTaskExecutionRun<TPayload>, snapshot: AgentTaskExecutionSnapshot): void | Promise<void>;
+    onTaskEvent?(run: AgentTaskExecutionRun<TPayload>, event: AgentEvent, snapshot: AgentTaskExecutionSnapshot): void | Promise<void>;
+    onCheckpoint?(checkpoint: AgentTaskExecutionCheckpoint<TPayload>): void | Promise<void>;
+    onTaskComplete?(run: AgentTaskExecutionRun<TPayload>, result: AgentTaskResult, snapshot: AgentTaskExecutionSnapshot): void | Promise<void>;
+    onTaskError?(run: AgentTaskExecutionRun<TPayload>, error: Error, snapshot: AgentTaskExecutionSnapshot): void | Promise<void>;
+    /**
+     * Get the active OTel context for a session.
+     *
+     * Used for trace context propagation between layers — e.g. the
+     * workflow bridge retrieves the observer's span context and injects
+     * it into activities so child spans (AI SDK, tool calls) are
+     * correlated under the observer's root span.
+     */
+    getOtelContext?(sessionId: string, executionId?: string): unknown;
+    /**
+     * Activate the OTel context for a session around a function call.
+     *
+     * Used by the task runner to ensure child spans (from middleware,
+     * AI SDK) are parented under the observer's root span in direct
+     * execution mode. The observer wraps `fn` in `context.with()` so
+     * that `context.active()` returns the session's trace context.
+     */
+    activateContext?<T>(sessionId: string, executionId: string, fn: () => T): T;
+}
+export interface AgentTaskCheckpointStrategyInput<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+    run: AgentTaskExecutionRun<TPayload>;
+    event: AgentEvent;
+    snapshot: AgentTaskExecutionSnapshot;
+}
+export type AgentTaskCheckpointStrategy<TPayload extends AgentTaskPayload = AgentTaskPayload> = (input: AgentTaskCheckpointStrategyInput<TPayload>) => AgentTaskCheckpointReason | undefined;
+/**
+ * Default checkpoint strategy for runtime integrations.
+ *
+ * This intentionally checkpoints at coarse-grained boundaries that are useful
+ * for external runtimes and durable adapters without creating excessive churn:
+ * - step completion
+ * - tool results/errors
+ * - task completion
+ */
+export declare function defaultAgentTaskCheckpointStrategy<TPayload extends AgentTaskPayload = AgentTaskPayload>(input: AgentTaskCheckpointStrategyInput<TPayload>): AgentTaskCheckpointReason | undefined;
+//# sourceMappingURL=observer.d.ts.map

package/dist/execution/task/observer.d.ts.map

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

package/dist/execution/task/runner.d.ts

@@ -0,0 +1,39 @@
+import type { AgentTaskChatAdapter, AgentTaskExecutionContext, AgentTaskPayload, AgentTaskRunner } from "./types.js";
+import { type AgentTaskCheckpointStrategy, type AgentTaskObserver } from "./observer.js";
+import type { Logger } from "../../logger/types.js";
+export interface AgentTaskRunnerOptions<TPayload extends AgentTaskPayload = AgentTaskPayload> {
+    /** Prefix used for generated runtime session IDs. Defaults to "runtime". */
+    sessionPrefix?: string;
+    /**
+     * Optional callback for resolving session IDs from payload/context.
+     * Ignored when payload.sessionId is provided.
+     */
+    resolveSessionId?: (payload: TPayload, context: AgentTaskExecutionContext) => string | undefined;
+    /**
+     * Optional execution observers. These are generic lifecycle hooks that can be
+     * consumed by runtime adapters (in-memory, Dapr, queues, etc.) without
+     * introducing infrastructure dependencies into `@cuylabs/agent-core`.
+     */
+    observers?: AgentTaskObserver<TPayload>[];
+    /**
+     * Optional checkpoint strategy for converting streamed agent events into
+     * coarse-grained execution checkpoints. Defaults to
+     * `defaultAgentTaskCheckpointStrategy(...)`.
+     */
+    checkpointStrategy?: AgentTaskCheckpointStrategy<TPayload>;
+    /** Logger for diagnostic output. Defaults to silent. */
+    logger?: Logger;
+}
+/**
+ * Create a reusable task runner that maps generic task payloads to `agent.chat()`.
+ *
+ * This helper is intentionally infrastructure-agnostic. It can be used by any
+ * runtime/orchestration package (in-memory, Dapr, queues, cron, etc.) without
+ * introducing infrastructure dependencies into `@cuylabs/agent-core`.
+ *
+ * The runner also exposes a neutral execution observer/checkpoint surface so
+ * external runtimes can persist progress, react to lifecycle events, or map
+ * streamed execution milestones into their own durability layer.
+ */
+export declare function createAgentTaskRunner<TPayload extends AgentTaskPayload = AgentTaskPayload>(agent: AgentTaskChatAdapter, options?: AgentTaskRunnerOptions<TPayload>): AgentTaskRunner<TPayload>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/execution/task/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/execution/task/runner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAEhB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,2BAA2B,EAIhC,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AAMvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,WAAW,sBAAsB,CACrC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB;IAEpD,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CACjB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,yBAAyB,KAC/B,MAAM,GAAG,SAAS,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC3D,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqDD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB,EAEpD,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,sBAAsB,CAAC,QAAQ,CAAM,GAC7C,eAAe,CAAC,QAAQ,CAAC,CAiM3B"}

package/dist/execution/task/types.d.ts

@@ -0,0 +1,85 @@
+import type { AgentEvent } from "../../types/events.js";
+import type { TokenUsage } from "../../types/messages.js";
+export interface AgentTaskPayload {
+    /** Prompt/message passed to the agent. */
+    message: string;
+    /** Optional explicit session id. If omitted, a runtime session id is generated. */
+    sessionId?: string;
+    /** Optional per-run system override forwarded to agent.chat(). */
+    system?: string;
+}
+export interface AgentTaskExecutionContext {
+    /** Abort signal propagated to agent.chat(). */
+    signal?: AbortSignal;
+    /** Stable identifier for this task execution when supplied by the caller. */
+    executionId?: string;
+    /** Optional trigger descriptor from caller (for logging/routing). */
+    trigger?: string;
+    /**
+     * Optional stable key used when auto-generating session ids.
+     * For scheduled jobs, a job ID is a good candidate.
+     */
+    fallbackSessionKey?: string;
+    /**
+     * Optional prior execution state to resume from. When provided, the task
+     * runner restores accumulated response, usage, tool results, and step
+     * counter from this snapshot before streaming the next agent.chat() turn.
+     *
+     * This enables runtime providers (e.g. Dapr) to implement crash recovery
+     * on the direct (non-workflow) execution path: load the last checkpoint
+     * from the execution store, then re-run with `restoreFrom` so the turn
+     * continues from where it left off rather than starting fresh.
+     *
+     * The snapshot only provides accumulated bookkeeping — the actual
+     * conversation context is recovered through the session storage layer
+     * (same sessionId → same persisted messages).
+     */
+    restoreFrom?: AgentTaskResumeSnapshot;
+}
+/**
+ * Portable snapshot of prior execution state used for resume.
+ *
+ * This is intentionally a minimal subset — just enough for the task runner
+ * to restore its accumulators. The full `AgentTaskExecutionSnapshot` (with
+ * turn state, events, scope) lives in the runtime provider's execution store.
+ */
+export interface AgentTaskResumeSnapshot {
+    /** Accumulated response text from prior execution. */
+    response: string;
+    /** Accumulated token usage from prior execution. */
+    usage: TokenUsage;
+    /** Tool calls completed in the prior execution. */
+    toolCalls: Array<{
+        name: string;
+        result: unknown;
+    }>;
+    /** Step counter to resume from. */
+    step: number;
+    /** Event counter to resume from. */
+    eventCount: number;
+    /** ISO timestamp of the original execution start. */
+    startedAt: string;
+}
+export interface AgentTaskResult {
+    response: string;
+    sessionId: string;
+    usage: TokenUsage;
+    toolCalls: Array<{
+        name: string;
+        result: unknown;
+    }>;
+}
+export type AgentTaskRunner<TPayload extends AgentTaskPayload = AgentTaskPayload> = (payload: TPayload, context?: AgentTaskExecutionContext) => Promise<AgentTaskResult>;
+/**
+ * Minimal chat surface required by `createAgentTaskRunner(...)`.
+ *
+ * The concrete `Agent` class already satisfies this contract. Keeping the
+ * requirement this small makes runtime integration easier to test and reuse.
+ */
+export interface AgentTaskChatAdapter {
+    chat(sessionId: string, message: string, options?: {
+        abort?: AbortSignal;
+        system?: string;
+    }): AsyncIterable<AgentEvent>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/task/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/execution/task/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,KAAK,EAAE,UAAU,CAAC;IAClB,mDAAmD;IACnD,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,MAAM,eAAe,CACzB,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB,IAClD,CACF,OAAO,EAAE,QAAQ,EACjB,OAAO,CAAC,EAAE,yBAAyB,KAChC,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACjD,aAAa,CAAC,UAAU,CAAC,CAAC;CAC9B"}

package/dist/execution/turn/engine/commit-batch.d.ts

@@ -0,0 +1,16 @@
+import type { AgentTurnBoundaryEvent, AgentTurnBoundaryMetadata, AgentTurnCommitBatch, AgentTurnOutputCommitOptions, AgentTurnStepCommitSnapshot, CreateAgentTurnStepCommitBatchOptions } from "./types.js";
+export declare function createAgentTurnBoundaryEvent(boundary: import("./types.js").AgentTurnBoundaryKind, metadata?: AgentTurnBoundaryMetadata): AgentTurnBoundaryEvent;
+export declare function createAgentTurnStepCommitBatch(step: number, snapshot: AgentTurnStepCommitSnapshot, options?: CreateAgentTurnStepCommitBatchOptions): AgentTurnCommitBatch | undefined;
+export declare function createAgentTurnInputCommit(options: {
+    content: string;
+    system?: string;
+    createdAt?: Date;
+    id?: string;
+}): AgentTurnCommitBatch;
+export declare function createAgentTurnInterventionCommit(options: {
+    id: string;
+    content: string;
+    createdAt?: Date;
+}): AgentTurnCommitBatch;
+export declare function createAgentTurnOutputCommit(options: AgentTurnOutputCommitOptions): AgentTurnCommitBatch | undefined;
+//# sourceMappingURL=commit-batch.d.ts.map

package/dist/execution/turn/engine/commit-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-batch.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/engine/commit-batch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,qCAAqC,EACtC,MAAM,YAAY,CAAC;AAEpB,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,YAAY,EAAE,qBAAqB,EACpD,QAAQ,GAAE,yBAA8B,GACvC,sBAAsB,CAUxB;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,2BAA2B,EACrC,OAAO,GAAE,qCAA0C,GAClD,oBAAoB,GAAG,SAAS,CA0ClC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,oBAAoB,CAkBvB;AAED,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB,GAAG,oBAAoB,CAiBvB;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,oBAAoB,GAAG,SAAS,CAsBlC"}

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

@@ -0,0 +1,32 @@
+import { type AgentTurnState } from "../state.js";
+import type { AgentTurnBoundaryEvent, AgentTurnBoundaryMetadata, AgentTurnCommitBatch, AgentTurnEngineOptions, AgentTurnOutputCommitOptions, AgentTurnStepCommitSnapshot } from "./types.js";
+/**
+ * Neutral internal turn engine for one in-flight agent turn.
+ */
+export declare class AgentTurnEngine {
+    private turnState;
+    private readonly pendingToolCalls;
+    private readonly pendingToolResults;
+    private readonly getToolReplayPolicy?;
+    constructor(options: AgentTurnEngineOptions);
+    getState(): AgentTurnState;
+    hasPendingToolCalls(): boolean;
+    createStepCommitSnapshot(): AgentTurnStepCommitSnapshot | undefined;
+    recordEvent(event: import("../../../types/events.js").AgentEvent, updatedAt: string): AgentTurnState;
+    createBoundaryEvent(boundary: import("./types.js").AgentTurnBoundaryKind, metadata?: AgentTurnBoundaryMetadata): AgentTurnBoundaryEvent;
+    createInputCommit(options: {
+        content: string;
+        system?: string;
+        createdAt?: Date;
+        id?: string;
+    }): AgentTurnCommitBatch;
+    createInterventionCommit(options: {
+        id: string;
+        content: string;
+        createdAt?: Date;
+    }): AgentTurnCommitBatch;
+    consumeStepCommit(step: number): AgentTurnCommitBatch | undefined;
+    createOutputCommit(options: AgentTurnOutputCommitOptions): AgentTurnCommitBatch | undefined;
+}
+export declare function createAgentTurnEngine(options: AgentTurnEngineOptions): AgentTurnEngine;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/engine/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAG5B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4C;IAC7E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IACJ,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAgD;gBAEzE,OAAO,EAAE,sBAAsB;IAQ3C,QAAQ,IAAI,cAAc;IAI1B,mBAAmB,IAAI,OAAO;IAI9B,wBAAwB,IAAI,2BAA2B,GAAG,SAAS;IAiCnE,WAAW,CACT,KAAK,EAAE,OAAO,0BAA0B,EAAE,UAAU,EACpD,SAAS,EAAE,MAAM,GAChB,cAAc;IAuCjB,mBAAmB,CACjB,QAAQ,EAAE,OAAO,YAAY,EAAE,qBAAqB,EACpD,QAAQ,GAAE,yBAA8B,GACvC,sBAAsB;IAIzB,iBAAiB,CAAC,OAAO,EAAE;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GAAG,oBAAoB;IAIxB,wBAAwB,CAAC,OAAO,EAAE;QAChC,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,GAAG,oBAAoB;IAIxB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAgBjE,kBAAkB,CAChB,OAAO,EAAE,4BAA4B,GACpC,oBAAoB,GAAG,SAAS;CAGpC;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAEjB"}

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

@@ -0,0 +1,12 @@
+/**
+ * Turn engine module.
+ *
+ * Split by responsibility:
+ * - `types` defines the public turn-engine contracts
+ * - `commit-batch` owns commit-message/boundary construction
+ * - `engine` owns pending tool-call state and turn-state advancement
+ */
+export type { AgentTurnBoundaryMetadata, AgentTurnCommitBatch, AgentTurnEngineOptions, AgentTurnStepCommitSnapshot, AgentTurnStepCommitToolCall, AgentTurnStepCommitToolResult, CreateAgentTurnStepCommitBatchOptions, } from "./types.js";
+export { createAgentTurnStepCommitBatch } from "./commit-batch.js";
+export { AgentTurnEngine, createAgentTurnEngine } from "./engine.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,6BAA6B,EAC7B,qCAAqC,GACtC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,67 @@
+import type { Message, TokenUsage } from "../../../types/messages.js";
+import type { AgentEvent, AgentTurnBoundaryKind } from "../../../types/events.js";
+import type { NormalizedToolReplayPolicy } from "../../../types/tool.js";
+import type { ToolMetadata } from "../../../types/tool.js";
+export interface AgentTurnEngineOptions {
+    sessionId: string;
+    startedAt: string;
+    getToolReplayPolicy?: (toolName: string) => NormalizedToolReplayPolicy | undefined;
+}
+export interface AgentTurnBoundaryMetadata {
+    step?: number;
+    messageRole?: Message["role"];
+    pendingToolCallCount?: number;
+}
+export interface AgentTurnStepCommitToolCall {
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+    replayPolicy?: NormalizedToolReplayPolicy;
+}
+export interface AgentTurnStepCommitToolResult {
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    metadata?: ToolMetadata;
+    replayPolicy?: NormalizedToolReplayPolicy;
+}
+export interface AgentTurnStepCommitSnapshot {
+    toolCalls: AgentTurnStepCommitToolCall[];
+    toolResults: AgentTurnStepCommitToolResult[];
+}
+export interface CreateAgentTurnStepCommitBatchOptions {
+    assistantMessageId?: string;
+    toolMessageIds?: Record<string, string>;
+    createdAt?: Date;
+}
+export interface AgentTurnCommitBatch {
+    startBoundary: AgentEvent & {
+        type: "turn-boundary";
+    };
+    finishBoundary: AgentEvent & {
+        type: "turn-boundary";
+    };
+    messages: Message[];
+}
+export interface PendingToolCallRecord {
+    toolName: string;
+    input: unknown;
+    replayPolicy?: NormalizedToolReplayPolicy;
+}
+export interface PendingToolResultRecord {
+    toolName: string;
+    result: unknown;
+    metadata?: ToolMetadata;
+    replayPolicy?: NormalizedToolReplayPolicy;
+}
+export interface AgentTurnOutputCommitOptions {
+    text: string;
+    usage?: TokenUsage;
+    createdAt?: Date;
+    id?: string;
+}
+export type AgentTurnBoundaryEvent = AgentEvent & {
+    type: "turn-boundary";
+};
+export type { AgentTurnBoundaryKind };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/execution/turn/engine/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,CACpB,QAAQ,EAAE,MAAM,KACb,0BAA0B,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,0BAA0B,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,YAAY,CAAC,EAAE,0BAA0B,CAAC;CAC3C;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,WAAW,EAAE,6BAA6B,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,qCAAqC;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,CAAC;IACtD,cAAc,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,eAAe,CAAA;KAAE,CAAC;IACvD,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,0BAA0B,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,YAAY,CAAC,EAAE,0BAA0B,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Turn execution primitives.
+ *
+ * Groups the live turn state machine, step ledger, turn engine, model/tool
+ * runner helpers, and streamed step processing.
+ */
+export type { AgentTurnActiveToolCall, AgentTurnStateAdvanceOptions, AgentTurnBoundarySnapshot, AgentTurnPhase, AgentTurnResolvedToolCall, AgentTurnState, CreateAgentTurnStateOptions, } from "./state.js";
+export type { AgentTurnStepCommitKind, AgentTurnStepCommitRecord, AgentTurnStepCommitStatus, AgentTurnStepRecord, AgentTurnStepStatus, AgentTurnStepToolResultCaptureMode, AgentTurnStepToolResultCaptureOptions, AgentTurnStepToolResultFormat, AgentTurnStepToolResultSummary, AgentTurnStepToolRecord, AgentTurnStepToolStatus, AgentTurnStateConflict, } from "./step-ledger.js";
+export type { AgentTurnBoundaryMetadata, AgentTurnCommitBatch, AgentTurnEngineOptions, AgentTurnStepCommitSnapshot, AgentTurnStepCommitToolCall, AgentTurnStepCommitToolResult, CreateAgentTurnStepCommitBatchOptions, } from "./engine/index.js";
+export type { AgentTurnCommitApplier, AgentTurnCommitOptions, AgentTurnStepRuntimeConfig, CommitOutputOptions, CommitStepOptions, PreparedAgentModelStep, PrepareModelStepOptions, RunToolBatchOptions, RunToolBatchResult, RunModelStepOptions, } from "./runner/index.js";
+export type { StepProcessingOptions, StepProcessingOutput, } from "./step-processing/index.js";
+export { advanceAgentTurnState, createAgentTurnState, failAgentTurnState, mergeAgentTurnStateProgress, } from "./state.js";
+export { AgentTurnStateConflictError, getCurrentAgentTurnStepRecord, } from "./step-ledger.js";
+export { AgentTurnEngine, createAgentTurnEngine } from "./engine/index.js";
+export { createAgentTurnStepCommitBatch } from "./engine/index.js";
+export { commitOutput, commitStep, prepareModelStep, runToolBatch, runModelStep, } from "./runner/index.js";
+export { processStepStream, DoomLoopError, ContextOverflowError, } from "./step-processing/index.js";
+//# sourceMappingURL=index.d.ts.map