zeitlich 0.2.32 → 0.2.34

package/dist/{proxy-CTCYWjkr.d.cts → proxy-BesT2ioL.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-DlLajQcu.cjs';
 
 /**
  * Shared proxy helper for thread operations.

package/dist/{proxy-Br4unLTC.d.ts → proxy-Bz6wXYW-.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-BGLW5Zyj.js';
 
 /**
  * Shared proxy helper for thread operations.

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

@@ -1,6 +1,6 @@
 import Redis from 'ioredis';
 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-DPAZ3KCs.cjs';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;

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

@@ -1,6 +1,6 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-NJDyMyUx.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DPAZ3KCs.cjs';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];

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

@@ -1,6 +1,6 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BxiT8w9d.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BVUmLYpj.js';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];

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

@@ -1,6 +1,6 @@
 import Redis from 'ioredis';
 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-BVUmLYpj.js';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;

package/dist/{types-Bpq5fDI5.d.cts → types-BGLW5Zyj.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.
@@ -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
@@ -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;
 }
 
 /**
@@ -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-BxiT8w9d.d.ts → types-BVUmLYpj.d.ts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-CheCTLeV.js';
+import { J as JsonValue } from './types-BGLW5Zyj.js';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;

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-NJDyMyUx.d.cts → types-DPAZ3KCs.d.cts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-Bpq5fDI5.cjs';
+import { J as JsonValue } from './types-DlLajQcu.cjs';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;

package/dist/{types-CheCTLeV.d.ts → types-DlLajQcu.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.
@@ -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
@@ -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;
 }
 
 /**
@@ -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-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/{workflow-BWKQcz9d.d.cts → workflow-_ZGcacCK.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, 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-BGLW5Zyj.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),
  *   },
@@ -405,6 +405,34 @@ interface ZeitlichObservabilitySinks extends Sinks {
     };
 }
 
+/**
+ * Workflow-safe proxy for runAgent activities with LLM-optimised defaults.
+ *
+ * Resolves the activity name from the scope using the same convention as
+ * {@link createRunAgentActivity}: `run<Scope>`.
+ * When no scope is provided, defaults to `workflowInfo().workflowType`.
+ *
+ * Import this from `zeitlich/workflow` in your Temporal workflow files.
+ *
+ * @typeParam M - SDK-native message type (e.g. `StoredMessage` for LangChain,
+ *   `Anthropic.Messages.Message` for Anthropic, `Content` for Google GenAI).
+ *   Must be provided for `SessionResult.finalMessage` to be correctly typed.
+ *
+ * @example
+ * ```typescript
+ * import { proxyRunAgent } from 'zeitlich/workflow';
+ * import type { StoredMessage } from '@langchain/core/messages';
+ *
+ * // Auto-scoped to the current workflow name
+ * const runAgent = proxyRunAgent<StoredMessage>();
+ *
+ * // Explicit scope for subagents
+ * const runResearcher = proxyRunAgent<StoredMessage>("Researcher");
+ * ```
+ */
+
+declare function proxyRunAgent<M = unknown>(scope?: string, options?: Parameters<typeof proxyActivities>[0]): (config: RunAgentConfig) => Promise<AgentResponse<M>>;
+
 /**
  * Apply a list of {@link TreeMutation}s to the `fileTree` stored in a state
  * manager instance, updating it in place and returning the new tree.
@@ -747,4 +775,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { proxyVirtualFsOps as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskListHandler as C, createTaskUpdateHandler as D, createToolRouter as E, type FileEditArgs as F, type GlobArgs as G, defineSubagent as H, defineSubagentWorkflow as I, defineTool as J, defineWorkflow as K, editTool as L, filesWithMimeType as M, formatVirtualFileTree as N, type ObservabilityHooks as O, getShortId as P, globTool as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, type TaskCreateArgs as T, grepTool as U, hasDirectory as V, type WorkflowConfig as W, hasFileWithMimeType as X, hasNoOtherToolCalls as Y, type ZeitlichObservabilitySinks as Z, parseSkillFile as _, type FileReadArgs as a, readFileTool as a0, taskCreateTool as a1, taskGetTool as a2, taskListTool as a3, taskUpdateTool as a4, writeFileTool as a5, type FileWriteArgs as b, type FileTreeAccessor as c, type GrepArgs as d, type SessionStartedEvent as e, type SubagentArgs as f, type TaskGetArgs as g, type TaskListArgs as h, type TaskUpdateArgs as i, type ToolExecutedEvent as j, type TurnCompletedEvent as k, type WorkflowInput as l, type WorkflowSessionInput as m, applyVirtualTreeMutations as n, askUserQuestionTool as o, bashTool as p, composeHooks as q, createAgentStateManager as r, createAskUserQuestionHandler as s, createBashToolDescription as t, createObservabilityHooks as u, createReadSkillHandler as v, createReadSkillTool as w, createSession as x, createTaskCreateHandler as y, createTaskGetHandler as z };
+export { proxyRunAgent as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskListHandler as C, createTaskUpdateHandler as D, createToolRouter as E, type FileEditArgs as F, type GlobArgs as G, defineSubagent as H, defineSubagentWorkflow as I, defineTool as J, defineWorkflow as K, editTool as L, filesWithMimeType as M, formatVirtualFileTree as N, type ObservabilityHooks as O, getShortId as P, globTool as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, type TaskCreateArgs as T, grepTool as U, hasDirectory as V, type WorkflowConfig as W, hasFileWithMimeType as X, hasNoOtherToolCalls as Y, type ZeitlichObservabilitySinks as Z, parseSkillFile as _, type FileReadArgs as a, proxyVirtualFsOps as a0, readFileTool as a1, taskCreateTool as a2, taskGetTool as a3, taskListTool as a4, taskUpdateTool as a5, writeFileTool as a6, type FileWriteArgs as b, type FileTreeAccessor as c, type GrepArgs as d, type SessionStartedEvent as e, type SubagentArgs as f, type TaskGetArgs as g, type TaskListArgs as h, type TaskUpdateArgs as i, type ToolExecutedEvent as j, type TurnCompletedEvent as k, type WorkflowInput as l, type WorkflowSessionInput as m, applyVirtualTreeMutations as n, askUserQuestionTool as o, bashTool as p, composeHooks as q, createAgentStateManager as r, createAskUserQuestionHandler as s, createBashToolDescription as t, createObservabilityHooks as u, createReadSkillHandler as v, createReadSkillTool as w, createSession as x, createTaskCreateHandler as y, createTaskGetHandler as z };

package/dist/{workflow-D8wK7TJY.d.ts → workflow-hocXpLwg.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, 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-DlLajQcu.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),
  *   },
@@ -405,6 +405,34 @@ interface ZeitlichObservabilitySinks extends Sinks {
     };
 }
 
+/**
+ * Workflow-safe proxy for runAgent activities with LLM-optimised defaults.
+ *
+ * Resolves the activity name from the scope using the same convention as
+ * {@link createRunAgentActivity}: `run<Scope>`.
+ * When no scope is provided, defaults to `workflowInfo().workflowType`.
+ *
+ * Import this from `zeitlich/workflow` in your Temporal workflow files.
+ *
+ * @typeParam M - SDK-native message type (e.g. `StoredMessage` for LangChain,
+ *   `Anthropic.Messages.Message` for Anthropic, `Content` for Google GenAI).
+ *   Must be provided for `SessionResult.finalMessage` to be correctly typed.
+ *
+ * @example
+ * ```typescript
+ * import { proxyRunAgent } from 'zeitlich/workflow';
+ * import type { StoredMessage } from '@langchain/core/messages';
+ *
+ * // Auto-scoped to the current workflow name
+ * const runAgent = proxyRunAgent<StoredMessage>();
+ *
+ * // Explicit scope for subagents
+ * const runResearcher = proxyRunAgent<StoredMessage>("Researcher");
+ * ```
+ */
+
+declare function proxyRunAgent<M = unknown>(scope?: string, options?: Parameters<typeof proxyActivities>[0]): (config: RunAgentConfig) => Promise<AgentResponse<M>>;
+
 /**
  * Apply a list of {@link TreeMutation}s to the `fileTree` stored in a state
  * manager instance, updating it in place and returning the new tree.
@@ -747,4 +775,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { proxyVirtualFsOps as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskListHandler as C, createTaskUpdateHandler as D, createToolRouter as E, type FileEditArgs as F, type GlobArgs as G, defineSubagent as H, defineSubagentWorkflow as I, defineTool as J, defineWorkflow as K, editTool as L, filesWithMimeType as M, formatVirtualFileTree as N, type ObservabilityHooks as O, getShortId as P, globTool as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, type TaskCreateArgs as T, grepTool as U, hasDirectory as V, type WorkflowConfig as W, hasFileWithMimeType as X, hasNoOtherToolCalls as Y, type ZeitlichObservabilitySinks as Z, parseSkillFile as _, type FileReadArgs as a, readFileTool as a0, taskCreateTool as a1, taskGetTool as a2, taskListTool as a3, taskUpdateTool as a4, writeFileTool as a5, type FileWriteArgs as b, type FileTreeAccessor as c, type GrepArgs as d, type SessionStartedEvent as e, type SubagentArgs as f, type TaskGetArgs as g, type TaskListArgs as h, type TaskUpdateArgs as i, type ToolExecutedEvent as j, type TurnCompletedEvent as k, type WorkflowInput as l, type WorkflowSessionInput as m, applyVirtualTreeMutations as n, askUserQuestionTool as o, bashTool as p, composeHooks as q, createAgentStateManager as r, createAskUserQuestionHandler as s, createBashToolDescription as t, createObservabilityHooks as u, createReadSkillHandler as v, createReadSkillTool as w, createSession as x, createTaskCreateHandler as y, createTaskGetHandler as z };
+export { proxyRunAgent as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskListHandler as C, createTaskUpdateHandler as D, createToolRouter as E, type FileEditArgs as F, type GlobArgs as G, defineSubagent as H, defineSubagentWorkflow as I, defineTool as J, defineWorkflow as K, editTool as L, filesWithMimeType as M, formatVirtualFileTree as N, type ObservabilityHooks as O, getShortId as P, globTool as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, type TaskCreateArgs as T, grepTool as U, hasDirectory as V, type WorkflowConfig as W, hasFileWithMimeType as X, hasNoOtherToolCalls as Y, type ZeitlichObservabilitySinks as Z, parseSkillFile as _, type FileReadArgs as a, proxyVirtualFsOps as a0, readFileTool as a1, taskCreateTool as a2, taskGetTool as a3, taskListTool as a4, taskUpdateTool as a5, writeFileTool as a6, type FileWriteArgs as b, type FileTreeAccessor as c, type GrepArgs as d, type SessionStartedEvent as e, type SubagentArgs as f, type TaskGetArgs as g, type TaskListArgs as h, type TaskUpdateArgs as i, type ToolExecutedEvent as j, type TurnCompletedEvent as k, type WorkflowInput as l, type WorkflowSessionInput as m, applyVirtualTreeMutations as n, askUserQuestionTool as o, bashTool as p, composeHooks as q, createAgentStateManager as r, createAskUserQuestionHandler as s, createBashToolDescription as t, createObservabilityHooks as u, createReadSkillHandler as v, createReadSkillTool as w, createSession as x, createTaskCreateHandler as y, createTaskGetHandler as z };