zeitlich 0.2.25 → 0.2.27

package/dist/activities-DE3_q9yq.d.ts

@@ -0,0 +1,140 @@
+import Redis from 'ioredis';
+import { Part, Content, GoogleGenAI } from '@google/genai';
+import { R as RouterContext, T as ToolHandlerResponse, A as ActivityToolHandler } from './types-mCVxKIZb.js';
+import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix } from './types-CvJyXDYt.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-CIkYBoF8.js';
+
+/** SDK-native content type for Google GenAI human messages */
+type GoogleGenAIContent = string | Part[];
+/** A Content with a unique ID for idempotent Redis storage */
+interface StoredContent {
+    id: string;
+    content: Content;
+}
+type GoogleGenAIThreadManagerHooks = ThreadManagerHooks<StoredContent, Content>;
+interface GoogleGenAIThreadManagerConfig {
+    redis: Redis;
+    threadId: string;
+    /** Thread key, defaults to 'messages' */
+    key?: string;
+    hooks?: GoogleGenAIThreadManagerHooks;
+}
+/** Prepared payload ready to send to the Google GenAI API */
+interface GoogleGenAIInvocationPayload {
+    contents: Content[];
+    systemInstruction?: string;
+}
+/** Thread manager with Google GenAI Content convenience helpers */
+interface GoogleGenAIThreadManager extends ProviderThreadManager<StoredContent, GoogleGenAIContent, GoogleGenAIToolResponse> {
+    appendModelContent(id: string, parts: Part[]): Promise<void>;
+    prepareForInvocation(): Promise<GoogleGenAIInvocationPayload>;
+}
+/**
+ * Creates a Google GenAI-specific thread manager that stores StoredContent
+ * instances in Redis and provides convenience helpers for creating and
+ * appending typed Content messages.
+ */
+declare function createGoogleGenAIThreadManager(config: GoogleGenAIThreadManagerConfig): GoogleGenAIThreadManager;
+
+declare const ADAPTER_PREFIX: "googleGenAI";
+type GoogleGenAIThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_PREFIX>, GoogleGenAIContent>;
+interface GoogleGenAIAdapterConfig {
+    redis: Redis;
+    client?: GoogleGenAI;
+    /** Default model name (e.g. 'gemini-2.5-flash'). If omitted, use `createModelInvoker()` */
+    model?: string;
+    hooks?: GoogleGenAIThreadManagerHooks;
+}
+/**
+ * Tool response type accepted by the Google GenAI adapter.
+ *
+ * Handlers can return:
+ * - **`string`** — plain text, wrapped in a `functionResponse` part.
+ * - **`Record<string, unknown>`** — structured object used as `functionResponse.response`.
+ * - **`Part[]`** — pre-built parts used directly as `Content.parts`.
+ *   The handler is responsible for building correct Part objects (e.g. `functionResponse`,
+ *   `inlineData`, `text`). Use `context.toolCallId` and `context.toolName` to construct
+ *   `functionResponse` parts.
+ *
+ * @example
+ * ```typescript
+ * adapter.wrapHandler(async (args, ctx) => ({
+ *   toolResponse: [
+ *     { functionResponse: { id: ctx.toolCallId, name: ctx.toolName, response: { result: "done" } } },
+ *     { inlineData: { data: base64, mimeType: "image/png" } },
+ *   ],
+ *   data: null,
+ * }));
+ * ```
+ */
+type GoogleGenAIToolResponse = string | Record<string, unknown> | Part[];
+interface GoogleGenAIAdapter {
+    /** Model invoker using the default model (only available when `model` was provided) */
+    invoker: ModelInvoker<Content>;
+    /** Create an invoker for a specific model name (for multi-model setups) */
+    createModelInvoker(model: string, client: GoogleGenAI): ModelInvoker<Content>;
+    /**
+     * Create prefixed thread activities for registration on the worker.
+     *
+     * @param scope - Workflow name appended to the adapter prefix.
+     *   Use different scopes for the main agent vs subagents to avoid collisions.
+     *
+     * @example
+     * ```typescript
+     * adapter.createActivities("codingAgent")
+     * // → { googleGenAICodingAgentInitializeThread, googleGenAICodingAgentAppendHumanMessage, … }
+     *
+     * adapter.createActivities("researchAgent")
+     * // → { googleGenAIResearchAgentInitializeThread, … }
+     * ```
+     */
+    createActivities<S extends string = "">(scope?: S): GoogleGenAIThreadOps<S>;
+    /**
+     * Identity wrapper that types a tool handler for this adapter.
+     * Constrains `toolResponse` to {@link GoogleGenAIToolResponse}.
+     */
+    wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(handler: (args: TArgs, context: TContext) => Promise<ToolHandlerResponse<TResult, GoogleGenAIToolResponse>>): ActivityToolHandler<TArgs, TResult, TContext, GoogleGenAIToolResponse>;
+}
+/**
+ * Creates a Google GenAI adapter that bundles thread operations and model
+ * invocation using the `@google/genai` SDK.
+ *
+ * Use `createActivities(scope)` to register scoped thread operations as
+ * Temporal activities on the worker. The `invoker` (or invokers created via
+ * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.
+ *
+ * @example
+ * ```typescript
+ * import { createGoogleGenAIAdapter } from 'zeitlich/adapters/thread/google-genai';
+ * import { createRunAgentActivity } from 'zeitlich';
+ * import { GoogleGenAI } from '@google/genai';
+ *
+ * const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+ * const adapter = createGoogleGenAIAdapter({ redis, client, model: 'gemini-2.5-flash' });
+ *
+ * export function createActivities(temporalClient: WorkflowClient) {
+ *   return {
+ *     ...adapter.createActivities("codingAgent"),
+ *     runCodingAgent: createRunAgentActivity(temporalClient, adapter.invoker),
+ *   };
+ * }
+ * ```
+ *
+ * @example Multi-agent worker (main + subagent share the adapter)
+ * ```typescript
+ * export function createActivities(temporalClient: WorkflowClient) {
+ *   return {
+ *     ...adapter.createActivities("codingAgent"),
+ *     ...adapter.createActivities("researchAgent"),
+ *     runCodingAgent: createRunAgentActivity(temporalClient, adapter.invoker),
+ *     runResearchAgent: createRunAgentActivity(
+ *       temporalClient,
+ *       adapter.createModelInvoker('gemini-2.5-pro'),
+ *     ),
+ *   };
+ * }
+ * ```
+ */
+declare function createGoogleGenAIAdapter(config: GoogleGenAIAdapterConfig): GoogleGenAIAdapter;
+
+export { type GoogleGenAIThreadManagerHooks as G, type StoredContent as S, type GoogleGenAIAdapter as a, type GoogleGenAIAdapterConfig as b, type GoogleGenAIContent as c, type GoogleGenAIInvocationPayload as d, type GoogleGenAIThreadManager as e, type GoogleGenAIThreadManagerConfig as f, type GoogleGenAIThreadOps as g, type GoogleGenAIToolResponse as h, createGoogleGenAIAdapter as i, createGoogleGenAIThreadManager as j };

package/dist/activities-p8PDlRIK.d.cts

@@ -0,0 +1,140 @@
+import Redis from 'ioredis';
+import { Part, Content, GoogleGenAI } from '@google/genai';
+import { R as RouterContext, T as ToolHandlerResponse, A as ActivityToolHandler } from './types-mCVxKIZb.cjs';
+import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix } from './types-DSOefLpY.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BfIQABzu.cjs';
+
+/** SDK-native content type for Google GenAI human messages */
+type GoogleGenAIContent = string | Part[];
+/** A Content with a unique ID for idempotent Redis storage */
+interface StoredContent {
+    id: string;
+    content: Content;
+}
+type GoogleGenAIThreadManagerHooks = ThreadManagerHooks<StoredContent, Content>;
+interface GoogleGenAIThreadManagerConfig {
+    redis: Redis;
+    threadId: string;
+    /** Thread key, defaults to 'messages' */
+    key?: string;
+    hooks?: GoogleGenAIThreadManagerHooks;
+}
+/** Prepared payload ready to send to the Google GenAI API */
+interface GoogleGenAIInvocationPayload {
+    contents: Content[];
+    systemInstruction?: string;
+}
+/** Thread manager with Google GenAI Content convenience helpers */
+interface GoogleGenAIThreadManager extends ProviderThreadManager<StoredContent, GoogleGenAIContent, GoogleGenAIToolResponse> {
+    appendModelContent(id: string, parts: Part[]): Promise<void>;
+    prepareForInvocation(): Promise<GoogleGenAIInvocationPayload>;
+}
+/**
+ * Creates a Google GenAI-specific thread manager that stores StoredContent
+ * instances in Redis and provides convenience helpers for creating and
+ * appending typed Content messages.
+ */
+declare function createGoogleGenAIThreadManager(config: GoogleGenAIThreadManagerConfig): GoogleGenAIThreadManager;
+
+declare const ADAPTER_PREFIX: "googleGenAI";
+type GoogleGenAIThreadOps<TScope extends string = ""> = PrefixedThreadOps<ScopedPrefix<TScope, typeof ADAPTER_PREFIX>, GoogleGenAIContent>;
+interface GoogleGenAIAdapterConfig {
+    redis: Redis;
+    client?: GoogleGenAI;
+    /** Default model name (e.g. 'gemini-2.5-flash'). If omitted, use `createModelInvoker()` */
+    model?: string;
+    hooks?: GoogleGenAIThreadManagerHooks;
+}
+/**
+ * Tool response type accepted by the Google GenAI adapter.
+ *
+ * Handlers can return:
+ * - **`string`** — plain text, wrapped in a `functionResponse` part.
+ * - **`Record<string, unknown>`** — structured object used as `functionResponse.response`.
+ * - **`Part[]`** — pre-built parts used directly as `Content.parts`.
+ *   The handler is responsible for building correct Part objects (e.g. `functionResponse`,
+ *   `inlineData`, `text`). Use `context.toolCallId` and `context.toolName` to construct
+ *   `functionResponse` parts.
+ *
+ * @example
+ * ```typescript
+ * adapter.wrapHandler(async (args, ctx) => ({
+ *   toolResponse: [
+ *     { functionResponse: { id: ctx.toolCallId, name: ctx.toolName, response: { result: "done" } } },
+ *     { inlineData: { data: base64, mimeType: "image/png" } },
+ *   ],
+ *   data: null,
+ * }));
+ * ```
+ */
+type GoogleGenAIToolResponse = string | Record<string, unknown> | Part[];
+interface GoogleGenAIAdapter {
+    /** Model invoker using the default model (only available when `model` was provided) */
+    invoker: ModelInvoker<Content>;
+    /** Create an invoker for a specific model name (for multi-model setups) */
+    createModelInvoker(model: string, client: GoogleGenAI): ModelInvoker<Content>;
+    /**
+     * Create prefixed thread activities for registration on the worker.
+     *
+     * @param scope - Workflow name appended to the adapter prefix.
+     *   Use different scopes for the main agent vs subagents to avoid collisions.
+     *
+     * @example
+     * ```typescript
+     * adapter.createActivities("codingAgent")
+     * // → { googleGenAICodingAgentInitializeThread, googleGenAICodingAgentAppendHumanMessage, … }
+     *
+     * adapter.createActivities("researchAgent")
+     * // → { googleGenAIResearchAgentInitializeThread, … }
+     * ```
+     */
+    createActivities<S extends string = "">(scope?: S): GoogleGenAIThreadOps<S>;
+    /**
+     * Identity wrapper that types a tool handler for this adapter.
+     * Constrains `toolResponse` to {@link GoogleGenAIToolResponse}.
+     */
+    wrapHandler<TArgs, TResult, TContext extends RouterContext = RouterContext>(handler: (args: TArgs, context: TContext) => Promise<ToolHandlerResponse<TResult, GoogleGenAIToolResponse>>): ActivityToolHandler<TArgs, TResult, TContext, GoogleGenAIToolResponse>;
+}
+/**
+ * Creates a Google GenAI adapter that bundles thread operations and model
+ * invocation using the `@google/genai` SDK.
+ *
+ * Use `createActivities(scope)` to register scoped thread operations as
+ * Temporal activities on the worker. The `invoker` (or invokers created via
+ * `createModelInvoker`) should be wrapped with `createRunAgentActivity`.
+ *
+ * @example
+ * ```typescript
+ * import { createGoogleGenAIAdapter } from 'zeitlich/adapters/thread/google-genai';
+ * import { createRunAgentActivity } from 'zeitlich';
+ * import { GoogleGenAI } from '@google/genai';
+ *
+ * const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
+ * const adapter = createGoogleGenAIAdapter({ redis, client, model: 'gemini-2.5-flash' });
+ *
+ * export function createActivities(temporalClient: WorkflowClient) {
+ *   return {
+ *     ...adapter.createActivities("codingAgent"),
+ *     runCodingAgent: createRunAgentActivity(temporalClient, adapter.invoker),
+ *   };
+ * }
+ * ```
+ *
+ * @example Multi-agent worker (main + subagent share the adapter)
+ * ```typescript
+ * export function createActivities(temporalClient: WorkflowClient) {
+ *   return {
+ *     ...adapter.createActivities("codingAgent"),
+ *     ...adapter.createActivities("researchAgent"),
+ *     runCodingAgent: createRunAgentActivity(temporalClient, adapter.invoker),
+ *     runResearchAgent: createRunAgentActivity(
+ *       temporalClient,
+ *       adapter.createModelInvoker('gemini-2.5-pro'),
+ *     ),
+ *   };
+ * }
+ * ```
+ */
+declare function createGoogleGenAIAdapter(config: GoogleGenAIAdapterConfig): GoogleGenAIAdapter;
+
+export { type GoogleGenAIThreadManagerHooks as G, type StoredContent as S, type GoogleGenAIAdapter as a, type GoogleGenAIAdapterConfig as b, type GoogleGenAIContent as c, type GoogleGenAIInvocationPayload as d, type GoogleGenAIThreadManager as e, type GoogleGenAIThreadManagerConfig as f, type GoogleGenAIThreadOps as g, type GoogleGenAIToolResponse as h, createGoogleGenAIAdapter as i, createGoogleGenAIThreadManager as j };

package/dist/adapters/sandbox/virtual/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/sandbox/types.ts","../../../../src/adapters/sandbox/virtual/filesystem.ts","../../../../src/lib/thread/id.ts","../../../../src/adapters/sandbox/virtual/provider.ts","../../../../src/lib/activity.ts","../../../../src/adapters/sandbox/virtual/with-virtual-sandbox.ts","../../../../src/adapters/sandbox/virtual/queries.ts","../../../../src/adapters/sandbox/virtual/index.ts"],"names":["ApplicationFailure","posix","path","uuid4","Context"],"mappings":"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","file":"index.cjs","sourcesContent":["// ============================================================================\n// Sandbox Filesystem\n// ============================================================================\n\nexport interface DirentEntry {\n  name: string;\n  isFile: boolean;\n  isDirectory: boolean;\n  isSymbolicLink: boolean;\n}\n\nexport interface FileStat {\n  isFile: boolean;\n  isDirectory: boolean;\n  isSymbolicLink: boolean;\n  size: number;\n  mtime: Date;\n}\n\n/**\n * Provider-agnostic filesystem interface.\n *\n * Implementations that don't support a method should throw\n * {@link SandboxNotSupportedError}.\n */\nexport interface SandboxFileSystem {\n  /** Base directory used when resolving relative paths. */\n  readonly workspaceBase: string;\n  readFile(path: string): Promise<string>;\n  readFileBuffer(path: string): Promise<Uint8Array>;\n  writeFile(path: string, content: string | Uint8Array): Promise<void>;\n  appendFile(path: string, content: string | Uint8Array): Promise<void>;\n  exists(path: string): Promise<boolean>;\n  stat(path: string): Promise<FileStat>;\n  mkdir(path: string, options?: { recursive?: boolean }): Promise<void>;\n  readdir(path: string): Promise<string[]>;\n  readdirWithFileTypes(path: string): Promise<DirentEntry[]>;\n  rm(\n    path: string,\n    options?: { recursive?: boolean; force?: boolean }\n  ): Promise<void>;\n  cp(\n    src: string,\n    dest: string,\n    options?: { recursive?: boolean }\n  ): Promise<void>;\n  mv(src: string, dest: string): Promise<void>;\n  readlink(path: string): Promise<string>;\n  resolvePath(base: string, path: string): string;\n}\n\n// ============================================================================\n// Execution\n// ============================================================================\n\nexport interface ExecOptions {\n  timeout?: number;\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ExecResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n// ============================================================================\n// Capabilities\n// ============================================================================\n\nexport interface SandboxCapabilities {\n  /** Sandbox supports filesystem operations */\n  filesystem: boolean;\n  /** Sandbox supports shell/command execution */\n  execution: boolean;\n  /** Sandbox state can be persisted and restored */\n  persistence: boolean;\n}\n\n// ============================================================================\n// Sandbox\n// ============================================================================\n\nexport interface Sandbox {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n  readonly fs: SandboxFileSystem;\n\n  exec(command: string, options?: ExecOptions): Promise<ExecResult>;\n  destroy(): Promise<void>;\n}\n\n// ============================================================================\n// Snapshots\n// ============================================================================\n\nexport interface SandboxSnapshot {\n  sandboxId: string;\n  providerId: string;\n  /** Provider-specific serialised state */\n  data: unknown;\n  createdAt: string;\n}\n\n// ============================================================================\n// Provider\n// ============================================================================\n\nexport interface SandboxCreateOptions {\n  /** Preferred sandbox ID (provider may ignore) */\n  id?: string;\n  /** Seed the filesystem with these files */\n  initialFiles?: Record<string, string | Uint8Array>;\n  /** Environment variables available inside the sandbox */\n  env?: Record<string, string>;\n}\n\nexport interface SandboxCreateResult {\n  sandbox: Sandbox;\n  /** Optional state to merge into the workflow's `AgentState` via the session. */\n  stateUpdate?: Record<string, unknown>;\n}\n\nexport interface SandboxProvider<\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n  TSandbox extends Sandbox = Sandbox,\n> {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n\n  create(options?: TOptions): Promise<SandboxCreateResult>;\n  get(sandboxId: string): Promise<TSandbox>;\n  destroy(sandboxId: string): Promise<void>;\n  pause(sandboxId: string, ttlSeconds?: number): Promise<void>;\n  snapshot(sandboxId: string): Promise<SandboxSnapshot>;\n  restore(snapshot: SandboxSnapshot): Promise<Sandbox>;\n  fork(sandboxId: string): Promise<Sandbox>;\n}\n\n// ============================================================================\n// SandboxOps — workflow-side activity interface (like ThreadOps)\n// ============================================================================\n\nexport interface SandboxOps<\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n> {\n  createSandbox(\n    options?: TOptions\n  ): Promise<{ sandboxId: string; stateUpdate?: Record<string, unknown> }>;\n  destroySandbox(sandboxId: string): Promise<void>;\n  pauseSandbox(sandboxId: string): Promise<void>;\n  snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;\n  forkSandbox(sandboxId: string): Promise<string>;\n}\n\n/**\n * Maps generic {@link SandboxOps} method names to adapter-prefixed names.\n *\n * @example\n * ```typescript\n * type InMemOps = PrefixedSandboxOps<\"inMemory\">;\n * // → { inMemoryCreateSandbox, inMemoryDestroySandbox, inMemorySnapshotSandbox }\n * ```\n */\nexport type PrefixedSandboxOps<\n  TPrefix extends string,\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n> = {\n  [K in keyof SandboxOps<TOptions> as `${TPrefix}${Capitalize<K & string>}`]: SandboxOps<TOptions>[K];\n};\n\n// ============================================================================\n// Errors\n// ============================================================================\n\nimport { ApplicationFailure } from \"@temporalio/common\";\n\nexport class SandboxNotSupportedError extends ApplicationFailure {\n  constructor(operation: string) {\n    super(\n      `Sandbox does not support: ${operation}`,\n      \"SandboxNotSupportedError\",\n      true\n    );\n  }\n}\n\nexport class SandboxNotFoundError extends ApplicationFailure {\n  constructor(sandboxId: string) {\n    super(`Sandbox not found: ${sandboxId}`, \"SandboxNotFoundError\", true);\n  }\n}\n","import type {\n  SandboxFileSystem,\n  DirentEntry,\n  FileStat,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotSupportedError } from \"../../../lib/sandbox/types\";\nimport { posix } from \"node:path\";\nimport type {\n  FileEntry,\n  FileEntryMetadata,\n  FileResolver,\n  TreeMutation,\n} from \"./types\";\n\n/** Normalize a path against the provided workspace base. */\nfunction normalisePath(p: string, workspaceBase = \"/\"): string {\n  return posix.resolve(workspaceBase, p);\n}\n\n/** Return the parent directory of a normalised path (\"/a/b\" → \"/a\"). */\nfunction parentDir(p: string): string {\n  const idx = p.lastIndexOf(\"/\");\n  return idx <= 0 ? \"/\" : p.slice(0, idx);\n}\n\n/**\n * Collect the set of implicit directory paths from a flat file list.\n * E.g. \"/a/b/c.ts\" contributes \"/a/b\", \"/a\", \"/\".\n */\nfunction inferDirectories(\n  entries: { path: string }[],\n  workspaceBase: string\n): Set<string> {\n  const dirs = new Set<string>();\n  dirs.add(\"/\");\n  for (const entry of entries) {\n    let dir = parentDir(normalisePath(entry.path, workspaceBase));\n    while (dir !== \"/\" && !dirs.has(dir)) {\n      dirs.add(dir);\n      dir = parentDir(dir);\n    }\n    dirs.add(\"/\");\n  }\n  return dirs;\n}\n\n/**\n * Ephemeral {@link SandboxFileSystem} backed by a {@link FileResolver}.\n *\n * Created fresh for each tool invocation from the current workflow file tree.\n * Directory structure is inferred from file paths. All mutations are tracked\n * and can be retrieved via {@link getMutations} after the handler completes.\n */\nexport class VirtualSandboxFileSystem<\n  TCtx = unknown,\n  TMeta = FileEntryMetadata,\n> implements SandboxFileSystem {\n  readonly workspaceBase: string;\n  private entries: Map<string, FileEntry<TMeta>>;\n  private directories: Set<string>;\n  private mutations: TreeMutation<TMeta>[] = [];\n\n  constructor(\n    tree: FileEntry<TMeta>[],\n    private resolver: FileResolver<TCtx, TMeta>,\n    private ctx: TCtx,\n    workspaceBase = \"/\",\n  ) {\n    this.workspaceBase = normalisePath(workspaceBase);\n    this.entries = new Map(\n      tree.map((e) => [normalisePath(e.path, this.workspaceBase), e])\n    );\n    this.directories = inferDirectories(tree, this.workspaceBase);\n  }\n\n  /** Return all mutations accumulated during this invocation. */\n  getMutations(): TreeMutation<TMeta>[] {\n    return this.mutations;\n  }\n\n  /** Look up a file entry by virtual path. */\n  getEntry(path: string): FileEntry<TMeta> | undefined {\n    return this.entries.get(normalisePath(path, this.workspaceBase));\n  }\n\n  // --------------------------------------------------------------------------\n  // Read operations — delegate to resolver lazily\n  // --------------------------------------------------------------------------\n\n  async readFile(path: string): Promise<string> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFile(entry.id, this.ctx, entry.metadata);\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFileBuffer(entry.id, this.ctx, entry.metadata);\n  }\n\n  // --------------------------------------------------------------------------\n  // Metadata operations — pure, resolved from the tree\n  // --------------------------------------------------------------------------\n\n  async exists(path: string): Promise<boolean> {\n    const norm = normalisePath(path, this.workspaceBase);\n    return this.entries.has(norm) || this.directories.has(norm);\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n    if (entry) {\n      return {\n        isFile: true,\n        isDirectory: false,\n        isSymbolicLink: false,\n        size: entry.size,\n        mtime: new Date(entry.mtime),\n      };\n    }\n    if (this.directories.has(norm)) {\n      return {\n        isFile: false,\n        isDirectory: true,\n        isSymbolicLink: false,\n        size: 0,\n        mtime: new Date(),\n      };\n    }\n    throw new Error(`ENOENT: no such file or directory: ${path}`);\n  }\n\n  async readdir(path: string): Promise<string[]> {\n    const norm = normalisePath(path, this.workspaceBase);\n    if (!this.directories.has(norm)) {\n      throw new Error(`ENOENT: no such directory: ${path}`);\n    }\n    const prefix = norm === \"/\" ? \"/\" : norm + \"/\";\n    const names = new Set<string>();\n\n    for (const p of this.entries.keys()) {\n      if (p.startsWith(prefix)) {\n        const rest = p.slice(prefix.length);\n        const seg = rest.split(\"/\")[0];\n        if (seg) names.add(seg);\n      }\n    }\n    for (const d of this.directories) {\n      if (d.startsWith(prefix) && d !== norm) {\n        const rest = d.slice(prefix.length);\n        const seg = rest.split(\"/\")[0];\n        if (seg) names.add(seg);\n      }\n    }\n    return [...names].sort();\n  }\n\n  async readdirWithFileTypes(path: string): Promise<DirentEntry[]> {\n    const names = await this.readdir(path);\n    const norm = normalisePath(path, this.workspaceBase);\n    const prefix = norm === \"/\" ? \"/\" : norm + \"/\";\n\n    return names.map((name) => {\n      const full = prefix + name;\n      const isFile = this.entries.has(full);\n      const isDirectory = this.directories.has(full);\n      return { name, isFile, isDirectory, isSymbolicLink: false };\n    });\n  }\n\n  // --------------------------------------------------------------------------\n  // Write operations — delegate to resolver, record mutations\n  // --------------------------------------------------------------------------\n\n  async writeFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const existing = this.entries.get(norm);\n\n    if (existing) {\n      await this.resolver.writeFile(\n        existing.id,\n        content,\n        this.ctx,\n        existing.metadata\n      );\n      const size =\n        typeof content === \"string\"\n          ? new TextEncoder().encode(content).byteLength\n          : content.byteLength;\n      const updated: FileEntry<TMeta> = {\n        ...existing,\n        size,\n        mtime: new Date().toISOString(),\n      };\n      this.entries.set(norm, updated);\n      this.mutations.push({ type: \"update\", path: norm, entry: updated });\n    } else {\n      const entry = await this.resolver.createFile(norm, content, this.ctx);\n      const normalised = { ...entry, path: norm };\n      this.entries.set(norm, normalised);\n      this.addParentDirectories(norm);\n      this.mutations.push({ type: \"add\", entry: normalised });\n    }\n  }\n\n  async appendFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const existing = this.entries.get(norm);\n\n    if (!existing) {\n      return this.writeFile(path, content);\n    }\n\n    const current = await this.resolver.readFile(\n      existing.id,\n      this.ctx,\n      existing.metadata\n    );\n    const appended =\n      typeof content === \"string\"\n        ? current + content\n        : current + new TextDecoder().decode(content);\n    await this.resolver.writeFile(\n      existing.id,\n      appended,\n      this.ctx,\n      existing.metadata\n    );\n\n    const size = new TextEncoder().encode(appended).byteLength;\n    const updated: FileEntry<TMeta> = {\n      ...existing,\n      size,\n      mtime: new Date().toISOString(),\n    };\n    this.entries.set(norm, updated);\n    this.mutations.push({ type: \"update\", path: norm, entry: updated });\n  }\n\n  async mkdir(\n    _path: string,\n    _options?: { recursive?: boolean }\n  ): Promise<void> {\n    const norm = normalisePath(_path, this.workspaceBase);\n    if (this.directories.has(norm)) return;\n\n    if (_options?.recursive) {\n      this.addParentDirectories(norm + \"/placeholder\");\n      this.directories.add(norm);\n    } else {\n      const parent = parentDir(norm);\n      if (!this.directories.has(parent)) {\n        throw new Error(`ENOENT: no such directory: ${parent}`);\n      }\n      this.directories.add(norm);\n    }\n  }\n\n  async rm(\n    path: string,\n    options?: { recursive?: boolean; force?: boolean }\n  ): Promise<void> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n\n    if (entry) {\n      await this.resolver.deleteFile(entry.id, this.ctx, entry.metadata);\n      this.entries.delete(norm);\n      this.mutations.push({ type: \"remove\", path: norm });\n      return;\n    }\n\n    if (this.directories.has(norm)) {\n      if (!options?.recursive) {\n        throw new Error(`EISDIR: is a directory (use recursive): ${path}`);\n      }\n      const prefix = norm === \"/\" ? \"/\" : norm + \"/\";\n      for (const [p, e] of this.entries) {\n        if (p.startsWith(prefix)) {\n          await this.resolver.deleteFile(e.id, this.ctx, e.metadata);\n          this.entries.delete(p);\n          this.mutations.push({ type: \"remove\", path: p });\n        }\n      }\n      for (const d of this.directories) {\n        if (d.startsWith(prefix)) this.directories.delete(d);\n      }\n      this.directories.delete(norm);\n      return;\n    }\n\n    if (!options?.force) {\n      throw new Error(`ENOENT: no such file or directory: ${path}`);\n    }\n  }\n\n  async cp(\n    src: string,\n    dest: string,\n    _options?: { recursive?: boolean }\n  ): Promise<void> {\n    const normSrc = normalisePath(src, this.workspaceBase);\n    const normDest = normalisePath(dest, this.workspaceBase);\n\n    const entry = this.entries.get(normSrc);\n    if (entry) {\n      const content = await this.resolver.readFile(\n        entry.id,\n        this.ctx,\n        entry.metadata\n      );\n      await this.writeFile(normDest, content);\n      return;\n    }\n\n    if (!this.directories.has(normSrc)) {\n      throw new Error(`ENOENT: no such file or directory: ${src}`);\n    }\n    if (!_options?.recursive) {\n      throw new Error(`EISDIR: is a directory (use recursive): ${src}`);\n    }\n\n    const prefix = normSrc === \"/\" ? \"/\" : normSrc + \"/\";\n    for (const [p, e] of this.entries) {\n      if (p.startsWith(prefix)) {\n        const relative = p.slice(normSrc.length);\n        const content = await this.resolver.readFile(\n          e.id,\n          this.ctx,\n          e.metadata\n        );\n        await this.writeFile(normDest + relative, content);\n      }\n    }\n  }\n\n  async mv(src: string, dest: string): Promise<void> {\n    await this.cp(src, dest, { recursive: true });\n    await this.rm(src, { recursive: true });\n  }\n\n  // --------------------------------------------------------------------------\n  // Unsupported\n  // --------------------------------------------------------------------------\n\n  async readlink(_path: string): Promise<string> {\n    throw new SandboxNotSupportedError(\"readlink\");\n  }\n\n  resolvePath(base: string, path: string): string {\n    return posix.resolve(normalisePath(base, this.workspaceBase), path);\n  }\n\n  // --------------------------------------------------------------------------\n  // Helpers\n  // --------------------------------------------------------------------------\n\n  private addParentDirectories(filePath: string): void {\n    let dir = parentDir(normalisePath(filePath, this.workspaceBase));\n    while (!this.directories.has(dir)) {\n      this.directories.add(dir);\n      dir = parentDir(dir);\n    }\n  }\n}\n","import { uuid4 } from \"@temporalio/workflow\";\n\nconst BASE62 =\n  \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n\n/**\n * Generate a compact, workflow-deterministic identifier.\n *\n * Uses Temporal's `uuid4()` internally (seeded by the workflow's RNG),\n * then re-encodes the hex bytes into a base-62 alphabet for a shorter,\n * more token-efficient identifier (~3 tokens vs ~10 for a full UUID).\n *\n * Suitable for thread IDs, child workflow IDs, or any workflow-scoped identifier.\n *\n * @param length - Number of base-62 characters (default 12, ~71 bits of entropy)\n */\nexport function getShortId(length = 12): string {\n  const hex = uuid4().replace(/-/g, \"\");\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    const byte = parseInt(hex.slice(i * 2, i * 2 + 2), 16);\n    result += BASE62[byte % BASE62.length];\n  }\n  return result;\n}\n","import type {\n  SandboxCapabilities,\n  SandboxCreateResult,\n  SandboxProvider,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotSupportedError } from \"../../../lib/sandbox/types\";\nimport { getShortId } from \"../../../lib/thread/id\";\nimport { createVirtualSandbox } from \"./index\";\nimport type {\n  FileEntryMetadata,\n  FileResolver,\n  VirtualSandboxCreateOptions,\n} from \"./types\";\n\n/**\n * Stateless {@link SandboxProvider} backed by a {@link FileResolver}.\n *\n * The provider holds **no internal state**. All sandbox state (sandboxId,\n * fileTree, resolverContext, workspaceBase) is returned as a `stateUpdate` from\n * {@link create} and merged into the workflow's `AgentState` by the session.\n * {@link withVirtualSandbox} reads this state back on every tool invocation.\n *\n * @example\n * ```typescript\n * const provider = new VirtualSandboxProvider(resolver);\n * const manager = new SandboxManager(provider);\n *\n * export const activities = {\n *   ...manager.createActivities(\"CodingAgent\"),\n *   readFile: withVirtualSandbox(client, provider, readHandler),\n * };\n * ```\n */\nexport class VirtualSandboxProvider<\n  TCtx = unknown,\n  TMeta = FileEntryMetadata,\n> implements SandboxProvider<VirtualSandboxCreateOptions<TCtx>> {\n  readonly id = \"virtual\";\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: false,\n    persistence: true,\n  };\n\n  readonly resolver: FileResolver<TCtx, TMeta>;\n\n  constructor(resolver: FileResolver<TCtx, TMeta>) {\n    this.resolver = resolver;\n  }\n\n  async create(\n    options?: VirtualSandboxCreateOptions<TCtx>\n  ): Promise<SandboxCreateResult> {\n    if (!options || !(\"resolverContext\" in options)) {\n      throw new Error(\"VirtualSandboxProvider.create requires resolverContext\");\n    }\n\n    const sandboxId = options.id ?? getShortId();\n    const fileTree = await this.resolver.resolveEntries(\n      options.resolverContext\n    );\n    const workspaceBase = options.workspaceBase ?? \"/\";\n\n    const sandbox = createVirtualSandbox(\n      sandboxId,\n      fileTree,\n      this.resolver,\n      options.resolverContext,\n      workspaceBase,\n    );\n\n    if (options.initialFiles) {\n      for (const [path, content] of Object.entries(options.initialFiles)) {\n        await sandbox.fs.writeFile(path, content);\n      }\n      for (const m of sandbox.fs.getMutations()) {\n        if (m.type === \"add\") fileTree.push(m.entry);\n      }\n    }\n\n    return {\n      sandbox,\n      stateUpdate: {\n        sandboxId,\n        fileTree,\n        resolverContext: options.resolverContext,\n        workspaceBase,\n      },\n    };\n  }\n\n  async get(): Promise<never> {\n    throw new SandboxNotSupportedError(\n      \"get (virtual sandbox state lives in workflow AgentState)\"\n    );\n  }\n\n  async destroy(): Promise<void> {\n    // No-op — no internal state to clean up\n  }\n\n  async pause(): Promise<void> {\n    // No-op — virtual sandbox state lives in workflow AgentState\n  }\n\n  async fork(_sandboxId: string): Promise<never> {\n    throw new Error(\"Not implemented\");\n  }\n\n  async snapshot(): Promise<never> {\n    throw new SandboxNotSupportedError(\n      \"snapshot (virtual sandbox state lives in workflow AgentState)\"\n    );\n  }\n\n  async restore(): Promise<never> {\n    throw new SandboxNotSupportedError(\n      \"restore (virtual sandbox state lives in workflow AgentState)\"\n    );\n  }\n}\n","import { Context } from \"@temporalio/activity\";\nimport type { WorkflowClient } from \"@temporalio/client\";\nimport type { BaseAgentState, RunAgentConfig } from \"./types\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"./tool-router/types\";\n\n/**\n * Query the parent workflow's state from within an activity.\n * Resolves the workflow handle from the current activity context.\n */\nexport async function queryParentWorkflowState<T>(\n  client: WorkflowClient\n): Promise<T> {\n  const { workflowExecution } = Context.current().info;\n  const handle = client.getHandle(\n    workflowExecution.workflowId,\n    workflowExecution.runId\n  );\n  return handle.query<T>(\"getAgentState\");\n}\n\n/**\n * Wraps a handler into a `RunAgentActivity` by auto-fetching the parent\n * workflow's agent state before each invocation.\n *\n * @example\n * ```typescript\n * import { createRunAgentActivity } from 'zeitlich';\n * import { createLangChainModelInvoker } from 'zeitlich/adapters/thread/langchain';\n *\n * const invoker = createLangChainModelInvoker({ redis, model });\n * return { runAgent: createRunAgentActivity(client, invoker) };\n * ```\n */\nexport function createRunAgentActivity<R, S extends BaseAgentState = BaseAgentState>(\n  client: WorkflowClient,\n  handler: (config: RunAgentConfig & { state: S }) => Promise<R>,\n): (config: RunAgentConfig) => Promise<R> {\n  return async (config: RunAgentConfig) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler({ ...config, state });\n  };\n}\n\n/**\n * Context injected into tool handlers created via {@link withParentWorkflowState}.\n */\nexport interface AgentStateContext<S extends BaseAgentState = BaseAgentState> extends RouterContext {\n  state: S;\n}\n\n/**\n * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the\n * parent workflow's agent state before each invocation.\n *\n * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)\n *\n * @example\n * ```typescript\n * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';\n *\n * // With custom state:\n * interface MyState extends BaseAgentState { customField: string }\n * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(\n *   client,\n *   async (args, ctx) => {\n *     console.log(ctx.state.customField);\n *     return { toolResponse: 'done', data: null };\n *   },\n * );\n * ```\n */\nexport function withParentWorkflowState<TArgs, TResult, S extends BaseAgentState = BaseAgentState>(\n  client: WorkflowClient,\n  handler: (\n    args: TArgs,\n    context: AgentStateContext<S>,\n  ) => Promise<ToolHandlerResponse<TResult>>,\n): ActivityToolHandler<TArgs, TResult> {\n  return async (args, context) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler(args, { ...context, state });\n  };\n}\n","import type { WorkflowClient } from \"@temporalio/client\";\nimport { queryParentWorkflowState } from \"../../../lib/activity\";\nimport type { ActivityToolHandler } from \"../../../lib/tool-router/types\";\nimport type {\n  FileEntryMetadata,\n  TreeMutation,\n  VirtualSandboxContext,\n  VirtualSandboxState,\n} from \"./types\";\nimport type { VirtualSandboxProvider } from \"./provider\";\nimport { createVirtualSandbox } from \"./index\";\n\n/**\n * Wraps a tool handler that needs a virtual sandbox, automatically querying\n * the parent workflow for the current file tree and resolver context.\n *\n * On each invocation the wrapper:\n * 1. Queries the workflow's `AgentState` for `fileTree`, `resolverContext`, and `workspaceBase`\n * 2. Creates an ephemeral {@link VirtualSandbox} from tree + provider's resolver\n * 3. Runs the inner handler\n * 4. Returns the handler's result together with any {@link TreeMutation}s\n *\n * The consumer applies mutations back to workflow state via a post-tool hook.\n *\n * @param client    - Temporal `WorkflowClient` for querying the parent workflow\n * @param agentName - Agent name (used to derive the state query name)\n * @param provider  - {@link VirtualSandboxProvider} (wraps the resolver)\n * @param handler   - Inner handler expecting a {@link VirtualSandboxContext}\n *\n * @example\n * ```typescript\n * import { withVirtualSandbox, type VirtualSandboxContext } from 'zeitlich';\n *\n * const readHandler: ActivityToolHandler<FileReadArgs, ReadResult, VirtualSandboxContext> =\n *   async (args, { sandbox }) => {\n *     const content = await sandbox.fs.readFile(args.path);\n *     return { toolResponse: content, data: { path: args.path, content } };\n *   };\n *\n * // At activity registration:\n * const provider = new VirtualSandboxProvider(resolver);\n * const handler = withVirtualSandbox(client, \"myAgent\", provider, readHandler);\n * ```\n */\nexport function withVirtualSandbox<\n  TArgs,\n  TResult,\n  TCtx,\n  TMeta = FileEntryMetadata,\n>(\n  client: WorkflowClient,\n  provider: VirtualSandboxProvider<TCtx, TMeta>,\n  handler: ActivityToolHandler<\n    TArgs,\n    TResult,\n    VirtualSandboxContext<TCtx, TMeta>\n  >\n): ActivityToolHandler<\n  TArgs,\n  (TResult & { treeMutations: TreeMutation<TMeta>[] }) | null\n> {\n  return async (args, context) => {\n    const state =\n      await queryParentWorkflowState<VirtualSandboxState<TCtx, TMeta>>(client);\n\n    const { sandboxId, fileTree, resolverContext, workspaceBase } = state;\n    if (!fileTree || !sandboxId) {\n      return {\n        toolResponse: `Error: No fileTree/sandboxId in agent state. The ${context.toolName} tool requires a virtual sandbox.`,\n        data: null,\n      };\n    }\n\n    const sandbox = createVirtualSandbox(\n      sandboxId,\n      fileTree,\n      provider.resolver,\n      resolverContext,\n      workspaceBase ?? \"/\",\n    );\n    const response = await handler(args, { ...context, sandbox });\n    const mutations = sandbox.fs.getMutations();\n\n    return {\n      toolResponse: response.toolResponse,\n      data: {\n        ...(response.data ?? {}),\n        treeMutations: mutations,\n      } as TResult & { treeMutations: TreeMutation<TMeta>[] },\n    };\n  };\n}\n","import type { FileEntry } from \"./types\";\n\n/**\n * Structural constraint: accepts any `AgentStateManager<T>` whose custom\n * state includes `fileTree: FileEntry<TMeta>[]`.\n */\nexport interface FileTreeAccessor<TMeta> {\n  get(key: \"fileTree\"): FileEntry<TMeta>[];\n}\n\n/**\n * Check whether any file in the tree has a `metadata.mimeType` that matches\n * the given pattern.\n *\n * Patterns:\n * - Exact: `\"application/pdf\"`\n * - Wildcard type: `\"image/*\"`\n *\n * Useful for conditionally enabling tools:\n *\n * ```ts\n * { enabled: hasFileWithMimeType(stateManager, \"image/*\") }\n * { enabled: hasFileWithMimeType(stateManager, [\"image/*\", \"application/pdf\"]) }\n * ```\n */\nexport function hasFileWithMimeType<TMeta>(\n  stateManager: FileTreeAccessor<TMeta>,\n  pattern: string | string[],\n): boolean {\n  const tree = stateManager.get(\"fileTree\");\n  const matchers = (Array.isArray(pattern) ? pattern : [pattern]).map(buildMatcher);\n  return tree.some((entry) => {\n    const meta = entry.metadata as Record<string, unknown> | undefined;\n    const mime = meta?.mimeType;\n    return typeof mime === \"string\" && matchers.some((m) => m(mime));\n  });\n}\n\n/**\n * Return all entries whose `metadata.mimeType` matches the given pattern.\n */\nexport function filesWithMimeType<TMeta>(\n  stateManager: FileTreeAccessor<TMeta>,\n  pattern: string,\n): FileEntry<TMeta>[] {\n  const tree = stateManager.get(\"fileTree\");\n  const match = buildMatcher(pattern);\n  return tree.filter((entry) => {\n    const meta = entry.metadata as Record<string, unknown> | undefined;\n    const mime = meta?.mimeType;\n    return typeof mime === \"string\" && match(mime);\n  });\n}\n\n/**\n * Check whether the tree contains a directory whose name matches the given\n * pattern. Directories are inferred from file paths.\n *\n * Patterns:\n * - Exact: `\"src\"`\n * - Glob with `*` wildcard: `\"test*\"`, `\"*.generated\"`\n *\n * ```ts\n * { enabled: hasDirectory(stateManager, \"test*\") }\n * ```\n */\nexport function hasDirectory<TMeta>(\n  stateManager: FileTreeAccessor<TMeta>,\n  pattern: string,\n): boolean {\n  const tree = stateManager.get(\"fileTree\");\n  const match = buildGlobMatcher(pattern);\n  return tree.some((entry) => {\n    const segments = entry.path.split(\"/\").filter(Boolean);\n    return segments.slice(0, -1).some(match);\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Internal matchers\n// ---------------------------------------------------------------------------\n\nfunction buildMatcher(pattern: string): (value: string) => boolean {\n  if (pattern.endsWith(\"/*\")) {\n    const prefix = pattern.slice(0, -1);\n    return (v) => v.startsWith(prefix);\n  }\n  return (v) => v === pattern;\n}\n\nfunction buildGlobMatcher(pattern: string): (value: string) => boolean {\n  if (!pattern.includes(\"*\")) return (v) => v === pattern;\n  const re = new RegExp(\n    \"^\" + pattern.replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\").replace(/\\*/g, \".*\") + \"$\",\n  );\n  return (v) => re.test(v);\n}\n","import type {\n  Sandbox,\n  SandboxCapabilities,\n  ExecOptions,\n  ExecResult,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotSupportedError } from \"../../../lib/sandbox/types\";\nimport { VirtualSandboxFileSystem } from \"./filesystem\";\nimport type {\n  FileEntry,\n  FileEntryMetadata,\n  FileResolver,\n  VirtualSandbox,\n} from \"./types\";\n\n// ============================================================================\n// VirtualSandbox\n// ============================================================================\n\nclass VirtualSandboxImpl<\n  TCtx = unknown,\n  TMeta = FileEntryMetadata,\n> implements Sandbox\n{\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: false,\n    persistence: true,\n  };\n\n  readonly fs: VirtualSandboxFileSystem<TCtx, TMeta>;\n\n  constructor(\n    readonly id: string,\n    tree: FileEntry<TMeta>[],\n    resolver: FileResolver<TCtx, TMeta>,\n    ctx: TCtx,\n    workspaceBase = \"/\",\n  ) {\n    this.fs = new VirtualSandboxFileSystem(tree, resolver, ctx, workspaceBase);\n  }\n\n  async exec(_command: string, _options?: ExecOptions): Promise<ExecResult> {\n    throw new SandboxNotSupportedError(\"exec\");\n  }\n\n  async destroy(): Promise<void> {\n    // Ephemeral — nothing to clean up\n  }\n}\n\n// ============================================================================\n// Factory\n// ============================================================================\n\n/**\n * Create an ephemeral {@link Sandbox} from a file tree and resolver.\n *\n * Used internally by {@link withVirtualSandbox} and\n * {@link VirtualSandboxProvider}; consumers can also call this directly\n * if they need a sandbox outside the wrapper pattern.\n */\nexport function createVirtualSandbox<\n  TCtx,\n  TMeta = FileEntryMetadata,\n>(\n  id: string,\n  tree: FileEntry<TMeta>[],\n  resolver: FileResolver<TCtx, TMeta>,\n  ctx: TCtx,\n  workspaceBase = \"/\",\n): VirtualSandbox<TCtx, TMeta> {\n  return new VirtualSandboxImpl(id, tree, resolver, ctx, workspaceBase);\n}\n\n// Re-exports for convenience\nexport { VirtualSandboxFileSystem } from \"./filesystem\";\nexport { VirtualSandboxProvider } from \"./provider\";\nexport { withVirtualSandbox } from \"./with-virtual-sandbox\";\nexport { hasFileWithMimeType, filesWithMimeType, hasDirectory } from \"./queries\";\nexport type { FileTreeAccessor } from \"./queries\";\nexport type {\n  FileEntry,\n  FileEntryMetadata,\n  FileResolver,\n  VirtualFileTree,\n  VirtualSandboxCreateOptions,\n  VirtualSandboxState,\n  VirtualSandboxContext,\n  VirtualSandbox,\n  TreeMutation,\n} from \"./types\";\n"]}
+{"version":3,"sources":["../../../../src/lib/sandbox/types.ts","../../../../src/adapters/sandbox/virtual/filesystem.ts","../../../../src/lib/thread/id.ts","../../../../src/adapters/sandbox/virtual/provider.ts","../../../../src/lib/activity.ts","../../../../src/adapters/sandbox/virtual/with-virtual-sandbox.ts","../../../../src/adapters/sandbox/virtual/queries.ts","../../../../src/adapters/sandbox/virtual/index.ts"],"names":["ApplicationFailure","posix","path","uuid4","Context"],"mappings":"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","file":"index.cjs","sourcesContent":["// ============================================================================\n// Sandbox Filesystem\n// ============================================================================\n\nexport interface DirentEntry {\n  name: string;\n  isFile: boolean;\n  isDirectory: boolean;\n  isSymbolicLink: boolean;\n}\n\nexport interface FileStat {\n  isFile: boolean;\n  isDirectory: boolean;\n  isSymbolicLink: boolean;\n  size: number;\n  mtime: Date;\n}\n\n/**\n * Provider-agnostic filesystem interface.\n *\n * Implementations that don't support a method should throw\n * {@link SandboxNotSupportedError}.\n */\nexport interface SandboxFileSystem {\n  /** Base directory used when resolving relative paths. */\n  readonly workspaceBase: string;\n  readFile(path: string): Promise<string>;\n  readFileBuffer(path: string): Promise<Uint8Array>;\n  writeFile(path: string, content: string | Uint8Array): Promise<void>;\n  appendFile(path: string, content: string | Uint8Array): Promise<void>;\n  exists(path: string): Promise<boolean>;\n  stat(path: string): Promise<FileStat>;\n  mkdir(path: string, options?: { recursive?: boolean }): Promise<void>;\n  readdir(path: string): Promise<string[]>;\n  readdirWithFileTypes(path: string): Promise<DirentEntry[]>;\n  rm(\n    path: string,\n    options?: { recursive?: boolean; force?: boolean }\n  ): Promise<void>;\n  cp(\n    src: string,\n    dest: string,\n    options?: { recursive?: boolean }\n  ): Promise<void>;\n  mv(src: string, dest: string): Promise<void>;\n  readlink(path: string): Promise<string>;\n  resolvePath(base: string, path: string): string;\n}\n\n// ============================================================================\n// Execution\n// ============================================================================\n\nexport interface ExecOptions {\n  timeout?: number;\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ExecResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n// ============================================================================\n// Capabilities\n// ============================================================================\n\nexport interface SandboxCapabilities {\n  /** Sandbox supports filesystem operations */\n  filesystem: boolean;\n  /** Sandbox supports shell/command execution */\n  execution: boolean;\n  /** Sandbox state can be persisted and restored */\n  persistence: boolean;\n}\n\n// ============================================================================\n// Sandbox\n// ============================================================================\n\nexport interface Sandbox {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n  readonly fs: SandboxFileSystem;\n\n  exec(command: string, options?: ExecOptions): Promise<ExecResult>;\n  destroy(): Promise<void>;\n}\n\n// ============================================================================\n// Snapshots\n// ============================================================================\n\nexport interface SandboxSnapshot {\n  sandboxId: string;\n  providerId: string;\n  /** Provider-specific serialised state */\n  data: unknown;\n  createdAt: string;\n}\n\n// ============================================================================\n// Provider\n// ============================================================================\n\nexport interface SandboxCreateOptions {\n  /** Preferred sandbox ID (provider may ignore) */\n  id?: string;\n  /** Seed the filesystem with these files */\n  initialFiles?: Record<string, string | Uint8Array>;\n  /** Environment variables available inside the sandbox */\n  env?: Record<string, string>;\n}\n\nexport interface SandboxCreateResult {\n  sandbox: Sandbox;\n  /** Optional state to merge into the workflow's `AgentState` via the session. */\n  stateUpdate?: Record<string, unknown>;\n}\n\nexport interface SandboxProvider<\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n  TSandbox extends Sandbox = Sandbox,\n> {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n\n  create(options?: TOptions): Promise<SandboxCreateResult>;\n  get(sandboxId: string): Promise<TSandbox>;\n  destroy(sandboxId: string): Promise<void>;\n  pause(sandboxId: string, ttlSeconds?: number): Promise<void>;\n  snapshot(sandboxId: string): Promise<SandboxSnapshot>;\n  restore(snapshot: SandboxSnapshot): Promise<Sandbox>;\n  fork(sandboxId: string): Promise<Sandbox>;\n}\n\n// ============================================================================\n// SandboxOps — workflow-side activity interface (like ThreadOps)\n// ============================================================================\n\nexport interface SandboxOps<\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n> {\n  createSandbox(\n    options?: TOptions\n  ): Promise<{ sandboxId: string; stateUpdate?: Record<string, unknown> }>;\n  destroySandbox(sandboxId: string): Promise<void>;\n  pauseSandbox(sandboxId: string): Promise<void>;\n  snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;\n  forkSandbox(sandboxId: string): Promise<string>;\n}\n\n/**\n * Maps generic {@link SandboxOps} method names to adapter-prefixed names.\n *\n * @example\n * ```typescript\n * type InMemOps = PrefixedSandboxOps<\"inMemory\">;\n * // → { inMemoryCreateSandbox, inMemoryDestroySandbox, inMemorySnapshotSandbox }\n * ```\n */\nexport type PrefixedSandboxOps<\n  TPrefix extends string,\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n> = {\n  [K in keyof SandboxOps<TOptions> as `${TPrefix}${Capitalize<K & string>}`]: SandboxOps<TOptions>[K];\n};\n\n// ============================================================================\n// Errors\n// ============================================================================\n\nimport { ApplicationFailure } from \"@temporalio/common\";\n\nexport class SandboxNotSupportedError extends ApplicationFailure {\n  constructor(operation: string) {\n    super(\n      `Sandbox does not support: ${operation}`,\n      \"SandboxNotSupportedError\",\n      true\n    );\n  }\n}\n\nexport class SandboxNotFoundError extends ApplicationFailure {\n  constructor(sandboxId: string) {\n    super(`Sandbox not found: ${sandboxId}`, \"SandboxNotFoundError\", true);\n  }\n}\n","import type {\n  SandboxFileSystem,\n  DirentEntry,\n  FileStat,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotSupportedError } from \"../../../lib/sandbox/types\";\nimport { posix } from \"node:path\";\nimport type {\n  FileEntry,\n  FileEntryMetadata,\n  FileResolver,\n  TreeMutation,\n} from \"./types\";\n\n/** Normalize a path against the provided workspace base. */\nfunction normalisePath(p: string, workspaceBase = \"/\"): string {\n  return posix.resolve(workspaceBase, p);\n}\n\n/** Return the parent directory of a normalised path (\"/a/b\" → \"/a\"). */\nfunction parentDir(p: string): string {\n  const idx = p.lastIndexOf(\"/\");\n  return idx <= 0 ? \"/\" : p.slice(0, idx);\n}\n\n/**\n * Collect the set of implicit directory paths from a flat file list.\n * E.g. \"/a/b/c.ts\" contributes \"/a/b\", \"/a\", \"/\".\n */\nfunction inferDirectories(\n  entries: { path: string }[],\n  workspaceBase: string\n): Set<string> {\n  const dirs = new Set<string>();\n  dirs.add(\"/\");\n  for (const entry of entries) {\n    let dir = parentDir(normalisePath(entry.path, workspaceBase));\n    while (dir !== \"/\" && !dirs.has(dir)) {\n      dirs.add(dir);\n      dir = parentDir(dir);\n    }\n    dirs.add(\"/\");\n  }\n  return dirs;\n}\n\n/**\n * Ephemeral {@link SandboxFileSystem} backed by a {@link FileResolver}.\n *\n * Created fresh for each tool invocation from the current workflow file tree.\n * Directory structure is inferred from file paths. All mutations are tracked\n * and can be retrieved via {@link getMutations} after the handler completes.\n */\nexport class VirtualSandboxFileSystem<\n  TCtx = unknown,\n  TMeta = FileEntryMetadata,\n> implements SandboxFileSystem {\n  readonly workspaceBase: string;\n  private entries: Map<string, FileEntry<TMeta>>;\n  private directories: Set<string>;\n  private mutations: TreeMutation<TMeta>[] = [];\n\n  constructor(\n    tree: FileEntry<TMeta>[],\n    private resolver: FileResolver<TCtx, TMeta>,\n    private ctx: TCtx,\n    workspaceBase = \"/\",\n  ) {\n    this.workspaceBase = normalisePath(workspaceBase);\n    this.entries = new Map(\n      tree.map((e) => [normalisePath(e.path, this.workspaceBase), e])\n    );\n    this.directories = inferDirectories(tree, this.workspaceBase);\n  }\n\n  /** Return all mutations accumulated during this invocation. */\n  getMutations(): TreeMutation<TMeta>[] {\n    return this.mutations;\n  }\n\n  /** Look up a file entry by virtual path. */\n  getEntry(path: string): FileEntry<TMeta> | undefined {\n    return this.entries.get(normalisePath(path, this.workspaceBase));\n  }\n\n  // --------------------------------------------------------------------------\n  // Read operations — delegate to resolver lazily\n  // --------------------------------------------------------------------------\n\n  async readFile(path: string): Promise<string> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFile(entry.id, this.ctx, entry.metadata);\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFileBuffer(entry.id, this.ctx, entry.metadata);\n  }\n\n  // --------------------------------------------------------------------------\n  // Metadata operations — pure, resolved from the tree\n  // --------------------------------------------------------------------------\n\n  async exists(path: string): Promise<boolean> {\n    const norm = normalisePath(path, this.workspaceBase);\n    return this.entries.has(norm) || this.directories.has(norm);\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n    if (entry) {\n      return {\n        isFile: true,\n        isDirectory: false,\n        isSymbolicLink: false,\n        size: entry.size,\n        mtime: new Date(entry.mtime),\n      };\n    }\n    if (this.directories.has(norm)) {\n      return {\n        isFile: false,\n        isDirectory: true,\n        isSymbolicLink: false,\n        size: 0,\n        mtime: new Date(),\n      };\n    }\n    throw new Error(`ENOENT: no such file or directory: ${path}`);\n  }\n\n  async readdir(path: string): Promise<string[]> {\n    const norm = normalisePath(path, this.workspaceBase);\n    if (!this.directories.has(norm)) {\n      throw new Error(`ENOENT: no such directory: ${path}`);\n    }\n    const prefix = norm === \"/\" ? \"/\" : norm + \"/\";\n    const names = new Set<string>();\n\n    for (const p of this.entries.keys()) {\n      if (p.startsWith(prefix)) {\n        const rest = p.slice(prefix.length);\n        const seg = rest.split(\"/\")[0];\n        if (seg) names.add(seg);\n      }\n    }\n    for (const d of this.directories) {\n      if (d.startsWith(prefix) && d !== norm) {\n        const rest = d.slice(prefix.length);\n        const seg = rest.split(\"/\")[0];\n        if (seg) names.add(seg);\n      }\n    }\n    return [...names].sort();\n  }\n\n  async readdirWithFileTypes(path: string): Promise<DirentEntry[]> {\n    const names = await this.readdir(path);\n    const norm = normalisePath(path, this.workspaceBase);\n    const prefix = norm === \"/\" ? \"/\" : norm + \"/\";\n\n    return names.map((name) => {\n      const full = prefix + name;\n      const isFile = this.entries.has(full);\n      const isDirectory = this.directories.has(full);\n      return { name, isFile, isDirectory, isSymbolicLink: false };\n    });\n  }\n\n  // --------------------------------------------------------------------------\n  // Write operations — delegate to resolver, record mutations\n  // --------------------------------------------------------------------------\n\n  async writeFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const existing = this.entries.get(norm);\n\n    if (existing) {\n      await this.resolver.writeFile(\n        existing.id,\n        content,\n        this.ctx,\n        existing.metadata\n      );\n      const size =\n        typeof content === \"string\"\n          ? new TextEncoder().encode(content).byteLength\n          : content.byteLength;\n      const updated: FileEntry<TMeta> = {\n        ...existing,\n        size,\n        mtime: new Date().toISOString(),\n      };\n      this.entries.set(norm, updated);\n      this.mutations.push({ type: \"update\", path: norm, entry: updated });\n    } else {\n      const entry = await this.resolver.createFile(norm, content, this.ctx);\n      const normalised = { ...entry, path: norm };\n      this.entries.set(norm, normalised);\n      this.addParentDirectories(norm);\n      this.mutations.push({ type: \"add\", entry: normalised });\n    }\n  }\n\n  async appendFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const existing = this.entries.get(norm);\n\n    if (!existing) {\n      return this.writeFile(path, content);\n    }\n\n    const current = await this.resolver.readFile(\n      existing.id,\n      this.ctx,\n      existing.metadata\n    );\n    const appended =\n      typeof content === \"string\"\n        ? current + content\n        : current + new TextDecoder().decode(content);\n    await this.resolver.writeFile(\n      existing.id,\n      appended,\n      this.ctx,\n      existing.metadata\n    );\n\n    const size = new TextEncoder().encode(appended).byteLength;\n    const updated: FileEntry<TMeta> = {\n      ...existing,\n      size,\n      mtime: new Date().toISOString(),\n    };\n    this.entries.set(norm, updated);\n    this.mutations.push({ type: \"update\", path: norm, entry: updated });\n  }\n\n  async mkdir(\n    _path: string,\n    _options?: { recursive?: boolean }\n  ): Promise<void> {\n    const norm = normalisePath(_path, this.workspaceBase);\n    if (this.directories.has(norm)) return;\n\n    if (_options?.recursive) {\n      this.addParentDirectories(norm + \"/placeholder\");\n      this.directories.add(norm);\n    } else {\n      const parent = parentDir(norm);\n      if (!this.directories.has(parent)) {\n        throw new Error(`ENOENT: no such directory: ${parent}`);\n      }\n      this.directories.add(norm);\n    }\n  }\n\n  async rm(\n    path: string,\n    options?: { recursive?: boolean; force?: boolean }\n  ): Promise<void> {\n    const norm = normalisePath(path, this.workspaceBase);\n    const entry = this.entries.get(norm);\n\n    if (entry) {\n      await this.resolver.deleteFile(entry.id, this.ctx, entry.metadata);\n      this.entries.delete(norm);\n      this.mutations.push({ type: \"remove\", path: norm });\n      return;\n    }\n\n    if (this.directories.has(norm)) {\n      if (!options?.recursive) {\n        throw new Error(`EISDIR: is a directory (use recursive): ${path}`);\n      }\n      const prefix = norm === \"/\" ? \"/\" : norm + \"/\";\n      for (const [p, e] of this.entries) {\n        if (p.startsWith(prefix)) {\n          await this.resolver.deleteFile(e.id, this.ctx, e.metadata);\n          this.entries.delete(p);\n          this.mutations.push({ type: \"remove\", path: p });\n        }\n      }\n      for (const d of this.directories) {\n        if (d.startsWith(prefix)) this.directories.delete(d);\n      }\n      this.directories.delete(norm);\n      return;\n    }\n\n    if (!options?.force) {\n      throw new Error(`ENOENT: no such file or directory: ${path}`);\n    }\n  }\n\n  async cp(\n    src: string,\n    dest: string,\n    _options?: { recursive?: boolean }\n  ): Promise<void> {\n    const normSrc = normalisePath(src, this.workspaceBase);\n    const normDest = normalisePath(dest, this.workspaceBase);\n\n    const entry = this.entries.get(normSrc);\n    if (entry) {\n      const content = await this.resolver.readFile(\n        entry.id,\n        this.ctx,\n        entry.metadata\n      );\n      await this.writeFile(normDest, content);\n      return;\n    }\n\n    if (!this.directories.has(normSrc)) {\n      throw new Error(`ENOENT: no such file or directory: ${src}`);\n    }\n    if (!_options?.recursive) {\n      throw new Error(`EISDIR: is a directory (use recursive): ${src}`);\n    }\n\n    const prefix = normSrc === \"/\" ? \"/\" : normSrc + \"/\";\n    for (const [p, e] of this.entries) {\n      if (p.startsWith(prefix)) {\n        const relative = p.slice(normSrc.length);\n        const content = await this.resolver.readFile(\n          e.id,\n          this.ctx,\n          e.metadata\n        );\n        await this.writeFile(normDest + relative, content);\n      }\n    }\n  }\n\n  async mv(src: string, dest: string): Promise<void> {\n    await this.cp(src, dest, { recursive: true });\n    await this.rm(src, { recursive: true });\n  }\n\n  // --------------------------------------------------------------------------\n  // Unsupported\n  // --------------------------------------------------------------------------\n\n  async readlink(_path: string): Promise<string> {\n    throw new SandboxNotSupportedError(\"readlink\");\n  }\n\n  resolvePath(base: string, path: string): string {\n    return posix.resolve(normalisePath(base, this.workspaceBase), path);\n  }\n\n  // --------------------------------------------------------------------------\n  // Helpers\n  // --------------------------------------------------------------------------\n\n  private addParentDirectories(filePath: string): void {\n    let dir = parentDir(normalisePath(filePath, this.workspaceBase));\n    while (!this.directories.has(dir)) {\n      this.directories.add(dir);\n      dir = parentDir(dir);\n    }\n  }\n}\n","import { uuid4 } from \"@temporalio/workflow\";\n\nconst BASE62 =\n  \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n\n/**\n * Generate a compact, workflow-deterministic identifier.\n *\n * Uses Temporal's `uuid4()` internally (seeded by the workflow's RNG),\n * then re-encodes the hex bytes into a base-62 alphabet for a shorter,\n * more token-efficient identifier (~3 tokens vs ~10 for a full UUID).\n *\n * Suitable for thread IDs, child workflow IDs, or any workflow-scoped identifier.\n *\n * @param length - Number of base-62 characters (default 12, ~71 bits of entropy)\n */\nexport function getShortId(length = 12): string {\n  const hex = uuid4().replace(/-/g, \"\");\n  let result = \"\";\n  for (let i = 0; i < length; i++) {\n    const byte = parseInt(hex.slice(i * 2, i * 2 + 2), 16);\n    result += BASE62[byte % BASE62.length];\n  }\n  return result;\n}\n","import type {\n  SandboxCapabilities,\n  SandboxCreateResult,\n  SandboxProvider,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotSupportedError } from \"../../../lib/sandbox/types\";\nimport { getShortId } from \"../../../lib/thread/id\";\nimport { createVirtualSandbox } from \"./index\";\nimport type {\n  FileEntryMetadata,\n  FileResolver,\n  VirtualSandboxCreateOptions,\n} from \"./types\";\n\n/**\n * Stateless {@link SandboxProvider} backed by a {@link FileResolver}.\n *\n * The provider holds **no internal state**. All sandbox state (sandboxId,\n * fileTree, resolverContext, workspaceBase) is returned as a `stateUpdate` from\n * {@link create} and merged into the workflow's `AgentState` by the session.\n * {@link withVirtualSandbox} reads this state back on every tool invocation.\n *\n * @example\n * ```typescript\n * const provider = new VirtualSandboxProvider(resolver);\n * const manager = new SandboxManager(provider);\n *\n * export const activities = {\n *   ...manager.createActivities(\"CodingAgent\"),\n *   readFile: withVirtualSandbox(client, provider, readHandler),\n * };\n * ```\n */\nexport class VirtualSandboxProvider<\n  TCtx = unknown,\n  TMeta = FileEntryMetadata,\n> implements SandboxProvider<VirtualSandboxCreateOptions<TCtx>> {\n  readonly id = \"virtual\";\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: false,\n    persistence: true,\n  };\n\n  readonly resolver: FileResolver<TCtx, TMeta>;\n\n  constructor(resolver: FileResolver<TCtx, TMeta>) {\n    this.resolver = resolver;\n  }\n\n  async create(\n    options?: VirtualSandboxCreateOptions<TCtx>\n  ): Promise<SandboxCreateResult> {\n    if (!options || !(\"resolverContext\" in options)) {\n      throw new Error(\"VirtualSandboxProvider.create requires resolverContext\");\n    }\n\n    const sandboxId = options.id ?? getShortId();\n    const fileTree = await this.resolver.resolveEntries(\n      options.resolverContext\n    );\n    const workspaceBase = options.workspaceBase ?? \"/\";\n\n    const sandbox = createVirtualSandbox(\n      sandboxId,\n      fileTree,\n      this.resolver,\n      options.resolverContext,\n      workspaceBase,\n    );\n\n    if (options.initialFiles) {\n      for (const [path, content] of Object.entries(options.initialFiles)) {\n        await sandbox.fs.writeFile(path, content);\n      }\n      for (const m of sandbox.fs.getMutations()) {\n        if (m.type === \"add\") fileTree.push(m.entry);\n      }\n    }\n\n    return {\n      sandbox,\n      stateUpdate: {\n        sandboxId,\n        fileTree,\n        resolverContext: options.resolverContext,\n        workspaceBase,\n      },\n    };\n  }\n\n  async get(): Promise<never> {\n    throw new SandboxNotSupportedError(\n      \"get (virtual sandbox state lives in workflow AgentState)\"\n    );\n  }\n\n  async destroy(): Promise<void> {\n    // No-op — no internal state to clean up\n  }\n\n  async pause(): Promise<void> {\n    // No-op — virtual sandbox state lives in workflow AgentState\n  }\n\n  async fork(_sandboxId: string): Promise<never> {\n    throw new Error(\"Not implemented\");\n  }\n\n  async snapshot(): Promise<never> {\n    throw new SandboxNotSupportedError(\n      \"snapshot (virtual sandbox state lives in workflow AgentState)\"\n    );\n  }\n\n  async restore(): Promise<never> {\n    throw new SandboxNotSupportedError(\n      \"restore (virtual sandbox state lives in workflow AgentState)\"\n    );\n  }\n}\n","import { Context } from \"@temporalio/activity\";\nimport type { WorkflowClient } from \"@temporalio/client\";\nimport type { BaseAgentState, RunAgentConfig } from \"./types\";\nimport type { JsonValue } from \"./state/types\";\nimport type {\n  ActivityToolHandler,\n  RouterContext,\n  ToolHandlerResponse,\n} from \"./tool-router/types\";\n\n/**\n * Query the parent workflow's state from within an activity.\n * Resolves the workflow handle from the current activity context.\n */\nexport async function queryParentWorkflowState<T>(\n  client: WorkflowClient\n): Promise<T> {\n  const { workflowExecution } = Context.current().info;\n  const handle = client.getHandle(\n    workflowExecution.workflowId,\n    workflowExecution.runId\n  );\n  return handle.query<T>(\"getAgentState\");\n}\n\n/**\n * Wraps a handler into a `RunAgentActivity` by auto-fetching the parent\n * workflow's agent state before each invocation.\n *\n * @example\n * ```typescript\n * import { createRunAgentActivity } from 'zeitlich';\n * import { createLangChainModelInvoker } from 'zeitlich/adapters/thread/langchain';\n *\n * const invoker = createLangChainModelInvoker({ redis, model });\n * return { runAgent: createRunAgentActivity(client, invoker) };\n * ```\n */\nexport function createRunAgentActivity<R, S extends BaseAgentState = BaseAgentState>(\n  client: WorkflowClient,\n  handler: (config: RunAgentConfig & { state: S }) => Promise<R>,\n): (config: RunAgentConfig) => Promise<R> {\n  return async (config: RunAgentConfig) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler({ ...config, state });\n  };\n}\n\n/**\n * Context injected into tool handlers created via {@link withParentWorkflowState}.\n */\nexport interface AgentStateContext<S extends BaseAgentState = BaseAgentState> extends RouterContext {\n  state: S;\n}\n\n/**\n * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the\n * parent workflow's agent state before each invocation.\n *\n * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)\n *\n * @example\n * ```typescript\n * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';\n *\n * // With custom state:\n * interface MyState extends BaseAgentState { customField: string }\n * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(\n *   client,\n *   async (args, ctx) => {\n *     console.log(ctx.state.customField);\n *     return { toolResponse: 'done', data: null };\n *   },\n * );\n * ```\n */\nexport function withParentWorkflowState<TArgs, TResult, S extends BaseAgentState = BaseAgentState, TToolResponse = JsonValue>(\n  client: WorkflowClient,\n  handler: (\n    args: TArgs,\n    context: AgentStateContext<S>,\n  ) => Promise<ToolHandlerResponse<TResult, TToolResponse>>,\n): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse> {\n  return async (args, context) => {\n    const state = await queryParentWorkflowState<S>(client);\n    return handler(args, { ...context, state });\n  };\n}\n","import type { WorkflowClient } from \"@temporalio/client\";\nimport { queryParentWorkflowState } from \"../../../lib/activity\";\nimport type { JsonValue } from \"../../../lib/state/types\";\nimport type { ActivityToolHandler, RouterContext } from \"../../../lib/tool-router/types\";\nimport type {\n  FileEntryMetadata,\n  TreeMutation,\n  VirtualSandboxContext,\n  VirtualSandboxState,\n} from \"./types\";\nimport type { VirtualSandboxProvider } from \"./provider\";\nimport { createVirtualSandbox } from \"./index\";\n\n/**\n * Wraps a tool handler that needs a virtual sandbox, automatically querying\n * the parent workflow for the current file tree and resolver context.\n *\n * On each invocation the wrapper:\n * 1. Queries the workflow's `AgentState` for `fileTree`, `resolverContext`, and `workspaceBase`\n * 2. Creates an ephemeral {@link VirtualSandbox} from tree + provider's resolver\n * 3. Runs the inner handler\n * 4. Returns the handler's result together with any {@link TreeMutation}s\n *\n * The consumer applies mutations back to workflow state via a post-tool hook.\n *\n * @param client    - Temporal `WorkflowClient` for querying the parent workflow\n * @param agentName - Agent name (used to derive the state query name)\n * @param provider  - {@link VirtualSandboxProvider} (wraps the resolver)\n * @param handler   - Inner handler expecting a {@link VirtualSandboxContext}\n *\n * @example\n * ```typescript\n * import { withVirtualSandbox, type VirtualSandboxContext } from 'zeitlich';\n *\n * const readHandler: ActivityToolHandler<FileReadArgs, ReadResult, VirtualSandboxContext> =\n *   async (args, { sandbox }) => {\n *     const content = await sandbox.fs.readFile(args.path);\n *     return { toolResponse: content, data: { path: args.path, content } };\n *   };\n *\n * // At activity registration:\n * const provider = new VirtualSandboxProvider(resolver);\n * const handler = withVirtualSandbox(client, \"myAgent\", provider, readHandler);\n * ```\n */\nexport function withVirtualSandbox<\n  TArgs,\n  TResult,\n  TCtx,\n  TMeta = FileEntryMetadata,\n  TToolResponse = JsonValue,\n>(\n  client: WorkflowClient,\n  provider: VirtualSandboxProvider<TCtx, TMeta>,\n  handler: ActivityToolHandler<\n    TArgs,\n    TResult,\n    VirtualSandboxContext<TCtx, TMeta>,\n    TToolResponse\n  >\n): ActivityToolHandler<\n  TArgs,\n  (TResult & { treeMutations: TreeMutation<TMeta>[] }) | null,\n  RouterContext,\n  TToolResponse | string\n> {\n  return async (args, context) => {\n    const state =\n      await queryParentWorkflowState<VirtualSandboxState<TCtx, TMeta>>(client);\n\n    const { sandboxId, fileTree, resolverContext, workspaceBase } = state;\n    if (!fileTree || !sandboxId) {\n      return {\n        toolResponse: `Error: No fileTree/sandboxId in agent state. The ${context.toolName} tool requires a virtual sandbox.`,\n        data: null,\n      };\n    }\n\n    const sandbox = createVirtualSandbox(\n      sandboxId,\n      fileTree,\n      provider.resolver,\n      resolverContext,\n      workspaceBase ?? \"/\",\n    );\n    const response = await handler(args, { ...context, sandbox });\n    const mutations = sandbox.fs.getMutations();\n\n    return {\n      toolResponse: response.toolResponse,\n      data: {\n        ...(response.data ?? {}),\n        treeMutations: mutations,\n      } as TResult & { treeMutations: TreeMutation<TMeta>[] },\n    };\n  };\n}\n","import type { FileEntry } from \"./types\";\n\n/**\n * Structural constraint: accepts any `AgentStateManager<T>` whose custom\n * state includes `fileTree: FileEntry<TMeta>[]`.\n */\nexport interface FileTreeAccessor<TMeta> {\n  get(key: \"fileTree\"): FileEntry<TMeta>[];\n}\n\n/**\n * Check whether any file in the tree has a `metadata.mimeType` that matches\n * the given pattern.\n *\n * Patterns:\n * - Exact: `\"application/pdf\"`\n * - Wildcard type: `\"image/*\"`\n *\n * Useful for conditionally enabling tools:\n *\n * ```ts\n * { enabled: hasFileWithMimeType(stateManager, \"image/*\") }\n * { enabled: hasFileWithMimeType(stateManager, [\"image/*\", \"application/pdf\"]) }\n * ```\n */\nexport function hasFileWithMimeType<TMeta>(\n  stateManager: FileTreeAccessor<TMeta>,\n  pattern: string | string[],\n): boolean {\n  const tree = stateManager.get(\"fileTree\");\n  const matchers = (Array.isArray(pattern) ? pattern : [pattern]).map(buildMatcher);\n  return tree.some((entry) => {\n    const meta = entry.metadata as Record<string, unknown> | undefined;\n    const mime = meta?.mimeType;\n    return typeof mime === \"string\" && matchers.some((m) => m(mime));\n  });\n}\n\n/**\n * Return all entries whose `metadata.mimeType` matches the given pattern.\n */\nexport function filesWithMimeType<TMeta>(\n  stateManager: FileTreeAccessor<TMeta>,\n  pattern: string,\n): FileEntry<TMeta>[] {\n  const tree = stateManager.get(\"fileTree\");\n  const match = buildMatcher(pattern);\n  return tree.filter((entry) => {\n    const meta = entry.metadata as Record<string, unknown> | undefined;\n    const mime = meta?.mimeType;\n    return typeof mime === \"string\" && match(mime);\n  });\n}\n\n/**\n * Check whether the tree contains a directory whose name matches the given\n * pattern. Directories are inferred from file paths.\n *\n * Patterns:\n * - Exact: `\"src\"`\n * - Glob with `*` wildcard: `\"test*\"`, `\"*.generated\"`\n *\n * ```ts\n * { enabled: hasDirectory(stateManager, \"test*\") }\n * ```\n */\nexport function hasDirectory<TMeta>(\n  stateManager: FileTreeAccessor<TMeta>,\n  pattern: string,\n): boolean {\n  const tree = stateManager.get(\"fileTree\");\n  const match = buildGlobMatcher(pattern);\n  return tree.some((entry) => {\n    const segments = entry.path.split(\"/\").filter(Boolean);\n    return segments.slice(0, -1).some(match);\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Internal matchers\n// ---------------------------------------------------------------------------\n\nfunction buildMatcher(pattern: string): (value: string) => boolean {\n  if (pattern.endsWith(\"/*\")) {\n    const prefix = pattern.slice(0, -1);\n    return (v) => v.startsWith(prefix);\n  }\n  return (v) => v === pattern;\n}\n\nfunction buildGlobMatcher(pattern: string): (value: string) => boolean {\n  if (!pattern.includes(\"*\")) return (v) => v === pattern;\n  const re = new RegExp(\n    \"^\" + pattern.replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\").replace(/\\*/g, \".*\") + \"$\",\n  );\n  return (v) => re.test(v);\n}\n","import type {\n  Sandbox,\n  SandboxCapabilities,\n  ExecOptions,\n  ExecResult,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotSupportedError } from \"../../../lib/sandbox/types\";\nimport { VirtualSandboxFileSystem } from \"./filesystem\";\nimport type {\n  FileEntry,\n  FileEntryMetadata,\n  FileResolver,\n  VirtualSandbox,\n} from \"./types\";\n\n// ============================================================================\n// VirtualSandbox\n// ============================================================================\n\nclass VirtualSandboxImpl<\n  TCtx = unknown,\n  TMeta = FileEntryMetadata,\n> implements Sandbox\n{\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: false,\n    persistence: true,\n  };\n\n  readonly fs: VirtualSandboxFileSystem<TCtx, TMeta>;\n\n  constructor(\n    readonly id: string,\n    tree: FileEntry<TMeta>[],\n    resolver: FileResolver<TCtx, TMeta>,\n    ctx: TCtx,\n    workspaceBase = \"/\",\n  ) {\n    this.fs = new VirtualSandboxFileSystem(tree, resolver, ctx, workspaceBase);\n  }\n\n  async exec(_command: string, _options?: ExecOptions): Promise<ExecResult> {\n    throw new SandboxNotSupportedError(\"exec\");\n  }\n\n  async destroy(): Promise<void> {\n    // Ephemeral — nothing to clean up\n  }\n}\n\n// ============================================================================\n// Factory\n// ============================================================================\n\n/**\n * Create an ephemeral {@link Sandbox} from a file tree and resolver.\n *\n * Used internally by {@link withVirtualSandbox} and\n * {@link VirtualSandboxProvider}; consumers can also call this directly\n * if they need a sandbox outside the wrapper pattern.\n */\nexport function createVirtualSandbox<\n  TCtx,\n  TMeta = FileEntryMetadata,\n>(\n  id: string,\n  tree: FileEntry<TMeta>[],\n  resolver: FileResolver<TCtx, TMeta>,\n  ctx: TCtx,\n  workspaceBase = \"/\",\n): VirtualSandbox<TCtx, TMeta> {\n  return new VirtualSandboxImpl(id, tree, resolver, ctx, workspaceBase);\n}\n\n// Re-exports for convenience\nexport { VirtualSandboxFileSystem } from \"./filesystem\";\nexport { VirtualSandboxProvider } from \"./provider\";\nexport { withVirtualSandbox } from \"./with-virtual-sandbox\";\nexport { hasFileWithMimeType, filesWithMimeType, hasDirectory } from \"./queries\";\nexport type { FileTreeAccessor } from \"./queries\";\nexport type {\n  FileEntry,\n  FileEntryMetadata,\n  FileResolver,\n  VirtualFileTree,\n  VirtualSandboxCreateOptions,\n  VirtualSandboxState,\n  VirtualSandboxContext,\n  VirtualSandbox,\n  TreeMutation,\n} from \"./types\";\n"]}

package/dist/adapters/sandbox/virtual/index.d.cts

@@ -1,12 +1,13 @@
-import { a as FileEntryMetadata, V as VirtualSandboxCreateOptions, b as FileResolver, c as VirtualSandboxContext, T as TreeMutation, F as FileEntry, d as VirtualSandbox } from '../../../types-Bf8KV0Ci.cjs';
-export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-Bf8KV0Ci.cjs';
+import { a as FileEntryMetadata, V as VirtualSandboxCreateOptions, b as FileResolver, c as VirtualSandboxContext, T as TreeMutation, F as FileEntry, d as VirtualSandbox } from '../../../types-DRnz-OZp.cjs';
+export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-DRnz-OZp.cjs';
 import { b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult } from '../../../types-ChAMwU3q.cjs';
 import { WorkflowClient } from '@temporalio/client';
-import { A as ActivityToolHandler } from '../../../types-D_igp10o.cjs';
-export { F as FileTreeAccessor, f as filesWithMimeType, h as hasDirectory, a as hasFileWithMimeType } from '../../../queries-BYGBImeC.cjs';
+import { J as JsonValue, A as ActivityToolHandler, R as RouterContext } from '../../../types-mCVxKIZb.cjs';
+export { F as FileTreeAccessor, f as filesWithMimeType, h as hasDirectory, a as hasFileWithMimeType } from '../../../queries-DwnE2bu3.cjs';
 import '@temporalio/common';
-import 'zod';
 import '@temporalio/workflow';
+import '@temporalio/common/lib/interfaces';
+import 'zod';
 
 /**
  * Stateless {@link SandboxProvider} backed by a {@link FileResolver}.
@@ -73,9 +74,9 @@ declare class VirtualSandboxProvider<TCtx = unknown, TMeta = FileEntryMetadata>
  * const handler = withVirtualSandbox(client, "myAgent", provider, readHandler);
  * ```
  */
-declare function withVirtualSandbox<TArgs, TResult, TCtx, TMeta = FileEntryMetadata>(client: WorkflowClient, provider: VirtualSandboxProvider<TCtx, TMeta>, handler: ActivityToolHandler<TArgs, TResult, VirtualSandboxContext<TCtx, TMeta>>): ActivityToolHandler<TArgs, (TResult & {
+declare function withVirtualSandbox<TArgs, TResult, TCtx, TMeta = FileEntryMetadata, TToolResponse = JsonValue>(client: WorkflowClient, provider: VirtualSandboxProvider<TCtx, TMeta>, handler: ActivityToolHandler<TArgs, TResult, VirtualSandboxContext<TCtx, TMeta>, TToolResponse>): ActivityToolHandler<TArgs, (TResult & {
     treeMutations: TreeMutation<TMeta>[];
-}) | null>;
+}) | null, RouterContext, TToolResponse | string>;
 
 /**
  * Create an ephemeral {@link Sandbox} from a file tree and resolver.

package/dist/adapters/sandbox/virtual/index.d.ts

@@ -1,12 +1,13 @@
-import { a as FileEntryMetadata, V as VirtualSandboxCreateOptions, b as FileResolver, c as VirtualSandboxContext, T as TreeMutation, F as FileEntry, d as VirtualSandbox } from '../../../types-LVKmCNds.js';
-export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-LVKmCNds.js';
+import { a as FileEntryMetadata, V as VirtualSandboxCreateOptions, b as FileResolver, c as VirtualSandboxContext, T as TreeMutation, F as FileEntry, d as VirtualSandbox } from '../../../types-DFUNSYbj.js';
+export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-DFUNSYbj.js';
 import { b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult } from '../../../types-ChAMwU3q.js';
 import { WorkflowClient } from '@temporalio/client';
-import { A as ActivityToolHandler } from '../../../types-D_igp10o.js';
-export { F as FileTreeAccessor, f as filesWithMimeType, h as hasDirectory, a as hasFileWithMimeType } from '../../../queries-DwBe2CAA.js';
+import { J as JsonValue, A as ActivityToolHandler, R as RouterContext } from '../../../types-mCVxKIZb.js';
+export { F as FileTreeAccessor, f as filesWithMimeType, h as hasDirectory, a as hasFileWithMimeType } from '../../../queries-BCgJ9Sr5.js';
 import '@temporalio/common';
-import 'zod';
 import '@temporalio/workflow';
+import '@temporalio/common/lib/interfaces';
+import 'zod';
 
 /**
  * Stateless {@link SandboxProvider} backed by a {@link FileResolver}.
@@ -73,9 +74,9 @@ declare class VirtualSandboxProvider<TCtx = unknown, TMeta = FileEntryMetadata>
  * const handler = withVirtualSandbox(client, "myAgent", provider, readHandler);
  * ```
  */
-declare function withVirtualSandbox<TArgs, TResult, TCtx, TMeta = FileEntryMetadata>(client: WorkflowClient, provider: VirtualSandboxProvider<TCtx, TMeta>, handler: ActivityToolHandler<TArgs, TResult, VirtualSandboxContext<TCtx, TMeta>>): ActivityToolHandler<TArgs, (TResult & {
+declare function withVirtualSandbox<TArgs, TResult, TCtx, TMeta = FileEntryMetadata, TToolResponse = JsonValue>(client: WorkflowClient, provider: VirtualSandboxProvider<TCtx, TMeta>, handler: ActivityToolHandler<TArgs, TResult, VirtualSandboxContext<TCtx, TMeta>, TToolResponse>): ActivityToolHandler<TArgs, (TResult & {
     treeMutations: TreeMutation<TMeta>[];
-}) | null>;
+}) | null, RouterContext, TToolResponse | string>;
 
 /**
  * Create an ephemeral {@link Sandbox} from a file tree and resolver.