agentbox-sdk 0.1.523 → 0.1.600

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

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

@@ -31,23 +31,30 @@ import {
 
 // src/agents/Agent.ts
 import { randomUUID as randomUUID3 } from "crypto";
-import path11 from "path";
+import path12 from "path";
 
 // src/agents/providers/claude-code.ts
 import { randomUUID } 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) {
@@ -1578,7 +1586,7 @@ async function activateRtk(target) {
 
 // src/agents/config/setup-manifest.ts
 import { createHash } from "crypto";
-import path5 from "path";
+import path6 from "path";
 var MANIFEST_FILENAME = "setup-manifest.json";
 var TARGET_MANIFEST_FILENAME = "setup-target.json";
 var INSTALL_SCRIPT_FILENAME = "install.sh";
@@ -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
     );
@@ -1763,19 +1771,19 @@ async function applyDifferentialSetup(target, artifacts, installCommands) {
           mode: artifact.executable ? 493 : 420
         })),
         {
-          path: path5.posix.join(rootDir, TARGET_MANIFEST_FILENAME),
+          path: path6.posix.join(rootDir, TARGET_MANIFEST_FILENAME),
           content: JSON.stringify(targetForSandbox),
           mode: 420
         },
         {
-          path: path5.posix.join(rootDir, INSTALL_SCRIPT_FILENAME),
+          path: path6.posix.join(rootDir, INSTALL_SCRIPT_FILENAME),
           content: buildInstallScript(rootDir, installCommandsByKey),
           mode: 493
         }
       ];
       await target.uploadAndRun(
         tarballEntries,
-        `bash ${shellQuote(path5.posix.join(rootDir, INSTALL_SCRIPT_FILENAME))}`
+        `bash ${shellQuote(path6.posix.join(rootDir, INSTALL_SCRIPT_FILENAME))}`
       );
     },
     () => ({
@@ -1786,15 +1794,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 +1818,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 +1826,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 +1841,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 +1871,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 +1909,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 +1927,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 +2616,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 +2634,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 +3428,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 +3601,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 +3626,7 @@ var ClaudeCodeAgentAdapter = class {
       const artifacts = [
         ...!sandbox ? [
           {
-            path: path8.join(
+            path: path9.join(
               target.layout.claudeDir,
               ".claude-plugin",
               "plugin.json"
@@ -3673,8 +3683,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,
@@ -4432,8 +4442,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 +4640,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 +4859,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 +4868,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 +5099,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 +5330,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 +5349,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 +5511,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 +5536,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 +5572,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"
     );
@@ -5664,7 +5677,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 +5708,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 +5743,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 +5789,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"
   );
@@ -6337,14 +6347,14 @@ var CodexAgentAdapter = class {
 // src/agents/providers/opencode.ts
 import { createHash as createHash2, randomBytes, randomUUID as randomUUID2 } 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 +6640,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,
@@ -6685,11 +6695,11 @@ async function ensureSandboxOpenCodeServer(request) {
       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"
     );
@@ -6811,7 +6821,7 @@ 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", randomUUID2())
   };
   let generatedEnv = {};
   if (options.configuration !== "native") {
@@ -6819,7 +6829,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 +6922,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 +7876,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);

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-RSURGSVM.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.600",
   "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",