zeitlich 0.2.13 → 0.2.14

package/README.md

@@ -35,7 +35,7 @@ Temporal solves these problems for workflows. Zeitlich brings these guarantees t
 
 Zeitlich's core is framework-agnostic — it defines generic interfaces (`ModelInvoker`, `ThreadOps`, `MessageContent`) that work with any LLM SDK. Concrete implementations are provided via adapter packages.
 
-### LangChain Adapter (`zeitlich/adapters/langchain`)
+### LangChain Adapter (`zeitlich/adapters/thread/langchain`)
 
 The built-in LangChain adapter gives you:
 
@@ -45,7 +45,7 @@ The built-in LangChain adapter gives you:
 
 ```typescript
 import { ChatAnthropic } from "@langchain/anthropic";
-import { createLangChainAdapter } from "zeitlich/adapters/langchain";
+import { createLangChainAdapter } from "zeitlich/adapters/thread/langchain";
 import { createRunAgentActivity } from "zeitlich";
 
 const adapter = createLangChainAdapter({
@@ -78,7 +78,7 @@ npm install zeitlich ioredis
 **Peer dependencies:**
 
 - `ioredis` >= 5.0.0
-- `@langchain/core` >= 1.0.0 (optional — only needed when using `zeitlich/adapters/langchain`)
+- `@langchain/core` >= 1.0.0 (optional — only needed when using `zeitlich/adapters/thread/langchain`)
 
 **Required infrastructure:**
 
@@ -104,20 +104,22 @@ import {
 // In activity files and worker setup — framework-agnostic core
 import {
   createRunAgentActivity,
-  createBashHandler,
+  withParentWorkflowState,
+  withSandbox,
+  bashHandler,
   createAskUserQuestionHandler,
   toTree,
 } from "zeitlich";
 
 // LangChain adapter — unified adapter for LLM invocation and thread management
-import { createLangChainAdapter } from "zeitlich/adapters/langchain";
+import { createLangChainAdapter } from "zeitlich/adapters/thread/langchain";
 ```
 
 **Why three entry points?**
 
 - `zeitlich/workflow` — Pure TypeScript, safe for Temporal's V8 sandbox
 - `zeitlich` — Activity-side utilities (Redis, filesystem), framework-agnostic
-- `zeitlich/adapters/langchain` — LangChain-specific adapter (model invocation + thread management)
+- `zeitlich/adapters/thread/langchain` — LangChain-specific adapter (model invocation + thread management)
 
 ## Examples
 
@@ -223,11 +225,12 @@ import type Redis from "ioredis";
 import type { WorkflowClient } from "@temporalio/client";
 import { ChatAnthropic } from "@langchain/anthropic";
 import {
-  createBashHandler,
+  withSandbox,
+  bashHandler,
   createAskUserQuestionHandler,
   createRunAgentActivity,
 } from "zeitlich";
-import { createLangChainAdapter } from "zeitlich/adapters/langchain";
+import { createLangChainAdapter } from "zeitlich/adapters/thread/langchain";
 
 export const createActivities = ({
   redis,
@@ -251,7 +254,7 @@ export const createActivities = ({
       toolResponse: JSON.stringify(await performSearch(args.query)),
       data: null,
     }),
-    bashHandlerActivity: createBashHandler({ fs: inMemoryFileSystem }),
+    bashHandlerActivity: withSandbox(sandboxManager, bashHandler),
     askUserQuestionHandlerActivity: createAskUserQuestionHandler(),
   };
 };
@@ -521,20 +524,24 @@ const session = await createSession({
 });
 ```
 
-For file operations, use the built-in tool handler factories. All handlers accept an `IFileSystem`:
+For file operations, use the built-in tool handlers wrapped with `withSandbox`:
 
 ```typescript
 import {
-  createGlobHandler,
-  createEditHandler,
-  createBashHandler,
+  SandboxManager,
+  withSandbox,
+  globHandler,
+  editHandler,
+  bashHandler,
 } from "zeitlich";
 
+const sandboxManager = new SandboxManager(provider);
+
 export const createActivities = ({ redis, client }) => ({
-  generateFileTreeActivity: async () => toTree(inMemoryFileSystem),
-  globHandlerActivity: createGlobHandler(inMemoryFileSystem),
-  editHandlerActivity: createEditHandler(inMemoryFileSystem),
-  bashHandlerActivity: createBashHandler({ fs: inMemoryFileSystem }),
+  ...sandboxManager.createActivities(),
+  globHandlerActivity: withSandbox(sandboxManager, globHandler),
+  editHandlerActivity: withSandbox(sandboxManager, editHandler),
+  bashHandlerActivity: withSandbox(sandboxManager, bashHandler),
 });
 ```
 
@@ -565,11 +572,12 @@ import {
   askUserQuestionTool,
 } from "zeitlich/workflow";
 
-// Import handler factories in activities
+// Import handlers + wrapper in activities
 import {
-  createEditHandler,
-  createGlobHandler,
-  createBashHandler,
+  withSandbox,
+  editHandler,
+  globHandler,
+  bashHandler,
   createAskUserQuestionHandler,
 } from "zeitlich";
 ```
@@ -598,18 +606,17 @@ const session = await createSession({
 
 Safe for use in Temporal workflow files:
 
-| Export                    | Description                                                                                            |
-| ------------------------- | ------------------------------------------------------------------------------------------------------ |
-| `createSession`           | Creates an agent session with tools, prompts, subagents, and hooks                                     |
-| `createAgentStateManager` | Creates a state manager for workflow state with query/update handlers                                  |
-| `createToolRouter`        | Creates a tool router (used internally by session, or for advanced use)                                |
-| `defineTool`              | Identity function for type-safe tool definition with handler and hooks                                 |
-| `defineSubagent`          | Identity function for type-safe subagent configuration                                                 |
-| `getShortId`              | Generate a compact, workflow-deterministic identifier (base-62, 12 chars)                              |
-| `createSubagentTool`      | Creates the Subagent tool for spawning child workflows                                                 |
-| Tool definitions          | `askUserQuestionTool`, `globTool`, `grepTool`, `readFileTool`, `writeFileTool`, `editTool`, `bashTool` |
-| Task tools                | `taskCreateTool`, `taskGetTool`, `taskListTool`, `taskUpdateTool` for workflow task management         |
-| Types                     | `SubagentWorkflow`, `ToolDefinition`, `ToolWithHandler`, `AgentConfig`, `SessionConfig`, etc.          |
+| Export                      | Description                                                                                            |
+| --------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `createSession`             | Creates an agent session with tools, prompts, subagents, and hooks                                     |
+| `createAgentStateManager`   | Creates a state manager for workflow state with query/update handlers                                  |
+| `createToolRouter`          | Creates a tool router (used internally by session, or for advanced use)                                |
+| `defineTool`                | Identity function for type-safe tool definition with handler and hooks                                 |
+| `defineSubagent`            | Identity function for type-safe subagent configuration                                                 |
+| `getShortId`                | Generate a compact, workflow-deterministic identifier (base-62, 12 chars)                              |
+| Tool definitions            | `askUserQuestionTool`, `globTool`, `grepTool`, `readFileTool`, `writeFileTool`, `editTool`, `bashTool` |
+| Task tools                  | `taskCreateTool`, `taskGetTool`, `taskListTool`, `taskUpdateTool` for workflow task management         |
+| Types                       | `SubagentWorkflow`, `ToolDefinition`, `ToolWithHandler`, `RouterContext`, `SessionConfig`, etc.        |
 
 ### Activity Entry Point (`zeitlich`)
 
@@ -617,12 +624,14 @@ Framework-agnostic utilities for activities, worker setup, and Node.js code:
 
 | Export                    | Description                                                                                   |
 | ------------------------- | --------------------------------------------------------------------------------------------- |
-| `createRunAgentActivity`  | Wraps a `ModelInvoker` into a `RunAgentActivity` with automatic tool loading                  |
+| `createRunAgentActivity`  | Wraps a handler into a `RunAgentActivity` with auto-fetched parent workflow state             |
+| `withParentWorkflowState`  | Wraps a tool handler into an `ActivityToolHandler` with auto-fetched parent workflow state    |
 | `createThreadManager`     | Generic Redis-backed thread manager factory                                                   |
 | `toTree`                  | Generate file tree string from an `IFileSystem` instance                                      |
-| Tool handlers             | `createGlobHandler`, `createEditHandler`, `createBashHandler`, `createAskUserQuestionHandler` |
+| `withSandbox`             | Wraps a handler to auto-resolve sandbox from context (pairs with `withAutoAppend`)            |
+| Tool handlers             | `bashHandler`, `editHandler`, `globHandler`, `readFileHandler`, `writeFileHandler`, `createAskUserQuestionHandler` |
 
-### LangChain Adapter Entry Point (`zeitlich/adapters/langchain`)
+### LangChain Adapter Entry Point (`zeitlich/adapters/thread/langchain`)
 
 LangChain-specific implementations:
 
@@ -644,8 +653,10 @@ LangChain-specific implementations:
 | `ModelInvokerConfig`    | Configuration passed to a model invoker                                      |
 | `ToolDefinition`        | Tool definition with name, description, and Zod schema                       |
 | `ToolWithHandler`       | Tool definition combined with its handler                                    |
+| `RouterContext`          | Base context every tool handler receives (`threadId`, `toolCallId`, `toolName`, `sandboxId?`) |
+| `Hooks`                 | Combined session lifecycle + tool execution hooks                            |
+| `ToolRouterHooks`       | Narrowed hook interface for tool execution only (pre/post/failure)            |
 | `SubagentConfig`        | Configuration for subagent workflows                                         |
-| `SessionLifecycleHooks` | Lifecycle hooks interface                                                    |
 | `AgentState`            | Generic agent state type                                                     |
 
 ## Architecture
@@ -671,7 +682,7 @@ LangChain-specific implementations:
 │  └──────────────────────────────────────────────────────────┘  │
 │                              │                                  │
 │  ┌──────────────────────────────────────────────────────────┐  │
-│  │       LLM Adapter (zeitlich/adapters/langchain)           │  │
+│  │       LLM Adapter (zeitlich/adapters/thread/langchain)           │  │
 │  │  • createLangChainAdapter (thread ops + model invoker)    │  │
 │  │  • createLangChainThreadManager (message helpers)         │  │
 │  └──────────────────────────────────────────────────────────┘  │

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

@@ -0,0 +1,205 @@
+'use strict';
+
+var sdk = require('@daytonaio/sdk');
+var common = require('@temporalio/common');
+var path = require('path');
+
+// src/adapters/sandbox/daytona/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);
+  }
+};
+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$1) {
+    if (path.posix.isAbsolute(path$1)) return path.posix.normalize(path$1);
+    return path.posix.resolve(base, path$1);
+  }
+};
+
+// 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 sdk.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)"
+    );
+  }
+};
+
+exports.DaytonaSandboxFileSystem = DaytonaSandboxFileSystem;
+exports.DaytonaSandboxProvider = DaytonaSandboxProvider;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/adapters/sandbox/daytona/index.cjs.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":["ApplicationFailure","path","posix","Daytona"],"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 { 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/daytona/index.d.cts

@@ -0,0 +1,86 @@
+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-CDubRtad.cjs';
+import { Sandbox } from '@daytonaio/sdk';
+import '@temporalio/common';
+
+/**
+ * {@link SandboxFileSystem} backed by a Daytona SDK sandbox.
+ *
+ * Maps zeitlich's filesystem interface to Daytona's `sandbox.fs` and
+ * `sandbox.process` APIs. Operations that have no direct Daytona equivalent
+ * (e.g. `appendFile`, `cp`) are composed from primitives.
+ */
+declare class DaytonaSandboxFileSystem implements SandboxFileSystem {
+    private sandbox;
+    constructor(sandbox: Sandbox);
+    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;
+}
+
+/**
+ * A Daytona-backed {@link Sandbox} with its typed filesystem.
+ */
+type DaytonaSandbox = Sandbox$1 & {
+    fs: DaytonaSandboxFileSystem;
+};
+interface DaytonaSandboxConfig {
+    apiKey?: string;
+    apiUrl?: string;
+    target?: string;
+}
+interface DaytonaSandboxCreateOptions extends SandboxCreateOptions {
+    /** Programming language runtime. Defaults to "python". */
+    language?: string;
+    /** Daytona snapshot name to create the sandbox from. */
+    snapshot?: string;
+    /** Custom Docker image to use. */
+    image?: string;
+    /** Resource allocation. */
+    resources?: {
+        cpu?: number;
+        memory?: number;
+        disk?: number;
+    };
+    /** Auto-stop interval in minutes (0 = disabled). Default 15. */
+    autoStopInterval?: number;
+    /** Auto-archive interval in minutes (0 = max interval). Default 7 days. */
+    autoArchiveInterval?: number;
+    /** Auto-delete interval in minutes (negative = disabled). */
+    autoDeleteInterval?: number;
+    /** Custom labels for the sandbox. */
+    labels?: Record<string, string>;
+    /** Timeout in seconds for sandbox creation. Default 60. */
+    timeout?: number;
+}
+
+declare class DaytonaSandboxProvider implements SandboxProvider<DaytonaSandboxCreateOptions, DaytonaSandbox> {
+    readonly id = "daytona";
+    readonly capabilities: SandboxCapabilities;
+    private client;
+    constructor(config?: DaytonaSandboxConfig);
+    create(options?: DaytonaSandboxCreateOptions): Promise<SandboxCreateResult>;
+    get(sandboxId: string): Promise<DaytonaSandbox>;
+    destroy(sandboxId: string): Promise<void>;
+    snapshot(_sandboxId: string): Promise<SandboxSnapshot>;
+    restore(_snapshot: SandboxSnapshot): Promise<never>;
+}
+
+export { type DaytonaSandbox, type DaytonaSandboxConfig, type DaytonaSandboxCreateOptions, DaytonaSandboxFileSystem, DaytonaSandboxProvider };

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

@@ -0,0 +1,86 @@
+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-CDubRtad.js';
+import { Sandbox } from '@daytonaio/sdk';
+import '@temporalio/common';
+
+/**
+ * {@link SandboxFileSystem} backed by a Daytona SDK sandbox.
+ *
+ * Maps zeitlich's filesystem interface to Daytona's `sandbox.fs` and
+ * `sandbox.process` APIs. Operations that have no direct Daytona equivalent
+ * (e.g. `appendFile`, `cp`) are composed from primitives.
+ */
+declare class DaytonaSandboxFileSystem implements SandboxFileSystem {
+    private sandbox;
+    constructor(sandbox: Sandbox);
+    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;
+}
+
+/**
+ * A Daytona-backed {@link Sandbox} with its typed filesystem.
+ */
+type DaytonaSandbox = Sandbox$1 & {
+    fs: DaytonaSandboxFileSystem;
+};
+interface DaytonaSandboxConfig {
+    apiKey?: string;
+    apiUrl?: string;
+    target?: string;
+}
+interface DaytonaSandboxCreateOptions extends SandboxCreateOptions {
+    /** Programming language runtime. Defaults to "python". */
+    language?: string;
+    /** Daytona snapshot name to create the sandbox from. */
+    snapshot?: string;
+    /** Custom Docker image to use. */
+    image?: string;
+    /** Resource allocation. */
+    resources?: {
+        cpu?: number;
+        memory?: number;
+        disk?: number;
+    };
+    /** Auto-stop interval in minutes (0 = disabled). Default 15. */
+    autoStopInterval?: number;
+    /** Auto-archive interval in minutes (0 = max interval). Default 7 days. */
+    autoArchiveInterval?: number;
+    /** Auto-delete interval in minutes (negative = disabled). */
+    autoDeleteInterval?: number;
+    /** Custom labels for the sandbox. */
+    labels?: Record<string, string>;
+    /** Timeout in seconds for sandbox creation. Default 60. */
+    timeout?: number;
+}
+
+declare class DaytonaSandboxProvider implements SandboxProvider<DaytonaSandboxCreateOptions, DaytonaSandbox> {
+    readonly id = "daytona";
+    readonly capabilities: SandboxCapabilities;
+    private client;
+    constructor(config?: DaytonaSandboxConfig);
+    create(options?: DaytonaSandboxCreateOptions): Promise<SandboxCreateResult>;
+    get(sandboxId: string): Promise<DaytonaSandbox>;
+    destroy(sandboxId: string): Promise<void>;
+    snapshot(_sandboxId: string): Promise<SandboxSnapshot>;
+    restore(_snapshot: SandboxSnapshot): Promise<never>;
+}
+
+export { type DaytonaSandbox, type DaytonaSandboxConfig, type DaytonaSandboxCreateOptions, DaytonaSandboxFileSystem, DaytonaSandboxProvider };