agentbox-sdk 0.1.601 → 0.1.603

package/dist/agents/index.d.ts

@@ -1,5 +1,5 @@
-import { o as AgentProviderName, h as AgentOptions, t as AgentRunConfig, s as AgentRun, r as AgentResult, al as RawAgentEvent, b as AgentAttachRequest, B as AttachedRun, as as SetupLayout, ay as UserContent } from '../types-ChkpU7Lf.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, y as AgentUserAnswer, z as AgentUserQuestion, E as ClaudeCodeAgentOptions, F as ClaudeCodeHookConfig, G as ClaudeCodeHookEvent, H as ClaudeCodeHookHandler, I as ClaudeCodeHookMatcherGroup, J as ClaudeCodeHooksConfig, K as ClaudeCodeProviderOptions, L as CodexAgentOptions, M as CodexCommandHook, N as CodexHookEvent, O as CodexHookMatcherGroup, P as CodexHooksConfig, Q as CodexModelProviderConfig, R as CodexProviderOptions, S as CodexSkillEntry, T as DataContent, U as EmbeddedSkillConfig, V as FilePart, W as HarnessCommandDescriptor, X as HarnessCommandInvocation, Y as HarnessCommandSource, _ as ImagePart, $ as MAX_HARNESS_COMMANDS, a0 as MAX_HARNESS_COMMAND_ARGUMENT_HINT, a1 as MAX_HARNESS_COMMAND_DESCRIPTION, a2 as MAX_HARNESS_COMMAND_NAME, a6 as NativeParkBackgroundWork, ab as OpenCodeAgentOptions, ac as OpenCodeCommandEntry, ad as OpenCodePluginConfig, ae as OpenCodePluginEvent, af as OpenCodePluginHookConfig, ag as OpenCodeProviderOptions, ah as OpenCodeSkillEntry, ai as OpenRouterPlugin, an as RepoSkillConfig, au as TextPart, az as UserContentPart, aA as builtinHarnessCommands, aB as claudeHarnessCommands, aC as codexHarnessCommands, aD as codexSkillMention, aG as openCodeHarnessCommands, aH as parseHarnessCommandInvocation, aI as skillDirective } from '../types-ChkpU7Lf.js';
+import { o as AgentProviderName, h as AgentOptions, t as AgentRunConfig, s as AgentRun, r as AgentResult, al as RawAgentEvent, b as AgentAttachRequest, B as AttachedRun, as as SetupLayout, ay as UserContent } from '../types-B_oR4A4a.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, y as AgentUserAnswer, z as AgentUserQuestion, E as ClaudeCodeAgentOptions, F as ClaudeCodeHookConfig, G as ClaudeCodeHookEvent, H as ClaudeCodeHookHandler, I as ClaudeCodeHookMatcherGroup, J as ClaudeCodeHooksConfig, K as ClaudeCodeProviderOptions, L as CodexAgentOptions, M as CodexCommandHook, N as CodexHookEvent, O as CodexHookMatcherGroup, P as CodexHooksConfig, Q as CodexModelProviderConfig, R as CodexProviderOptions, S as CodexSkillEntry, T as DataContent, U as EmbeddedSkillConfig, V as FilePart, W as HarnessCommandDescriptor, X as HarnessCommandInvocation, Y as HarnessCommandSource, _ as ImagePart, $ as MAX_HARNESS_COMMANDS, a0 as MAX_HARNESS_COMMAND_ARGUMENT_HINT, a1 as MAX_HARNESS_COMMAND_DESCRIPTION, a2 as MAX_HARNESS_COMMAND_NAME, a6 as NativeParkBackgroundWork, ab as OpenCodeAgentOptions, ac as OpenCodeCommandEntry, ad as OpenCodePluginConfig, ae as OpenCodePluginEvent, af as OpenCodePluginHookConfig, ag as OpenCodeProviderOptions, ah as OpenCodeSkillEntry, ai as OpenRouterPlugin, an as RepoSkillConfig, au as TextPart, az as UserContentPart, aA as builtinHarnessCommands, aB as claudeHarnessCommands, aC as codexHarnessCommands, aD as codexSkillMention, aG as openCodeHarnessCommands, aH as parseHarnessCommandInvocation, aI as skillDirective } from '../types-B_oR4A4a.js';
 import { S as Sandbox } from '../Sandbox-DcKAU-E3.js';
 export { AgentProvider } from '../enums.js';
 import 'e2b';

package/dist/agents/index.js

@@ -15,7 +15,7 @@ import {
   parseHarnessCommandInvocation,
   resolveHarnessCommand,
   skillDirective
-} from "../chunk-ZITMGTVR.js";
+} from "../chunk-JO6LTAAD.js";
 import "../chunk-AE2FQ6YU.js";
 import {
   AGENT_RESERVED_PORTS,

package/dist/{chunk-ZITMGTVR.js → chunk-JO6LTAAD.js}

@@ -2193,6 +2193,11 @@ function asArray(value) {
 }
 var SCHEDULE_TOOLS = /* @__PURE__ */ new Set(["CronCreate", "ScheduleWakeup"]);
 var DONE_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "killed"]);
+var SUBAGENT_TASK_TYPES = /* @__PURE__ */ new Set(["local_agent", "local_workflow", "subagent"]);
+var SUBAGENT_RESULT_GRACE_MS = 6e4;
+function holdsBackgroundCeiling(tasks, exemptSubagents) {
+  return exemptSubagents === true && tasks.some((task) => SUBAGENT_TASK_TYPES.has(task.type));
+}
 var BackgroundTaskTracker = class {
   tasks = /* @__PURE__ */ new Map();
   wakeups = /* @__PURE__ */ new Map();
@@ -2371,21 +2376,42 @@ function withTimeout(promise, ms) {
   return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
 }
 var BackgroundWait = class {
-  constructor(graceMs, ceilingMs) {
+  constructor(graceMs, ceilingMs, held = false) {
     this.graceMs = graceMs;
+    this.ceilingMs = ceilingMs;
     this.expired = new Promise((resolve) => {
       this.expire = resolve;
     });
-    if (Number.isFinite(ceilingMs)) {
-      this.ceiling = setTimeout(() => this.expire("ceiling"), Math.min(ceilingMs, MAX_TIMER_MS));
-    }
+    if (held) this.heldSince = this.startedAt;
+    else this.armCeiling();
   }
   graceMs;
+  ceilingMs;
   expired;
   expire;
   grace;
   ceiling;
   startedAt = Date.now();
+  heldMs = 0;
+  heldSince;
+  /** Stop the ceiling while a subagent is live; resume it with what is left once none is. */
+  hold(held) {
+    if (held === (this.heldSince !== void 0)) return;
+    if (held) {
+      clearTimeout(this.ceiling);
+      this.ceiling = void 0;
+      this.heldSince = Date.now();
+      return;
+    }
+    this.heldMs += Date.now() - this.heldSince;
+    this.heldSince = void 0;
+    this.armCeiling(SUBAGENT_RESULT_GRACE_MS);
+  }
+  armCeiling(floorMs = 0) {
+    if (!Number.isFinite(this.ceilingMs)) return;
+    const leftMs = Math.max(floorMs, this.ceilingMs - this.elapsedMs());
+    this.ceiling = setTimeout(() => this.expire("ceiling"), Math.min(leftMs, MAX_TIMER_MS));
+  }
   /** Arm the grace timer while nothing is live; disarm it once a task appears. */
   setIdle(idle) {
     if (!idle) {
@@ -2399,8 +2425,11 @@ var BackgroundWait = class {
   finish() {
     this.expire("finished");
   }
+  /** Time counted against the budget: held time excluded. */
   elapsedMs() {
-    return Date.now() - this.startedAt;
+    const now = Date.now();
+    const held = this.heldMs + (this.heldSince === void 0 ? 0 : now - this.heldSince);
+    return now - this.startedAt - held;
   }
   clear() {
     clearTimeout(this.grace);
@@ -2453,9 +2482,14 @@ var NativeClaudeSession = class {
   iterator;
   handlers;
   parked;
-  // Absolute end of the background budget, carried across parks so a CLI
-  // that is adopted and parked again cannot extend its own ceiling.
-  parkDeadline = Infinity;
+  // The background budget, carried across parks so a CLI that is adopted and
+  // parked again cannot extend its own ceiling: what was left of it at
+  // `budgetSince`, and it runs from then on. Unset while a subagent holds it.
+  budgetLeftMs = Infinity;
+  budgetSince = Date.now();
+  exemptSubagents = false;
+  // What is live in the CLI, from every message it produces.
+  tasks = new BackgroundTaskTracker();
   buffer = [];
   bufferedBytes = 0;
   bufferedResults = 0;
@@ -2503,30 +2537,59 @@ var NativeClaudeSession = class {
    * Keep the CLI after the attached run settles. `inflight` is a read that
    * run started but never consumed; its message is buffered, not lost.
    */
-  park(tasks, ttlMs, parking, inflight) {
+  park(tasks, ttlMs, parking, inflight, options = {}) {
     if (this.ending || !this.iterator) return false;
     this.handlers = void 0;
-    this.parkDeadline = Math.min(
-      this.parkDeadline,
-      Number.isFinite(ttlMs) ? Date.now() + Math.max(0, ttlMs) : Infinity
+    this.budgetLeftMs = Math.min(
+      this.budgetLeft(),
+      Number.isFinite(ttlMs) ? Math.max(0, ttlMs) : Infinity
     );
-    const parked = { tasks, parking, waking: false, wokeAt: 0 };
-    if (Number.isFinite(this.parkDeadline)) {
-      parked.timer = setTimeout(
-        () => {
-          if (this.parked !== parked) return;
-          debugClaude("\u2605 parked CLI ran out of background budget; ending it");
-          void this.end();
-        },
-        Math.min(Math.max(0, this.parkDeadline - Date.now()), 2147483647)
-      );
-      parked.timer.unref?.();
-    }
-    this.parked = parked;
+    if (this.budgetSince !== void 0) this.budgetSince = Date.now();
+    this.exemptSubagents = options.exemptSubagents === true;
+    this.parked = { tasks, parking, waking: false, wokeAt: 0 };
     parkedSessions.set(this.sessionId, this);
+    this.updateBudget();
+    this.armBudget();
     void this.pump(inflight);
     return true;
   }
+  budgetLeft() {
+    return this.budgetSince === void 0 ? this.budgetLeftMs : this.budgetLeftMs - (Date.now() - this.budgetSince);
+  }
+  /** Hold the budget while an exempt subagent is live. True when that changed. */
+  updateBudget() {
+    const held = holdsBackgroundCeiling(
+      this.tasks.liveTasks(),
+      this.exemptSubagents
+    );
+    if (held === (this.budgetSince === void 0)) return false;
+    if (held) {
+      this.budgetLeftMs = this.budgetLeft();
+      this.budgetSince = void 0;
+    } else {
+      this.budgetLeftMs = Math.max(this.budgetLeftMs, SUBAGENT_RESULT_GRACE_MS);
+      this.budgetSince = Date.now();
+    }
+    return true;
+  }
+  /** While parked, end the CLI once a running budget is spent. */
+  armBudget() {
+    const parked = this.parked;
+    if (!parked) return;
+    clearTimeout(parked.timer);
+    parked.timer = void 0;
+    if (this.budgetSince === void 0 || !Number.isFinite(this.budgetLeftMs))
+      return;
+    parked.timer = setTimeout(
+      () => {
+        if (this.parked !== parked) return;
+        debugClaude("\u2605 parked CLI ran out of background budget; ending it");
+        void this.end();
+      },
+      Math.min(Math.max(0, this.budgetLeft()), MAX_TIMER_MS)
+    );
+    parked.timer.unref?.();
+  }
   /**
    * A later run takes the parked CLI over: it learns what was live and how
    * many results precede its own turn, then reads what was buffered. An
@@ -2540,7 +2603,8 @@ var NativeClaudeSession = class {
     clearTimeout(parked.timer);
     this.parked = void 0;
     parkedSessions.delete(this.sessionId);
-    const budgetLeftMs = Number.isFinite(this.parkDeadline) ? Math.max(0, this.parkDeadline - Date.now()) : null;
+    const left = this.budgetLeft();
+    const budgetLeftMs = Number.isFinite(left) ? Math.max(0, left) : null;
     const preamble = [
       { _parked: { tasks: parked.tasks, turns, budgetLeftMs } },
       ...this.buffer
@@ -2575,6 +2639,8 @@ var NativeClaudeSession = class {
         const { started, ended } = turnEdges(result.value);
         if (started) this.turnActive = true;
         if (ended) this.turnActive = false;
+        this.tasks.ingest(result.value);
+        if (this.updateBudget()) this.armBudget();
       }
       return result;
     });
@@ -4045,6 +4111,10 @@ async function consumeClaudeMessages(request, sink, messages, executeStartedAt,
   const timeoutMs = resolveBackgroundTaskTimeoutMs(
     request.options.backgroundTaskTimeoutMs
   );
+  const holdsCeiling = (live) => holdsBackgroundCeiling(
+    live,
+    request.options.exemptSubagentsFromBackgroundTimeout
+  );
   const graceMs = wait.graceMs ?? BACKGROUND_TASK_GRACE_MS;
   let pendingWait;
   let waitedMs = 0;
@@ -4077,8 +4147,9 @@ async function consumeClaudeMessages(request, sink, messages, executeStartedAt,
   const tryPark = async (inflight) => {
     const live = tracker.liveTasks();
     const ttlMs = budgetLeftMs();
-    if (!wait.park || live.length === 0 || isAborted() || ttlMs <= 0)
-      return false;
+    const held = holdsCeiling(live);
+    if (!wait.park || live.length === 0 || isAborted()) return false;
+    if (held ? !wait.parkHoldsSubagents : ttlMs <= 0) return false;
     parked = await wait.park(live, ttlMs, inflight).catch(() => false);
     if (parked)
       debugClaude(
@@ -4174,6 +4245,7 @@ async function consumeClaudeMessages(request, sink, messages, executeStartedAt,
         endWait();
       }
       emitTasks(tracker.liveTasks(), pendingWait !== void 0);
+      pendingWait?.hold(holdsCeiling(tracker.liveTasks()));
       const sessionState = message.type === "system" && message.subtype === "session_state_changed" ? message.state : void 0;
       if (sessionState) sawSessionState = true;
       pendingWait?.setIdle(
@@ -4342,7 +4414,11 @@ async function consumeClaudeMessages(request, sink, messages, executeStartedAt,
         );
         endWait();
         pendingWait = finishWait.watch(
-          new BackgroundWait(graceMs, Math.max(0, timeoutMs - waitedMs))
+          new BackgroundWait(
+            graceMs,
+            Math.max(0, timeoutMs - waitedMs),
+            holdsCeiling(live)
+          )
         );
         pendingWait.setIdle(!sawSessionState && live.length === 0);
         emitTasks(live, true);
@@ -4667,7 +4743,10 @@ async function executeNativeClaude(request, sink, wait = {}) {
           );
         },
         ...parking && owned ? {
-          park: async (tasks, ttlMs, inflight) => parked = owned.park(tasks, ttlMs, parking, inflight),
+          park: async (tasks, ttlMs, inflight) => parked = owned.park(tasks, ttlMs, parking, inflight, {
+            exemptSubagents: request.options.exemptSubagentsFromBackgroundTimeout
+          }),
+          parkHoldsSubagents: true,
           // The CLI lives on in the session; nothing to let go of.
           detach: async () => void 0
         } : {}
@@ -4912,6 +4991,18 @@ function codexConfigDir(options) {
 var REMOTE_CODEX_APP_SERVER_PORT = 43181;
 var REMOTE_CODEX_APP_SERVER_ID = "shared-app-server";
 var CODEX_APP_SERVER_TOKEN_FILENAME = "codex-app-server-token";
+var MAX_CODEX_RECONNECTS = 3;
+var CODEX_RECONNECT_TIMEOUT_MS = 3e4;
+function missedCodexNotifications(thread, threadId, turnId, seenItemIds) {
+  const active = thread.status?.type === "active";
+  const turn = turnId ? thread.turns?.find((candidate) => candidate.id === turnId) : void 0;
+  if (!turn) return active ? [] : void 0;
+  const ended = turn.status === "completed" || turn.status === "failed";
+  if (!ended && (turn.status !== "inProgress" || !active)) return void 0;
+  const missed = (turn.items ?? []).filter((item) => typeof item.id === "string" && !seenItemIds.has(item.id) && item.status !== "inProgress").map((item) => ({ method: "item/completed", params: { threadId, turnId, item } }));
+  if (ended) missed.push({ method: "turn/completed", params: { threadId, turn: { ...turn, items: [] } } });
+  return missed;
+}
 function defaultRemoteCodexTokenPath() {
   return path10.posix.join(
     agentboxRoot(AgentProvider.Codex, true),
@@ -5742,25 +5833,28 @@ async function createRuntime(request, inputParts) {
       () => sandbox.getPreviewLink(REMOTE_CODEX_APP_SERVER_PORT)
     );
     const token = await getCodexAppServerToken(sandbox);
-    const transport = await connectRemoteCodexAppServer(
-      toRemoteCodexWebSocketUrl(previewUrl),
-      withCodexAppServerAuthHeaders(sandbox.previewHeaders, token)
-    );
-    debugCodex("\u2605 codex transport established");
-    return {
-      source: transport.source,
-      writeLine: transport.send,
-      cleanup: async () => {
-        await transport?.close().catch(() => void 0);
-      },
-      raw: {
-        transport: transport.raw,
-        previewUrl,
-        port: REMOTE_CODEX_APP_SERVER_PORT,
-        codexDir
-      },
-      inputItems
+    const connect = async () => {
+      const transport = await connectRemoteCodexAppServer(
+        toRemoteCodexWebSocketUrl(previewUrl),
+        withCodexAppServerAuthHeaders(sandbox.previewHeaders, token)
+      );
+      return {
+        source: transport.source,
+        writeLine: transport.send,
+        cleanup: async () => {
+          await transport.close().catch(() => void 0);
+        },
+        raw: {
+          transport: transport.raw,
+          previewUrl,
+          port: REMOTE_CODEX_APP_SERVER_PORT,
+          codexDir
+        }
+      };
     };
+    const connection = await connect();
+    debugCodex("\u2605 codex transport established");
+    return { ...connection, reconnect: connect, inputItems };
   }
   const binary = options.provider?.binary ?? "codex";
   if (options.sandbox) {
@@ -5927,7 +6021,7 @@ var CodexAgentAdapter = class {
         runId: request.runId
       })
     );
-    const client = runtime.client ?? new JsonRpcLineClient(
+    let client = runtime.client ?? new JsonRpcLineClient(
       runtime.source,
       runtime.writeLine
     );
@@ -5985,6 +6079,8 @@ var CodexAgentAdapter = class {
     const pendingFileChanges = /* @__PURE__ */ new Map();
     const fileItemKey = (params, itemId) => typeof params?.threadId === "string" && typeof params.turnId === "string" && typeof itemId === "string" ? `${params.threadId}:${params.turnId}:${itemId}` : void 0;
     let streamedText = "";
+    const completedItemIds = /* @__PURE__ */ new Set();
+    const replayedItemIds = /* @__PURE__ */ new Set();
     const timeoutMs = resolveBackgroundTaskTimeoutMs(request.options.backgroundTaskTimeoutMs);
     const isRootThread = (params) => !params?.threadId || params.threadId === rootThreadId;
     let goalStatus = request.run.goal ? "active" : void 0;
@@ -6021,29 +6117,82 @@ var CodexAgentAdapter = class {
       };
       void (async () => {
         let firstClientMessageLogged = false;
-        const iterator = client.messages()[Symbol.asyncIterator]();
-        for (let next = iterator.next(); ; next = iterator.next()) {
-          let step;
+        let iterator = client.messages()[Symbol.asyncIterator]();
+        let next;
+        const replay = [];
+        let reconnects = 0;
+        const reconnect = async (cause) => {
+          if (!runtime.reconnect || abortInvoked || !rootThreadId || reconnects >= MAX_CODEX_RECONNECTS) return false;
+          reconnects++;
+          debugCodex("\u2605 transport lost (%o); reconnecting (attempt %d)", cause, reconnects);
+          let connection;
           try {
-            step = pendingWait ? await Promise.race([
-              next.then((result) => ({ result })),
-              pendingWait.expired.then((reason) => ({ reason }))
-            ]) : { result: await next };
+            connection = await runtime.reconnect();
+            const nextClient = new JsonRpcLineClient(connection.source, connection.writeLine);
+            const resumed = await withTimeout((async () => {
+              await initializeCodexClient(nextClient);
+              return nextClient.request("thread/resume", { threadId: rootThreadId });
+            })(), CODEX_RECONNECT_TIMEOUT_MS);
+            const missed = resumed?.thread && missedCodexNotifications(resumed.thread, rootThreadId, turnId, completedItemIds);
+            if (!missed || abortInvoked) throw new Error("Codex thread could not be rejoined.");
+            const previous = runtime;
+            runtime = { ...runtime, ...connection };
+            await previous.cleanup().catch(() => void 0);
+            client = nextClient;
+            iterator = client.messages()[Symbol.asyncIterator]();
+            sink.setRaw(runtime.raw);
+            replay.push(...missed);
+            debugCodex("\u2605 rejoined thread %s; replaying %d notification(s)", rootThreadId, missed.length);
+            return true;
           } catch (error) {
-            if (settleOnFailure(error)) return;
-            throw error;
+            debugCodex("\u2605 reconnect failed: %o", error);
+            await connection?.cleanup().catch(() => void 0);
+            return false;
           }
-          if ("reason" in step) {
-            if (!abortInvoked) {
-              debugCodex("\u2605 native goal wait over (%s)", step.reason);
-              settle();
-              return;
+        };
+        for (; ; ) {
+          let step;
+          const replayed = replay.shift();
+          if (replayed) {
+            step = { result: { done: false, value: replayed } };
+          } else {
+            const read = next ??= iterator.next();
+            try {
+              step = pendingWait ? await Promise.race([
+                read.then((result) => ({ result })),
+                pendingWait.expired.then((reason) => ({ reason }))
+              ]) : { result: await read };
+            } catch (error) {
+              next = void 0;
+              if (settleOnFailure(error)) return;
+              if (await reconnect(error)) continue;
+              throw error;
             }
-            endWait();
-            step = { result: await next };
+            if ("reason" in step) {
+              if (!abortInvoked) {
+                debugCodex("\u2605 native goal wait over (%s)", step.reason);
+                settle();
+                return;
+              }
+              endWait();
+              step = { result: await read };
+            }
+            next = void 0;
+          }
+          if (step.result.done) {
+            if (pendingWait && lastTurn) break;
+            if (await reconnect(new Error("Codex transport closed."))) continue;
+            break;
           }
-          if (step.result.done) break;
           const message = step.result.value;
+          if (message.method === "item/completed") {
+            const id = message.params?.item?.id;
+            if (typeof id === "string") {
+              if (replayed) replayedItemIds.add(id);
+              else if (replayedItemIds.has(id)) continue;
+              completedItemIds.add(id);
+            }
+          }
           if (!firstClientMessageLogged) {
             firstClientMessageLogged = true;
             debugCodex(
@@ -7197,7 +7346,9 @@ var OpenCodeAgentAdapter = class {
       );
       const wait = new BackgroundWait(
         BACKGROUND_TASK_GRACE_MS,
-        Math.max(0, backgroundTimeoutMs - waitedMs)
+        Math.max(0, backgroundTimeoutMs - waitedMs),
+        // Every child waited on here is a subagent.
+        request.options.exemptSubagentsFromBackgroundTimeout === true
       );
       pendingWait = wait;
       void wait.expired.then((reason) => {

package/dist/events/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AISDKEvent, C as BackgroundTask, D as BackgroundTasksEvent, Z as HarnessCommandsEvent, a3 as MessageCompletedEvent, a4 as MessageInjectedEvent, a5 as MessageStartedEvent, a7 as NativePlanEvent, a8 as NormalizedAgentEvent, a9 as NormalizedAgentEventBase, aa as NormalizedAgentEventType, aj as PermissionRequestedEvent, ak as PermissionResolvedEvent, al as RawAgentEvent, am as ReasoningDeltaEvent, ao as RunCancelledEvent, ap as RunCompletedEvent, aq as RunErrorEvent, ar as RunStartedEvent, at as TextDeltaEvent, av as ToolCallCompletedEvent, aw as ToolCallDeltaEvent, ax as ToolCallStartedEvent, aE as createNormalizedEvent, aF as normalizeRawAgentEvent, aJ as toAISDKEvent, aK as toAISDKStream } from '../types-ChkpU7Lf.js';
+export { A as AISDKEvent, C as BackgroundTask, D as BackgroundTasksEvent, Z as HarnessCommandsEvent, a3 as MessageCompletedEvent, a4 as MessageInjectedEvent, a5 as MessageStartedEvent, a7 as NativePlanEvent, a8 as NormalizedAgentEvent, a9 as NormalizedAgentEventBase, aa as NormalizedAgentEventType, aj as PermissionRequestedEvent, ak as PermissionResolvedEvent, al as RawAgentEvent, am as ReasoningDeltaEvent, ao as RunCancelledEvent, ap as RunCompletedEvent, aq as RunErrorEvent, ar as RunStartedEvent, at as TextDeltaEvent, av as ToolCallCompletedEvent, aw as ToolCallDeltaEvent, ax as ToolCallStartedEvent, aE as createNormalizedEvent, aF as normalizeRawAgentEvent, aJ as toAISDKEvent, aK as toAISDKStream } from '../types-B_oR4A4a.js';
 import { AgentProvider } from '../enums.js';
 import '../Sandbox-DcKAU-E3.js';
 import 'e2b';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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 AgentUserAnswer, z as AgentUserQuestion, B as AttachedRun, C as BackgroundTask, D as BackgroundTasksEvent, E as ClaudeCodeAgentOptions, F as ClaudeCodeHookConfig, G as ClaudeCodeHookEvent, H as ClaudeCodeHookHandler, I as ClaudeCodeHookMatcherGroup, J as ClaudeCodeHooksConfig, K as ClaudeCodeProviderOptions, L as CodexAgentOptions, M as CodexCommandHook, N as CodexHookEvent, O as CodexHookMatcherGroup, P as CodexHooksConfig, Q as CodexModelProviderConfig, R as CodexProviderOptions, S as CodexSkillEntry, T as DataContent, U as EmbeddedSkillConfig, V as FilePart, W as HarnessCommandDescriptor, X as HarnessCommandInvocation, Y as HarnessCommandSource, Z as HarnessCommandsEvent, _ as ImagePart, $ as MAX_HARNESS_COMMANDS, a0 as MAX_HARNESS_COMMAND_ARGUMENT_HINT, a1 as MAX_HARNESS_COMMAND_DESCRIPTION, a2 as MAX_HARNESS_COMMAND_NAME, a3 as MessageCompletedEvent, a4 as MessageInjectedEvent, a5 as MessageStartedEvent, a6 as NativeParkBackgroundWork, a7 as NativePlanEvent, a8 as NormalizedAgentEvent, a9 as NormalizedAgentEventBase, aa as NormalizedAgentEventType, ab as OpenCodeAgentOptions, ac as OpenCodeCommandEntry, ad as OpenCodePluginConfig, ae as OpenCodePluginEvent, af as OpenCodePluginHookConfig, ag as OpenCodeProviderOptions, ah as OpenCodeSkillEntry, ai as OpenRouterPlugin, aj as PermissionRequestedEvent, ak as PermissionResolvedEvent, al as RawAgentEvent, am as ReasoningDeltaEvent, an as RepoSkillConfig, ao as RunCancelledEvent, ap as RunCompletedEvent, aq as RunErrorEvent, ar as RunStartedEvent, as as SetupLayout, at as TextDeltaEvent, au as TextPart, av as ToolCallCompletedEvent, aw as ToolCallDeltaEvent, ax as ToolCallStartedEvent, ay as UserContent, az as UserContentPart, aA as builtinHarnessCommands, aB as claudeHarnessCommands, aC as codexHarnessCommands, aD as codexSkillMention, aE as createNormalizedEvent, aF as normalizeRawAgentEvent, aG as openCodeHarnessCommands, aH as parseHarnessCommandInvocation, aI as skillDirective, aJ as toAISDKEvent, aK as toAISDKStream } from './types-ChkpU7Lf.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 AgentUserAnswer, z as AgentUserQuestion, B as AttachedRun, C as BackgroundTask, D as BackgroundTasksEvent, E as ClaudeCodeAgentOptions, F as ClaudeCodeHookConfig, G as ClaudeCodeHookEvent, H as ClaudeCodeHookHandler, I as ClaudeCodeHookMatcherGroup, J as ClaudeCodeHooksConfig, K as ClaudeCodeProviderOptions, L as CodexAgentOptions, M as CodexCommandHook, N as CodexHookEvent, O as CodexHookMatcherGroup, P as CodexHooksConfig, Q as CodexModelProviderConfig, R as CodexProviderOptions, S as CodexSkillEntry, T as DataContent, U as EmbeddedSkillConfig, V as FilePart, W as HarnessCommandDescriptor, X as HarnessCommandInvocation, Y as HarnessCommandSource, Z as HarnessCommandsEvent, _ as ImagePart, $ as MAX_HARNESS_COMMANDS, a0 as MAX_HARNESS_COMMAND_ARGUMENT_HINT, a1 as MAX_HARNESS_COMMAND_DESCRIPTION, a2 as MAX_HARNESS_COMMAND_NAME, a3 as MessageCompletedEvent, a4 as MessageInjectedEvent, a5 as MessageStartedEvent, a6 as NativeParkBackgroundWork, a7 as NativePlanEvent, a8 as NormalizedAgentEvent, a9 as NormalizedAgentEventBase, aa as NormalizedAgentEventType, ab as OpenCodeAgentOptions, ac as OpenCodeCommandEntry, ad as OpenCodePluginConfig, ae as OpenCodePluginEvent, af as OpenCodePluginHookConfig, ag as OpenCodeProviderOptions, ah as OpenCodeSkillEntry, ai as OpenRouterPlugin, aj as PermissionRequestedEvent, ak as PermissionResolvedEvent, al as RawAgentEvent, am as ReasoningDeltaEvent, an as RepoSkillConfig, ao as RunCancelledEvent, ap as RunCompletedEvent, aq as RunErrorEvent, ar as RunStartedEvent, as as SetupLayout, at as TextDeltaEvent, au as TextPart, av as ToolCallCompletedEvent, aw as ToolCallDeltaEvent, ax as ToolCallStartedEvent, ay as UserContent, az as UserContentPart, aA as builtinHarnessCommands, aB as claudeHarnessCommands, aC as codexHarnessCommands, aD as codexSkillMention, aE as createNormalizedEvent, aF as normalizeRawAgentEvent, aG as openCodeHarnessCommands, aH as parseHarnessCommandInvocation, aI as skillDirective, aJ as toAISDKEvent, aK as toAISDKStream } from './types-B_oR4A4a.js';
 export { AGENT_RESERVED_PORTS, Agent, HarnessCapabilities, HarnessCommand, agentboxRoot, collectAllAgentReservedPorts, getAgentLayout, harnessCapabilities, resolveHarnessCommand } 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';

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   parseHarnessCommandInvocation,
   resolveHarnessCommand,
   skillDirective
-} from "./chunk-ZITMGTVR.js";
+} from "./chunk-JO6LTAAD.js";
 import {
   ProviderLogAssembler,
   createNormalizedEvent,

package/dist/{types-ChkpU7Lf.d.ts → types-B_oR4A4a.d.ts}

@@ -625,6 +625,17 @@ interface AgentOptionsBase {
      * settles immediately.
      */
     backgroundTaskTimeoutMs?: number;
+    /**
+     * Leave background subagents out of {@link backgroundTaskTimeoutMs}: while
+     * one is live (Claude Code background agents and workflows, OpenCode
+     * background children) the budget does not run, so the ceiling never stops
+     * a working subagent. Shells, monitors and scheduled wakeups are still
+     * bounded once no subagent is live. Covers the run's own waits and native
+     * Claude Code parks; a sandbox run keeps waiting instead of parking while a
+     * subagent is live, since the daemon's park TTL cannot be held. Default
+     * `false`. `backgroundTaskTimeoutMs: 0` still abandons everything.
+     */
+    exemptSubagentsFromBackgroundTimeout?: boolean;
     /**
      * Keep every normalized and raw event in memory for the life of the run so
      * {@link AgentResult.events} / {@link AgentResult.rawEvents} can replay it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentbox-sdk",
-  "version": "0.1.601",
+  "version": "0.1.603",
   "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
   "license": "MIT",
   "repository": {