zeitlich 0.2.13 → 0.2.14

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

@@ -0,0 +1,202 @@
+import { Daytona } from '@daytonaio/sdk';
+import { ApplicationFailure } from '@temporalio/common';
+import { posix } from 'path';
+
+// src/adapters/sandbox/daytona/index.ts
+var SandboxNotSupportedError = class extends ApplicationFailure {
+  constructor(operation) {
+    super(
+      `Sandbox does not support: ${operation}`,
+      "SandboxNotSupportedError",
+      true
+    );
+  }
+};
+var SandboxNotFoundError = class extends ApplicationFailure {
+  constructor(sandboxId) {
+    super(`Sandbox not found: ${sandboxId}`, "SandboxNotFoundError", true);
+  }
+};
+var DaytonaSandboxFileSystem = class {
+  constructor(sandbox) {
+    this.sandbox = sandbox;
+  }
+  async readFile(path) {
+    const buf = await this.sandbox.fs.downloadFile(path);
+    return buf.toString("utf-8");
+  }
+  async readFileBuffer(path) {
+    const buf = await this.sandbox.fs.downloadFile(path);
+    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+  }
+  async writeFile(path, content) {
+    const buf = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
+    await this.sandbox.fs.uploadFile(buf, path);
+  }
+  async appendFile(path, content) {
+    let existing;
+    try {
+      existing = await this.sandbox.fs.downloadFile(path);
+    } catch {
+      return this.writeFile(path, content);
+    }
+    const addition = typeof content === "string" ? Buffer.from(content, "utf-8") : content;
+    const merged = Buffer.concat([existing, Buffer.from(addition)]);
+    await this.sandbox.fs.uploadFile(merged, path);
+  }
+  async exists(path) {
+    try {
+      await this.sandbox.fs.getFileDetails(path);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async stat(path) {
+    const info = await this.sandbox.fs.getFileDetails(path);
+    return {
+      isFile: !info.isDir,
+      isDirectory: info.isDir,
+      isSymbolicLink: false,
+      size: info.size,
+      mtime: new Date(info.modTime)
+    };
+  }
+  async mkdir(path, _options) {
+    await this.sandbox.fs.createFolder(path, "755");
+  }
+  async readdir(path) {
+    const entries = await this.sandbox.fs.listFiles(path);
+    return entries.map((e) => e.name);
+  }
+  async readdirWithFileTypes(path) {
+    const entries = await this.sandbox.fs.listFiles(path);
+    return entries.map((e) => ({
+      name: e.name,
+      isFile: !e.isDir,
+      isDirectory: e.isDir,
+      isSymbolicLink: false
+    }));
+  }
+  async rm(path, options) {
+    try {
+      await this.sandbox.fs.deleteFile(path, options?.recursive);
+    } catch (err) {
+      if (!options?.force) throw err;
+    }
+  }
+  async cp(src, dest, options) {
+    const info = await this.sandbox.fs.getFileDetails(src);
+    if (info.isDir) {
+      if (!options?.recursive) {
+        throw new Error(`EISDIR: is a directory (use recursive): ${src}`);
+      }
+      await this.sandbox.process.executeCommand(`cp -r "${src}" "${dest}"`);
+    } else {
+      await this.sandbox.process.executeCommand(`cp "${src}" "${dest}"`);
+    }
+  }
+  async mv(src, dest) {
+    await this.sandbox.fs.moveFiles(src, dest);
+  }
+  async readlink(_path) {
+    throw new SandboxNotSupportedError("readlink");
+  }
+  resolvePath(base, path) {
+    if (posix.isAbsolute(path)) return posix.normalize(path);
+    return posix.resolve(base, path);
+  }
+};
+
+// src/adapters/sandbox/daytona/index.ts
+var DaytonaSandboxImpl = class {
+  constructor(id, sdkSandbox) {
+    this.id = id;
+    this.sdkSandbox = sdkSandbox;
+    this.fs = new DaytonaSandboxFileSystem(sdkSandbox);
+  }
+  capabilities = {
+    filesystem: true,
+    execution: true,
+    persistence: false
+  };
+  fs;
+  async exec(command, options) {
+    const response = await this.sdkSandbox.process.executeCommand(
+      command,
+      options?.cwd,
+      options?.env,
+      options?.timeout
+    );
+    return {
+      exitCode: response.exitCode ?? 0,
+      stdout: response.result ?? "",
+      stderr: ""
+    };
+  }
+  async destroy() {
+    await this.sdkSandbox.delete(60);
+  }
+};
+var DaytonaSandboxProvider = class {
+  id = "daytona";
+  capabilities = {
+    filesystem: true,
+    execution: true,
+    persistence: false
+  };
+  client;
+  constructor(config) {
+    this.client = new Daytona(config);
+  }
+  async create(options) {
+    const sdkSandbox = await this.client.create(
+      {
+        language: options?.language,
+        snapshot: options?.snapshot,
+        envVars: options?.env,
+        labels: options?.labels,
+        autoStopInterval: options?.autoStopInterval,
+        autoArchiveInterval: options?.autoArchiveInterval,
+        autoDeleteInterval: options?.autoDeleteInterval
+      },
+      { timeout: options?.timeout ?? 60 }
+    );
+    const sandbox = new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox);
+    if (options?.initialFiles) {
+      for (const [path, content] of Object.entries(options.initialFiles)) {
+        await sandbox.fs.writeFile(path, content);
+      }
+    }
+    return { sandbox };
+  }
+  async get(sandboxId) {
+    try {
+      const sdkSandbox = await this.client.get(sandboxId);
+      return new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox);
+    } catch {
+      throw new SandboxNotFoundError(sandboxId);
+    }
+  }
+  async destroy(sandboxId) {
+    try {
+      const sdkSandbox = await this.client.get(sandboxId);
+      await this.client.delete(sdkSandbox);
+    } catch {
+    }
+  }
+  async snapshot(_sandboxId) {
+    throw new SandboxNotSupportedError(
+      "snapshot (use Daytona's native snapshot API directly)"
+    );
+  }
+  async restore(_snapshot) {
+    throw new SandboxNotSupportedError(
+      "restore (use Daytona's native snapshot API directly)"
+    );
+  }
+};
+
+export { DaytonaSandboxFileSystem, DaytonaSandboxProvider };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/adapters/sandbox/daytona/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/sandbox/types.ts","../../../../src/adapters/sandbox/daytona/filesystem.ts","../../../../src/adapters/sandbox/daytona/index.ts"],"names":[],"mappings":"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","file":"index.js","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 { Sandbox as DaytonaSdkSandbox } from \"@daytonaio/sdk\";\nimport type {\n  SandboxFileSystem,\n  DirentEntry,\n  FileStat,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotSupportedError } from \"../../../lib/sandbox/types\";\nimport { posix } from \"node:path\";\n\n/**\n * {@link SandboxFileSystem} backed by a Daytona SDK sandbox.\n *\n * Maps zeitlich's filesystem interface to Daytona's `sandbox.fs` and\n * `sandbox.process` APIs. Operations that have no direct Daytona equivalent\n * (e.g. `appendFile`, `cp`) are composed from primitives.\n */\nexport class DaytonaSandboxFileSystem implements SandboxFileSystem {\n  constructor(private sandbox: DaytonaSdkSandbox) {}\n\n  async readFile(path: string): Promise<string> {\n    const buf = await this.sandbox.fs.downloadFile(path);\n    return buf.toString(\"utf-8\");\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    const buf = await this.sandbox.fs.downloadFile(path);\n    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n  }\n\n  async writeFile(path: string, content: string | Uint8Array): Promise<void> {\n    const buf =\n      typeof content === \"string\"\n        ? Buffer.from(content, \"utf-8\")\n        : Buffer.from(content);\n    await this.sandbox.fs.uploadFile(buf, path);\n  }\n\n  async appendFile(\n    path: string,\n    content: string | Uint8Array,\n  ): Promise<void> {\n    let existing: Buffer;\n    try {\n      existing = await this.sandbox.fs.downloadFile(path);\n    } catch {\n      return this.writeFile(path, content);\n    }\n\n    const addition =\n      typeof content === \"string\" ? Buffer.from(content, \"utf-8\") : content;\n    const merged = Buffer.concat([existing, Buffer.from(addition)]);\n    await this.sandbox.fs.uploadFile(merged, path);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      await this.sandbox.fs.getFileDetails(path);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const info = await this.sandbox.fs.getFileDetails(path);\n    return {\n      isFile: !info.isDir,\n      isDirectory: info.isDir,\n      isSymbolicLink: false,\n      size: info.size,\n      mtime: new Date(info.modTime),\n    };\n  }\n\n  async mkdir(\n    path: string,\n    _options?: { recursive?: boolean },\n  ): Promise<void> {\n    await this.sandbox.fs.createFolder(path, \"755\");\n  }\n\n  async readdir(path: string): Promise<string[]> {\n    const entries = await this.sandbox.fs.listFiles(path);\n    return entries.map((e) => e.name);\n  }\n\n  async readdirWithFileTypes(path: string): Promise<DirentEntry[]> {\n    const entries = await this.sandbox.fs.listFiles(path);\n    return entries.map((e) => ({\n      name: e.name,\n      isFile: !e.isDir,\n      isDirectory: e.isDir,\n      isSymbolicLink: false,\n    }));\n  }\n\n  async rm(\n    path: string,\n    options?: { recursive?: boolean; force?: boolean },\n  ): Promise<void> {\n    try {\n      await this.sandbox.fs.deleteFile(path, options?.recursive);\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 info = await this.sandbox.fs.getFileDetails(src);\n    if (info.isDir) {\n      if (!options?.recursive) {\n        throw new Error(`EISDIR: is a directory (use recursive): ${src}`);\n      }\n      await this.sandbox.process.executeCommand(`cp -r \"${src}\" \"${dest}\"`);\n    } else {\n      await this.sandbox.process.executeCommand(`cp \"${src}\" \"${dest}\"`);\n    }\n  }\n\n  async mv(src: string, dest: string): Promise<void> {\n    await this.sandbox.fs.moveFiles(src, dest);\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 (posix.isAbsolute(path)) return posix.normalize(path);\n    return posix.resolve(base, path);\n  }\n}\n","import {\n  Daytona,\n  type Sandbox as DaytonaSdkSandbox,\n} from \"@daytonaio/sdk\";\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 { DaytonaSandboxFileSystem } from \"./filesystem\";\nimport type {\n  DaytonaSandbox,\n  DaytonaSandboxConfig,\n  DaytonaSandboxCreateOptions,\n} from \"./types\";\n\n// ============================================================================\n// DaytonaSandbox\n// ============================================================================\n\nclass DaytonaSandboxImpl implements Sandbox {\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: true,\n    persistence: false,\n  };\n\n  readonly fs: DaytonaSandboxFileSystem;\n\n  constructor(\n    readonly id: string,\n    private sdkSandbox: DaytonaSdkSandbox,\n  ) {\n    this.fs = new DaytonaSandboxFileSystem(sdkSandbox);\n  }\n\n  async exec(command: string, options?: ExecOptions): Promise<ExecResult> {\n    const response = await this.sdkSandbox.process.executeCommand(\n      command,\n      options?.cwd,\n      options?.env,\n      options?.timeout,\n    );\n\n    return {\n      exitCode: response.exitCode ?? 0,\n      stdout: response.result ?? \"\",\n      stderr: \"\",\n    };\n  }\n\n  async destroy(): Promise<void> {\n    await this.sdkSandbox.delete(60);\n  }\n}\n\n// ============================================================================\n// DaytonaSandboxProvider\n// ============================================================================\n\nexport class DaytonaSandboxProvider\n  implements SandboxProvider<DaytonaSandboxCreateOptions, DaytonaSandbox>\n{\n  readonly id = \"daytona\";\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: true,\n    persistence: false,\n  };\n\n  private client: Daytona;\n\n  constructor(config?: DaytonaSandboxConfig) {\n    this.client = new Daytona(config);\n  }\n\n  async create(\n    options?: DaytonaSandboxCreateOptions,\n  ): Promise<SandboxCreateResult> {\n    const sdkSandbox = await this.client.create(\n      {\n        language: options?.language,\n        snapshot: options?.snapshot,\n        envVars: options?.env,\n        labels: options?.labels,\n        autoStopInterval: options?.autoStopInterval,\n        autoArchiveInterval: options?.autoArchiveInterval,\n        autoDeleteInterval: options?.autoDeleteInterval,\n      },\n      { timeout: options?.timeout ?? 60 },\n    );\n\n    const sandbox = new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox);\n\n    if (options?.initialFiles) {\n      for (const [path, content] of Object.entries(options.initialFiles)) {\n        await sandbox.fs.writeFile(path, content);\n      }\n    }\n\n    return { sandbox };\n  }\n\n  async get(sandboxId: string): Promise<DaytonaSandbox> {\n    try {\n      const sdkSandbox = await this.client.get(sandboxId);\n      return new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox);\n    } catch {\n      throw new SandboxNotFoundError(sandboxId);\n    }\n  }\n\n  async destroy(sandboxId: string): Promise<void> {\n    try {\n      const sdkSandbox = await this.client.get(sandboxId);\n      await this.client.delete(sdkSandbox);\n    } catch {\n      // Already gone\n    }\n  }\n\n  async snapshot(_sandboxId: string): Promise<SandboxSnapshot> {\n    throw new SandboxNotSupportedError(\n      \"snapshot (use Daytona's native snapshot API directly)\",\n    );\n  }\n\n  async restore(_snapshot: SandboxSnapshot): Promise<never> {\n    throw new SandboxNotSupportedError(\n      \"restore (use Daytona's native snapshot API directly)\",\n    );\n  }\n}\n\n// Re-exports\nexport { DaytonaSandboxFileSystem } from \"./filesystem\";\nexport type {\n  DaytonaSandbox,\n  DaytonaSandboxConfig,\n  DaytonaSandboxCreateOptions,\n} from \"./types\";\n"]}

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

@@ -0,0 +1,174 @@
+'use strict';
+
+var justBash = require('just-bash');
+var common = require('@temporalio/common');
+var workflow = require('@temporalio/workflow');
+
+// src/adapters/sandbox/inmemory/index.ts
+var SandboxNotFoundError = class extends common.ApplicationFailure {
+  constructor(sandboxId) {
+    super(`Sandbox not found: ${sandboxId}`, "SandboxNotFoundError", true);
+  }
+};
+var BASE62 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+function getShortId(length = 12) {
+  const hex = workflow.uuid4().replace(/-/g, "");
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    const byte = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    result += BASE62[byte % BASE62.length];
+  }
+  return result;
+}
+
+// src/adapters/sandbox/inmemory/index.ts
+function toSandboxFs(fs) {
+  return {
+    readFile: (path) => fs.readFile(path),
+    readFileBuffer: (path) => fs.readFileBuffer(path),
+    writeFile: (path, content) => fs.writeFile(path, content),
+    appendFile: (path, content) => fs.appendFile(path, content),
+    exists: (path) => fs.exists(path),
+    stat: async (path) => {
+      const s = await fs.stat(path);
+      return {
+        isFile: s.isFile,
+        isDirectory: s.isDirectory,
+        isSymbolicLink: s.isSymbolicLink,
+        size: s.size,
+        mtime: s.mtime
+      };
+    },
+    mkdir: (path, opts) => fs.mkdir(path, opts),
+    readdir: (path) => fs.readdir(path),
+    readdirWithFileTypes: async (path) => {
+      if (!fs.readdirWithFileTypes) {
+        const names = await fs.readdir(path);
+        return Promise.all(
+          names.map(async (name) => {
+            const s = await fs.stat(`${path}/${name}`);
+            return {
+              name,
+              isFile: s.isFile,
+              isDirectory: s.isDirectory,
+              isSymbolicLink: s.isSymbolicLink
+            };
+          })
+        );
+      }
+      return fs.readdirWithFileTypes(path);
+    },
+    rm: (path, opts) => fs.rm(path, opts),
+    cp: (src, dest, opts) => fs.cp(src, dest, opts),
+    mv: (src, dest) => fs.mv(src, dest),
+    readlink: (path) => fs.readlink(path),
+    resolvePath: (base, p) => fs.resolvePath(base, p)
+  };
+}
+var InMemorySandboxImpl = class {
+  constructor(id, justBashFs, options) {
+    this.id = id;
+    this.justBashFs = justBashFs;
+    this.fs = toSandboxFs(justBashFs);
+    this.bashOptions = {
+      executionLimits: { maxStringLength: 52428800 },
+      ...options?.bashOptions
+    };
+  }
+  capabilities = {
+    filesystem: true,
+    execution: true,
+    persistence: true
+  };
+  fs;
+  bashOptions;
+  async exec(command, _options) {
+    const bash = new justBash.Bash({ ...this.bashOptions, fs: this.justBashFs });
+    const { exitCode, stderr, stdout } = await bash.exec(command);
+    return { exitCode, stdout, stderr };
+  }
+  async destroy() {
+  }
+  /** Expose the underlying IFileSystem for snapshot serialisation */
+  _getJustBashFs() {
+    return this.justBashFs;
+  }
+};
+var InMemorySandboxProvider = class {
+  constructor(defaultOptions) {
+    this.defaultOptions = defaultOptions;
+  }
+  id = "inmemory";
+  capabilities = {
+    filesystem: true,
+    execution: true,
+    persistence: true
+  };
+  sandboxes = /* @__PURE__ */ new Map();
+  async get(id) {
+    const sandbox = this.sandboxes.get(id);
+    if (!sandbox) throw new SandboxNotFoundError(id);
+    return sandbox;
+  }
+  async destroy(id) {
+    const sandbox = this.sandboxes.get(id);
+    if (sandbox) {
+      await sandbox.destroy();
+      this.sandboxes.delete(id);
+    }
+  }
+  async create(options) {
+    const id = options?.id ?? getShortId();
+    const initialFiles = {};
+    if (options?.initialFiles) {
+      for (const [path, content] of Object.entries(options.initialFiles)) {
+        initialFiles[path] = content;
+      }
+    }
+    const fs = new justBash.InMemoryFs(initialFiles);
+    const sandbox = new InMemorySandboxImpl(id, fs, this.defaultOptions);
+    this.sandboxes.set(id, sandbox);
+    return { sandbox };
+  }
+  async snapshot(sandboxId) {
+    const sandbox = this.sandboxes.get(sandboxId);
+    if (!sandbox) throw new SandboxNotFoundError(sandboxId);
+    const fs = sandbox._getJustBashFs();
+    const paths = fs.getAllPaths();
+    const files = {};
+    for (const p of paths) {
+      try {
+        const stat = await fs.stat(p);
+        if (stat.isFile) {
+          files[p] = await fs.readFile(p);
+        }
+      } catch {
+      }
+    }
+    return {
+      sandboxId,
+      providerId: this.id,
+      data: { files },
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  async restore(snapshot) {
+    const { files } = snapshot.data;
+    const initialFiles = {};
+    for (const [path, content] of Object.entries(files)) {
+      initialFiles[path] = content;
+    }
+    const fs = new justBash.InMemoryFs(initialFiles);
+    const sandbox = new InMemorySandboxImpl(
+      snapshot.sandboxId,
+      fs,
+      this.defaultOptions
+    );
+    this.sandboxes.set(sandbox.id, sandbox);
+    return sandbox;
+  }
+};
+
+exports.InMemorySandboxProvider = InMemorySandboxProvider;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/sandbox/types.ts","../../../../src/lib/thread/id.ts","../../../../src/adapters/sandbox/inmemory/index.ts"],"names":["ApplicationFailure","uuid4","Bash","InMemoryFs"],"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 { 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 {\n  Bash,\n  InMemoryFs,\n  type BashOptions,\n  type IFileSystem,\n  type InitialFiles,\n} from \"just-bash\";\nimport type {\n  Sandbox,\n  SandboxCapabilities,\n  SandboxCreateOptions,\n  SandboxCreateResult,\n  SandboxFileSystem,\n  SandboxProvider,\n  SandboxSnapshot,\n  ExecOptions,\n  ExecResult,\n  DirentEntry,\n  FileStat,\n} from \"../../../lib/sandbox/types\";\nimport { SandboxNotFoundError } from \"../../../lib/sandbox/types\";\nimport { getShortId } from \"../../../lib/thread/id\";\n\n// ============================================================================\n// Adapter: IFileSystem → SandboxFileSystem\n// ============================================================================\n\nfunction toSandboxFs(fs: IFileSystem): SandboxFileSystem {\n  return {\n    readFile: (path) => fs.readFile(path),\n    readFileBuffer: (path) => fs.readFileBuffer(path),\n    writeFile: (path, content) => fs.writeFile(path, content),\n    appendFile: (path, content) => fs.appendFile(path, content),\n    exists: (path) => fs.exists(path),\n    stat: async (path): Promise<FileStat> => {\n      const s = await fs.stat(path);\n      return {\n        isFile: s.isFile,\n        isDirectory: s.isDirectory,\n        isSymbolicLink: s.isSymbolicLink,\n        size: s.size,\n        mtime: s.mtime,\n      };\n    },\n    mkdir: (path, opts) => fs.mkdir(path, opts),\n    readdir: (path) => fs.readdir(path),\n    readdirWithFileTypes: async (path): Promise<DirentEntry[]> => {\n      if (!fs.readdirWithFileTypes) {\n        const names = await fs.readdir(path);\n        return Promise.all(\n          names.map(async (name) => {\n            const s = await fs.stat(`${path}/${name}`);\n            return {\n              name,\n              isFile: s.isFile,\n              isDirectory: s.isDirectory,\n              isSymbolicLink: s.isSymbolicLink,\n            };\n          })\n        );\n      }\n      return fs.readdirWithFileTypes(path);\n    },\n    rm: (path, opts) => fs.rm(path, opts),\n    cp: (src, dest, opts) => fs.cp(src, dest, opts),\n    mv: (src, dest) => fs.mv(src, dest),\n    readlink: (path) => fs.readlink(path),\n    resolvePath: (base, p) => fs.resolvePath(base, p),\n  };\n}\n\n// ============================================================================\n// InMemorySandbox\n// ============================================================================\n\nexport interface InMemorySandboxOptions {\n  /** Options forwarded to `just-bash` `Bash` (minus `fs` which is managed) */\n  bashOptions?: Omit<BashOptions, \"fs\">;\n}\n\n/**\n * An in-memory {@link Sandbox} backed by `just-bash`.\n */\nexport type InMemorySandbox = Sandbox & { fs: SandboxFileSystem };\n\nclass InMemorySandboxImpl implements Sandbox {\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: true,\n    persistence: true,\n  };\n\n  readonly fs: SandboxFileSystem;\n  private bashOptions: Omit<BashOptions, \"fs\">;\n\n  constructor(\n    readonly id: string,\n    private justBashFs: IFileSystem,\n    options?: InMemorySandboxOptions\n  ) {\n    this.fs = toSandboxFs(justBashFs);\n    this.bashOptions = {\n      executionLimits: { maxStringLength: 52_428_800 },\n      ...options?.bashOptions,\n    };\n  }\n\n  async exec(command: string, _options?: ExecOptions): Promise<ExecResult> {\n    const bash = new Bash({ ...this.bashOptions, fs: this.justBashFs });\n    const { exitCode, stderr, stdout } = await bash.exec(command);\n    return { exitCode, stdout, stderr };\n  }\n\n  async destroy(): Promise<void> {\n    // In-memory: nothing to clean up\n  }\n\n  /** Expose the underlying IFileSystem for snapshot serialisation */\n  _getJustBashFs(): IFileSystem {\n    return this.justBashFs;\n  }\n}\n\n// ============================================================================\n// InMemorySandboxProvider\n// ============================================================================\n\nexport class InMemorySandboxProvider implements SandboxProvider {\n  readonly id = \"inmemory\";\n  readonly capabilities: SandboxCapabilities = {\n    filesystem: true,\n    execution: true,\n    persistence: true,\n  };\n\n  private sandboxes = new Map<string, InMemorySandboxImpl>();\n\n  constructor(private defaultOptions?: InMemorySandboxOptions) {}\n\n  async get(id: string): Promise<Sandbox> {\n    const sandbox = this.sandboxes.get(id);\n    if (!sandbox) throw new SandboxNotFoundError(id);\n    return sandbox;\n  }\n\n  async destroy(id: string): Promise<void> {\n    const sandbox = this.sandboxes.get(id);\n    if (sandbox) {\n      await sandbox.destroy();\n      this.sandboxes.delete(id);\n    }\n  }\n\n  async create(options?: SandboxCreateOptions): Promise<SandboxCreateResult> {\n    const id = options?.id ?? getShortId();\n    const initialFiles: InitialFiles = {};\n\n    if (options?.initialFiles) {\n      for (const [path, content] of Object.entries(options.initialFiles)) {\n        initialFiles[path] = content;\n      }\n    }\n\n    const fs = new InMemoryFs(initialFiles);\n    const sandbox = new InMemorySandboxImpl(id, fs, this.defaultOptions);\n    this.sandboxes.set(id, sandbox);\n    return { sandbox };\n  }\n\n  async snapshot(sandboxId: string): Promise<SandboxSnapshot> {\n    const sandbox = this.sandboxes.get(sandboxId);\n    if (!sandbox) throw new SandboxNotFoundError(sandboxId);\n\n    const fs = sandbox._getJustBashFs();\n    const paths = fs.getAllPaths();\n    const files: Record<string, string> = {};\n\n    for (const p of paths) {\n      try {\n        const stat = await fs.stat(p);\n        if (stat.isFile) {\n          files[p] = await fs.readFile(p);\n        }\n      } catch {\n        // skip entries that can't be read (e.g. broken symlinks)\n      }\n    }\n\n    return {\n      sandboxId,\n      providerId: this.id,\n      data: { files },\n      createdAt: new Date().toISOString(),\n    };\n  }\n\n  async restore(snapshot: SandboxSnapshot): Promise<Sandbox> {\n    const { files } = snapshot.data as { files: Record<string, string> };\n    const initialFiles: InitialFiles = {};\n    for (const [path, content] of Object.entries(files)) {\n      initialFiles[path] = content;\n    }\n\n    const fs = new InMemoryFs(initialFiles);\n    const sandbox = new InMemorySandboxImpl(\n      snapshot.sandboxId,\n      fs,\n      this.defaultOptions\n    );\n    this.sandboxes.set(sandbox.id, sandbox);\n    return sandbox;\n  }\n}\n"]}

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

@@ -0,0 +1,28 @@
+import { BashOptions } from 'just-bash';
+import { S as Sandbox, a as SandboxFileSystem, b as SandboxProvider, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, f as SandboxSnapshot } from '../../../types-CDubRtad.cjs';
+import '@temporalio/common';
+
+interface InMemorySandboxOptions {
+    /** Options forwarded to `just-bash` `Bash` (minus `fs` which is managed) */
+    bashOptions?: Omit<BashOptions, "fs">;
+}
+/**
+ * An in-memory {@link Sandbox} backed by `just-bash`.
+ */
+type InMemorySandbox = Sandbox & {
+    fs: SandboxFileSystem;
+};
+declare class InMemorySandboxProvider implements SandboxProvider {
+    private defaultOptions?;
+    readonly id = "inmemory";
+    readonly capabilities: SandboxCapabilities;
+    private sandboxes;
+    constructor(defaultOptions?: InMemorySandboxOptions | undefined);
+    get(id: string): Promise<Sandbox>;
+    destroy(id: string): Promise<void>;
+    create(options?: SandboxCreateOptions): Promise<SandboxCreateResult>;
+    snapshot(sandboxId: string): Promise<SandboxSnapshot>;
+    restore(snapshot: SandboxSnapshot): Promise<Sandbox>;
+}
+
+export { type InMemorySandbox, type InMemorySandboxOptions, InMemorySandboxProvider };

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

@@ -0,0 +1,28 @@
+import { BashOptions } from 'just-bash';
+import { S as Sandbox, a as SandboxFileSystem, b as SandboxProvider, c as SandboxCapabilities, d as SandboxCreateOptions, e as SandboxCreateResult, f as SandboxSnapshot } from '../../../types-CDubRtad.js';
+import '@temporalio/common';
+
+interface InMemorySandboxOptions {
+    /** Options forwarded to `just-bash` `Bash` (minus `fs` which is managed) */
+    bashOptions?: Omit<BashOptions, "fs">;
+}
+/**
+ * An in-memory {@link Sandbox} backed by `just-bash`.
+ */
+type InMemorySandbox = Sandbox & {
+    fs: SandboxFileSystem;
+};
+declare class InMemorySandboxProvider implements SandboxProvider {
+    private defaultOptions?;
+    readonly id = "inmemory";
+    readonly capabilities: SandboxCapabilities;
+    private sandboxes;
+    constructor(defaultOptions?: InMemorySandboxOptions | undefined);
+    get(id: string): Promise<Sandbox>;
+    destroy(id: string): Promise<void>;
+    create(options?: SandboxCreateOptions): Promise<SandboxCreateResult>;
+    snapshot(sandboxId: string): Promise<SandboxSnapshot>;
+    restore(snapshot: SandboxSnapshot): Promise<Sandbox>;
+}
+
+export { type InMemorySandbox, type InMemorySandboxOptions, InMemorySandboxProvider };