agentbox-sdk 0.1.523 → 0.1.601

package/README.md

@@ -746,6 +746,17 @@ each run in its own process group can set `processGroup: "inherited"`; that
 supervisor is then responsible for stopping the complete group before reporting
 that a run has stopped. This option is unavailable for cloud sandboxes.
 
+On Windows, host CLIs start through cross-spawn without a shell: it resolves
+`PATHEXT` and script shebangs, and escapes the arguments `cmd.exe` sees when the
+binary is a batch shim. Windows has no process groups or signals, so stopping a
+host CLI ends its whole process tree with `taskkill /T /F`; a supervisor using
+`processGroup: "inherited"` there still owns everything the tree left behind
+(for example through a Job Object).
+
+`provider.args` passes native CLI flags for a run without touching the user's
+configuration. Codex places them before its subcommand (`["-c", "key=value"]`);
+Claude Code accepts `--name` and `--name=value` entries.
+
 ## Packaging
 
 `npm pack` builds the package from maintained TypeScript source before creating

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

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

@@ -30,24 +30,31 @@ import {
 } from "./chunk-GOFJNFAD.js";
 
 // src/agents/Agent.ts
-import { randomUUID as randomUUID3 } from "crypto";
-import path11 from "path";
+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 { spawn } from "child_process";
+import { execFile, spawn } from "child_process";
+import path from "path";
 import { createInterface } from "readline";
+import crossSpawn from "cross-spawn";
+var windows = process.platform === "win32";
+function killWindowsTree(pid) {
+  const taskkill = path.join(process.env.SystemRoot ?? "C:\\Windows", "System32", "taskkill.exe");
+  execFile(taskkill, ["/pid", String(pid), "/T", "/F"], { windowsHide: true }, () => void 0);
+}
 function spawnCommand(options) {
-  const child = spawn(options.command, options.args ?? [], {
+  const spawnOptions = {
     cwd: options.cwd,
     env: options.env,
     stdio: "pipe",
-    shell: process.platform === "win32",
     windowsHide: true,
-    detached: options.processGroup === true && process.platform !== "win32"
-  });
+    detached: options.processGroup === true && !windows
+  };
+  const child = (windows ? crossSpawn : spawn)(options.command, options.args ?? [], spawnOptions);
   const exitPromise = new Promise((resolve, reject) => {
     child.once("error", reject);
     child.once("close", (code) => resolve(code ?? 0));
@@ -56,7 +63,8 @@ function spawnCommand(options) {
   let killPromise;
   const signalProcess = (signal) => {
     try {
-      if (options.processGroup && process.platform !== "win32" && child.pid) process.kill(-child.pid, signal);
+      if (windows && child.pid) killWindowsTree(child.pid);
+      else if (options.processGroup && child.pid) process.kill(-child.pid, signal);
       else child.kill(signal);
     } catch (error) {
       if (error.code !== "ESRCH") throw error;
@@ -81,7 +89,7 @@ function spawnCommand(options) {
     kill: (signal = "SIGTERM") => killPromise ??= (async () => {
       signalProcess(signal);
       if (await waitForExit(options.terminationTimeoutMs ?? 3e3)) {
-        if (options.processGroup && process.platform !== "win32") signalProcess("SIGKILL");
+        if (options.processGroup && !windows) signalProcess("SIGKILL");
         return;
       }
       signalProcess("SIGKILL");
@@ -101,7 +109,7 @@ async function* linesFromNodeStream(stream) {
 }
 
 // src/agents/providers/claude-code.ts
-import path8 from "path";
+import path9 from "path";
 
 // src/agents/harness-commands.ts
 var MAX_HARNESS_COMMANDS = 500;
@@ -454,7 +462,7 @@ function questionReply(provider, input, answers) {
 
 // src/agents/input.ts
 import { readFile } from "fs/promises";
-import path from "path";
+import path2 from "path";
 import { fileURLToPath } from "url";
 var IMAGE_MEDIA_TYPE_BY_EXTENSION = {
   ".gif": "image/gif",
@@ -794,7 +802,7 @@ async function resolveUrlContent(url, options) {
     const buffer = await readFile(filePath);
     return {
       mediaType: resolveMediaType(filePath, options),
-      filename: options.filename ?? path.basename(filePath),
+      filename: options.filename ?? path2.basename(filePath),
       source: {
         type: "base64",
         data: buffer.toString("base64")
@@ -843,11 +851,11 @@ function resolveMediaType(pathname, options, parsedMediaType) {
   );
 }
 function inferMediaType(pathname) {
-  const extension = path.extname(pathname).toLowerCase();
+  const extension = path2.extname(pathname).toLowerCase();
   return FILE_MEDIA_TYPE_BY_EXTENSION[extension];
 }
 function inferFilename(pathname) {
-  const name = path.basename(pathname);
+  const name = path2.basename(pathname);
   return name && name !== "." ? name : void 0;
 }
 function parseStructuredUrl(value) {
@@ -890,7 +898,7 @@ function isClaudeTextLikeMediaType(mediaType) {
 }
 
 // src/agents/config/commands.ts
-import path2 from "path";
+import path3 from "path";
 function buildFrontmatter(values) {
   const lines = Object.entries(values).filter(([, value]) => value !== void 0).map(([key, value]) => `${key}: ${JSON.stringify(value)}`);
   return lines.length > 0 ? `---
@@ -901,7 +909,7 @@ ${lines.join("\n")}
 }
 function buildClaudeCommandArtifacts(commands, layout) {
   return (commands ?? []).map((command) => ({
-    path: path2.join(layout.claudeDir, "commands", `${command.name}.md`),
+    path: path3.join(layout.claudeDir, "commands", `${command.name}.md`),
     content: buildFrontmatter({
       description: command.description
     }) + command.template
@@ -936,7 +944,7 @@ function assertCommandsSupported(provider, commands) {
 }
 
 // src/agents/config/hooks.ts
-import path3 from "path";
+import path4 from "path";
 function hasHookEntries(hooks) {
   if (!hooks || typeof hooks !== "object") {
     return false;
@@ -1049,7 +1057,7 @@ function buildOpenCodePluginArtifacts(plugins, opencodeDir) {
     }
     seenFileNames.add(fileName);
     return {
-      path: path3.join(opencodeDir, "plugins", fileName),
+      path: path4.join(opencodeDir, "plugins", fileName),
       content: buildOpenCodePluginSource(plugin)
     };
   });
@@ -1296,7 +1304,7 @@ function buildCodexConfigToml(opts = {}) {
 // src/agents/config/setup.ts
 import { mkdir, chmod, rm, writeFile } from "fs/promises";
 import os from "os";
-import path4 from "path";
+import path5 from "path";
 function shortLabel(command) {
   const oneLine = command.replace(/\s+/g, " ").trim();
   return oneLine.length > 60 ? `${oneLine.slice(0, 60)}\u2026` : oneLine;
@@ -1304,21 +1312,21 @@ function shortLabel(command) {
 function agentboxRoot(provider, hasSandbox = true, stateDirectory) {
   if (stateDirectory !== void 0) {
     if (hasSandbox) throw new Error("stateDirectory is only supported for host execution.");
-    if (!path4.isAbsolute(stateDirectory)) throw new Error("stateDirectory must be an absolute path.");
-    return path4.join(stateDirectory, provider);
+    if (!path5.isAbsolute(stateDirectory)) throw new Error("stateDirectory must be an absolute path.");
+    return path5.join(stateDirectory, provider);
   }
-  return hasSandbox ? `/tmp/agentbox/${provider}` : path4.join(os.tmpdir(), `agentbox-${provider}`);
+  return hasSandbox ? `/tmp/agentbox/${provider}` : path5.join(os.tmpdir(), `agentbox-${provider}`);
 }
 function getAgentLayout(rootDir) {
-  const xdgConfigHome = path4.join(rootDir, ".config");
+  const xdgConfigHome = path5.join(rootDir, ".config");
   return {
     rootDir,
     homeDir: rootDir,
     xdgConfigHome,
-    agentsDir: path4.join(rootDir, ".agents"),
-    claudeDir: path4.join(rootDir, ".claude"),
-    opencodeDir: path4.join(xdgConfigHome, "opencode"),
-    codexDir: path4.join(rootDir, ".codex")
+    agentsDir: path5.join(rootDir, ".agents"),
+    claudeDir: path5.join(rootDir, ".claude"),
+    opencodeDir: path5.join(xdgConfigHome, "opencode"),
+    codexDir: path5.join(rootDir, ".codex")
   };
 }
 function buildLayoutEnv(provider, layout) {
@@ -1329,7 +1337,7 @@ function buildLayoutEnv(provider, layout) {
       return { CODEX_HOME: layout.codexDir };
     case "open-code":
       return {
-        OPENCODE_CONFIG: path4.join(layout.opencodeDir, "agentbox.json"),
+        OPENCODE_CONFIG: path5.join(layout.opencodeDir, "agentbox.json"),
         OPENCODE_CONFIG_DIR: layout.opencodeDir
       };
   }
@@ -1359,7 +1367,7 @@ var HostSetupTarget = class {
       async () => {
         await Promise.all(
           files.map(async (entry) => {
-            await mkdir(path4.dirname(entry.path), { recursive: true, mode: 448 });
+            await mkdir(path5.dirname(entry.path), { recursive: true, mode: 448 });
             const content = typeof entry.content === "string" ? entry.content : entry.content;
             await writeFile(entry.path, content, { mode: entry.mode ?? 384 });
             if (entry.mode && (entry.mode & 73) !== 0) {
@@ -1577,13 +1585,13 @@ async function activateRtk(target) {
 }
 
 // src/agents/config/setup-manifest.ts
-import { createHash } from "crypto";
-import path5 from "path";
+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");
@@ -1632,7 +1640,7 @@ async function preflightSetup(target, setupId, daemon) {
     debugSetup,
     `preflightSetup ${target.provider}`,
     async () => {
-      const setupIdFile = path5.posix.join(
+      const setupIdFile = path6.posix.join(
         target.layout.rootDir,
         SETUP_ID_FILENAME
       );
@@ -1660,7 +1668,7 @@ async function preflightSetup(target, setupId, daemon) {
 }
 async function markSetupComplete(target, setupId) {
   await time(debugSetup, `markSetupComplete ${target.provider}`, async () => {
-    const setupIdFile = path5.posix.join(
+    const setupIdFile = path6.posix.join(
       target.layout.rootDir,
       SETUP_ID_FILENAME
     );
@@ -1677,7 +1685,7 @@ ${detail}` : ""}`
     }
   });
 }
-function buildInstallScript(rootDir, installCommandsByKey) {
+function buildInstallScript(rootDir, targetManifestPath, installCommandsByKey) {
   const commandsB64 = Buffer.from(
     JSON.stringify(installCommandsByKey),
     "utf8"
@@ -1685,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
 
@@ -1694,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"
@@ -1720,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
@@ -1737,7 +1767,7 @@ mv "$TARGET_MANIFEST" "$EXISTING_MANIFEST"
 `;
 }
 async function applyDifferentialSetup(target, artifacts, installCommands) {
-  await time(
+  return time(
     debugSetup,
     `applyDifferentialSetup ${target.provider}`,
     async () => {
@@ -1755,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,
@@ -1763,22 +1802,36 @@ async function applyDifferentialSetup(target, artifacts, installCommands) {
           mode: artifact.executable ? 493 : 420
         })),
         {
-          path: path5.posix.join(rootDir, TARGET_MANIFEST_FILENAME),
+          path: targetManifestPath,
           content: JSON.stringify(targetForSandbox),
           mode: 420
         },
         {
-          path: path5.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(path5.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
     })
@@ -1786,15 +1839,15 @@ async function applyDifferentialSetup(target, artifacts, installCommands) {
 }
 
 // src/agents/config/skills.ts
-import path6 from "path";
+import path7 from "path";
 function getSkillTargetDir(provider, layout, skillName) {
   switch (provider) {
     case AgentProvider.ClaudeCode:
-      return path6.join(layout.claudeDir, "skills", skillName);
+      return path7.join(layout.claudeDir, "skills", skillName);
     case AgentProvider.OpenCode:
-      return path6.join(layout.opencodeDir, "skills", skillName);
+      return path7.join(layout.opencodeDir, "skills", skillName);
     case AgentProvider.Codex:
-      return path6.join(layout.codexDir, "skills", skillName);
+      return path7.join(layout.codexDir, "skills", skillName);
   }
 }
 function skillsCliAgentName(provider) {
@@ -1810,7 +1863,7 @@ async function prepareSkillArtifacts(provider, skills, layout) {
   const preparedSkills = [];
   for (const skill of skills ?? []) {
     const targetDir = getSkillTargetDir(provider, layout, skill.name);
-    const skillFilePath = path6.join(targetDir, "SKILL.md");
+    const skillFilePath = path7.join(targetDir, "SKILL.md");
     if (!("files" in skill)) {
       installCommands.push(buildSkillsInstallerCommand(provider, skill));
       preparedSkills.push({ name: skill.name, skillFilePath });
@@ -1818,7 +1871,7 @@ async function prepareSkillArtifacts(provider, skills, layout) {
     }
     for (const [relativePath, content] of Object.entries(skill.files)) {
       artifacts.push({
-        path: path6.join(targetDir, relativePath),
+        path: path7.join(targetDir, relativePath),
         content,
         executable: relativePath.startsWith("scripts/")
       });
@@ -1833,7 +1886,7 @@ async function prepareSkillArtifacts(provider, skills, layout) {
 }
 
 // src/agents/config/subagents.ts
-import path7 from "path";
+import path8 from "path";
 function toToolsArray(tools) {
   const filtered = tools?.map((tool) => tool.trim()).filter(Boolean);
   return filtered && filtered.length > 0 ? filtered : void 0;
@@ -1863,7 +1916,7 @@ ${frontmatterLines.join("\n")}
 ${subAgent.instructions.trim()}
 `;
     return {
-      path: path7.join(layout.claudeDir, "agents", `${subAgent.name}.md`),
+      path: path8.join(layout.claudeDir, "agents", `${subAgent.name}.md`),
       content
     };
   });
@@ -1901,7 +1954,7 @@ function buildCodexSubagentArtifacts(subAgents, layout, defaultModel) {
     const roleConfigRelativePath = `./agents/${subAgent.name}.toml`;
     const roleConfigPromptPath = `../prompts/${subAgent.name}.md`;
     artifacts.push({
-      path: path7.join(layout.codexDir, "prompts", `${subAgent.name}.md`),
+      path: path8.join(layout.codexDir, "prompts", `${subAgent.name}.md`),
       content: subAgent.instructions
     });
     const tomlLines = [
@@ -1919,7 +1972,7 @@ function buildCodexSubagentArtifacts(subAgents, layout, defaultModel) {
       ""
     );
     artifacts.push({
-      path: path7.join(layout.codexDir, "agents", `${subAgent.name}.toml`),
+      path: path8.join(layout.codexDir, "agents", `${subAgent.name}.toml`),
       content: tomlLines.join("\n")
     });
     agentSections.push(
@@ -2608,7 +2661,7 @@ var DAEMON_TOKEN_PATH = "/tmp/agentbox/claude-code/daemon-token";
 var DAEMON_READY_TIMEOUT_MS = 3e4;
 var DAEMON_READY_POLL_INTERVAL_MS = 250;
 function claudeConfigDir(options) {
-  return path8.join(
+  return path9.join(
     agentboxRoot(
       AgentProvider.ClaudeCode,
       Boolean(options.sandbox),
@@ -2626,7 +2679,9 @@ function buildClaudeQueryOptions(params) {
   for (const arg of provider?.args ?? []) {
     if (typeof arg !== "string") continue;
     if (arg.startsWith("--")) {
-      extraArgs[arg.slice(2)] = null;
+      const separator = arg.indexOf("=");
+      if (separator === -1) extraArgs[arg.slice(2)] = null;
+      else extraArgs[arg.slice(2, separator)] = arg.slice(separator + 1);
     }
   }
   if (run.systemPrompt) {
@@ -3418,7 +3473,7 @@ async function ensureClaudeCodeDaemonUncached(options, env) {
       DAEMON_TOKEN_PATH,
       true
     );
-    const daemonDir = path8.posix.dirname(DAEMON_PATH);
+    const daemonDir = path9.posix.dirname(DAEMON_PATH);
     const daemonNodeModules = `${daemonDir}/node_modules/@anthropic-ai`;
     const launchCommand = [
       `NPM_ROOT="$(npm root -g 2>/dev/null)"`,
@@ -3591,8 +3646,8 @@ var ClaudeCodeAgentAdapter = class {
       const provider = request.provider;
       const sandbox = options.sandbox;
       const target = await createSetupTarget(provider, "shared-setup", options);
-      const settingsPath = path8.join(target.layout.claudeDir, "settings.json");
-      const mcpConfigPath = path8.join(
+      const settingsPath = path9.join(target.layout.claudeDir, "settings.json");
+      const mcpConfigPath = path9.join(
         target.layout.claudeDir,
         "agentbox-mcp.json"
       );
@@ -3616,7 +3671,7 @@ var ClaudeCodeAgentAdapter = class {
       const artifacts = [
         ...!sandbox ? [
           {
-            path: path8.join(
+            path: path9.join(
               target.layout.claudeDir,
               ".claude-plugin",
               "plugin.json"
@@ -3650,7 +3705,7 @@ var ClaudeCodeAgentAdapter = class {
         return;
       }
       const env = { ...options.env ?? {}, ...target.env };
-      await Promise.all([
+      const [installed] = await Promise.all([
         time(
           debugClaude,
           "applyDifferentialSetup",
@@ -3661,7 +3716,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) {
@@ -3673,8 +3728,8 @@ var ClaudeCodeAgentAdapter = class {
       return;
     }
     const claudeDir = claudeConfigDir(request.options);
-    const settingsPath = path8.join(claudeDir, "settings.json");
-    const mcpConfigPath = path8.join(claudeDir, "agentbox-mcp.json");
+    const settingsPath = path9.join(claudeDir, "settings.json");
+    const mcpConfigPath = path9.join(claudeDir, "agentbox-mcp.json");
     const env = {
       ...request.options.env ?? {},
       CLAUDE_CONFIG_DIR: claudeDir,
@@ -3699,8 +3754,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,
@@ -3765,7 +3820,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`,
         {
@@ -4386,7 +4441,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;
@@ -4403,7 +4458,7 @@ async function executeNativeClaude(request, sink, wait = {}) {
     await stop();
   });
   sink.setSessionId(sessionId);
-  const messageId = randomUUID();
+  const messageId = randomUUID2();
   const userMessage = {
     type: "user",
     uuid: messageId,
@@ -4432,8 +4487,8 @@ async function executeNativeClaude(request, sink, wait = {}) {
   const options = buildClaudeQueryOptions({
     request,
     ...request.options.configuration === "native" ? {} : {
-      settingsPath: path8.join(claudeDir, "settings.json"),
-      mcpConfigPath: path8.join(claudeDir, "agentbox-mcp.json")
+      settingsPath: path9.join(claudeDir, "settings.json"),
+      mcpConfigPath: path9.join(claudeDir, "agentbox-mcp.json")
     },
     // Auth is deliberately CLI-owned. Never copy the user's credential files
     // into the generated configuration directory or a task artifact.
@@ -4630,7 +4685,7 @@ async function executeNativeClaude(request, sink, wait = {}) {
 
 // src/agents/providers/codex.ts
 import crypto2 from "crypto";
-import path9 from "path";
+import path10 from "path";
 
 // src/agents/transports/app-server.ts
 import { createParser } from "eventsource-parser";
@@ -4849,7 +4904,7 @@ var JsonRpcLineClient = class {
 
 // src/agents/providers/codex.ts
 function codexConfigDir(options) {
-  return path9.join(
+  return path10.join(
     agentboxRoot(AgentProvider.Codex, Boolean(options.sandbox), options.stateDirectory),
     ".codex"
   );
@@ -4858,7 +4913,7 @@ 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";
 function defaultRemoteCodexTokenPath() {
-  return path9.posix.join(
+  return path10.posix.join(
     agentboxRoot(AgentProvider.Codex, true),
     CODEX_APP_SERVER_TOKEN_FILENAME
   );
@@ -5089,12 +5144,15 @@ function shouldIgnoreCodexError(notification) {
   return notification.params?.willRetry === true;
 }
 function buildCodexCommandArgs(binary, args, options) {
+  return [...options?.configuration === "native" ? [] : ["-u", "XDG_CONFIG_HOME"], ...buildCodexCommand(binary, args, options)];
+}
+function buildCodexCommand(binary, args, options) {
   const overrides = [];
   if (options?.provider?.supportsWebsockets === false) {
     overrides.push(["supports_websockets", "false"]);
   }
   const overrideArgs = overrides.flatMap(([k, v]) => ["-c", `${k}=${v}`]);
-  return [...options?.configuration === "native" ? [] : ["-u", "XDG_CONFIG_HOME"], binary, ...overrideArgs, ...args];
+  return [binary, ...overrideArgs, ...options?.provider?.args ?? [], ...args];
 }
 function toNormalizedCodexEvents(runId, notification) {
   const base = {
@@ -5317,7 +5375,7 @@ async function materializeCodexImage(options, part, index) {
     throw new Error("Cannot attach an empty image to Codex.");
   }
   const root = agentboxRoot(AgentProvider.Codex, Boolean(options.sandbox), options.stateDirectory);
-  const imagePath = path9.join(
+  const imagePath = path10.join(
     root,
     "inputs",
     `codex-image-${index}-${crypto2.randomUUID()}${codexImageExtension(part.mediaType)}`
@@ -5336,7 +5394,7 @@ async function materializeCodexImage(options, part, index) {
     return imagePath;
   }
   const fs = await import("fs/promises");
-  await fs.mkdir(path9.dirname(imagePath), { recursive: true });
+  await fs.mkdir(path10.dirname(imagePath), { recursive: true });
   await fs.writeFile(imagePath, data);
   return imagePath;
 }
@@ -5498,13 +5556,13 @@ async function setupCodex(request) {
     const artifacts = [...subAgentArtifacts];
     if (configToml) {
       artifacts.push({
-        path: path9.join(layoutTarget.layout.codexDir, "config.toml"),
+        path: path10.join(layoutTarget.layout.codexDir, "config.toml"),
         content: configToml
       });
     }
     if (hooksFile) {
       artifacts.push({
-        path: path9.join(layoutTarget.layout.codexDir, "hooks.json"),
+        path: path10.join(layoutTarget.layout.codexDir, "hooks.json"),
         content: JSON.stringify(hooksFile, null, 2)
       });
     }
@@ -5523,7 +5581,7 @@ async function setupCodex(request) {
       ...sharedTarget.env,
       ...options.provider?.env ?? {}
     });
-    const tokenFilePath = path9.posix.join(
+    const tokenFilePath = path10.posix.join(
       sharedTarget.layout.rootDir,
       CODEX_APP_SERVER_TOKEN_FILENAME
     );
@@ -5559,11 +5617,11 @@ async function setupCodex(request) {
     );
     await applyDifferentialSetup(sharedTarget, serverArtifacts, []);
     const binary = options.provider?.binary ?? "codex";
-    const pidFilePath = path9.posix.join(
+    const pidFilePath = path10.posix.join(
       sharedTarget.layout.rootDir,
       "codex-app-server.pid"
     );
-    const logFilePath = path9.posix.join(
+    const logFilePath = path10.posix.join(
       sharedTarget.layout.rootDir,
       "codex-app-server.log"
     );
@@ -5618,8 +5676,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;
@@ -5627,7 +5690,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);
@@ -5650,11 +5713,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;
@@ -5664,7 +5731,7 @@ async function createRuntime(request, inputParts) {
     ...options.configuration === "native" ? {} : { CODEX_HOME: codexDir },
     ...options.provider?.env ?? {}
   });
-  const runtimeCwd = options.configuration === "native" ? options.cwd : path9.dirname(codexDir);
+  const runtimeCwd = options.configuration === "native" ? options.cwd : path10.dirname(codexDir);
   const inputItems = await buildCodexInputItems(options, inputParts);
   const usesRemoteWebSocket = options.sandbox && options.sandbox.provider !== SandboxProvider.LocalDocker;
   if (usesRemoteWebSocket && options.sandbox) {
@@ -5695,12 +5762,9 @@ async function createRuntime(request, inputParts) {
       inputItems
     };
   }
-  const codexArgs = buildCodexCommandArgs(
-    options.provider?.binary ?? "codex",
-    ["app-server"],
-    options
-  );
+  const binary = options.provider?.binary ?? "codex";
   if (options.sandbox) {
+    const codexArgs = buildCodexCommandArgs(binary, ["app-server"], options);
     const handle = await options.sandbox.runAsync(["env", ...codexArgs], {
       cwd: runtimeCwd,
       env
@@ -5733,15 +5797,15 @@ async function createRuntime(request, inputParts) {
       inputItems
     };
   }
+  const [command, ...args] = buildCodexCommand(binary, ["app-server"], options);
+  const hostEnv = { ...process.env, ...env };
+  if (options.configuration !== "native") delete hostEnv.XDG_CONFIG_HOME;
   const processHandle = spawnCommand({
     processGroup: options.processGroup !== "inherited",
-    command: "env",
-    args: codexArgs,
+    command,
+    args,
     cwd: runtimeCwd,
-    env: {
-      ...process.env,
-      ...env
-    }
+    env: hostEnv
   });
   processHandle.child.stderr.resume();
   return {
@@ -5779,7 +5843,7 @@ async function killCodexAppServer(request) {
     REMOTE_CODEX_APP_SERVER_ID,
     options
   );
-  const pidFilePath = path9.posix.join(
+  const pidFilePath = path10.posix.join(
     sharedTarget.layout.rootDir,
     "codex-app-server.pid"
   );
@@ -6335,16 +6399,16 @@ 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 path10 from "path";
+import path11 from "path";
 var SANDBOX_OPENCODE_PORT = 4096;
 var SANDBOX_OPENCODE_READY_TIMEOUT_MS = 9e4;
 var LOCAL_OPENCODE_READY_TIMEOUT_MS = 2e4;
 var SHARED_OPENCODE_TARGET_ID = "shared-opencode-server";
 var OPENCODE_AUTH_USERNAME = "opencode";
 function opencodeServerTokenPath() {
-  return path10.posix.join(
+  return path11.posix.join(
     agentboxRoot(AgentProvider.OpenCode, true),
     "opencode-auth-token"
   );
@@ -6630,7 +6694,7 @@ async function ensureSandboxOpenCodeServer(request) {
       plugins,
       target.layout.opencodeDir
     );
-    const configPath = path10.join(target.layout.opencodeDir, "agentbox.json");
+    const configPath = path11.join(target.layout.opencodeDir, "agentbox.json");
     const openCodeConfig = buildOpenCodeConfig(options, interactiveApproval);
     const allArtifacts = [
       ...skillArtifacts,
@@ -6680,16 +6744,20 @@ 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));
     }
     const binary = options.provider?.binary ?? "opencode";
-    const pidFilePath = path10.posix.join(
+    const pidFilePath = path11.posix.join(
       target.layout.rootDir,
       "opencode-serve.pid"
     );
-    const logFilePath = path10.posix.join(
+    const logFilePath = path11.posix.join(
       target.layout.rootDir,
       "opencode-serve.log"
     );
@@ -6804,14 +6872,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: path10.join(originalOptions.stateDirectory ?? path10.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") {
@@ -6819,7 +6887,7 @@ async function startLocalOpenCodeServer(request) {
     assertCommandsSupported(request.provider, options.commands);
     const target = await createSetupTarget(request.provider, "shared-setup", options);
     const { artifacts: skillArtifacts, installCommands } = await prepareSkillArtifacts(request.provider, options.skills, target.layout);
-    const configPath = path10.join(target.layout.opencodeDir, "agentbox.json");
+    const configPath = path11.join(target.layout.opencodeDir, "agentbox.json");
     const artifacts = [
       ...skillArtifacts,
       ...buildOpenCodePluginArtifacts(plugins, target.layout.opencodeDir),
@@ -6912,7 +6980,7 @@ async function killOpenCodeServer(request) {
       SHARED_OPENCODE_TARGET_ID,
       options
     );
-    const pidFilePath = path10.posix.join(
+    const pidFilePath = path11.posix.join(
       target.layout.rootDir,
       "opencode-serve.pid"
     );
@@ -7866,7 +7934,7 @@ function createAdapter(provider) {
 function prepareAgentOptions(_provider, options) {
   if (options.stateDirectory !== void 0) {
     if (options.sandbox) throw new Error("stateDirectory is only supported for host execution.");
-    if (!path11.isAbsolute(options.stateDirectory)) throw new Error("stateDirectory must be an absolute path.");
+    if (!path12.isAbsolute(options.stateDirectory)) throw new Error("stateDirectory must be an absolute path.");
   }
   if (options.sandbox && options.processGroup !== void 0) throw new Error("processGroup is only supported for host execution.");
   resolveBackgroundTaskTimeoutMs(options.backgroundTaskTimeoutMs);
@@ -8307,7 +8375,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-DM6zUiv1.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-ChkpU7Lf.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-DM6zUiv1.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-ChkpU7Lf.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-PFGHRDL4.js";
+} from "./chunk-ZITMGTVR.js";
 import {
   ProviderLogAssembler,
   createNormalizedEvent,

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

@@ -665,6 +665,8 @@ interface CodexProviderOptions {
     /** Network access for an explicit host workspace-write policy; defaults to false. */
     networkAccess?: boolean;
     binary?: string;
+    /** Global CLI arguments placed before the subcommand, e.g. `["-c", "key=value"]`. */
+    args?: string[];
     env?: Record<string, string>;
     brokerEndpoint?: string;
     useBroker?: boolean;
@@ -751,6 +753,7 @@ interface ClaudeCodeProviderOptions {
     /** Request fast mode explicitly; false overrides inherited fast settings. */
     fastMode?: boolean;
     binary?: string;
+    /** CLI flags as `--name` or `--name=value`; other entries are ignored. */
     args?: string[];
     hooks?: ClaudeCodeHooksConfig;
     permissionMode?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentbox-sdk",
-  "version": "0.1.523",
+  "version": "0.1.601",
   "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
   "license": "MIT",
   "repository": {
@@ -63,6 +63,7 @@
     "@daytonaio/sdk": "^0.171.0",
     "@types/debug": "^4.1.13",
     "@vercel/sandbox": "2.0.0-beta.13",
+    "cross-spawn": "^7.0.6",
     "debug": "^4.4.3",
     "dockerode": "^4.0.10",
     "e2b": "^2.19.0",
@@ -74,6 +75,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@types/cross-spawn": "^6.0.6",
     "@types/dockerode": "^3.3.42",
     "@types/node": "^25.5.2",
     "@types/tar-stream": "^3.1.4",