@band-ai/sdk 0.2.1 → 0.3.0

package/dist/{ClaudeSDKAdapter-Cna5P1dR.d.ts → ClaudeSDKAdapter-CXud2DBE.d.ts}

@@ -1,6 +1,6 @@
 import { S as SimpleAdapter } from './simpleAdapter--wznuoOw.js';
 import { A as AdapterToolsProtocol, a as AgentToolsProtocol, c as MessagingTools, T as ToolExecutor, f as ToolSchemaProvider, H as HistoryConverter } from './protocols-Bwwcql0h.js';
-import { H as HistoryProvider, P as PlatformMessage } from './types-BTN_ZETM.js';
+import { H as HistoryProvider, P as PlatformMessage } from './types-DFUtpxah.js';
 import { L as Logger } from './logger-CABQOnlR.js';
 import { C as CustomToolDef } from './customTools-BzF0IISO.js';
 import { m as ToolModelMessage, n as ToolModelSchema, M as MetadataMap } from './dtos-B8KU_q4d.js';
@@ -562,6 +562,7 @@ declare class GoogleADKAdapter extends SimpleAdapter<GoogleADKMessages, AdapterT
     private buildPrompt;
     private formatIncomingMessage;
     private reportExecutionEvent;
+    private warnOnFailedSend;
 }
 
 interface LangGraphGraph {

package/dist/{ClaudeSDKAdapter-BY4zEbCl.d.cts → ClaudeSDKAdapter-Cx6zhSaG.d.cts}

@@ -1,6 +1,6 @@
 import { S as SimpleAdapter } from './simpleAdapter-BpT4XbZC.cjs';
 import { A as AdapterToolsProtocol, a as AgentToolsProtocol, c as MessagingTools, T as ToolExecutor, f as ToolSchemaProvider, H as HistoryConverter } from './protocols-Bz1rxcUg.cjs';
-import { H as HistoryProvider, P as PlatformMessage } from './types-D958TC71.cjs';
+import { H as HistoryProvider, P as PlatformMessage } from './types-BNNtOXu3.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
 import { C as CustomToolDef } from './customTools-BzF0IISO.cjs';
 import { m as ToolModelMessage, n as ToolModelSchema, M as MetadataMap } from './dtos-B8KU_q4d.cjs';
@@ -562,6 +562,7 @@ declare class GoogleADKAdapter extends SimpleAdapter<GoogleADKMessages, AdapterT
     private buildPrompt;
     private formatIncomingMessage;
     private reportExecutionEvent;
+    private warnOnFailedSend;
 }
 
 interface LangGraphGraph {

package/dist/adapters.cjs

@@ -141,13 +141,17 @@ var init_memory = __esm({
 });
 
 // src/contracts/chatEvents.ts
-var CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES;
+function isBlankEventContent(content) {
+  return !VISIBLE_CONTENT_PATTERN.test(content);
+}
+var CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, VISIBLE_CONTENT_PATTERN;
 var init_chatEvents = __esm({
   "src/contracts/chatEvents.ts"() {
     "use strict";
     init_errors();
     CHAT_EVENT_TYPES = ["tool_call", "tool_result", "thought", "error", "task"];
     CHAT_MESSAGE_TYPES = ["text", ...CHAT_EVENT_TYPES];
+    VISIBLE_CONTENT_PATTERN = /[\p{L}\p{N}\p{P}\p{S}]/u;
   }
 });
 
@@ -496,6 +500,13 @@ function isToolExecutorError(value) {
   const candidate = value;
   return candidate.ok === false && typeof candidate.errorType === "string" && TOOL_EXECUTOR_ERROR_TYPES.includes(candidate.errorType) && typeof candidate.toolName === "string" && typeof candidate.message === "string" && typeof candidate.legacyMessage === "string";
 }
+function isStructuredToolFailure(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const payload = value;
+  return payload.ok === false && typeof payload.message === "string";
+}
 function toLegacyToolExecutorErrorMessage(value) {
   if (typeof value === "string") {
     return value;
@@ -1246,7 +1257,116 @@ ${customSection}`.trim();
   return parts.join("\n\n");
 }
 
+// src/runtime/types.ts
+function ensureHandlePrefix(handle) {
+  if (!handle) {
+    return null;
+  }
+  return handle.startsWith("@") ? handle : `@${handle}`;
+}
+
+// src/runtime/formatters.ts
+function isMetadataMap(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function mentionSubjectsFromMetadata(metadata) {
+  const mentions = metadata?.mentions;
+  if (!Array.isArray(mentions)) {
+    return [];
+  }
+  const subjects = [];
+  for (const mention of mentions) {
+    if (!isMetadataMap(mention) || typeof mention.id !== "string") {
+      continue;
+    }
+    const label = [mention.handle, mention.username, mention.name].find(
+      (value) => typeof value === "string" && value.trim().length > 0
+    );
+    if (label === void 0) {
+      continue;
+    }
+    subjects.push({ id: mention.id, handle: label });
+  }
+  return subjects;
+}
+function replaceUuidMentions(content, participants) {
+  if (!content || participants.length === 0) {
+    return content;
+  }
+  let next = content;
+  for (const participant of participants) {
+    const participantId = participant.id;
+    const handle = participant.handle;
+    if (typeof participantId === "string" && typeof handle === "string") {
+      next = next.replaceAll(`@[[${participantId}]]`, ensureHandlePrefix(handle) ?? "");
+    }
+  }
+  return next;
+}
+function formatMessageForLlm(message, participants) {
+  const senderType = String(message.sender_type ?? "");
+  const senderName = String(message.sender_name ?? message.name ?? senderType);
+  const content = participants ? replaceUuidMentions(String(message.content ?? ""), participants) : String(message.content ?? "");
+  return {
+    role: senderType === "Agent" ? "assistant" : "user",
+    content,
+    sender_name: senderName,
+    sender_type: senderType,
+    message_type: String(message.message_type ?? "text"),
+    metadata: isMetadataMap(message.metadata) ? message.metadata : {}
+  };
+}
+function formatHistoryForLlm(messages, options) {
+  const excludeId = options?.excludeId;
+  const participants = options?.participants;
+  return messages.filter((message) => String(message.id ?? "") !== excludeId).map((message) => formatMessageForLlm(message, participants));
+}
+
+// src/adapters/shared/conversationPrompt.ts
+function systemUpdateParts(participantsMessage, contactsMessage) {
+  const parts = [];
+  if (participantsMessage) {
+    parts.push(`[System]: ${participantsMessage}`);
+  }
+  if (contactsMessage) {
+    parts.push(`[System]: ${contactsMessage}`);
+  }
+  return parts;
+}
+function buildConversationPrompt(options) {
+  const parts = [];
+  if (options.isSessionBootstrap && options.history.length > 0) {
+    const historyText = options.history.raw.slice(-(options.maxHistoryMessages ?? 50)).map(formatHistoryLine).join("\n");
+    parts.push(`${options.historyHeader}
+${historyText}`);
+  }
+  parts.push(...systemUpdateParts(options.participantsMessage, options.contactsMessage));
+  parts.push(options.currentMessage);
+  return parts.join("\n\n");
+}
+function formatHistoryLine(entry) {
+  const sender = String(entry.sender_name ?? entry.sender_type ?? "Unknown");
+  const content = String(entry.content ?? "");
+  return `[${sender}]: ${content}`;
+}
+
+// src/adapters/shared/withTimeout.ts
+async function withTimeout(promise, timeoutMs, message) {
+  let timer;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(message)), timeoutMs);
+      })
+    ]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 // src/adapters/acp/ACPClientAdapter.ts
+init_chatEvents();
 init_schemas();
 
 // src/mcp/auth.ts
@@ -2029,6 +2149,7 @@ var acpModule = new LazyAsyncValue({
 
 // src/adapters/acp/ACPClientAdapter.ts
 var DEFAULT_PERMISSION_TIMEOUT_MS = 5 * 6e4;
+var SET_SESSION_MODE_TIMEOUT_MS = 1e4;
 var ACPClientAdapter = class extends SimpleAdapter {
   command;
   cwd;
@@ -2047,6 +2168,7 @@ var ACPClientAdapter = class extends SimpleAdapter {
   pendingPermissions = /* @__PURE__ */ new Map();
   resolvePermission;
   permissionTimeoutMs;
+  requestedPermissionMode;
   logger;
   backend = null;
   backendPromise = null;
@@ -2077,6 +2199,10 @@ var ACPClientAdapter = class extends SimpleAdapter {
     this.resolvePermission = options.resolvePermission;
     this.logger = options.logger ?? new NoopLogger();
     this.permissionTimeoutMs = options.permissionTimeoutMs ?? DEFAULT_PERMISSION_TIMEOUT_MS;
+    this.requestedPermissionMode = options.requestedPermissionMode;
+    if (this.requestedPermissionMode !== void 0 && this.requestedPermissionMode.length === 0) {
+      throw new ValidationError("requestedPermissionMode must be a non-empty mode id, got an empty string");
+    }
     if (this.resolvePermission && (!Number.isFinite(this.permissionTimeoutMs) || this.permissionTimeoutMs <= 0)) {
       throw new ValidationError(`permissionTimeoutMs must be a positive finite number, got ${options.permissionTimeoutMs}`);
     }
@@ -2091,7 +2217,7 @@ var ACPClientAdapter = class extends SimpleAdapter {
     });
     await this.ensureConnection();
   }
-  async onMessage(message, tools, history, _participantsMessage, _contactsMessage, context) {
+  async onMessage(message, tools, history, participantsMessage, contactsMessage, context) {
     if (context.isSessionBootstrap) {
       this.rehydrate(history);
     }
@@ -2107,9 +2233,11 @@ var ACPClientAdapter = class extends SimpleAdapter {
       sessionId,
       (params) => this.handlePermissionRequest(tools, context.roomId, params)
     );
-    const promptText = this.bootstrappedSessions.has(sessionId) ? message.content : `${this.buildSystemContext(context.roomId, message)}
+    const content = replaceUuidMentions(message.content, mentionSubjectsFromMetadata(message.metadata));
+    const messageWithContext = [...systemUpdateParts(participantsMessage, contactsMessage), content].join("\n\n");
+    const promptText = this.bootstrappedSessions.has(sessionId) ? messageWithContext : `${this.buildSystemContext(context.roomId, message)}
 
-${message.content}`;
+${messageWithContext}`;
     this.bootstrappedSessions.add(sessionId);
     try {
       await connection.prompt({
@@ -2236,9 +2364,10 @@ ${message.content}`;
     const mcpServers = await this.buildSessionMcpServers();
     if (existingSessionId) {
       const restored = await this.tryRestoreSession(connection, existingSessionId, mcpServers);
-      if (restored) {
+      if (restored.ok) {
         this.activeSessions.add(existingSessionId);
         this.bootstrappedSessions.add(existingSessionId);
+        await this.applyRequestedPermissionMode(connection, existingSessionId, restored.modes);
         return existingSessionId;
       }
     }
@@ -2248,30 +2377,52 @@ ${message.content}`;
     });
     this.roomToSession.set(roomId, created.sessionId);
     this.activeSessions.add(created.sessionId);
+    await this.applyRequestedPermissionMode(connection, created.sessionId, created.modes);
     return created.sessionId;
   }
   async tryRestoreSession(connection, sessionId, mcpServers) {
+    const capabilities = this.connectionState?.agentCapabilities;
+    const params = { cwd: this.cwd, mcpServers, sessionId };
+    const restore = capabilities?.loadSession ? () => connection.loadSession(params) : capabilities?.sessionCapabilities?.resume ? () => connection.unstable_resumeSession(params) : null;
+    if (!restore) {
+      return { ok: false };
+    }
     try {
-      if (this.connectionState?.agentCapabilities?.loadSession) {
-        await connection.loadSession({
-          cwd: this.cwd,
-          mcpServers,
-          sessionId
-        });
-        return true;
-      }
-      if (this.connectionState?.agentCapabilities?.sessionCapabilities?.resume) {
-        await connection.unstable_resumeSession({
-          cwd: this.cwd,
-          mcpServers,
-          sessionId
-        });
-        return true;
-      }
+      const restored = await restore();
+      return { ok: true, modes: restored?.modes };
     } catch {
-      return false;
+      return { ok: false };
+    }
+  }
+  // Best-effort: never throws, so a mode switch going wrong can't take a
+  // session establishment down with it.
+  async applyRequestedPermissionMode(connection, sessionId, modes) {
+    const requestedModeId = this.requestedPermissionMode;
+    if (!requestedModeId || !modes || modes.currentModeId === requestedModeId) {
+      return;
+    }
+    const availableModes = Array.isArray(modes.availableModes) ? modes.availableModes : [];
+    if (!availableModes.some((mode) => mode?.id === requestedModeId)) {
+      this.safeWarn("requested permission mode is not advertised by this session", {
+        sessionId,
+        requestedModeId,
+        availableModeIds: availableModes.map((mode) => mode?.id)
+      });
+      return;
+    }
+    try {
+      await withTimeout(
+        connection.setSessionMode({ sessionId, modeId: requestedModeId }),
+        SET_SESSION_MODE_TIMEOUT_MS,
+        `setSessionMode did not respond within ${SET_SESSION_MODE_TIMEOUT_MS}ms`
+      );
+    } catch (error) {
+      this.safeWarn("failed to switch session into the requested permission mode", {
+        sessionId,
+        requestedModeId,
+        error: String(error)
+      });
     }
-    return false;
   }
   async buildSessionMcpServers() {
     const mcpServers = [...this.mcpServers];
@@ -2410,6 +2561,18 @@ ${message.content}`;
     const matched = chosenId !== void 0 && options.some((option) => option.optionId === chosenId);
     return matched ? { outcome: { outcome: "selected", optionId: chosenId } } : { outcome: { outcome: "cancelled" } };
   }
+  // A caller-supplied `Logger` isn't guaranteed to be synchronous or
+  // non-throwing. Every best-effort warning in this file routes through here
+  // so one failing sink — a synchronous throw, or an `async` implementation
+  // rejecting (the `Logger` interface's `void` return type permits either;
+  // a bare try/catch only ever catches the former) — can't turn a warning
+  // into an unhandled rejection in its place.
+  safeWarn(message, context) {
+    try {
+      Promise.resolve(this.logger.warn(message, context)).catch(() => void 0);
+    } catch {
+    }
+  }
   // Races the caller-supplied resolver against a timeout and against
   // `controller`'s own abort signal — aborted externally by
   // `cancelPendingPermissions`/`cancelAllPendingPermissions` (fired from
@@ -2433,10 +2596,7 @@ ${message.content}`;
         // rejected promise, so both land in the `.catch` below rather than
         // escaping this race uncaught.
         Promise.resolve().then(() => this.resolvePermission(params, controller.signal)).catch((error) => {
-          try {
-            this.logger.warn("resolvePermission threw; treating as no answer", { error: String(error) });
-          } catch {
-          }
+          this.safeWarn("resolvePermission threw; treating as no answer", { error: String(error) });
           return void 0;
         }),
         timeout,
@@ -2476,13 +2636,14 @@ ${message.content}`;
       return;
     }
     for (const chunk of client.getCollectedChunks(input.sessionId)) {
+      if (isBlankEventContent(chunk.content)) {
+        continue;
+      }
       if (chunk.chunkType === "text") {
-        if (chunk.content.length > 0) {
-          await input.tools.sendMessage(chunk.content, [{
-            id: input.senderId,
-            handle: input.senderHandle
-          }]);
-        }
+        await input.tools.sendMessage(chunk.content, [{
+          id: input.senderId,
+          handle: input.senderHandle
+        }]);
         continue;
       }
       const messageType = chunk.chunkType === "plan" ? "task" : chunk.chunkType;
@@ -2590,14 +2751,6 @@ var ACPServerHistoryConverter = class {
   }
 };
 
-// src/runtime/types.ts
-function ensureHandlePrefix(handle) {
-  if (!handle) {
-    return null;
-  }
-  return handle.startsWith("@") ? handle : `@${handle}`;
-}
-
 // src/converters/shared.ts
 function asOptionalString(value) {
   if (typeof value !== "string") {
@@ -3436,43 +3589,6 @@ function extractPromptText(prompt) {
 // src/adapters/tool-calling/ToolCallingAdapter.ts
 init_protocols();
 
-// src/runtime/formatters.ts
-function isMetadataMap(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function replaceUuidMentions(content, participants) {
-  if (!content || participants.length === 0) {
-    return content;
-  }
-  let next = content;
-  for (const participant of participants) {
-    const participantId = participant.id;
-    const handle = participant.handle;
-    if (typeof participantId === "string" && typeof handle === "string") {
-      next = next.replaceAll(`@[[${participantId}]]`, ensureHandlePrefix(handle) ?? "");
-    }
-  }
-  return next;
-}
-function formatMessageForLlm(message, participants) {
-  const senderType = String(message.sender_type ?? "");
-  const senderName = String(message.sender_name ?? message.name ?? senderType);
-  const content = participants ? replaceUuidMentions(String(message.content ?? ""), participants) : String(message.content ?? "");
-  return {
-    role: senderType === "Agent" ? "assistant" : "user",
-    content,
-    sender_name: senderName,
-    sender_type: senderType,
-    message_type: String(message.message_type ?? "text"),
-    metadata: isMetadataMap(message.metadata) ? message.metadata : {}
-  };
-}
-function formatHistoryForLlm(messages, options) {
-  const excludeId = options?.excludeId;
-  const participants = options?.participants;
-  return messages.filter((message) => String(message.id ?? "") !== excludeId).map((message) => formatMessageForLlm(message, participants));
-}
-
 // src/runtime/tools/customTools.ts
 var import_zod3 = require("zod");
 var import_zod_to_json_schema = require("zod-to-json-schema");
@@ -5011,18 +5127,28 @@ var GoogleADKAdapter = class extends SimpleAdapter {
   }
   async reportExecutionEvent(sdk, event, tools) {
     for (const functionCall of sdk.getFunctionCalls(event)) {
-      await tools.sendEvent(JSON.stringify({
+      const result = await tools.sendEvent(JSON.stringify({
         name: functionCall.name ?? "unknown",
         args: asToolArgs(functionCall.args),
         tool_call_id: functionCall.id ?? ""
       }), "tool_call");
+      this.warnOnFailedSend(result, "Google ADK tool_call event send failed", { toolCallId: functionCall.id ?? "" });
     }
     for (const functionResponse of sdk.getFunctionResponses(event)) {
-      await tools.sendEvent(JSON.stringify({
+      const result = await tools.sendEvent(JSON.stringify({
         name: functionResponse.name ?? "unknown",
         output: String(functionResponse.response ?? ""),
         tool_call_id: functionResponse.id ?? ""
       }), "tool_result");
+      this.warnOnFailedSend(result, "Google ADK tool_result event send failed", { toolCallId: functionResponse.id ?? "" });
+    }
+  }
+  warnOnFailedSend(result, message, meta) {
+    if (result.ok === false) {
+      try {
+        this.logger.warn(message, meta);
+      } catch {
+      }
     }
   }
 };
@@ -9580,29 +9706,6 @@ function delay(ms) {
 init_errors();
 init_schemas();
 
-// src/adapters/shared/conversationPrompt.ts
-function buildConversationPrompt(options) {
-  const parts = [];
-  if (options.isSessionBootstrap && options.history.length > 0) {
-    const historyText = options.history.raw.slice(-(options.maxHistoryMessages ?? 50)).map(formatHistoryLine).join("\n");
-    parts.push(`${options.historyHeader}
-${historyText}`);
-  }
-  if (options.participantsMessage) {
-    parts.push(`[System]: ${options.participantsMessage}`);
-  }
-  if (options.contactsMessage) {
-    parts.push(`[System]: ${options.contactsMessage}`);
-  }
-  parts.push(options.currentMessage);
-  return parts.join("\n\n");
-}
-function formatHistoryLine(entry) {
-  const sender = String(entry.sender_name ?? entry.sender_type ?? "Unknown");
-  const content = String(entry.content ?? "");
-  return `[${sender}]: ${content}`;
-}
-
 // src/converters/claude-sdk.ts
 function extractClaudeSessionId(raw) {
   const metadata = findLatestTaskMetadata(
@@ -10626,11 +10729,8 @@ var CodexAdapter = class extends SimpleAdapter {
         items.push({ type: "text", text: context });
       }
     }
-    if (input.participantsMessage) {
-      items.push({ type: "text", text: `[System]: ${input.participantsMessage}` });
-    }
-    if (input.contactsMessage) {
-      items.push({ type: "text", text: `[System]: ${input.contactsMessage}` });
+    for (const part of systemUpdateParts(input.participantsMessage, input.contactsMessage)) {
+      items.push({ type: "text", text: part });
     }
     items.push({
       type: "text",
@@ -11058,13 +11158,6 @@ var TURN_STATUS_VALUES = /* @__PURE__ */ new Set([
   "failed",
   "inProgress"
 ]);
-function isStructuredToolFailure(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const payload = value;
-  return payload.ok === false && typeof payload.message === "string";
-}
 function isCodexToolOutputError(value) {
   return isToolExecutorError(value) || isStructuredToolFailure(value);
 }

package/dist/adapters.d.cts

@@ -1,12 +1,12 @@
-export { A as A2AAdapter, a as A2AAdapterOptions, K as A2AClientFactory, M as A2AClientLike, b as A2AGatewayAdapter, c as AnthropicAdapter, d as AnthropicAdapterOptions, N as AnthropicClientFactory, Q as AnthropicToolCallingModel, R as AnthropicToolCallingModelOptions, C as CODEX_REASONING_EFFORTS, e as CODEX_REASONING_SUMMARIES, f as CODEX_WEB_SEARCH_MODES, g as ClaudePermissionMode, h as ClaudeSDKAdapter, i as ClaudeSDKAdapterOptions, S as ClaudeSDKQuery, U as ClaudeSDKQueryParams, j as CodexAdapter, k as CodexAdapterConfig, W as CodexAppServerStdioClient, l as CodexApprovalPolicy, X as CodexClientLike, Y as CodexJsonRpcError, m as CodexReasoningEffort, n as CodexReasoningSummary, o as CodexSandboxMode, p as CodexWebSearchMode, Z as DynamicToolCallParams, _ as DynamicToolCallResponse, $ as DynamicToolSpec, G as GeminiAdapter, q as GeminiAdapterOptions, a0 as GeminiClientFactory, a1 as GeminiToolCallingModel, a2 as GeminiToolCallingModelOptions, r as GenericAdapter, s as GenericAdapterHandler, t as GoogleADKAdapter, u as GoogleADKAdapterOptions, a3 as HttpOpencodeClient, a4 as HttpOpencodeClientOptions, a5 as HttpStatusError, L as LangGraphAdapter, v as LangGraphAdapterOptions, w as LangGraphGraph, x as LettaAdapter, y as LettaAdapterOptions, a6 as LettaAgentCreateParams, a7 as LettaClientFactory, a8 as LettaClientLike, a9 as LettaHistoryConverter, aa as LettaMessage, ab as LettaMessageCreateParams, ac as LettaMessages, ad as LettaRequestOptions, ae as LettaResponse, af as LettaResponseMessage, O as OpenAIAdapter, z as OpenAIAdapterOptions, ag as OpenAIClientFactory, ah as OpenAIToolCallingModel, ai as OpenAIToolCallingModelOptions, B as OpencodeAdapter, D as OpencodeAdapterConfig, E as OpencodeApprovalMode, F as OpencodeApprovalReply, aj as OpencodeClientLike, H as OpencodeQuestionMode, P as ParlantAdapter, I as ParlantAdapterOptions, ak as ParlantClientFactory, al as ParlantClientLike, am as ToolCall, an as ToolCallingAdapter, ao as ToolCallingAdapterOptions, T as ToolCallingModel, ap as ToolCallingModelRequest, aq as ToolCallingResponse, ar as ToolResult, as as TurnStartParams, V as VercelAISDKAdapter, J as VercelAISDKAdapterOptions, at as VercelAISDKToolCallingModel, au as VercelAISDKToolCallingModelOptions, av as runSingleToolRound } from './ClaudeSDKAdapter-BY4zEbCl.cjs';
+export { A as A2AAdapter, a as A2AAdapterOptions, K as A2AClientFactory, M as A2AClientLike, b as A2AGatewayAdapter, c as AnthropicAdapter, d as AnthropicAdapterOptions, N as AnthropicClientFactory, Q as AnthropicToolCallingModel, R as AnthropicToolCallingModelOptions, C as CODEX_REASONING_EFFORTS, e as CODEX_REASONING_SUMMARIES, f as CODEX_WEB_SEARCH_MODES, g as ClaudePermissionMode, h as ClaudeSDKAdapter, i as ClaudeSDKAdapterOptions, S as ClaudeSDKQuery, U as ClaudeSDKQueryParams, j as CodexAdapter, k as CodexAdapterConfig, W as CodexAppServerStdioClient, l as CodexApprovalPolicy, X as CodexClientLike, Y as CodexJsonRpcError, m as CodexReasoningEffort, n as CodexReasoningSummary, o as CodexSandboxMode, p as CodexWebSearchMode, Z as DynamicToolCallParams, _ as DynamicToolCallResponse, $ as DynamicToolSpec, G as GeminiAdapter, q as GeminiAdapterOptions, a0 as GeminiClientFactory, a1 as GeminiToolCallingModel, a2 as GeminiToolCallingModelOptions, r as GenericAdapter, s as GenericAdapterHandler, t as GoogleADKAdapter, u as GoogleADKAdapterOptions, a3 as HttpOpencodeClient, a4 as HttpOpencodeClientOptions, a5 as HttpStatusError, L as LangGraphAdapter, v as LangGraphAdapterOptions, w as LangGraphGraph, x as LettaAdapter, y as LettaAdapterOptions, a6 as LettaAgentCreateParams, a7 as LettaClientFactory, a8 as LettaClientLike, a9 as LettaHistoryConverter, aa as LettaMessage, ab as LettaMessageCreateParams, ac as LettaMessages, ad as LettaRequestOptions, ae as LettaResponse, af as LettaResponseMessage, O as OpenAIAdapter, z as OpenAIAdapterOptions, ag as OpenAIClientFactory, ah as OpenAIToolCallingModel, ai as OpenAIToolCallingModelOptions, B as OpencodeAdapter, D as OpencodeAdapterConfig, E as OpencodeApprovalMode, F as OpencodeApprovalReply, aj as OpencodeClientLike, H as OpencodeQuestionMode, P as ParlantAdapter, I as ParlantAdapterOptions, ak as ParlantClientFactory, al as ParlantClientLike, am as ToolCall, an as ToolCallingAdapter, ao as ToolCallingAdapterOptions, T as ToolCallingModel, ap as ToolCallingModelRequest, aq as ToolCallingResponse, ar as ToolResult, as as TurnStartParams, V as VercelAISDKAdapter, J as VercelAISDKAdapterOptions, at as VercelAISDKToolCallingModel, au as VercelAISDKToolCallingModelOptions, av as runSingleToolRound } from './ClaudeSDKAdapter-Cx6zhSaG.cjs';
 import * as _agentclientprotocol_sdk from '@agentclientprotocol/sdk';
-import { Client, ClientSideConnection, McpServer, ClientCapabilities, RequestPermissionRequest, SessionMode, AgentSideConnection, SessionModeState, Agent, InitializeResponse, Implementation, Stream, InitializeRequest, LoadSessionRequest, LoadSessionResponse, ListSessionsRequest, ListSessionsResponse, ForkSessionRequest, ForkSessionResponse, ResumeSessionRequest, ResumeSessionResponse, SetSessionModeRequest, SetSessionModeResponse, SetSessionModelRequest, SetSessionModelResponse, SetSessionConfigOptionRequest, SetSessionConfigOptionResponse, AuthenticateRequest, AuthenticateResponse, PromptRequest, PromptResponse } from '@agentclientprotocol/sdk';
+import { Client, ClientSideConnection, McpServer, ClientCapabilities, RequestPermissionRequest, SessionModeId, SessionMode, AgentSideConnection, SessionModeState, Agent, InitializeResponse, Implementation, Stream, InitializeRequest, LoadSessionRequest, LoadSessionResponse, ListSessionsRequest, ListSessionsResponse, ForkSessionRequest, ForkSessionResponse, ResumeSessionRequest, ResumeSessionResponse, SetSessionModeRequest, SetSessionModeResponse, SetSessionModelRequest, SetSessionModelResponse, SetSessionConfigOptionRequest, SetSessionConfigOptionResponse, AuthenticateRequest, AuthenticateResponse, PromptRequest, PromptResponse } from '@agentclientprotocol/sdk';
 import { A as ACPClientSessionState, a as ACPServerSessionState } from './acp-server-Dlj7D563.cjs';
 export { G as GatewayHistoryConverter } from './acp-server-Dlj7D563.cjs';
 import { S as SimpleAdapter } from './simpleAdapter-BpT4XbZC.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
 import { A as AdapterToolsProtocol, c as MessagingTools } from './protocols-Bz1rxcUg.cjs';
-import { P as PlatformMessage } from './types-D958TC71.cjs';
+import { P as PlatformMessage } from './types-BNNtOXu3.cjs';
 import { M as McpToolRegistration } from './sdk-BTciSLRQ.cjs';
 import { R as RestApi } from './types-BgYFd_Yw.cjs';
 import { b as GatewayServerLike, c as GatewayServerOptions } from './opencode-2YdscIc1.cjs';
@@ -54,6 +54,7 @@ interface ACPClientAdapterOptions {
     connectionFactory?: ACPClientConnectionFactory;
     resolvePermission?: (request: RequestPermissionRequest, signal: AbortSignal) => Promise<string | undefined>;
     permissionTimeoutMs?: number;
+    requestedPermissionMode?: SessionModeId;
     logger?: Logger;
 }
 declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, AdapterToolsProtocol> {
@@ -74,6 +75,7 @@ declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, Adap
     private readonly pendingPermissions;
     private readonly resolvePermission?;
     private readonly permissionTimeoutMs;
+    private readonly requestedPermissionMode?;
     private readonly logger;
     private backend;
     private backendPromise;
@@ -86,7 +88,7 @@ declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, Adap
     private spawnPromise;
     constructor(options: ACPClientAdapterOptions);
     onStarted(agentName: string, agentDescription: string): Promise<void>;
-    onMessage(message: PlatformMessage, tools: AdapterToolsProtocol, history: ACPClientSessionState, _participantsMessage: string | null, _contactsMessage: string | null, context: {
+    onMessage(message: PlatformMessage, tools: AdapterToolsProtocol, history: ACPClientSessionState, participantsMessage: string | null, contactsMessage: string | null, context: {
         isSessionBootstrap: boolean;
         roomId: string;
     }): Promise<void>;
@@ -98,12 +100,14 @@ declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, Adap
     private spawnConnection;
     private getOrCreateSession;
     private tryRestoreSession;
+    private applyRequestedPermissionMode;
     private buildSessionMcpServers;
     private getOrCreateBackend;
     private createBackend;
     private buildSystemContext;
     private handlePermissionRequest;
     private toResponse;
+    private safeWarn;
     private resolveManually;
     private trackPending;
     private untrackPending;

package/dist/adapters.d.ts

@@ -1,12 +1,12 @@
-export { A as A2AAdapter, a as A2AAdapterOptions, K as A2AClientFactory, M as A2AClientLike, b as A2AGatewayAdapter, c as AnthropicAdapter, d as AnthropicAdapterOptions, N as AnthropicClientFactory, Q as AnthropicToolCallingModel, R as AnthropicToolCallingModelOptions, C as CODEX_REASONING_EFFORTS, e as CODEX_REASONING_SUMMARIES, f as CODEX_WEB_SEARCH_MODES, g as ClaudePermissionMode, h as ClaudeSDKAdapter, i as ClaudeSDKAdapterOptions, S as ClaudeSDKQuery, U as ClaudeSDKQueryParams, j as CodexAdapter, k as CodexAdapterConfig, W as CodexAppServerStdioClient, l as CodexApprovalPolicy, X as CodexClientLike, Y as CodexJsonRpcError, m as CodexReasoningEffort, n as CodexReasoningSummary, o as CodexSandboxMode, p as CodexWebSearchMode, Z as DynamicToolCallParams, _ as DynamicToolCallResponse, $ as DynamicToolSpec, G as GeminiAdapter, q as GeminiAdapterOptions, a0 as GeminiClientFactory, a1 as GeminiToolCallingModel, a2 as GeminiToolCallingModelOptions, r as GenericAdapter, s as GenericAdapterHandler, t as GoogleADKAdapter, u as GoogleADKAdapterOptions, a3 as HttpOpencodeClient, a4 as HttpOpencodeClientOptions, a5 as HttpStatusError, L as LangGraphAdapter, v as LangGraphAdapterOptions, w as LangGraphGraph, x as LettaAdapter, y as LettaAdapterOptions, a6 as LettaAgentCreateParams, a7 as LettaClientFactory, a8 as LettaClientLike, a9 as LettaHistoryConverter, aa as LettaMessage, ab as LettaMessageCreateParams, ac as LettaMessages, ad as LettaRequestOptions, ae as LettaResponse, af as LettaResponseMessage, O as OpenAIAdapter, z as OpenAIAdapterOptions, ag as OpenAIClientFactory, ah as OpenAIToolCallingModel, ai as OpenAIToolCallingModelOptions, B as OpencodeAdapter, D as OpencodeAdapterConfig, E as OpencodeApprovalMode, F as OpencodeApprovalReply, aj as OpencodeClientLike, H as OpencodeQuestionMode, P as ParlantAdapter, I as ParlantAdapterOptions, ak as ParlantClientFactory, al as ParlantClientLike, am as ToolCall, an as ToolCallingAdapter, ao as ToolCallingAdapterOptions, T as ToolCallingModel, ap as ToolCallingModelRequest, aq as ToolCallingResponse, ar as ToolResult, as as TurnStartParams, V as VercelAISDKAdapter, J as VercelAISDKAdapterOptions, at as VercelAISDKToolCallingModel, au as VercelAISDKToolCallingModelOptions, av as runSingleToolRound } from './ClaudeSDKAdapter-Cna5P1dR.js';
+export { A as A2AAdapter, a as A2AAdapterOptions, K as A2AClientFactory, M as A2AClientLike, b as A2AGatewayAdapter, c as AnthropicAdapter, d as AnthropicAdapterOptions, N as AnthropicClientFactory, Q as AnthropicToolCallingModel, R as AnthropicToolCallingModelOptions, C as CODEX_REASONING_EFFORTS, e as CODEX_REASONING_SUMMARIES, f as CODEX_WEB_SEARCH_MODES, g as ClaudePermissionMode, h as ClaudeSDKAdapter, i as ClaudeSDKAdapterOptions, S as ClaudeSDKQuery, U as ClaudeSDKQueryParams, j as CodexAdapter, k as CodexAdapterConfig, W as CodexAppServerStdioClient, l as CodexApprovalPolicy, X as CodexClientLike, Y as CodexJsonRpcError, m as CodexReasoningEffort, n as CodexReasoningSummary, o as CodexSandboxMode, p as CodexWebSearchMode, Z as DynamicToolCallParams, _ as DynamicToolCallResponse, $ as DynamicToolSpec, G as GeminiAdapter, q as GeminiAdapterOptions, a0 as GeminiClientFactory, a1 as GeminiToolCallingModel, a2 as GeminiToolCallingModelOptions, r as GenericAdapter, s as GenericAdapterHandler, t as GoogleADKAdapter, u as GoogleADKAdapterOptions, a3 as HttpOpencodeClient, a4 as HttpOpencodeClientOptions, a5 as HttpStatusError, L as LangGraphAdapter, v as LangGraphAdapterOptions, w as LangGraphGraph, x as LettaAdapter, y as LettaAdapterOptions, a6 as LettaAgentCreateParams, a7 as LettaClientFactory, a8 as LettaClientLike, a9 as LettaHistoryConverter, aa as LettaMessage, ab as LettaMessageCreateParams, ac as LettaMessages, ad as LettaRequestOptions, ae as LettaResponse, af as LettaResponseMessage, O as OpenAIAdapter, z as OpenAIAdapterOptions, ag as OpenAIClientFactory, ah as OpenAIToolCallingModel, ai as OpenAIToolCallingModelOptions, B as OpencodeAdapter, D as OpencodeAdapterConfig, E as OpencodeApprovalMode, F as OpencodeApprovalReply, aj as OpencodeClientLike, H as OpencodeQuestionMode, P as ParlantAdapter, I as ParlantAdapterOptions, ak as ParlantClientFactory, al as ParlantClientLike, am as ToolCall, an as ToolCallingAdapter, ao as ToolCallingAdapterOptions, T as ToolCallingModel, ap as ToolCallingModelRequest, aq as ToolCallingResponse, ar as ToolResult, as as TurnStartParams, V as VercelAISDKAdapter, J as VercelAISDKAdapterOptions, at as VercelAISDKToolCallingModel, au as VercelAISDKToolCallingModelOptions, av as runSingleToolRound } from './ClaudeSDKAdapter-CXud2DBE.js';
 import * as _agentclientprotocol_sdk from '@agentclientprotocol/sdk';
-import { Client, ClientSideConnection, McpServer, ClientCapabilities, RequestPermissionRequest, SessionMode, AgentSideConnection, SessionModeState, Agent, InitializeResponse, Implementation, Stream, InitializeRequest, LoadSessionRequest, LoadSessionResponse, ListSessionsRequest, ListSessionsResponse, ForkSessionRequest, ForkSessionResponse, ResumeSessionRequest, ResumeSessionResponse, SetSessionModeRequest, SetSessionModeResponse, SetSessionModelRequest, SetSessionModelResponse, SetSessionConfigOptionRequest, SetSessionConfigOptionResponse, AuthenticateRequest, AuthenticateResponse, PromptRequest, PromptResponse } from '@agentclientprotocol/sdk';
+import { Client, ClientSideConnection, McpServer, ClientCapabilities, RequestPermissionRequest, SessionModeId, SessionMode, AgentSideConnection, SessionModeState, Agent, InitializeResponse, Implementation, Stream, InitializeRequest, LoadSessionRequest, LoadSessionResponse, ListSessionsRequest, ListSessionsResponse, ForkSessionRequest, ForkSessionResponse, ResumeSessionRequest, ResumeSessionResponse, SetSessionModeRequest, SetSessionModeResponse, SetSessionModelRequest, SetSessionModelResponse, SetSessionConfigOptionRequest, SetSessionConfigOptionResponse, AuthenticateRequest, AuthenticateResponse, PromptRequest, PromptResponse } from '@agentclientprotocol/sdk';
 import { A as ACPClientSessionState, a as ACPServerSessionState } from './acp-server-CiUqN3G3.js';
 export { G as GatewayHistoryConverter } from './acp-server-CiUqN3G3.js';
 import { S as SimpleAdapter } from './simpleAdapter--wznuoOw.js';
 import { L as Logger } from './logger-CABQOnlR.js';
 import { A as AdapterToolsProtocol, c as MessagingTools } from './protocols-Bwwcql0h.js';
-import { P as PlatformMessage } from './types-BTN_ZETM.js';
+import { P as PlatformMessage } from './types-DFUtpxah.js';
 import { M as McpToolRegistration } from './sdk-qKJtMma_.js';
 import { R as RestApi } from './types-BivGO7I9.js';
 import { b as GatewayServerLike, c as GatewayServerOptions } from './opencode-Bld62x5t.js';
@@ -54,6 +54,7 @@ interface ACPClientAdapterOptions {
     connectionFactory?: ACPClientConnectionFactory;
     resolvePermission?: (request: RequestPermissionRequest, signal: AbortSignal) => Promise<string | undefined>;
     permissionTimeoutMs?: number;
+    requestedPermissionMode?: SessionModeId;
     logger?: Logger;
 }
 declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, AdapterToolsProtocol> {
@@ -74,6 +75,7 @@ declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, Adap
     private readonly pendingPermissions;
     private readonly resolvePermission?;
     private readonly permissionTimeoutMs;
+    private readonly requestedPermissionMode?;
     private readonly logger;
     private backend;
     private backendPromise;
@@ -86,7 +88,7 @@ declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, Adap
     private spawnPromise;
     constructor(options: ACPClientAdapterOptions);
     onStarted(agentName: string, agentDescription: string): Promise<void>;
-    onMessage(message: PlatformMessage, tools: AdapterToolsProtocol, history: ACPClientSessionState, _participantsMessage: string | null, _contactsMessage: string | null, context: {
+    onMessage(message: PlatformMessage, tools: AdapterToolsProtocol, history: ACPClientSessionState, participantsMessage: string | null, contactsMessage: string | null, context: {
         isSessionBootstrap: boolean;
         roomId: string;
     }): Promise<void>;
@@ -98,12 +100,14 @@ declare class ACPClientAdapter extends SimpleAdapter<ACPClientSessionState, Adap
     private spawnConnection;
     private getOrCreateSession;
     private tryRestoreSession;
+    private applyRequestedPermissionMode;
     private buildSessionMcpServers;
     private getOrCreateBackend;
     private createBackend;
     private buildSystemContext;
     private handlePermissionRequest;
     private toResponse;
+    private safeWarn;
     private resolveManually;
     private trackPending;
     private untrackPending;