agentbox-sdk 0.1.301 → 0.1.303

package/dist/{chunk-ZOWBRUQR.js → chunk-NWAXQ7UD.js}

@@ -155,6 +155,7 @@ function toAISDKEvent(event) {
       };
     case "message.completed":
     case "run.completed":
+    case "run.cancelled":
       return {
         type: "response-finish",
         id: event.runId,
@@ -376,9 +377,130 @@ var OpenCodeLogAssembler = class {
     return clone(next);
   }
 };
+var ClaudeCodeLogAssembler = class {
+  currentMessageId = null;
+  textByMessageId = /* @__PURE__ */ new Map();
+  thinkingByMessageId = /* @__PURE__ */ new Map();
+  byMessageId = /* @__PURE__ */ new Map();
+  process(event) {
+    if (!isRecord(event)) return [];
+    const type = typeof event.type === "string" ? event.type : "";
+    if (type === "stream_event") {
+      const stream = isRecord(event.event) ? event.event : null;
+      if (!stream) return [];
+      const streamType = typeof stream.type === "string" ? stream.type : "";
+      if (streamType === "message_start") {
+        const message = isRecord(stream.message) ? stream.message : null;
+        const id = message && typeof message.id === "string" ? message.id : null;
+        if (!id) return [];
+        this.currentMessageId = id;
+        if (!this.textByMessageId.has(id)) this.textByMessageId.set(id, "");
+        if (!this.thinkingByMessageId.has(id))
+          this.thinkingByMessageId.set(id, "");
+        return [this.upsertMessage(id)];
+      }
+      if (streamType === "content_block_delta") {
+        const id = this.currentMessageId;
+        if (!id) return [];
+        const delta = isRecord(stream.delta) ? stream.delta : null;
+        if (!delta) return [];
+        if (delta.type === "text_delta" && typeof delta.text === "string" && delta.text) {
+          const text = (this.textByMessageId.get(id) ?? "") + delta.text;
+          this.textByMessageId.set(id, text);
+          return [this.upsertMessage(id)];
+        }
+        if (delta.type === "thinking_delta" && typeof delta.thinking === "string" && delta.thinking) {
+          const thinking = (this.thinkingByMessageId.get(id) ?? "") + delta.thinking;
+          this.thinkingByMessageId.set(id, thinking);
+          return [this.upsertMessage(id)];
+        }
+        return [];
+      }
+      return [];
+    }
+    if (type === "assistant") {
+      const message = isRecord(event.message) ? event.message : null;
+      const id = message && typeof message.id === "string" ? message.id : null;
+      if (!id || !message) {
+        return [clone(event)];
+      }
+      const final = extractClaudeAssistantContent(message);
+      this.textByMessageId.set(id, final.text);
+      this.thinkingByMessageId.set(id, final.thinking);
+      const snapshot = this.upsertMessage(id, final.extraBlocks);
+      this.currentMessageId = null;
+      return [snapshot];
+    }
+    return [clone(event)];
+  }
+  seed(snapshots) {
+    this.currentMessageId = null;
+    this.textByMessageId.clear();
+    this.thinkingByMessageId.clear();
+    this.byMessageId.clear();
+    for (const snapshot of snapshots) {
+      if (!isRecord(snapshot)) continue;
+      if (snapshot.type !== "message.updated") continue;
+      const messageId = typeof snapshot.messageId === "string" ? snapshot.messageId : null;
+      if (!messageId) continue;
+      this.byMessageId.set(messageId, clone(snapshot));
+      const message = isRecord(snapshot.message) ? snapshot.message : null;
+      const content = message && Array.isArray(message.content) ? message.content : [];
+      let text = "";
+      let thinking = "";
+      for (const block of content) {
+        if (!isRecord(block)) continue;
+        if (block.type === "text" && typeof block.text === "string") {
+          text += block.text;
+        } else if (block.type === "thinking" && typeof block.thinking === "string") {
+          thinking += block.thinking;
+        }
+      }
+      this.textByMessageId.set(messageId, text);
+      this.thinkingByMessageId.set(messageId, thinking);
+    }
+  }
+  upsertMessage(messageId, extraBlocks = []) {
+    const text = this.textByMessageId.get(messageId) ?? "";
+    const thinking = this.thinkingByMessageId.get(messageId) ?? "";
+    const content = [];
+    if (text) content.push({ type: "text", text });
+    if (thinking) content.push({ type: "thinking", thinking });
+    for (const block of extraBlocks) content.push(clone(block));
+    const next = {
+      type: "message.updated",
+      messageId,
+      message: {
+        id: messageId,
+        role: "assistant",
+        content
+      }
+    };
+    this.byMessageId.set(messageId, next);
+    return clone(next);
+  }
+};
+function extractClaudeAssistantContent(message) {
+  const content = Array.isArray(message.content) ? message.content : [];
+  let text = "";
+  let thinking = "";
+  const extraBlocks = [];
+  for (const block of content) {
+    if (!isRecord(block)) continue;
+    if (block.type === "text" && typeof block.text === "string") {
+      text += block.text;
+    } else if (block.type === "thinking" && typeof block.thinking === "string") {
+      thinking += block.thinking;
+    } else {
+      extraBlocks.push(clone(block));
+    }
+  }
+  return { text, thinking, extraBlocks };
+}
 var ProviderLogAssembler = class {
   codex = new CodexLogAssembler();
   openCode = new OpenCodeLogAssembler();
+  claudeCode = new ClaudeCodeLogAssembler();
   /**
    * Process a raw provider event and return any newly-produced assembled
    * snapshots. May return an empty array when the event is non-stateful (e.g.
@@ -391,6 +513,9 @@ var ProviderLogAssembler = class {
     if (provider === AgentProvider.OpenCode || provider === "opencode") {
       return this.openCode.process(event);
     }
+    if (provider === AgentProvider.ClaudeCode || provider === "claude-code") {
+      return this.claudeCode.process(event);
+    }
     if (isRecord(event)) {
       return [clone(event)];
     }
@@ -411,14 +536,17 @@ var ProviderLogAssembler = class {
       this.openCode.seed(snapshots);
       return;
     }
+    if (provider === AgentProvider.ClaudeCode || provider === "claude-code") {
+      this.claudeCode.seed(snapshots);
+      return;
+    }
   }
   /**
    * Given a sequence of assembled snapshots (typically the persisted history
    * for a run), return one entry per item / part with the latest snapshot
    * winning, preserving first-seen order.
    *
-   * For providers that don't have a stateful item model (Claude Code), or
-   * for unrecognized snapshot shapes, entries are returned in original order
+   * For unrecognized snapshot shapes, entries are returned in original order
    * with no dedup.
    */
   static dedupeSnapshots(provider, snapshots) {
@@ -429,6 +557,12 @@ var ProviderLogAssembler = class {
         return item && typeof item.id === "string" ? `item:${item.id}` : null;
       });
     }
+    if (provider === AgentProvider.ClaudeCode || provider === "claude-code") {
+      return dedupeByKey(snapshots, (snapshot) => {
+        const messageId = typeof snapshot.messageId === "string" ? snapshot.messageId : null;
+        return messageId ? `message:${messageId}` : null;
+      });
+    }
     if (provider === AgentProvider.OpenCode || provider === "opencode") {
       return dedupeByKey(snapshots, (snapshot) => {
         const properties = isRecord(snapshot.properties) ? snapshot.properties : null;

package/dist/{chunk-LPKKT6YT.js → chunk-QNNAAVJV.js}

@@ -5,11 +5,12 @@ import {
   debugSandbox,
   pipeReadableStream,
   readNodeStream,
+  readStreamAsBytes,
   readStreamAsText,
   sleep,
   suppressUnhandledRejection,
   time
-} from "./chunk-INMA52FV.js";
+} from "./chunk-AVXJMCBC.js";
 import {
   shellQuote,
   toShellCommand
@@ -68,7 +69,7 @@ var SandboxAdapter = class {
    * `provision()` implementations. Stays `false` until `findOrProvision()`
    * has resolved.
    */
-  wasFoundFlag = false;
+  isWarmFlag = false;
   constructor(options) {
     this.options = options;
     this.baseEnv = { ...options.env ?? {} };
@@ -167,8 +168,8 @@ var SandboxAdapter = class {
    * idempotent setup that the previous run already performed (e.g.
    * `agent.setup()`). Always `false` before `findOrProvision()` resolves.
    */
-  get wasFound() {
-    return this.wasFoundFlag;
+  get isWarm() {
+    return this.isWarmFlag;
   }
   /**
    * Headers that callers should attach to HTTP / WebSocket requests they make
@@ -241,8 +242,9 @@ var DaytonaSandboxAdapter = class extends SandboxAdapter {
     const existing = await this.findMatchingSandbox();
     if (existing) {
       this.sandbox = existing;
+      const isWarm = existing.state === "started";
       await existing.start();
-      this.wasFoundFlag = true;
+      this.isWarmFlag = isWarm;
       return;
     }
     const labels = this.getLabels();
@@ -517,7 +519,7 @@ var E2bSandboxAdapter = class extends SandboxAdapter {
     const existing = await this.findMatchingSandbox();
     if (existing) {
       this.sandbox = existing;
-      this.wasFoundFlag = true;
+      this.isWarmFlag = true;
       return;
     }
     const template = resolveSandboxImage(this.options.image);
@@ -1284,6 +1286,7 @@ var LocalDockerSandboxAdapter = class extends SandboxAdapter {
 };
 
 // src/sandboxes/providers/modal.ts
+import path from "path";
 import { ModalClient } from "modal";
 
 // src/sandboxes/tarball.ts
@@ -1350,7 +1353,7 @@ var ModalSandboxAdapter = class extends SandboxAdapter {
     const existing = await this.findMatchingSandbox();
     if (existing) {
       this.sandbox = existing;
-      this.wasFoundFlag = true;
+      this.isWarmFlag = true;
       return;
     }
     const appName = this.options.provider?.appName ?? "agentbox";
@@ -1535,6 +1538,74 @@ ${command}`;
       raw: process2
     };
   }
+  /**
+   * Upload `content` to `targetPath` inside the Modal sandbox.
+   *
+   * Modal's TS SDK only exposes a `Sandbox.open()` FileIO handle for direct
+   * filesystem access, which is deprecated and capped at 100 MiB per
+   * operation. To match the cross-provider semantics (works for arbitrarily
+   * large artifacts, parent dirs are created on demand), we instead pipe
+   * raw bytes through stdin into a single `mkdir -p … && cat > …` shell —
+   * the same single-exec pattern `uploadAndRun` uses.
+   */
+  async uploadFile(content, targetPath) {
+    this.requireProvisioned();
+    const sandbox = this.requireSandbox();
+    const data = Buffer.isBuffer(content) ? content : Buffer.from(content, "utf8");
+    const dir = path.posix.dirname(targetPath);
+    const wrapped = dir && dir !== "." && dir !== "/" ? `set -e; mkdir -p ${shellQuote(dir)}; cat > ${shellQuote(targetPath)}` : `set -e; cat > ${shellQuote(targetPath)}`;
+    const proc = await sandbox.exec(["/bin/sh", "-c", wrapped], {
+      mode: "binary"
+    });
+    const writer = proc.stdin.getWriter();
+    try {
+      await writer.write(data);
+      await writer.close();
+    } finally {
+      try {
+        writer.releaseLock();
+      } catch {
+      }
+    }
+    const [stderrBytes, exitCode] = await Promise.all([
+      readStreamAsBytes(proc.stderr),
+      proc.wait()
+    ]);
+    if (exitCode !== 0) {
+      const stderr = stderrBytes.toString("utf8").trim();
+      throw new Error(
+        `Failed to upload file to Modal sandbox at ${targetPath} (exit ${exitCode})${stderr ? `: ${stderr}` : ""}`
+      );
+    }
+  }
+  /**
+   * Download a file from the Modal sandbox as raw bytes.
+   *
+   * Implemented by `cat`-ing the file in a binary-mode `exec` and
+   * collecting stdout. This matches the cross-provider contract (returns a
+   * Node `Buffer` of the file's exact bytes) and avoids the deprecated
+   * 100 MiB FileIO cap on `Sandbox.open()`.
+   */
+  async downloadFile(sourcePath) {
+    this.requireProvisioned();
+    const sandbox = this.requireSandbox();
+    const proc = await sandbox.exec(
+      ["/bin/sh", "-c", `cat -- ${shellQuote(sourcePath)}`],
+      { mode: "binary" }
+    );
+    const [stdoutBytes, stderrBytes, exitCode] = await Promise.all([
+      readStreamAsBytes(proc.stdout),
+      readStreamAsBytes(proc.stderr),
+      proc.wait()
+    ]);
+    if (exitCode !== 0) {
+      const stderr = stderrBytes.toString("utf8").trim();
+      throw new Error(
+        `Failed to download file from Modal sandbox at ${sourcePath} (exit ${exitCode})${stderr ? `: ${stderr}` : ""}`
+      );
+    }
+    return stdoutBytes;
+  }
   async list(options) {
     const sandboxes = [];
     for await (const sandbox of this.client.sandboxes.list({
@@ -2032,8 +2103,8 @@ var Sandbox = class {
    * idempotent setup that the previous run already performed (e.g.
    * `agent.setup()`). Always `false` before `findOrProvision()` resolves.
    */
-  get wasFound() {
-    return this.adapter.wasFound;
+  get isWarm() {
+    return this.adapter.isWarm;
   }
   /**
    * Attach to an existing tagged sandbox or create a new one. Must be

package/dist/events/index.d.ts

@@ -1,6 +1,6 @@
-export { A as AISDKEvent, S as MessageCompletedEvent, T as MessageInjectedEvent, U as MessageStartedEvent, V as NormalizedAgentEvent, W as NormalizedAgentEventBase, X as NormalizedAgentEventType, a1 as PermissionRequestedEvent, a2 as PermissionResolvedEvent, a3 as RawAgentEvent, a4 as ReasoningDeltaEvent, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, a9 as TextDeltaEvent, ab as ToolCallCompletedEvent, ac as ToolCallDeltaEvent, ad as ToolCallStartedEvent, ag as createNormalizedEvent, ah as normalizeRawAgentEvent, ai as toAISDKEvent, aj as toAISDKStream } from '../types-B3N-Qo2q.js';
+export { A as AISDKEvent, R as MessageCompletedEvent, S as MessageInjectedEvent, T as MessageStartedEvent, U as NormalizedAgentEvent, V as NormalizedAgentEventBase, W as NormalizedAgentEventType, a0 as PermissionRequestedEvent, a1 as PermissionResolvedEvent, a2 as RawAgentEvent, a3 as ReasoningDeltaEvent, a5 as RunCancelledEvent, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, a9 as TextDeltaEvent, ab as ToolCallCompletedEvent, ac as ToolCallDeltaEvent, ad as ToolCallStartedEvent, ag as createNormalizedEvent, ah as normalizeRawAgentEvent, ai as toAISDKEvent, aj as toAISDKStream } from '../types-Ozo1rHKs.js';
 import { AgentProvider } from '../enums.js';
-import '../Sandbox-CByFJI8X.js';
+import '../Sandbox-K6VNqKeo.js';
 import 'e2b';
 import '@vercel/sandbox';
 import '@daytonaio/sdk';
@@ -62,6 +62,7 @@ type JsonRecord = Record<string, unknown>;
 declare class ProviderLogAssembler {
     private readonly codex;
     private readonly openCode;
+    private readonly claudeCode;
     /**
      * Process a raw provider event and return any newly-produced assembled
      * snapshots. May return an empty array when the event is non-stateful (e.g.
@@ -80,8 +81,7 @@ declare class ProviderLogAssembler {
      * for a run), return one entry per item / part with the latest snapshot
      * winning, preserving first-seen order.
      *
-     * For providers that don't have a stateful item model (Claude Code), or
-     * for unrecognized snapshot shapes, entries are returned in original order
+     * For unrecognized snapshot shapes, entries are returned in original order
      * with no dedup.
      */
     static dedupeSnapshots(provider: AgentProvider | string | null | undefined, snapshots: JsonRecord[]): JsonRecord[];

package/dist/events/index.js

@@ -4,7 +4,7 @@ import {
   normalizeRawAgentEvent,
   toAISDKEvent,
   toAISDKStream
-} from "../chunk-ZOWBRUQR.js";
+} from "../chunk-NWAXQ7UD.js";
 import "../chunk-GOFJNFAD.js";
 export {
   ProviderLogAssembler,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { A as AISDKEvent, a as AgentApprovalMode, b as AgentAttachRequest, c as AgentCommandConfig, d as AgentCostData, e as AgentExecutionRequest, f as AgentLocalMcpConfig, g as AgentMcpConfig, h as AgentOptions, i as AgentOptionsBase, j as AgentOptionsMap, k as AgentPermissionDecision, l as AgentPermissionKind, m as AgentPermissionResponse, n as AgentProviderAdapter, o as AgentProviderName, p as AgentReasoningEffort, q as AgentRemoteMcpConfig, r as AgentResult, s as AgentRun, t as AgentRunConfig, u as AgentRunSink, v as AgentSetupConfig, w as AgentSetupRequest, x as AgentSkillConfig, y as AgentSubAgentConfig, z as AttachedRun, C as ClaudeCodeAgentOptions, B as ClaudeCodeHookConfig, D as ClaudeCodeHookEvent, E as ClaudeCodeHookHandler, F as ClaudeCodeHookMatcherGroup, G as ClaudeCodeHooksConfig, H as ClaudeCodeProviderOptions, I as CodexAgentOptions, J as CodexCommandHook, K as CodexHookEvent, L as CodexHookMatcherGroup, M as CodexHooksConfig, N as CodexProviderOptions, O as DataContent, P as EmbeddedSkillConfig, Q as FilePart, R as ImagePart, S as MessageCompletedEvent, T as MessageInjectedEvent, U as MessageStartedEvent, V as NormalizedAgentEvent, W as NormalizedAgentEventBase, X as NormalizedAgentEventType, Y as OpenCodeAgentOptions, Z as OpenCodePluginConfig, _ as OpenCodePluginEvent, $ as OpenCodePluginHookConfig, a0 as OpenCodeProviderOptions, a1 as PermissionRequestedEvent, a2 as PermissionResolvedEvent, a3 as RawAgentEvent, a4 as ReasoningDeltaEvent, a5 as RepoSkillConfig, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, a9 as TextDeltaEvent, aa as TextPart, ab as ToolCallCompletedEvent, ac as ToolCallDeltaEvent, ad as ToolCallStartedEvent, ae as UserContent, af as UserContentPart, ag as createNormalizedEvent, ah as normalizeRawAgentEvent, ai as toAISDKEvent, aj as toAISDKStream } from './types-B3N-Qo2q.js';
+export { A as AISDKEvent, a as AgentApprovalMode, b as AgentAttachRequest, c as AgentCommandConfig, d as AgentCostData, e as AgentExecutionRequest, f as AgentLocalMcpConfig, g as AgentMcpConfig, h as AgentOptions, i as AgentOptionsBase, j as AgentOptionsMap, k as AgentPermissionDecision, l as AgentPermissionKind, m as AgentPermissionResponse, n as AgentProviderAdapter, o as AgentProviderName, p as AgentReasoningEffort, q as AgentRemoteMcpConfig, r as AgentResult, s as AgentRun, t as AgentRunConfig, u as AgentRunSink, v as AgentSetupRequest, w as AgentSkillConfig, x as AgentSubAgentConfig, y as AttachedRun, C as ClaudeCodeAgentOptions, z as ClaudeCodeHookConfig, B as ClaudeCodeHookEvent, D as ClaudeCodeHookHandler, E as ClaudeCodeHookMatcherGroup, F as ClaudeCodeHooksConfig, G as ClaudeCodeProviderOptions, H as CodexAgentOptions, I as CodexCommandHook, J as CodexHookEvent, K as CodexHookMatcherGroup, L as CodexHooksConfig, M as CodexProviderOptions, N as DataContent, O as EmbeddedSkillConfig, P as FilePart, Q as ImagePart, R as MessageCompletedEvent, S as MessageInjectedEvent, T as MessageStartedEvent, U as NormalizedAgentEvent, V as NormalizedAgentEventBase, W as NormalizedAgentEventType, X as OpenCodeAgentOptions, Y as OpenCodePluginConfig, Z as OpenCodePluginEvent, _ as OpenCodePluginHookConfig, $ as OpenCodeProviderOptions, a0 as PermissionRequestedEvent, a1 as PermissionResolvedEvent, a2 as RawAgentEvent, a3 as ReasoningDeltaEvent, a4 as RepoSkillConfig, a5 as RunCancelledEvent, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, a9 as TextDeltaEvent, aa as TextPart, ab as ToolCallCompletedEvent, ac as ToolCallDeltaEvent, ad as ToolCallStartedEvent, ae as UserContent, af as UserContentPart, ag as createNormalizedEvent, ah as normalizeRawAgentEvent, ai as toAISDKEvent, aj as toAISDKStream } from './types-Ozo1rHKs.js';
 export { AGENT_RESERVED_PORTS, Agent, collectAllAgentReservedPorts } from './agents/index.js';
-export { A as AsyncCommandHandle, C as CommandEvent, a as CommandOptions, b as CommandResult, D as DaytonaProviderOptions, c as DaytonaSandboxOptions, E as E2bProviderOptions, d as E2bSandboxOptions, G as GitCloneOptions, L as LocalDockerProviderOptions, e as LocalDockerSandboxOptions, M as ModalProviderOptions, f as ModalSandboxOptions, S as Sandbox, g as SandboxDescriptor, h as SandboxListOptions, i as SandboxOptions, j as SandboxOptionsBase, k as SandboxOptionsMap, l as SandboxProviderName, m as SandboxRaw, n as SandboxRawMap, o as SandboxResourceSpec, T as TarballEntry, V as VercelGitSource, p as VercelProviderOptions, q as VercelSandboxOptions } from './Sandbox-CByFJI8X.js';
+export { A as AsyncCommandHandle, C as CommandEvent, a as CommandOptions, b as CommandResult, D as DaytonaProviderOptions, c as DaytonaSandboxOptions, E as E2bProviderOptions, d as E2bSandboxOptions, G as GitCloneOptions, L as LocalDockerProviderOptions, e as LocalDockerSandboxOptions, M as ModalProviderOptions, f as ModalSandboxOptions, S as Sandbox, g as SandboxDescriptor, h as SandboxListOptions, i as SandboxOptions, j as SandboxOptionsBase, k as SandboxOptionsMap, l as SandboxProviderName, m as SandboxRaw, n as SandboxRawMap, o as SandboxResourceSpec, T as TarballEntry, V as VercelGitSource, p as VercelProviderOptions, q as VercelSandboxOptions } from './Sandbox-K6VNqKeo.js';
 export { SandboxAdapter, buildGitCloneCommand } from './sandboxes/index.js';
 export { ProviderLogAssembler } from './events/index.js';
 export { AgentProvider, SandboxProvider } from './enums.js';

package/dist/index.js

@@ -1,22 +1,22 @@
 import {
   Agent
-} from "./chunk-4MBB6QHD.js";
+} from "./chunk-GBM7LKZF.js";
 import {
   ProviderLogAssembler,
   createNormalizedEvent,
   normalizeRawAgentEvent,
   toAISDKEvent,
   toAISDKStream
-} from "./chunk-ZOWBRUQR.js";
+} from "./chunk-NWAXQ7UD.js";
 import {
   Sandbox,
   SandboxAdapter,
   buildGitCloneCommand
-} from "./chunk-LPKKT6YT.js";
+} from "./chunk-QNNAAVJV.js";
 import {
   AGENT_RESERVED_PORTS,
   collectAllAgentReservedPorts
-} from "./chunk-INMA52FV.js";
+} from "./chunk-AVXJMCBC.js";
 import "./chunk-NSJM57Z4.js";
 import {
   AgentProvider,

package/dist/sandboxes/index.d.ts

@@ -1,5 +1,5 @@
-import { l as SandboxProviderName, i as SandboxOptions, a as CommandOptions, b as CommandResult, A as AsyncCommandHandle, h as SandboxListOptions, g as SandboxDescriptor, T as TarballEntry, G as GitCloneOptions } from '../Sandbox-CByFJI8X.js';
-export { C as CommandEvent, D as DaytonaProviderOptions, c as DaytonaSandboxOptions, E as E2bProviderOptions, d as E2bSandboxOptions, L as LocalDockerProviderOptions, e as LocalDockerSandboxOptions, M as ModalProviderOptions, f as ModalSandboxOptions, S as Sandbox, j as SandboxOptionsBase, k as SandboxOptionsMap, m as SandboxRaw, n as SandboxRawMap, o as SandboxResourceSpec, V as VercelGitSource, p as VercelProviderOptions, q as VercelSandboxOptions } from '../Sandbox-CByFJI8X.js';
+import { l as SandboxProviderName, i as SandboxOptions, a as CommandOptions, b as CommandResult, A as AsyncCommandHandle, h as SandboxListOptions, g as SandboxDescriptor, T as TarballEntry, G as GitCloneOptions } from '../Sandbox-K6VNqKeo.js';
+export { C as CommandEvent, D as DaytonaProviderOptions, c as DaytonaSandboxOptions, E as E2bProviderOptions, d as E2bSandboxOptions, L as LocalDockerProviderOptions, e as LocalDockerSandboxOptions, M as ModalProviderOptions, f as ModalSandboxOptions, S as Sandbox, j as SandboxOptionsBase, k as SandboxOptionsMap, m as SandboxRaw, n as SandboxRawMap, o as SandboxResourceSpec, V as VercelGitSource, p as VercelProviderOptions, q as VercelSandboxOptions } from '../Sandbox-K6VNqKeo.js';
 export { SandboxProvider } from '../enums.js';
 import 'e2b';
 import '@vercel/sandbox';
@@ -19,7 +19,7 @@ declare abstract class SandboxAdapter<TProvider extends SandboxProviderName = Sa
      * `provision()` implementations. Stays `false` until `findOrProvision()`
      * has resolved.
      */
-    protected wasFoundFlag: boolean;
+    protected isWarmFlag: boolean;
     constructor(options: TOptions);
     abstract get provider(): TProvider;
     abstract get raw(): TRaw | undefined;
@@ -74,7 +74,7 @@ declare abstract class SandboxAdapter<TProvider extends SandboxProviderName = Sa
      * idempotent setup that the previous run already performed (e.g.
      * `agent.setup()`). Always `false` before `findOrProvision()` resolves.
      */
-    get wasFound(): boolean;
+    get isWarm(): boolean;
     /**
      * Headers that callers should attach to HTTP / WebSocket requests they make
      * against this sandbox's preview URL. Default is empty; providers like

package/dist/sandboxes/index.js

@@ -2,8 +2,8 @@ import {
   Sandbox,
   SandboxAdapter,
   buildGitCloneCommand
-} from "../chunk-LPKKT6YT.js";
-import "../chunk-INMA52FV.js";
+} from "../chunk-QNNAAVJV.js";
+import "../chunk-AVXJMCBC.js";
 import "../chunk-NSJM57Z4.js";
 import {
   SandboxProvider

package/dist/{types-B3N-Qo2q.d.ts → types-Ozo1rHKs.d.ts}

@@ -1,5 +1,5 @@
 import { AgentProvider } from './enums.js';
-import { S as Sandbox } from './Sandbox-CByFJI8X.js';
+import { S as Sandbox } from './Sandbox-K6VNqKeo.js';
 
 interface RawAgentEvent<TPayload = unknown> {
     provider: string;
@@ -9,7 +9,7 @@ interface RawAgentEvent<TPayload = unknown> {
     payload: TPayload;
 }
 
-type NormalizedAgentEventType = "run.started" | "message.started" | "message.injected" | "text.delta" | "reasoning.delta" | "tool.call.started" | "tool.call.delta" | "tool.call.completed" | "permission.requested" | "permission.resolved" | "message.completed" | "run.completed" | "run.error";
+type NormalizedAgentEventType = "run.started" | "message.started" | "message.injected" | "text.delta" | "reasoning.delta" | "tool.call.started" | "tool.call.delta" | "tool.call.completed" | "permission.requested" | "permission.resolved" | "message.completed" | "run.completed" | "run.cancelled" | "run.error";
 interface NormalizedAgentEventBase {
     provider: string;
     runId: string;
@@ -97,11 +97,15 @@ interface RunCompletedEvent extends NormalizedAgentEventBase {
     type: "run.completed";
     text?: string;
 }
+interface RunCancelledEvent extends NormalizedAgentEventBase {
+    type: "run.cancelled";
+    text?: string;
+}
 interface RunErrorEvent extends NormalizedAgentEventBase {
     type: "run.error";
     error: string;
 }
-type NormalizedAgentEvent = RunStartedEvent | MessageStartedEvent | MessageInjectedEvent | TextDeltaEvent | ReasoningDeltaEvent | ToolCallStartedEvent | ToolCallDeltaEvent | ToolCallCompletedEvent | PermissionRequestedEvent | PermissionResolvedEvent | MessageCompletedEvent | RunCompletedEvent | RunErrorEvent;
+type NormalizedAgentEvent = RunStartedEvent | MessageStartedEvent | MessageInjectedEvent | TextDeltaEvent | ReasoningDeltaEvent | ToolCallStartedEvent | ToolCallDeltaEvent | ToolCallCompletedEvent | PermissionRequestedEvent | PermissionResolvedEvent | MessageCompletedEvent | RunCompletedEvent | RunCancelledEvent | RunErrorEvent;
 declare function createNormalizedEvent<TType extends NormalizedAgentEventType>(type: TType, base: Omit<NormalizedAgentEventBase, "type" | "timestamp"> & {
     timestamp?: string;
 }, extra?: Record<string, unknown>): NormalizedAgentEvent;
@@ -307,16 +311,28 @@ interface AgentRunConfig {
     model?: string;
     systemPrompt?: string;
     resumeSessionId?: string;
+    /**
+     * Source session/thread to fork from. The new run begins in a *new*
+     * session whose history is the prefix of the source up to and including
+     * {@link forkAtMessageId}. Mutually exclusive with {@link resumeSessionId}.
+     * Requires {@link forkAtMessageId}.
+     *
+     * Provider mapping:
+     * - claude-code: `query({ resume, resumeSessionAt, forkSession: true })`
+     * - opencode: `POST /session/:forkSessionId/fork { messageID }`
+     * - codex: emulated via `thread/fork` + `thread/rollback` (no native
+     *   message-level fork in the codex app-server)
+     */
+    forkSessionId?: string;
+    /**
+     * Provider-native message id (claude-code: assistant message UUID;
+     * opencode: message info id; codex: turn id) to fork at — inclusive.
+     * The unified `messageId` field on `message.started` events carries the
+     * value to feed back here. Required when {@link forkSessionId} is set.
+     */
+    forkAtMessageId?: string;
     reasoning?: AgentReasoningEffort;
 }
-/**
- * Subset of {@link AgentRunConfig} that needs to be committed at
- * `agent.setup()` time so the runtime can pre-bake artifacts that
- * reference it (codex `model_instructions_file`, opencode agent config,
- * etc.). Unlike `AgentRunConfig`, this never carries per-turn input or
- * a resumed session id.
- */
-type AgentSetupConfig = Pick<AgentRunConfig, "systemPrompt" | "model" | "reasoning">;
 type AgentApprovalMode = "auto" | "interactive";
 type AgentPermissionKind = "bash" | "edit" | "tool" | "network" | "file-change" | "unknown";
 type AgentPermissionDecision = "allow" | "deny";
@@ -396,6 +412,8 @@ interface AgentResult {
     provider: AgentProviderName;
     sessionId: string;
     text: string;
+    isCancelled: boolean;
+    error?: string;
     rawEvents: RawAgentEvent[];
     events: NormalizedAgentEvent[];
     costData?: AgentCostData | null;
@@ -427,12 +445,15 @@ interface AgentRunSink {
         text?: string;
         costData?: AgentCostData | null;
     }): void;
+    cancel(result?: {
+        text?: string;
+        costData?: AgentCostData | null;
+    }): void;
     fail(error: unknown): void;
 }
 interface AgentSetupRequest<P extends AgentProviderName = AgentProviderName> {
     provider: P;
     options: AgentOptions<P>;
-    config: AgentSetupConfig;
 }
 interface AgentExecutionRequest<P extends AgentProviderName = AgentProviderName> {
     runId: string;
@@ -524,4 +545,4 @@ interface AgentProviderAdapter<P extends AgentProviderName = AgentProviderName>
     attachSendMessage(request: AgentAttachRequest<P>, content: UserContent): Promise<void>;
 }
 
-export { type OpenCodePluginHookConfig as $, type AISDKEvent as A, type ClaudeCodeHookConfig as B, type ClaudeCodeAgentOptions as C, type ClaudeCodeHookEvent as D, type ClaudeCodeHookHandler as E, type ClaudeCodeHookMatcherGroup as F, type ClaudeCodeHooksConfig as G, type ClaudeCodeProviderOptions as H, type CodexAgentOptions as I, type CodexCommandHook as J, type CodexHookEvent as K, type CodexHookMatcherGroup as L, type CodexHooksConfig as M, type CodexProviderOptions as N, type DataContent as O, type EmbeddedSkillConfig as P, type FilePart as Q, type ImagePart as R, type MessageCompletedEvent as S, type MessageInjectedEvent as T, type MessageStartedEvent as U, type NormalizedAgentEvent as V, type NormalizedAgentEventBase as W, type NormalizedAgentEventType as X, type OpenCodeAgentOptions as Y, type OpenCodePluginConfig as Z, type OpenCodePluginEvent as _, type AgentApprovalMode as a, type OpenCodeProviderOptions as a0, type PermissionRequestedEvent as a1, type PermissionResolvedEvent as a2, type RawAgentEvent as a3, type ReasoningDeltaEvent as a4, type RepoSkillConfig as a5, type RunCompletedEvent as a6, type RunErrorEvent as a7, type RunStartedEvent as a8, type TextDeltaEvent as a9, type TextPart as aa, type ToolCallCompletedEvent as ab, type ToolCallDeltaEvent as ac, type ToolCallStartedEvent as ad, type UserContent as ae, type UserContentPart as af, createNormalizedEvent as ag, normalizeRawAgentEvent as ah, toAISDKEvent as ai, toAISDKStream as aj, type AgentAttachRequest as b, type AgentCommandConfig as c, type AgentCostData as d, type AgentExecutionRequest as e, type AgentLocalMcpConfig as f, type AgentMcpConfig as g, type AgentOptions as h, type AgentOptionsBase as i, type AgentOptionsMap as j, type AgentPermissionDecision as k, type AgentPermissionKind as l, type AgentPermissionResponse as m, type AgentProviderAdapter as n, type AgentProviderName as o, type AgentReasoningEffort as p, type AgentRemoteMcpConfig as q, type AgentResult as r, type AgentRun as s, type AgentRunConfig as t, type AgentRunSink as u, type AgentSetupConfig as v, type AgentSetupRequest as w, type AgentSkillConfig as x, type AgentSubAgentConfig as y, type AttachedRun as z };
+export { type OpenCodeProviderOptions as $, type AISDKEvent as A, type ClaudeCodeHookEvent as B, type ClaudeCodeAgentOptions as C, type ClaudeCodeHookHandler as D, type ClaudeCodeHookMatcherGroup as E, type ClaudeCodeHooksConfig as F, type ClaudeCodeProviderOptions as G, type CodexAgentOptions as H, type CodexCommandHook as I, type CodexHookEvent as J, type CodexHookMatcherGroup as K, type CodexHooksConfig as L, type CodexProviderOptions as M, type DataContent as N, type EmbeddedSkillConfig as O, type FilePart as P, type ImagePart as Q, type MessageCompletedEvent as R, type MessageInjectedEvent as S, type MessageStartedEvent as T, type NormalizedAgentEvent as U, type NormalizedAgentEventBase as V, type NormalizedAgentEventType as W, type OpenCodeAgentOptions as X, type OpenCodePluginConfig as Y, type OpenCodePluginEvent as Z, type OpenCodePluginHookConfig as _, type AgentApprovalMode as a, type PermissionRequestedEvent as a0, type PermissionResolvedEvent as a1, type RawAgentEvent as a2, type ReasoningDeltaEvent as a3, type RepoSkillConfig as a4, type RunCancelledEvent as a5, type RunCompletedEvent as a6, type RunErrorEvent as a7, type RunStartedEvent as a8, type TextDeltaEvent as a9, type TextPart as aa, type ToolCallCompletedEvent as ab, type ToolCallDeltaEvent as ac, type ToolCallStartedEvent as ad, type UserContent as ae, type UserContentPart as af, createNormalizedEvent as ag, normalizeRawAgentEvent as ah, toAISDKEvent as ai, toAISDKStream as aj, type AgentAttachRequest as b, type AgentCommandConfig as c, type AgentCostData as d, type AgentExecutionRequest as e, type AgentLocalMcpConfig as f, type AgentMcpConfig as g, type AgentOptions as h, type AgentOptionsBase as i, type AgentOptionsMap as j, type AgentPermissionDecision as k, type AgentPermissionKind as l, type AgentPermissionResponse as m, type AgentProviderAdapter as n, type AgentProviderName as o, type AgentReasoningEffort as p, type AgentRemoteMcpConfig as q, type AgentResult as r, type AgentRun as s, type AgentRunConfig as t, type AgentRunSink as u, type AgentSetupRequest as v, type AgentSkillConfig as w, type AgentSubAgentConfig as x, type AttachedRun as y, type ClaudeCodeHookConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentbox-sdk",
-  "version": "0.1.301",
+  "version": "0.1.303",
   "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
   "license": "MIT",
   "repository": {
@@ -58,7 +58,7 @@
     "bun": ">=1.1.0"
   },
   "dependencies": {
-    "@daytonaio/sdk": "^0.161.0",
+    "@daytonaio/sdk": "^0.171.0",
     "@types/debug": "^4.1.13",
     "@vercel/sandbox": "2.0.0-beta.13",
     "debug": "^4.4.3",