zeitlich 0.2.22 → 0.2.23

package/README.md

@@ -28,20 +28,41 @@ Temporal solves these problems for workflows. Zeitlich brings these guarantees t
 - **Type-safe tools** — Define tools with Zod schemas, get full TypeScript inference
 - **Lifecycle hooks** — Pre/post tool execution, session start/end
 - **Subagent support** — Spawn child agents as Temporal child workflows
+- **Skills** — First-class [agentskills.io](https://agentskills.io) support with progressive disclosure
 - **Filesystem utilities** — In-memory or custom providers for file operations
-- **Model flexibility** — Framework-agnostic model invocation with adapters for LangChain (and more coming)
+- **Model flexibility** — Framework-agnostic model invocation with adapters for LangChain, Vercel AI SDK, or provider-specific SDKs
 
 ## LLM Integration
 
-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.
+Zeitlich's core is framework-agnostic — it defines generic interfaces (`ModelInvoker`, `ThreadOps`, `MessageContent`) that work with any LLM SDK. You choose a **thread adapter** (for conversation storage and model invocation) and a **sandbox adapter** (for filesystem operations), then wire them together.
 
-### LangChain Adapter (`zeitlich/adapters/thread/langchain`)
+### Thread Adapters
 
-The built-in LangChain adapter gives you:
+A thread adapter bundles two concerns:
+1. **Thread management** — Storing and retrieving conversation messages in Redis
+2. **Model invocation** — Calling the LLM with the conversation history and tools
 
-- **Provider flexibility** — Use Anthropic, OpenAI, Google, Azure, AWS Bedrock, or any LangChain-supported provider
-- **Consistent interface** — Same tool calling and message format regardless of provider
-- **Easy model swapping** — Change models without rewriting agent logic
+Each adapter exposes the same shape: `createActivities(scope)` for Temporal worker registration, and an `invoker` for model calls. Pick the one matching your preferred SDK:
+
+| Adapter | Import | SDK |
+|---------|--------|-----|
+| LangChain | `zeitlich/adapters/thread/langchain` | `@langchain/core` + any provider package |
+| Google GenAI | `zeitlich/adapters/thread/google-genai` | `@google/genai` |
+
+Vercel AI SDK and other provider-specific adapters can be built by implementing the `ThreadOps` and `ModelInvoker` interfaces.
+
+### Sandbox Adapters
+
+A sandbox adapter provides filesystem access for tools like `Bash`, `Read`, `Write`, and `Edit`:
+
+| 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 |
+| Daytona | `zeitlich/adapters/sandbox/daytona` | Remote Daytona workspaces |
+| E2B | `zeitlich/adapters/sandbox/e2b` | E2B cloud sandboxes |
+
+### Example: LangChain Adapter
 
 ```typescript
 import { ChatAnthropic } from "@langchain/anthropic";
@@ -55,20 +76,13 @@ const adapter = createLangChainAdapter({
 
 export function createActivities(client: WorkflowClient) {
   return {
-    // scope must match the workflow name (used by the proxy to resolve activity names)
     ...adapter.createActivities("myAgentWorkflow"),
     runAgent: createRunAgentActivity(client, adapter.invoker),
   };
 }
 ```
 
-Install the LangChain package for your chosen provider:
-
-```bash
-npm install @langchain/core @langchain/anthropic  # Anthropic
-npm install @langchain/core @langchain/openai     # OpenAI
-npm install @langchain/core @langchain/google-genai # Google
-```
+All adapters follow the same pattern — `createActivities(scope)` for worker registration and `invoker` for model calls.
 
 ## Installation
 
@@ -79,7 +93,8 @@ npm install zeitlich ioredis
 **Peer dependencies:**
 
 - `ioredis` >= 5.0.0
-- `@langchain/core` >= 1.0.0 (optional — only needed when using `zeitlich/adapters/thread/langchain`)
+- `@langchain/core` >= 1.0.0 (optional — only when using the LangChain adapter)
+- `@google/genai` >= 1.0.0 (optional — only when using the Google GenAI adapter)
 
 **Required infrastructure:**
 
@@ -91,7 +106,7 @@ npm install zeitlich ioredis
 Zeitlich uses separate entry points for workflow-side and activity-side code:
 
 ```typescript
-// In workflow files — no external dependencies (Redis, LangChain, etc.)
+// In workflow files — no external dependencies (Redis, LLM SDKs, etc.)
 import {
   createSession,
   createAgentStateManager,
@@ -99,7 +114,7 @@ import {
   bashTool,
 } from "zeitlich/workflow";
 
-// Adapter-specific workflow proxies (auto-scoped to current workflow)
+// Adapter workflow proxies (auto-scoped to current workflow)
 import { proxyLangChainThreadOps } from "zeitlich/adapters/thread/langchain/workflow";
 import { proxyInMemorySandboxOps } from "zeitlich/adapters/sandbox/inmemory/workflow";
 
@@ -111,7 +126,7 @@ import {
   bashHandler,
 } from "zeitlich";
 
-// LangChain adapter — activity-side (thread management + model invocation)
+// Thread adapter — activity-side
 import { createLangChainAdapter } from "zeitlich/adapters/thread/langchain";
 ```
 
@@ -146,7 +161,7 @@ export const searchTool: ToolDefinition<"Search", typeof searchSchema> = {
 
 ### 2. Create the Workflow
 
-The system prompt is set via `createAgentStateManager`'s `initialState`, and agent config fields (`agentName`, `maxTurns`, etc.) are spread into `createSession`.
+The workflow wires together a **thread adapter** (for conversation storage / model calls) and a **sandbox adapter** (for filesystem tools). Both are pluggable — swap the proxy import to switch providers.
 
 ```typescript
 import { proxyActivities, workflowInfo } from "@temporalio/workflow";
@@ -158,10 +173,12 @@ import {
   bashTool,
   defineTool,
 } from "zeitlich/workflow";
-import { proxyLangChainThreadOps } from "zeitlich/adapters/thread/langchain/workflow";
 import { searchTool } from "./tools";
 import type { MyActivities } from "./activities";
 
+import { proxyLangChainThreadOps } from "zeitlich/adapters/thread/langchain/workflow";
+import { proxyInMemorySandboxOps } from "zeitlich/adapters/sandbox/inmemory/workflow";
+
 const {
   runAgentActivity,
   searchHandlerActivity,
@@ -190,12 +207,12 @@ export const myAgentWorkflow = defineWorkflow(
       agentName: "my-agent",
     });
 
-    // threadOps auto-scopes to "myAgentWorkflow" via workflowInfo().workflowType
     const session = await createSession({
       agentName: "my-agent",
       maxTurns: 20,
-      threadId: runId,
+      thread: { mode: "new", threadId: runId },
       threadOps: proxyLangChainThreadOps(),
+      sandboxOps: proxyInMemorySandboxOps(),
       runAgent: runAgentActivity,
       buildContextMessage: () => [{ type: "text", text: prompt }],
       tools: {
@@ -228,20 +245,26 @@ export const myAgentWorkflow = defineWorkflow(
 
 ### 3. Create Activities
 
-Activities are factory functions that receive infrastructure dependencies (`redis`, `client`). Each returns an object of activity functions registered with the Temporal worker.
+Activities are factory functions that receive infrastructure dependencies (`redis`, `client`). The thread adapter and sandbox provider are configured here — swap imports to change LLM or sandbox backend.
 
 ```typescript
 import type Redis from "ioredis";
 import type { WorkflowClient } from "@temporalio/client";
 import { ChatAnthropic } from "@langchain/anthropic";
 import {
+  SandboxManager,
   withSandbox,
   bashHandler,
   createAskUserQuestionHandler,
   createRunAgentActivity,
 } from "zeitlich";
+import { InMemorySandboxProvider } from "zeitlich/adapters/sandbox/inmemory";
+
 import { createLangChainAdapter } from "zeitlich/adapters/thread/langchain";
 
+const sandboxProvider = new InMemorySandboxProvider();
+const sandboxManager = new SandboxManager(sandboxProvider);
+
 export const createActivities = ({
   redis,
   client,
@@ -258,8 +281,8 @@ export const createActivities = ({
   });
 
   return {
-    // "myAgentWorkflow" must match the workflow name in defineWorkflow()
     ...adapter.createActivities("myAgentWorkflow"),
+    ...sandboxManager.createActivities("myAgentWorkflow"),
     runAgentActivity: createRunAgentActivity(client, adapter.invoker),
     searchHandlerActivity: async (args: { query: string }) => ({
       toolResponse: JSON.stringify(await performSearch(args.query)),
@@ -411,7 +434,7 @@ export const researcherWorkflow = defineSubagentWorkflow(
     });
 
     const session = await createSession({
-      ...sessionInput, // spreads agentName, threadId, continueThread, sandboxId
+      ...sessionInput, // spreads agentName, thread, sandbox, sandboxShutdown
       threadOps: proxyLangChainThreadOps(), // auto-scoped to "Researcher"
       runAgent: runResearcherActivity,
       buildContextMessage: () => [{ type: "text", text: prompt }],
@@ -439,7 +462,7 @@ export const researcherSubagent = defineSubagent(researcherWorkflow);
 
 // Optionally override parent-specific config
 export const researcherSubagent = defineSubagent(researcherWorkflow, {
-  allowThreadContinuation: true,
+  thread: "fork",
   sandbox: "own",
   hooks: {
     onPostExecution: ({ result }) => console.log("researcher done", result),
@@ -454,39 +477,186 @@ const session = await createSession({
 
 The `Subagent` tool is automatically added when subagents are configured, allowing the LLM to spawn child workflows.
 
-### Thread Continuation
+### Skills
+
+Zeitlich has first-class support for the [agentskills.io](https://agentskills.io) specification. Skills are reusable instruction sets that an agent can load on-demand via the built-in `ReadSkill` tool — progressive disclosure keeps token usage low while giving agents access to rich, domain-specific guidance.
+
+#### Defining a Skill
+
+Each skill lives in its own directory as a `SKILL.md` file with YAML frontmatter:
+
+```
+skills/
+├── code-review/
+│   └── SKILL.md
+├── pdf-processing/
+│   └── SKILL.md
+```
+
+```markdown
+---
+name: code-review
+description: Review pull requests for correctness, style, and security issues
+allowed-tools: Bash Grep Read
+license: MIT
+---
+
+## Instructions
+
+When reviewing code, follow these steps:
+1. Read the diff with `Bash`
+2. Search for related tests with `Grep`
+3. ...
+```
+
+Required fields: `name` and `description`. Optional: `license`, `compatibility`, `allowed-tools` (space-delimited), `metadata` (key-value map).
 
-By default, each session initializes a fresh thread. To continue from an existing thread (e.g., resuming a conversation after a workflow completes), pass `continueThread: true` along with the previous `threadId`:
+#### Loading Skills
+
+Use `FileSystemSkillProvider` to load skills from a directory (works with any sandbox filesystem):
+
+```typescript
+import { FileSystemSkillProvider } from "zeitlich";
+import { InMemorySandboxProvider } from "zeitlich/adapters/sandbox/inmemory";
+
+const provider = new InMemorySandboxProvider();
+const { sandbox } = await provider.create({});
+
+const skillProvider = new FileSystemSkillProvider(sandbox.fs, "/skills");
+const skills = await skillProvider.loadAll();
+```
+
+Or parse a single file directly:
+
+```typescript
+import { parseSkillFile } from "zeitlich/workflow";
+
+const { frontmatter, body } = parseSkillFile(rawMarkdown);
+// frontmatter: SkillMetadata, body: instruction text
+```
+
+#### Passing Skills to a Session
+
+Pass loaded skills to `createSession`. Zeitlich automatically registers a `ReadSkill` tool whose description lists all available skills — the agent discovers them through the tool definition and loads instructions on demand:
 
 ```typescript
 import { createSession } from "zeitlich/workflow";
 
-// First run — threadId defaults to getShortId() if omitted
 const session = await createSession({
-  // threadId is optional, auto-generated if not provided
   // ... other config
+  skills, // Skill[] — loaded via FileSystemSkillProvider or manually
 });
+```
+
+The `ReadSkill` tool accepts a `skill_name` parameter (constrained to an enum of available names) and returns the full instruction body. The handler runs directly in the workflow — no activity needed.
+
+#### Building Skills Manually
+
+For advanced use cases, you can construct the tool and handler independently:
+
+```typescript
+import { createReadSkillTool, createReadSkillHandler } from "zeitlich/workflow";
+
+const tool = createReadSkillTool(skills);    // ToolDefinition with enum schema
+const handler = createReadSkillHandler(skills); // Returns skill instructions
+```
+
+### Thread & Sandbox Lifecycle
+
+Every session has a **thread** (conversation history) and an optional **sandbox** (filesystem environment). Both are configured with explicit lifecycle types that control how they are initialized and torn down.
+
+#### Thread Initialization (`ThreadInit`)
+
+The `thread` field on `SessionConfig` (and `WorkflowInput`) accepts one of three modes:
+
+| Mode | Description |
+|------|-------------|
+| `{ mode: "new" }` | Start a fresh thread (default). Optionally pass `threadId` to choose the ID. |
+| `{ mode: "fork", threadId }` | Copy all messages from an existing thread into a new one and continue there. The original is never mutated. |
+| `{ mode: "continue", threadId }` | Append directly to an existing thread in-place. |
 
-// Later — new workflow forks the previous thread
+```typescript
+import { createSession } from "zeitlich/workflow";
+
+// First run — fresh thread
+const session = await createSession({
+  thread: { mode: "new" },
+  // ... other config
+});
+
+// Later — fork the previous conversation
 const resumedSession = await createSession({
-  threadId: savedThreadId, // the thread to continue from
-  continueThread: true, // fork into a new thread with the old messages
+  thread: { mode: "fork", threadId: savedThreadId },
   // ... other config
 });
-```
 
-When `continueThread` is true the session **forks** the provided thread — it copies all messages into a new thread and operates on the copy. The original thread is never mutated, so multiple sessions can safely continue from the same thread in parallel.
+// Or append directly to the existing thread
+const continuedSession = await createSession({
+  thread: { mode: "continue", threadId: savedThreadId },
+  // ... other config
+});
+```
 
 `getShortId()` produces compact, workflow-deterministic IDs (~12 base-62 chars) that are more token-efficient than UUIDs.
 
-#### Subagent Thread Continuation
+#### Sandbox Initialization (`SandboxInit`)
+
+The `sandbox` field controls how a sandbox is created or reused:
+
+| Mode | Description |
+|------|-------------|
+| `{ mode: "new" }` | Create a fresh sandbox (default when `sandboxOps` is provided). |
+| `{ mode: "continue", sandboxId }` | Resume a previously-paused sandbox. This session takes ownership. |
+| `{ mode: "fork", sandboxId }` | Fork from an existing sandbox. A new sandbox is created and owned by this session. |
+| `{ mode: "inherit", sandboxId }` | Use a sandbox owned by someone else (e.g. a parent agent). Shutdown policy is ignored. |
 
-Subagents can opt in to thread continuation via `allowThreadContinuation`. When enabled, the parent agent can pass a `threadId` to resume a previous subagent conversation:
+#### Sandbox Shutdown (`SandboxShutdown`)
+
+The `sandboxShutdown` field controls what happens to the sandbox when the session exits:
+
+| Value | Description |
+|-------|-------------|
+| `"destroy"` | Tear down the sandbox entirely (default). |
+| `"pause"` | Pause the sandbox so it can be resumed later. |
+| `"keep"` | Leave the sandbox running (no-op on exit). |
+
+Subagents also support `"pause-until-parent-close"` — pause on exit, then wait for the parent workflow to signal when to destroy it.
+
+#### Subagent Thread & Sandbox Config
+
+Subagents configure thread and sandbox strategies via `defineSubagent`:
 
 ```typescript
-import { defineSubagentWorkflow, defineSubagent, createSession } from "zeitlich/workflow";
-import { proxyLangChainThreadOps } from "zeitlich/adapters/thread/langchain/workflow";
+import { defineSubagent } from "zeitlich/workflow";
+import { researcherWorkflow } from "./researcher.workflow";
+
+// Fresh thread each time, no sandbox (defaults)
+export const researcherSubagent = defineSubagent(researcherWorkflow);
+
+// Allow the parent to continue a previous conversation via fork
+export const researcherSubagent = defineSubagent(researcherWorkflow, {
+  thread: "fork",
+});
 
+// Own sandbox with pause-on-exit
+export const researcherSubagent = defineSubagent(researcherWorkflow, {
+  thread: "fork",
+  sandbox: { source: "own", shutdown: "pause" },
+});
+
+// Inherit the parent's sandbox
+export const researcherSubagent = defineSubagent(researcherWorkflow, {
+  sandbox: "inherit",
+});
+```
+
+The `thread` field accepts `"new"` (default), `"fork"`, or `"continue"`. When set to `"fork"` or `"continue"`, the parent agent can pass a `threadId` in a subsequent `Task` tool call to resume the conversation. The subagent returns its `threadId` in the response (surfaced as `[Thread ID: ...]`), which the parent can use for continuation.
+
+The `sandbox` field accepts `"none"` (default), `"inherit"`, `"own"`, or `{ source: "own", shutdown }` for explicit shutdown policy.
+
+The subagent workflow receives lifecycle fields via `sessionInput`:
+
+```typescript
 export const researcherWorkflow = defineSubagentWorkflow(
   {
     name: "Researcher",
@@ -494,28 +664,17 @@ export const researcherWorkflow = defineSubagentWorkflow(
   },
   async (prompt, sessionInput) => {
     const session = await createSession({
-      ...sessionInput, // threadId/continueThread are provided by parent when resuming
+      ...sessionInput, // spreads agentName, thread, sandbox, sandboxShutdown
       threadOps: proxyLangChainThreadOps(),
       // ... other config
     });
 
     const { threadId, finalMessage } = await session.runSession({ stateManager });
-    return {
-      toolResponse: finalMessage ? extractText(finalMessage) : "No response",
-      data: null,
-      threadId,
-    };
+    return { toolResponse: extractText(finalMessage), data: null, threadId };
   },
 );
-
-// Enable thread continuation in the parent registration
-export const researcherSubagent = defineSubagent(researcherWorkflow, {
-  allowThreadContinuation: true,
-});
 ```
 
-The subagent returns its `threadId` in the response, which the handler surfaces to the parent LLM as `[Thread ID: ...]`. The parent can then pass that ID back in a subsequent `Subagent` tool call to continue the conversation.
-
 ### Filesystem Utilities
 
 Built-in support for file operations with in-memory or custom filesystem providers (e.g. from [`just-bash`](https://github.com/nicholasgasior/just-bash)).
@@ -632,6 +791,7 @@ Zeitlich provides ready-to-use tool definitions and handlers for common agent op
 | `Grep`            | Search file contents with regex patterns                          |
 | `Bash`            | Execute shell commands                                            |
 | `AskUserQuestion` | Ask the user questions during execution with structured options   |
+| `ReadSkill`       | Load skill instructions on demand (see [Skills](#skills))         |
 | `Task`            | Launch subagents as child workflows (see [Subagents](#subagents)) |
 
 ```typescript
@@ -691,7 +851,10 @@ Safe for use in Temporal workflow files:
 | `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                       | `SubagentDefinition`, `SubagentConfig`, `ToolDefinition`, `ToolWithHandler`, `RouterContext`, `SessionConfig`, etc. |
+| Skill utilities             | `parseSkillFile`, `createReadSkillTool`, `createReadSkillHandler`                                      |
+| `defineWorkflow`            | Wraps a main workflow function, translating `WorkflowInput` into session-compatible fields             |
+| Lifecycle types             | `ThreadInit`, `SandboxInit`, `SandboxShutdown`, `SubagentSandboxShutdown`, `SubagentSandboxConfig`     |
+| Types                       | `Skill`, `SkillMetadata`, `SkillProvider`, `SubagentDefinition`, `SubagentConfig`, `ToolDefinition`, `ToolWithHandler`, `RouterContext`, `SessionConfig`, `WorkflowConfig`, `WorkflowInput`, etc. |
 
 ### Activity Entry Point (`zeitlich`)
 
@@ -704,11 +867,12 @@ Framework-agnostic utilities for activities, worker setup, and Node.js code:
 | `createThreadManager`     | Generic Redis-backed thread manager factory                                                   |
 | `toTree`                  | Generate file tree string from an `IFileSystem` instance                                      |
 | `withSandbox`             | Wraps a handler to auto-resolve sandbox from context (pairs with `withAutoAppend`)            |
+| `FileSystemSkillProvider`   | Load skills from a directory following the agentskills.io layout                                  |
 | Tool handlers             | `bashHandler`, `editHandler`, `globHandler`, `readFileHandler`, `writeFileHandler`, `createAskUserQuestionHandler` |
 
-### LangChain Adapter Entry Point (`zeitlich/adapters/thread/langchain`)
+### Thread Adapter Entry Points
 
-LangChain-specific implementations:
+**LangChain** (`zeitlich/adapters/thread/langchain`):
 
 | Export                              | Description                                                            |
 | ----------------------------------- | ---------------------------------------------------------------------- |
@@ -717,6 +881,15 @@ LangChain-specific implementations:
 | `invokeLangChainModel`              | One-shot model invocation convenience function                         |
 | `createLangChainThreadManager`      | Thread manager with LangChain `StoredMessage` helpers                  |
 
+**Google GenAI** (`zeitlich/adapters/thread/google-genai`):
+
+| Export                              | Description                                                            |
+| ----------------------------------- | ---------------------------------------------------------------------- |
+| `createGoogleGenAIAdapter`          | Unified adapter returning `createActivities`, `invoker`, `createModelInvoker` |
+| `createGoogleGenAIModelInvoker`     | Factory that returns a `ModelInvoker` backed by the `@google/genai` SDK |
+| `invokeGoogleGenAIModel`            | One-shot model invocation convenience function                         |
+| `createGoogleGenAIThreadManager`    | Thread manager with Google GenAI `Content` helpers                     |
+
 ### Types
 
 | Export                  | Description                                                                  |
@@ -731,6 +904,11 @@ LangChain-specific implementations:
 | `RouterContext`          | Base context every tool handler receives (`threadId`, `toolCallId`, `toolName`, `sandboxId?`) |
 | `Hooks`                 | Combined session lifecycle + tool execution hooks                            |
 | `ToolRouterHooks`       | Narrowed hook interface for tool execution only (pre/post/failure)            |
+| `ThreadInit`            | Thread initialization strategy: `"new"`, `"continue"`, or `"fork"`               |
+| `SandboxInit`           | Sandbox initialization strategy: `"new"`, `"continue"`, `"fork"`, or `"inherit"` |
+| `SandboxShutdown`       | Sandbox exit policy: `"destroy" \| "pause" \| "keep"`                            |
+| `SubagentSandboxShutdown` | Extended shutdown with `"pause-until-parent-close"`                             |
+| `SubagentSandboxConfig` | Subagent sandbox strategy: `"none" \| "inherit" \| "own" \| { source, shutdown }` |
 | `SubagentDefinition`    | Callable subagent workflow with embedded metadata (from `defineSubagentWorkflow`) |
 | `SubagentConfig`        | Resolved subagent configuration consumed by `createSession`                  |
 | `AgentState`            | Generic agent state type                                                     |
@@ -758,9 +936,14 @@ LangChain-specific implementations:
 │  └──────────────────────────────────────────────────────────┘  │
 │                              │                                  │
 │  ┌──────────────────────────────────────────────────────────┐  │
-│  │       LLM Adapter (zeitlich/adapters/thread/langchain)           │  │
-│  │  • createLangChainAdapter (thread ops + model invoker)    │  │
-│  │  • createLangChainThreadManager (message helpers)         │  │
+│  │          Thread Adapter (zeitlich/adapters/thread/*)       │  │
+│  │  • LangChain, Google GenAI, or custom                     │  │
+│  │  • Thread ops (message storage) + model invoker            │  │
+│  └──────────────────────────────────────────────────────────┘  │
+│  ┌──────────────────────────────────────────────────────────┐  │
+│  │         Sandbox Adapter (zeitlich/adapters/sandbox/*)      │  │
+│  │  • In-memory, Virtual, Daytona, E2B, or custom            │  │
+│  │  • Filesystem ops for agent tools                          │  │
 │  └──────────────────────────────────────────────────────────┘  │
 └─────────────────────────────────────────────────────────────────┘
                               │

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

@@ -47,7 +47,7 @@ var DaytonaSandboxFileSystem = class {
     await this.sandbox.fs.uploadFiles(
       files.map((f) => ({
         source: Buffer.from(f.content),
-        destination: f.path
+        destination: this.normalisePath(f.path)
       }))
     );
   }
@@ -231,6 +231,9 @@ var DaytonaSandboxProvider = class {
     } catch {
     }
   }
+  async pause(_sandboxId, _ttlSeconds) {
+    throw new SandboxNotSupportedError("pause");
+  }
   async fork(_sandboxId) {
     throw new Error("Not implemented");
   }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/sandbox/types.ts","../../../../src/adapters/sandbox/daytona/filesystem.ts","../../../../src/adapters/sandbox/daytona/index.ts"],"names":["ApplicationFailure","posix","path","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  /** Base directory used when resolving relative paths. */\n  readonly workspaceBase: string;\n  readFile(path: string): Promise<string>;\n  readFileBuffer(path: string): Promise<Uint8Array>;\n  writeFile(path: string, content: string | Uint8Array): Promise<void>;\n  appendFile(path: string, content: string | Uint8Array): Promise<void>;\n  exists(path: string): Promise<boolean>;\n  stat(path: string): Promise<FileStat>;\n  mkdir(path: string, options?: { recursive?: boolean }): Promise<void>;\n  readdir(path: string): Promise<string[]>;\n  readdirWithFileTypes(path: string): Promise<DirentEntry[]>;\n  rm(path: string, options?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  cp(src: string, dest: string, options?: { recursive?: boolean }): Promise<void>;\n  mv(src: string, dest: string): Promise<void>;\n  readlink(path: string): Promise<string>;\n  resolvePath(base: string, path: string): string;\n}\n\n// ============================================================================\n// Execution\n// ============================================================================\n\nexport interface ExecOptions {\n  timeout?: number;\n  cwd?: string;\n  env?: Record<string, string>;\n}\n\nexport interface ExecResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n// ============================================================================\n// Capabilities\n// ============================================================================\n\nexport interface SandboxCapabilities {\n  /** Sandbox supports filesystem operations */\n  filesystem: boolean;\n  /** Sandbox supports shell/command execution */\n  execution: boolean;\n  /** Sandbox state can be persisted and restored */\n  persistence: boolean;\n}\n\n// ============================================================================\n// Sandbox\n// ============================================================================\n\nexport interface Sandbox {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n  readonly fs: SandboxFileSystem;\n\n  exec(command: string, options?: ExecOptions): Promise<ExecResult>;\n  destroy(): Promise<void>;\n}\n\n// ============================================================================\n// Snapshots\n// ============================================================================\n\nexport interface SandboxSnapshot {\n  sandboxId: string;\n  providerId: string;\n  /** Provider-specific serialised state */\n  data: unknown;\n  createdAt: string;\n}\n\n// ============================================================================\n// Provider\n// ============================================================================\n\nexport interface SandboxCreateOptions {\n  /** Preferred sandbox ID (provider may ignore) */\n  id?: string;\n  /** Seed the filesystem with these files */\n  initialFiles?: Record<string, string | Uint8Array>;\n  /** Environment variables available inside the sandbox */\n  env?: Record<string, string>;\n}\n\nexport interface SandboxCreateResult {\n  sandbox: Sandbox;\n  /** Optional state to merge into the workflow's `AgentState` via the session. */\n  stateUpdate?: Record<string, unknown>;\n}\n\nexport interface SandboxProvider<\n  TOptions extends SandboxCreateOptions = SandboxCreateOptions,\n  TSandbox extends Sandbox = Sandbox,\n> {\n  readonly id: string;\n  readonly capabilities: SandboxCapabilities;\n\n  create(options?: TOptions): Promise<SandboxCreateResult>;\n  get(sandboxId: string): Promise<TSandbox>;\n  destroy(sandboxId: string): Promise<void>;\n  snapshot(sandboxId: string): Promise<SandboxSnapshot>;\n  restore(snapshot: SandboxSnapshot): Promise<Sandbox>;\n  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  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 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  readonly workspaceBase: string;\n\n  constructor(\n    private sandbox: DaytonaSdkSandbox,\n    workspaceBase = \"/home/daytona\"\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    const norm = this.normalisePath(path);\n    const buf = await this.sandbox.fs.downloadFile(norm);\n    return buf.toString(\"utf-8\");\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    const norm = this.normalisePath(path);\n    const buf = await this.sandbox.fs.downloadFile(norm);\n    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n  }\n\n  async writeFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = this.normalisePath(path);\n    const buf =\n      typeof content === \"string\"\n        ? Buffer.from(content, \"utf-8\")\n        : Buffer.from(content);\n    await this.sandbox.fs.uploadFile(buf, norm);\n  }\n\n  async writeFiles(\n    files: { path: string; content: string | Uint8Array }[]\n  ): Promise<void> {\n    await this.sandbox.fs.uploadFiles(\n      files.map((f) => ({\n        source: Buffer.from(f.content),\n        destination: f.path,\n      }))\n    );\n  }\n\n  async appendFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = this.normalisePath(path);\n    let existing: Buffer;\n    try {\n      existing = await this.sandbox.fs.downloadFile(norm);\n    } catch {\n      return this.writeFile(norm, 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, norm);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    const norm = this.normalisePath(path);\n    try {\n      await this.sandbox.fs.getFileDetails(norm);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const norm = this.normalisePath(path);\n    const info = await this.sandbox.fs.getFileDetails(norm);\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(path: string, _options?: { recursive?: boolean }): Promise<void> {\n    const norm = this.normalisePath(path);\n    await this.sandbox.fs.createFolder(norm, \"755\");\n  }\n\n  async readdir(path: string): Promise<string[]> {\n    const norm = this.normalisePath(path);\n    const entries = await this.sandbox.fs.listFiles(norm);\n    return entries.map((e) => e.name);\n  }\n\n  async readdirWithFileTypes(path: string): Promise<DirentEntry[]> {\n    const norm = this.normalisePath(path);\n    const entries = await this.sandbox.fs.listFiles(norm);\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    const norm = this.normalisePath(path);\n    try {\n      await this.sandbox.fs.deleteFile(norm, 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 normSrc = this.normalisePath(src);\n    const normDest = this.normalisePath(dest);\n    const info = await this.sandbox.fs.getFileDetails(normSrc);\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(\n        `cp -r \"${normSrc}\" \"${normDest}\"`\n      );\n    } else {\n      await this.sandbox.process.executeCommand(\n        `cp \"${normSrc}\" \"${normDest}\"`\n      );\n    }\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.fs.moveFiles(normSrc, normDest);\n  }\n\n  async readlink(_path: string): Promise<string> {\n    throw new SandboxNotSupportedError(\"readlink\");\n  }\n\n  resolvePath(base: string, path: string): string {\n    return posix.resolve(this.normalisePath(base), path);\n  }\n}\n","import { Daytona, type Sandbox as DaytonaSdkSandbox } 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    workspaceBase = \"/home/daytona\"\n  ) {\n    this.fs = new DaytonaSandboxFileSystem(sdkSandbox, workspaceBase);\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 implements SandboxProvider<\n  DaytonaSandboxCreateOptions,\n  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  private readonly defaultWorkspaceBase: string;\n\n  constructor(config?: DaytonaSandboxConfig) {\n    this.client = new Daytona(config);\n    this.defaultWorkspaceBase = config?.workspaceBase ?? \"/home/daytona\";\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 workspaceBase = options?.workspaceBase ?? this.defaultWorkspaceBase;\n\n    const sandbox = new DaytonaSandboxImpl(\n      sdkSandbox.id,\n      sdkSandbox,\n      workspaceBase\n    );\n\n    if (options?.initialFiles) {\n      await sandbox.fs.writeFiles(\n        Object.entries(options.initialFiles).map(([path, content]) => ({\n          path,\n          content,\n        }))\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(\n        sdkSandbox.id,\n        sdkSandbox,\n        this.defaultWorkspaceBase\n      );\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 fork(_sandboxId: string): Promise<Sandbox> {\n    throw new Error(\"Not implemented\");\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"]}
+{"version":3,"sources":["../../../../src/lib/sandbox/types.ts","../../../../src/adapters/sandbox/daytona/filesystem.ts","../../../../src/adapters/sandbox/daytona/index.ts"],"names":["ApplicationFailure","posix","path","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  /** 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 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  readonly workspaceBase: string;\n\n  constructor(\n    private sandbox: DaytonaSdkSandbox,\n    workspaceBase = \"/home/daytona\"\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    const norm = this.normalisePath(path);\n    const buf = await this.sandbox.fs.downloadFile(norm);\n    return buf.toString(\"utf-8\");\n  }\n\n  async readFileBuffer(path: string): Promise<Uint8Array> {\n    const norm = this.normalisePath(path);\n    const buf = await this.sandbox.fs.downloadFile(norm);\n    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n  }\n\n  async writeFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = this.normalisePath(path);\n    const buf =\n      typeof content === \"string\"\n        ? Buffer.from(content, \"utf-8\")\n        : Buffer.from(content);\n    await this.sandbox.fs.uploadFile(buf, norm);\n  }\n\n  async writeFiles(\n    files: { path: string; content: string | Uint8Array }[]\n  ): Promise<void> {\n    await this.sandbox.fs.uploadFiles(\n      files.map((f) => ({\n        source: Buffer.from(f.content),\n        destination: this.normalisePath(f.path),\n      }))\n    );\n  }\n\n  async appendFile(path: string, content: string | Uint8Array): Promise<void> {\n    const norm = this.normalisePath(path);\n    let existing: Buffer;\n    try {\n      existing = await this.sandbox.fs.downloadFile(norm);\n    } catch {\n      return this.writeFile(norm, 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, norm);\n  }\n\n  async exists(path: string): Promise<boolean> {\n    const norm = this.normalisePath(path);\n    try {\n      await this.sandbox.fs.getFileDetails(norm);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async stat(path: string): Promise<FileStat> {\n    const norm = this.normalisePath(path);\n    const info = await this.sandbox.fs.getFileDetails(norm);\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(path: string, _options?: { recursive?: boolean }): Promise<void> {\n    const norm = this.normalisePath(path);\n    await this.sandbox.fs.createFolder(norm, \"755\");\n  }\n\n  async readdir(path: string): Promise<string[]> {\n    const norm = this.normalisePath(path);\n    const entries = await this.sandbox.fs.listFiles(norm);\n    return entries.map((e) => e.name);\n  }\n\n  async readdirWithFileTypes(path: string): Promise<DirentEntry[]> {\n    const norm = this.normalisePath(path);\n    const entries = await this.sandbox.fs.listFiles(norm);\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    const norm = this.normalisePath(path);\n    try {\n      await this.sandbox.fs.deleteFile(norm, 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 normSrc = this.normalisePath(src);\n    const normDest = this.normalisePath(dest);\n    const info = await this.sandbox.fs.getFileDetails(normSrc);\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(\n        `cp -r \"${normSrc}\" \"${normDest}\"`\n      );\n    } else {\n      await this.sandbox.process.executeCommand(\n        `cp \"${normSrc}\" \"${normDest}\"`\n      );\n    }\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.fs.moveFiles(normSrc, normDest);\n  }\n\n  async readlink(_path: string): Promise<string> {\n    throw new SandboxNotSupportedError(\"readlink\");\n  }\n\n  resolvePath(base: string, path: string): string {\n    return posix.resolve(this.normalisePath(base), path);\n  }\n}\n","import { Daytona, type Sandbox as DaytonaSdkSandbox } 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    workspaceBase = \"/home/daytona\"\n  ) {\n    this.fs = new DaytonaSandboxFileSystem(sdkSandbox, workspaceBase);\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 implements SandboxProvider<\n  DaytonaSandboxCreateOptions,\n  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  private readonly defaultWorkspaceBase: string;\n\n  constructor(config?: DaytonaSandboxConfig) {\n    this.client = new Daytona(config);\n    this.defaultWorkspaceBase = config?.workspaceBase ?? \"/home/daytona\";\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 workspaceBase = options?.workspaceBase ?? this.defaultWorkspaceBase;\n\n    const sandbox = new DaytonaSandboxImpl(\n      sdkSandbox.id,\n      sdkSandbox,\n      workspaceBase\n    );\n\n    if (options?.initialFiles) {\n      await sandbox.fs.writeFiles(\n        Object.entries(options.initialFiles).map(([path, content]) => ({\n          path,\n          content,\n        }))\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(\n        sdkSandbox.id,\n        sdkSandbox,\n        this.defaultWorkspaceBase\n      );\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 pause(_sandboxId: string, _ttlSeconds?: number): Promise<void> {\n    throw new SandboxNotSupportedError(\"pause\");\n  }\n\n  async fork(_sandboxId: string): Promise<Sandbox> {\n    throw new Error(\"Not implemented\");\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"]}