agentbox-sdk 0.1.514 → 0.1.515

package/dist/events/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AISDKEvent, C as BackgroundTask, D as BackgroundTasksEvent, W as MessageCompletedEvent, X as MessageInjectedEvent, Y as MessageStartedEvent, Z as NativePlanEvent, _ as NormalizedAgentEvent, $ as NormalizedAgentEventBase, a0 as NormalizedAgentEventType, a7 as PermissionRequestedEvent, a8 as PermissionResolvedEvent, a9 as RawAgentEvent, aa as ReasoningDeltaEvent, ac as RunCancelledEvent, ad as RunCompletedEvent, ae as RunErrorEvent, af as RunStartedEvent, ah as TextDeltaEvent, aj as ToolCallCompletedEvent, ak as ToolCallDeltaEvent, al as ToolCallStartedEvent, ao as createNormalizedEvent, ap as normalizeRawAgentEvent, aq as toAISDKEvent, ar as toAISDKStream } from '../types-NhKw_6mW.js';
+export { A as AISDKEvent, C as BackgroundTask, D as BackgroundTasksEvent, W as MessageCompletedEvent, X as MessageInjectedEvent, Y as MessageStartedEvent, Z as NativePlanEvent, _ as NormalizedAgentEvent, $ as NormalizedAgentEventBase, a0 as NormalizedAgentEventType, a7 as PermissionRequestedEvent, a8 as PermissionResolvedEvent, a9 as RawAgentEvent, aa as ReasoningDeltaEvent, ac as RunCancelledEvent, ad as RunCompletedEvent, ae as RunErrorEvent, af as RunStartedEvent, ah as TextDeltaEvent, aj as ToolCallCompletedEvent, ak as ToolCallDeltaEvent, al as ToolCallStartedEvent, ao as createNormalizedEvent, ap as normalizeRawAgentEvent, aq as toAISDKEvent, ar as toAISDKStream } from '../types-BKvKgRMY.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 DataContent, T as EmbeddedSkillConfig, U as FilePart, V as ImagePart, W as MessageCompletedEvent, X as MessageInjectedEvent, Y as MessageStartedEvent, Z as NativePlanEvent, _ as NormalizedAgentEvent, $ as NormalizedAgentEventBase, a0 as NormalizedAgentEventType, a1 as OpenCodeAgentOptions, a2 as OpenCodePluginConfig, a3 as OpenCodePluginEvent, a4 as OpenCodePluginHookConfig, a5 as OpenCodeProviderOptions, a6 as OpenRouterPlugin, a7 as PermissionRequestedEvent, a8 as PermissionResolvedEvent, a9 as RawAgentEvent, aa as ReasoningDeltaEvent, ab as RepoSkillConfig, ac as RunCancelledEvent, ad as RunCompletedEvent, ae as RunErrorEvent, af as RunStartedEvent, ag as SetupLayout, ah as TextDeltaEvent, ai as TextPart, aj as ToolCallCompletedEvent, ak as ToolCallDeltaEvent, al as ToolCallStartedEvent, am as UserContent, an as UserContentPart, ao as createNormalizedEvent, ap as normalizeRawAgentEvent, aq as toAISDKEvent, ar as toAISDKStream } from './types-NhKw_6mW.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 DataContent, T as EmbeddedSkillConfig, U as FilePart, V as ImagePart, W as MessageCompletedEvent, X as MessageInjectedEvent, Y as MessageStartedEvent, Z as NativePlanEvent, _ as NormalizedAgentEvent, $ as NormalizedAgentEventBase, a0 as NormalizedAgentEventType, a1 as OpenCodeAgentOptions, a2 as OpenCodePluginConfig, a3 as OpenCodePluginEvent, a4 as OpenCodePluginHookConfig, a5 as OpenCodeProviderOptions, a6 as OpenRouterPlugin, a7 as PermissionRequestedEvent, a8 as PermissionResolvedEvent, a9 as RawAgentEvent, aa as ReasoningDeltaEvent, ab as RepoSkillConfig, ac as RunCancelledEvent, ad as RunCompletedEvent, ae as RunErrorEvent, af as RunStartedEvent, ag as SetupLayout, ah as TextDeltaEvent, ai as TextPart, aj as ToolCallCompletedEvent, ak as ToolCallDeltaEvent, al as ToolCallStartedEvent, am as UserContent, an as UserContentPart, ao as createNormalizedEvent, ap as normalizeRawAgentEvent, aq as toAISDKEvent, ar as toAISDKStream } from './types-BKvKgRMY.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

@@ -4,7 +4,7 @@ import {
   getAgentLayout,
   harnessCapabilities,
   resolveHarnessCommand
-} from "./chunk-D33LRRN7.js";
+} from "./chunk-HVXPNGSC.js";
 import {
   ProviderLogAssembler,
   createNormalizedEvent,

package/dist/{types-NhKw_6mW.d.ts → types-BKvKgRMY.d.ts}

@@ -110,6 +110,11 @@ interface BackgroundTasksEvent extends NormalizedAgentEventBase {
     tasks: BackgroundTask[];
     /** True once the harness ended its turn and the run stays open only for these tasks. */
     waiting: boolean;
+    /**
+     * Set on a run's last event when it ended with `tasks` still running in a
+     * parked harness: the work goes on, and a later run picks it up.
+     */
+    parked?: boolean;
 }
 interface RunCompletedEvent extends NormalizedAgentEventBase {
     type: "run.completed";
@@ -385,6 +390,13 @@ interface AgentRunConfig {
     model?: string;
     systemPrompt?: string;
     resumeSessionId?: string;
+    /**
+     * claude-code sandbox runs: attach to the harness parked for
+     * {@link resumeSessionId} without sending {@link input}, and stream the
+     * turn it started on its own. Completes with empty text when nothing is
+     * parked or no such turn exists. See `provider.parkBackgroundWork`.
+     */
+    resumeParked?: boolean;
     /**
      * Source session/thread to fork from. The new run begins in a *new*
      * session whose history is the prefix of the source up to and including
@@ -577,6 +589,20 @@ interface OpenCodeProviderOptions {
     plugins?: OpenCodePluginConfig[];
 }
 interface ClaudeCodeProviderOptions {
+    /**
+     * Sandbox runs only. End a run at its answer even when background work is
+     * still live, and keep the CLI alive in the sandbox for it (a "parked"
+     * run) instead of holding the run open. A run whose turn ends with nothing
+     * live is unaffected. The next run resuming that session takes the CLI
+     * over. When the CLI starts a turn on its own with nobody attached (a task
+     * finished, a schedule fired) the daemon POSTs `{ runId, sessionId }` to
+     * `wakeUrl` with `Authorization: Bearer <wakeToken>`; stream that turn with
+     * `resumeParked`. The park lasts what is left of `backgroundTaskTimeoutMs`.
+     */
+    parkBackgroundWork?: {
+        wakeUrl: string;
+        wakeToken: string;
+    };
     /** Request fast mode explicitly; false overrides inherited fast settings. */
     fastMode?: boolean;
     binary?: string;
@@ -682,6 +708,14 @@ interface AgentResult {
     rawEvents: RawAgentEvent[];
     events: NormalizedAgentEvent[];
     costData?: AgentCostData | null;
+    /**
+     * A {@link AgentRunConfig.resumeParked} run found nothing parked for its
+     * session — the park's budget ran out, the sandbox was replaced, or the CLI
+     * was torn down. The run streamed no turn of its own, so there is nothing
+     * to show for it. Never inferred from empty output: a real tool-only turn
+     * (a commit, an edit, a push) produces that too.
+     */
+    nothingParked?: boolean;
 }
 interface AgentRun extends AsyncIterable<NormalizedAgentEvent> {
     id: string;
@@ -694,11 +728,21 @@ interface AgentRun extends AsyncIterable<NormalizedAgentEvent> {
     respondToPermission(response: AgentPermissionResponse): Promise<void>;
     sendMessage(content: UserContent): Promise<void>;
     abort(): Promise<void>;
+    /**
+     * Stop holding the run open for background work. A run that is only
+     * waiting (`background.tasks` with `waiting: true`) stops what is left and
+     * completes with the answer it already has; unlike {@link abort} it is not
+     * cancelled. Asked while a turn is active, it applies at that turn's end.
+     * A no-op for a run that never waits.
+     */
+    finishBackgroundWait(): Promise<void>;
     readonly finished: Promise<AgentResult>;
 }
 interface AgentRunSink {
     setRaw(raw: unknown): void;
     setAbort(abort: () => Promise<void>): void;
+    /** Providers that hold runs open for background work register how to stop. */
+    setFinishBackgroundWait?(finish: () => void): void;
     setSessionId(sessionId: string): void;
     emitRaw(event: RawAgentEvent): void;
     emitEvent(event: NormalizedAgentEvent): void;
@@ -709,6 +753,8 @@ interface AgentRunSink {
     complete(result?: {
         text?: string;
         costData?: AgentCostData | null;
+        /** See {@link AgentResult.nothingParked}. */
+        nothingParked?: boolean;
     }): void;
     cancel(result?: {
         text?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentbox-sdk",
-  "version": "0.1.514",
+  "version": "0.1.515",
   "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
   "license": "MIT",
   "repository": {