agentbox-sdk 0.1.309 → 0.1.311

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-BNBEOIGX.js";
+import "../chunk-764MJCER.js";
 import {
   AGENT_RESERVED_PORTS,
   collectAllAgentReservedPorts

package/dist/{chunk-ZDSHOGJ4.js → chunk-764MJCER.js}

@@ -291,11 +291,29 @@ 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();
   textByPartId = /* @__PURE__ */ new Map();
   byPartId = /* @__PURE__ */ new Map();
+  // Sub-agent (`task` tool) linkage. opencode multiplexes the parent task
+  // tool's `state.metadata.sessionId` update and the child session's first
+  // stream events onto the same SSE bus with no ordering guarantee, so
+  // child events frequently arrive before the parent has published its
+  // child sessionID. We bind FIFO instead: every task tool we see goes
+  // onto a queue; the first non-main sessionID that lacks an explicit
+  // binding gets paired with the queue head. Once a binding is established
+  // we stamp every emitted snapshot for that child session with
+  // `parentTaskCallId` on the part so consumers don't have to re-derive
+  // the linkage from snapshots.
+  mainSessionID = null;
+  pendingTaskCallIds = [];
+  childSessionToTaskCallId = /* @__PURE__ */ new Map();
+  childMessageIdToTaskCallId = /* @__PURE__ */ new Map();
+  messageIdToSessionId = /* @__PURE__ */ new Map();
   process(event) {
     if (!isRecord(event)) {
       return [];
@@ -303,10 +321,48 @@ var OpenCodeLogAssembler = class {
     const type = typeof event.type === "string" ? event.type : "";
     const properties = isRecord(event.properties) ? event.properties : {};
     const info = isRecord(properties.info) ? properties.info : null;
+    const eventPart = isRecord(properties.part) ? properties.part : isRecord(event.part) ? event.part : null;
+    if (this.mainSessionID === null) {
+      const candidate = (typeof info?.sessionID === "string" ? info.sessionID : null) ?? (eventPart && typeof eventPart.sessionID === "string" ? eventPart.sessionID : null) ?? (typeof properties.sessionID === "string" ? properties.sessionID : null);
+      if (candidate) this.mainSessionID = candidate;
+    }
+    if (info && typeof info.id === "string" && typeof info.sessionID === "string") {
+      this.messageIdToSessionId.set(info.id, info.sessionID);
+    }
+    if (eventPart && typeof eventPart.id === "string" && typeof eventPart.messageID === "string" && typeof eventPart.sessionID === "string") {
+      this.messageIdToSessionId.set(eventPart.messageID, eventPart.sessionID);
+    }
+    if (eventPart && this.isTaskToolPart(eventPart)) {
+      const callId = typeof eventPart.callID === "string" ? eventPart.callID : typeof eventPart.id === "string" ? eventPart.id : null;
+      if (callId) {
+        const metaSid = this.extractTaskMetadataSessionId(eventPart);
+        if (metaSid && !this.childSessionToTaskCallId.has(metaSid)) {
+          this.childSessionToTaskCallId.set(metaSid, callId);
+          this.pendingTaskCallIds = this.pendingTaskCallIds.filter(
+            (id) => id !== callId
+          );
+        } else if (!metaSid) {
+          const alreadyBound = this.taskCallIdAlreadyBound(callId);
+          if (!alreadyBound && !this.pendingTaskCallIds.includes(callId)) {
+            this.pendingTaskCallIds.push(callId);
+          }
+        }
+      }
+    }
+    const effectiveSid = this.extractSessionID(properties, eventPart, info);
+    if (effectiveSid && effectiveSid !== this.mainSessionID && !this.childSessionToTaskCallId.has(effectiveSid) && this.pendingTaskCallIds.length > 0) {
+      const taskCallId = this.pendingTaskCallIds.shift();
+      this.childSessionToTaskCallId.set(effectiveSid, taskCallId);
+    }
     if (type === "message.updated" && typeof info?.id === "string" && info.role === "user") {
       this.userMessageIds.add(info.id);
       return [clone(event)];
     }
+    const parentTaskCallId = this.resolveParentTaskCallId(
+      effectiveSid,
+      eventPart,
+      info
+    );
     if (type === "message.part.delta") {
       const partId = typeof properties.partID === "string" ? properties.partID : null;
       const messageId = typeof properties.messageID === "string" ? properties.messageID : null;
@@ -314,32 +370,50 @@ var OpenCodeLogAssembler = class {
       if (!partId || !delta || properties.field !== "text" || messageId && this.userMessageIds.has(messageId)) {
         return [];
       }
+      if (messageId && effectiveSid) {
+        this.messageIdToSessionId.set(messageId, effectiveSid);
+      }
       const text = (this.textByPartId.get(partId) ?? "") + delta;
       this.textByPartId.set(partId, text);
-      return [
-        this.upsertPart(partId, {
-          id: partId,
-          messageID: messageId ?? void 0,
-          type: "text",
-          text
-        })
-      ];
+      const part = {
+        id: partId,
+        messageID: messageId ?? void 0,
+        type: "text",
+        text
+      };
+      if (parentTaskCallId) {
+        part.parentTaskCallId = parentTaskCallId;
+        if (messageId) {
+          this.childMessageIdToTaskCallId.set(messageId, parentTaskCallId);
+        }
+      }
+      return [this.upsertPart(partId, part)];
     }
-    const part = isRecord(properties.part) ? properties.part : isRecord(event.part) ? event.part : null;
-    if (part && typeof part.id === "string") {
-      if (part.messageID && this.userMessageIds.has(String(part.messageID))) {
+    if (eventPart && typeof eventPart.id === "string") {
+      if (eventPart.messageID && this.userMessageIds.has(String(eventPart.messageID))) {
         return [];
       }
-      const previous = this.byPartId.get(part.id);
-      if (part.type === "text" && previous && isRecord(previous.properties?.part)) {
+      const previous = this.byPartId.get(eventPart.id);
+      if (eventPart.type === "text" && previous && isRecord(previous.properties?.part)) {
         const previousPart = previous.properties.part;
         const previousText = typeof previousPart.text === "string" ? previousPart.text : "";
-        const nextText = typeof part.text === "string" ? part.text : "";
+        const nextText = typeof eventPart.text === "string" ? eventPart.text : "";
         if (nextText.length < previousText.length) {
           return [clone(previous)];
         }
       }
-      this.byPartId.set(part.id, clone(event));
+      const enriched = clone(event);
+      if (parentTaskCallId) {
+        this.stampParentTaskCallId(enriched, parentTaskCallId);
+        if (typeof eventPart.messageID === "string") {
+          this.childMessageIdToTaskCallId.set(
+            eventPart.messageID,
+            parentTaskCallId
+          );
+        }
+      }
+      this.byPartId.set(eventPart.id, enriched);
+      return [clone(enriched)];
     }
     return [clone(event)];
   }
@@ -347,11 +421,23 @@ var OpenCodeLogAssembler = class {
     this.userMessageIds.clear();
     this.textByPartId.clear();
     this.byPartId.clear();
+    this.mainSessionID = null;
+    this.pendingTaskCallIds = [];
+    this.childSessionToTaskCallId.clear();
+    this.childMessageIdToTaskCallId.clear();
+    this.messageIdToSessionId.clear();
     for (const snapshot of snapshots) {
       if (!isRecord(snapshot)) continue;
       const type = typeof snapshot.type === "string" ? snapshot.type : "";
       const properties = isRecord(snapshot.properties) ? snapshot.properties : {};
       const info = isRecord(properties.info) ? properties.info : null;
+      if (this.mainSessionID === null) {
+        const candidate = (typeof info?.sessionID === "string" ? info.sessionID : null) ?? (typeof properties.sessionID === "string" ? properties.sessionID : null);
+        if (candidate) this.mainSessionID = candidate;
+      }
+      if (info && typeof info.id === "string" && typeof info.sessionID === "string") {
+        this.messageIdToSessionId.set(info.id, info.sessionID);
+      }
       if (type === "message.updated" && typeof info?.id === "string" && info.role === "user") {
         this.userMessageIds.add(info.id);
         continue;
@@ -362,9 +448,88 @@ var OpenCodeLogAssembler = class {
         if (typeof part.text === "string") {
           this.textByPartId.set(part.id, part.text);
         }
+        if (typeof part.messageID === "string" && typeof part.sessionID === "string") {
+          this.messageIdToSessionId.set(part.messageID, part.sessionID);
+        }
+        if (typeof part.parentTaskCallId === "string") {
+          if (typeof part.sessionID === "string" && !this.childSessionToTaskCallId.has(part.sessionID)) {
+            this.childSessionToTaskCallId.set(
+              part.sessionID,
+              part.parentTaskCallId
+            );
+          }
+          if (typeof part.messageID === "string") {
+            this.childMessageIdToTaskCallId.set(
+              part.messageID,
+              part.parentTaskCallId
+            );
+          }
+        }
+        if (this.isTaskToolPart(part)) {
+          const callId = typeof part.callID === "string" ? part.callID : typeof part.id === "string" ? part.id : null;
+          const metaSid = this.extractTaskMetadataSessionId(part);
+          if (callId && metaSid && !this.childSessionToTaskCallId.has(metaSid)) {
+            this.childSessionToTaskCallId.set(metaSid, callId);
+          }
+        }
       }
     }
   }
+  isTaskToolPart(part) {
+    if (part.type !== "tool") return false;
+    const tool = typeof part.tool === "string" ? part.tool.toLowerCase() : "";
+    return tool === "task";
+  }
+  taskCallIdAlreadyBound(callId) {
+    for (const v of this.childSessionToTaskCallId.values()) {
+      if (v === callId) return true;
+    }
+    return false;
+  }
+  extractTaskMetadataSessionId(part) {
+    const state = isRecord(part.state) ? part.state : null;
+    const metadata = state && isRecord(state.metadata) ? state.metadata : null;
+    if (!metadata) return null;
+    if (typeof metadata.sessionId === "string") return metadata.sessionId;
+    if (typeof metadata.sessionID === "string") return metadata.sessionID;
+    return null;
+  }
+  extractSessionID(properties, part, info) {
+    if (typeof properties.sessionID === "string") return properties.sessionID;
+    if (part && typeof part.sessionID === "string") return part.sessionID;
+    if (info && typeof info.sessionID === "string") return info.sessionID;
+    return null;
+  }
+  resolveParentTaskCallId(sessionID, part, info) {
+    if (sessionID && this.childSessionToTaskCallId.has(sessionID)) {
+      return this.childSessionToTaskCallId.get(sessionID) ?? null;
+    }
+    const candidateMessageIds = [];
+    if (part && typeof part.messageID === "string") {
+      candidateMessageIds.push(part.messageID);
+    }
+    if (info && typeof info.id === "string") {
+      candidateMessageIds.push(info.id);
+    }
+    for (const messageId of candidateMessageIds) {
+      const cached = this.childMessageIdToTaskCallId.get(messageId);
+      if (cached) return cached;
+      const mappedSid = this.messageIdToSessionId.get(messageId);
+      if (mappedSid && this.childSessionToTaskCallId.has(mappedSid)) {
+        const tcid = this.childSessionToTaskCallId.get(mappedSid);
+        this.childMessageIdToTaskCallId.set(messageId, tcid);
+        return tcid;
+      }
+    }
+    return null;
+  }
+  stampParentTaskCallId(snapshot, parentTaskCallId) {
+    const properties = isRecord(snapshot.properties) ? snapshot.properties : null;
+    const part = properties && isRecord(properties.part) ? properties.part : isRecord(snapshot.part) ? snapshot.part : null;
+    if (part) {
+      part.parentTaskCallId = parentTaskCallId;
+    }
+  }
   upsertPart(partId, part) {
     const next = {
       type: "message.part.updated",
@@ -376,12 +541,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 +604,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 +616,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 +627,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 +679,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 +724,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/{chunk-VBMMNUB7.js → chunk-BNBEOIGX.js}

@@ -2,7 +2,7 @@ import {
   createNormalizedEvent,
   normalizeRawAgentEvent,
   toAISDKStream
-} from "./chunk-ZDSHOGJ4.js";
+} from "./chunk-764MJCER.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/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-764MJCER.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-BNBEOIGX.js";
 import {
   ProviderLogAssembler,
   createNormalizedEvent,
   normalizeRawAgentEvent,
   toAISDKEvent,
   toAISDKStream
-} from "./chunk-ZDSHOGJ4.js";
+} from "./chunk-764MJCER.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.311",
   "description": "Swappable coding agents and sandbox providers for Bun and TypeScript.",
   "license": "MIT",
   "repository": {