zeitlich 0.2.15 → 0.2.16

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

@@ -1,6 +1,7 @@
 'use strict';
 
 var common = require('@temporalio/common');
+var path = require('path');
 var workflow = require('@temporalio/workflow');
 var activity = require('@temporalio/activity');
 
@@ -14,23 +15,18 @@ var SandboxNotSupportedError = class extends common.ApplicationFailure {
     );
   }
 };
-
-// src/adapters/sandbox/virtual/filesystem.ts
-function normalisePath(p) {
-  if (!p.startsWith("/")) p = "/" + p;
-  p = p.replace(/\/+/g, "/");
-  if (p.length > 1 && p.endsWith("/")) p = p.slice(0, -1);
-  return p;
+function normalisePath(p, workspaceBase = "/") {
+  return path.posix.resolve(workspaceBase, p);
 }
 function parentDir(p) {
   const idx = p.lastIndexOf("/");
   return idx <= 0 ? "/" : p.slice(0, idx);
 }
-function inferDirectories(entries) {
+function inferDirectories(entries, workspaceBase) {
   const dirs = /* @__PURE__ */ new Set();
   dirs.add("/");
   for (const entry of entries) {
-    let dir = parentDir(normalisePath(entry.path));
+    let dir = parentDir(normalisePath(entry.path, workspaceBase));
     while (dir !== "/" && !dirs.has(dir)) {
       dirs.add(dir);
       dir = parentDir(dir);
@@ -40,14 +36,16 @@ function inferDirectories(entries) {
   return dirs;
 }
 var VirtualSandboxFileSystem = class {
-  constructor(tree, resolver, ctx) {
+  constructor(tree, resolver, ctx, workspaceBase = "/") {
     this.resolver = resolver;
     this.ctx = ctx;
+    this.workspaceBase = normalisePath(workspaceBase);
     this.entries = new Map(
-      tree.map((e) => [normalisePath(e.path), e])
+      tree.map((e) => [normalisePath(e.path, this.workspaceBase), e])
     );
-    this.directories = inferDirectories(tree);
+    this.directories = inferDirectories(tree, this.workspaceBase);
   }
+  workspaceBase;
   entries;
   directories;
   mutations = [];
@@ -57,18 +55,18 @@ var VirtualSandboxFileSystem = class {
   }
   /** Look up a file entry by virtual path. */
   getEntry(path) {
-    return this.entries.get(normalisePath(path));
+    return this.entries.get(normalisePath(path, this.workspaceBase));
   }
   // --------------------------------------------------------------------------
   // Read operations — delegate to resolver lazily
   // --------------------------------------------------------------------------
   async readFile(path) {
-    const entry = this.entries.get(normalisePath(path));
+    const entry = this.entries.get(normalisePath(path, this.workspaceBase));
     if (!entry) throw new Error(`ENOENT: no such file: ${path}`);
     return this.resolver.readFile(entry.id, this.ctx);
   }
   async readFileBuffer(path) {
-    const entry = this.entries.get(normalisePath(path));
+    const entry = this.entries.get(normalisePath(path, this.workspaceBase));
     if (!entry) throw new Error(`ENOENT: no such file: ${path}`);
     return this.resolver.readFileBuffer(entry.id, this.ctx);
   }
@@ -76,11 +74,11 @@ var VirtualSandboxFileSystem = class {
   // Metadata operations — pure, resolved from the tree
   // --------------------------------------------------------------------------
   async exists(path) {
-    const norm = normalisePath(path);
+    const norm = normalisePath(path, this.workspaceBase);
     return this.entries.has(norm) || this.directories.has(norm);
   }
   async stat(path) {
-    const norm = normalisePath(path);
+    const norm = normalisePath(path, this.workspaceBase);
     const entry = this.entries.get(norm);
     if (entry) {
       return {
@@ -103,7 +101,7 @@ var VirtualSandboxFileSystem = class {
     throw new Error(`ENOENT: no such file or directory: ${path}`);
   }
   async readdir(path) {
-    const norm = normalisePath(path);
+    const norm = normalisePath(path, this.workspaceBase);
     if (!this.directories.has(norm)) {
       throw new Error(`ENOENT: no such directory: ${path}`);
     }
@@ -127,7 +125,7 @@ var VirtualSandboxFileSystem = class {
   }
   async readdirWithFileTypes(path) {
     const names = await this.readdir(path);
-    const norm = normalisePath(path);
+    const norm = normalisePath(path, this.workspaceBase);
     const prefix = norm === "/" ? "/" : norm + "/";
     return names.map((name) => {
       const full = prefix + name;
@@ -140,7 +138,7 @@ var VirtualSandboxFileSystem = class {
   // Write operations — delegate to resolver, record mutations
   // --------------------------------------------------------------------------
   async writeFile(path, content) {
-    const norm = normalisePath(path);
+    const norm = normalisePath(path, this.workspaceBase);
     const existing = this.entries.get(norm);
     if (existing) {
       await this.resolver.writeFile(existing.id, content, this.ctx);
@@ -161,7 +159,7 @@ var VirtualSandboxFileSystem = class {
     }
   }
   async appendFile(path, content) {
-    const norm = normalisePath(path);
+    const norm = normalisePath(path, this.workspaceBase);
     const existing = this.entries.get(norm);
     if (!existing) {
       return this.writeFile(path, content);
@@ -179,7 +177,7 @@ var VirtualSandboxFileSystem = class {
     this.mutations.push({ type: "update", path: norm, entry: updated });
   }
   async mkdir(_path, _options) {
-    const norm = normalisePath(_path);
+    const norm = normalisePath(_path, this.workspaceBase);
     if (this.directories.has(norm)) return;
     if (_options?.recursive) {
       this.addParentDirectories(norm + "/placeholder");
@@ -193,7 +191,7 @@ var VirtualSandboxFileSystem = class {
     }
   }
   async rm(path, options) {
-    const norm = normalisePath(path);
+    const norm = normalisePath(path, this.workspaceBase);
     const entry = this.entries.get(norm);
     if (entry) {
       await this.resolver.deleteFile(entry.id, this.ctx);
@@ -224,8 +222,8 @@ var VirtualSandboxFileSystem = class {
     }
   }
   async cp(src, dest, _options) {
-    const normSrc = normalisePath(src);
-    const normDest = normalisePath(dest);
+    const normSrc = normalisePath(src, this.workspaceBase);
+    const normDest = normalisePath(dest, this.workspaceBase);
     const entry = this.entries.get(normSrc);
     if (entry) {
       const content = await this.resolver.readFile(entry.id, this.ctx);
@@ -257,16 +255,14 @@ var VirtualSandboxFileSystem = class {
   async readlink(_path) {
     throw new SandboxNotSupportedError("readlink");
   }
-  resolvePath(base, path) {
-    if (path.startsWith("/")) return normalisePath(path);
-    const combined = base.endsWith("/") ? base + path : base + "/" + path;
-    return normalisePath(combined);
+  resolvePath(base, path$1) {
+    return path.posix.resolve(normalisePath(base, this.workspaceBase), path$1);
   }
   // --------------------------------------------------------------------------
   // Helpers
   // --------------------------------------------------------------------------
   addParentDirectories(filePath) {
-    let dir = parentDir(normalisePath(filePath));
+    let dir = parentDir(normalisePath(filePath, this.workspaceBase));
     while (!this.directories.has(dir)) {
       this.directories.add(dir);
       dir = parentDir(dir);
@@ -304,18 +300,21 @@ var VirtualSandboxProvider = class {
     const fileTree = await this.resolver.resolveEntries(
       options.resolverContext
     );
+    const workspaceBase = options.workspaceBase ?? "/";
     const sandbox = createVirtualSandbox(
       sandboxId,
       fileTree,
       this.resolver,
-      options.resolverContext
+      options.resolverContext,
+      workspaceBase
     );
     return {
       sandbox,
       stateUpdate: {
         sandboxId,
         fileTree,
-        resolverContext: options.resolverContext
+        resolverContext: options.resolverContext,
+        workspaceBase
       }
     };
   }
@@ -350,7 +349,7 @@ async function queryParentWorkflowState(client) {
 function withVirtualSandbox(client, provider, handler) {
   return async (args, context) => {
     const state = await queryParentWorkflowState(client);
-    const { sandboxId, fileTree, resolverContext } = state;
+    const { sandboxId, fileTree, resolverContext, workspaceBase } = state;
     if (!fileTree || !sandboxId) {
       return {
         toolResponse: `Error: No fileTree/sandboxId in agent state. The ${context.toolName} tool requires a virtual sandbox.`,
@@ -361,7 +360,8 @@ function withVirtualSandbox(client, provider, handler) {
       sandboxId,
       fileTree,
       provider.resolver,
-      resolverContext
+      resolverContext,
+      workspaceBase ?? "/"
     );
     const response = await handler(args, { ...context, sandbox });
     const mutations = sandbox.fs.getMutations();
@@ -377,9 +377,9 @@ function withVirtualSandbox(client, provider, handler) {
 
 // src/adapters/sandbox/virtual/index.ts
 var VirtualSandboxImpl = class {
-  constructor(id, tree, resolver, ctx) {
+  constructor(id, tree, resolver, ctx, workspaceBase = "/") {
     this.id = id;
-    this.fs = new VirtualSandboxFileSystem(tree, resolver, ctx);
+    this.fs = new VirtualSandboxFileSystem(tree, resolver, ctx, workspaceBase);
   }
   capabilities = {
     filesystem: true,
@@ -393,8 +393,8 @@ var VirtualSandboxImpl = class {
   async destroy() {
   }
 };
-function createVirtualSandbox(id, tree, resolver, ctx) {
-  return new VirtualSandboxImpl(id, tree, resolver, ctx);
+function createVirtualSandbox(id, tree, resolver, ctx, workspaceBase = "/") {
+  return new VirtualSandboxImpl(id, tree, resolver, ctx, workspaceBase);
 }
 
 exports.VirtualSandboxFileSystem = VirtualSandboxFileSystem;

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","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  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 type {\n  FileEntry,\n  FileEntryMetadata,\n  FileResolver,\n  TreeMutation,\n} from \"./types\";\n\n/**\n * Normalise a virtual path to a canonical form: absolute, no trailing slash\n * (except root), no double slashes.\n */\nfunction normalisePath(p: string): string {\n  if (!p.startsWith(\"/\")) p = \"/\" + p;\n  p = p.replace(/\\/+/g, \"/\");\n  if (p.length > 1 && p.endsWith(\"/\")) p = p.slice(0, -1);\n  return 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(entries: { path: string }[]): Set<string> {\n  const dirs = new Set<string>();\n  dirs.add(\"/\");\n  for (const entry of entries) {\n    let dir = parentDir(normalisePath(entry.path));\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  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  ) {\n    this.entries = new Map(\n      tree.map((e) => [normalisePath(e.path), e]),\n    );\n    this.directories = inferDirectories(tree);\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));\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));\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));\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);\n    return this.entries.has(norm) || this.directories.has(norm);\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const norm = normalisePath(path);\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);\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);\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);\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);\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);\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);\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);\n    const normDest = normalisePath(dest);\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    if (path.startsWith(\"/\")) return normalisePath(path);\n    const combined =\n      base.endsWith(\"/\") ? base + path : base + \"/\" + path;\n    return normalisePath(combined);\n  }\n\n  // --------------------------------------------------------------------------\n  // Helpers\n  // --------------------------------------------------------------------------\n\n  private addParentDirectories(filePath: string): void {\n    let dir = parentDir(normalisePath(filePath));\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) 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\n    const sandbox = createVirtualSandbox(\n      sandboxId,\n      fileTree,\n      this.resolver,\n      options.resolverContext\n    );\n\n    return {\n      sandbox,\n      stateUpdate: {\n        sandboxId,\n        fileTree,\n        resolverContext: options.resolverContext,\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` and `resolverContext`\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 } = 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    );\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  ) {\n    this.fs = new VirtualSandboxFileSystem(tree, resolver, ctx);\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): VirtualSandbox<TCtx, TMeta> {\n  return new VirtualSandboxImpl(id, tree, resolver, ctx);\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/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"]}

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

@@ -1,6 +1,6 @@
-import { F as FileEntryMetadata, V as VirtualSandboxCreateOptions, a as FileResolver, b as VirtualSandboxContext, T as TreeMutation, c as FileEntry, d as VirtualSandbox } from '../../../types-BVP87m_W.cjs';
-export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-BVP87m_W.cjs';
-import { b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult } from '../../../types-CDubRtad.cjs';
+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 { 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';
 import '@temporalio/common';
@@ -10,7 +10,7 @@ import 'zod';
  * Stateless {@link SandboxProvider} backed by a {@link FileResolver}.
  *
  * The provider holds **no internal state**. All sandbox state (sandboxId,
- * fileTree, resolverContext) is returned as a `stateUpdate` from
+ * fileTree, resolverContext, workspaceBase) is returned as a `stateUpdate` from
  * {@link create} and merged into the workflow's `AgentState` by the session.
  * {@link withVirtualSandbox} reads this state back on every tool invocation.
  *
@@ -42,7 +42,7 @@ declare class VirtualSandboxProvider<TCtx = unknown, TMeta = FileEntryMetadata>
  * the parent workflow for the current file tree and resolver context.
  *
  * On each invocation the wrapper:
- * 1. Queries the workflow's `AgentState` for `fileTree` and `resolverContext`
+ * 1. Queries the workflow's `AgentState` for `fileTree`, `resolverContext`, and `workspaceBase`
  * 2. Creates an ephemeral {@link VirtualSandbox} from tree + provider's resolver
  * 3. Runs the inner handler
  * 4. Returns the handler's result together with any {@link TreeMutation}s
@@ -80,6 +80,6 @@ declare function withVirtualSandbox<TArgs, TResult, TCtx, TMeta = FileEntryMetad
  * {@link VirtualSandboxProvider}; consumers can also call this directly
  * if they need a sandbox outside the wrapper pattern.
  */
-declare function createVirtualSandbox<TCtx, TMeta = FileEntryMetadata>(id: string, tree: FileEntry<TMeta>[], resolver: FileResolver<TCtx, TMeta>, ctx: TCtx): VirtualSandbox<TCtx, TMeta>;
+declare function createVirtualSandbox<TCtx, TMeta = FileEntryMetadata>(id: string, tree: FileEntry<TMeta>[], resolver: FileResolver<TCtx, TMeta>, ctx: TCtx, workspaceBase?: string): VirtualSandbox<TCtx, TMeta>;
 
 export { FileEntry, FileEntryMetadata, FileResolver, TreeMutation, VirtualSandbox, VirtualSandboxContext, VirtualSandboxCreateOptions, VirtualSandboxProvider, createVirtualSandbox, withVirtualSandbox };

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

@@ -1,6 +1,6 @@
-import { F as FileEntryMetadata, V as VirtualSandboxCreateOptions, a as FileResolver, b as VirtualSandboxContext, T as TreeMutation, c as FileEntry, d as VirtualSandbox } from '../../../types-CwwgQ_9H.js';
-export { e as VirtualFileTree, f as VirtualSandboxFileSystem, g as VirtualSandboxState } from '../../../types-CwwgQ_9H.js';
-import { b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult } from '../../../types-CDubRtad.js';
+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 { 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';
 import '@temporalio/common';
@@ -10,7 +10,7 @@ import 'zod';
  * Stateless {@link SandboxProvider} backed by a {@link FileResolver}.
  *
  * The provider holds **no internal state**. All sandbox state (sandboxId,
- * fileTree, resolverContext) is returned as a `stateUpdate` from
+ * fileTree, resolverContext, workspaceBase) is returned as a `stateUpdate` from
  * {@link create} and merged into the workflow's `AgentState` by the session.
  * {@link withVirtualSandbox} reads this state back on every tool invocation.
  *
@@ -42,7 +42,7 @@ declare class VirtualSandboxProvider<TCtx = unknown, TMeta = FileEntryMetadata>
  * the parent workflow for the current file tree and resolver context.
  *
  * On each invocation the wrapper:
- * 1. Queries the workflow's `AgentState` for `fileTree` and `resolverContext`
+ * 1. Queries the workflow's `AgentState` for `fileTree`, `resolverContext`, and `workspaceBase`
  * 2. Creates an ephemeral {@link VirtualSandbox} from tree + provider's resolver
  * 3. Runs the inner handler
  * 4. Returns the handler's result together with any {@link TreeMutation}s
@@ -80,6 +80,6 @@ declare function withVirtualSandbox<TArgs, TResult, TCtx, TMeta = FileEntryMetad
  * {@link VirtualSandboxProvider}; consumers can also call this directly
  * if they need a sandbox outside the wrapper pattern.
  */
-declare function createVirtualSandbox<TCtx, TMeta = FileEntryMetadata>(id: string, tree: FileEntry<TMeta>[], resolver: FileResolver<TCtx, TMeta>, ctx: TCtx): VirtualSandbox<TCtx, TMeta>;
+declare function createVirtualSandbox<TCtx, TMeta = FileEntryMetadata>(id: string, tree: FileEntry<TMeta>[], resolver: FileResolver<TCtx, TMeta>, ctx: TCtx, workspaceBase?: string): VirtualSandbox<TCtx, TMeta>;
 
 export { FileEntry, FileEntryMetadata, FileResolver, TreeMutation, VirtualSandbox, VirtualSandboxContext, VirtualSandboxCreateOptions, VirtualSandboxProvider, createVirtualSandbox, withVirtualSandbox };