agentbox-sdk 0.1.503 → 0.1.508

package/README.md

@@ -504,6 +504,77 @@ AGENTBOX_RUN_MATRIX_E2E=1 npm run test:e2e:matrix     # provider matrix
 
 Live test suites are opt-in because they provision real infrastructure.
 
+## Host execution settings
+
+Use `configuration: "native"` to run a host harness with its own configuration,
+built-in prompt, credentials, and repository instructions. AgentBox does not
+generate settings, skills, commands, subagents, hooks, plugins, or MCP definitions
+in this mode. It cannot be combined with a sandbox or AgentBox-managed skills,
+MCPs, commands, subagents, or RTK. Omit `systemPrompt` when starting a turn to keep
+the harness's built-in instructions unchanged.
+
+```ts
+const agent = new Agent("codex", {
+  cwd: "/absolute/path/to/project",
+  configuration: "native",
+  approvalMode: "interactive",
+});
+await agent.setup();
+```
+
+Start a turn with `agent.stream({ input })`, consume its async event iterator,
+and answer permission requests with `run.respondToPermission()`. Await
+`run.finished` for the result and call `agent.killServer()` to release the runtime.
+
+The default `configuration: "managed"` retains AgentBox-generated configuration
+for host and sandbox execution.
+
+`stateDirectory` selects a private, persistent directory for generated agent
+configuration and session state on the host. It must be an absolute path and
+cannot be combined with `sandbox`. Use a different directory for each execution
+environment to prevent unrelated local jobs from overwriting configuration.
+This setting does not copy credentials from the user's account.
+
+With native configuration, Codex uses the user's sandbox and approval settings.
+Managed host execution defaults to read-only. An explicit
+`provider: { sandboxMode: "workspace-write" }` enables a host write policy;
+`writableRoots` adds allowed directories and `networkAccess` enables network
+access for that policy (disabled by default). The shared
+`approvalMode: "interactive"` routes permission requests to the caller; it does
+not itself change the native harness's policy. Cloud sandbox defaults are unchanged.
+
+Host Claude runs the Anthropic SDK with the SDK-matched CLI by default.
+`provider.binary` explicitly selects another compatible CLI. Sign-in and session
+storage remain CLI-owned. Managed configuration loads generated skills, commands,
+and subagents as a private local plugin. Native configuration loads user, project,
+and local settings instead. Neither mode copies the CLI's credentials.
+
+Each host OpenCode Agent owns an authenticated loopback server on an ephemeral
+port. Managed configuration uses an isolated configuration directory; native
+configuration preserves the user's configuration paths. `killServer()` stops
+only that Agent's process. It never discovers or kills another server by port number.
+
+All three providers normalize interactive questions into `permission.requested`
+events with `kind: "question"`. Respond with `decision: "allow"` and an `answers`
+array containing each `questionId` and its selected or custom `values`, or use
+`decision: "deny"` to skip. Invalid answers leave the request pending for correction.
+Question answers cannot modify unrelated tool arguments. Ordinary tool requests
+use the same API without `answers`.
+
+Native runtimes own a POSIX process group by default. Termination is bounded and
+escalates to SIGKILL if the process ignores SIGTERM. A supervisor that launches
+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.
+
+## Packaging
+
+`npm pack` builds the package from maintained TypeScript source before creating
+the archive. Host execution includes the pinned Anthropic SDK and its Zod peer
+as runtime dependencies; consumers do not need package-manager extensions.
+Run `npm run check` before publishing. Provider integration tests use fake local
+CLIs and SDK mocks; live tests remain opt-in.
+
 ## License
 
 MIT

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, a4 as RawAgentEvent, b as AgentAttachRequest, y as AttachedRun, ab as SetupLayout } from '../types-3VRJIiW0.js';
-export { a as AgentApprovalMode, c as AgentCommandConfig, d as AgentCostData, e as AgentExecutionRequest, f as AgentLocalMcpConfig, g as AgentMcpConfig, i as AgentOptionsBase, j as AgentOptionsMap, k as AgentPermissionDecision, l as AgentPermissionKind, m as AgentPermissionResponse, n as AgentProviderAdapter, p as AgentReasoningEffort, q as AgentRemoteMcpConfig, u as AgentRunSink, v as AgentSetupRequest, w as AgentSkillConfig, x as AgentSubAgentConfig, C as ClaudeCodeAgentOptions, z as ClaudeCodeHookConfig, B as ClaudeCodeHookEvent, D as ClaudeCodeHookHandler, E as ClaudeCodeHookMatcherGroup, F as ClaudeCodeHooksConfig, G as ClaudeCodeProviderOptions, H as CodexAgentOptions, I as CodexCommandHook, J as CodexHookEvent, K as CodexHookMatcherGroup, L as CodexHooksConfig, M as CodexModelProviderConfig, N as CodexProviderOptions, O as DataContent, P as EmbeddedSkillConfig, Q as FilePart, R as ImagePart, Y as OpenCodeAgentOptions, Z as OpenCodePluginConfig, _ as OpenCodePluginEvent, $ as OpenCodePluginHookConfig, a0 as OpenCodeProviderOptions, a1 as OpenRouterPlugin, a6 as RepoSkillConfig, ad as TextPart, ah as UserContent, ai as UserContentPart } from '../types-3VRJIiW0.js';
+import { o as AgentProviderName, h as AgentOptions, t as AgentRunConfig, s as AgentRun, r as AgentResult, a7 as RawAgentEvent, b as AgentAttachRequest, B as AttachedRun, ae as SetupLayout, ak as UserContent } from '../types-BQ-_AUfY.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, C as ClaudeCodeAgentOptions, D as ClaudeCodeHookConfig, E as ClaudeCodeHookEvent, F as ClaudeCodeHookHandler, G as ClaudeCodeHookMatcherGroup, H as ClaudeCodeHooksConfig, I as ClaudeCodeProviderOptions, J as CodexAgentOptions, K as CodexCommandHook, L as CodexHookEvent, M as CodexHookMatcherGroup, N as CodexHooksConfig, O as CodexModelProviderConfig, P as CodexProviderOptions, Q as DataContent, R as EmbeddedSkillConfig, S as FilePart, T as ImagePart, $ as OpenCodeAgentOptions, a0 as OpenCodePluginConfig, a1 as OpenCodePluginEvent, a2 as OpenCodePluginHookConfig, a3 as OpenCodeProviderOptions, a4 as OpenRouterPlugin, a9 as RepoSkillConfig, ag as TextPart, al as UserContentPart } from '../types-BQ-_AUfY.js';
 import { S as Sandbox } from '../Sandbox-DcKAU-E3.js';
 export { AgentProvider } from '../enums.js';
 import 'e2b';
@@ -93,7 +93,7 @@ declare class Agent<P extends AgentProviderName = AgentProviderName> {
  *  - **Sandbox**: `/tmp/agentbox/<provider>` inside the sandbox.
  *  - **Local host**: `<os.tmpdir()>/agentbox-<provider>` on the host.
  */
-declare function agentboxRoot(provider: AgentProviderName, hasSandbox?: boolean): string;
+declare function agentboxRoot(provider: AgentProviderName, hasSandbox?: boolean, stateDirectory?: string): string;
 /**
  * Resolve the on-disk layout (config dirs per provider) for the given
  * agentbox root. Public so external consumers (e.g. agentbox-driven
@@ -124,4 +124,15 @@ declare function getAgentLayout(rootDir: string): SetupLayout;
 declare const AGENT_RESERVED_PORTS: Record<AgentProviderName, readonly number[]>;
 declare function collectAllAgentReservedPorts(): number[];
 
-export { AGENT_RESERVED_PORTS, Agent, AgentAttachRequest, AgentOptions, AgentProviderName, AgentResult, AgentRun, AgentRunConfig, AttachedRun, SetupLayout, agentboxRoot, collectAllAgentReservedPorts, getAgentLayout };
+type HarnessCommand = "plan" | "agent" | "goal";
+interface HarnessCapabilities {
+    commands: HarnessCommand[];
+    planning: "explicit" | "agent-directed";
+    questions: boolean;
+    fullAccess: boolean;
+}
+/** Adapter capabilities. Runtime adapters additionally validate commands against the live harness. */
+declare function harnessCapabilities(provider: AgentProviderName): HarnessCapabilities;
+declare function resolveHarnessCommand(provider: AgentProviderName, input: UserContent): Pick<AgentRunConfig, "input" | "mode" | "goal">;
+
+export { AGENT_RESERVED_PORTS, Agent, AgentAttachRequest, AgentOptions, AgentProviderName, AgentResult, AgentRun, AgentRunConfig, AttachedRun, type HarnessCapabilities, type HarnessCommand, SetupLayout, UserContent, agentboxRoot, collectAllAgentReservedPorts, getAgentLayout, harnessCapabilities, resolveHarnessCommand };

package/dist/agents/index.js

@@ -1,13 +1,15 @@
 import {
   Agent,
   agentboxRoot,
-  getAgentLayout
-} from "../chunk-34LDITII.js";
+  getAgentLayout,
+  harnessCapabilities,
+  resolveHarnessCommand
+} from "../chunk-BO4J4KSM.js";
 import "../chunk-775FIGGL.js";
 import {
   AGENT_RESERVED_PORTS,
   collectAllAgentReservedPorts
-} from "../chunk-AVXJMCBC.js";
+} from "../chunk-MTQ2S46C.js";
 import "../chunk-NSJM57Z4.js";
 import {
   AgentProvider
@@ -18,5 +20,7 @@ export {
   AgentProvider,
   agentboxRoot,
   collectAllAgentReservedPorts,
-  getAgentLayout
+  getAgentLayout,
+  harnessCapabilities,
+  resolveHarnessCommand
 };

package/dist/{chunk-TUBBWIOM.js → chunk-76AFK7XN.js}

@@ -10,7 +10,7 @@ import {
   sleep,
   suppressUnhandledRejection,
   time
-} from "./chunk-AVXJMCBC.js";
+} from "./chunk-MTQ2S46C.js";
 import {
   shellQuote,
   toShellCommand