agentbox-sdk 0.1.308 → 0.1.309

package/dist/{Sandbox-K6VNqKeo.d.ts → Sandbox-DcKAU-E3.d.ts}

@@ -258,6 +258,14 @@ declare class Sandbox<P extends SandboxProviderName = SandboxProviderName> {
      * cached internally).
      */
     findOrProvision(): Promise<this>;
+    /**
+     * Attach to an existing sandbox by id, skipping the
+     * `findMatchingSandbox` lookup. Useful when the caller just created the
+     * sandbox (e.g. via a provider-native fork API) and knows its id.
+     * Repeated calls are cheap. Currently only the Daytona adapter
+     * implements this; other providers throw.
+     */
+    attachById(id: string): Promise<this>;
     openPort(port: number): Promise<this>;
     setSecret(name: string, value: string): this;
     setSecrets(values: Record<string, string>): this;

package/dist/agents/index.d.ts

@@ -1,6 +1,6 @@
-import { o as AgentProviderName, h as AgentOptions, t as AgentRunConfig, s as AgentRun, r as AgentResult, a2 as RawAgentEvent, b as AgentAttachRequest, y as AttachedRun } from '../types-CZdyLzA4.js';
-export { a as AgentApprovalMode, c as AgentCommandConfig, d as AgentCostData, e as AgentExecutionRequest, f as AgentLocalMcpConfig, g as AgentMcpConfig, i as AgentOptionsBase, j as AgentOptionsMap, k as AgentPermissionDecision, l as AgentPermissionKind, m as AgentPermissionResponse, n as AgentProviderAdapter, p as AgentReasoningEffort, q as AgentRemoteMcpConfig, u as AgentRunSink, v as AgentSetupRequest, w as AgentSkillConfig, x as AgentSubAgentConfig, 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, X as OpenCodeAgentOptions, Y as OpenCodePluginConfig, Z as OpenCodePluginEvent, _ as OpenCodePluginHookConfig, $ as OpenCodeProviderOptions, a4 as RepoSkillConfig, aa as TextPart, ae as UserContent, af as UserContentPart } from '../types-CZdyLzA4.js';
-import { S as Sandbox } from '../Sandbox-K6VNqKeo.js';
+import { o as AgentProviderName, h as AgentOptions, t as AgentRunConfig, s as AgentRun, r as AgentResult, a2 as RawAgentEvent, b as AgentAttachRequest, y as AttachedRun, a9 as SetupLayout } from '../types-DmkbgYmn.js';
+export { a as AgentApprovalMode, c as AgentCommandConfig, d as AgentCostData, e as AgentExecutionRequest, f as AgentLocalMcpConfig, g as AgentMcpConfig, i as AgentOptionsBase, j as AgentOptionsMap, k as AgentPermissionDecision, l as AgentPermissionKind, m as AgentPermissionResponse, n as AgentProviderAdapter, p as AgentReasoningEffort, q as AgentRemoteMcpConfig, u as AgentRunSink, v as AgentSetupRequest, w as AgentSkillConfig, x as AgentSubAgentConfig, 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, X as OpenCodeAgentOptions, Y as OpenCodePluginConfig, Z as OpenCodePluginEvent, _ as OpenCodePluginHookConfig, $ as OpenCodeProviderOptions, a4 as RepoSkillConfig, ab as TextPart, af as UserContent, ag as UserContentPart } from '../types-DmkbgYmn.js';
+import { S as Sandbox } from '../Sandbox-DcKAU-E3.js';
 export { AgentProvider } from '../enums.js';
 import 'e2b';
 import '@vercel/sandbox';
@@ -67,6 +67,28 @@ declare class Agent<P extends AgentProviderName = AgentProviderName> {
     static attach<P extends AgentProviderName>(request: AgentAttachRequest<P>): Promise<AttachedRun>;
 }
 
+/**
+ * The on-disk root for every artifact agentbox writes for a given
+ * provider. Deterministic — same inputs, same path — so `setup()` and
+ * `execute()` agree on file locations without any data channel between
+ * them.
+ *
+ *  - **Sandbox**: `/tmp/agentbox/<provider>` inside the sandbox.
+ *  - **Local host**: `<os.tmpdir()>/agentbox-<provider>` on the host.
+ */
+declare function agentboxRoot(provider: AgentProviderName, hasSandbox?: boolean): string;
+/**
+ * Resolve the on-disk layout (config dirs per provider) for the given
+ * agentbox root. Public so external consumers (e.g. agentbox-driven
+ * orchestrators) can locate where each CLI writes its files without
+ * having to hardcode the layout shape.
+ *
+ * Pair with {@link agentboxRoot} to get the root for `(provider,
+ * hasSandbox)` first, then call this to expand it into the per-provider
+ * dirs (`claudeDir`, `codexDir`, `opencodeDir`, …).
+ */
+declare function getAgentLayout(rootDir: string): SetupLayout;
+
 /**
  * Ports each agent harness needs exposed on its sandbox in order to reach
  * its app-server (or equivalent local server). These are used to:
@@ -85,4 +107,4 @@ declare class Agent<P extends AgentProviderName = AgentProviderName> {
 declare const AGENT_RESERVED_PORTS: Record<AgentProviderName, readonly number[]>;
 declare function collectAllAgentReservedPorts(): number[];
 
-export { AGENT_RESERVED_PORTS, Agent, AgentAttachRequest, AgentOptions, AgentProviderName, AgentResult, AgentRun, AgentRunConfig, AttachedRun, collectAllAgentReservedPorts };
+export { AGENT_RESERVED_PORTS, Agent, AgentAttachRequest, AgentOptions, AgentProviderName, AgentResult, AgentRun, AgentRunConfig, AttachedRun, SetupLayout, agentboxRoot, collectAllAgentReservedPorts, getAgentLayout };

package/dist/agents/index.js

@@ -1,6 +1,8 @@
 import {
-  Agent
-} from "../chunk-T3RBNOSE.js";
+  Agent,
+  agentboxRoot,
+  getAgentLayout
+} from "../chunk-VBMMNUB7.js";
 import "../chunk-ZDSHOGJ4.js";
 import {
   AGENT_RESERVED_PORTS,
@@ -14,5 +16,7 @@ export {
   AGENT_RESERVED_PORTS,
   Agent,
   AgentProvider,
-  collectAllAgentReservedPorts
+  agentboxRoot,
+  collectAllAgentReservedPorts,
+  getAgentLayout
 };

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

@@ -144,6 +144,44 @@ var SandboxAdapter = class {
     }
     await this.provisioning;
   }
+  /**
+   * Attach to an already-existing sandbox by id. Skips the
+   * `findMatchingSandbox` lookup that `findOrProvision` does — useful when
+   * the caller just created the sandbox (e.g. via a fork API) and knows
+   * its id directly. Idempotent: a second call is a no-op once attached.
+   *
+   * Default implementation throws — providers opt in by overriding
+   * `attachExisting`. Currently implemented by the Daytona adapter.
+   */
+  async attachById(id) {
+    if (this.provisioned) {
+      return;
+    }
+    if (!this.provisioning) {
+      this.provisioning = time(
+        debugSandbox,
+        `attachById [${this.provider}] ${id}`,
+        async () => {
+          await this.attachExisting(id);
+          this.provisioned = true;
+        }
+      ).finally(() => {
+        this.provisioning = void 0;
+      });
+    }
+    await this.provisioning;
+  }
+  /**
+   * Provider hook for `attachById`. Adopt the sandbox with the given id
+   * (e.g. fetch via the provider client, mark `isWarmFlag`, start if
+   * paused). Throw if the provider doesn't support direct attach.
+   */
+  async attachExisting(id) {
+    void id;
+    throw new Error(
+      `attachById is not supported by the ${this.provider} provider.`
+    );
+  }
   /**
    * Throw a consistent error when a method that needs a provisioned
    * sandbox is called before `findOrProvision()`. Provider adapters call
@@ -238,6 +276,19 @@ var DaytonaSandboxAdapter = class extends SandboxAdapter {
   get id() {
     return this.sandbox?.id;
   }
+  async attachExisting(id) {
+    const existing = await this.client.get(id);
+    if (!existing) {
+      throw new Error(`Daytona sandbox ${id} not found`);
+    }
+    this.sandbox = existing;
+    const state = existing.state ?? "unknown";
+    const isWarm = state === "started";
+    if (!isWarm) {
+      await existing.start();
+    }
+    this.isWarmFlag = isWarm;
+  }
   async provision() {
     const existing = await this.findMatchingSandbox();
     if (existing) {
@@ -284,9 +335,9 @@ var DaytonaSandboxAdapter = class extends SandboxAdapter {
     this.requireProvisioned();
     const sandbox = this.requireSandbox();
     const result = await sandbox.process.executeCommand(
-      toShellCommand(command),
+      this.buildSessionCommand(command, options),
       options?.cwd ?? this.workingDir,
-      this.getMergedEnv(options?.env),
+      void 0,
       options?.timeoutMs ? Math.ceil(options.timeoutMs / 1e3) : void 0
     );
     const output = result.result ?? "";
@@ -2120,6 +2171,17 @@ var Sandbox = class {
     );
     return this;
   }
+  /**
+   * Attach to an existing sandbox by id, skipping the
+   * `findMatchingSandbox` lookup. Useful when the caller just created the
+   * sandbox (e.g. via a provider-native fork API) and knows its id.
+   * Repeated calls are cheap. Currently only the Daytona adapter
+   * implements this; other providers throw.
+   */
+  async attachById(id) {
+    await this.adapter.attachById(id);
+    return this;
+  }
   async openPort(port) {
     await time(
       debugSandbox,

package/dist/{chunk-T3RBNOSE.js → chunk-VBMMNUB7.js}

@@ -893,10 +893,10 @@ function shortLabel(command) {
   const oneLine = command.replace(/\s+/g, " ").trim();
   return oneLine.length > 60 ? `${oneLine.slice(0, 60)}\u2026` : oneLine;
 }
-function agentboxRoot(provider, hasSandbox) {
+function agentboxRoot(provider, hasSandbox = true) {
   return hasSandbox ? `/tmp/agentbox/${provider}` : path4.join(os.tmpdir(), `agentbox-${provider}`);
 }
-function buildLayout(rootDir) {
+function getAgentLayout(rootDir) {
   const xdgConfigHome = path4.join(rootDir, ".config");
   return {
     rootDir,
@@ -1108,7 +1108,7 @@ ${output}` : "";
 async function createSetupTarget(provider, setupId, options) {
   return time(debugRuntime, `createSetupTarget ${provider}`, async () => {
     void setupId;
-    const layout = buildLayout(
+    const layout = getAgentLayout(
       agentboxRoot(provider, Boolean(options.sandbox))
     );
     if (options.sandbox) {
@@ -3864,12 +3864,17 @@ function buildOpenCodeConfig(options, interactiveApproval) {
     ])
   );
   const googleBaseUrl = options.env?.GOOGLE_BASE_URL;
+  const openRouterBaseUrl = options.env?.OPENROUTER_BASE_URL;
   return {
     $schema: "https://opencode.ai/config.json",
     ...mcpConfig ? { mcp: mcpConfig } : {},
     ...commandsConfig ? { command: commandsConfig } : {},
     provider: {
-      openrouter: { options: { baseURL: "https://openrouter.ai/api/v1" } },
+      openrouter: {
+        options: {
+          baseURL: openRouterBaseUrl || "https://openrouter.ai/api/v1"
+        }
+      },
       ...googleBaseUrl ? { google: { options: { baseURL: googleBaseUrl } } } : {}
     },
     agent: {
@@ -5156,5 +5161,7 @@ var Agent = class {
 };
 
 export {
+  agentboxRoot,
+  getAgentLayout,
   Agent
 };

package/dist/events/index.d.ts

@@ -1,6 +1,6 @@
-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-CZdyLzA4.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, aa as TextDeltaEvent, ac as ToolCallCompletedEvent, ad as ToolCallDeltaEvent, ae as ToolCallStartedEvent, ah as createNormalizedEvent, ai as normalizeRawAgentEvent, aj as toAISDKEvent, ak as toAISDKStream } from '../types-DmkbgYmn.js';
 import { AgentProvider } from '../enums.js';
-import '../Sandbox-K6VNqKeo.js';
+import '../Sandbox-DcKAU-E3.js';
 import 'e2b';
 import '@vercel/sandbox';
 import '@daytonaio/sdk';

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 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-CZdyLzA4.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-K6VNqKeo.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 SetupLayout, aa as TextDeltaEvent, ab as TextPart, ac as ToolCallCompletedEvent, ad as ToolCallDeltaEvent, ae as ToolCallStartedEvent, af as UserContent, ag as UserContentPart, ah as createNormalizedEvent, ai as normalizeRawAgentEvent, aj as toAISDKEvent, ak as toAISDKStream } from './types-DmkbgYmn.js';
+export { AGENT_RESERVED_PORTS, Agent, agentboxRoot, collectAllAgentReservedPorts, getAgentLayout } 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-DcKAU-E3.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,6 +1,8 @@
 import {
-  Agent
-} from "./chunk-T3RBNOSE.js";
+  Agent,
+  agentboxRoot,
+  getAgentLayout
+} from "./chunk-VBMMNUB7.js";
 import {
   ProviderLogAssembler,
   createNormalizedEvent,
@@ -12,7 +14,7 @@ import {
   Sandbox,
   SandboxAdapter,
   buildGitCloneCommand
-} from "./chunk-QNNAAVJV.js";
+} from "./chunk-HYHLKO3L.js";
 import {
   AGENT_RESERVED_PORTS,
   collectAllAgentReservedPorts
@@ -30,9 +32,11 @@ export {
   Sandbox,
   SandboxAdapter,
   SandboxProvider,
+  agentboxRoot,
   buildGitCloneCommand,
   collectAllAgentReservedPorts,
   createNormalizedEvent,
+  getAgentLayout,
   normalizeRawAgentEvent,
   toAISDKEvent,
   toAISDKStream

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-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';
+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-DcKAU-E3.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-DcKAU-E3.js';
 export { SandboxProvider } from '../enums.js';
 import 'e2b';
 import '@vercel/sandbox';
@@ -60,6 +60,22 @@ declare abstract class SandboxAdapter<TProvider extends SandboxProviderName = Sa
      * (potentially slow) sandbox attach / create happens.
      */
     findOrProvision(): Promise<void>;
+    /**
+     * Attach to an already-existing sandbox by id. Skips the
+     * `findMatchingSandbox` lookup that `findOrProvision` does — useful when
+     * the caller just created the sandbox (e.g. via a fork API) and knows
+     * its id directly. Idempotent: a second call is a no-op once attached.
+     *
+     * Default implementation throws — providers opt in by overriding
+     * `attachExisting`. Currently implemented by the Daytona adapter.
+     */
+    attachById(id: string): Promise<void>;
+    /**
+     * Provider hook for `attachById`. Adopt the sandbox with the given id
+     * (e.g. fetch via the provider client, mark `isWarmFlag`, start if
+     * paused). Throw if the provider doesn't support direct attach.
+     */
+    protected attachExisting(id: string): Promise<void>;
     /**
      * Throw a consistent error when a method that needs a provisioned
      * sandbox is called before `findOrProvision()`. Provider adapters call

package/dist/sandboxes/index.js

@@ -2,7 +2,7 @@ import {
   Sandbox,
   SandboxAdapter,
   buildGitCloneCommand
-} from "../chunk-QNNAAVJV.js";
+} from "../chunk-HYHLKO3L.js";
 import "../chunk-AVXJMCBC.js";
 import "../chunk-NSJM57Z4.js";
 import {

package/dist/{types-CZdyLzA4.d.ts → types-DmkbgYmn.d.ts}

@@ -1,5 +1,5 @@
 import { AgentProvider } from './enums.js';
-import { S as Sandbox } from './Sandbox-K6VNqKeo.js';
+import { S as Sandbox } from './Sandbox-DcKAU-E3.js';
 
 interface RawAgentEvent<TPayload = unknown> {
     provider: string;
@@ -284,6 +284,15 @@ interface AgentCommandConfig {
     model?: string;
     subtask?: boolean;
 }
+interface SetupLayout {
+    rootDir: string;
+    homeDir: string;
+    xdgConfigHome: string;
+    agentsDir: string;
+    claudeDir: string;
+    opencodeDir: string;
+    codexDir: string;
+}
 
 type AgentProviderName = AgentProvider;
 type DataContent = string | URL | Uint8Array | ArrayBuffer | Buffer;
@@ -581,4 +590,4 @@ interface AgentProviderAdapter<P extends AgentProviderName = AgentProviderName>
     attachSendMessage(request: AgentAttachRequest<P>, content: UserContent): Promise<void>;
 }
 
-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 };
+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 SetupLayout as a9, type TextDeltaEvent as aa, type TextPart as ab, type ToolCallCompletedEvent as ac, type ToolCallDeltaEvent as ad, type ToolCallStartedEvent as ae, type UserContent as af, type UserContentPart as ag, createNormalizedEvent as ah, normalizeRawAgentEvent as ai, toAISDKEvent as aj, toAISDKStream as ak, 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.308",
+  "version": "0.1.309",
   "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
   "license": "MIT",
   "repository": {