zeitlich 0.2.33 → 0.2.35

package/dist/{proxy-CTCYWjkr.d.cts → proxy-7RnVaPdJ.d.cts}

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

package/dist/{proxy-Br4unLTC.d.ts → proxy-BjdFGPTm.d.ts}

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

package/dist/{thread-manager-DKWxHUzD.d.ts → thread-manager-BBzNgQWH.d.cts}

@@ -1,9 +1,12 @@
 import Redis from 'ioredis';
+import { J as JsonValue } from './types-DQ1l_gXL.cjs';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BxiT8w9d.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-Mc_4BCfT.cjs';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;
+/** SDK-native content type for LangChain system messages */
+type LangChainSystemContent = string | MessageContent;
 type LangChainThreadManagerHooks = ThreadManagerHooks<StoredMessage, BaseMessage>;
 interface LangChainThreadManagerConfig {
     redis: Redis;
@@ -17,7 +20,7 @@ interface LangChainInvocationPayload {
     messages: BaseMessage[];
 }
 /** Thread manager with LangChain StoredMessage convenience helpers */
-interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, LangChainContent> {
+interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, LangChainContent, JsonValue, LangChainSystemContent> {
     appendAIMessage(id: string, content: string | MessageContent): Promise<void>;
     prepareForInvocation(): Promise<LangChainInvocationPayload>;
 }

package/dist/{thread-manager-CUubPYPH.d.cts → thread-manager-CbpiGq1L.d.ts}

@@ -1,9 +1,12 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-NJDyMyUx.cjs';
+import { J as JsonValue } from './types-CADc5V_P.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-yiXmqedU.js';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];
+/** SDK-native content type for Anthropic system prompts (supports cache_control blocks) */
+type AnthropicSystemContent = string | Anthropic.Messages.TextBlockParam[];
 /** A MessageParam with a unique ID for idempotent Redis storage */
 interface StoredMessage {
     id: string;
@@ -22,10 +25,10 @@ interface AnthropicThreadManagerConfig {
 /** Prepared payload ready to send to the Anthropic API */
 interface AnthropicInvocationPayload {
     messages: Anthropic.Messages.MessageParam[];
-    system?: string;
+    system?: string | Anthropic.Messages.TextBlockParam[];
 }
 /** Thread manager with Anthropic MessageParam convenience helpers */
-interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, AnthropicContent> {
+interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, AnthropicContent, JsonValue, AnthropicSystemContent> {
     appendAssistantMessage(id: string, content: Anthropic.Messages.ContentBlock[]): Promise<void>;
     prepareForInvocation(): Promise<AnthropicInvocationPayload>;
 }

package/dist/{thread-manager-Cv_BR28i.d.cts → thread-manager-DjN5JYul.d.ts}

@@ -1,9 +1,12 @@
 import Redis from 'ioredis';
+import { J as JsonValue } from './types-CADc5V_P.js';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-NJDyMyUx.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-yiXmqedU.js';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;
+/** SDK-native content type for LangChain system messages */
+type LangChainSystemContent = string | MessageContent;
 type LangChainThreadManagerHooks = ThreadManagerHooks<StoredMessage, BaseMessage>;
 interface LangChainThreadManagerConfig {
     redis: Redis;
@@ -17,7 +20,7 @@ interface LangChainInvocationPayload {
     messages: BaseMessage[];
 }
 /** Thread manager with LangChain StoredMessage convenience helpers */
-interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, LangChainContent> {
+interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, LangChainContent, JsonValue, LangChainSystemContent> {
     appendAIMessage(id: string, content: string | MessageContent): Promise<void>;
     prepareForInvocation(): Promise<LangChainInvocationPayload>;
 }

package/dist/{thread-manager-YJLoc1vH.d.ts → thread-manager-DzXm9eeI.d.cts}

@@ -1,9 +1,12 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BxiT8w9d.js';
+import { J as JsonValue } from './types-DQ1l_gXL.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-Mc_4BCfT.cjs';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];
+/** SDK-native content type for Anthropic system prompts (supports cache_control blocks) */
+type AnthropicSystemContent = string | Anthropic.Messages.TextBlockParam[];
 /** A MessageParam with a unique ID for idempotent Redis storage */
 interface StoredMessage {
     id: string;
@@ -22,10 +25,10 @@ interface AnthropicThreadManagerConfig {
 /** Prepared payload ready to send to the Anthropic API */
 interface AnthropicInvocationPayload {
     messages: Anthropic.Messages.MessageParam[];
-    system?: string;
+    system?: string | Anthropic.Messages.TextBlockParam[];
 }
 /** Thread manager with Anthropic MessageParam convenience helpers */
-interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, AnthropicContent> {
+interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, AnthropicContent, JsonValue, AnthropicSystemContent> {
     appendAssistantMessage(id: string, content: Anthropic.Messages.ContentBlock[]): Promise<void>;
     prepareForInvocation(): Promise<AnthropicInvocationPayload>;
 }

package/dist/{types-Bpq5fDI5.d.cts → types-CADc5V_P.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, g as SandboxOps } from './types-AujBIMMn.cjs';
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, g as SandboxOps } from './types-DxCpFNv_.js';
 
 /**
  * A tool definition with a name, description, and Zod schema for arguments.
@@ -424,9 +424,9 @@ interface AgentStateManager<TCustom extends JsonSerializable<TCustom>> {
     /** Get current turns */
     getTurns(): number;
     /** Get the system prompt */
-    getSystemPrompt(): string | undefined;
+    getSystemPrompt(): unknown;
     /** Set the system prompt */
-    setSystemPrompt(newSystemPrompt: string): void;
+    setSystemPrompt(newSystemPrompt: unknown): void;
     /** Get a custom state value by key */
     get<K extends keyof TCustom>(key: K): TCustom[K];
     /** Set a custom state value by key */
@@ -565,11 +565,11 @@ interface VirtualFsOps<TCtx = unknown, TMeta = FileEntryMetadata> {
  * @example
  * ```typescript
  * type Ops = PrefixedVirtualFsOps<"codingAgent">;
- * // → { codingAgentResolveFileTree: ... }
+ * // → { virtualFsCodingAgentResolveFileTree: ... }
  * ```
  */
 type PrefixedVirtualFsOps<TPrefix extends string, TCtx = unknown, TMeta = FileEntryMetadata> = {
-    [K in keyof VirtualFsOps<TCtx, TMeta> as `${TPrefix}${Capitalize<K & string>}`]: VirtualFsOps<TCtx, TMeta>[K];
+    [K in keyof VirtualFsOps<TCtx, TMeta> as `virtualFs${Capitalize<TPrefix>}${Capitalize<K & string>}`]: VirtualFsOps<TCtx, TMeta>[K];
 };
 /**
  * The portion of workflow `AgentState` that the virtual filesystem reads via
@@ -608,7 +608,7 @@ interface BaseAgentState {
     /** In-memory file contents keyed by path, bypassing the resolver (e.g. skill resources). */
     inlineFiles?: Record<string, string>;
     virtualFsCtx?: unknown;
-    systemPrompt?: string;
+    systemPrompt?: unknown;
     totalInputTokens: number;
     totalOutputTokens: number;
     cachedWriteTokens: number;
@@ -803,8 +803,9 @@ type ThreadInit = {
  * - `"new"` — create a fresh sandbox. Optionally pass `ctx` to
  *   have the {@link SandboxManager}'s resolver produce creation options
  *   (e.g. initial files) from workflow arguments.
- * - `"continue"` — resume a previously-paused sandbox (this session takes
- *   ownership and the shutdown policy applies on exit).
+ * - `"continue"` — take ownership of an existing sandbox (paused or running).
+ *   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.
  * - `"inherit"` — use a sandbox owned by someone else (e.g. a parent agent).
@@ -837,8 +838,10 @@ type SandboxShutdown = "destroy" | "pause" | "keep";
  * Includes all base {@link SandboxShutdown} values plus:
  * - `"pause-until-parent-close"` — pause the sandbox on exit, then wait for
  *   the parent workflow to signal when to destroy it.
+ * - `"keep-until-parent-close"` — leave the sandbox running on exit, then
+ *   wait for the parent workflow to signal when to destroy it.
  */
-type SubagentSandboxShutdown = SandboxShutdown | "pause-until-parent-close";
+type SubagentSandboxShutdown = SandboxShutdown | "pause-until-parent-close" | "keep-until-parent-close";
 
 /** ToolHandlerResponse with threadId required (subagents must always surface their thread) */
 type SubagentHandlerResponse<TResult = null, TToolResponse = JsonValue> = ToolHandlerResponse<TResult, TToolResponse> & {
@@ -872,16 +875,23 @@ type SubagentContext = Record<string, unknown> | (() => Record<string, unknown>)
 /**
  * Sandbox configuration for a subagent.
  *
- * String shorthands:
  * - `"none"` — no sandbox (default).
- * - `"inherit"` — reuse the parent's sandbox (shared filesystem/exec).
- * - `"own"` — the child creates and owns its own sandbox (shutdown defaults to `"destroy"`).
- *
- * Object form (only for `source: "own"`):
- * - `{ source: "own", shutdown?: SubagentSandboxShutdown }` — own sandbox with explicit shutdown policy.
- */
-type SubagentSandboxConfig = "none" | "inherit" | "own" | {
+ * - `{ source: "inherit", continuation }` — reuse the parent's sandbox.
+ *   `continuation: "continue"` shares the parent sandbox directly;
+ *   `continuation: "fork"` forks from the parent on every call.
+ * - `{ source: "own", init?, continuation }` — the child gets its own sandbox.
+ *   `init: "per-call"` (default) creates fresh each call (thread continuation
+ *   uses the previous sandbox). `init: "once"` creates on the first call and
+ *   stores it for all subsequent calls.
+ */
+type SubagentSandboxConfig = "none" | {
+    source: "inherit";
+    continuation: "continue" | "fork";
+    shutdown?: SubagentSandboxShutdown;
+} | {
     source: "own";
+    init?: "per-call" | "once";
+    continuation: "continue" | "fork";
     shutdown?: SubagentSandboxShutdown;
 };
 /**
@@ -919,9 +929,6 @@ interface SubagentConfig<TResult extends z.ZodType = z.ZodType> {
     /**
      * Sandbox strategy for this subagent.
      *
-     * String shorthands: `"none"` (default) | `"inherit"` | `"own"`.
-     * Object form: `{ source: "own", shutdown?: SubagentSandboxShutdown }`.
-     *
      * @see {@link SubagentSandboxConfig}
      */
     sandbox?: SubagentSandboxConfig;
@@ -959,10 +966,11 @@ interface SubagentHooks<TArgs = unknown, TResult = unknown> {
  * Extended response from the subagent `fn` — includes optional cleanup callbacks
  * stripped before signaling the parent.
  *
- * When `TSandboxShutdown` is `"pause-until-parent-close"`, both `destroySandbox`
- * and `sandboxId` become required so the parent can coordinate cleanup.
+ * When `TSandboxShutdown` is `"pause-until-parent-close"` or
+ * `"keep-until-parent-close"`, both `destroySandbox` and `sandboxId` become
+ * required so the parent can coordinate cleanup.
  */
-type SubagentFnResult<TResult = null, TSandboxShutdown extends SubagentSandboxShutdown = SubagentSandboxShutdown> = SubagentHandlerResponse<TResult> & (TSandboxShutdown extends "pause-until-parent-close" ? {
+type SubagentFnResult<TResult = null, TSandboxShutdown extends SubagentSandboxShutdown = SubagentSandboxShutdown> = SubagentHandlerResponse<TResult> & (TSandboxShutdown extends "pause-until-parent-close" | "keep-until-parent-close" ? {
     destroySandbox: () => Promise<void>;
     sandboxId: string;
 } : {
@@ -980,6 +988,8 @@ interface SubagentSessionInput {
     sandbox?: SandboxInit;
     /** Sandbox shutdown policy (default: "destroy") */
     sandboxShutdown?: SubagentSandboxShutdown;
+    /** Called by the session as soon as the sandbox is created, before the agent loop starts. */
+    onSandboxReady?: (sandboxId: string) => void;
 }
 
 /**
@@ -1082,7 +1092,7 @@ interface ThreadOps<TContent = string> {
     /** Append the model's response to the thread */
     appendAgentMessage(threadId: string, id: string, message: unknown, threadKey?: string): Promise<void>;
     /** Append a system message to the thread */
-    appendSystemMessage(threadId: string, id: string, content: string, threadKey?: string): Promise<void>;
+    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>;
 }
@@ -1186,6 +1196,11 @@ interface SessionConfig<T extends ToolMap, M = unknown, TContent = string> {
      * Has no effect when the sandbox is inherited (`sandbox.mode === "inherit"`).
      */
     sandboxShutdown?: SubagentSandboxShutdown;
+    /**
+     * Called as soon as the sandbox is created (or resumed/forked), before the
+     * agent loop starts. Useful for signalling sandbox readiness to a parent.
+     */
+    onSandboxReady?: (sandboxId: string) => void;
     virtualFsOps?: VirtualFsOps;
     /**
      * Virtual filesystem configuration (optional — independent of sandbox).

package/dist/{types-DUvEZSDe.d.cts → types-CBH54cwr.d.cts}

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

package/dist/{types-CheCTLeV.d.ts → types-DQ1l_gXL.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, g as SandboxOps } from './types-AujBIMMn.js';
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, g as SandboxOps } from './types-DxCpFNv_.cjs';
 
 /**
  * A tool definition with a name, description, and Zod schema for arguments.
@@ -424,9 +424,9 @@ interface AgentStateManager<TCustom extends JsonSerializable<TCustom>> {
     /** Get current turns */
     getTurns(): number;
     /** Get the system prompt */
-    getSystemPrompt(): string | undefined;
+    getSystemPrompt(): unknown;
     /** Set the system prompt */
-    setSystemPrompt(newSystemPrompt: string): void;
+    setSystemPrompt(newSystemPrompt: unknown): void;
     /** Get a custom state value by key */
     get<K extends keyof TCustom>(key: K): TCustom[K];
     /** Set a custom state value by key */
@@ -565,11 +565,11 @@ interface VirtualFsOps<TCtx = unknown, TMeta = FileEntryMetadata> {
  * @example
  * ```typescript
  * type Ops = PrefixedVirtualFsOps<"codingAgent">;
- * // → { codingAgentResolveFileTree: ... }
+ * // → { virtualFsCodingAgentResolveFileTree: ... }
  * ```
  */
 type PrefixedVirtualFsOps<TPrefix extends string, TCtx = unknown, TMeta = FileEntryMetadata> = {
-    [K in keyof VirtualFsOps<TCtx, TMeta> as `${TPrefix}${Capitalize<K & string>}`]: VirtualFsOps<TCtx, TMeta>[K];
+    [K in keyof VirtualFsOps<TCtx, TMeta> as `virtualFs${Capitalize<TPrefix>}${Capitalize<K & string>}`]: VirtualFsOps<TCtx, TMeta>[K];
 };
 /**
  * The portion of workflow `AgentState` that the virtual filesystem reads via
@@ -608,7 +608,7 @@ interface BaseAgentState {
     /** In-memory file contents keyed by path, bypassing the resolver (e.g. skill resources). */
     inlineFiles?: Record<string, string>;
     virtualFsCtx?: unknown;
-    systemPrompt?: string;
+    systemPrompt?: unknown;
     totalInputTokens: number;
     totalOutputTokens: number;
     cachedWriteTokens: number;
@@ -803,8 +803,9 @@ type ThreadInit = {
  * - `"new"` — create a fresh sandbox. Optionally pass `ctx` to
  *   have the {@link SandboxManager}'s resolver produce creation options
  *   (e.g. initial files) from workflow arguments.
- * - `"continue"` — resume a previously-paused sandbox (this session takes
- *   ownership and the shutdown policy applies on exit).
+ * - `"continue"` — take ownership of an existing sandbox (paused or running).
+ *   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.
  * - `"inherit"` — use a sandbox owned by someone else (e.g. a parent agent).
@@ -837,8 +838,10 @@ type SandboxShutdown = "destroy" | "pause" | "keep";
  * Includes all base {@link SandboxShutdown} values plus:
  * - `"pause-until-parent-close"` — pause the sandbox on exit, then wait for
  *   the parent workflow to signal when to destroy it.
+ * - `"keep-until-parent-close"` — leave the sandbox running on exit, then
+ *   wait for the parent workflow to signal when to destroy it.
  */
-type SubagentSandboxShutdown = SandboxShutdown | "pause-until-parent-close";
+type SubagentSandboxShutdown = SandboxShutdown | "pause-until-parent-close" | "keep-until-parent-close";
 
 /** ToolHandlerResponse with threadId required (subagents must always surface their thread) */
 type SubagentHandlerResponse<TResult = null, TToolResponse = JsonValue> = ToolHandlerResponse<TResult, TToolResponse> & {
@@ -872,16 +875,23 @@ type SubagentContext = Record<string, unknown> | (() => Record<string, unknown>)
 /**
  * Sandbox configuration for a subagent.
  *
- * String shorthands:
  * - `"none"` — no sandbox (default).
- * - `"inherit"` — reuse the parent's sandbox (shared filesystem/exec).
- * - `"own"` — the child creates and owns its own sandbox (shutdown defaults to `"destroy"`).
- *
- * Object form (only for `source: "own"`):
- * - `{ source: "own", shutdown?: SubagentSandboxShutdown }` — own sandbox with explicit shutdown policy.
- */
-type SubagentSandboxConfig = "none" | "inherit" | "own" | {
+ * - `{ source: "inherit", continuation }` — reuse the parent's sandbox.
+ *   `continuation: "continue"` shares the parent sandbox directly;
+ *   `continuation: "fork"` forks from the parent on every call.
+ * - `{ source: "own", init?, continuation }` — the child gets its own sandbox.
+ *   `init: "per-call"` (default) creates fresh each call (thread continuation
+ *   uses the previous sandbox). `init: "once"` creates on the first call and
+ *   stores it for all subsequent calls.
+ */
+type SubagentSandboxConfig = "none" | {
+    source: "inherit";
+    continuation: "continue" | "fork";
+    shutdown?: SubagentSandboxShutdown;
+} | {
     source: "own";
+    init?: "per-call" | "once";
+    continuation: "continue" | "fork";
     shutdown?: SubagentSandboxShutdown;
 };
 /**
@@ -919,9 +929,6 @@ interface SubagentConfig<TResult extends z.ZodType = z.ZodType> {
     /**
      * Sandbox strategy for this subagent.
      *
-     * String shorthands: `"none"` (default) | `"inherit"` | `"own"`.
-     * Object form: `{ source: "own", shutdown?: SubagentSandboxShutdown }`.
-     *
      * @see {@link SubagentSandboxConfig}
      */
     sandbox?: SubagentSandboxConfig;
@@ -959,10 +966,11 @@ interface SubagentHooks<TArgs = unknown, TResult = unknown> {
  * Extended response from the subagent `fn` — includes optional cleanup callbacks
  * stripped before signaling the parent.
  *
- * When `TSandboxShutdown` is `"pause-until-parent-close"`, both `destroySandbox`
- * and `sandboxId` become required so the parent can coordinate cleanup.
+ * When `TSandboxShutdown` is `"pause-until-parent-close"` or
+ * `"keep-until-parent-close"`, both `destroySandbox` and `sandboxId` become
+ * required so the parent can coordinate cleanup.
  */
-type SubagentFnResult<TResult = null, TSandboxShutdown extends SubagentSandboxShutdown = SubagentSandboxShutdown> = SubagentHandlerResponse<TResult> & (TSandboxShutdown extends "pause-until-parent-close" ? {
+type SubagentFnResult<TResult = null, TSandboxShutdown extends SubagentSandboxShutdown = SubagentSandboxShutdown> = SubagentHandlerResponse<TResult> & (TSandboxShutdown extends "pause-until-parent-close" | "keep-until-parent-close" ? {
     destroySandbox: () => Promise<void>;
     sandboxId: string;
 } : {
@@ -980,6 +988,8 @@ interface SubagentSessionInput {
     sandbox?: SandboxInit;
     /** Sandbox shutdown policy (default: "destroy") */
     sandboxShutdown?: SubagentSandboxShutdown;
+    /** Called by the session as soon as the sandbox is created, before the agent loop starts. */
+    onSandboxReady?: (sandboxId: string) => void;
 }
 
 /**
@@ -1082,7 +1092,7 @@ interface ThreadOps<TContent = string> {
     /** Append the model's response to the thread */
     appendAgentMessage(threadId: string, id: string, message: unknown, threadKey?: string): Promise<void>;
     /** Append a system message to the thread */
-    appendSystemMessage(threadId: string, id: string, content: string, threadKey?: string): Promise<void>;
+    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>;
 }
@@ -1186,6 +1196,11 @@ interface SessionConfig<T extends ToolMap, M = unknown, TContent = string> {
      * Has no effect when the sandbox is inherited (`sandbox.mode === "inherit"`).
      */
     sandboxShutdown?: SubagentSandboxShutdown;
+    /**
+     * Called as soon as the sandbox is created (or resumed/forked), before the
+     * agent loop starts. Useful for signalling sandbox readiness to a parent.
+     */
+    onSandboxReady?: (sandboxId: string) => void;
     virtualFsOps?: VirtualFsOps;
     /**
      * Virtual filesystem configuration (optional — independent of sandbox).

package/dist/{types-AujBIMMn.d.cts → types-DxCpFNv_.d.cts}

@@ -94,6 +94,8 @@ interface SandboxProvider<TOptions extends SandboxCreateOptions = SandboxCreateO
     get(sandboxId: string): Promise<TSandbox>;
     destroy(sandboxId: string): Promise<void>;
     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>;
     fork(sandboxId: string): Promise<Sandbox>;
@@ -104,6 +106,8 @@ interface SandboxOps<TOptions extends SandboxCreateOptions = SandboxCreateOption
     } | null>;
     destroySandbox(sandboxId: string): Promise<void>;
     pauseSandbox(sandboxId: string): Promise<void>;
+    /** Resume a paused sandbox. No-op if already running. */
+    resumeSandbox(sandboxId: string): Promise<void>;
     snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;
     forkSandbox(sandboxId: string): Promise<string>;
 }

package/dist/{types-AujBIMMn.d.ts → types-DxCpFNv_.d.ts}

@@ -94,6 +94,8 @@ interface SandboxProvider<TOptions extends SandboxCreateOptions = SandboxCreateO
     get(sandboxId: string): Promise<TSandbox>;
     destroy(sandboxId: string): Promise<void>;
     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>;
     fork(sandboxId: string): Promise<Sandbox>;
@@ -104,6 +106,8 @@ interface SandboxOps<TOptions extends SandboxCreateOptions = SandboxCreateOption
     } | null>;
     destroySandbox(sandboxId: string): Promise<void>;
     pauseSandbox(sandboxId: string): Promise<void>;
+    /** Resume a paused sandbox. No-op if already running. */
+    resumeSandbox(sandboxId: string): Promise<void>;
     snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;
     forkSandbox(sandboxId: string): Promise<string>;
 }

package/dist/{types-NJDyMyUx.d.cts → types-Mc_4BCfT.d.cts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-Bpq5fDI5.cjs';
+import { J as JsonValue } from './types-DQ1l_gXL.cjs';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;
@@ -64,9 +64,9 @@ interface ThreadManagerHooks<TStored, TPrepared = TStored> {
     /** Called for each SDK-native message after all processing, right before the payload is returned */
     onPreparedMessage?: (message: TPrepared, index: number, messages: readonly TPrepared[]) => TPrepared;
 }
-interface ProviderThreadManager<TStored, TContent = string, TToolContent = JsonValue> extends BaseThreadManager<TStored> {
+interface ProviderThreadManager<TStored, TContent = string, TToolContent = JsonValue, TSystemContent = string> extends BaseThreadManager<TStored> {
     appendUserMessage(id: string, content: TContent): Promise<void>;
-    appendSystemMessage(id: string, content: string): Promise<void>;
+    appendSystemMessage(id: string, content: TSystemContent): Promise<void>;
     appendToolResult(id: string, toolCallId: string, toolName: string, content: TToolContent): Promise<void>;
 }
 

package/dist/{types-DBk-C8zM.d.ts → types-wiGLvxWf.d.ts}

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

package/dist/{types-BxiT8w9d.d.ts → types-yiXmqedU.d.ts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-CheCTLeV.js';
+import { J as JsonValue } from './types-CADc5V_P.js';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;
@@ -64,9 +64,9 @@ interface ThreadManagerHooks<TStored, TPrepared = TStored> {
     /** Called for each SDK-native message after all processing, right before the payload is returned */
     onPreparedMessage?: (message: TPrepared, index: number, messages: readonly TPrepared[]) => TPrepared;
 }
-interface ProviderThreadManager<TStored, TContent = string, TToolContent = JsonValue> extends BaseThreadManager<TStored> {
+interface ProviderThreadManager<TStored, TContent = string, TToolContent = JsonValue, TSystemContent = string> extends BaseThreadManager<TStored> {
     appendUserMessage(id: string, content: TContent): Promise<void>;
-    appendSystemMessage(id: string, content: string): Promise<void>;
+    appendSystemMessage(id: string, content: TSystemContent): Promise<void>;
     appendToolResult(id: string, toolCallId: string, toolName: string, content: TToolContent): Promise<void>;
 }
 

package/dist/{workflow-Od9vx5Jk.d.cts → workflow-DhtWRovz.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-Bpq5fDI5.cjs';
-import { g as SandboxOps } from './types-AujBIMMn.cjs';
+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-DQ1l_gXL.cjs';
+import { g as SandboxOps } from './types-DxCpFNv_.cjs';
 import z$1, { z } from 'zod';
 import { Sinks, proxyActivities } from '@temporalio/workflow';
 
@@ -207,7 +207,7 @@ type SubagentArgs = {
  * // With parent-specific overrides
  * export const researcher = defineSubagent(researcherWorkflow, {
  *   thread: "fork",
- *   sandbox: { source: "own", shutdown: "pause" },
+ *   sandbox: { source: "own", continuation: "fork", shutdown: "pause" },
  *   hooks: {
  *     onPostExecution: ({ result }) => console.log(result),
  *   },

package/dist/{workflow-D9nNERvs.d.ts → workflow-P2pTSfKu.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-CheCTLeV.js';
-import { g as SandboxOps } from './types-AujBIMMn.js';
+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-CADc5V_P.js';
+import { g as SandboxOps } from './types-DxCpFNv_.js';
 import z$1, { z } from 'zod';
 import { Sinks, proxyActivities } from '@temporalio/workflow';
 
@@ -207,7 +207,7 @@ type SubagentArgs = {
  * // With parent-specific overrides
  * export const researcher = defineSubagent(researcherWorkflow, {
  *   thread: "fork",
- *   sandbox: { source: "own", shutdown: "pause" },
+ *   sandbox: { source: "own", continuation: "fork", shutdown: "pause" },
  *   hooks: {
  *     onPostExecution: ({ result }) => console.log(result),
  *   },