zeitlich 0.2.16 → 0.2.17

package/README.md

@@ -97,7 +97,8 @@ import {
   askUserQuestionTool,
   bashTool,
   defineTool,
-  type SubagentWorkflow,
+  defineSubagentWorkflow,
+  defineSubagent,
   type ModelInvoker,
 } from "zeitlich/workflow";
 
@@ -371,58 +372,68 @@ const session = await createSession({
 
 ### Subagents
 
-Spawn child agents as Temporal child workflows. Each subagent is a workflow typed with `SubagentWorkflow` that returns `{ toolResponse, data }`:
+Spawn child agents as Temporal child workflows. Use `defineSubagentWorkflow` to define the workflow with its metadata once, then `defineSubagent` to register it in the parent:
 
 ```typescript
-import { proxyActivities, workflowInfo } from "@temporalio/workflow";
+// researcher.workflow.ts
+import { proxyActivities } from "@temporalio/workflow";
 import {
   createAgentStateManager,
   createSession,
-  type SubagentWorkflow,
+  defineSubagentWorkflow,
 } from "zeitlich/workflow";
-import { agentConfig } from "./config";
 import type { createResearcherActivities } from "./activities";
 
 const { runResearcherActivity } = proxyActivities<
   ReturnType<typeof createResearcherActivities>
 >({ startToCloseTimeout: "30m", heartbeatTimeout: "5m" });
 
-// Subagent workflow typed as SubagentWorkflow
-export const researcherSubagentWorkflow: SubagentWorkflow = async ({
-  prompt,
-}) => {
-  const { runId } = workflowInfo();
+// Define the workflow — name, description (and optional resultSchema) live here
+export const researcherWorkflow = defineSubagentWorkflow(
+  {
+    name: "Researcher",
+    description: "Researches topics and gathers information",
+  },
+  async (prompt, sessionInput) => {
+    const stateManager = createAgentStateManager({
+      initialState: { systemPrompt: "You are a researcher." },
+    });
+
+    const session = await createSession({
+      ...sessionInput, // spreads agentName, threadId, continueThread, sandboxId
+      runAgent: runResearcherActivity,
+      buildContextMessage: () => [{ type: "text", text: prompt }],
+    });
+
+    const { finalMessage, threadId } = await session.runSession({ stateManager });
+    return {
+      toolResponse: finalMessage ? extractText(finalMessage) : "No response",
+      data: null,
+      threadId,
+    };
+  },
+);
+```
 
-  const stateManager = createAgentStateManager({
-    initialState: { systemPrompt: agentConfig.systemPrompt },
-    agentName: agentConfig.agentName,
-  });
+In the parent workflow, register it with `defineSubagent` and pass it to `createSession`:
 
-  const session = await createSession({
-    ...agentConfig,
-    threadId: runId,
-    runAgent: runResearcherActivity,
-    buildContextMessage: () => [{ type: "text", text: prompt }],
-  });
+```typescript
+// parent.workflow.ts
+import { defineSubagent } from "zeitlich/workflow";
+import { researcherWorkflow } from "./researcher.workflow";
 
-  const { finalMessage } = await session.runSession({ stateManager });
-  return {
-    toolResponse: finalMessage ? extractText(finalMessage) : "No response",
-    data: null,
-  };
-};
+// Metadata (name, description) comes from the workflow definition
+export const researcherSubagent = defineSubagent(researcherWorkflow);
 
-// Register the subagent for the parent workflow
-export const researcherSubagent = {
-  agentName: agentConfig.agentName,
-  description: agentConfig.description,
-  workflow: researcherSubagentWorkflow,
-};
-```
-
-In the parent workflow, pass subagents to `createSession`:
+// Optionally override parent-specific config
+export const researcherSubagent = defineSubagent(researcherWorkflow, {
+  allowThreadContinuation: true,
+  sandbox: "own",
+  hooks: {
+    onPostExecution: ({ result }) => console.log("researcher done", result),
+  },
+});
 
-```typescript
 const session = await createSession({
   // ... other config
   subagents: [researcherSubagent, codeReviewerSubagent],
@@ -461,34 +472,32 @@ When `continueThread` is true the session **forks** the provided thread — it c
 Subagents can opt in to thread continuation via `allowThreadContinuation`. When enabled, the parent agent can pass a `threadId` to resume a previous subagent conversation:
 
 ```typescript
-import { type SubagentWorkflow } from "zeitlich/workflow";
-
-// Subagent workflow that supports continuation
-export const researcherWorkflow: SubagentWorkflow = async ({
-  prompt,
-  previousThreadId,
-}) => {
-  const session = await createSession({
-    threadId: previousThreadId, // undefined → fresh thread, set → fork
-    continueThread: !!previousThreadId,
-    // ... other config
-  });
+import { defineSubagentWorkflow, defineSubagent } from "zeitlich/workflow";
 
-  const { threadId, finalMessage } = await session.runSession({ stateManager });
-  return {
-    toolResponse: finalMessage ? extractText(finalMessage) : "No response",
-    data: null,
-    threadId,
-  };
-};
+export const researcherWorkflow = defineSubagentWorkflow(
+  {
+    name: "Researcher",
+    description: "Researches topics and gathers information",
+  },
+  async (prompt, sessionInput) => {
+    const session = await createSession({
+      ...sessionInput, // threadId/continueThread are provided by parent when resuming
+      // ... other config
+    });
+
+    const { threadId, finalMessage } = await session.runSession({ stateManager });
+    return {
+      toolResponse: finalMessage ? extractText(finalMessage) : "No response",
+      data: null,
+      threadId,
+    };
+  },
+);
 
-// Register with allowThreadContinuation
-export const researcherSubagent = {
-  agentName: "Researcher",
-  description: "Researches topics and gathers information",
-  workflow: researcherWorkflow,
+// Enable thread continuation in the parent registration
+export const researcherSubagent = defineSubagent(researcherWorkflow, {
   allowThreadContinuation: true,
-};
+});
 ```
 
 The subagent returns its `threadId` in the response, which the handler surfaces to the parent LLM as `[Thread ID: ...]`. The parent can then pass that ID back in a subsequent `Subagent` tool call to continue the conversation.
@@ -662,11 +671,12 @@ Safe for use in Temporal workflow files:
 | `createAgentStateManager`   | Creates a state manager for workflow state with query/update handlers                                  |
 | `createToolRouter`          | Creates a tool router (used internally by session, or for advanced use)                                |
 | `defineTool`                | Identity function for type-safe tool definition with handler and hooks                                 |
-| `defineSubagent`            | Identity function for type-safe subagent configuration                                                 |
+| `defineSubagentWorkflow`    | Defines a subagent workflow with embedded name, description, and optional resultSchema                 |
+| `defineSubagent`            | Creates a `SubagentConfig` from a `SubagentDefinition` with optional parent-specific overrides         |
 | `getShortId`                | Generate a compact, workflow-deterministic identifier (base-62, 12 chars)                              |
 | Tool definitions            | `askUserQuestionTool`, `globTool`, `grepTool`, `readFileTool`, `writeFileTool`, `editTool`, `bashTool` |
 | Task tools                  | `taskCreateTool`, `taskGetTool`, `taskListTool`, `taskUpdateTool` for workflow task management         |
-| Types                       | `SubagentWorkflow`, `ToolDefinition`, `ToolWithHandler`, `RouterContext`, `SessionConfig`, etc.        |
+| Types                       | `SubagentDefinition`, `SubagentConfig`, `ToolDefinition`, `ToolWithHandler`, `RouterContext`, `SessionConfig`, etc. |
 
 ### Activity Entry Point (`zeitlich`)
 
@@ -706,7 +716,8 @@ LangChain-specific implementations:
 | `RouterContext`          | Base context every tool handler receives (`threadId`, `toolCallId`, `toolName`, `sandboxId?`) |
 | `Hooks`                 | Combined session lifecycle + tool execution hooks                            |
 | `ToolRouterHooks`       | Narrowed hook interface for tool execution only (pre/post/failure)            |
-| `SubagentConfig`        | Configuration for subagent workflows                                         |
+| `SubagentDefinition`    | Callable subagent workflow with embedded metadata (from `defineSubagentWorkflow`) |
+| `SubagentConfig`        | Resolved subagent configuration consumed by `createSession`                  |
 | `AgentState`            | Generic agent state type                                                     |
 
 ## Architecture

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

@@ -375,6 +375,48 @@ function withVirtualSandbox(client, provider, handler) {
   };
 }
 
+// src/adapters/sandbox/virtual/queries.ts
+function hasFileWithMimeType(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const matchers = (Array.isArray(pattern) ? pattern : [pattern]).map(buildMatcher);
+  return tree.some((entry) => {
+    const meta = entry.metadata;
+    const mime = meta?.mimeType;
+    return typeof mime === "string" && matchers.some((m) => m(mime));
+  });
+}
+function filesWithMimeType(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const match = buildMatcher(pattern);
+  return tree.filter((entry) => {
+    const meta = entry.metadata;
+    const mime = meta?.mimeType;
+    return typeof mime === "string" && match(mime);
+  });
+}
+function hasDirectory(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const match = buildGlobMatcher(pattern);
+  return tree.some((entry) => {
+    const segments = entry.path.split("/").filter(Boolean);
+    return segments.slice(0, -1).some(match);
+  });
+}
+function buildMatcher(pattern) {
+  if (pattern.endsWith("/*")) {
+    const prefix = pattern.slice(0, -1);
+    return (v) => v.startsWith(prefix);
+  }
+  return (v) => v === pattern;
+}
+function buildGlobMatcher(pattern) {
+  if (!pattern.includes("*")) return (v) => v === pattern;
+  const re = new RegExp(
+    "^" + pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$"
+  );
+  return (v) => re.test(v);
+}
+
 // src/adapters/sandbox/virtual/index.ts
 var VirtualSandboxImpl = class {
   constructor(id, tree, resolver, ctx, workspaceBase = "/") {
@@ -400,6 +442,9 @@ function createVirtualSandbox(id, tree, resolver, ctx, workspaceBase = "/") {
 exports.VirtualSandboxFileSystem = VirtualSandboxFileSystem;
 exports.VirtualSandboxProvider = VirtualSandboxProvider;
 exports.createVirtualSandbox = createVirtualSandbox;
+exports.filesWithMimeType = filesWithMimeType;
+exports.hasDirectory = hasDirectory;
+exports.hasFileWithMimeType = hasFileWithMimeType;
 exports.withVirtualSandbox = withVirtualSandbox;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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/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(path: string, options?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  cp(src: string, dest: string, options?: { recursive?: boolean }): 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  snapshot(sandboxId: string): Promise<SandboxSnapshot>;\n  restore(snapshot: SandboxSnapshot): 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  snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;\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{\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 entry = this.entries.get(normalisePath(path, this.workspaceBase));\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFile(entry.id, this.ctx);\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    const entry = this.entries.get(normalisePath(path, this.workspaceBase));\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFileBuffer(entry.id, this.ctx);\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(existing.id, content, this.ctx);\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(existing.id, this.ctx);\n    const appended =\n      typeof content === \"string\"\n        ? current + content\n        : current + new TextDecoder().decode(content);\n    await this.resolver.writeFile(existing.id, appended, this.ctx);\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(_path: string, _options?: { recursive?: boolean }): 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);\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);\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(entry.id, this.ctx);\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(e.id, this.ctx);\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(),\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    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 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 {\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 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(path: string, options?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  cp(src: string, dest: string, options?: { recursive?: boolean }): 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  snapshot(sandboxId: string): Promise<SandboxSnapshot>;\n  restore(snapshot: SandboxSnapshot): 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  snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;\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{\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 entry = this.entries.get(normalisePath(path, this.workspaceBase));\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFile(entry.id, this.ctx);\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    const entry = this.entries.get(normalisePath(path, this.workspaceBase));\n    if (!entry) throw new Error(`ENOENT: no such file: ${path}`);\n    return this.resolver.readFileBuffer(entry.id, this.ctx);\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(existing.id, content, this.ctx);\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(existing.id, this.ctx);\n    const appended =\n      typeof content === \"string\"\n        ? current + content\n        : current + new TextDecoder().decode(content);\n    await this.resolver.writeFile(existing.id, appended, this.ctx);\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(_path: string, _options?: { recursive?: boolean }): 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);\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);\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(entry.id, this.ctx);\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(e.id, this.ctx);\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(),\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    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 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"]}

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

@@ -1,5 +1,5 @@
-import { F as FileEntryMetadata, V as VirtualSandboxCreateOptions, a as FileResolver, b as VirtualSandboxContext, T as TreeMutation, c as FileEntry, d as VirtualSandbox } from '../../../types-DCi2qXjN.cjs';
-export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-DCi2qXjN.cjs';
+import { F as FileEntryMetadata, V as VirtualSandboxCreateOptions, a as FileResolver, b as VirtualSandboxContext, T as TreeMutation, c as FileEntry, d as VirtualSandbox } from '../../../queries-DlJ3jE48.cjs';
+export { e as FileTreeAccessor, f as VirtualFileTree, g as VirtualSandboxFileSystem, h as VirtualSandboxState, i as filesWithMimeType, j as hasDirectory, k as hasFileWithMimeType } from '../../../queries-DlJ3jE48.cjs';
 import { b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult } from '../../../types-BMRzfELQ.cjs';
 import { WorkflowClient } from '@temporalio/client';
 import { A as ActivityToolHandler } from '../../../types-BMXzv7TN.cjs';

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

@@ -1,5 +1,5 @@
-import { F as FileEntryMetadata, V as VirtualSandboxCreateOptions, a as FileResolver, b as VirtualSandboxContext, T as TreeMutation, c as FileEntry, d as VirtualSandbox } from '../../../types-BSOte_8s.js';
-export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-BSOte_8s.js';
+import { F as FileEntryMetadata, V as VirtualSandboxCreateOptions, a as FileResolver, b as VirtualSandboxContext, T as TreeMutation, c as FileEntry, d as VirtualSandbox } from '../../../queries-BlC1I3DK.js';
+export { e as FileTreeAccessor, f as VirtualFileTree, g as VirtualSandboxFileSystem, h as VirtualSandboxState, i as filesWithMimeType, j as hasDirectory, k as hasFileWithMimeType } from '../../../queries-BlC1I3DK.js';
 import { b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult } from '../../../types-BMRzfELQ.js';
 import { WorkflowClient } from '@temporalio/client';
 import { A as ActivityToolHandler } from '../../../types-BMXzv7TN.js';

package/dist/adapters/sandbox/virtual/index.js

@@ -373,6 +373,48 @@ function withVirtualSandbox(client, provider, handler) {
   };
 }
 
+// src/adapters/sandbox/virtual/queries.ts
+function hasFileWithMimeType(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const matchers = (Array.isArray(pattern) ? pattern : [pattern]).map(buildMatcher);
+  return tree.some((entry) => {
+    const meta = entry.metadata;
+    const mime = meta?.mimeType;
+    return typeof mime === "string" && matchers.some((m) => m(mime));
+  });
+}
+function filesWithMimeType(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const match = buildMatcher(pattern);
+  return tree.filter((entry) => {
+    const meta = entry.metadata;
+    const mime = meta?.mimeType;
+    return typeof mime === "string" && match(mime);
+  });
+}
+function hasDirectory(stateManager, pattern) {
+  const tree = stateManager.get("fileTree");
+  const match = buildGlobMatcher(pattern);
+  return tree.some((entry) => {
+    const segments = entry.path.split("/").filter(Boolean);
+    return segments.slice(0, -1).some(match);
+  });
+}
+function buildMatcher(pattern) {
+  if (pattern.endsWith("/*")) {
+    const prefix = pattern.slice(0, -1);
+    return (v) => v.startsWith(prefix);
+  }
+  return (v) => v === pattern;
+}
+function buildGlobMatcher(pattern) {
+  if (!pattern.includes("*")) return (v) => v === pattern;
+  const re = new RegExp(
+    "^" + pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$"
+  );
+  return (v) => re.test(v);
+}
+
 // src/adapters/sandbox/virtual/index.ts
 var VirtualSandboxImpl = class {
   constructor(id, tree, resolver, ctx, workspaceBase = "/") {
@@ -395,6 +437,6 @@ function createVirtualSandbox(id, tree, resolver, ctx, workspaceBase = "/") {
   return new VirtualSandboxImpl(id, tree, resolver, ctx, workspaceBase);
 }
 
-export { VirtualSandboxFileSystem, VirtualSandboxProvider, createVirtualSandbox, withVirtualSandbox };
+export { VirtualSandboxFileSystem, VirtualSandboxProvider, createVirtualSandbox, filesWithMimeType, hasDirectory, hasFileWithMimeType, withVirtualSandbox };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map