zeitlich 0.2.40 → 0.2.42

package/dist/index.d.cts

@@ -1,15 +1,15 @@
-import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-DhplIN65.cjs';
-export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadListKey, X as getThreadMetaKey, Y as globTool, _ as grepTool, $ as hasDirectory, a0 as hasFileWithMimeType, a1 as hasNoOtherToolCalls, a2 as parseSkillFile, a3 as proxyRunAgent, a4 as proxyVirtualFsOps, a5 as readFileTool, a6 as taskCreateTool, a7 as taskGetTool, a8 as taskListTool, a9 as taskUpdateTool, aa as writeFileTool } from './workflow-DhplIN65.cjs';
-import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-Cn2r3ol3.cjs';
-export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionResult, a6 as SessionStartHook, a7 as SessionStartHookContext, a8 as SubagentChildWorkflowOptions, a9 as SubagentConfig, aa as SubagentDefinition, ab as SubagentFnResult, ac as SubagentHandlerResponse, ad as SubagentHooks, ae as SubagentSandboxConfig, af as SubagentSandboxShutdown, ag as SubagentSessionInput, ah as SubagentWorkflow, ai as SubagentWorkflowInput, aj as TaskStatus, ak as ThreadInit, T as ThreadOps, al as TokenUsage, am as ToolArgs, an as ToolCallResult, ao as ToolCallResultUnion, ap as ToolDefinition, aq as ToolHandler, ar as ToolHooks, as as ToolMap, at as ToolNames, au as ToolResult, av as ToolRouter, aw as ToolRouterHooks, ax as ToolWithHandler, ay as VirtualFileSystem, az as VirtualFileTree, aA as VirtualFsOps, aB as VirtualFsState, aC as WorkflowTask, aD as ZeitlichSession, aE as isTerminalStatus } from './types-Cn2r3ol3.cjs';
-import { S as Sandbox, a as SandboxFileSystem, d as SandboxCreateOptions, b as SandboxProvider, f as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-yx0LzPGn.cjs';
-export { h as ExecOptions, c as SandboxCapabilities, e as SandboxCreateResult, i as SandboxNotFoundError, j as SandboxNotSupportedError, g as SandboxOps } from './types-yx0LzPGn.cjs';
+import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-DMmiaw6w.cjs';
+export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadListKey, X as getThreadMetaKey, Y as globTool, _ as grepTool, $ as hasDirectory, a0 as hasFileWithMimeType, a1 as hasNoOtherToolCalls, a2 as parseSkillFile, a3 as proxyRunAgent, a4 as proxyVirtualFsOps, a5 as readFileTool, a6 as taskCreateTool, a7 as taskGetTool, a8 as taskListTool, a9 as taskUpdateTool, aa as writeFileTool } from './workflow-DMmiaw6w.cjs';
+import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-CdALEF3z.cjs';
+export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-CdALEF3z.cjs';
+import { b as Sandbox, c as SandboxFileSystem, a as SandboxCreateOptions, h as SandboxCapability, d as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-CJ7tCdl6.cjs';
+export { i as ExecOptions, e as SandboxCapabilities, f as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, S as SandboxOps } from './types-CJ7tCdl6.cjs';
 import { WorkflowClient } from '@temporalio/client';
-import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-CuISs0Ub.cjs';
-export { P as ProviderThreadManager } from './types-CuISs0Ub.cjs';
+import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-C66-BVBr.cjs';
+export { P as ProviderThreadManager } from './types-C66-BVBr.cjs';
 import 'zod';
-import '@temporalio/workflow';
 import '@temporalio/common';
+import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'ioredis';
 
@@ -42,6 +42,32 @@ import 'ioredis';
  */
 declare function withAutoAppend<TArgs, TResult, TContext extends RouterContext = RouterContext, TToolResponse = unknown>(threadHandler: (id: string, config: ToolResultConfig) => Promise<void>, handler: ActivityToolHandler<TArgs, TResult, TContext, TToolResponse>): ActivityToolHandler<TArgs, TResult, TContext>;
 
+/**
+ * Options for {@link withSandbox}.
+ */
+interface WithSandboxOptions {
+    /**
+     * If `true`, a {@link SandboxNotFoundError} thrown by `manager.getSandbox`
+     * is translated into a structured tool-handler response (instead of
+     * propagating). This lets the agent return a graceful error to the model
+     * rather than crashing the workflow when the backing sandbox has been
+     * killed mid-run (e.g. because the E2B `timeoutMs` lifetime elapsed).
+     *
+     * Off by default to preserve the existing contract for callers that rely
+     * on the error bubbling out. New callers should generally enable this in
+     * combination with the E2B `keepAliveMs` provider option.
+     *
+     * @default false
+     */
+    translateSandboxNotFound?: boolean;
+    /**
+     * Custom tool response returned to the agent when the backing sandbox
+     * is not found and `translateSandboxNotFound` is `true`. Defaults to a
+     * generic English message. Use this to localize, match agent persona,
+     * or give the model more specific recovery instructions.
+     */
+    sandboxNotFoundToolResponse?: string;
+}
 /**
  * Extended router context with a resolved {@link Sandbox} instance.
  *
@@ -95,7 +121,7 @@ declare function withSandbox<TArgs, TResult, TSandbox extends Sandbox = Sandbox,
 }, handler: (args: TArgs, context: RouterContext & {
     sandbox: TSandbox;
     sandboxId: string;
-}) => Promise<ToolHandlerResponse<TResult, TToolResponse>>): ActivityToolHandler<TArgs, TResult | null, RouterContext, TToolResponse | string>;
+}) => Promise<ToolHandlerResponse<TResult, TToolResponse>>, options?: WithSandboxOptions): ActivityToolHandler<TArgs, TResult | null, RouterContext, TToolResponse | string>;
 
 /**
  * Safely retrieve Temporal activity heartbeat and cancellation signal.
@@ -249,8 +275,16 @@ interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCre
 /**
  * Stateless facade over a {@link SandboxProvider}.
  *
- * Delegates all lifecycle operations to the provider, which is responsible
- * for its own instance management strategy (e.g. in-memory map, remote API).
+ * Generic over the same capability set (`TCaps`) as the underlying
+ * provider. The manager's lifecycle methods are always present on the
+ * class (so existing call sites compile unchanged), but
+ * {@link SandboxManager.createActivities} is capability-gated: only
+ * activities whose capability the provider declares via
+ * {@link SandboxProvider.supportedCapabilities} are wrapped, and the
+ * returned object's type omits absent ones.
+ *
+ * The default `TCaps = SandboxCapability` keeps the full method surface
+ * for existing usages that only pass `TOptions` / `TSandbox` / `TId`.
  *
  * Optional {@link SandboxManagerHooks} can be passed at construction time.
  * The `onPreCreate` hook runs inside the `createSandbox` activity, receiving
@@ -288,25 +322,61 @@ interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCre
  * );
  * ```
  */
-declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string, TCtx = unknown> {
+declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string, TCtx = unknown, TCaps extends SandboxCapability = SandboxCapability> {
     private provider;
     private hooks;
-    constructor(provider: SandboxProvider<TOptions, TSandbox> & {
+    constructor(provider: SandboxProvider<TOptions, TSandbox, TCaps> & {
         readonly id: TId;
     }, options?: {
         hooks?: SandboxManagerHooks<TOptions, TCtx>;
     });
+    /**
+     * Verifies that the provider's runtime `supportedCapabilities` set is
+     * consistent with the gated methods physically present on the provider.
+     *
+     * Belt-and-suspenders complement to the type-level
+     * `ReadonlySet<TCaps & SandboxCapability>` constraint: TypeScript can
+     * prevent the runtime set from containing capabilities not declared in
+     * `TCaps`, but it cannot detect a provider that **declares** a cap in
+     * `TCaps` and forgets to include it in the runtime set (or that ships
+     * a method without listing its cap). Both shapes silently break
+     * activity registration, so we trip a loud failure at construction
+     * time instead.
+     *
+     * Adapters that derive both surfaces from a single `as const`
+     * capability array (the recommended pattern) pass this check by
+     * construction.
+     */
+    private assertCapabilityRuntimeConsistency;
     create(options?: TOptions, ctx?: TCtx): Promise<{
         sandboxId: string;
     } | null>;
     getSandbox(id: string): Promise<TSandbox>;
     destroy(id: string): Promise<void>;
+    /**
+     * Capability-gated lifecycle methods on the underlying provider.
+     *
+     * These manager methods always exist at runtime; calling one whose
+     * capability is absent from the provider's `supportedCapabilities`
+     * throws an error. The activities returned from
+     * {@link SandboxManager.createActivities} are gated at the type level
+     * via `TCaps`, which is where compile-time safety is enforced.
+     */
     pause(id: string, ttlSeconds?: number): Promise<void>;
     resume(id: string): Promise<void>;
     snapshot(id: string, options?: TOptions): Promise<SandboxSnapshot>;
     restore(snapshot: SandboxSnapshot, options?: TOptions): Promise<string>;
     deleteSnapshot(snapshot: SandboxSnapshot): Promise<void>;
     fork(sandboxId: string, options?: TOptions): Promise<string>;
+    private providerMethod;
+    /**
+     * Constructs the structured error thrown when an unsupported lifecycle
+     * method is invoked through the manager. Uses the public
+     * {@link SandboxNotSupportedError} symbol so consumers that catch on
+     * `instanceof SandboxNotSupportedError` (the documented compatibility
+     * path) keep matching after the refactor.
+     */
+    private unsupported;
     /**
      * Returns Temporal activity functions with prefixed names.
      *
@@ -314,6 +384,11 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
      * to pass the workflow/scope name. Use the matching `proxy*SandboxOps()`
      * helper from the adapter's `/workflow` entrypoint on the workflow side.
      *
+     * Activities are only registered for capabilities the provider declares
+     * via {@link SandboxProvider.supportedCapabilities}: methods omitted
+     * from the cap set are not wrapped, and the returned object's type
+     * omits the corresponding keys.
+     *
      * @param scope - Workflow name (appended to the provider id)
      *
      * @example
@@ -324,10 +399,11 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
      *
      * const dmgr = new SandboxManager(new DaytonaSandboxProvider(config));
      * dmgr.createActivities("CodingAgent");
-     * // registers: daytonaCodingAgentCreateSandbox, …
+     * // registers: daytonaCodingAgentCreateSandbox, daytonaCodingAgentDestroySandbox
+     * // (snapshot/restore/fork/pause/resume omitted — Daytona doesn't declare them)
      * ```
      */
-    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions, TCtx>;
+    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions, TCtx, TCaps>;
 }
 
 /**
@@ -518,4 +594,4 @@ declare const toTree: (fs: SandboxFileSystem, opts?: {
     sort?: boolean;
 }) => Promise<string>;
 
-export { ActivityToolHandler, type AgentStateContext, BaseAgentState, BaseThreadManager, BashArgs, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };
+export { ActivityToolHandler, type AgentStateContext, BaseAgentState, BaseThreadManager, BashArgs, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, SandboxCapability, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, type WithSandboxOptions, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };

package/dist/index.d.ts

@@ -1,15 +1,15 @@
-import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-C2MZZj5K.js';
-export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadListKey, X as getThreadMetaKey, Y as globTool, _ as grepTool, $ as hasDirectory, a0 as hasFileWithMimeType, a1 as hasNoOtherToolCalls, a2 as parseSkillFile, a3 as proxyRunAgent, a4 as proxyVirtualFsOps, a5 as readFileTool, a6 as taskCreateTool, a7 as taskGetTool, a8 as taskListTool, a9 as taskUpdateTool, aa as writeFileTool } from './workflow-C2MZZj5K.js';
-import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-DeQH84C_.js';
-export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionResult, a6 as SessionStartHook, a7 as SessionStartHookContext, a8 as SubagentChildWorkflowOptions, a9 as SubagentConfig, aa as SubagentDefinition, ab as SubagentFnResult, ac as SubagentHandlerResponse, ad as SubagentHooks, ae as SubagentSandboxConfig, af as SubagentSandboxShutdown, ag as SubagentSessionInput, ah as SubagentWorkflow, ai as SubagentWorkflowInput, aj as TaskStatus, ak as ThreadInit, T as ThreadOps, al as TokenUsage, am as ToolArgs, an as ToolCallResult, ao as ToolCallResultUnion, ap as ToolDefinition, aq as ToolHandler, ar as ToolHooks, as as ToolMap, at as ToolNames, au as ToolResult, av as ToolRouter, aw as ToolRouterHooks, ax as ToolWithHandler, ay as VirtualFileSystem, az as VirtualFileTree, aA as VirtualFsOps, aB as VirtualFsState, aC as WorkflowTask, aD as ZeitlichSession, aE as isTerminalStatus } from './types-DeQH84C_.js';
-import { S as Sandbox, a as SandboxFileSystem, d as SandboxCreateOptions, b as SandboxProvider, f as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-yx0LzPGn.js';
-export { h as ExecOptions, c as SandboxCapabilities, e as SandboxCreateResult, i as SandboxNotFoundError, j as SandboxNotSupportedError, g as SandboxOps } from './types-yx0LzPGn.js';
+import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-BwT5EybR.js';
+export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadListKey, X as getThreadMetaKey, Y as globTool, _ as grepTool, $ as hasDirectory, a0 as hasFileWithMimeType, a1 as hasNoOtherToolCalls, a2 as parseSkillFile, a3 as proxyRunAgent, a4 as proxyVirtualFsOps, a5 as readFileTool, a6 as taskCreateTool, a7 as taskGetTool, a8 as taskListTool, a9 as taskUpdateTool, aa as writeFileTool } from './workflow-BwT5EybR.js';
+import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-ChAy_jSP.js';
+export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-ChAy_jSP.js';
+import { b as Sandbox, c as SandboxFileSystem, a as SandboxCreateOptions, h as SandboxCapability, d as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-CJ7tCdl6.js';
+export { i as ExecOptions, e as SandboxCapabilities, f as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, S as SandboxOps } from './types-CJ7tCdl6.js';
 import { WorkflowClient } from '@temporalio/client';
-import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-C7OoY7h8.js';
-export { P as ProviderThreadManager } from './types-C7OoY7h8.js';
+import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-BkX4HLzi.js';
+export { P as ProviderThreadManager } from './types-BkX4HLzi.js';
 import 'zod';
-import '@temporalio/workflow';
 import '@temporalio/common';
+import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
 import 'ioredis';
 
@@ -42,6 +42,32 @@ import 'ioredis';
  */
 declare function withAutoAppend<TArgs, TResult, TContext extends RouterContext = RouterContext, TToolResponse = unknown>(threadHandler: (id: string, config: ToolResultConfig) => Promise<void>, handler: ActivityToolHandler<TArgs, TResult, TContext, TToolResponse>): ActivityToolHandler<TArgs, TResult, TContext>;
 
+/**
+ * Options for {@link withSandbox}.
+ */
+interface WithSandboxOptions {
+    /**
+     * If `true`, a {@link SandboxNotFoundError} thrown by `manager.getSandbox`
+     * is translated into a structured tool-handler response (instead of
+     * propagating). This lets the agent return a graceful error to the model
+     * rather than crashing the workflow when the backing sandbox has been
+     * killed mid-run (e.g. because the E2B `timeoutMs` lifetime elapsed).
+     *
+     * Off by default to preserve the existing contract for callers that rely
+     * on the error bubbling out. New callers should generally enable this in
+     * combination with the E2B `keepAliveMs` provider option.
+     *
+     * @default false
+     */
+    translateSandboxNotFound?: boolean;
+    /**
+     * Custom tool response returned to the agent when the backing sandbox
+     * is not found and `translateSandboxNotFound` is `true`. Defaults to a
+     * generic English message. Use this to localize, match agent persona,
+     * or give the model more specific recovery instructions.
+     */
+    sandboxNotFoundToolResponse?: string;
+}
 /**
  * Extended router context with a resolved {@link Sandbox} instance.
  *
@@ -95,7 +121,7 @@ declare function withSandbox<TArgs, TResult, TSandbox extends Sandbox = Sandbox,
 }, handler: (args: TArgs, context: RouterContext & {
     sandbox: TSandbox;
     sandboxId: string;
-}) => Promise<ToolHandlerResponse<TResult, TToolResponse>>): ActivityToolHandler<TArgs, TResult | null, RouterContext, TToolResponse | string>;
+}) => Promise<ToolHandlerResponse<TResult, TToolResponse>>, options?: WithSandboxOptions): ActivityToolHandler<TArgs, TResult | null, RouterContext, TToolResponse | string>;
 
 /**
  * Safely retrieve Temporal activity heartbeat and cancellation signal.
@@ -249,8 +275,16 @@ interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCre
 /**
  * Stateless facade over a {@link SandboxProvider}.
  *
- * Delegates all lifecycle operations to the provider, which is responsible
- * for its own instance management strategy (e.g. in-memory map, remote API).
+ * Generic over the same capability set (`TCaps`) as the underlying
+ * provider. The manager's lifecycle methods are always present on the
+ * class (so existing call sites compile unchanged), but
+ * {@link SandboxManager.createActivities} is capability-gated: only
+ * activities whose capability the provider declares via
+ * {@link SandboxProvider.supportedCapabilities} are wrapped, and the
+ * returned object's type omits absent ones.
+ *
+ * The default `TCaps = SandboxCapability` keeps the full method surface
+ * for existing usages that only pass `TOptions` / `TSandbox` / `TId`.
  *
  * Optional {@link SandboxManagerHooks} can be passed at construction time.
  * The `onPreCreate` hook runs inside the `createSandbox` activity, receiving
@@ -288,25 +322,61 @@ interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCre
  * );
  * ```
  */
-declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string, TCtx = unknown> {
+declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string, TCtx = unknown, TCaps extends SandboxCapability = SandboxCapability> {
     private provider;
     private hooks;
-    constructor(provider: SandboxProvider<TOptions, TSandbox> & {
+    constructor(provider: SandboxProvider<TOptions, TSandbox, TCaps> & {
         readonly id: TId;
     }, options?: {
         hooks?: SandboxManagerHooks<TOptions, TCtx>;
     });
+    /**
+     * Verifies that the provider's runtime `supportedCapabilities` set is
+     * consistent with the gated methods physically present on the provider.
+     *
+     * Belt-and-suspenders complement to the type-level
+     * `ReadonlySet<TCaps & SandboxCapability>` constraint: TypeScript can
+     * prevent the runtime set from containing capabilities not declared in
+     * `TCaps`, but it cannot detect a provider that **declares** a cap in
+     * `TCaps` and forgets to include it in the runtime set (or that ships
+     * a method without listing its cap). Both shapes silently break
+     * activity registration, so we trip a loud failure at construction
+     * time instead.
+     *
+     * Adapters that derive both surfaces from a single `as const`
+     * capability array (the recommended pattern) pass this check by
+     * construction.
+     */
+    private assertCapabilityRuntimeConsistency;
     create(options?: TOptions, ctx?: TCtx): Promise<{
         sandboxId: string;
     } | null>;
     getSandbox(id: string): Promise<TSandbox>;
     destroy(id: string): Promise<void>;
+    /**
+     * Capability-gated lifecycle methods on the underlying provider.
+     *
+     * These manager methods always exist at runtime; calling one whose
+     * capability is absent from the provider's `supportedCapabilities`
+     * throws an error. The activities returned from
+     * {@link SandboxManager.createActivities} are gated at the type level
+     * via `TCaps`, which is where compile-time safety is enforced.
+     */
     pause(id: string, ttlSeconds?: number): Promise<void>;
     resume(id: string): Promise<void>;
     snapshot(id: string, options?: TOptions): Promise<SandboxSnapshot>;
     restore(snapshot: SandboxSnapshot, options?: TOptions): Promise<string>;
     deleteSnapshot(snapshot: SandboxSnapshot): Promise<void>;
     fork(sandboxId: string, options?: TOptions): Promise<string>;
+    private providerMethod;
+    /**
+     * Constructs the structured error thrown when an unsupported lifecycle
+     * method is invoked through the manager. Uses the public
+     * {@link SandboxNotSupportedError} symbol so consumers that catch on
+     * `instanceof SandboxNotSupportedError` (the documented compatibility
+     * path) keep matching after the refactor.
+     */
+    private unsupported;
     /**
      * Returns Temporal activity functions with prefixed names.
      *
@@ -314,6 +384,11 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
      * to pass the workflow/scope name. Use the matching `proxy*SandboxOps()`
      * helper from the adapter's `/workflow` entrypoint on the workflow side.
      *
+     * Activities are only registered for capabilities the provider declares
+     * via {@link SandboxProvider.supportedCapabilities}: methods omitted
+     * from the cap set are not wrapped, and the returned object's type
+     * omits the corresponding keys.
+     *
      * @param scope - Workflow name (appended to the provider id)
      *
      * @example
@@ -324,10 +399,11 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
      *
      * const dmgr = new SandboxManager(new DaytonaSandboxProvider(config));
      * dmgr.createActivities("CodingAgent");
-     * // registers: daytonaCodingAgentCreateSandbox, …
+     * // registers: daytonaCodingAgentCreateSandbox, daytonaCodingAgentDestroySandbox
+     * // (snapshot/restore/fork/pause/resume omitted — Daytona doesn't declare them)
      * ```
      */
-    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions, TCtx>;
+    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions, TCtx, TCaps>;
 }
 
 /**
@@ -518,4 +594,4 @@ declare const toTree: (fs: SandboxFileSystem, opts?: {
     sort?: boolean;
 }) => Promise<string>;
 
-export { ActivityToolHandler, type AgentStateContext, BaseAgentState, BaseThreadManager, BashArgs, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };
+export { ActivityToolHandler, type AgentStateContext, BaseAgentState, BaseThreadManager, BashArgs, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, SandboxCapability, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, type WithSandboxOptions, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };