agentbox-sdk 0.1.513 → 0.1.515

package/README.md

@@ -123,12 +123,68 @@ 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
+settles the run when Claude emits `session_state_changed: idle` and the live
+task set is empty. AgentBox enables this documented CLI event with
+`CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1`; there is no extra model call or
+fixed completion delay ([upstream opt-in documentation](https://github.com/anthropics/claude-agent-sdk-typescript/blob/main/CHANGELOG.md#0283)). Older/custom CLIs that never emit session state use
+a 15s grace as a compatibility fallback. 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.
+Tasks marked ambient by Claude (such as live-update watchers) do not keep the
+run waiting. The SDK's full task snapshots take precedence over task start and
+finish events, whose ordering relative to those snapshots is unspecified.
+
+AgentBox does not inject a Stop-hook prompt or infer from the answer that a
+running task is unwanted. A genuinely live polling helper keeps the run open
+until it finishes, is stopped, or reaches the wait budget. Unlike the interactive
+CLI, an AgentBox run owns the query lifetime: completing it closes the process.
+Keep the streaming input open while waiting so background continuations retain
+their hooks, permissions, and SDK MCP control channel.
+
+The host decides when a wait has stopped being useful. A foreground command
+that outlives Bash's timeout is moved to the background by the CLI, and a model
+that answers without it leaves the run open for work nobody needs.
+`run.finishBackgroundWait()` ends the wait: a run that is only waiting stops
+what is left and completes with the answer it already has (`run.completed`,
+not `run.cancelled` as with `abort()`). The request latches, so calling it
+while a turn is active applies at that turn's end; a run that never waits
+ignores it. Use it when the user moves on, for example by sending a follow-up.
+It applies equally to Codex native goal waits and OpenCode background subagents.
+
+```ts
+for await (const event of run) {
+  if (event.type === "background.tasks" && event.waiting && userMovedOn()) {
+    await run.finishBackgroundWait();
+  }
+}
+```
+
+**Parked runs (claude-code in a sandbox).** A sandbox outlives the run, and so
+does the in-sandbox daemon, so a run there does not have to stay open at all.
+With `provider.parkBackgroundWork: { wakeUrl, wakeToken }` a run whose turn
+ends with background work still live **completes at its answer** and the daemon
+keeps the CLI for that work; the last `background.tasks` event carries
+`parked: true` and the tasks still running. A turn that ends with nothing live
+is untouched: the CLI winds down as before. While parked:
+
+- The next run that resumes the session takes the same CLI over (never a second
+  one on the session). It learns what was live, skips the results of turns that
+  ran before its own input, answers, and parks again if work is still live.
+- When the CLI starts a turn on its own with nobody attached, the daemon POSTs
+  `{ runId, sessionId }` to `wakeUrl` with `Authorization: Bearer <wakeToken>`,
+  retrying until it gets a 2xx. Stream that turn with
+  `agent.stream({ input: "", resumeSessionId, resumeParked: true })`; it
+  completes with empty text if nothing is parked. Whether to act on a wake is
+  the host's call: a host already running that session is attached to the same
+  CLI, which delivers the turn inside that run.
+- The park lasts what is left of `backgroundTaskTimeoutMs`, then the CLI winds
+  down as at the wait ceiling. A rewind (`forkSessionId`) and an explicit
+  `DELETE` end it too. With parking on, `finishBackgroundWait()` parks rather
+  than stops the work. Output is buffered while nobody is attached (partial
+  deltas excepted), up to 16 MB.
 
 Codex owns command polling (`write_stdin`), yielded code-mode waits (`wait`),
 and subagent waits (`wait_agent`). AgentBox finishes an ordinary Codex run on
@@ -181,7 +237,7 @@ the end of the run.
 
 ## Agents
 
-Three agent providers are supported. Each wraps a CLI that runs inside the sandbox:
+Four agent providers are supported. Each wraps a CLI that runs inside the sandbox:
 
 | Provider      | CLI        | Model format                                    |
 | ------------- | ---------- | ----------------------------------------------- |

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, a9 as RawAgentEvent, b as AgentAttachRequest, B as AttachedRun, ag as SetupLayout, am as UserContent } from '../types-NhKw_6mW.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-NhKw_6mW.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-BKvKgRMY.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-BKvKgRMY.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-XJWZR2NR.js";
+} from "../chunk-HVXPNGSC.js";
 import "../chunk-775FIGGL.js";
 import {
   AGENT_RESERVED_PORTS,