zeitlich 0.2.27 → 0.2.29

package/README.md

@@ -58,7 +58,7 @@ A sandbox adapter provides filesystem access for tools like `Bash`, `Read`, `Wri
 | Adapter | Import | Use case |
 |---------|--------|----------|
 | In-memory | `zeitlich/adapters/sandbox/inmemory` | Tests and lightweight agents |
-| Virtual | `zeitlich/adapters/sandbox/virtual` | Custom resolvers with path-only ops |
+| Virtual FS | `zeitlich` / `zeitlich/workflow` | Built-in virtual filesystem with custom resolvers |
 | Daytona | `zeitlich/adapters/sandbox/daytona` | Remote Daytona workspaces |
 | E2B | `zeitlich/adapters/sandbox/e2b` | E2B cloud sandboxes |
 | Bedrock | `zeitlich/adapters/sandbox/bedrock` | AWS Bedrock AgentCore Code Interpreter |
@@ -774,22 +774,16 @@ This means `readFile("a/b.txt")` is treated as `/a/b.txt` across adapters.
 
 Each `fs` instance also exposes `workspaceBase`, which is the base used for relative paths.
 
-**Virtual sandbox example (path-only calls):**
+**Virtual filesystem example (path-only calls):**
 
 ```typescript
-import { createVirtualSandbox, VirtualSandboxProvider } from "zeitlich";
+import { VirtualFileSystem } from "zeitlich";
 
-const provider = new VirtualSandboxProvider(resolver);
-const { sandbox } = await provider.create({
-  resolverContext: { projectId: "p1" },
-  workspaceBase: "/repo",
-});
-
-const fs = sandbox.fs;
-console.log(fs.workspaceBase); // "/repo"
+const virtualFs = new VirtualFileSystem(fileTree, resolver, { projectId: "p1" }, "/repo");
+console.log(virtualFs.workspaceBase); // "/repo"
 
-await fs.writeFile("src/index.ts", 'export const ok = true;\n');
-const content = await fs.readFile("src/index.ts"); // reads /repo/src/index.ts
+await virtualFs.writeFile("src/index.ts", 'export const ok = true;\n');
+const content = await virtualFs.readFile("src/index.ts"); // reads /repo/src/index.ts
 ```
 
 **Daytona sandbox example (base `/home/daytona`):**
@@ -991,6 +985,120 @@ Framework-agnostic utilities for activities, worker setup, and Node.js code:
                     └─────────────────┘
 ```
 
+## Observability
+
+Zeitlich emits structured, replay-safe logs at key lifecycle points (session start/end, each turn, tool execution, subagent spawn/completion). These flow through Temporal's built-in workflow logger with zero configuration.
+
+### Logging
+
+All log messages are emitted via `@temporalio/workflow`'s `log` and automatically routed to whatever logger you configure on the Temporal Runtime. By default they go to `STDERR` via `console.error`.
+
+**Custom logger (e.g. winston):**
+
+```typescript
+import { Runtime, makeTelemetryFilterString } from "@temporalio/worker";
+import winston from "winston";
+
+const logger = winston.createLogger({
+  level: "info",
+  format: winston.format.json(),
+  transports: [new winston.transports.File({ filename: "worker.log" })],
+});
+
+Runtime.install({
+  logger,
+  telemetryOptions: {
+    logging: {
+      filter: makeTelemetryFilterString({ core: "INFO", other: "INFO" }),
+      forward: {},
+    },
+  },
+});
+```
+
+### Metrics via Sinks
+
+For custom metrics (Prometheus, Datadog, OpenTelemetry, etc.), zeitlich provides `ZeitlichObservabilitySinks` — a typed Temporal Sinks interface that bridges agent events from the workflow sandbox to your Node.js metrics backend.
+
+**1. Register sinks on the Worker:**
+
+```typescript
+import { Worker, InjectedSinks } from "@temporalio/worker";
+import type { ZeitlichObservabilitySinks } from "zeitlich/workflow";
+
+const sinks: InjectedSinks<ZeitlichObservabilitySinks> = {
+  zeitlichMetrics: {
+    sessionStarted: {
+      fn(_workflowInfo, event) {
+        sessionCounter.inc({ agent: event.agentName });
+      },
+      callDuringReplay: false,
+    },
+    sessionEnded: {
+      fn(_workflowInfo, event) {
+        sessionDuration.observe(event.durationMs);
+        tokenCounter.inc({ type: "input" }, event.usage.inputTokens ?? 0);
+      },
+      callDuringReplay: false,
+    },
+    turnCompleted: {
+      fn(_workflowInfo, event) {
+        turnGauge.set({ agent: event.agentName }, event.turn);
+      },
+      callDuringReplay: false,
+    },
+    toolExecuted: {
+      fn(_workflowInfo, event) {
+        toolDuration.observe({ tool: event.toolName }, event.durationMs);
+        if (!event.success) toolErrors.inc({ tool: event.toolName });
+      },
+      callDuringReplay: false,
+    },
+  },
+};
+
+const worker = await Worker.create({ sinks, /* ... */ });
+```
+
+**2. Wire hooks in your workflow:**
+
+```typescript
+import { createSession, createObservabilityHooks } from "zeitlich/workflow";
+
+const session = await createSession({
+  agentName: "myAgent",
+  hooks: createObservabilityHooks("myAgent"),
+  // ...
+});
+```
+
+Use `composeHooks()` to combine observability hooks with your own:
+
+```typescript
+import { createObservabilityHooks, composeHooks } from "zeitlich/workflow";
+
+const obs = createObservabilityHooks("myAgent");
+
+const session = await createSession({
+  hooks: {
+    ...obs,
+    onSessionEnd: composeHooks(obs.onSessionEnd, (ctx) => {
+      // your custom session-end logic
+    }),
+  },
+});
+```
+
+### Tracing with OpenTelemetry
+
+For distributed tracing across client, workflow, and activities, use Temporal's OpenTelemetry interceptor package:
+
+```bash
+npm install @temporalio/interceptors-opentelemetry @opentelemetry/sdk-node
+```
+
+See [Temporal's tracing docs](https://docs.temporal.io/develop/typescript/observability#set-up-tracing) and the [`interceptors-opentelemetry` sample](https://github.com/temporalio/samples-typescript/tree/main/interceptors-opentelemetry) for setup.
+
 ## Requirements
 
 - Node.js >= 18

package/dist/{activities-DE3_q9yq.d.ts → activities-1xrWRrGJ.d.cts}

@@ -1,8 +1,7 @@
 import Redis from 'ioredis';
 import { Part, Content, GoogleGenAI } from '@google/genai';
-import { R as RouterContext, T as ToolHandlerResponse, A as ActivityToolHandler } from './types-mCVxKIZb.js';
-import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix } from './types-CvJyXDYt.js';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-CIkYBoF8.js';
+import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, b as ToolHandlerResponse, c as ActivityToolHandler } from './types-seDYom4M.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-Dpz2gXLk.cjs';
 
 /** SDK-native content type for Google GenAI human messages */
 type GoogleGenAIContent = string | Part[];

package/dist/{activities-p8PDlRIK.d.cts → activities-DOViDCTE.d.ts}

@@ -1,8 +1,7 @@
 import Redis from 'ioredis';
 import { Part, Content, GoogleGenAI } from '@google/genai';
-import { R as RouterContext, T as ToolHandlerResponse, A as ActivityToolHandler } from './types-mCVxKIZb.cjs';
-import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix } from './types-DSOefLpY.cjs';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BfIQABzu.cjs';
+import { a as ModelInvoker, P as PrefixedThreadOps, S as ScopedPrefix, R as RouterContext, b as ToolHandlerResponse, c as ActivityToolHandler } from './types-BkVoEyiH.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DAv_SLN8.js';
 
 /** SDK-native content type for Google GenAI human messages */
 type GoogleGenAIContent = string | Part[];

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

@@ -0,0 +1,230 @@
+'use strict';
+
+var codeInterpreter = require('@e2b/code-interpreter');
+var common = require('@temporalio/common');
+var path = require('path');
+
+// src/adapters/sandbox/e2b/index.ts
+var SandboxNotSupportedError = class extends common.ApplicationFailure {
+  constructor(operation) {
+    super(
+      `Sandbox does not support: ${operation}`,
+      "SandboxNotSupportedError",
+      true
+    );
+  }
+};
+var SandboxNotFoundError = class extends common.ApplicationFailure {
+  constructor(sandboxId) {
+    super(`Sandbox not found: ${sandboxId}`, "SandboxNotFoundError", true);
+  }
+};
+function toArrayBuffer(u8) {
+  return u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength);
+}
+var E2bSandboxFileSystem = class {
+  constructor(sandbox, workspaceBase = "/home/user") {
+    this.sandbox = sandbox;
+    this.workspaceBase = path.posix.resolve("/", workspaceBase);
+  }
+  workspaceBase;
+  normalisePath(path$1) {
+    return path.posix.resolve(this.workspaceBase, path$1);
+  }
+  async readFile(path) {
+    return this.sandbox.files.read(this.normalisePath(path));
+  }
+  async readFileBuffer(path) {
+    return this.sandbox.files.read(this.normalisePath(path), {
+      format: "bytes"
+    });
+  }
+  async writeFile(path, content) {
+    const norm = this.normalisePath(path);
+    if (typeof content === "string") {
+      await this.sandbox.files.write(norm, content);
+    } else {
+      await this.sandbox.files.write(norm, toArrayBuffer(content));
+    }
+  }
+  async appendFile(path, content) {
+    const norm = this.normalisePath(path);
+    let existing = "";
+    try {
+      existing = await this.sandbox.files.read(norm);
+    } catch {
+    }
+    const addition = typeof content === "string" ? content : new TextDecoder().decode(content);
+    await this.sandbox.files.write(norm, existing + addition);
+  }
+  async exists(path) {
+    return this.sandbox.files.exists(this.normalisePath(path));
+  }
+  async stat(path) {
+    const norm = this.normalisePath(path);
+    const info = await this.sandbox.files.getInfo(norm);
+    const isSymlink = !!info.symlinkTarget;
+    return {
+      isFile: isSymlink ? false : info.type === codeInterpreter.FileType.FILE,
+      isDirectory: isSymlink ? false : info.type === codeInterpreter.FileType.DIR,
+      isSymbolicLink: isSymlink,
+      size: info.size,
+      mtime: info.modifiedTime ?? /* @__PURE__ */ new Date(0)
+    };
+  }
+  async mkdir(path, _options) {
+    await this.sandbox.files.makeDir(this.normalisePath(path));
+  }
+  async readdir(path$1) {
+    const entries = await this.sandbox.files.list(this.normalisePath(path$1));
+    return entries.map((e) => path.posix.basename(e.path));
+  }
+  async readdirWithFileTypes(path$1) {
+    const entries = await this.sandbox.files.list(this.normalisePath(path$1));
+    return entries.map((e) => {
+      const isSymlink = !!e.symlinkTarget;
+      return {
+        name: path.posix.basename(e.path),
+        isFile: isSymlink ? false : e.type === codeInterpreter.FileType.FILE,
+        isDirectory: isSymlink ? false : e.type === codeInterpreter.FileType.DIR,
+        isSymbolicLink: isSymlink
+      };
+    });
+  }
+  async rm(path, options) {
+    const norm = this.normalisePath(path);
+    try {
+      await this.sandbox.files.remove(norm);
+    } catch (err) {
+      if (!options?.force) throw err;
+    }
+  }
+  async cp(src, dest, _options) {
+    const normSrc = this.normalisePath(src);
+    const normDest = this.normalisePath(dest);
+    await this.sandbox.commands.run(`cp -r "${normSrc}" "${normDest}"`);
+  }
+  async mv(src, dest) {
+    const normSrc = this.normalisePath(src);
+    const normDest = this.normalisePath(dest);
+    await this.sandbox.files.rename(normSrc, normDest);
+  }
+  async readlink(path) {
+    const norm = this.normalisePath(path);
+    const info = await this.sandbox.files.getInfo(norm);
+    if (!info.symlinkTarget) {
+      throw new Error(`EINVAL: invalid argument, readlink '${path}'`);
+    }
+    return info.symlinkTarget;
+  }
+  resolvePath(base, path$1) {
+    return path.posix.resolve(this.normalisePath(base), path$1);
+  }
+};
+
+// src/adapters/sandbox/e2b/index.ts
+var E2bSandboxImpl = class {
+  constructor(id, sdkSandbox, workspaceBase = "/home/user") {
+    this.id = id;
+    this.sdkSandbox = sdkSandbox;
+    this.fs = new E2bSandboxFileSystem(sdkSandbox, workspaceBase);
+  }
+  capabilities = {
+    filesystem: true,
+    execution: true,
+    persistence: true
+  };
+  fs;
+  async exec(command, options) {
+    const result = await this.sdkSandbox.commands.run(command, {
+      cwd: options?.cwd,
+      envs: options?.env,
+      timeoutMs: options?.timeout
+    });
+    return {
+      exitCode: result.exitCode,
+      stdout: result.stdout,
+      stderr: result.stderr
+    };
+  }
+  async destroy() {
+    await this.sdkSandbox.kill();
+  }
+};
+var E2bSandboxProvider = class {
+  id = "e2b";
+  capabilities = {
+    filesystem: true,
+    execution: true,
+    persistence: true
+  };
+  defaultTemplate;
+  defaultWorkspaceBase;
+  defaultTimeoutMs;
+  constructor(config) {
+    this.defaultTemplate = config?.template;
+    this.defaultWorkspaceBase = config?.workspaceBase ?? "/home/user";
+    this.defaultTimeoutMs = config?.timeoutMs;
+  }
+  async create(options) {
+    const template = options?.template ?? this.defaultTemplate;
+    const workspaceBase = this.defaultWorkspaceBase;
+    const createOpts = {
+      envs: options?.env,
+      timeoutMs: options?.timeoutMs ?? this.defaultTimeoutMs
+    };
+    const sdkSandbox = template ? await codeInterpreter.Sandbox.create(template, createOpts) : await codeInterpreter.Sandbox.create(createOpts);
+    const sandbox = new E2bSandboxImpl(
+      sdkSandbox.sandboxId,
+      sdkSandbox,
+      workspaceBase
+    );
+    if (options?.initialFiles) {
+      await Promise.all(
+        Object.entries(options.initialFiles).map(
+          ([path, content]) => sandbox.fs.writeFile(path, content)
+        )
+      );
+    }
+    return { sandbox };
+  }
+  async get(sandboxId) {
+    try {
+      const sdkSandbox = await codeInterpreter.Sandbox.connect(sandboxId);
+      return new E2bSandboxImpl(sandboxId, sdkSandbox, this.defaultWorkspaceBase);
+    } catch {
+      throw new SandboxNotFoundError(sandboxId);
+    }
+  }
+  async destroy(sandboxId) {
+    try {
+      const sdkSandbox = await codeInterpreter.Sandbox.connect(sandboxId);
+      await sdkSandbox.kill();
+    } catch {
+    }
+  }
+  async pause(sandboxId, _ttlSeconds) {
+    const sdkSandbox = await codeInterpreter.Sandbox.connect(sandboxId);
+    await sdkSandbox.pause();
+  }
+  async snapshot(_sandboxId) {
+    throw new SandboxNotSupportedError("snapshot");
+  }
+  async restore(_snapshot) {
+    throw new SandboxNotSupportedError("restore");
+  }
+  async fork(sandboxId) {
+    const { snapshotId } = await codeInterpreter.Sandbox.createSnapshot(sandboxId);
+    const sdkSandbox = await codeInterpreter.Sandbox.create(snapshotId);
+    return new E2bSandboxImpl(
+      sdkSandbox.sandboxId,
+      sdkSandbox,
+      this.defaultWorkspaceBase
+    );
+  }
+};
+
+exports.E2bSandboxFileSystem = E2bSandboxFileSystem;
+exports.E2bSandboxProvider = E2bSandboxProvider;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/sandbox/types.ts","../../../../src/adapters/sandbox/e2b/filesystem.ts","../../../../src/adapters/sandbox/e2b/index.ts"],"names":["ApplicationFailure","posix","path","FileType","E2bSdkSandbox"],"mappings":"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","file":"index.cjs","sourcesContent":["// ============================================================================\n// Sandbox Filesystem\n// ============================================================================\n\nexport interface DirentEntry {\n  name: string;\n  isFile: boolean;\n  isDirectory: boolean;\n  isSymbolicLink: boolean;\n}\n\nexport interface FileStat {\n  isFile: boolean;\n  isDirectory: boolean;\n  isSymbolicLink: boolean;\n  size: number;\n  mtime: Date;\n}\n\n/**\n * Provider-agnostic filesystem interface.\n *\n * Implementations that don't support a method should throw\n * {@link SandboxNotSupportedError}.\n */\nexport interface SandboxFileSystem {\n  /** Base directory used when resolving relative paths. */\n  readonly workspaceBase: string;\n  readFile(path: string): Promise<string>;\n  readFileBuffer(path: string): Promise<Uint8Array>;\n  writeFile(path: string, content: string | Uint8Array): Promise<void>;\n  appendFile(path: string, content: string | Uint8Array): Promise<void>;\n  exists(path: string): Promise<boolean>;\n  stat(path: string): Promise<FileStat>;\n  mkdir(path: string, options?: { recursive?: boolean }): Promise<void>;\n  readdir(path: string): Promise<string[]>;\n  readdirWithFileTypes(path: string): Promise<DirentEntry[]>;\n  rm(\n    path: string,\n    options?: { recursive?: boolean; force?: boolean }\n  ): Promise<void>;\n  cp(\n    src: string,\n    dest: string,\n    options?: { recursive?: boolean }\n  ): Promise<void>;\n  mv(src: string, dest: string): Promise<void>;\n  readlink(path: string): Promise<string>;\n  resolvePath(base: string, path: string): string;\n}\n\n// ============================================================================\n// Execution\n// ============================================================================\n\nexport interface ExecOptions {\n  timeout?: number;\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ExecResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n// ============================================================================\n// Capabilities\n// ============================================================================\n\nexport interface SandboxCapabilities {\n  /** Sandbox supports filesystem operations */\n  filesystem: boolean;\n  /** Sandbox supports shell/command execution */\n  execution: boolean;\n  /** Sandbox state can be persisted and restored */\n  persistence: boolean;\n}\n\n// ============================================================================\n// Sandbox\n// ============================================================================\n\nexport interface Sandbox {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n  readonly fs: SandboxFileSystem;\n\n  exec(command: string, options?: ExecOptions): Promise<ExecResult>;\n  destroy(): Promise<void>;\n}\n\n// ============================================================================\n// Snapshots\n// ============================================================================\n\nexport interface SandboxSnapshot {\n  sandboxId: string;\n  providerId: string;\n  /** Provider-specific serialised state */\n  data: unknown;\n  createdAt: string;\n}\n\n// ============================================================================\n// Provider\n// ============================================================================\n\nexport interface SandboxCreateOptions {\n  /** Preferred sandbox ID (provider may ignore) */\n  id?: string;\n  /** Seed the filesystem with these files */\n  initialFiles?: Record<string, string | Uint8Array>;\n  /** Environment variables available inside the sandbox */\n  env?: Record<string, string>;\n}\n\nexport interface SandboxCreateResult {\n  sandbox: Sandbox;\n  /** Optional state to merge into the workflow's `AgentState` via the session. */\n  stateUpdate?: Record<string, unknown>;\n}\n\nexport interface SandboxProvider<\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n  TSandbox extends Sandbox = Sandbox,\n> {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n\n  create(options?: TOptions): Promise<SandboxCreateResult>;\n  get(sandboxId: string): Promise<TSandbox>;\n  destroy(sandboxId: string): Promise<void>;\n  pause(sandboxId: string, ttlSeconds?: number): Promise<void>;\n  snapshot(sandboxId: string): Promise<SandboxSnapshot>;\n  restore(snapshot: SandboxSnapshot): Promise<Sandbox>;\n  fork(sandboxId: string): Promise<Sandbox>;\n}\n\n// ============================================================================\n// SandboxOps — workflow-side activity interface (like ThreadOps)\n// ============================================================================\n\nexport interface SandboxOps<\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n> {\n  createSandbox(\n    options?: TOptions\n  ): Promise<{ sandboxId: string; stateUpdate?: Record<string, unknown> }>;\n  destroySandbox(sandboxId: string): Promise<void>;\n  pauseSandbox(sandboxId: string): Promise<void>;\n  snapshotSandbox(sandboxId: string): Promise<SandboxSnapshot>;\n  forkSandbox(sandboxId: string): Promise<string>;\n}\n\n/**\n * Maps generic {@link SandboxOps} method names to adapter-prefixed names.\n *\n * @example\n * ```typescript\n * type InMemOps = PrefixedSandboxOps<\"inMemory\">;\n * // → { inMemoryCreateSandbox, inMemoryDestroySandbox, inMemorySnapshotSandbox }\n * ```\n */\nexport type PrefixedSandboxOps<\n  TPrefix extends string,\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n> = {\n  [K in keyof SandboxOps<TOptions> as `${TPrefix}${Capitalize<K & string>}`]: SandboxOps<TOptions>[K];\n};\n\n// ============================================================================\n// Errors\n// ============================================================================\n\nimport { ApplicationFailure } from \"@temporalio/common\";\n\nexport class SandboxNotSupportedError extends ApplicationFailure {\n  constructor(operation: string) {\n    super(\n      `Sandbox does not support: ${operation}`,\n      \"SandboxNotSupportedError\",\n      true\n    );\n  }\n}\n\nexport class SandboxNotFoundError extends ApplicationFailure {\n  constructor(sandboxId: string) {\n    super(`Sandbox not found: ${sandboxId}`, \"SandboxNotFoundError\", true);\n  }\n}\n","import { FileType, type Sandbox as E2bSdkSandbox } from \"@e2b/code-interpreter\";\nimport type {\n  SandboxFileSystem,\n  DirentEntry,\n  FileStat,\n} from \"../../../lib/sandbox/types\";\nimport { posix } from \"node:path\";\n\nfunction toArrayBuffer(u8: Uint8Array): ArrayBuffer {\n  return u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength) as ArrayBuffer;\n}\n\n/**\n * {@link SandboxFileSystem} backed by an E2B SDK sandbox.\n *\n * Maps zeitlich's filesystem interface to E2B's `sandbox.files` and\n * `sandbox.commands` APIs. Operations that have no direct E2B equivalent\n * (e.g. `appendFile`, `cp`) are composed from primitives.\n */\nexport class E2bSandboxFileSystem implements SandboxFileSystem {\n  readonly workspaceBase: string;\n\n  constructor(\n    private sandbox: E2bSdkSandbox,\n    workspaceBase = \"/home/user\"\n  ) {\n    this.workspaceBase = posix.resolve(\"/\", workspaceBase);\n  }\n\n  private normalisePath(path: string): string {\n    return posix.resolve(this.workspaceBase, path);\n  }\n\n  async readFile(path: string): Promise<string> {\n    return this.sandbox.files.read(this.normalisePath(path));\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    return this.sandbox.files.read(this.normalisePath(path), {\n      format: \"bytes\",\n    });\n  }\n\n  async writeFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = this.normalisePath(path);\n    if (typeof content === \"string\") {\n      await this.sandbox.files.write(norm, content);\n    } else {\n      await this.sandbox.files.write(norm, toArrayBuffer(content));\n    }\n  }\n\n  async appendFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = this.normalisePath(path);\n    let existing = \"\";\n    try {\n      existing = await this.sandbox.files.read(norm);\n    } catch {\n      // file doesn't exist yet — write from scratch\n    }\n    const addition =\n      typeof content === \"string\"\n        ? content\n        : new TextDecoder().decode(content);\n    await this.sandbox.files.write(norm, existing + addition);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.sandbox.files.exists(this.normalisePath(path));\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const norm = this.normalisePath(path);\n    const info = await this.sandbox.files.getInfo(norm);\n    const isSymlink = !!info.symlinkTarget;\n    return {\n      isFile: isSymlink ? false : info.type === FileType.FILE,\n      isDirectory: isSymlink ? false : info.type === FileType.DIR,\n      isSymbolicLink: isSymlink,\n      size: info.size,\n      mtime: info.modifiedTime ?? new Date(0),\n    };\n  }\n\n  async mkdir(path: string, _options?: { recursive?: boolean }): Promise<void> {\n    await this.sandbox.files.makeDir(this.normalisePath(path));\n  }\n\n  async readdir(path: string): Promise<string[]> {\n    const entries = await this.sandbox.files.list(this.normalisePath(path));\n    return entries.map((e) => posix.basename(e.path));\n  }\n\n  async readdirWithFileTypes(path: string): Promise<DirentEntry[]> {\n    const entries = await this.sandbox.files.list(this.normalisePath(path));\n    return entries.map((e) => {\n      const isSymlink = !!e.symlinkTarget;\n      return {\n        name: posix.basename(e.path),\n        isFile: isSymlink ? false : e.type === FileType.FILE,\n        isDirectory: isSymlink ? false : e.type === FileType.DIR,\n        isSymbolicLink: isSymlink,\n      };\n    });\n  }\n\n  async rm(\n    path: string,\n    options?: { recursive?: boolean; force?: boolean }\n  ): Promise<void> {\n    const norm = this.normalisePath(path);\n    try {\n      await this.sandbox.files.remove(norm);\n    } catch (err) {\n      if (!options?.force) throw err;\n    }\n  }\n\n  async cp(\n    src: string,\n    dest: string,\n    _options?: { recursive?: boolean }\n  ): Promise<void> {\n    const normSrc = this.normalisePath(src);\n    const normDest = this.normalisePath(dest);\n    await this.sandbox.commands.run(`cp -r \"${normSrc}\" \"${normDest}\"`);\n  }\n\n  async mv(src: string, dest: string): Promise<void> {\n    const normSrc = this.normalisePath(src);\n    const normDest = this.normalisePath(dest);\n    await this.sandbox.files.rename(normSrc, normDest);\n  }\n\n  async readlink(path: string): Promise<string> {\n    const norm = this.normalisePath(path);\n    const info = await this.sandbox.files.getInfo(norm);\n    if (!info.symlinkTarget) {\n      throw new Error(`EINVAL: invalid argument, readlink '${path}'`);\n    }\n    return info.symlinkTarget;\n  }\n\n  resolvePath(base: string, path: string): string {\n    return posix.resolve(this.normalisePath(base), path);\n  }\n}\n","import { Sandbox as E2bSdkSandbox } from \"@e2b/code-interpreter\";\nimport type {\n  Sandbox,\n  SandboxCapabilities,\n  SandboxCreateResult,\n  SandboxProvider,\n  SandboxSnapshot,\n  ExecOptions,\n  ExecResult,\n} from \"../../../lib/sandbox/types\";\nimport {\n  SandboxNotFoundError,\n  SandboxNotSupportedError,\n} from \"../../../lib/sandbox/types\";\nimport { E2bSandboxFileSystem } from \"./filesystem\";\nimport type {\n  E2bSandbox,\n  E2bSandboxConfig,\n  E2bSandboxCreateOptions,\n} from \"./types\";\n\n// ============================================================================\n// E2bSandbox\n// ============================================================================\n\nclass E2bSandboxImpl implements Sandbox {\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: true,\n    persistence: true,\n  };\n\n  readonly fs: E2bSandboxFileSystem;\n\n  constructor(\n    readonly id: string,\n    private sdkSandbox: E2bSdkSandbox,\n    workspaceBase = \"/home/user\"\n  ) {\n    this.fs = new E2bSandboxFileSystem(sdkSandbox, workspaceBase);\n  }\n\n  async exec(command: string, options?: ExecOptions): Promise<ExecResult> {\n    const result = await this.sdkSandbox.commands.run(command, {\n      cwd: options?.cwd,\n      envs: options?.env,\n      timeoutMs: options?.timeout,\n    });\n    return {\n      exitCode: result.exitCode,\n      stdout: result.stdout,\n      stderr: result.stderr,\n    };\n  }\n\n  async destroy(): Promise<void> {\n    await this.sdkSandbox.kill();\n  }\n}\n\n// ============================================================================\n// E2bSandboxProvider\n// ============================================================================\n\nexport class E2bSandboxProvider\n  implements SandboxProvider<E2bSandboxCreateOptions, E2bSandbox>\n{\n  readonly id = \"e2b\";\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: true,\n    persistence: true,\n  };\n\n  private readonly defaultTemplate?: string;\n  private readonly defaultWorkspaceBase: string;\n  private readonly defaultTimeoutMs?: number;\n\n  constructor(config?: E2bSandboxConfig) {\n    this.defaultTemplate = config?.template;\n    this.defaultWorkspaceBase = config?.workspaceBase ?? \"/home/user\";\n    this.defaultTimeoutMs = config?.timeoutMs;\n  }\n\n  async create(\n    options?: E2bSandboxCreateOptions\n  ): Promise<SandboxCreateResult> {\n    const template = options?.template ?? this.defaultTemplate;\n    const workspaceBase = this.defaultWorkspaceBase;\n    const createOpts = {\n      envs: options?.env,\n      timeoutMs: options?.timeoutMs ?? this.defaultTimeoutMs,\n    };\n\n    const sdkSandbox = template\n      ? await E2bSdkSandbox.create(template, createOpts)\n      : await E2bSdkSandbox.create(createOpts);\n\n    const sandbox = new E2bSandboxImpl(\n      sdkSandbox.sandboxId,\n      sdkSandbox,\n      workspaceBase\n    );\n\n    if (options?.initialFiles) {\n      await Promise.all(\n        Object.entries(options.initialFiles).map(([path, content]) =>\n          sandbox.fs.writeFile(path, content)\n        )\n      );\n    }\n\n    return { sandbox };\n  }\n\n  async get(sandboxId: string): Promise<E2bSandbox> {\n    try {\n      const sdkSandbox = await E2bSdkSandbox.connect(sandboxId);\n      return new E2bSandboxImpl(sandboxId, sdkSandbox, this.defaultWorkspaceBase);\n    } catch {\n      throw new SandboxNotFoundError(sandboxId);\n    }\n  }\n\n  async destroy(sandboxId: string): Promise<void> {\n    try {\n      const sdkSandbox = await E2bSdkSandbox.connect(sandboxId);\n      await sdkSandbox.kill();\n    } catch {\n      // Already gone or not found\n    }\n  }\n\n  async pause(sandboxId: string, _ttlSeconds?: number): Promise<void> {\n    const sdkSandbox = await E2bSdkSandbox.connect(sandboxId);\n    await sdkSandbox.pause();\n  }\n\n  async snapshot(_sandboxId: string): Promise<SandboxSnapshot> {\n    throw new SandboxNotSupportedError(\"snapshot\");\n  }\n\n  async restore(_snapshot: SandboxSnapshot): Promise<Sandbox> {\n    throw new SandboxNotSupportedError(\"restore\");\n  }\n\n  async fork(sandboxId: string): Promise<Sandbox> {\n    const { snapshotId } = await E2bSdkSandbox.createSnapshot(sandboxId);\n    const sdkSandbox = await E2bSdkSandbox.create(snapshotId);\n    return new E2bSandboxImpl(\n      sdkSandbox.sandboxId,\n      sdkSandbox,\n      this.defaultWorkspaceBase\n    );\n  }\n}\n\n// Re-exports\nexport { E2bSandboxFileSystem } from \"./filesystem\";\nexport type {\n  E2bSandbox,\n  E2bSandboxConfig,\n  E2bSandboxCreateOptions,\n} from \"./types\";\n"]}

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

@@ -0,0 +1,77 @@
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox$1, d as SandboxCreateOptions, b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult, f as SandboxSnapshot } from '../../../types-ChAMwU3q.cjs';
+import { Sandbox } from '@e2b/code-interpreter';
+import '@temporalio/common';
+
+/**
+ * {@link SandboxFileSystem} backed by an E2B SDK sandbox.
+ *
+ * Maps zeitlich's filesystem interface to E2B's `sandbox.files` and
+ * `sandbox.commands` APIs. Operations that have no direct E2B equivalent
+ * (e.g. `appendFile`, `cp`) are composed from primitives.
+ */
+declare class E2bSandboxFileSystem implements SandboxFileSystem {
+    private sandbox;
+    readonly workspaceBase: string;
+    constructor(sandbox: Sandbox, workspaceBase?: string);
+    private normalisePath;
+    readFile(path: string): Promise<string>;
+    readFileBuffer(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    appendFile(path: string, content: string | Uint8Array): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    mkdir(path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    readdirWithFileTypes(path: string): Promise<DirentEntry[]>;
+    rm(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    cp(src: string, dest: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    mv(src: string, dest: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    resolvePath(base: string, path: string): string;
+}
+
+/**
+ * An E2B-backed {@link Sandbox} with its typed filesystem.
+ */
+type E2bSandbox = Sandbox$1 & {
+    fs: E2bSandboxFileSystem;
+};
+interface E2bSandboxConfig {
+    /** Sandbox template name or ID */
+    template?: string;
+    /** Default working directory inside the sandbox */
+    workspaceBase?: string;
+    /** Sandbox idle timeout in milliseconds */
+    timeoutMs?: number;
+}
+interface E2bSandboxCreateOptions extends SandboxCreateOptions {
+    /** Sandbox template name or ID — overrides the provider default */
+    template?: string;
+    /** Sandbox idle timeout in milliseconds — overrides the provider default */
+    timeoutMs?: number;
+}
+
+declare class E2bSandboxProvider implements SandboxProvider<E2bSandboxCreateOptions, E2bSandbox> {
+    readonly id = "e2b";
+    readonly capabilities: SandboxCapabilities;
+    private readonly defaultTemplate?;
+    private readonly defaultWorkspaceBase;
+    private readonly defaultTimeoutMs?;
+    constructor(config?: E2bSandboxConfig);
+    create(options?: E2bSandboxCreateOptions): Promise<SandboxCreateResult>;
+    get(sandboxId: string): Promise<E2bSandbox>;
+    destroy(sandboxId: string): Promise<void>;
+    pause(sandboxId: string, _ttlSeconds?: number): Promise<void>;
+    snapshot(_sandboxId: string): Promise<SandboxSnapshot>;
+    restore(_snapshot: SandboxSnapshot): Promise<Sandbox$1>;
+    fork(sandboxId: string): Promise<Sandbox$1>;
+}
+
+export { type E2bSandbox, type E2bSandboxConfig, type E2bSandboxCreateOptions, E2bSandboxFileSystem, E2bSandboxProvider };

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

@@ -0,0 +1,77 @@
+import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox$1, d as SandboxCreateOptions, b as SandboxProvider, c as SandboxCapabilities, e as SandboxCreateResult, f as SandboxSnapshot } from '../../../types-ChAMwU3q.js';
+import { Sandbox } from '@e2b/code-interpreter';
+import '@temporalio/common';
+
+/**
+ * {@link SandboxFileSystem} backed by an E2B SDK sandbox.
+ *
+ * Maps zeitlich's filesystem interface to E2B's `sandbox.files` and
+ * `sandbox.commands` APIs. Operations that have no direct E2B equivalent
+ * (e.g. `appendFile`, `cp`) are composed from primitives.
+ */
+declare class E2bSandboxFileSystem implements SandboxFileSystem {
+    private sandbox;
+    readonly workspaceBase: string;
+    constructor(sandbox: Sandbox, workspaceBase?: string);
+    private normalisePath;
+    readFile(path: string): Promise<string>;
+    readFileBuffer(path: string): Promise<Uint8Array>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    appendFile(path: string, content: string | Uint8Array): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    mkdir(path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    readdirWithFileTypes(path: string): Promise<DirentEntry[]>;
+    rm(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    cp(src: string, dest: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    mv(src: string, dest: string): Promise<void>;
+    readlink(path: string): Promise<string>;
+    resolvePath(base: string, path: string): string;
+}
+
+/**
+ * An E2B-backed {@link Sandbox} with its typed filesystem.
+ */
+type E2bSandbox = Sandbox$1 & {
+    fs: E2bSandboxFileSystem;
+};
+interface E2bSandboxConfig {
+    /** Sandbox template name or ID */
+    template?: string;
+    /** Default working directory inside the sandbox */
+    workspaceBase?: string;
+    /** Sandbox idle timeout in milliseconds */
+    timeoutMs?: number;
+}
+interface E2bSandboxCreateOptions extends SandboxCreateOptions {
+    /** Sandbox template name or ID — overrides the provider default */
+    template?: string;
+    /** Sandbox idle timeout in milliseconds — overrides the provider default */
+    timeoutMs?: number;
+}
+
+declare class E2bSandboxProvider implements SandboxProvider<E2bSandboxCreateOptions, E2bSandbox> {
+    readonly id = "e2b";
+    readonly capabilities: SandboxCapabilities;
+    private readonly defaultTemplate?;
+    private readonly defaultWorkspaceBase;
+    private readonly defaultTimeoutMs?;
+    constructor(config?: E2bSandboxConfig);
+    create(options?: E2bSandboxCreateOptions): Promise<SandboxCreateResult>;
+    get(sandboxId: string): Promise<E2bSandbox>;
+    destroy(sandboxId: string): Promise<void>;
+    pause(sandboxId: string, _ttlSeconds?: number): Promise<void>;
+    snapshot(_sandboxId: string): Promise<SandboxSnapshot>;
+    restore(_snapshot: SandboxSnapshot): Promise<Sandbox$1>;
+    fork(sandboxId: string): Promise<Sandbox$1>;
+}
+
+export { type E2bSandbox, type E2bSandboxConfig, type E2bSandboxCreateOptions, E2bSandboxFileSystem, E2bSandboxProvider };