zeitlich 0.2.29 → 0.2.31

package/dist/index.d.cts

@@ -1,12 +1,12 @@
-import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-B4T3la0p.cjs';
-export { A as AskUserQuestionArgs, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as TaskCreateArgs, g as TaskGetArgs, h as TaskListArgs, i as TaskUpdateArgs, j as ToolExecutedEvent, k as TurnCompletedEvent, W as WorkflowConfig, l as WorkflowInput, m as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, n as applyVirtualTreeMutations, o as askUserQuestionTool, p as bashTool, q as composeHooks, r as createAgentStateManager, s as createAskUserQuestionHandler, t as createBashToolDescription, u as createObservabilityHooks, v as createReadSkillHandler, w as createReadSkillTool, x as createSession, y as createTaskCreateHandler, z as createTaskGetHandler, C as createTaskListHandler, D as createTaskUpdateHandler, E as createToolRouter, H as defineSubagent, I as defineSubagentWorkflow, J as defineTool, K as defineWorkflow, L as editTool, M as filesWithMimeType, N as formatVirtualFileTree, P as getShortId, Q as globTool, U as grepTool, V as hasDirectory, X as hasFileWithMimeType, Y as hasNoOtherToolCalls, _ as parseSkillFile, $ as proxyVirtualFsOps, a0 as readFileTool, a1 as taskCreateTool, a2 as taskGetTool, a3 as taskListTool, a4 as taskUpdateTool, a5 as writeFileTool } from './workflow-B4T3la0p.cjs';
-import { R as RouterContext, d as ToolResultConfig, c as ActivityToolHandler, J as JsonValue, b as ToolHandlerResponse, B as BaseAgentState, e as RunAgentConfig, f as SkillProvider, g as SkillMetadata, h as Skill, F as FileEntryMetadata, i as FileResolver, V as VirtualFsContext, j as TreeMutation, k as PrefixedVirtualFsOps } from './types-seDYom4M.cjs';
-export { l as AgentConfig, m as AgentFile, A as AgentResponse, n as AgentState, o as AgentStateManager, p as AgentStatus, q as AppendToolResultFn, r as FileEntry, H as Hooks, I as InferToolResults, s as JsonPrimitive, t as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, u as ParsedToolCall, v as ParsedToolCallUnion, w as PostHumanMessageAppendHook, x as PostHumanMessageAppendHookContext, y as PostToolUseFailureHook, z as PostToolUseFailureHookContext, C as PostToolUseFailureHookResult, D as PostToolUseHook, E as PostToolUseHookContext, G as PreHumanMessageAppendHook, K as PreHumanMessageAppendHookContext, L as PreToolUseHook, N as PreToolUseHookContext, O as PreToolUseHookResult, P as PrefixedThreadOps, Q as ProcessToolCallsContext, U as RawToolCall, W as RunAgentActivity, X as SandboxInit, Y as SandboxShutdown, S as ScopedPrefix, Z as SerializableToolDefinition, _ as SessionConfig, $ as SessionEndHook, a0 as SessionEndHookContext, a1 as SessionExitReason, a2 as SessionResult, a3 as SessionStartHook, a4 as SessionStartHookContext, a5 as SubagentConfig, a6 as SubagentDefinition, a7 as SubagentFnResult, a8 as SubagentHandlerResponse, a9 as SubagentHooks, aa as SubagentSandboxConfig, ab as SubagentSandboxShutdown, ac as SubagentSessionInput, ad as SubagentWorkflow, ae as SubagentWorkflowInput, af as TaskStatus, ag as ThreadInit, T as ThreadOps, ah as TokenUsage, ai as ToolArgs, aj as ToolCallResult, ak as ToolCallResultUnion, al as ToolDefinition, am as ToolHandler, an as ToolHooks, ao as ToolMap, ap as ToolNames, aq as ToolResult, ar as ToolRouter, as as ToolRouterHooks, at as ToolWithHandler, au as VirtualFileSystem, av as VirtualFileTree, aw as VirtualFsOps, ax as VirtualFsState, ay as WorkflowTask, az as ZeitlichSession, aA as isTerminalStatus } from './types-seDYom4M.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-ChAMwU3q.cjs';
-export { h as ExecOptions, c as SandboxCapabilities, e as SandboxCreateResult, i as SandboxNotFoundError, j as SandboxNotSupportedError, g as SandboxOps } from './types-ChAMwU3q.cjs';
+import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-CNshfqSO.cjs';
+export { A as AskUserQuestionArgs, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as TaskCreateArgs, g as TaskGetArgs, h as TaskListArgs, i as TaskUpdateArgs, j as ToolExecutedEvent, k as TurnCompletedEvent, W as WorkflowConfig, l as WorkflowInput, m as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, n as applyVirtualTreeMutations, o as askUserQuestionTool, p as bashTool, q as composeHooks, r as createAgentStateManager, s as createAskUserQuestionHandler, t as createBashToolDescription, u as createObservabilityHooks, v as createReadSkillHandler, w as createReadSkillTool, x as createSession, y as createTaskCreateHandler, z as createTaskGetHandler, C as createTaskListHandler, D as createTaskUpdateHandler, E as createToolRouter, H as defineSubagent, I as defineSubagentWorkflow, J as defineTool, K as defineWorkflow, L as editTool, M as filesWithMimeType, N as formatVirtualFileTree, P as getShortId, Q as globTool, U as grepTool, V as hasDirectory, X as hasFileWithMimeType, Y as hasNoOtherToolCalls, _ as parseSkillFile, $ as proxyVirtualFsOps, a0 as readFileTool, a1 as taskCreateTool, a2 as taskGetTool, a3 as taskListTool, a4 as taskUpdateTool, a5 as writeFileTool } from './workflow-CNshfqSO.cjs';
+import { R as RouterContext, d as ToolResultConfig, c as ActivityToolHandler, J as JsonValue, b as ToolHandlerResponse, B as BaseAgentState, e as RunAgentConfig, f as SkillProvider, g as SkillMetadata, h as Skill, F as FileEntryMetadata, i as FileResolver, V as VirtualFsContext, j as TreeMutation, k as PrefixedVirtualFsOps } from './types-CjeGWQm1.cjs';
+export { l as AgentConfig, m as AgentFile, A as AgentResponse, n as AgentState, o as AgentStateManager, p as AgentStatus, q as AppendToolResultFn, r as FileEntry, H as Hooks, I as InferToolResults, s as JsonPrimitive, t as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, u as ParsedToolCall, v as ParsedToolCallUnion, w as PostHumanMessageAppendHook, x as PostHumanMessageAppendHookContext, y as PostToolUseFailureHook, z as PostToolUseFailureHookContext, C as PostToolUseFailureHookResult, D as PostToolUseHook, E as PostToolUseHookContext, G as PreHumanMessageAppendHook, K as PreHumanMessageAppendHookContext, L as PreToolUseHook, N as PreToolUseHookContext, O as PreToolUseHookResult, P as PrefixedThreadOps, Q as ProcessToolCallsContext, U as RawToolCall, W as RunAgentActivity, X as SandboxInit, Y as SandboxShutdown, S as ScopedPrefix, Z as SerializableToolDefinition, _ as SessionConfig, $ as SessionEndHook, a0 as SessionEndHookContext, a1 as SessionExitReason, a2 as SessionResult, a3 as SessionStartHook, a4 as SessionStartHookContext, a5 as SubagentConfig, a6 as SubagentDefinition, a7 as SubagentFnResult, a8 as SubagentHandlerResponse, a9 as SubagentHooks, aa as SubagentSandboxConfig, ab as SubagentSandboxShutdown, ac as SubagentSessionInput, ad as SubagentWorkflow, ae as SubagentWorkflowInput, af as TaskStatus, ag as ThreadInit, T as ThreadOps, ah as TokenUsage, ai as ToolArgs, aj as ToolCallResult, ak as ToolCallResultUnion, al as ToolDefinition, am as ToolHandler, an as ToolHooks, ao as ToolMap, ap as ToolNames, aq as ToolResult, ar as ToolRouter, as as ToolRouterHooks, at as ToolWithHandler, au as VirtualFileSystem, av as VirtualFileTree, aw as VirtualFsOps, ax as VirtualFsState, ay as WorkflowTask, az as ZeitlichSession, aA as isTerminalStatus } from './types-CjeGWQm1.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-AujBIMMn.cjs';
+export { h as ExecOptions, c as SandboxCapabilities, e as SandboxCreateResult, i as SandboxNotFoundError, j as SandboxNotSupportedError, g as SandboxOps } from './types-AujBIMMn.cjs';
 import { WorkflowClient } from '@temporalio/client';
-import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-Dpz2gXLk.cjs';
-export { P as ProviderThreadManager } from './types-Dpz2gXLk.cjs';
+import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-e_38QaKo.cjs';
+export { P as ProviderThreadManager } from './types-e_38QaKo.cjs';
 import 'zod';
 import '@temporalio/workflow';
 import '@temporalio/common';
@@ -191,12 +191,53 @@ declare class FileSystemSkillProvider implements SkillProvider {
  */
 declare function createThreadManager<T>(config: ThreadManagerConfig<T>): BaseThreadManager<T>;
 
+/**
+ * Result returned by {@link SandboxManagerHooks.onPreCreate}.
+ *
+ * - Set `skip: true` to prevent sandbox creation entirely.
+ * - Set `modifiedOptions` to override/extend the creation options that will
+ *   be forwarded to the provider. Fields in `modifiedOptions` are merged on
+ *   top of the original options (`initialFiles` and `env` are shallow-merged;
+ *   everything else is overwritten).
+ */
+interface PreCreateHookResult<TOptions extends SandboxCreateOptions = SandboxCreateOptions> {
+    skip?: boolean;
+    modifiedOptions?: Partial<TOptions>;
+}
+/**
+ * Lifecycle hooks for {@link SandboxManager}.
+ *
+ * Hooks run inside the existing `createSandbox` activity — no additional
+ * activity registration required.
+ */
+interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TCtx = unknown> {
+    /**
+     * Called before sandbox creation.
+     *
+     * Receives the provider options and an opaque `ctx` value set from the
+     * workflow's {@link SandboxInit}. Use `ctx` to derive additional creation
+     * options (e.g. initial files from workflow arguments).
+     *
+     * Return `{ skip: true }` to prevent creation, or `{ modifiedOptions }`
+     * to alter the options before they reach the provider.
+     */
+    onPreCreate?: (options: TOptions, ctx: TCtx) => Promise<PreCreateHookResult<TOptions> | undefined>;
+    /**
+     * Called after a sandbox has been successfully created.
+     */
+    onPostCreate?: (sandboxId: string) => Promise<void>;
+}
 /**
  * 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).
  *
+ * Optional {@link SandboxManagerHooks} can be passed at construction time.
+ * The `onPreCreate` hook runs inside the `createSandbox` activity, receiving
+ * the provider options and an opaque `ctx` value from the workflow's
+ * {@link SandboxInit}. It can modify options or skip creation entirely.
+ *
  * @example
  * ```typescript
  * const manager = new SandboxManager(new InMemorySandboxProvider());
@@ -206,16 +247,38 @@ declare function createThreadManager<T>(config: ThreadManagerConfig<T>): BaseThr
  * };
  * // registers: inMemoryCodingAgentCreateSandbox, …
  * ```
+ *
+ * @example
+ * ```typescript
+ * const manager = new SandboxManager(
+ *   new DaytonaSandboxProvider(config),
+ *   {
+ *     hooks: {
+ *       onPreCreate: async (options, ctx) => {
+ *         const { projectId, filePaths } = ctx as { projectId: string; filePaths: string[] };
+ *         const files: Record<string, string> = {};
+ *         for (const p of filePaths) files[p] = await db.readFile(projectId, p);
+ *         return { modifiedOptions: { initialFiles: files } };
+ *       },
+ *       onPostCreate: async (sandboxId) => {
+ *         console.log("Sandbox created:", sandboxId);
+ *       },
+ *     },
+ *   },
+ * );
+ * ```
  */
-declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string> {
+declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string, TCtx = unknown> {
     private provider;
+    private hooks;
     constructor(provider: SandboxProvider<TOptions, TSandbox> & {
         readonly id: TId;
+    }, options?: {
+        hooks?: SandboxManagerHooks<TOptions, TCtx>;
     });
-    create(options?: TOptions): Promise<{
+    create(options?: TOptions, ctx?: TCtx): Promise<{
         sandboxId: string;
-        stateUpdate?: Record<string, unknown>;
-    }>;
+    } | null>;
     getSandbox(id: string): Promise<TSandbox>;
     destroy(id: string): Promise<void>;
     pause(id: string, ttlSeconds?: number): Promise<void>;
@@ -242,7 +305,7 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
      * // registers: daytonaCodingAgentCreateSandbox, …
      * ```
      */
-    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions>;
+    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions, TCtx>;
 }
 
 /**
@@ -293,7 +356,7 @@ declare class NodeFsSandboxFileSystem implements SandboxFileSystem {
  * the parent workflow for the current file tree and resolver context.
  *
  * On each invocation the wrapper:
- * 1. Queries the workflow's `AgentState` for `fileTree`, `resolverContext`, and `workspaceBase`
+ * 1. Queries the workflow's `AgentState` for `fileTree`, `ctx`, and `workspaceBase`
  * 2. Creates an ephemeral {@link VirtualFileSystem} from tree + resolver
  * 3. Runs the inner handler
  * 4. Returns the handler's result together with any {@link TreeMutation}s
@@ -433,4 +496,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, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, 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, 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, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-DCmaXLZ_.js';
-export { A as AskUserQuestionArgs, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as TaskCreateArgs, g as TaskGetArgs, h as TaskListArgs, i as TaskUpdateArgs, j as ToolExecutedEvent, k as TurnCompletedEvent, W as WorkflowConfig, l as WorkflowInput, m as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, n as applyVirtualTreeMutations, o as askUserQuestionTool, p as bashTool, q as composeHooks, r as createAgentStateManager, s as createAskUserQuestionHandler, t as createBashToolDescription, u as createObservabilityHooks, v as createReadSkillHandler, w as createReadSkillTool, x as createSession, y as createTaskCreateHandler, z as createTaskGetHandler, C as createTaskListHandler, D as createTaskUpdateHandler, E as createToolRouter, H as defineSubagent, I as defineSubagentWorkflow, J as defineTool, K as defineWorkflow, L as editTool, M as filesWithMimeType, N as formatVirtualFileTree, P as getShortId, Q as globTool, U as grepTool, V as hasDirectory, X as hasFileWithMimeType, Y as hasNoOtherToolCalls, _ as parseSkillFile, $ as proxyVirtualFsOps, a0 as readFileTool, a1 as taskCreateTool, a2 as taskGetTool, a3 as taskListTool, a4 as taskUpdateTool, a5 as writeFileTool } from './workflow-DCmaXLZ_.js';
-import { R as RouterContext, d as ToolResultConfig, c as ActivityToolHandler, J as JsonValue, b as ToolHandlerResponse, B as BaseAgentState, e as RunAgentConfig, f as SkillProvider, g as SkillMetadata, h as Skill, F as FileEntryMetadata, i as FileResolver, V as VirtualFsContext, j as TreeMutation, k as PrefixedVirtualFsOps } from './types-BkVoEyiH.js';
-export { l as AgentConfig, m as AgentFile, A as AgentResponse, n as AgentState, o as AgentStateManager, p as AgentStatus, q as AppendToolResultFn, r as FileEntry, H as Hooks, I as InferToolResults, s as JsonPrimitive, t as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, u as ParsedToolCall, v as ParsedToolCallUnion, w as PostHumanMessageAppendHook, x as PostHumanMessageAppendHookContext, y as PostToolUseFailureHook, z as PostToolUseFailureHookContext, C as PostToolUseFailureHookResult, D as PostToolUseHook, E as PostToolUseHookContext, G as PreHumanMessageAppendHook, K as PreHumanMessageAppendHookContext, L as PreToolUseHook, N as PreToolUseHookContext, O as PreToolUseHookResult, P as PrefixedThreadOps, Q as ProcessToolCallsContext, U as RawToolCall, W as RunAgentActivity, X as SandboxInit, Y as SandboxShutdown, S as ScopedPrefix, Z as SerializableToolDefinition, _ as SessionConfig, $ as SessionEndHook, a0 as SessionEndHookContext, a1 as SessionExitReason, a2 as SessionResult, a3 as SessionStartHook, a4 as SessionStartHookContext, a5 as SubagentConfig, a6 as SubagentDefinition, a7 as SubagentFnResult, a8 as SubagentHandlerResponse, a9 as SubagentHooks, aa as SubagentSandboxConfig, ab as SubagentSandboxShutdown, ac as SubagentSessionInput, ad as SubagentWorkflow, ae as SubagentWorkflowInput, af as TaskStatus, ag as ThreadInit, T as ThreadOps, ah as TokenUsage, ai as ToolArgs, aj as ToolCallResult, ak as ToolCallResultUnion, al as ToolDefinition, am as ToolHandler, an as ToolHooks, ao as ToolMap, ap as ToolNames, aq as ToolResult, ar as ToolRouter, as as ToolRouterHooks, at as ToolWithHandler, au as VirtualFileSystem, av as VirtualFileTree, aw as VirtualFsOps, ax as VirtualFsState, ay as WorkflowTask, az as ZeitlichSession, aA as isTerminalStatus } from './types-BkVoEyiH.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-ChAMwU3q.js';
-export { h as ExecOptions, c as SandboxCapabilities, e as SandboxCreateResult, i as SandboxNotFoundError, j as SandboxNotSupportedError, g as SandboxOps } from './types-ChAMwU3q.js';
+import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-CTcrPZAV.js';
+export { A as AskUserQuestionArgs, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as TaskCreateArgs, g as TaskGetArgs, h as TaskListArgs, i as TaskUpdateArgs, j as ToolExecutedEvent, k as TurnCompletedEvent, W as WorkflowConfig, l as WorkflowInput, m as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, n as applyVirtualTreeMutations, o as askUserQuestionTool, p as bashTool, q as composeHooks, r as createAgentStateManager, s as createAskUserQuestionHandler, t as createBashToolDescription, u as createObservabilityHooks, v as createReadSkillHandler, w as createReadSkillTool, x as createSession, y as createTaskCreateHandler, z as createTaskGetHandler, C as createTaskListHandler, D as createTaskUpdateHandler, E as createToolRouter, H as defineSubagent, I as defineSubagentWorkflow, J as defineTool, K as defineWorkflow, L as editTool, M as filesWithMimeType, N as formatVirtualFileTree, P as getShortId, Q as globTool, U as grepTool, V as hasDirectory, X as hasFileWithMimeType, Y as hasNoOtherToolCalls, _ as parseSkillFile, $ as proxyVirtualFsOps, a0 as readFileTool, a1 as taskCreateTool, a2 as taskGetTool, a3 as taskListTool, a4 as taskUpdateTool, a5 as writeFileTool } from './workflow-CTcrPZAV.js';
+import { R as RouterContext, d as ToolResultConfig, c as ActivityToolHandler, J as JsonValue, b as ToolHandlerResponse, B as BaseAgentState, e as RunAgentConfig, f as SkillProvider, g as SkillMetadata, h as Skill, F as FileEntryMetadata, i as FileResolver, V as VirtualFsContext, j as TreeMutation, k as PrefixedVirtualFsOps } from './types-BmS-Huc0.js';
+export { l as AgentConfig, m as AgentFile, A as AgentResponse, n as AgentState, o as AgentStateManager, p as AgentStatus, q as AppendToolResultFn, r as FileEntry, H as Hooks, I as InferToolResults, s as JsonPrimitive, t as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, u as ParsedToolCall, v as ParsedToolCallUnion, w as PostHumanMessageAppendHook, x as PostHumanMessageAppendHookContext, y as PostToolUseFailureHook, z as PostToolUseFailureHookContext, C as PostToolUseFailureHookResult, D as PostToolUseHook, E as PostToolUseHookContext, G as PreHumanMessageAppendHook, K as PreHumanMessageAppendHookContext, L as PreToolUseHook, N as PreToolUseHookContext, O as PreToolUseHookResult, P as PrefixedThreadOps, Q as ProcessToolCallsContext, U as RawToolCall, W as RunAgentActivity, X as SandboxInit, Y as SandboxShutdown, S as ScopedPrefix, Z as SerializableToolDefinition, _ as SessionConfig, $ as SessionEndHook, a0 as SessionEndHookContext, a1 as SessionExitReason, a2 as SessionResult, a3 as SessionStartHook, a4 as SessionStartHookContext, a5 as SubagentConfig, a6 as SubagentDefinition, a7 as SubagentFnResult, a8 as SubagentHandlerResponse, a9 as SubagentHooks, aa as SubagentSandboxConfig, ab as SubagentSandboxShutdown, ac as SubagentSessionInput, ad as SubagentWorkflow, ae as SubagentWorkflowInput, af as TaskStatus, ag as ThreadInit, T as ThreadOps, ah as TokenUsage, ai as ToolArgs, aj as ToolCallResult, ak as ToolCallResultUnion, al as ToolDefinition, am as ToolHandler, an as ToolHooks, ao as ToolMap, ap as ToolNames, aq as ToolResult, ar as ToolRouter, as as ToolRouterHooks, at as ToolWithHandler, au as VirtualFileSystem, av as VirtualFileTree, aw as VirtualFsOps, ax as VirtualFsState, ay as WorkflowTask, az as ZeitlichSession, aA as isTerminalStatus } from './types-BmS-Huc0.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-AujBIMMn.js';
+export { h as ExecOptions, c as SandboxCapabilities, e as SandboxCreateResult, i as SandboxNotFoundError, j as SandboxNotSupportedError, g as SandboxOps } from './types-AujBIMMn.js';
 import { WorkflowClient } from '@temporalio/client';
-import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-DAv_SLN8.js';
-export { P as ProviderThreadManager } from './types-DAv_SLN8.js';
+import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-D6UKZZtj.js';
+export { P as ProviderThreadManager } from './types-D6UKZZtj.js';
 import 'zod';
 import '@temporalio/workflow';
 import '@temporalio/common';
@@ -191,12 +191,53 @@ declare class FileSystemSkillProvider implements SkillProvider {
  */
 declare function createThreadManager<T>(config: ThreadManagerConfig<T>): BaseThreadManager<T>;
 
+/**
+ * Result returned by {@link SandboxManagerHooks.onPreCreate}.
+ *
+ * - Set `skip: true` to prevent sandbox creation entirely.
+ * - Set `modifiedOptions` to override/extend the creation options that will
+ *   be forwarded to the provider. Fields in `modifiedOptions` are merged on
+ *   top of the original options (`initialFiles` and `env` are shallow-merged;
+ *   everything else is overwritten).
+ */
+interface PreCreateHookResult<TOptions extends SandboxCreateOptions = SandboxCreateOptions> {
+    skip?: boolean;
+    modifiedOptions?: Partial<TOptions>;
+}
+/**
+ * Lifecycle hooks for {@link SandboxManager}.
+ *
+ * Hooks run inside the existing `createSandbox` activity — no additional
+ * activity registration required.
+ */
+interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TCtx = unknown> {
+    /**
+     * Called before sandbox creation.
+     *
+     * Receives the provider options and an opaque `ctx` value set from the
+     * workflow's {@link SandboxInit}. Use `ctx` to derive additional creation
+     * options (e.g. initial files from workflow arguments).
+     *
+     * Return `{ skip: true }` to prevent creation, or `{ modifiedOptions }`
+     * to alter the options before they reach the provider.
+     */
+    onPreCreate?: (options: TOptions, ctx: TCtx) => Promise<PreCreateHookResult<TOptions> | undefined>;
+    /**
+     * Called after a sandbox has been successfully created.
+     */
+    onPostCreate?: (sandboxId: string) => Promise<void>;
+}
 /**
  * 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).
  *
+ * Optional {@link SandboxManagerHooks} can be passed at construction time.
+ * The `onPreCreate` hook runs inside the `createSandbox` activity, receiving
+ * the provider options and an opaque `ctx` value from the workflow's
+ * {@link SandboxInit}. It can modify options or skip creation entirely.
+ *
  * @example
  * ```typescript
  * const manager = new SandboxManager(new InMemorySandboxProvider());
@@ -206,16 +247,38 @@ declare function createThreadManager<T>(config: ThreadManagerConfig<T>): BaseThr
  * };
  * // registers: inMemoryCodingAgentCreateSandbox, …
  * ```
+ *
+ * @example
+ * ```typescript
+ * const manager = new SandboxManager(
+ *   new DaytonaSandboxProvider(config),
+ *   {
+ *     hooks: {
+ *       onPreCreate: async (options, ctx) => {
+ *         const { projectId, filePaths } = ctx as { projectId: string; filePaths: string[] };
+ *         const files: Record<string, string> = {};
+ *         for (const p of filePaths) files[p] = await db.readFile(projectId, p);
+ *         return { modifiedOptions: { initialFiles: files } };
+ *       },
+ *       onPostCreate: async (sandboxId) => {
+ *         console.log("Sandbox created:", sandboxId);
+ *       },
+ *     },
+ *   },
+ * );
+ * ```
  */
-declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string> {
+declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCreateOptions, TSandbox extends Sandbox = Sandbox, TId extends string = string, TCtx = unknown> {
     private provider;
+    private hooks;
     constructor(provider: SandboxProvider<TOptions, TSandbox> & {
         readonly id: TId;
+    }, options?: {
+        hooks?: SandboxManagerHooks<TOptions, TCtx>;
     });
-    create(options?: TOptions): Promise<{
+    create(options?: TOptions, ctx?: TCtx): Promise<{
         sandboxId: string;
-        stateUpdate?: Record<string, unknown>;
-    }>;
+    } | null>;
     getSandbox(id: string): Promise<TSandbox>;
     destroy(id: string): Promise<void>;
     pause(id: string, ttlSeconds?: number): Promise<void>;
@@ -242,7 +305,7 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
      * // registers: daytonaCodingAgentCreateSandbox, …
      * ```
      */
-    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions>;
+    createActivities<S extends string>(scope: S): PrefixedSandboxOps<`${TId}${Capitalize<S>}`, TOptions, TCtx>;
 }
 
 /**
@@ -293,7 +356,7 @@ declare class NodeFsSandboxFileSystem implements SandboxFileSystem {
  * the parent workflow for the current file tree and resolver context.
  *
  * On each invocation the wrapper:
- * 1. Queries the workflow's `AgentState` for `fileTree`, `resolverContext`, and `workspaceBase`
+ * 1. Queries the workflow's `AgentState` for `fileTree`, `ctx`, and `workspaceBase`
  * 2. Creates an ephemeral {@link VirtualFileSystem} from tree + resolver
  * 3. Runs the inner handler
  * 4. Returns the handler's result together with any {@link TreeMutation}s
@@ -433,4 +496,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, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, 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, 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, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };

package/dist/index.js

@@ -399,7 +399,7 @@ function resolveSandboxConfig(config) {
   if (config === "own") return { source: "own" };
   return { source: "own", shutdown: config.shutdown };
 }
-function createSubagentHandler(subagents, options) {
+function createSubagentHandler(subagents) {
   const { taskQueue: parentTaskQueue } = workflowInfo();
   const childResults = /* @__PURE__ */ new Map();
   const pendingDestroys = /* @__PURE__ */ new Map();
@@ -427,15 +427,16 @@ function createSubagentHandler(subagents, options) {
     const continuationThreadId = args.threadId && allowsContinuation ? args.threadId : void 0;
     let thread;
     if (continuationThreadId) {
-      thread = { mode: threadMode, threadId: continuationThreadId };
+      thread = {
+        mode: threadMode,
+        threadId: continuationThreadId
+      };
     }
     let sandbox;
     if (sandboxCfg.source === "inherit" && parentSandboxId) {
-      const stateUpdate = options?.getSandboxStateForInheritance?.();
       sandbox = {
         mode: "inherit",
-        sandboxId: parentSandboxId,
-        ...stateUpdate && { stateUpdate }
+        sandboxId: parentSandboxId
       };
     } else if (sandboxCfg.source === "own") {
       const prevSbId = continuationThreadId ? threadSandboxes.get(continuationThreadId) : void 0;
@@ -555,7 +556,7 @@ function createSubagentHandler(subagents, options) {
 }
 
 // src/lib/subagent/register.ts
-function buildSubagentRegistration(subagents, options) {
+function buildSubagentRegistration(subagents) {
   if (subagents.length === 0) return null;
   const getEnabled = () => subagents.filter(
     (s) => typeof s.enabled === "function" ? s.enabled() : s.enabled ?? true
@@ -565,9 +566,7 @@ function buildSubagentRegistration(subagents, options) {
     if (s.hooks) subagentHooksMap.set(s.agentName, s.hooks);
   }
   const resolveSubagentName = (args) => args.subagent;
-  const { handler, destroySubagentSandboxes } = createSubagentHandler(subagents, {
-    getSandboxStateForInheritance: options?.getSandboxStateForInheritance
-  });
+  const { handler, destroySubagentSandboxes } = createSubagentHandler(subagents);
   const registration = {
     name: SUBAGENT_TOOL_NAME,
     enabled: () => getEnabled().length > 0,
@@ -707,7 +706,8 @@ async function createSession({
   thread: threadInit,
   sandbox: sandboxInit,
   sandboxShutdown = "destroy",
-  virtualFs: virtualFsConfig
+  virtualFs: virtualFsConfig,
+  virtualFsOps
 }) {
   const threadMode = threadInit?.mode ?? "new";
   let threadId;
@@ -733,11 +733,8 @@ async function createSession({
   } = threadOps;
   const plugins = [];
   let destroySubagentSandboxes;
-  let sandboxStateGetter;
   if (subagents) {
-    const result = buildSubagentRegistration(subagents, {
-      getSandboxStateForInheritance: () => sandboxStateGetter?.()
-    });
+    const result = buildSubagentRegistration(subagents);
     if (result) {
       plugins.push(result.registration);
       destroySubagentSandboxes = result.destroySubagentSandboxes;
@@ -793,23 +790,9 @@ async function createSession({
       const sandboxMode = sandboxInit?.mode;
       let sandboxId;
       let sandboxOwned = false;
-      sandboxStateGetter = () => {
-        const fileTree = stateManager.get("fileTree");
-        const resolverContext = stateManager.get("resolverContext");
-        const workspaceBase = stateManager.get("workspaceBase");
-        if (!fileTree && !resolverContext && !workspaceBase) return void 0;
-        return {
-          ...fileTree !== void 0 && { fileTree },
-          ...resolverContext !== void 0 && { resolverContext },
-          ...workspaceBase !== void 0 && { workspaceBase }
-        };
-      };
       if (sandboxMode === "inherit") {
         const inheritInit = sandboxInit;
         sandboxId = inheritInit.sandboxId;
-        if (inheritInit.stateUpdate) {
-          stateManager.mergeUpdate(inheritInit.stateUpdate);
-        }
         if (!sandboxOps) {
           throw ApplicationFailure.create({
             message: "sandboxId provided but no sandboxOps \u2014 cannot manage sandbox lifecycle",
@@ -838,24 +821,36 @@ async function createSession({
         sandboxOwned = true;
       } else if (sandboxOps) {
         const skillFiles = skills ? collectSkillFiles(skills) : void 0;
-        const result = await sandboxOps.createSandbox(
-          skillFiles ? { initialFiles: skillFiles } : void 0
-        );
-        sandboxId = result.sandboxId;
-        sandboxOwned = true;
-        if (result.stateUpdate) {
-          stateManager.mergeUpdate(result.stateUpdate);
+        const ctx = sandboxInit?.ctx;
+        const createOptions = skillFiles ? { initialFiles: skillFiles } : void 0;
+        const result = await sandboxOps.createSandbox(createOptions, ctx);
+        if (result) {
+          sandboxId = result.sandboxId;
+          sandboxOwned = true;
         }
       }
       if (virtualFsConfig) {
-        const result = await virtualFsConfig.ops.resolveFileTree(
-          virtualFsConfig.resolverContext
-        );
+        if (!virtualFsOps) {
+          throw ApplicationFailure.create({
+            message: "No virtualFsOps provided \u2014 cannot resolve file tree",
+            nonRetryable: true
+          });
+        }
+        const result = await virtualFsOps.resolveFileTree(virtualFsConfig.ctx);
+        const skillFiles = skills ? collectSkillFiles(skills) : void 0;
+        const fileTree = skillFiles ? [
+          ...result.fileTree,
+          ...Object.entries(skillFiles).map(([path, content]) => ({
+            id: `skill:${path}`,
+            path,
+            size: content.length,
+            mtime: (/* @__PURE__ */ new Date()).toISOString(),
+            metadata: {}
+          }))
+        ] : result.fileTree;
         stateManager.mergeUpdate({
-          fileTree: result.fileTree,
-          resolverContext: virtualFsConfig.resolverContext,
-          workspaceBase: virtualFsConfig.workspaceBase ?? "/",
-          ...result.stateUpdate
+          fileTree,
+          ...skillFiles && { inlineFiles: skillFiles }
         });
       }
       if (hooks.onSessionStart) {
@@ -889,7 +884,12 @@ async function createSession({
           await initializeThread(threadId, threadKey);
         }
       }
-      await appendHumanMessage(threadId, uuid4(), await buildContextMessage(), threadKey);
+      await appendHumanMessage(
+        threadId,
+        uuid4(),
+        await buildContextMessage(),
+        threadKey
+      );
       let exitReason = "completed";
       try {
         while (stateManager.isRunning() && !stateManager.isTerminal() && stateManager.getTurns() < maxTurns) {
@@ -2186,12 +2186,41 @@ function withParentWorkflowState(client, handler) {
 
 // src/lib/sandbox/manager.ts
 var SandboxManager = class {
-  constructor(provider) {
+  constructor(provider, options) {
     this.provider = provider;
-  }
-  async create(options) {
-    const { sandbox, stateUpdate } = await this.provider.create(options);
-    return { sandboxId: sandbox.id, ...stateUpdate && { stateUpdate } };
+    this.hooks = options?.hooks ?? {};
+  }
+  hooks;
+  async create(options, ctx) {
+    let providerOptions = options;
+    if (this.hooks.onPreCreate) {
+      const hookResult = await this.hooks.onPreCreate(
+        options ?? {},
+        ctx ?? {}
+      );
+      if (hookResult?.skip) return null;
+      if (hookResult?.modifiedOptions) {
+        const orig = options ?? {};
+        const mod = hookResult.modifiedOptions;
+        providerOptions = {
+          ...mod,
+          ...orig,
+          initialFiles: {
+            ...mod.initialFiles,
+            ...orig.initialFiles
+          },
+          env: {
+            ...mod.env,
+            ...orig.env
+          }
+        };
+      }
+    }
+    const { sandbox } = await this.provider.create(providerOptions);
+    if (this.hooks.onPostCreate) {
+      await this.hooks.onPostCreate(sandbox.id);
+    }
+    return { sandboxId: sandbox.id };
   }
   async getSandbox(id) {
     return this.provider.get(id);
@@ -2236,8 +2265,8 @@ var SandboxManager = class {
   createActivities(scope) {
     const prefix = `${this.provider.id}${scope.charAt(0).toUpperCase()}${scope.slice(1)}`;
     const ops = {
-      createSandbox: async (options) => {
-        return this.create(options);
+      createSandbox: async (options, ctx) => {
+        return this.create(options, ctx);
       },
       destroySandbox: async (sandboxId) => {
         await this.destroy(sandboxId);
@@ -2348,7 +2377,7 @@ function inferDirectories(entries, workspaceBase) {
   return dirs;
 }
 var VirtualFileSystem = class {
-  constructor(tree, resolver, ctx, workspaceBase = "/") {
+  constructor(tree, resolver, ctx, workspaceBase = "/", inlineFiles) {
     this.resolver = resolver;
     this.ctx = ctx;
     this.workspaceBase = normalisePath(workspaceBase);
@@ -2356,11 +2385,18 @@ var VirtualFileSystem = class {
       tree.map((e) => [normalisePath(e.path, this.workspaceBase), e])
     );
     this.directories = inferDirectories(tree, this.workspaceBase);
+    this.inlineFiles = new Map(
+      inlineFiles ? Object.entries(inlineFiles).map(([p, c]) => [
+        normalisePath(p, this.workspaceBase),
+        c
+      ]) : []
+    );
   }
   workspaceBase;
   entries;
   directories;
   mutations = [];
+  inlineFiles;
   /** Return all mutations accumulated during this invocation. */
   getMutations() {
     return this.mutations;
@@ -2374,12 +2410,16 @@ var VirtualFileSystem = class {
   // --------------------------------------------------------------------------
   async readFile(path) {
     const norm = normalisePath(path, this.workspaceBase);
+    const inline = this.inlineFiles.get(norm);
+    if (inline !== void 0) return inline;
     const entry = this.entries.get(norm);
     if (!entry) throw new Error(`ENOENT: no such file: ${path}`);
     return this.resolver.readFile(entry.id, this.ctx, entry.metadata);
   }
   async readFileBuffer(path) {
     const norm = normalisePath(path, this.workspaceBase);
+    const inline = this.inlineFiles.get(norm);
+    if (inline !== void 0) return new TextEncoder().encode(inline);
     const entry = this.entries.get(norm);
     if (!entry) throw new Error(`ENOENT: no such file: ${path}`);
     return this.resolver.readFileBuffer(entry.id, this.ctx, entry.metadata);
@@ -2610,7 +2650,7 @@ var VirtualFileSystem = class {
 function withVirtualFs(client, resolver, handler) {
   return async (args, context) => {
     const state = await queryParentWorkflowState(client);
-    const { fileTree, resolverContext, workspaceBase } = state;
+    const { fileTree, ctx, workspaceBase, inlineFiles } = state;
     if (!fileTree) {
       return {
         toolResponse: `Error: No fileTree in agent state. The ${context.toolName} tool requires a virtual filesystem.`,
@@ -2620,8 +2660,9 @@ function withVirtualFs(client, resolver, handler) {
     const virtualFs = new VirtualFileSystem(
       fileTree,
       resolver,
-      resolverContext,
-      workspaceBase ?? "/"
+      ctx,
+      workspaceBase ?? "/",
+      inlineFiles
     );
     const response = await handler(args, { ...context, virtualFs });
     const mutations = virtualFs.getMutations();