agentbox-sdk 0.1.508 → 0.1.512

package/README.md

@@ -115,6 +115,70 @@ for await (const event of run) {
 const result = await run.finished;
 ```
 
+Claude Code can leave work running after its turn ends (`run_in_background`
+shells, `Monitor`, background subagents, scheduled wakeups) and re-prompts
+itself when that work finishes. AgentBox reports it through `background.tasks`
+events — `tasks` is the full live set after each change and `waiting` is `true`
+while the harness has ended its turn and the run stays open only for those
+tasks (or, with an empty set, for the wake-up the CLI queues for a task that
+finished mid-turn) — and settles the run on the follow-up turn's result
+instead of the first one. Once background work has been seen, a turn end
+settles the run only after a 15s grace with no new turn, and a final
+`background.tasks` with `tasks: []` and `waiting: false` precedes the settle.
+`backgroundTaskTimeoutMs` bounds the total time spent waiting across the run:
+default 30 minutes, `0` settles at the first turn end as before, `Infinity`
+waits forever. On expiry the tasks are stopped best-effort and the run
+completes with the last turn's text.
+
+Codex owns command polling (`write_stdin`), yielded code-mode waits (`wait`),
+and subagent waits (`wait_agent`). AgentBox finishes an ordinary Codex run on
+its root `turn/completed`, regardless of shell processes still running. It does
+not classify commands, wait for their exit, or inject synthetic follow-up turns.
+Raw tool events remain available. A command ending after the final turn does
+not restart the model. Remote cleanup disconnects from the shared app-server;
+local cleanup shuts down the app-server it owns.
+
+Native Codex goals are a separate lifecycle: an active root-thread goal keeps
+the run open between turns so Codex can continue on its own. AgentBox reports
+these gaps with `background.tasks { tasks: [], waiting: true }` and clears the
+wait when the next native turn starts. A root goal becoming `complete` or
+`blocked` ends the run after its final turn; a goal cleared or made inactive
+while idle settles immediately. Child-thread and stale-turn goal updates do
+not end the root run. `blocked` preserves the final answer without implying
+that the objective was achieved.
+
+Only these native goal waits use `backgroundTaskTimeoutMs` for Codex. The
+15-second idle grace and total wait ceiling bound the gap between native turns;
+`0` settles at the first turn. Expiry settles with the last answer without
+terminating remote shell processes. A user message can resume an idle goal
+wait. Stateless cancellation (`Agent.attach(...).abort()`) interrupts an active
+turn, or starts a turn only to interrupt it if the thread is idle, then stops
+the idle thread's leftover terminals. Claude Code and OpenCode retain their own
+background-work handling described above and below.
+
+OpenCode has no background shells, monitors, or wake-ups; its only work that
+outlives a turn is `task {background: true}`, which the server accepts only when
+it runs with `OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true` (or the
+`OPENCODE_EXPERIMENTAL` umbrella) in its environment. With that flag the parent
+session goes idle while the child session runs and OpenCode itself re-prompts
+the parent with the child's result. AgentBox recognises a background child from
+the parent's `task` tool call (`metadata.background`), so nothing depends on the
+caller's env: while such a child is live at the parent's idle the run stays
+open, the children are reported through `background.tasks` (`type:
+"subagent"`, `description` is the task description / child session title),
+`waiting` flips to `false` when the parent resumes, and the run settles on the
+next parent idle with nothing live — its text is the parent's last assistant
+message, never the injected result. Child liveness comes from SSE frames
+reconciled against `GET /session/status` at each parent idle and while waiting,
+and the injected `<task id=… state=…>` result also counts as the child's
+completion, so a lost frame cannot hold the run open. A child that ends without
+waking the parent settles the run after the 15s grace. `backgroundTaskTimeoutMs`
+bounds the total wait as for Claude Code; on expiry, or when the run fails with
+a child still live, the leftover subagents are stopped best-effort via
+`POST /session/:id/abort`. Aborting the run while waiting cancels the children
+through the same endpoint. Without the flag nothing changes: a parent idle is
+the end of the run.
+
 ## Agents
 
 Three agent providers are supported. Each wraps a CLI that runs inside the sandbox:
@@ -138,13 +202,15 @@ Pass an optional `reasoning` level alongside `model` on any run. It maps to each
 ```ts
 await agent.run({
   model: "sonnet",
-  reasoning: "high", // "low" | "medium" | "high" | "xhigh"
+  reasoning: "high", // "low" | "medium" | "high" | "xhigh" | "max" | "ultra"
   input: "Refactor this module and explain your reasoning.",
 });
 ```
 
 `xhigh` requires a model that supports it (e.g. Claude Opus 4.7+, Codex `gpt-5.4`).
 
+Codex also supports `max` (maximum reasoning) and `ultra` (maximum reasoning with automatic task delegation). Astra, GPT-5.6 Sol, and GPT-5.6 Terra support both; GPT-5.6 Luna supports `max`. Check the runtime's `model/list` → `supportedReasoningEfforts` for model availability. Both values are forwarded unchanged to `turn/start.effort`, including resumed and plan-mode turns; other AgentBox providers reject them.
+
 ### Open-source & custom models (OpenRouter, OSS)
 
 Codex isn't limited to OpenAI models — it can route through any
@@ -547,7 +613,11 @@ 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.
+and local settings instead. Neither mode copies the CLI's credentials. When
+`backgroundTaskTimeoutMs` expires, host Claude stops the leftover background
+tasks through the SDK; in a sandbox the daemon lets the CLI wind down on
+disconnect, bounded by `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS=30000`, which
+AgentBox sets in the CLI environment unless `env` already defines it.
 
 Each host OpenCode Agent owns an authenticated loopback server on an ephemeral
 port. Managed configuration uses an isolated configuration directory; native
@@ -578,3 +648,5 @@ CLIs and SDK mocks; live tests remain opt-in.
 ## License
 
 MIT
+
+For native speed selection, use `provider: { serviceTier: "fast" }` with Codex (or `"default"` for standard speed), and `provider: { fastMode: true }` with Claude Code. Omit these options to inherit harness settings. Availability and usage charges are enforced by the harness.

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, 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 { o as AgentProviderName, h as AgentOptions, t as AgentRunConfig, s as AgentRun, r as AgentResult, a9 as RawAgentEvent, b as AgentAttachRequest, B as AttachedRun, ag as SetupLayout, am as UserContent } from '../types-VT1LMbLW.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 DataContent, T as EmbeddedSkillConfig, U as FilePart, V as ImagePart, a1 as OpenCodeAgentOptions, a2 as OpenCodePluginConfig, a3 as OpenCodePluginEvent, a4 as OpenCodePluginHookConfig, a5 as OpenCodeProviderOptions, a6 as OpenRouterPlugin, ab as RepoSkillConfig, ai as TextPart, an as UserContentPart } from '../types-VT1LMbLW.js';
 import { S as Sandbox } from '../Sandbox-DcKAU-E3.js';
 export { AgentProvider } from '../enums.js';
 import 'e2b';

package/dist/agents/index.js

@@ -4,7 +4,7 @@ import {
   getAgentLayout,
   harnessCapabilities,
   resolveHarnessCommand
-} from "../chunk-BO4J4KSM.js";
+} from "../chunk-4DADE7TF.js";
 import "../chunk-775FIGGL.js";
 import {
   AGENT_RESERVED_PORTS,