zeitlich 0.2.15 → 0.2.17

package/README.md

@@ -97,7 +97,8 @@ import {
   askUserQuestionTool,
   bashTool,
   defineTool,
-  type SubagentWorkflow,
+  defineSubagentWorkflow,
+  defineSubagent,
   type ModelInvoker,
 } from "zeitlich/workflow";
 
@@ -371,58 +372,68 @@ const session = await createSession({
 
 ### Subagents
 
-Spawn child agents as Temporal child workflows. Each subagent is a workflow typed with `SubagentWorkflow` that returns `{ toolResponse, data }`:
+Spawn child agents as Temporal child workflows. Use `defineSubagentWorkflow` to define the workflow with its metadata once, then `defineSubagent` to register it in the parent:
 
 ```typescript
-import { proxyActivities, workflowInfo } from "@temporalio/workflow";
+// researcher.workflow.ts
+import { proxyActivities } from "@temporalio/workflow";
 import {
   createAgentStateManager,
   createSession,
-  type SubagentWorkflow,
+  defineSubagentWorkflow,
 } from "zeitlich/workflow";
-import { agentConfig } from "./config";
 import type { createResearcherActivities } from "./activities";
 
 const { runResearcherActivity } = proxyActivities<
   ReturnType<typeof createResearcherActivities>
 >({ startToCloseTimeout: "30m", heartbeatTimeout: "5m" });
 
-// Subagent workflow typed as SubagentWorkflow
-export const researcherSubagentWorkflow: SubagentWorkflow = async ({
-  prompt,
-}) => {
-  const { runId } = workflowInfo();
-
-  const stateManager = createAgentStateManager({
-    initialState: { systemPrompt: agentConfig.systemPrompt },
-    agentName: agentConfig.agentName,
-  });
+// Define the workflow — name, description (and optional resultSchema) live here
+export const researcherWorkflow = defineSubagentWorkflow(
+  {
+    name: "Researcher",
+    description: "Researches topics and gathers information",
+  },
+  async (prompt, sessionInput) => {
+    const stateManager = createAgentStateManager({
+      initialState: { systemPrompt: "You are a researcher." },
+    });
+
+    const session = await createSession({
+      ...sessionInput, // spreads agentName, threadId, continueThread, sandboxId
+      runAgent: runResearcherActivity,
+      buildContextMessage: () => [{ type: "text", text: prompt }],
+    });
+
+    const { finalMessage, threadId } = await session.runSession({ stateManager });
+    return {
+      toolResponse: finalMessage ? extractText(finalMessage) : "No response",
+      data: null,
+      threadId,
+    };
+  },
+);
+```
 
-  const session = await createSession({
-    ...agentConfig,
-    threadId: runId,
-    runAgent: runResearcherActivity,
-    buildContextMessage: () => [{ type: "text", text: prompt }],
-  });
+In the parent workflow, register it with `defineSubagent` and pass it to `createSession`:
 
-  const { finalMessage } = await session.runSession({ stateManager });
-  return {
-    toolResponse: finalMessage ? extractText(finalMessage) : "No response",
-    data: null,
-  };
-};
+```typescript
+// parent.workflow.ts
+import { defineSubagent } from "zeitlich/workflow";
+import { researcherWorkflow } from "./researcher.workflow";
 
-// Register the subagent for the parent workflow
-export const researcherSubagent = {
-  agentName: agentConfig.agentName,
-  description: agentConfig.description,
-  workflow: researcherSubagentWorkflow,
-};
-```
+// Metadata (name, description) comes from the workflow definition
+export const researcherSubagent = defineSubagent(researcherWorkflow);
 
-In the parent workflow, pass subagents to `createSession`:
+// Optionally override parent-specific config
+export const researcherSubagent = defineSubagent(researcherWorkflow, {
+  allowThreadContinuation: true,
+  sandbox: "own",
+  hooks: {
+    onPostExecution: ({ result }) => console.log("researcher done", result),
+  },
+});
 
-```typescript
 const session = await createSession({
   // ... other config
   subagents: [researcherSubagent, codeReviewerSubagent],
@@ -461,34 +472,32 @@ When `continueThread` is true the session **forks** the provided thread — it c
 Subagents can opt in to thread continuation via `allowThreadContinuation`. When enabled, the parent agent can pass a `threadId` to resume a previous subagent conversation:
 
 ```typescript
-import { type SubagentWorkflow } from "zeitlich/workflow";
+import { defineSubagentWorkflow, defineSubagent } from "zeitlich/workflow";
 
-// Subagent workflow that supports continuation
-export const researcherWorkflow: SubagentWorkflow = async ({
-  prompt,
-  previousThreadId,
-}) => {
-  const session = await createSession({
-    threadId: previousThreadId, // undefined → fresh thread, set → fork
-    continueThread: !!previousThreadId,
-    // ... other config
-  });
-
-  const { threadId, finalMessage } = await session.runSession({ stateManager });
-  return {
-    toolResponse: finalMessage ? extractText(finalMessage) : "No response",
-    data: null,
-    threadId,
-  };
-};
+export const researcherWorkflow = defineSubagentWorkflow(
+  {
+    name: "Researcher",
+    description: "Researches topics and gathers information",
+  },
+  async (prompt, sessionInput) => {
+    const session = await createSession({
+      ...sessionInput, // threadId/continueThread are provided by parent when resuming
+      // ... other config
+    });
+
+    const { threadId, finalMessage } = await session.runSession({ stateManager });
+    return {
+      toolResponse: finalMessage ? extractText(finalMessage) : "No response",
+      data: null,
+      threadId,
+    };
+  },
+);
 
-// Register with allowThreadContinuation
-export const researcherSubagent = {
-  agentName: "Researcher",
-  description: "Researches topics and gathers information",
-  workflow: researcherWorkflow,
+// 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.
@@ -545,6 +554,56 @@ export const createActivities = ({ redis, client }) => ({
 });
 ```
 
+#### Sandbox Path Semantics (Virtual + Daytona)
+
+Filesystem adapters now apply the same path rules:
+
+- Absolute paths are used as-is (canonicalized).
+- Relative paths are resolved from `/`.
+- Paths are normalized (duplicate slashes removed, `.`/`..` collapsed).
+
+This means `readFile("a/b.txt")` is treated as `/a/b.txt` across adapters.
+
+Each `fs` instance also exposes `workspaceBase`, which is the base used for relative paths.
+
+**Virtual sandbox example (path-only calls):**
+
+```typescript
+import { createVirtualSandbox, VirtualSandboxProvider } from "zeitlich";
+
+const provider = new VirtualSandboxProvider(resolver);
+const { sandbox } = await provider.create({
+  resolverContext: { projectId: "p1" },
+  workspaceBase: "/repo",
+});
+
+const fs = sandbox.fs;
+console.log(fs.workspaceBase); // "/repo"
+
+await fs.writeFile("src/index.ts", 'export const ok = true;\n');
+const content = await fs.readFile("src/index.ts"); // reads /repo/src/index.ts
+```
+
+**Daytona sandbox example (base `/home/daytona`):**
+
+```typescript
+import { DaytonaSandboxProvider } from "zeitlich";
+
+const provider = new DaytonaSandboxProvider();
+const { sandbox } = await provider.create({
+  workspaceBase: "/home/daytona",
+});
+
+const fs = sandbox.fs;
+console.log(fs.workspaceBase); // "/home/daytona"
+
+await fs.mkdir("project", { recursive: true });
+await fs.writeFile("project/README.md", "# Hello from Daytona\n");
+const content = await fs.readFile("project/README.md");
+```
+
+For Daytona, use `workspaceBase: "/home/daytona"` (or your own working dir) so relative paths stay in the expected workspace.
+
 ### Built-in Tools
 
 Zeitlich provides ready-to-use tool definitions and handlers for common agent operations.
@@ -612,11 +671,12 @@ Safe for use in Temporal workflow files:
 | `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                                                 |
+| `defineSubagentWorkflow`    | Defines a subagent workflow with embedded name, description, and optional resultSchema                 |
+| `defineSubagent`            | Creates a `SubagentConfig` from a `SubagentDefinition` with optional parent-specific overrides         |
 | `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.        |
+| Types                       | `SubagentDefinition`, `SubagentConfig`, `ToolDefinition`, `ToolWithHandler`, `RouterContext`, `SessionConfig`, etc. |
 
 ### Activity Entry Point (`zeitlich`)
 
@@ -656,7 +716,8 @@ 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)            |
-| `SubagentConfig`        | Configuration for subagent workflows                                         |
+| `SubagentDefinition`    | Callable subagent workflow with embedded metadata (from `defineSubagentWorkflow`) |
+| `SubagentConfig`        | Resolved subagent configuration consumed by `createSession`                  |
 | `AgentState`            | Generic agent state type                                                     |
 
 ## Architecture

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

@@ -20,42 +20,53 @@ var SandboxNotFoundError = class extends common.ApplicationFailure {
   }
 };
 var DaytonaSandboxFileSystem = class {
-  constructor(sandbox) {
+  constructor(sandbox, workspaceBase = "/home/daytona") {
     this.sandbox = sandbox;
+    this.workspaceBase = path.posix.resolve("/", workspaceBase);
+  }
+  workspaceBase;
+  normalisePath(path$1) {
+    return path.posix.resolve(this.workspaceBase, path$1);
   }
   async readFile(path) {
-    const buf = await this.sandbox.fs.downloadFile(path);
+    const norm = this.normalisePath(path);
+    const buf = await this.sandbox.fs.downloadFile(norm);
     return buf.toString("utf-8");
   }
   async readFileBuffer(path) {
-    const buf = await this.sandbox.fs.downloadFile(path);
+    const norm = this.normalisePath(path);
+    const buf = await this.sandbox.fs.downloadFile(norm);
     return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
   }
   async writeFile(path, content) {
+    const norm = this.normalisePath(path);
     const buf = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
-    await this.sandbox.fs.uploadFile(buf, path);
+    await this.sandbox.fs.uploadFile(buf, norm);
   }
   async appendFile(path, content) {
+    const norm = this.normalisePath(path);
     let existing;
     try {
-      existing = await this.sandbox.fs.downloadFile(path);
+      existing = await this.sandbox.fs.downloadFile(norm);
     } catch {
-      return this.writeFile(path, content);
+      return this.writeFile(norm, 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);
+    await this.sandbox.fs.uploadFile(merged, norm);
   }
   async exists(path) {
+    const norm = this.normalisePath(path);
     try {
-      await this.sandbox.fs.getFileDetails(path);
+      await this.sandbox.fs.getFileDetails(norm);
       return true;
     } catch {
       return false;
     }
   }
   async stat(path) {
-    const info = await this.sandbox.fs.getFileDetails(path);
+    const norm = this.normalisePath(path);
+    const info = await this.sandbox.fs.getFileDetails(norm);
     return {
       isFile: !info.isDir,
       isDirectory: info.isDir,
@@ -65,14 +76,17 @@ var DaytonaSandboxFileSystem = class {
     };
   }
   async mkdir(path, _options) {
-    await this.sandbox.fs.createFolder(path, "755");
+    const norm = this.normalisePath(path);
+    await this.sandbox.fs.createFolder(norm, "755");
   }
   async readdir(path) {
-    const entries = await this.sandbox.fs.listFiles(path);
+    const norm = this.normalisePath(path);
+    const entries = await this.sandbox.fs.listFiles(norm);
     return entries.map((e) => e.name);
   }
   async readdirWithFileTypes(path) {
-    const entries = await this.sandbox.fs.listFiles(path);
+    const norm = this.normalisePath(path);
+    const entries = await this.sandbox.fs.listFiles(norm);
     return entries.map((e) => ({
       name: e.name,
       isFile: !e.isDir,
@@ -81,41 +95,45 @@ var DaytonaSandboxFileSystem = class {
     }));
   }
   async rm(path, options) {
+    const norm = this.normalisePath(path);
     try {
-      await this.sandbox.fs.deleteFile(path, options?.recursive);
+      await this.sandbox.fs.deleteFile(norm, options?.recursive);
     } catch (err) {
       if (!options?.force) throw err;
     }
   }
   async cp(src, dest, options) {
-    const info = await this.sandbox.fs.getFileDetails(src);
+    const normSrc = this.normalisePath(src);
+    const normDest = this.normalisePath(dest);
+    const info = await this.sandbox.fs.getFileDetails(normSrc);
     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}"`);
+      await this.sandbox.process.executeCommand(`cp -r "${normSrc}" "${normDest}"`);
     } else {
-      await this.sandbox.process.executeCommand(`cp "${src}" "${dest}"`);
+      await this.sandbox.process.executeCommand(`cp "${normSrc}" "${normDest}"`);
     }
   }
   async mv(src, dest) {
-    await this.sandbox.fs.moveFiles(src, dest);
+    const normSrc = this.normalisePath(src);
+    const normDest = this.normalisePath(dest);
+    await this.sandbox.fs.moveFiles(normSrc, normDest);
   }
   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);
+    return path.posix.resolve(this.normalisePath(base), path$1);
   }
 };
 
 // src/adapters/sandbox/daytona/index.ts
 var DaytonaSandboxImpl = class {
-  constructor(id, sdkSandbox) {
+  constructor(id, sdkSandbox, workspaceBase = "/home/daytona") {
     this.id = id;
     this.sdkSandbox = sdkSandbox;
-    this.fs = new DaytonaSandboxFileSystem(sdkSandbox);
+    this.fs = new DaytonaSandboxFileSystem(sdkSandbox, workspaceBase);
   }
   capabilities = {
     filesystem: true,
@@ -148,8 +166,11 @@ var DaytonaSandboxProvider = class {
     persistence: false
   };
   client;
+  defaultWorkspaceBase;
+  workspaceBaseById = /* @__PURE__ */ new Map();
   constructor(config) {
     this.client = new sdk.Daytona(config);
+    this.defaultWorkspaceBase = config?.workspaceBase ?? "/home/daytona";
   }
   async create(options) {
     const sdkSandbox = await this.client.create(
@@ -164,7 +185,13 @@ var DaytonaSandboxProvider = class {
       },
       { timeout: options?.timeout ?? 60 }
     );
-    const sandbox = new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox);
+    const workspaceBase = options?.workspaceBase ?? this.defaultWorkspaceBase;
+    this.workspaceBaseById.set(sdkSandbox.id, workspaceBase);
+    const sandbox = new DaytonaSandboxImpl(
+      sdkSandbox.id,
+      sdkSandbox,
+      workspaceBase
+    );
     if (options?.initialFiles) {
       for (const [path, content] of Object.entries(options.initialFiles)) {
         await sandbox.fs.writeFile(path, content);
@@ -175,7 +202,8 @@ var DaytonaSandboxProvider = class {
   async get(sandboxId) {
     try {
       const sdkSandbox = await this.client.get(sandboxId);
-      return new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox);
+      const workspaceBase = this.workspaceBaseById.get(sandboxId) ?? this.defaultWorkspaceBase;
+      return new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox, workspaceBase);
     } catch {
       throw new SandboxNotFoundError(sandboxId);
     }
@@ -184,6 +212,7 @@ var DaytonaSandboxProvider = class {
     try {
       const sdkSandbox = await this.client.get(sandboxId);
       await this.client.delete(sdkSandbox);
+      this.workspaceBaseById.delete(sandboxId);
     } catch {
     }
   }

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","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"]}
+{"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}\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  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 appendFile(\n    path: string,\n    content: string | Uint8Array,\n  ): 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(\n    path: string,\n    _options?: { recursive?: boolean },\n  ): 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(`cp -r \"${normSrc}\" \"${normDest}\"`);\n    } else {\n      await this.sandbox.process.executeCommand(`cp \"${normSrc}\" \"${normDest}\"`);\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 {\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    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\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  private readonly defaultWorkspaceBase: string;\n  private workspaceBaseById = new Map<string, 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    this.workspaceBaseById.set(sdkSandbox.id, workspaceBase);\n    const sandbox = new DaytonaSandboxImpl(\n      sdkSandbox.id,\n      sdkSandbox,\n      workspaceBase,\n    );\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      const workspaceBase =\n        this.workspaceBaseById.get(sandboxId) ?? this.defaultWorkspaceBase;\n      return new DaytonaSandboxImpl(sdkSandbox.id, sdkSandbox, workspaceBase);\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      this.workspaceBaseById.delete(sandboxId);\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

@@ -1,4 +1,4 @@
-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 { 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-BMRzfELQ.cjs';
 import { Sandbox } from '@daytonaio/sdk';
 import '@temporalio/common';
 
@@ -11,7 +11,9 @@ import '@temporalio/common';
  */
 declare class DaytonaSandboxFileSystem implements SandboxFileSystem {
     private sandbox;
-    constructor(sandbox: Sandbox);
+    readonly workspaceBase: string;
+    constructor(sandbox: Sandbox, workspaceBase?: string);
+    private normalisePath;
     readFile(path: string): Promise<string>;
     readFileBuffer(path: string): Promise<Uint8Array>;
     writeFile(path: string, content: string | Uint8Array): Promise<void>;
@@ -45,6 +47,8 @@ interface DaytonaSandboxConfig {
     apiKey?: string;
     apiUrl?: string;
     target?: string;
+    /** Default base path for resolving relative filesystem paths. */
+    workspaceBase?: string;
 }
 interface DaytonaSandboxCreateOptions extends SandboxCreateOptions {
     /** Programming language runtime. Defaults to "python". */
@@ -69,12 +73,16 @@ interface DaytonaSandboxCreateOptions extends SandboxCreateOptions {
     labels?: Record<string, string>;
     /** Timeout in seconds for sandbox creation. Default 60. */
     timeout?: number;
+    /** Base path for resolving relative filesystem paths in this sandbox. */
+    workspaceBase?: string;
 }
 
 declare class DaytonaSandboxProvider implements SandboxProvider<DaytonaSandboxCreateOptions, DaytonaSandbox> {
     readonly id = "daytona";
     readonly capabilities: SandboxCapabilities;
     private client;
+    private readonly defaultWorkspaceBase;
+    private workspaceBaseById;
     constructor(config?: DaytonaSandboxConfig);
     create(options?: DaytonaSandboxCreateOptions): Promise<SandboxCreateResult>;
     get(sandboxId: string): Promise<DaytonaSandbox>;

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

@@ -1,4 +1,4 @@
-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 { 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-BMRzfELQ.js';
 import { Sandbox } from '@daytonaio/sdk';
 import '@temporalio/common';
 
@@ -11,7 +11,9 @@ import '@temporalio/common';
  */
 declare class DaytonaSandboxFileSystem implements SandboxFileSystem {
     private sandbox;
-    constructor(sandbox: Sandbox);
+    readonly workspaceBase: string;
+    constructor(sandbox: Sandbox, workspaceBase?: string);
+    private normalisePath;
     readFile(path: string): Promise<string>;
     readFileBuffer(path: string): Promise<Uint8Array>;
     writeFile(path: string, content: string | Uint8Array): Promise<void>;
@@ -45,6 +47,8 @@ interface DaytonaSandboxConfig {
     apiKey?: string;
     apiUrl?: string;
     target?: string;
+    /** Default base path for resolving relative filesystem paths. */
+    workspaceBase?: string;
 }
 interface DaytonaSandboxCreateOptions extends SandboxCreateOptions {
     /** Programming language runtime. Defaults to "python". */
@@ -69,12 +73,16 @@ interface DaytonaSandboxCreateOptions extends SandboxCreateOptions {
     labels?: Record<string, string>;
     /** Timeout in seconds for sandbox creation. Default 60. */
     timeout?: number;
+    /** Base path for resolving relative filesystem paths in this sandbox. */
+    workspaceBase?: string;
 }
 
 declare class DaytonaSandboxProvider implements SandboxProvider<DaytonaSandboxCreateOptions, DaytonaSandbox> {
     readonly id = "daytona";
     readonly capabilities: SandboxCapabilities;
     private client;
+    private readonly defaultWorkspaceBase;
+    private workspaceBaseById;
     constructor(config?: DaytonaSandboxConfig);
     create(options?: DaytonaSandboxCreateOptions): Promise<SandboxCreateResult>;
     get(sandboxId: string): Promise<DaytonaSandbox>;