zeitlich 0.2.37 → 0.2.38

package/dist/{proxy-0smGKvx8.d.ts → proxy-CUlKSvZS.d.ts}

@@ -1,5 +1,5 @@
 import { proxyActivities, ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from './types-CPKDl-y_.js';
+import { T as ThreadOps } from './types-DNr31FzL.js';
 
 /**
  * Shared proxy helper for thread operations.

package/dist/{proxy-DEtowJyd.d.cts → proxy-D_3x7RN4.d.cts}

@@ -1,5 +1,5 @@
 import { proxyActivities, ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from './types-BO7Yju20.cjs';
+import { T as ThreadOps } from './types-C06FwR96.cjs';
 
 /**
  * Shared proxy helper for thread operations.

package/dist/{thread-manager-C-C4pI2z.d.ts → thread-manager-CVu7o2cs.d.ts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-CPKDl-y_.js';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-B37hKoWA.js';
+import { J as JsonValue } from './types-DNr31FzL.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BH_IRryz.js';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];
@@ -26,6 +26,8 @@ interface AnthropicThreadManagerConfig {
 interface AnthropicInvocationPayload {
     messages: Anthropic.Messages.MessageParam[];
     system?: string | Anthropic.Messages.TextBlockParam[];
+    /** Number of stored messages loaded from Redis before preparation. */
+    storedLength: number;
 }
 /** Thread manager with Anthropic MessageParam convenience helpers */
 interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, AnthropicContent, JsonValue, AnthropicSystemContent> {

package/dist/{thread-manager-D4vgzYrh.d.cts → thread-manager-HSwyh28L.d.cts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-BO7Yju20.cjs';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-D08CXPh8.cjs';
+import { J as JsonValue } from './types-C06FwR96.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BaOw4hKI.cjs';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];
@@ -26,6 +26,8 @@ interface AnthropicThreadManagerConfig {
 interface AnthropicInvocationPayload {
     messages: Anthropic.Messages.MessageParam[];
     system?: string | Anthropic.Messages.TextBlockParam[];
+    /** Number of stored messages loaded from Redis before preparation. */
+    storedLength: number;
 }
 /** Thread manager with Anthropic MessageParam convenience helpers */
 interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, AnthropicContent, JsonValue, AnthropicSystemContent> {

package/dist/{thread-manager-3fszQih4.d.ts → thread-manager-c1gPopAG.d.ts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-CPKDl-y_.js';
+import { J as JsonValue } from './types-DNr31FzL.js';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-B37hKoWA.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BH_IRryz.js';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;
@@ -18,6 +18,8 @@ interface LangChainThreadManagerConfig {
 /** Prepared payload ready to send to a LangChain chat model */
 interface LangChainInvocationPayload {
     messages: BaseMessage[];
+    /** Number of stored messages loaded from Redis before preparation. */
+    storedLength: number;
 }
 /** Thread manager with LangChain StoredMessage convenience helpers */
 interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, LangChainContent, JsonValue, LangChainSystemContent> {

package/dist/{thread-manager-CzYln2OC.d.cts → thread-manager-wGi-LqIP.d.cts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-BO7Yju20.cjs';
+import { J as JsonValue } from './types-C06FwR96.cjs';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-D08CXPh8.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BaOw4hKI.cjs';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;
@@ -18,6 +18,8 @@ interface LangChainThreadManagerConfig {
 /** Prepared payload ready to send to a LangChain chat model */
 interface LangChainInvocationPayload {
     messages: BaseMessage[];
+    /** Number of stored messages loaded from Redis before preparation. */
+    storedLength: number;
 }
 /** Thread manager with LangChain StoredMessage convenience helpers */
 interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, LangChainContent, JsonValue, LangChainSystemContent> {

package/dist/{types-B37hKoWA.d.ts → types-BH_IRryz.d.ts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-CPKDl-y_.js';
+import { J as JsonValue } from './types-DNr31FzL.js';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;
@@ -36,6 +36,15 @@ interface BaseThreadManager<T> {
     fork(newThreadId: string): Promise<BaseThreadManager<T>>;
     /** Delete the thread */
     delete(): Promise<void>;
+    /** Get the number of stored messages currently in the thread */
+    length(): Promise<number>;
+    /**
+     * Truncate the thread to the given length (inclusive). Any messages
+     * beyond `length` are removed. When `length` is 0 the thread ends up
+     * empty (but still exists). Also clears any dedup markers so that
+     * subsequent appends with the same ids replay correctly.
+     */
+    truncate(length: number): Promise<void>;
 }
 /**
  * Shared contract for provider-specific thread managers.

package/dist/{types-D08CXPh8.d.cts → types-BaOw4hKI.d.cts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-BO7Yju20.cjs';
+import { J as JsonValue } from './types-C06FwR96.cjs';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;
@@ -36,6 +36,15 @@ interface BaseThreadManager<T> {
     fork(newThreadId: string): Promise<BaseThreadManager<T>>;
     /** Delete the thread */
     delete(): Promise<void>;
+    /** Get the number of stored messages currently in the thread */
+    length(): Promise<number>;
+    /**
+     * Truncate the thread to the given length (inclusive). Any messages
+     * beyond `length` are removed. When `length` is 0 the thread ends up
+     * empty (but still exists). Also clears any dedup markers so that
+     * subsequent appends with the same ids replay correctly.
+     */
+    truncate(length: number): Promise<void>;
 }
 /**
  * Shared contract for provider-specific thread managers.

package/dist/{types-CPKDl-y_.d.ts → types-C06FwR96.d.cts}

@@ -2,7 +2,7 @@ import { Duration } from '@temporalio/common';
 import { ActivityFunctionWithOptions, QueryDefinition, ActivityInterfaceFor } from '@temporalio/workflow';
 import { UpdateDefinition } from '@temporalio/common/lib/interfaces';
 import { z } from 'zod';
-import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, f as SandboxSnapshot, g as SandboxOps } from './types-tQL9njTu.js';
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, d as SandboxCreateOptions, f as SandboxSnapshot, g as SandboxOps } from './types-yx0LzPGn.cjs';
 
 /**
  * A tool definition with a name, description, and Zod schema for arguments.
@@ -98,6 +98,17 @@ interface ToolHandlerResponse<TResult = null, TToolResponse = JsonValue> {
      * payloads through Temporal's activity payload limit.
      */
     resultAppended?: boolean;
+    /**
+     * When true, the session will rewind: any in-flight parallel tool calls
+     * are cancelled, previously appended tool results and the triggering
+     * assistant message are removed from the thread, and the LLM call that
+     * produced the tool calls is retried.
+     *
+     * The `toolResponse` for a rewinding tool call is ignored (never
+     * appended) since the session truncates the thread back to the
+     * pre-invocation state.
+     */
+    rewind?: boolean;
     /** Token usage from the tool execution (e.g. child agent invocations) */
     usage?: TokenUsage;
     /** Thread ID used by the handler (surfaced to the LLM for subagent thread continuation) */
@@ -186,6 +197,27 @@ interface ProcessToolCallsContext {
     /** Active sandbox ID (when a sandbox is configured for this session) */
     sandboxId?: string;
 }
+/**
+ * Signal that a tool handler requested a rewind. Attached to the
+ * {@link ProcessToolCallsResult} so the session can roll the thread
+ * back to the pre-invocation snapshot and retry the LLM call.
+ */
+interface RewindSignal {
+    toolCallId: string;
+    toolName: string;
+}
+/**
+ * Result returned by {@link ToolRouter.processToolCalls}.
+ *
+ * The object is a standard array of tool call results for successful
+ * tool calls (cancelled or rewinding siblings are omitted), extended
+ * with a `rewind` property when any tool in the batch requested a
+ * rewind. Using an array-with-property lets existing code that treats
+ * the return value as `ToolCallResultUnion[]` continue to work.
+ */
+type ProcessToolCallsResult<TResults extends Record<string, unknown>> = ToolCallResultUnion<TResults>[] & {
+    rewind?: RewindSignal;
+};
 /**
  * Result from PreToolUse hook - can block or modify execution
  */
@@ -344,7 +376,7 @@ interface ToolRouter<T extends ToolMap> {
      * @param toolCalls - Array of parsed tool calls to process
      * @param context - Optional context including turn number for hooks
      */
-    processToolCalls(toolCalls: ParsedToolCallUnion<T>[], context?: ProcessToolCallsContext): Promise<ToolCallResultUnion<InferToolResults<T>>[]>;
+    processToolCalls(toolCalls: ParsedToolCallUnion<T>[], context?: ProcessToolCallsContext): Promise<ProcessToolCallsResult<InferToolResults<T>>>;
     /**
      * Process tool calls matching a specific name with a custom handler.
      * Useful for overriding the default handler for specific cases.
@@ -808,9 +840,12 @@ type ThreadInit = {
  *   Paused sandboxes are automatically resumed. The shutdown policy applies
  *   on exit.
  * - `"fork"` — fork from an existing (or paused) sandbox; a new sandbox is
- *   created and owned by this session.
+ *   created and owned by this session. `options` is an optional per-call
+ *   override merged on top of the provider's static defaults.
  * - `"from-snapshot"` — restore a fresh sandbox from a previously captured
  *   {@link SandboxSnapshot}. The new sandbox is owned by this session.
+ *   `options` is an optional per-call override merged on top of the
+ *   provider's static defaults.
  * - `"inherit"` — use a sandbox owned by someone else (e.g. a parent agent).
  *   The session will **not** manage its lifecycle on exit.
  */
@@ -823,9 +858,11 @@ type SandboxInit = {
 } | {
     mode: "fork";
     sandboxId: string;
+    options?: SandboxCreateOptions;
 } | {
     mode: "from-snapshot";
     snapshot: SandboxSnapshot;
+    options?: SandboxCreateOptions;
 } | {
     mode: "inherit";
     sandboxId: string;
@@ -1083,6 +1120,16 @@ interface AgentResponse<M = unknown> {
     message: M;
     rawToolCalls: RawToolCall[];
     usage?: TokenUsage;
+    /**
+     * Number of stored messages in the thread at the moment the LLM was
+     * invoked — i.e. *before* the assistant message is appended. The
+     * session uses this as a rewind snapshot so it can roll the thread
+     * back to this exact state if a tool requests a rewind.
+     *
+     * Adapters compute this for free from the array of stored messages
+     * they load when preparing the payload.
+     */
+    threadLengthAtCall?: number;
 }
 /**
  * Type signature for workflow-specific runAgent activity
@@ -1133,6 +1180,14 @@ interface ThreadOps<TContent = string> {
     appendSystemMessage(threadId: string, id: string, content: unknown, threadKey?: string): Promise<void>;
     /** Copy all messages from sourceThreadId into a new thread at targetThreadId */
     forkThread(sourceThreadId: string, targetThreadId: string, threadKey?: string): Promise<void>;
+    /**
+     * Truncate the thread back to `length` messages. Used by the session's
+     * rewind flow to roll the thread back before retrying a turn. The
+     * session obtains `length` from `AgentResponse.threadLengthAtCall`,
+     * which the model invoker computes for free from the messages it
+     * loaded before invoking the LLM.
+     */
+    truncateThread(threadId: string, length: number, threadKey?: string): Promise<void>;
 }
 /**
  * Composes an adapter prefix + workflow scope for activity naming.
@@ -1281,4 +1336,4 @@ interface ZeitlichSession<M = unknown, HasSandbox extends boolean = boolean> {
     }): Promise<SessionResult<M, T, HasSandbox>>;
 }
 
-export { type SessionEndHook as $, type AgentResponse as A, type BaseAgentState as B, type PostToolUseFailureHookResult as C, type PostToolUseHook as D, type PostToolUseHookContext as E, type FileEntryMetadata as F, type PreHumanMessageAppendHook as G, type Hooks as H, type InferToolResults as I, type JsonValue as J, type PreHumanMessageAppendHookContext as K, type PreToolUseHook as L, type ModelInvokerConfig as M, type PreToolUseHookContext as N, type PreToolUseHookResult as O, type PrefixedThreadOps as P, type ProcessToolCallsContext as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type RawToolCall as U, type VirtualFsContext as V, type RunAgentActivity as W, type SandboxInit as X, type SandboxShutdown as Y, type SerializableToolDefinition as Z, type SessionConfig as _, type ModelInvoker as a, type SessionEndHookContext as a0, type SessionExitReason as a1, type SessionResult as a2, type SessionStartHook as a3, type SessionStartHookContext as a4, type SubagentConfig as a5, type SubagentDefinition as a6, type SubagentFnResult as a7, type SubagentHandlerResponse as a8, type SubagentHooks as a9, isTerminalStatus as aA, type ToolRouterOptions as aB, type SubagentSandboxConfig as aa, type SubagentSandboxShutdown as ab, type SubagentSessionInput as ac, type SubagentWorkflow as ad, type SubagentWorkflowInput as ae, type TaskStatus as af, type ThreadInit as ag, type TokenUsage as ah, type ToolArgs as ai, type ToolCallResult as aj, type ToolCallResultUnion as ak, type ToolDefinition as al, type ToolHandler as am, type ToolHooks as an, type ToolMap as ao, type ToolNames as ap, type ToolResult as aq, type ToolRouter as ar, type ToolRouterHooks as as, type ToolWithHandler as at, VirtualFileSystem as au, type VirtualFileTree as av, type VirtualFsOps as aw, type VirtualFsState as ax, type WorkflowTask as ay, type ZeitlichSession as az, type ToolHandlerResponse as b, type ActivityToolHandler as c, type ToolResultConfig as d, type RunAgentConfig as e, type SkillProvider as f, type SkillMetadata as g, type Skill as h, type FileResolver as i, type TreeMutation as j, type PrefixedVirtualFsOps as k, type AgentConfig as l, type AgentFile as m, type AgentState as n, type AgentStateManager as o, type AgentStatus as p, type AppendToolResultFn as q, type FileEntry as r, type JsonPrimitive as s, type JsonSerializable as t, type ParsedToolCall as u, type ParsedToolCallUnion as v, type PostHumanMessageAppendHook as w, type PostHumanMessageAppendHookContext as x, type PostToolUseFailureHook as y, type PostToolUseFailureHookContext as z };
+export { type SerializableToolDefinition as $, type AgentResponse as A, type BaseAgentState as B, type PostToolUseFailureHookResult as C, type PostToolUseHook as D, type PostToolUseHookContext as E, type FileEntryMetadata as F, type PreHumanMessageAppendHook as G, type Hooks as H, type InferToolResults as I, type JsonValue as J, type PreHumanMessageAppendHookContext as K, type PreToolUseHook as L, type ModelInvokerConfig as M, type PreToolUseHookContext as N, type PreToolUseHookResult as O, type PrefixedThreadOps as P, type ProcessToolCallsContext as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type ProcessToolCallsResult as U, type VirtualFsContext as V, type RawToolCall as W, type RewindSignal as X, type RunAgentActivity as Y, type SandboxInit as Z, type SandboxShutdown as _, type ModelInvoker as a, type SessionConfig as a0, type SessionEndHook as a1, type SessionEndHookContext as a2, type SessionExitReason as a3, type SessionResult as a4, type SessionStartHook as a5, type SessionStartHookContext as a6, type SubagentConfig as a7, type SubagentDefinition as a8, type SubagentFnResult as a9, type WorkflowTask as aA, type ZeitlichSession as aB, isTerminalStatus as aC, type ToolRouterOptions as aD, type SubagentHandlerResponse as aa, type SubagentHooks as ab, type SubagentSandboxConfig as ac, type SubagentSandboxShutdown as ad, type SubagentSessionInput as ae, type SubagentWorkflow as af, type SubagentWorkflowInput as ag, type TaskStatus as ah, type ThreadInit as ai, type TokenUsage as aj, type ToolArgs as ak, type ToolCallResult as al, type ToolCallResultUnion as am, type ToolDefinition as an, type ToolHandler as ao, type ToolHooks as ap, type ToolMap as aq, type ToolNames as ar, type ToolResult as as, type ToolRouter as at, type ToolRouterHooks as au, type ToolWithHandler as av, VirtualFileSystem as aw, type VirtualFileTree as ax, type VirtualFsOps as ay, type VirtualFsState as az, type ToolHandlerResponse as b, type ActivityToolHandler as c, type ToolResultConfig as d, type RunAgentConfig as e, type SkillProvider as f, type SkillMetadata as g, type Skill as h, type FileResolver as i, type TreeMutation as j, type PrefixedVirtualFsOps as k, type AgentConfig as l, type AgentFile as m, type AgentState as n, type AgentStateManager as o, type AgentStatus as p, type AppendToolResultFn as q, type FileEntry as r, type JsonPrimitive as s, type JsonSerializable as t, type ParsedToolCall as u, type ParsedToolCallUnion as v, type PostHumanMessageAppendHook as w, type PostHumanMessageAppendHookContext as x, type PostToolUseFailureHook as y, type PostToolUseFailureHookContext as z };

package/dist/{types-CNuWnvy9.d.ts → types-DAsQ21Rt.d.ts}

@@ -1,4 +1,4 @@
-import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox, d as SandboxCreateOptions } from './types-tQL9njTu.js';
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox, d as SandboxCreateOptions } from './types-yx0LzPGn.js';
 import { BedrockAgentCoreClient, BedrockAgentCoreClientConfig } from '@aws-sdk/client-bedrock-agentcore';
 
 /**

package/dist/{types-BO7Yju20.d.cts → types-DNr31FzL.d.ts}

@@ -2,7 +2,7 @@ import { Duration } from '@temporalio/common';
 import { ActivityFunctionWithOptions, QueryDefinition, ActivityInterfaceFor } from '@temporalio/workflow';
 import { UpdateDefinition } from '@temporalio/common/lib/interfaces';
 import { z } from 'zod';
-import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, f as SandboxSnapshot, g as SandboxOps } from './types-tQL9njTu.cjs';
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, d as SandboxCreateOptions, f as SandboxSnapshot, g as SandboxOps } from './types-yx0LzPGn.js';
 
 /**
  * A tool definition with a name, description, and Zod schema for arguments.
@@ -98,6 +98,17 @@ interface ToolHandlerResponse<TResult = null, TToolResponse = JsonValue> {
      * payloads through Temporal's activity payload limit.
      */
     resultAppended?: boolean;
+    /**
+     * When true, the session will rewind: any in-flight parallel tool calls
+     * are cancelled, previously appended tool results and the triggering
+     * assistant message are removed from the thread, and the LLM call that
+     * produced the tool calls is retried.
+     *
+     * The `toolResponse` for a rewinding tool call is ignored (never
+     * appended) since the session truncates the thread back to the
+     * pre-invocation state.
+     */
+    rewind?: boolean;
     /** Token usage from the tool execution (e.g. child agent invocations) */
     usage?: TokenUsage;
     /** Thread ID used by the handler (surfaced to the LLM for subagent thread continuation) */
@@ -186,6 +197,27 @@ interface ProcessToolCallsContext {
     /** Active sandbox ID (when a sandbox is configured for this session) */
     sandboxId?: string;
 }
+/**
+ * Signal that a tool handler requested a rewind. Attached to the
+ * {@link ProcessToolCallsResult} so the session can roll the thread
+ * back to the pre-invocation snapshot and retry the LLM call.
+ */
+interface RewindSignal {
+    toolCallId: string;
+    toolName: string;
+}
+/**
+ * Result returned by {@link ToolRouter.processToolCalls}.
+ *
+ * The object is a standard array of tool call results for successful
+ * tool calls (cancelled or rewinding siblings are omitted), extended
+ * with a `rewind` property when any tool in the batch requested a
+ * rewind. Using an array-with-property lets existing code that treats
+ * the return value as `ToolCallResultUnion[]` continue to work.
+ */
+type ProcessToolCallsResult<TResults extends Record<string, unknown>> = ToolCallResultUnion<TResults>[] & {
+    rewind?: RewindSignal;
+};
 /**
  * Result from PreToolUse hook - can block or modify execution
  */
@@ -344,7 +376,7 @@ interface ToolRouter<T extends ToolMap> {
      * @param toolCalls - Array of parsed tool calls to process
      * @param context - Optional context including turn number for hooks
      */
-    processToolCalls(toolCalls: ParsedToolCallUnion<T>[], context?: ProcessToolCallsContext): Promise<ToolCallResultUnion<InferToolResults<T>>[]>;
+    processToolCalls(toolCalls: ParsedToolCallUnion<T>[], context?: ProcessToolCallsContext): Promise<ProcessToolCallsResult<InferToolResults<T>>>;
     /**
      * Process tool calls matching a specific name with a custom handler.
      * Useful for overriding the default handler for specific cases.
@@ -808,9 +840,12 @@ type ThreadInit = {
  *   Paused sandboxes are automatically resumed. The shutdown policy applies
  *   on exit.
  * - `"fork"` — fork from an existing (or paused) sandbox; a new sandbox is
- *   created and owned by this session.
+ *   created and owned by this session. `options` is an optional per-call
+ *   override merged on top of the provider's static defaults.
  * - `"from-snapshot"` — restore a fresh sandbox from a previously captured
  *   {@link SandboxSnapshot}. The new sandbox is owned by this session.
+ *   `options` is an optional per-call override merged on top of the
+ *   provider's static defaults.
  * - `"inherit"` — use a sandbox owned by someone else (e.g. a parent agent).
  *   The session will **not** manage its lifecycle on exit.
  */
@@ -823,9 +858,11 @@ type SandboxInit = {
 } | {
     mode: "fork";
     sandboxId: string;
+    options?: SandboxCreateOptions;
 } | {
     mode: "from-snapshot";
     snapshot: SandboxSnapshot;
+    options?: SandboxCreateOptions;
 } | {
     mode: "inherit";
     sandboxId: string;
@@ -1083,6 +1120,16 @@ interface AgentResponse<M = unknown> {
     message: M;
     rawToolCalls: RawToolCall[];
     usage?: TokenUsage;
+    /**
+     * Number of stored messages in the thread at the moment the LLM was
+     * invoked — i.e. *before* the assistant message is appended. The
+     * session uses this as a rewind snapshot so it can roll the thread
+     * back to this exact state if a tool requests a rewind.
+     *
+     * Adapters compute this for free from the array of stored messages
+     * they load when preparing the payload.
+     */
+    threadLengthAtCall?: number;
 }
 /**
  * Type signature for workflow-specific runAgent activity
@@ -1133,6 +1180,14 @@ interface ThreadOps<TContent = string> {
     appendSystemMessage(threadId: string, id: string, content: unknown, threadKey?: string): Promise<void>;
     /** Copy all messages from sourceThreadId into a new thread at targetThreadId */
     forkThread(sourceThreadId: string, targetThreadId: string, threadKey?: string): Promise<void>;
+    /**
+     * Truncate the thread back to `length` messages. Used by the session's
+     * rewind flow to roll the thread back before retrying a turn. The
+     * session obtains `length` from `AgentResponse.threadLengthAtCall`,
+     * which the model invoker computes for free from the messages it
+     * loaded before invoking the LLM.
+     */
+    truncateThread(threadId: string, length: number, threadKey?: string): Promise<void>;
 }
 /**
  * Composes an adapter prefix + workflow scope for activity naming.
@@ -1281,4 +1336,4 @@ interface ZeitlichSession<M = unknown, HasSandbox extends boolean = boolean> {
     }): Promise<SessionResult<M, T, HasSandbox>>;
 }
 
-export { type SessionEndHook as $, type AgentResponse as A, type BaseAgentState as B, type PostToolUseFailureHookResult as C, type PostToolUseHook as D, type PostToolUseHookContext as E, type FileEntryMetadata as F, type PreHumanMessageAppendHook as G, type Hooks as H, type InferToolResults as I, type JsonValue as J, type PreHumanMessageAppendHookContext as K, type PreToolUseHook as L, type ModelInvokerConfig as M, type PreToolUseHookContext as N, type PreToolUseHookResult as O, type PrefixedThreadOps as P, type ProcessToolCallsContext as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type RawToolCall as U, type VirtualFsContext as V, type RunAgentActivity as W, type SandboxInit as X, type SandboxShutdown as Y, type SerializableToolDefinition as Z, type SessionConfig as _, type ModelInvoker as a, type SessionEndHookContext as a0, type SessionExitReason as a1, type SessionResult as a2, type SessionStartHook as a3, type SessionStartHookContext as a4, type SubagentConfig as a5, type SubagentDefinition as a6, type SubagentFnResult as a7, type SubagentHandlerResponse as a8, type SubagentHooks as a9, isTerminalStatus as aA, type ToolRouterOptions as aB, type SubagentSandboxConfig as aa, type SubagentSandboxShutdown as ab, type SubagentSessionInput as ac, type SubagentWorkflow as ad, type SubagentWorkflowInput as ae, type TaskStatus as af, type ThreadInit as ag, type TokenUsage as ah, type ToolArgs as ai, type ToolCallResult as aj, type ToolCallResultUnion as ak, type ToolDefinition as al, type ToolHandler as am, type ToolHooks as an, type ToolMap as ao, type ToolNames as ap, type ToolResult as aq, type ToolRouter as ar, type ToolRouterHooks as as, type ToolWithHandler as at, VirtualFileSystem as au, type VirtualFileTree as av, type VirtualFsOps as aw, type VirtualFsState as ax, type WorkflowTask as ay, type ZeitlichSession as az, type ToolHandlerResponse as b, type ActivityToolHandler as c, type ToolResultConfig as d, type RunAgentConfig as e, type SkillProvider as f, type SkillMetadata as g, type Skill as h, type FileResolver as i, type TreeMutation as j, type PrefixedVirtualFsOps as k, type AgentConfig as l, type AgentFile as m, type AgentState as n, type AgentStateManager as o, type AgentStatus as p, type AppendToolResultFn as q, type FileEntry as r, type JsonPrimitive as s, type JsonSerializable as t, type ParsedToolCall as u, type ParsedToolCallUnion as v, type PostHumanMessageAppendHook as w, type PostHumanMessageAppendHookContext as x, type PostToolUseFailureHook as y, type PostToolUseFailureHookContext as z };
+export { type SerializableToolDefinition as $, type AgentResponse as A, type BaseAgentState as B, type PostToolUseFailureHookResult as C, type PostToolUseHook as D, type PostToolUseHookContext as E, type FileEntryMetadata as F, type PreHumanMessageAppendHook as G, type Hooks as H, type InferToolResults as I, type JsonValue as J, type PreHumanMessageAppendHookContext as K, type PreToolUseHook as L, type ModelInvokerConfig as M, type PreToolUseHookContext as N, type PreToolUseHookResult as O, type PrefixedThreadOps as P, type ProcessToolCallsContext as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type ProcessToolCallsResult as U, type VirtualFsContext as V, type RawToolCall as W, type RewindSignal as X, type RunAgentActivity as Y, type SandboxInit as Z, type SandboxShutdown as _, type ModelInvoker as a, type SessionConfig as a0, type SessionEndHook as a1, type SessionEndHookContext as a2, type SessionExitReason as a3, type SessionResult as a4, type SessionStartHook as a5, type SessionStartHookContext as a6, type SubagentConfig as a7, type SubagentDefinition as a8, type SubagentFnResult as a9, type WorkflowTask as aA, type ZeitlichSession as aB, isTerminalStatus as aC, type ToolRouterOptions as aD, type SubagentHandlerResponse as aa, type SubagentHooks as ab, type SubagentSandboxConfig as ac, type SubagentSandboxShutdown as ad, type SubagentSessionInput as ae, type SubagentWorkflow as af, type SubagentWorkflowInput as ag, type TaskStatus as ah, type ThreadInit as ai, type TokenUsage as aj, type ToolArgs as ak, type ToolCallResult as al, type ToolCallResultUnion as am, type ToolDefinition as an, type ToolHandler as ao, type ToolHooks as ap, type ToolMap as aq, type ToolNames as ar, type ToolResult as as, type ToolRouter as at, type ToolRouterHooks as au, type ToolWithHandler as av, VirtualFileSystem as aw, type VirtualFileTree as ax, type VirtualFsOps as ay, type VirtualFsState as az, type ToolHandlerResponse as b, type ActivityToolHandler as c, type ToolResultConfig as d, type RunAgentConfig as e, type SkillProvider as f, type SkillMetadata as g, type Skill as h, type FileResolver as i, type TreeMutation as j, type PrefixedVirtualFsOps as k, type AgentConfig as l, type AgentFile as m, type AgentState as n, type AgentStateManager as o, type AgentStatus as p, type AppendToolResultFn as q, type FileEntry as r, type JsonPrimitive as s, type JsonSerializable as t, type ParsedToolCall as u, type ParsedToolCallUnion as v, type PostHumanMessageAppendHook as w, type PostHumanMessageAppendHookContext as x, type PostToolUseFailureHook as y, type PostToolUseFailureHookContext as z };

package/dist/{types-DWEUmYAJ.d.cts → types-lm8tMNJQ.d.cts}

@@ -1,4 +1,4 @@
-import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox, d as SandboxCreateOptions } from './types-tQL9njTu.cjs';
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox, d as SandboxCreateOptions } from './types-yx0LzPGn.cjs';
 import { BedrockAgentCoreClient, BedrockAgentCoreClientConfig } from '@aws-sdk/client-bedrock-agentcore';
 
 /**

package/dist/{types-tQL9njTu.d.cts → types-yx0LzPGn.d.cts}

@@ -115,11 +115,23 @@ interface SandboxProvider<TOptions extends SandboxCreateOptions = SandboxCreateO
     pause(sandboxId: string, ttlSeconds?: number): Promise<void>;
     /** Resume a paused sandbox. No-op if already running. */
     resume(sandboxId: string): Promise<void>;
-    snapshot(sandboxId: string): Promise<SandboxSnapshot>;
-    restore(snapshot: SandboxSnapshot): Promise<Sandbox>;
+    /**
+     * Capture a snapshot of a running sandbox. `options` is a per-call override
+     * merged on top of the provider's static defaults.
+     */
+    snapshot(sandboxId: string, options?: TOptions): Promise<SandboxSnapshot>;
+    /**
+     * Restore a sandbox from a snapshot. `options` is a per-call override
+     * merged on top of the provider's static defaults.
+     */
+    restore(snapshot: SandboxSnapshot, options?: TOptions): Promise<Sandbox>;
     /** Delete a previously captured snapshot. No-op if already deleted. */
     deleteSnapshot(snapshot: SandboxSnapshot): Promise<void>;
-    fork(sandboxId: string): Promise<Sandbox>;
+    /**
+     * Fork a running sandbox into a new one. `options` is a per-call override
+     * merged on top of the provider's static defaults.
+     */
+    fork(sandboxId: string, options?: TOptions): Promise<Sandbox>;
 }
 interface SandboxOps<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TCtx = unknown> {
     createSandbox(options?: TOptions, ctx?: TCtx): Promise<{
@@ -129,12 +141,14 @@ interface SandboxOps<TOptions extends SandboxCreateOptions = SandboxCreateOption
     pauseSandbox(sandboxId: string): Promise<void>;
     /** Resume a paused sandbox. No-op if already running. */
     resumeSandbox(sandboxId: string): Promise<void>;
-    snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;
-    /** Create a fresh sandbox from a previously captured snapshot. */
-    restoreSandbox(snapshot: SandboxSnapshot): Promise<string>;
+    /** Capture a snapshot. `options` is a per-call override merged on top of provider defaults. */
+    snapshotSandbox(sandboxId: string, options?: TOptions): Promise<SandboxSnapshot>;
+    /** Create a fresh sandbox from a snapshot. `options` is a per-call override merged on top of provider defaults. */
+    restoreSandbox(snapshot: SandboxSnapshot, options?: TOptions): Promise<string>;
     /** Delete a previously captured snapshot. No-op if already deleted. */
     deleteSandboxSnapshot(snapshot: SandboxSnapshot): Promise<void>;
-    forkSandbox(sandboxId: string): Promise<string>;
+    /** Fork a running sandbox. `options` is a per-call override merged on top of provider defaults. */
+    forkSandbox(sandboxId: string, options?: TOptions): Promise<string>;
 }
 /**
  * Maps generic {@link SandboxOps} method names to adapter-prefixed names.

package/dist/{types-tQL9njTu.d.ts → types-yx0LzPGn.d.ts}

@@ -115,11 +115,23 @@ interface SandboxProvider<TOptions extends SandboxCreateOptions = SandboxCreateO
     pause(sandboxId: string, ttlSeconds?: number): Promise<void>;
     /** Resume a paused sandbox. No-op if already running. */
     resume(sandboxId: string): Promise<void>;
-    snapshot(sandboxId: string): Promise<SandboxSnapshot>;
-    restore(snapshot: SandboxSnapshot): Promise<Sandbox>;
+    /**
+     * Capture a snapshot of a running sandbox. `options` is a per-call override
+     * merged on top of the provider's static defaults.
+     */
+    snapshot(sandboxId: string, options?: TOptions): Promise<SandboxSnapshot>;
+    /**
+     * Restore a sandbox from a snapshot. `options` is a per-call override
+     * merged on top of the provider's static defaults.
+     */
+    restore(snapshot: SandboxSnapshot, options?: TOptions): Promise<Sandbox>;
     /** Delete a previously captured snapshot. No-op if already deleted. */
     deleteSnapshot(snapshot: SandboxSnapshot): Promise<void>;
-    fork(sandboxId: string): Promise<Sandbox>;
+    /**
+     * Fork a running sandbox into a new one. `options` is a per-call override
+     * merged on top of the provider's static defaults.
+     */
+    fork(sandboxId: string, options?: TOptions): Promise<Sandbox>;
 }
 interface SandboxOps<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TCtx = unknown> {
     createSandbox(options?: TOptions, ctx?: TCtx): Promise<{
@@ -129,12 +141,14 @@ interface SandboxOps<TOptions extends SandboxCreateOptions = SandboxCreateOption
     pauseSandbox(sandboxId: string): Promise<void>;
     /** Resume a paused sandbox. No-op if already running. */
     resumeSandbox(sandboxId: string): Promise<void>;
-    snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;
-    /** Create a fresh sandbox from a previously captured snapshot. */
-    restoreSandbox(snapshot: SandboxSnapshot): Promise<string>;
+    /** Capture a snapshot. `options` is a per-call override merged on top of provider defaults. */
+    snapshotSandbox(sandboxId: string, options?: TOptions): Promise<SandboxSnapshot>;
+    /** Create a fresh sandbox from a snapshot. `options` is a per-call override merged on top of provider defaults. */
+    restoreSandbox(snapshot: SandboxSnapshot, options?: TOptions): Promise<string>;
     /** Delete a previously captured snapshot. No-op if already deleted. */
     deleteSandboxSnapshot(snapshot: SandboxSnapshot): Promise<void>;
-    forkSandbox(sandboxId: string): Promise<string>;
+    /** Fork a running sandbox. `options` is a per-call override merged on top of provider defaults. */
+    forkSandbox(sandboxId: string, options?: TOptions): Promise<string>;
 }
 /**
  * Maps generic {@link SandboxOps} method names to adapter-prefixed names.

package/dist/{workflow-CjXHbZZc.d.ts → workflow-CSCkpwAL.d.ts}

@@ -1,5 +1,5 @@
-import { ao as ToolMap, _ as SessionConfig, az as ZeitlichSession, Y as SandboxShutdown, ag as ThreadInit, X as SandboxInit, t as JsonSerializable, B as BaseAgentState, o as AgentStateManager, aB as ToolRouterOptions, ar as ToolRouter, R as RouterContext, J as JsonValue, at as ToolWithHandler, v as ParsedToolCallUnion, ap as ToolNames, a6 as SubagentDefinition, a9 as SubagentHooks, aa as SubagentSandboxConfig, a5 as SubagentConfig, ab as SubagentSandboxShutdown, ac as SubagentSessionInput, a7 as SubagentFnResult, a3 as SessionStartHook, $ as SessionEndHook, D as PostToolUseHook, y as PostToolUseFailureHook, a1 as SessionExitReason, ah as TokenUsage, e as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, av as VirtualFileTree, j as TreeMutation, r as FileEntry, aw as VirtualFsOps, g as SkillMetadata, h as Skill, b as ToolHandlerResponse, am as ToolHandler, ay as WorkflowTask, c as ActivityToolHandler } from './types-CPKDl-y_.js';
-import { g as SandboxOps } from './types-tQL9njTu.js';
+import { aq as ToolMap, a0 as SessionConfig, aB as ZeitlichSession, _ as SandboxShutdown, ai as ThreadInit, Z as SandboxInit, t as JsonSerializable, B as BaseAgentState, o as AgentStateManager, aD as ToolRouterOptions, at as ToolRouter, R as RouterContext, J as JsonValue, av as ToolWithHandler, v as ParsedToolCallUnion, ar as ToolNames, a8 as SubagentDefinition, ab as SubagentHooks, ac as SubagentSandboxConfig, a7 as SubagentConfig, ad as SubagentSandboxShutdown, ae as SubagentSessionInput, a9 as SubagentFnResult, a5 as SessionStartHook, a1 as SessionEndHook, D as PostToolUseHook, y as PostToolUseFailureHook, a3 as SessionExitReason, aj as TokenUsage, e as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, ax as VirtualFileTree, j as TreeMutation, r as FileEntry, ay as VirtualFsOps, g as SkillMetadata, h as Skill, b as ToolHandlerResponse, ao as ToolHandler, aA as WorkflowTask, c as ActivityToolHandler } from './types-DNr31FzL.js';
+import { g as SandboxOps } from './types-yx0LzPGn.js';
 import z$1, { z } from 'zod';
 import { Sinks, proxyActivities } from '@temporalio/workflow';
 

package/dist/{workflow-Do_lzJpT.d.cts → workflow-DuvMZ8Vm.d.cts}

@@ -1,5 +1,5 @@
-import { ao as ToolMap, _ as SessionConfig, az as ZeitlichSession, Y as SandboxShutdown, ag as ThreadInit, X as SandboxInit, t as JsonSerializable, B as BaseAgentState, o as AgentStateManager, aB as ToolRouterOptions, ar as ToolRouter, R as RouterContext, J as JsonValue, at as ToolWithHandler, v as ParsedToolCallUnion, ap as ToolNames, a6 as SubagentDefinition, a9 as SubagentHooks, aa as SubagentSandboxConfig, a5 as SubagentConfig, ab as SubagentSandboxShutdown, ac as SubagentSessionInput, a7 as SubagentFnResult, a3 as SessionStartHook, $ as SessionEndHook, D as PostToolUseHook, y as PostToolUseFailureHook, a1 as SessionExitReason, ah as TokenUsage, e as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, av as VirtualFileTree, j as TreeMutation, r as FileEntry, aw as VirtualFsOps, g as SkillMetadata, h as Skill, b as ToolHandlerResponse, am as ToolHandler, ay as WorkflowTask, c as ActivityToolHandler } from './types-BO7Yju20.cjs';
-import { g as SandboxOps } from './types-tQL9njTu.cjs';
+import { aq as ToolMap, a0 as SessionConfig, aB as ZeitlichSession, _ as SandboxShutdown, ai as ThreadInit, Z as SandboxInit, t as JsonSerializable, B as BaseAgentState, o as AgentStateManager, aD as ToolRouterOptions, at as ToolRouter, R as RouterContext, J as JsonValue, av as ToolWithHandler, v as ParsedToolCallUnion, ar as ToolNames, a8 as SubagentDefinition, ab as SubagentHooks, ac as SubagentSandboxConfig, a7 as SubagentConfig, ad as SubagentSandboxShutdown, ae as SubagentSessionInput, a9 as SubagentFnResult, a5 as SessionStartHook, a1 as SessionEndHook, D as PostToolUseHook, y as PostToolUseFailureHook, a3 as SessionExitReason, aj as TokenUsage, e as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, ax as VirtualFileTree, j as TreeMutation, r as FileEntry, ay as VirtualFsOps, g as SkillMetadata, h as Skill, b as ToolHandlerResponse, ao as ToolHandler, aA as WorkflowTask, c as ActivityToolHandler } from './types-C06FwR96.cjs';
+import { g as SandboxOps } from './types-yx0LzPGn.cjs';
 import z$1, { z } from 'zod';
 import { Sinks, proxyActivities } from '@temporalio/workflow';