zeitlich 0.2.21 → 0.2.23

package/dist/workflow.d.cts

@@ -1,36 +1,37 @@
-import { proxyActivities, ActivityInterfaceFor } from '@temporalio/workflow';
-import { k as SessionConfig, Z as ZeitlichSession, T as ThreadOps, f as JsonSerializable, e as AgentStateManager, q as SubagentDefinition, s as SubagentHooks, p as SubagentConfig, t as SubagentSessionInput, r as SubagentHandlerResponse, b as SkillMetadata, c as Skill } from './types-CES_30qx.cjs';
-export { A as AgentResponse, d as AgentState, H as Hooks, J as JsonPrimitive, g as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, P as PostHumanMessageAppendHook, h as PostHumanMessageAppendHookContext, i as PreHumanMessageAppendHook, j as PreHumanMessageAppendHookContext, R as RunAgentActivity, l as SessionEndHook, m as SessionEndHookContext, n as SessionStartHook, o as SessionStartHookContext, S as SkillProvider, u as SubagentWorkflow, v as SubagentWorkflowInput } from './types-CES_30qx.cjs';
-import { g as SandboxOps } from './types-BMRzfELQ.cjs';
-export { h as ExecOptions, E as ExecResult, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-BMRzfELQ.cjs';
-import { a as ToolMap, B as BaseAgentState, N as ToolRouterOptions, J as ToolRouter, R as RouterContext, K as ToolWithHandler, p as ParsedToolCallUnion, G as ToolNames, c as ToolHandlerResponse, E as ToolHandler, W as WorkflowTask, A as ActivityToolHandler } from './types-YbL7JpEA.cjs';
-export { l as AgentConfig, m as AgentFile, h as AgentStatus, n as AppendToolResultFn, C as ContentPart, I as InferToolResults, M as MessageContent, o as ParsedToolCall, q as PostToolUseFailureHook, r as PostToolUseFailureHookContext, d as PostToolUseFailureHookResult, s as PostToolUseHook, t as PostToolUseHookContext, u as PreToolUseHook, v as PreToolUseHookContext, P as PreToolUseHookResult, w as ProcessToolCallsContext, e as RawToolCall, g as RunAgentConfig, x as SerializableToolDefinition, S as SessionExitReason, y as TaskStatus, f as TokenUsage, z as ToolArgs, D as ToolCallResult, k as ToolCallResultUnion, i as ToolDefinition, F as ToolHooks, T as ToolMessageContent, H as ToolResult, j as ToolResultConfig, b as ToolRouterHooks, L as isTerminalStatus } from './types-YbL7JpEA.cjs';
+import { o as SessionConfig, Z as ZeitlichSession, n as SandboxShutdown, F as ThreadInit, m as SandboxInit, g as JsonSerializable, f as AgentStateManager, v as SubagentDefinition, y as SubagentHooks, z as SubagentSandboxConfig, u as SubagentConfig, B as SubagentSandboxShutdown, C as SubagentSessionInput, w as SubagentFnResult, c as SkillMetadata, d as Skill } from './types-DQW8l7pY.cjs';
+export { A as AgentResponse, e as AgentState, H as Hooks, J as JsonPrimitive, h as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, i as PostHumanMessageAppendHook, j as PostHumanMessageAppendHookContext, k as PreHumanMessageAppendHook, l as PreHumanMessageAppendHookContext, P as PrefixedThreadOps, R as RunAgentActivity, S as ScopedPrefix, p as SessionEndHook, q as SessionEndHookContext, r as SessionResult, s as SessionStartHook, t as SessionStartHookContext, b as SkillProvider, x as SubagentHandlerResponse, D as SubagentWorkflow, E as SubagentWorkflowInput, T as ThreadOps } from './types-DQW8l7pY.cjs';
+import { g as SandboxOps } from './types-ChAMwU3q.cjs';
+export { h as ExecOptions, E as ExecResult, P as PrefixedSandboxOps, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-ChAMwU3q.cjs';
+import { a as ToolMap, B as BaseAgentState, N as ToolRouterOptions, J as ToolRouter, R as RouterContext, K as ToolWithHandler, p as ParsedToolCallUnion, G as ToolNames, c as ToolHandlerResponse, E as ToolHandler, W as WorkflowTask, A as ActivityToolHandler } from './types-Bll19FZJ.cjs';
+export { l as AgentConfig, m as AgentFile, h as AgentStatus, n as AppendToolResultFn, C as ContentPart, I as InferToolResults, M as MessageContent, o as ParsedToolCall, q as PostToolUseFailureHook, r as PostToolUseFailureHookContext, d as PostToolUseFailureHookResult, s as PostToolUseHook, t as PostToolUseHookContext, u as PreToolUseHook, v as PreToolUseHookContext, P as PreToolUseHookResult, w as ProcessToolCallsContext, e as RawToolCall, g as RunAgentConfig, x as SerializableToolDefinition, S as SessionExitReason, y as TaskStatus, f as TokenUsage, z as ToolArgs, D as ToolCallResult, k as ToolCallResultUnion, i as ToolDefinition, F as ToolHooks, T as ToolMessageContent, H as ToolResult, j as ToolResultConfig, b as ToolRouterHooks, L as isTerminalStatus } from './types-Bll19FZJ.cjs';
 import z$1, { z } from 'zod';
-import { F as FileEntryMetadata, f as VirtualFileTree, T as TreeMutation, c as FileEntry } from './queries-CHa2iv_I.cjs';
-export { a as FileResolver, h as VirtualSandboxState, i as filesWithMimeType, j as hasDirectory, k as hasFileWithMimeType } from './queries-CHa2iv_I.cjs';
+import { a as FileEntryMetadata, e as VirtualFileTree, T as TreeMutation, F as FileEntry } from './types-BuXdFhaZ.cjs';
+export { b as FileResolver, g as VirtualSandboxState } from './types-BuXdFhaZ.cjs';
+export { f as filesWithMimeType, h as hasDirectory, a as hasFileWithMimeType } from './queries-DModcWRy.cjs';
 import '@temporalio/common';
+import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 
 /**
  * Creates an agent session that manages the agent loop: LLM invocation,
  * tool routing, subagent coordination, and lifecycle hooks.
  *
+ * When `sandboxOps` is provided the returned session result is guaranteed to
+ * include `sandboxId: string`. Without it, `sandboxId` is `undefined`.
+ *
  * @param config - Session and agent configuration (merged `SessionConfig` and `AgentConfig`)
  * @returns A session object with `runSession()` to start the agent loop
  *
  * @example
  * ```typescript
  * import { createSession, createAgentStateManager, defineTool, bashTool } from 'zeitlich/workflow';
- *
- * const stateManager = createAgentStateManager({
- *   initialState: { systemPrompt: "You are a helpful assistant." },
- *   agentName: "my-agent",
- * });
+ * import { proxyGoogleGenAIThreadOps } from 'zeitlich/adapters/thread/google-genai/workflow';
  *
  * const session = await createSession({
  *   agentName: "my-agent",
  *   maxTurns: 20,
- *   threadId: runId,
+ *   thread: { mode: "new" },
+ *   threadOps: proxyGoogleGenAIThreadOps(),
  *   runAgent: runAgentActivity,
  *   buildContextMessage: () => [{ type: "text", text: prompt }],
  *   subagents: [researcherSubagent],
@@ -42,57 +43,43 @@ import '@temporalio/common/lib/interfaces';
  * const { finalMessage, exitReason } = await session.runSession({ stateManager });
  * ```
  */
-declare const createSession: <T extends ToolMap, M = unknown>({ threadId: providedThreadId, agentName, maxTurns, metadata, runAgent, threadOps, buildContextMessage, subagents, skills, tools, processToolsInParallel, hooks, appendSystemPrompt, continueThread, waitForInputTimeout, sandbox: sandboxOps, sandboxId: inheritedSandboxId, }: SessionConfig<T, M>) => Promise<ZeitlichSession<M>>;
-/**
- * Proxy the adapter's thread operations as Temporal activities.
- * Call this in workflow code to delegate thread operations to the
- * adapter-provided activities registered on the worker.
- *
- * @example
- * ```typescript
- * const session = await createSession({
- *   threadOps: proxyDefaultThreadOps(),
- *   // ...
- * });
- * ```
- */
-declare function proxyDefaultThreadOps(options?: Parameters<typeof proxyActivities>[0]): ActivityInterfaceFor<ThreadOps>;
-/**
- * Proxy sandbox lifecycle operations as Temporal activities.
- * Call this in workflow code when the agent needs a sandbox.
- *
- * @example
- * ```typescript
- * const session = await createSession({
- *   sandbox: proxySandboxOps(),
- *   // ...
- * });
- * ```
- */
-declare function proxySandboxOps(options?: Parameters<typeof proxyActivities>[0]): SandboxOps;
+declare function createSession<T extends ToolMap, M = unknown>(config: SessionConfig<T, M> & {
+    sandboxOps: SandboxOps;
+}): Promise<ZeitlichSession<M, true>>;
+declare function createSession<T extends ToolMap, M = unknown>(config: SessionConfig<T, M>): Promise<ZeitlichSession<M, false>>;
 
 /**
  * Session config fields derived from a main workflow input, ready to spread
  * into `createSession`.
  */
 interface WorkflowSessionInput {
-    /** Thread ID to continue (set from `input.previousThreadId`) */
-    threadId?: string;
-    /** Whether to continue an existing thread (true when `previousThreadId` is present) */
-    continueThread?: boolean;
-    /** Optional sandbox ID forwarded to the session */
-    sandboxId?: string;
+    /** Agent name — spread directly into `createSession` */
+    agentName: string;
+    /** Thread initialization strategy */
+    thread?: ThreadInit;
+    /** Sandbox initialization strategy */
+    sandbox?: SandboxInit;
+    /** Sandbox shutdown policy (default: "destroy") */
+    sandboxShutdown?: SandboxShutdown;
 }
 /** Raw workflow input fields that map into `WorkflowSessionInput`. */
 interface WorkflowInput {
-    /** When set, continue this thread instead of starting fresh */
-    previousThreadId?: string;
-    /** Optional sandbox ID to reuse */
-    sandboxId?: string;
+    /** Thread initialization strategy (default: `{ mode: "new" }`) */
+    thread?: ThreadInit;
+    /** Sandbox initialization strategy */
+    sandbox?: SandboxInit;
 }
 interface WorkflowConfig {
     /** Workflow name — used as the Temporal workflow function name */
     name: string;
+    /**
+     * Sandbox shutdown policy applied when the main agent session exits.
+     *
+     * - `"destroy"` (default) — destroy the sandbox on exit.
+     * - `"pause"` — pause the sandbox so it can be resumed later.
+     * - `"keep"` — leave the sandbox running (no-op on exit).
+     */
+    sandboxShutdown?: SandboxShutdown;
 }
 /**
  * Wraps a main workflow function, translating workflow input fields into
@@ -101,8 +88,8 @@ interface WorkflowConfig {
  * The wrapper:
  * - Accepts a `config` with at least a `name` (used for Temporal workflow naming)
  * - Accepts a handler `fn` receiving `(input, sessionInput)`
- * - Derives `threadId` + `continueThread` from `workflowInput.previousThreadId`
- * - Derives `sandboxId` from `workflowInput.sandboxId`
+ * - Derives thread / sandbox init from `workflowInput`
+ * - Applies the configured `sandboxShutdown` policy
  */
 declare function defineWorkflow<TInput, TResult>(config: WorkflowConfig, fn: (input: TInput, sessionInput: WorkflowSessionInput) => Promise<TResult>): (input: TInput, workflowInput?: WorkflowInput) => Promise<TResult>;
 
@@ -228,8 +215,8 @@ type SubagentArgs = {
  *
  * // With parent-specific overrides
  * export const researcher = defineSubagent(researcherWorkflow, {
- *   allowThreadContinuation: true,
- *   sandbox: "own",
+ *   thread: "fork",
+ *   sandbox: { source: "own", shutdown: "pause" },
  *   hooks: {
  *     onPostExecution: ({ result }) => console.log(result),
  *   },
@@ -242,12 +229,12 @@ type SubagentArgs = {
  * ```
  */
 declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(definition: SubagentDefinition<TResult, TContext>, overrides?: {
-    context?: TContext;
+    context?: TContext | (() => TContext);
     hooks?: SubagentHooks<SubagentArgs, z.infer<TResult>>;
     enabled?: boolean | (() => boolean);
     taskQueue?: string;
-    allowThreadContinuation?: boolean;
-    sandbox?: "inherit" | "own";
+    thread?: "new" | "fork" | "continue";
+    sandbox?: SubagentSandboxConfig;
 }): SubagentConfig<TResult>;
 
 /**
@@ -296,15 +283,17 @@ declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext
  * });
  * ```
  */
-declare function defineSubagentWorkflow<TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+declare function defineSubagentWorkflow<TSandboxShutdown extends SubagentSandboxShutdown = "destroy", TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
     name: string;
     description: string;
-}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<null>>): SubagentDefinition<z.ZodNull, TContext>;
-declare function defineSubagentWorkflow<TResult extends z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+    sandboxShutdown?: TSandboxShutdown;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentFnResult<null, TSandboxShutdown>>): SubagentDefinition<z.ZodNull, TContext>;
+declare function defineSubagentWorkflow<TResult extends z.ZodType, TSandboxShutdown extends SubagentSandboxShutdown = "destroy", TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
     name: string;
     description: string;
     resultSchema: TResult;
-}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>): SubagentDefinition<TResult, TContext>;
+    sandboxShutdown?: TSandboxShutdown;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentFnResult<z.infer<TResult> | null, TSandboxShutdown>>): SubagentDefinition<TResult, TContext>;
 
 /**
  * Apply a list of {@link TreeMutation}s to the `fileTree` stored in a state
@@ -584,4 +573,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxOps, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentDefinition, SubagentHandlerResponse, SubagentHooks, SubagentSessionInput, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadOps, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, type WorkflowConfig, type WorkflowInput, type WorkflowSessionInput, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineSubagentWorkflow, defineTool, defineWorkflow, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };
+export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxInit, SandboxOps, SandboxShutdown, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentDefinition, SubagentFnResult, SubagentHooks, SubagentSandboxConfig, SubagentSandboxShutdown, SubagentSessionInput, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadInit, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, type WorkflowConfig, type WorkflowInput, type WorkflowSessionInput, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineSubagentWorkflow, defineTool, defineWorkflow, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };

package/dist/workflow.d.ts

@@ -1,36 +1,37 @@
-import { proxyActivities, ActivityInterfaceFor } from '@temporalio/workflow';
-import { k as SessionConfig, Z as ZeitlichSession, T as ThreadOps, f as JsonSerializable, e as AgentStateManager, q as SubagentDefinition, s as SubagentHooks, p as SubagentConfig, t as SubagentSessionInput, r as SubagentHandlerResponse, b as SkillMetadata, c as Skill } from './types-BkAYmc96.js';
-export { A as AgentResponse, d as AgentState, H as Hooks, J as JsonPrimitive, g as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, P as PostHumanMessageAppendHook, h as PostHumanMessageAppendHookContext, i as PreHumanMessageAppendHook, j as PreHumanMessageAppendHookContext, R as RunAgentActivity, l as SessionEndHook, m as SessionEndHookContext, n as SessionStartHook, o as SessionStartHookContext, S as SkillProvider, u as SubagentWorkflow, v as SubagentWorkflowInput } from './types-BkAYmc96.js';
-import { g as SandboxOps } from './types-BMRzfELQ.js';
-export { h as ExecOptions, E as ExecResult, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-BMRzfELQ.js';
-import { a as ToolMap, B as BaseAgentState, N as ToolRouterOptions, J as ToolRouter, R as RouterContext, K as ToolWithHandler, p as ParsedToolCallUnion, G as ToolNames, c as ToolHandlerResponse, E as ToolHandler, W as WorkflowTask, A as ActivityToolHandler } from './types-YbL7JpEA.js';
-export { l as AgentConfig, m as AgentFile, h as AgentStatus, n as AppendToolResultFn, C as ContentPart, I as InferToolResults, M as MessageContent, o as ParsedToolCall, q as PostToolUseFailureHook, r as PostToolUseFailureHookContext, d as PostToolUseFailureHookResult, s as PostToolUseHook, t as PostToolUseHookContext, u as PreToolUseHook, v as PreToolUseHookContext, P as PreToolUseHookResult, w as ProcessToolCallsContext, e as RawToolCall, g as RunAgentConfig, x as SerializableToolDefinition, S as SessionExitReason, y as TaskStatus, f as TokenUsage, z as ToolArgs, D as ToolCallResult, k as ToolCallResultUnion, i as ToolDefinition, F as ToolHooks, T as ToolMessageContent, H as ToolResult, j as ToolResultConfig, b as ToolRouterHooks, L as isTerminalStatus } from './types-YbL7JpEA.js';
+import { o as SessionConfig, Z as ZeitlichSession, n as SandboxShutdown, F as ThreadInit, m as SandboxInit, g as JsonSerializable, f as AgentStateManager, v as SubagentDefinition, y as SubagentHooks, z as SubagentSandboxConfig, u as SubagentConfig, B as SubagentSandboxShutdown, C as SubagentSessionInput, w as SubagentFnResult, c as SkillMetadata, d as Skill } from './types-B50pBPEV.js';
+export { A as AgentResponse, e as AgentState, H as Hooks, J as JsonPrimitive, h as JsonValue, M as ModelInvoker, a as ModelInvokerConfig, i as PostHumanMessageAppendHook, j as PostHumanMessageAppendHookContext, k as PreHumanMessageAppendHook, l as PreHumanMessageAppendHookContext, P as PrefixedThreadOps, R as RunAgentActivity, S as ScopedPrefix, p as SessionEndHook, q as SessionEndHookContext, r as SessionResult, s as SessionStartHook, t as SessionStartHookContext, b as SkillProvider, x as SubagentHandlerResponse, D as SubagentWorkflow, E as SubagentWorkflowInput, T as ThreadOps } from './types-B50pBPEV.js';
+import { g as SandboxOps } from './types-ChAMwU3q.js';
+export { h as ExecOptions, E as ExecResult, P as PrefixedSandboxOps, S as Sandbox, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, D as SandboxDirentEntry, F as SandboxFileStat, a as SandboxFileSystem, i as SandboxNotFoundError, j as SandboxNotSupportedError, b as SandboxProvider, f as SandboxSnapshot } from './types-ChAMwU3q.js';
+import { a as ToolMap, B as BaseAgentState, N as ToolRouterOptions, J as ToolRouter, R as RouterContext, K as ToolWithHandler, p as ParsedToolCallUnion, G as ToolNames, c as ToolHandlerResponse, E as ToolHandler, W as WorkflowTask, A as ActivityToolHandler } from './types-Bll19FZJ.js';
+export { l as AgentConfig, m as AgentFile, h as AgentStatus, n as AppendToolResultFn, C as ContentPart, I as InferToolResults, M as MessageContent, o as ParsedToolCall, q as PostToolUseFailureHook, r as PostToolUseFailureHookContext, d as PostToolUseFailureHookResult, s as PostToolUseHook, t as PostToolUseHookContext, u as PreToolUseHook, v as PreToolUseHookContext, P as PreToolUseHookResult, w as ProcessToolCallsContext, e as RawToolCall, g as RunAgentConfig, x as SerializableToolDefinition, S as SessionExitReason, y as TaskStatus, f as TokenUsage, z as ToolArgs, D as ToolCallResult, k as ToolCallResultUnion, i as ToolDefinition, F as ToolHooks, T as ToolMessageContent, H as ToolResult, j as ToolResultConfig, b as ToolRouterHooks, L as isTerminalStatus } from './types-Bll19FZJ.js';
 import z$1, { z } from 'zod';
-import { F as FileEntryMetadata, f as VirtualFileTree, T as TreeMutation, c as FileEntry } from './queries-6Avfh74U.js';
-export { a as FileResolver, h as VirtualSandboxState, i as filesWithMimeType, j as hasDirectory, k as hasFileWithMimeType } from './queries-6Avfh74U.js';
+import { a as FileEntryMetadata, e as VirtualFileTree, T as TreeMutation, F as FileEntry } from './types-GZ76HZSj.js';
+export { b as FileResolver, g as VirtualSandboxState } from './types-GZ76HZSj.js';
+export { f as filesWithMimeType, h as hasDirectory, a as hasFileWithMimeType } from './queries-byD0jr1Y.js';
 import '@temporalio/common';
+import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 
 /**
  * Creates an agent session that manages the agent loop: LLM invocation,
  * tool routing, subagent coordination, and lifecycle hooks.
  *
+ * When `sandboxOps` is provided the returned session result is guaranteed to
+ * include `sandboxId: string`. Without it, `sandboxId` is `undefined`.
+ *
  * @param config - Session and agent configuration (merged `SessionConfig` and `AgentConfig`)
  * @returns A session object with `runSession()` to start the agent loop
  *
  * @example
  * ```typescript
  * import { createSession, createAgentStateManager, defineTool, bashTool } from 'zeitlich/workflow';
- *
- * const stateManager = createAgentStateManager({
- *   initialState: { systemPrompt: "You are a helpful assistant." },
- *   agentName: "my-agent",
- * });
+ * import { proxyGoogleGenAIThreadOps } from 'zeitlich/adapters/thread/google-genai/workflow';
  *
  * const session = await createSession({
  *   agentName: "my-agent",
  *   maxTurns: 20,
- *   threadId: runId,
+ *   thread: { mode: "new" },
+ *   threadOps: proxyGoogleGenAIThreadOps(),
  *   runAgent: runAgentActivity,
  *   buildContextMessage: () => [{ type: "text", text: prompt }],
  *   subagents: [researcherSubagent],
@@ -42,57 +43,43 @@ import '@temporalio/common/lib/interfaces';
  * const { finalMessage, exitReason } = await session.runSession({ stateManager });
  * ```
  */
-declare const createSession: <T extends ToolMap, M = unknown>({ threadId: providedThreadId, agentName, maxTurns, metadata, runAgent, threadOps, buildContextMessage, subagents, skills, tools, processToolsInParallel, hooks, appendSystemPrompt, continueThread, waitForInputTimeout, sandbox: sandboxOps, sandboxId: inheritedSandboxId, }: SessionConfig<T, M>) => Promise<ZeitlichSession<M>>;
-/**
- * Proxy the adapter's thread operations as Temporal activities.
- * Call this in workflow code to delegate thread operations to the
- * adapter-provided activities registered on the worker.
- *
- * @example
- * ```typescript
- * const session = await createSession({
- *   threadOps: proxyDefaultThreadOps(),
- *   // ...
- * });
- * ```
- */
-declare function proxyDefaultThreadOps(options?: Parameters<typeof proxyActivities>[0]): ActivityInterfaceFor<ThreadOps>;
-/**
- * Proxy sandbox lifecycle operations as Temporal activities.
- * Call this in workflow code when the agent needs a sandbox.
- *
- * @example
- * ```typescript
- * const session = await createSession({
- *   sandbox: proxySandboxOps(),
- *   // ...
- * });
- * ```
- */
-declare function proxySandboxOps(options?: Parameters<typeof proxyActivities>[0]): SandboxOps;
+declare function createSession<T extends ToolMap, M = unknown>(config: SessionConfig<T, M> & {
+    sandboxOps: SandboxOps;
+}): Promise<ZeitlichSession<M, true>>;
+declare function createSession<T extends ToolMap, M = unknown>(config: SessionConfig<T, M>): Promise<ZeitlichSession<M, false>>;
 
 /**
  * Session config fields derived from a main workflow input, ready to spread
  * into `createSession`.
  */
 interface WorkflowSessionInput {
-    /** Thread ID to continue (set from `input.previousThreadId`) */
-    threadId?: string;
-    /** Whether to continue an existing thread (true when `previousThreadId` is present) */
-    continueThread?: boolean;
-    /** Optional sandbox ID forwarded to the session */
-    sandboxId?: string;
+    /** Agent name — spread directly into `createSession` */
+    agentName: string;
+    /** Thread initialization strategy */
+    thread?: ThreadInit;
+    /** Sandbox initialization strategy */
+    sandbox?: SandboxInit;
+    /** Sandbox shutdown policy (default: "destroy") */
+    sandboxShutdown?: SandboxShutdown;
 }
 /** Raw workflow input fields that map into `WorkflowSessionInput`. */
 interface WorkflowInput {
-    /** When set, continue this thread instead of starting fresh */
-    previousThreadId?: string;
-    /** Optional sandbox ID to reuse */
-    sandboxId?: string;
+    /** Thread initialization strategy (default: `{ mode: "new" }`) */
+    thread?: ThreadInit;
+    /** Sandbox initialization strategy */
+    sandbox?: SandboxInit;
 }
 interface WorkflowConfig {
     /** Workflow name — used as the Temporal workflow function name */
     name: string;
+    /**
+     * Sandbox shutdown policy applied when the main agent session exits.
+     *
+     * - `"destroy"` (default) — destroy the sandbox on exit.
+     * - `"pause"` — pause the sandbox so it can be resumed later.
+     * - `"keep"` — leave the sandbox running (no-op on exit).
+     */
+    sandboxShutdown?: SandboxShutdown;
 }
 /**
  * Wraps a main workflow function, translating workflow input fields into
@@ -101,8 +88,8 @@ interface WorkflowConfig {
  * The wrapper:
  * - Accepts a `config` with at least a `name` (used for Temporal workflow naming)
  * - Accepts a handler `fn` receiving `(input, sessionInput)`
- * - Derives `threadId` + `continueThread` from `workflowInput.previousThreadId`
- * - Derives `sandboxId` from `workflowInput.sandboxId`
+ * - Derives thread / sandbox init from `workflowInput`
+ * - Applies the configured `sandboxShutdown` policy
  */
 declare function defineWorkflow<TInput, TResult>(config: WorkflowConfig, fn: (input: TInput, sessionInput: WorkflowSessionInput) => Promise<TResult>): (input: TInput, workflowInput?: WorkflowInput) => Promise<TResult>;
 
@@ -228,8 +215,8 @@ type SubagentArgs = {
  *
  * // With parent-specific overrides
  * export const researcher = defineSubagent(researcherWorkflow, {
- *   allowThreadContinuation: true,
- *   sandbox: "own",
+ *   thread: "fork",
+ *   sandbox: { source: "own", shutdown: "pause" },
  *   hooks: {
  *     onPostExecution: ({ result }) => console.log(result),
  *   },
@@ -242,12 +229,12 @@ type SubagentArgs = {
  * ```
  */
 declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(definition: SubagentDefinition<TResult, TContext>, overrides?: {
-    context?: TContext;
+    context?: TContext | (() => TContext);
     hooks?: SubagentHooks<SubagentArgs, z.infer<TResult>>;
     enabled?: boolean | (() => boolean);
     taskQueue?: string;
-    allowThreadContinuation?: boolean;
-    sandbox?: "inherit" | "own";
+    thread?: "new" | "fork" | "continue";
+    sandbox?: SubagentSandboxConfig;
 }): SubagentConfig<TResult>;
 
 /**
@@ -296,15 +283,17 @@ declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext
  * });
  * ```
  */
-declare function defineSubagentWorkflow<TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+declare function defineSubagentWorkflow<TSandboxShutdown extends SubagentSandboxShutdown = "destroy", TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
     name: string;
     description: string;
-}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<null>>): SubagentDefinition<z.ZodNull, TContext>;
-declare function defineSubagentWorkflow<TResult extends z.ZodType, TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
+    sandboxShutdown?: TSandboxShutdown;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentFnResult<null, TSandboxShutdown>>): SubagentDefinition<z.ZodNull, TContext>;
+declare function defineSubagentWorkflow<TResult extends z.ZodType, TSandboxShutdown extends SubagentSandboxShutdown = "destroy", TContext extends Record<string, unknown> = Record<string, unknown>>(config: {
     name: string;
     description: string;
     resultSchema: TResult;
-}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentHandlerResponse<z.infer<TResult> | null>>): SubagentDefinition<TResult, TContext>;
+    sandboxShutdown?: TSandboxShutdown;
+}, fn: (prompt: string, sessionInput: SubagentSessionInput, context: TContext) => Promise<SubagentFnResult<z.infer<TResult> | null, TSandboxShutdown>>): SubagentDefinition<TResult, TContext>;
 
 /**
  * Apply a list of {@link TreeMutation}s to the `fileTree` stored in a state
@@ -584,4 +573,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxOps, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentDefinition, SubagentHandlerResponse, SubagentHooks, SubagentSessionInput, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadOps, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, type WorkflowConfig, type WorkflowInput, type WorkflowSessionInput, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineSubagentWorkflow, defineTool, defineWorkflow, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, proxyDefaultThreadOps, proxySandboxOps, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };
+export { ActivityToolHandler, AgentStateManager, type AskUserQuestionArgs, BaseAgentState, type BashArgs, type FileEditArgs, FileEntry, FileEntryMetadata, type FileReadArgs, type FileWriteArgs, type GlobArgs, type GrepArgs, JsonSerializable, ParsedToolCallUnion, type ReadSkillArgs, RouterContext, SandboxInit, SandboxOps, SandboxShutdown, SessionConfig, Skill, SkillMetadata, type SubagentArgs, SubagentConfig, SubagentDefinition, SubagentFnResult, SubagentHooks, SubagentSandboxConfig, SubagentSandboxShutdown, SubagentSessionInput, type TaskCreateArgs, type TaskGetArgs, type TaskListArgs, type TaskUpdateArgs, ThreadInit, ToolHandler, ToolHandlerResponse, ToolMap, ToolNames, ToolRouter, ToolWithHandler, TreeMutation, VirtualFileTree, type WorkflowConfig, type WorkflowInput, type WorkflowSessionInput, WorkflowTask, ZeitlichSession, applyVirtualTreeMutations, askUserQuestionTool, bashTool, createAgentStateManager, createAskUserQuestionHandler, createBashToolDescription, createReadSkillHandler, createReadSkillTool, createSession, createTaskCreateHandler, createTaskGetHandler, createTaskListHandler, createTaskUpdateHandler, createToolRouter, defineSubagent, defineSubagentWorkflow, defineTool, defineWorkflow, editTool, formatVirtualFileTree, getShortId, globTool, grepTool, hasNoOtherToolCalls, parseSkillFile, readFileTool, taskCreateTool, taskGetTool, taskListTool, taskUpdateTool, writeFileTool };