agentbox-sdk 0.1.309 → 0.1.310

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, a2 as RawAgentEvent, b as AgentAttachRequest, y as AttachedRun, a9 as SetupLayout } from '../types-DmkbgYmn.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 CodexProviderOptions, N as DataContent, O as EmbeddedSkillConfig, P as FilePart, Q as ImagePart, X as OpenCodeAgentOptions, Y as OpenCodePluginConfig, Z as OpenCodePluginEvent, _ as OpenCodePluginHookConfig, $ as OpenCodeProviderOptions, a4 as RepoSkillConfig, ab as TextPart, af as UserContent, ag as UserContentPart } from '../types-DmkbgYmn.js';
+import { o as AgentProviderName, h as AgentOptions, t as AgentRunConfig, s as AgentRun, r as AgentResult, a2 as RawAgentEvent, b as AgentAttachRequest, y as AttachedRun, a9 as SetupLayout } from '../types-du-Kkn53.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 CodexProviderOptions, N as DataContent, O as EmbeddedSkillConfig, P as FilePart, Q as ImagePart, X as OpenCodeAgentOptions, Y as OpenCodePluginConfig, Z as OpenCodePluginEvent, _ as OpenCodePluginHookConfig, $ as OpenCodeProviderOptions, a4 as RepoSkillConfig, ab as TextPart, af as UserContent, ag as UserContentPart } from '../types-du-Kkn53.js';
 import { S as Sandbox } from '../Sandbox-DcKAU-E3.js';
 export { AgentProvider } from '../enums.js';
 import 'e2b';

package/dist/agents/index.js

@@ -2,8 +2,8 @@ import {
   Agent,
   agentboxRoot,
   getAgentLayout
-} from "../chunk-VBMMNUB7.js";
-import "../chunk-ZDSHOGJ4.js";
+} from "../chunk-6MDOW3GK.js";
+import "../chunk-PNONJAGY.js";
 import {
   AGENT_RESERVED_PORTS,
   collectAllAgentReservedPorts

package/dist/{chunk-VBMMNUB7.js → chunk-6MDOW3GK.js}

@@ -2,7 +2,7 @@ import {
   createNormalizedEvent,
   normalizeRawAgentEvent,
   toAISDKStream
-} from "./chunk-ZDSHOGJ4.js";
+} from "./chunk-PNONJAGY.js";
 import {
   AgentBoxError,
   AsyncQueue,
@@ -1662,6 +1662,7 @@ function buildClaudeQueryOptions(params) {
   if (run.systemPrompt) {
     extraArgs["append-system-prompt"] = run.systemPrompt;
   }
+  const includeHookEvents = provider?.includeHookEvents ?? false;
   return {
     cwd: params.cwd ?? params.request.options.cwd,
     env: params.env,
@@ -1669,7 +1670,9 @@ function buildClaudeQueryOptions(params) {
     settings: params.settingsPath,
     extraArgs,
     includePartialMessages: true,
+    includeHookEvents,
     thinking: { type: "adaptive", display: "summarized" },
+    ...provider?.additionalDirectories?.length ? { additionalDirectories: provider.additionalDirectories } : {},
     ...run.model ? { model: run.model } : {},
     ...run.reasoning ? { effort: run.reasoning } : {},
     ...provider?.permissionMode ? { permissionMode: provider.permissionMode } : {},
@@ -2355,12 +2358,33 @@ var ClaudeCodeAgentAdapter = class {
         rawPayloads.push(message);
         sink.emitRaw(toRawEvent(request.runId, message, message.type));
         if (message.type === "system") {
-          const sys = message;
-          if (sys.subtype === "init" && sys.session_id) {
+          const sub = message.subtype;
+          if (sub === "init") {
+            const sys = message;
+            if (sys.session_id) {
+              debugClaude(
+                "\u2605 session.init session_id=%s (%dms)",
+                sys.session_id.slice(0, 8),
+                Date.now() - executeStartedAt
+              );
+            }
+          } else if (sub === "hook_started") {
+            const h = message;
             debugClaude(
-              "\u2605 session.init session_id=%s (%dms)",
-              sys.session_id.slice(0, 8),
-              Date.now() - executeStartedAt
+              "hook.started name=%s event=%s hook_id=%s",
+              h.hook_name,
+              h.hook_event,
+              h.hook_id
+            );
+          } else if (sub === "hook_response") {
+            const h = message;
+            const stderr = h.stderr && h.stderr.length > 0 ? h.stderr.replace(/\s+$/, "") : void 0;
+            debugClaude(
+              "hook.response name=%s exit=%s outcome=%s%s",
+              h.hook_name,
+              h.exit_code,
+              h.outcome,
+              stderr ? ` stderr=${JSON.stringify(stderr).slice(0, 200)}` : ""
             );
           }
           continue;

package/dist/{chunk-ZDSHOGJ4.js → chunk-PNONJAGY.js}

@@ -291,6 +291,9 @@ var CodexLogAssembler = class {
     this.byItemId.set(itemId, next);
     return clone(next);
   }
+  getSnapshots() {
+    return Array.from(this.byItemId.values()).map(clone);
+  }
 };
 var OpenCodeLogAssembler = class {
   userMessageIds = /* @__PURE__ */ new Set();
@@ -376,12 +379,22 @@ var OpenCodeLogAssembler = class {
     this.byPartId.set(partId, next);
     return clone(next);
   }
+  getSnapshots() {
+    return Array.from(this.byPartId.values()).map(clone);
+  }
 };
 var ClaudeCodeLogAssembler = class {
   currentMessageId = null;
   textByMessageId = /* @__PURE__ */ new Map();
   thinkingByMessageId = /* @__PURE__ */ new Map();
   byMessageId = /* @__PURE__ */ new Map();
+  // Per-message tool_use / image / other non-text-non-thinking content blocks.
+  // Tracked persistently so any `upsertMessage` call (including those from a
+  // post-assistant `message_start` re-anchor) still renders them — otherwise
+  // a later stream_event for the same messageId would emit a snapshot without
+  // tool_use blocks, and the UI's dedup-by-messageId would wipe the running
+  // command from the trace.
+  extraBlocksByMessageId = /* @__PURE__ */ new Map();
   process(event) {
     if (!isRecord(event)) return [];
     const type = typeof event.type === "string" ? event.type : "";
@@ -429,7 +442,8 @@ var ClaudeCodeLogAssembler = class {
       if (final.thinking) {
         this.thinkingByMessageId.set(id, final.thinking);
       }
-      const snapshot = this.upsertMessage(id, final.extraBlocks);
+      this.mergeExtraBlocks(id, final.extraBlocks);
+      const snapshot = this.upsertMessage(id);
       this.currentMessageId = null;
       return [snapshot];
     }
@@ -440,6 +454,7 @@ var ClaudeCodeLogAssembler = class {
     this.textByMessageId.clear();
     this.thinkingByMessageId.clear();
     this.byMessageId.clear();
+    this.extraBlocksByMessageId.clear();
     for (const snapshot of snapshots) {
       if (!isRecord(snapshot)) continue;
       if (snapshot.type !== "message.updated") continue;
@@ -450,25 +465,46 @@ var ClaudeCodeLogAssembler = class {
       const content = message && Array.isArray(message.content) ? message.content : [];
       let text = "";
       let thinking = "";
+      const extraBlocks = [];
       for (const block of content) {
         if (!isRecord(block)) continue;
         if (block.type === "text" && typeof block.text === "string") {
           text += block.text;
         } else if (block.type === "thinking" && typeof block.thinking === "string") {
           thinking += block.thinking;
+        } else {
+          extraBlocks.push(block);
         }
       }
       this.textByMessageId.set(messageId, text);
       this.thinkingByMessageId.set(messageId, thinking);
+      if (extraBlocks.length > 0) {
+        this.mergeExtraBlocks(messageId, extraBlocks);
+      }
+    }
+  }
+  mergeExtraBlocks(messageId, blocks) {
+    if (blocks.length === 0) return;
+    let map = this.extraBlocksByMessageId.get(messageId);
+    if (!map) {
+      map = /* @__PURE__ */ new Map();
+      this.extraBlocksByMessageId.set(messageId, map);
+    }
+    for (const block of blocks) {
+      const key = typeof block.id === "string" && block.id ? `id:${block.id}` : `idx:${map.size}`;
+      map.set(key, clone(block));
     }
   }
-  upsertMessage(messageId, extraBlocks = []) {
+  upsertMessage(messageId) {
     const text = this.textByMessageId.get(messageId) ?? "";
     const thinking = this.thinkingByMessageId.get(messageId) ?? "";
     const content = [];
     if (thinking) content.push({ type: "thinking", thinking });
     if (text) content.push({ type: "text", text });
-    for (const block of extraBlocks) content.push(clone(block));
+    const extras = this.extraBlocksByMessageId.get(messageId);
+    if (extras) {
+      for (const block of extras.values()) content.push(clone(block));
+    }
     const next = {
       type: "message.updated",
       messageId,
@@ -481,6 +517,9 @@ var ClaudeCodeLogAssembler = class {
     this.byMessageId.set(messageId, next);
     return clone(next);
   }
+  getSnapshots() {
+    return Array.from(this.byMessageId.values()).map(clone);
+  }
 };
 function extractClaudeAssistantContent(message) {
   const content = Array.isArray(message.content) ? message.content : [];
@@ -523,6 +562,29 @@ var ProviderLogAssembler = class {
     }
     return [];
   }
+  /**
+   * Return the current deduped snapshot set held by the active per-provider
+   * assembler. Equivalent to running `dedupeSnapshots` over the full sequence
+   * of snapshots emitted by `process()` since construction (or last seed), but
+   * read directly from in-memory state — no transport or persistence layer
+   * involved. Used end-of-run to persist the full trace without paying a
+   * Redis LRANGE + parse roundtrip.
+   *
+   * Snapshots are returned in first-seen order (Map insertion order). Entries
+   * are cloned, so the caller can serialize them freely.
+   */
+  getSnapshots(provider) {
+    if (provider === AgentProvider.Codex || provider === "codex") {
+      return this.codex.getSnapshots();
+    }
+    if (provider === AgentProvider.OpenCode || provider === "opencode") {
+      return this.openCode.getSnapshots();
+    }
+    if (provider === AgentProvider.ClaudeCode || provider === "claude-code") {
+      return this.claudeCode.getSnapshots();
+    }
+    return [];
+  }
   /**
    * Re-seed the assembler from a sequence of previously-assembled snapshots
    * so that subsequent `process()` calls produce snapshots consistent with

package/dist/events/index.d.ts

@@ -1,4 +1,4 @@
-export { A as AISDKEvent, R as MessageCompletedEvent, S as MessageInjectedEvent, T as MessageStartedEvent, U as NormalizedAgentEvent, V as NormalizedAgentEventBase, W as NormalizedAgentEventType, a0 as PermissionRequestedEvent, a1 as PermissionResolvedEvent, a2 as RawAgentEvent, a3 as ReasoningDeltaEvent, a5 as RunCancelledEvent, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, aa as TextDeltaEvent, ac as ToolCallCompletedEvent, ad as ToolCallDeltaEvent, ae as ToolCallStartedEvent, ah as createNormalizedEvent, ai as normalizeRawAgentEvent, aj as toAISDKEvent, ak as toAISDKStream } from '../types-DmkbgYmn.js';
+export { A as AISDKEvent, R as MessageCompletedEvent, S as MessageInjectedEvent, T as MessageStartedEvent, U as NormalizedAgentEvent, V as NormalizedAgentEventBase, W as NormalizedAgentEventType, a0 as PermissionRequestedEvent, a1 as PermissionResolvedEvent, a2 as RawAgentEvent, a3 as ReasoningDeltaEvent, a5 as RunCancelledEvent, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, aa as TextDeltaEvent, ac as ToolCallCompletedEvent, ad as ToolCallDeltaEvent, ae as ToolCallStartedEvent, ah as createNormalizedEvent, ai as normalizeRawAgentEvent, aj as toAISDKEvent, ak as toAISDKStream } from '../types-du-Kkn53.js';
 import { AgentProvider } from '../enums.js';
 import '../Sandbox-DcKAU-E3.js';
 import 'e2b';
@@ -69,6 +69,18 @@ declare class ProviderLogAssembler {
      * a delta with no payload) or already represented by a previous snapshot.
      */
     process(provider: AgentProvider | string | null | undefined, event: unknown): JsonRecord[];
+    /**
+     * Return the current deduped snapshot set held by the active per-provider
+     * assembler. Equivalent to running `dedupeSnapshots` over the full sequence
+     * of snapshots emitted by `process()` since construction (or last seed), but
+     * read directly from in-memory state — no transport or persistence layer
+     * involved. Used end-of-run to persist the full trace without paying a
+     * Redis LRANGE + parse roundtrip.
+     *
+     * Snapshots are returned in first-seen order (Map insertion order). Entries
+     * are cloned, so the caller can serialize them freely.
+     */
+    getSnapshots(provider: AgentProvider | string | null | undefined): JsonRecord[];
     /**
      * Re-seed the assembler from a sequence of previously-assembled snapshots
      * so that subsequent `process()` calls produce snapshots consistent with

package/dist/events/index.js

@@ -4,7 +4,7 @@ import {
   normalizeRawAgentEvent,
   toAISDKEvent,
   toAISDKStream
-} from "../chunk-ZDSHOGJ4.js";
+} from "../chunk-PNONJAGY.js";
 import "../chunk-GOFJNFAD.js";
 export {
   ProviderLogAssembler,

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 AttachedRun, 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 CodexProviderOptions, N as DataContent, O as EmbeddedSkillConfig, P as FilePart, Q as ImagePart, R as MessageCompletedEvent, S as MessageInjectedEvent, T as MessageStartedEvent, U as NormalizedAgentEvent, V as NormalizedAgentEventBase, W as NormalizedAgentEventType, X as OpenCodeAgentOptions, Y as OpenCodePluginConfig, Z as OpenCodePluginEvent, _ as OpenCodePluginHookConfig, $ as OpenCodeProviderOptions, a0 as PermissionRequestedEvent, a1 as PermissionResolvedEvent, a2 as RawAgentEvent, a3 as ReasoningDeltaEvent, a4 as RepoSkillConfig, a5 as RunCancelledEvent, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, a9 as SetupLayout, aa as TextDeltaEvent, ab as TextPart, ac as ToolCallCompletedEvent, ad as ToolCallDeltaEvent, ae as ToolCallStartedEvent, af as UserContent, ag as UserContentPart, ah as createNormalizedEvent, ai as normalizeRawAgentEvent, aj as toAISDKEvent, ak as toAISDKStream } from './types-DmkbgYmn.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 AttachedRun, 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 CodexProviderOptions, N as DataContent, O as EmbeddedSkillConfig, P as FilePart, Q as ImagePart, R as MessageCompletedEvent, S as MessageInjectedEvent, T as MessageStartedEvent, U as NormalizedAgentEvent, V as NormalizedAgentEventBase, W as NormalizedAgentEventType, X as OpenCodeAgentOptions, Y as OpenCodePluginConfig, Z as OpenCodePluginEvent, _ as OpenCodePluginHookConfig, $ as OpenCodeProviderOptions, a0 as PermissionRequestedEvent, a1 as PermissionResolvedEvent, a2 as RawAgentEvent, a3 as ReasoningDeltaEvent, a4 as RepoSkillConfig, a5 as RunCancelledEvent, a6 as RunCompletedEvent, a7 as RunErrorEvent, a8 as RunStartedEvent, a9 as SetupLayout, aa as TextDeltaEvent, ab as TextPart, ac as ToolCallCompletedEvent, ad as ToolCallDeltaEvent, ae as ToolCallStartedEvent, af as UserContent, ag as UserContentPart, ah as createNormalizedEvent, ai as normalizeRawAgentEvent, aj as toAISDKEvent, ak as toAISDKStream } from './types-du-Kkn53.js';
 export { AGENT_RESERVED_PORTS, Agent, agentboxRoot, collectAllAgentReservedPorts, getAgentLayout } 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

@@ -2,14 +2,14 @@ import {
   Agent,
   agentboxRoot,
   getAgentLayout
-} from "./chunk-VBMMNUB7.js";
+} from "./chunk-6MDOW3GK.js";
 import {
   ProviderLogAssembler,
   createNormalizedEvent,
   normalizeRawAgentEvent,
   toAISDKEvent,
   toAISDKStream
-} from "./chunk-ZDSHOGJ4.js";
+} from "./chunk-PNONJAGY.js";
 import {
   Sandbox,
   SandboxAdapter,

package/dist/{types-DmkbgYmn.d.ts → types-du-Kkn53.d.ts}

@@ -401,6 +401,23 @@ interface ClaudeCodeProviderOptions {
     allowedTools?: string[];
     autoApproveTools?: boolean;
     verbose?: boolean;
+    /**
+     * Extra directories Claude Code is allowed to read/write outside `cwd`.
+     * Passed through to `--add-dir` (one flag per entry). Use absolute paths.
+     *
+     * Common case: cwd points at a parent directory and tasks need access
+     * to sibling repos cloned under it. Listing each repo here surfaces it
+     * to the agent without changing the working directory.
+     */
+    additionalDirectories?: string[];
+    /**
+     * When `true` (the default), the in-sandbox CLI emits `hook_started` and
+     * `hook_response` system messages so the host can observe every hook
+     * fire — useful to confirm a project-defined hook actually ran and to
+     * surface its stdout/stderr/exit_code on failures. Set `false` to
+     * silence them when hook noise drowns out the rest of the event stream.
+     */
+    includeHookEvents?: boolean;
 }
 interface CodexAgentOptions extends AgentOptionsBase {
     provider?: CodexProviderOptions;

package/package.json

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