agentbox-sdk 0.1.600 → 0.1.602

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-RSURGSVM.js";
+} from "../chunk-UE4LQEL5.js";
 import "../chunk-AE2FQ6YU.js";
 import {
   AGENT_RESERVED_PORTS,

package/dist/{chunk-RSURGSVM.js → chunk-UE4LQEL5.js}

@@ -30,11 +30,11 @@ import {
 } from "./chunk-GOFJNFAD.js";
 
 // src/agents/Agent.ts
-import { randomUUID as randomUUID3 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 import path12 from "path";
 
 // src/agents/providers/claude-code.ts
-import { randomUUID } from "crypto";
+import { randomUUID as randomUUID2 } from "crypto";
 
 // src/agents/transports/spawn.ts
 import { execFile, spawn } from "child_process";
@@ -1585,13 +1585,13 @@ async function activateRtk(target) {
 }
 
 // src/agents/config/setup-manifest.ts
-import { createHash } from "crypto";
+import { createHash, randomUUID } from "crypto";
 import path6 from "path";
 var MANIFEST_FILENAME = "setup-manifest.json";
-var TARGET_MANIFEST_FILENAME = "setup-target.json";
-var INSTALL_SCRIPT_FILENAME = "install.sh";
+var TARGET_MANIFEST_PREFIX = "setup-target.";
+var INSTALL_SCRIPT_PREFIX = "install.";
 var SETUP_ID_FILENAME = "setup.id";
-var MANIFEST_VERSION = 1;
+var MANIFEST_VERSION = 2;
 function hashArtifact(artifact) {
   const hasher = createHash("sha256");
   hasher.update(artifact.executable ? "1" : "0");
@@ -1685,7 +1685,7 @@ ${detail}` : ""}`
     }
   });
 }
-function buildInstallScript(rootDir, installCommandsByKey) {
+function buildInstallScript(rootDir, targetManifestPath, installCommandsByKey) {
   const commandsB64 = Buffer.from(
     JSON.stringify(installCommandsByKey),
     "utf8"
@@ -1693,7 +1693,7 @@ function buildInstallScript(rootDir, installCommandsByKey) {
   return `#!/usr/bin/env bash
 set -e
 ROOT_DIR=${shellQuote(rootDir)}
-TARGET_MANIFEST="$ROOT_DIR/${TARGET_MANIFEST_FILENAME}"
+TARGET_MANIFEST=${shellQuote(targetManifestPath)}
 EXISTING_MANIFEST="$ROOT_DIR/${MANIFEST_FILENAME}"
 export TARGET_MANIFEST EXISTING_MANIFEST
 
@@ -1702,7 +1702,8 @@ export TARGET_MANIFEST EXISTING_MANIFEST
 # emits the commands themselves, NUL-separated, so bash never has to
 # deserialize JSON.
 STALE_CMDS_FILE="$(mktemp)"
-trap 'rm -f "$STALE_CMDS_FILE"' EXIT
+# This run's target manifest and script are per-run files; remove them.
+trap 'rm -f "$STALE_CMDS_FILE" "$TARGET_MANIFEST" "$0"' EXIT
 COMMANDS_B64=${shellQuote(commandsB64)} \\
 MANIFEST_VERSION=${MANIFEST_VERSION} \\
 python3 - <<'PY' > "$STALE_CMDS_FILE"
@@ -1728,15 +1729,36 @@ stale = [
     for key, hashed in target_cmds.items()
     if commands.get(key) is not None and existing_cmds.get(key) != hashed
 ]
-sys.stdout.write("\\0".join(stale))
+# Terminate every entry: \`read -d ''\` drops a last entry with no NUL.
+sys.stdout.write("".join(cmd + "\\0" for cmd in stale))
 PY
 
+# Run stale commands in parallel, then retry failures one at a time: parallel
+# \`npx\` calls race on a cold npx cache, and the cache is warm by the retry.
+FAILED=0
 if [ -s "$STALE_CMDS_FILE" ]; then
+  CMDS=()
+  PIDS=()
   while IFS= read -r -d '' CMD; do
     [ -z "$CMD" ] && continue
     bash -c "$CMD" &
+    CMDS+=("$CMD")
+    PIDS+=("$!")
   done < "$STALE_CMDS_FILE"
-  wait
+  for i in "\${!PIDS[@]}"; do
+    if ! wait "\${PIDS[$i]}"; then
+      echo "agentbox install failed, retrying: \${CMDS[$i]}" >&2
+      if ! bash -c "\${CMDS[$i]}"; then
+        echo "agentbox install failed: \${CMDS[$i]}" >&2
+        FAILED=1
+      fi
+    fi
+  done
+fi
+
+# Keep the old manifest when an install failed so the next run retries it.
+if [ "$FAILED" -ne 0 ]; then
+  exit 1
 fi
 
 # Persist target manifest as the new manifest atomically. Doing this last
@@ -1745,7 +1767,7 @@ mv "$TARGET_MANIFEST" "$EXISTING_MANIFEST"
 `;
 }
 async function applyDifferentialSetup(target, artifacts, installCommands) {
-  await time(
+  return time(
     debugSetup,
     `applyDifferentialSetup ${target.provider}`,
     async () => {
@@ -1763,7 +1785,16 @@ async function applyDifferentialSetup(target, artifacts, installCommands) {
           ])
         )
       };
+      const runId = randomUUID();
       const rootDir = target.layout.rootDir;
+      const targetManifestPath = path6.posix.join(
+        rootDir,
+        `${TARGET_MANIFEST_PREFIX}${runId}.json`
+      );
+      const installScriptPath = path6.posix.join(
+        rootDir,
+        `${INSTALL_SCRIPT_PREFIX}${runId}.sh`
+      );
       const tarballEntries = [
         ...artifacts.map((artifact) => ({
           path: artifact.path,
@@ -1771,22 +1802,36 @@ async function applyDifferentialSetup(target, artifacts, installCommands) {
           mode: artifact.executable ? 493 : 420
         })),
         {
-          path: path6.posix.join(rootDir, TARGET_MANIFEST_FILENAME),
+          path: targetManifestPath,
           content: JSON.stringify(targetForSandbox),
           mode: 420
         },
         {
-          path: path6.posix.join(rootDir, INSTALL_SCRIPT_FILENAME),
-          content: buildInstallScript(rootDir, installCommandsByKey),
+          path: installScriptPath,
+          content: buildInstallScript(
+            rootDir,
+            targetManifestPath,
+            installCommandsByKey
+          ),
           mode: 493
         }
       ];
-      await target.uploadAndRun(
+      const result = await target.uploadAndRun(
         tarballEntries,
-        `bash ${shellQuote(path6.posix.join(rootDir, INSTALL_SCRIPT_FILENAME))}`
+        `bash ${shellQuote(installScriptPath)}`
       );
+      if (result.exitCode !== 0) {
+        const output = result.combinedOutput?.trim();
+        console.warn(
+          `[agentbox] ${target.provider} setup install failed (exit ${result.exitCode}); it will be retried on the next setup${output ? `:
+${output.slice(-2e3)}` : ""}`
+        );
+        return false;
+      }
+      return true;
     },
-    () => ({
+    (ok) => ({
+      ok,
       artifacts: artifacts.length,
       installCommands: installCommands.length
     })
@@ -2148,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();
@@ -2326,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) {
@@ -2354,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);
@@ -2408,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;
@@ -2458,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
@@ -2495,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
@@ -2530,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;
     });
@@ -3660,7 +3771,7 @@ var ClaudeCodeAgentAdapter = class {
         return;
       }
       const env = { ...options.env ?? {}, ...target.env };
-      await Promise.all([
+      const [installed] = await Promise.all([
         time(
           debugClaude,
           "applyDifferentialSetup",
@@ -3671,7 +3782,7 @@ var ClaudeCodeAgentAdapter = class {
       if (enableRtk) {
         await time(debugClaude, "activateRtk", () => activateRtk(target));
       }
-      await markSetupComplete(target, setupId);
+      if (installed) await markSetupComplete(target, setupId);
     });
   }
   async execute(request, sink) {
@@ -3709,8 +3820,8 @@ ${serialized}` : serialized;
       () => validateProviderUserInput(request.provider, request.run.input)
     );
     const userContent = mapToClaudeUserContent(inputParts);
-    const initialUuid = randomUUID();
-    const presetSessionId = request.run.resumeSessionId ?? randomUUID();
+    const initialUuid = randomUUID2();
+    const presetSessionId = request.run.resumeSessionId ?? randomUUID2();
     sink.setSessionId(presetSessionId);
     const baseUrl = await time(
       debugClaude,
@@ -3775,7 +3886,7 @@ ${serialized}` : serialized;
     sink.onMessage(async (content) => {
       const parts = await validateProviderUserInput(request.provider, content);
       const mapped = mapToClaudeUserContent(parts);
-      const messageUuid = randomUUID();
+      const messageUuid = randomUUID2();
       await fetch(
         `${baseUrl}/runs/${encodeURIComponent(request.runId)}/sendMessage`,
         {
@@ -4000,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;
@@ -4032,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(
@@ -4129,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(
@@ -4297,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);
@@ -4396,7 +4517,7 @@ async function executeNativeClaude(request, sink, wait = {}) {
   const input = attachOnly ? [] : await validateProviderUserInput(request.provider, request.run.input);
   const parkOption = request.options.provider?.parkBackgroundWork;
   const parking = parkOption && "onWake" in parkOption ? parkOption : void 0;
-  const sessionId = request.run.resumeSessionId ?? randomUUID();
+  const sessionId = request.run.resumeSessionId ?? randomUUID2();
   if (request.run.forkSessionId)
     await findParkedNativeSession(request.run.forkSessionId)?.end();
   const adopting = request.run.resumeSessionId ? findParkedNativeSession(request.run.resumeSessionId) : void 0;
@@ -4413,7 +4534,7 @@ async function executeNativeClaude(request, sink, wait = {}) {
     await stop();
   });
   sink.setSessionId(sessionId);
-  const messageId = randomUUID();
+  const messageId = randomUUID2();
   const userMessage = {
     type: "user",
     uuid: messageId,
@@ -4622,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
         } : {}
@@ -5631,8 +5755,13 @@ async function setupCodex(request) {
         `Could not start Codex app-server: ${launchResult.combinedOutput || launchResult.stderr}`
       );
     }
+    let installed2;
     try {
-      await applyDifferentialSetup(target2, skillArtifacts2, installCommands2);
+      installed2 = await applyDifferentialSetup(
+        target2,
+        skillArtifacts2,
+        installCommands2
+      );
     } catch (error) {
       await target2.cleanup().catch(() => void 0);
       throw error;
@@ -5640,7 +5769,7 @@ async function setupCodex(request) {
     if (enableRtk2) {
       await time(debugCodex, "activateRtk", () => activateRtk(sharedTarget));
     }
-    await markSetupComplete(sharedTarget, setupId2);
+    if (installed2) await markSetupComplete(sharedTarget, setupId2);
     return;
   }
   const target = await createSetupTarget(provider, "shared-setup", options);
@@ -5663,11 +5792,15 @@ async function setupCodex(request) {
     await target.cleanup().catch(() => void 0);
     throw error;
   }
-  await applyDifferentialSetup(target, allArtifacts, installCommands);
+  const installed = await applyDifferentialSetup(
+    target,
+    allArtifacts,
+    installCommands
+  );
   if (enableRtk) {
     await time(debugCodex, "activateRtk", () => activateRtk(target));
   }
-  await markSetupComplete(target, setupId);
+  if (installed) await markSetupComplete(target, setupId);
 }
 async function createRuntime(request, inputParts) {
   const options = request.options;
@@ -6345,7 +6478,7 @@ var CodexAgentAdapter = class {
 };
 
 // src/agents/providers/opencode.ts
-import { createHash as createHash2, randomBytes, randomUUID as randomUUID2 } from "crypto";
+import { createHash as createHash2, randomBytes, randomUUID as randomUUID3 } from "crypto";
 import os2 from "os";
 import path11 from "path";
 var SANDBOX_OPENCODE_PORT = 4096;
@@ -6690,7 +6823,11 @@ async function ensureSandboxOpenCodeServer(request) {
       OPENCODE_DISABLE_DEFAULT_PLUGINS: "true",
       OPENCODE_ENABLE_QUESTION_TOOL: hasInteractiveQuestions(options) ? "true" : "false"
     };
-    await applyDifferentialSetup(target, allArtifacts, installCommands);
+    const installed = await applyDifferentialSetup(
+      target,
+      allArtifacts,
+      installCommands
+    );
     if (enableRtk) {
       await time(debugOpencode, "activateRtk", () => activateRtk(target));
     }
@@ -6814,14 +6951,14 @@ ${lastLog}` : "")
         "OpenCode server started but is not enforcing the capability token (OPENCODE_SERVER_PASSWORD ignored). Upgrade opencode-ai to a version that supports server authentication."
       );
     }
-    await markSetupComplete(target, setupId);
+    if (installed) await markSetupComplete(target, setupId);
   });
 }
 async function startLocalOpenCodeServer(request) {
   const originalOptions = request.options;
   const options = {
     ...originalOptions,
-    stateDirectory: path11.join(originalOptions.stateDirectory ?? path11.join(os2.tmpdir(), "agentbox-native"), "instances", randomUUID2())
+    stateDirectory: path11.join(originalOptions.stateDirectory ?? path11.join(os2.tmpdir(), "agentbox-native"), "instances", randomUUID3())
   };
   let generatedEnv = {};
   if (options.configuration !== "native") {
@@ -7139,7 +7276,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) => {
@@ -8317,7 +8456,7 @@ var Agent = class {
         throw new Error("AgentRunConfig.resumeParked requires resumeSessionId.");
       }
     }
-    const runId = runConfig.runId ?? randomUUID3();
+    const runId = runConfig.runId ?? randomUUID4();
     const streamCalledAt = Date.now();
     debugAgent("stream() provider=%s runId=%s", this.provider, runId);
     const run = new AgentRunController(

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-RSURGSVM.js";
+} from "./chunk-UE4LQEL5.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.600",
+  "version": "0.1.602",
   "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
   "license": "MIT",
   "repository": {