@band-ai/sdk 0.4.1 → 0.4.2

package/dist/index.cjs

@@ -1058,6 +1058,7 @@ __export(src_exports, {
   A2AAdapter: () => A2AAdapter,
   A2AGatewayAdapter: () => A2AGatewayAdapter,
   ACPClientAdapter: () => ACPClientAdapter,
+  AcpSessionConfigError: () => AcpSessionConfigError,
   Agent: () => Agent,
   AgentFailure: () => import_band_sdk_core13.AgentFailure,
   AgentRuntime: () => AgentRuntime,
@@ -1073,6 +1074,7 @@ __export(src_exports, {
   DEFAULT_OMP_ACP_COMMAND: () => DEFAULT_OMP_ACP_COMMAND,
   DefaultPreprocessor: () => DefaultPreprocessor,
   DeliveryFailedError: () => DeliveryFailedError,
+  FAILURE_CODE_SESSION_CONFIG: () => FAILURE_CODE_SESSION_CONFIG,
   FAILURE_EVENT_TYPE: () => FAILURE_EVENT_TYPE,
   FAILURE_METADATA_KEY: () => FAILURE_METADATA_KEY,
   GeminiAdapter: () => GeminiAdapter,
@@ -1082,6 +1084,7 @@ __export(src_exports, {
   LettaAdapter: () => LettaAdapter,
   MCP_SERVER_NAME: () => MCP_SERVER_NAME,
   MCP_TOOL_PREFIX: () => MCP_TOOL_PREFIX,
+  MISSING_CONFIG_OPTIONS_REASON: () => MISSING_CONFIG_OPTIONS_REASON,
   OmpACPAdapter: () => OmpACPAdapter,
   OpenAIAdapter: () => OpenAIAdapter,
   OpencodeAdapter: () => OpencodeAdapter,
@@ -1094,6 +1097,7 @@ __export(src_exports, {
   VercelAISDKAdapter: () => VercelAISDKAdapter,
   WebSocketDisconnectError: () => WebSocketDisconnectError,
   agentFailure: () => agentFailure,
+  applySessionConfigSelections: () => applySessionConfigSelections,
   deliverReply: () => deliverReply,
   deriveDefaultRestUrl: () => deriveDefaultRestUrl,
   isDirectExecution: () => isDirectExecution,
@@ -17103,6 +17107,151 @@ var ACPClientHistoryConverter = class {
 
 // src/adapters/acp/ACPClientAdapter.ts
 init_errors();
+
+// src/adapters/acp/sessionConfigReconciliation.ts
+var FAILURE_CODE_SESSION_CONFIG = "session_config";
+var MISSING_CONFIG_OPTIONS_REASON = "missing_config_options";
+var AcpSessionConfigTimeoutError = class extends Error {
+};
+var AcpSessionConfigError = class extends Error {
+  provider;
+  sessionId;
+  optionId;
+  selectedValue;
+  acpCode;
+  detail;
+  timedOut;
+  constructor(input) {
+    super(input.message, input.cause !== void 0 ? { cause: input.cause } : void 0);
+    this.name = "AcpSessionConfigError";
+    this.provider = input.provider;
+    this.sessionId = input.sessionId;
+    this.optionId = input.optionId;
+    this.selectedValue = input.selectedValue;
+    this.acpCode = input.acpCode;
+    this.detail = input.detail;
+    this.timedOut = input.timedOut ?? false;
+  }
+  toAgentFailure() {
+    return agentFailure(
+      this.provider,
+      this.message,
+      this.acpCode !== void 0 ? String(this.acpCode) : FAILURE_CODE_SESSION_CONFIG,
+      {
+        sessionId: this.sessionId,
+        optionId: this.optionId,
+        selectedValue: this.selectedValue,
+        detail: this.detail
+      }
+    );
+  }
+};
+async function applySessionConfigSelections(input) {
+  let catalog = input.catalog;
+  for (const { configId, value: selectedValue } of sessionConfigSelectionEntries(input.selections)) {
+    if (selectedValue === void 0) {
+      continue;
+    }
+    const option = catalog.find((entry) => entry?.id === configId);
+    if (!option || !isSessionConfigSelect(option)) {
+      throw new AcpSessionConfigError({
+        provider: input.provider,
+        sessionId: input.sessionId,
+        optionId: configId,
+        selectedValue,
+        message: `Session config option "${configId}" is not available after prior selections.`
+      });
+    }
+    if (selectedValue === option.currentValue) {
+      continue;
+    }
+    const availableValues = flattenConfigSelectOptions(option.options).map((entry) => entry.value);
+    if (!availableValues.includes(selectedValue)) {
+      throw new AcpSessionConfigError({
+        provider: input.provider,
+        sessionId: input.sessionId,
+        optionId: configId,
+        selectedValue,
+        message: `Session config value "${selectedValue}" is not advertised for option "${configId}".`,
+        detail: { availableValues }
+      });
+    }
+    const timeoutMessage = `setSessionConfigOption did not respond within ${input.timeoutMs}ms`;
+    try {
+      const response = await withTimeout(
+        input.setOption({ sessionId: input.sessionId, configId, value: selectedValue }),
+        input.timeoutMs,
+        () => new AcpSessionConfigTimeoutError(timeoutMessage)
+      );
+      if (!Array.isArray(response?.configOptions)) {
+        throw new AcpSessionConfigError({
+          provider: input.provider,
+          sessionId: input.sessionId,
+          optionId: configId,
+          selectedValue,
+          message: `Session config option "${configId}" response did not include a refreshed catalog.`,
+          detail: { reason: MISSING_CONFIG_OPTIONS_REASON }
+        });
+      }
+      catalog = response.configOptions;
+    } catch (error) {
+      if (error instanceof AcpSessionConfigError) {
+        throw error;
+      }
+      const acpError = asAcpJsonRpcError(error);
+      throw new AcpSessionConfigError({
+        provider: input.provider,
+        sessionId: input.sessionId,
+        optionId: configId,
+        selectedValue,
+        acpCode: acpError?.code,
+        detail: acpError?.data,
+        message: acpError?.message ?? asErrorMessage(error),
+        cause: error,
+        timedOut: error instanceof AcpSessionConfigTimeoutError
+      });
+    }
+  }
+  return { catalog };
+}
+function sessionConfigSelectionEntries(selections) {
+  if (isOrderedSessionConfigSelections(selections)) {
+    return selections;
+  }
+  return Object.keys(selections).map((configId) => ({ configId, value: selections[configId] }));
+}
+function isOrderedSessionConfigSelections(selections) {
+  return Array.isArray(selections);
+}
+function isSessionConfigSelect(option) {
+  return option?.type === "select";
+}
+function flattenConfigSelectOptions(options) {
+  if (!Array.isArray(options)) {
+    return [];
+  }
+  return options.flatMap((entry) => {
+    if (!asOptionalRecord2(entry)) {
+      return [];
+    }
+    if ("group" in entry) {
+      return Array.isArray(entry.options) ? entry.options : [];
+    }
+    return [entry];
+  });
+}
+function isAcpErrorResponse(error) {
+  return typeof error === "object" && error !== null && typeof error.code === "number" && typeof error.message === "string";
+}
+function asAcpJsonRpcError(error) {
+  if (isAcpErrorResponse(error)) {
+    return error;
+  }
+  const nested = asOptionalRecord2(error)?.error;
+  return isAcpErrorResponse(nested) ? nested : void 0;
+}
+
+// src/adapters/acp/ACPClientAdapter.ts
 init_chatEvents();
 init_schemas();
 
@@ -17361,6 +17510,13 @@ var acpModule = new LazyAsyncValue({
 });
 
 // src/adapters/acp/ACPClientAdapter.ts
+function createConnectionRetirement() {
+  let reject = () => void 0;
+  const promise = new Promise((_resolve, rejectPromise) => {
+    reject = rejectPromise;
+  });
+  return { promise, reject };
+}
 var DEFAULT_PERMISSION_TIMEOUT_MS = 5 * 6e4;
 var DEFAULT_TURN_TIMEOUT_MS = 60 * 6e4;
 var SET_SESSION_CONFIG_TIMEOUT_MS = 1e4;
@@ -17418,6 +17574,7 @@ var ACPClientAdapter = class extends SimpleAdapter {
   permissionTimeoutMs;
   turnTimeoutMs;
   logger;
+  customSection;
   backend = null;
   backendPromise = null;
   client = null;
@@ -17428,6 +17585,7 @@ var ACPClientAdapter = class extends SimpleAdapter {
   started = false;
   systemPrompt = "";
   spawnPromise = null;
+  connectionRetirements = /* @__PURE__ */ new WeakMap();
   // Bumped by `stop()` and on every successful spawn install. Cleanup/timeout
   // and permission maps key by this plus session id so a stale generation
   // cannot alias a same-id session on a newer connection.
@@ -17454,6 +17612,7 @@ var ACPClientAdapter = class extends SimpleAdapter {
     this.resolveSessionModel = options.resolveSessionModel;
     this.resolveSessionConfig = options.resolveSessionConfig;
     this.logger = resolveLogger(options.logger);
+    this.customSection = options.customSection;
     this.permissionTimeoutMs = options.permissionTimeoutMs ?? DEFAULT_PERMISSION_TIMEOUT_MS;
     if ((this.resolvePermission || this.resolveSessionMode || this.resolveSessionModel || this.resolveSessionConfig) && (!Number.isFinite(this.permissionTimeoutMs) || this.permissionTimeoutMs <= 0)) {
       throw new ValidationError(`permissionTimeoutMs must be a positive finite number, got ${options.permissionTimeoutMs}`);
@@ -17485,7 +17644,8 @@ var ACPClientAdapter = class extends SimpleAdapter {
     this.systemPrompt = renderSystemPrompt({
       agentName,
       agentDescription,
-      includeBaseInstructions: false
+      includeBaseInstructions: false,
+      customSection: this.customSection
     });
     await this.ensureConnection();
   }
@@ -17518,13 +17678,17 @@ var ACPClientAdapter = class extends SimpleAdapter {
 
 ${messageWithContext}`;
       this.bootstrappedSessions.add(sessionKey);
-      const response = await withTimeout(connection.prompt({
-        sessionId,
-        prompt: [{
-          type: "text",
-          text: promptText
-        }]
-      }), this.turnTimeoutMs, () => new AcpTurnTimeoutError());
+      const response = await withTimeout(
+        this.raceAgainstConnectionRetirement(connection, connection.prompt({
+          sessionId,
+          prompt: [{
+            type: "text",
+            text: promptText
+          }]
+        })),
+        this.turnTimeoutMs,
+        () => new AcpTurnTimeoutError()
+      );
       await this.flushChunks({
         client,
         tools,
@@ -17565,12 +17729,17 @@ ${messageWithContext}`;
           }
         }
       }
-      const acpError = asAcpJsonRpcError(error);
+      const configError = error instanceof AcpSessionConfigError ? error : void 0;
+      const acpError = configError ? void 0 : asAcpJsonRpcError(error);
       await reportTurnFailure(
         tools,
-        isTimeout ? agentFailure(this.provider, "ACP turn timed out.", FAILURE_CODE_TIMEOUT) : acpError ? agentFailure(this.provider, acpError.message, String(acpError.code), acpError.data) : agentFailure(this.provider, asErrorMessage(error)),
+        isTimeout ? agentFailure(this.provider, "ACP turn timed out.", FAILURE_CODE_TIMEOUT) : configError ? configError.toAgentFailure() : acpError ? agentFailure(this.provider, acpError.message, String(acpError.code), acpError.data) : agentFailure(this.provider, asErrorMessage(error)),
         this.logger,
-        { roomId: context.roomId, sessionId }
+        {
+          roomId: context.roomId,
+          sessionId: configError?.sessionId ?? sessionId,
+          ...configError ? { optionId: configError.optionId, selectedValue: configError.selectedValue } : {}
+        }
       );
     }
   }
@@ -17589,17 +17758,12 @@ ${messageWithContext}`;
   // would risk blocking this room's turn lock forever on the very process
   // that just proved it can hang.
   async abandonTimedOutTurn(connection, sessionId, generation) {
-    const key = this.sessionKey(generation, sessionId);
-    this.activeSessions.delete(key);
-    this.abandonedSessions.add(key);
-    const owner = [...this.roomToSession.entries()].find(([, value]) => value.sessionId === sessionId && value.generation === generation);
-    if (owner) {
-      this.unlinkOwner(owner[0], owner[1]);
-    }
-    abandon(
-      () => connection.cancel({ sessionId }),
-      (error) => this.safeWarn("acp_client.cancel_failed", { sessionId, error: asErrorMessage(error) })
-    );
+    this.evictAbandonedSession(sessionId, generation, connection, () => {
+      const owner = [...this.roomToSession.entries()].find(([, value]) => value.sessionId === sessionId && value.generation === generation);
+      if (owner) {
+        this.unlinkOwner(owner[0], owner[1]);
+      }
+    });
   }
   // A per-room async mutex: `fn` for a given `roomId` never overlaps another
   // call for that same room, while different rooms stay fully concurrent.
@@ -17725,6 +17889,11 @@ ${messageWithContext}`;
     void connection.closed.then(() => reject(new Error("ACP connection closed while a session operation was still in flight")));
     return Promise.race([operation, closedRejection]);
   }
+  raceAgainstConnectionRetirement(connection, operation) {
+    const retirement = this.connectionRetirements.get(connection) ?? createConnectionRetirement();
+    this.connectionRetirements.set(connection, retirement);
+    return Promise.race([operation, retirement.promise]);
+  }
   unlinkRoom(roomId) {
     const owner = this.roomToSession.get(roomId);
     if (owner) {
@@ -17869,7 +18038,7 @@ ${messageWithContext}`;
         this.activeSessions.add(restoredKey);
         this.bootstrappedSessions.add(restoredKey);
         await this.configureSessionMode(roomId, existingSessionId, restored.modes, connection);
-        await this.configureSessionConfig(roomId, existingSessionId, restored.configOptions, connection);
+        await this.configureSessionConfig(roomId, existingSessionId, restored.configOptions, connection, connectionGeneration, client);
         if (!this.resolveSessionConfig) {
           await this.configureSessionModel(roomId, existingSessionId, restored.configOptions, connection);
         }
@@ -17883,13 +18052,13 @@ ${messageWithContext}`;
     this.linkOrAbandon(roomId, created.sessionId, generation, connectionGeneration, client);
     this.activeSessions.add(this.sessionKey(connectionGeneration, created.sessionId));
     await this.configureSessionMode(roomId, created.sessionId, created.modes, connection);
-    await this.configureSessionConfig(roomId, created.sessionId, created.configOptions, connection);
+    await this.configureSessionConfig(roomId, created.sessionId, created.configOptions, connection, connectionGeneration, client);
     if (!this.resolveSessionConfig) {
       await this.configureSessionModel(roomId, created.sessionId, created.configOptions, connection);
     }
     return created.sessionId;
   }
-  async configureSessionConfig(roomId, sessionId, configOptions, connection) {
+  async configureSessionConfig(roomId, sessionId, configOptions, connection, connectionGeneration, client) {
     if (!this.resolveSessionConfig || !Array.isArray(configOptions) || configOptions.length === 0) {
       return;
     }
@@ -17902,35 +18071,76 @@ ${messageWithContext}`;
     if (!selections) {
       return;
     }
-    for (const option of advertisedOptions) {
-      const selectedValue = selections[option.id];
-      if (selectedValue === void 0 || selectedValue === option.currentValue || !isSessionConfigSelect(option)) {
-        continue;
-      }
-      const availableValues = flattenConfigSelectOptions(option.options).map((entry) => entry.value);
-      if (!availableValues.includes(selectedValue)) {
-        this.safeWarn("resolveSessionConfig selected a value this session does not advertise", {
-          sessionId,
-          configId: option.id,
-          selectedValue,
-          availableValues
-        });
-        continue;
-      }
-      try {
-        await withTimeout(
-          connection.setSessionConfigOption({ sessionId, configId: option.id, value: selectedValue }),
-          SET_SESSION_CONFIG_TIMEOUT_MS,
-          `setSessionConfigOption did not respond within ${SET_SESSION_CONFIG_TIMEOUT_MS}ms`
-        );
-      } catch (error) {
-        this.safeWarn("failed to switch session config option", {
-          sessionId,
-          configId: option.id,
-          selectedValue,
-          error: String(error)
-        });
+    try {
+      await applySessionConfigSelections({
+        provider: this.provider,
+        sessionId,
+        catalog: advertisedOptions,
+        selections,
+        setOption: (params) => connection.setSessionConfigOption(params),
+        timeoutMs: SET_SESSION_CONFIG_TIMEOUT_MS
+      });
+    } catch (error) {
+      this.abandonFailedConfigSession(
+        roomId,
+        sessionId,
+        connectionGeneration,
+        client,
+        connection,
+        error instanceof AcpSessionConfigError && error.timedOut
+      );
+      throw error;
+    }
+  }
+  // A config failure mid-establish must not leave a half-applied session
+  // active for the room: the next turn needs a fresh `newSession` catalog.
+  abandonFailedConfigSession(roomId, sessionId, connectionGeneration, client, connection, retireConnection) {
+    const key = this.sessionKey(connectionGeneration, sessionId);
+    this.bootstrappedSessions.delete(key);
+    client.resetChunks(sessionId);
+    this.evictAbandonedSession(sessionId, connectionGeneration, connection, () => {
+      const owner = this.roomToSession.get(roomId);
+      if (owner && owner.sessionId === sessionId && owner.generation === connectionGeneration) {
+        this.unlinkOwner(roomId, owner);
       }
+    });
+    if (retireConnection) {
+      this.retireConnection(connection, connectionGeneration);
+    }
+  }
+  // Common half of timeout and config-failure abandon: mark the session
+  // unusable for restore, unlink ownership, and best-effort cancel.
+  evictAbandonedSession(sessionId, connectionGeneration, connection, unlink) {
+    const key = this.sessionKey(connectionGeneration, sessionId);
+    const wasActive = this.activeSessions.delete(key);
+    if (wasActive) {
+      this.abandonedSessions.add(key);
+    }
+    unlink();
+    abandon(
+      () => connection.cancel({ sessionId }),
+      (error) => this.safeWarn("acp_client.cancel_failed", { sessionId, error: asErrorMessage(error) })
+    );
+  }
+  // A timed-out config RPC means this transport has already failed to answer
+  // one request. Retire it so the next turn cannot wait forever on another.
+  retireConnection(connection, generation) {
+    if (this.connection !== connection || this.connectionGeneration !== generation) {
+      return;
+    }
+    const handle = this.connectionHandle;
+    this.connectionGeneration++;
+    this.connection = null;
+    this.connectionHandle = null;
+    this.connectionState = null;
+    this.client = null;
+    this.pruneConnectionGeneration(generation);
+    this.connectionRetirements.get(connection)?.reject(new Error("ACP connection retired after a config timeout"));
+    if (handle) {
+      abandon(
+        () => handle.stop(),
+        (error) => this.safeWarn("acp_client.handle_stop_after_config_timeout", { error: asErrorMessage(error) })
+      );
     }
   }
   // The single gate an establishment must pass before it's allowed to claim
@@ -18544,39 +18754,12 @@ async function createTcpConnection(client, endpoint, signal) {
   };
 }
 var MODEL_CONFIG_OPTION_KEY = "model";
-function isSessionConfigSelect(option) {
-  return option?.type === "select";
-}
 function isModelConfigOption(option) {
   return isSessionConfigSelect(option) && option.category === MODEL_CONFIG_OPTION_KEY;
 }
 function isModelConfigOptionById(option) {
   return isSessionConfigSelect(option) && option.id === MODEL_CONFIG_OPTION_KEY;
 }
-function flattenConfigSelectOptions(options) {
-  if (!Array.isArray(options)) {
-    return [];
-  }
-  return options.flatMap((entry) => {
-    if (!asOptionalRecord2(entry)) {
-      return [];
-    }
-    if ("group" in entry) {
-      return Array.isArray(entry.options) ? entry.options : [];
-    }
-    return [entry];
-  });
-}
-function isAcpErrorResponse(error) {
-  return typeof error === "object" && error !== null && typeof error.code === "number" && typeof error.message === "string";
-}
-function asAcpJsonRpcError(error) {
-  if (isAcpErrorResponse(error)) {
-    return error;
-  }
-  const nested = asOptionalRecord2(error)?.error;
-  return isAcpErrorResponse(nested) ? nested : void 0;
-}
 
 // src/adapters/acp/ACPServer.ts
 var import_node_stream2 = require("stream");
@@ -18633,6 +18816,7 @@ init_schemas();
   A2AAdapter,
   A2AGatewayAdapter,
   ACPClientAdapter,
+  AcpSessionConfigError,
   Agent,
   AgentFailure,
   AgentRuntime,
@@ -18648,6 +18832,7 @@ init_schemas();
   DEFAULT_OMP_ACP_COMMAND,
   DefaultPreprocessor,
   DeliveryFailedError,
+  FAILURE_CODE_SESSION_CONFIG,
   FAILURE_EVENT_TYPE,
   FAILURE_METADATA_KEY,
   GeminiAdapter,
@@ -18657,6 +18842,7 @@ init_schemas();
   LettaAdapter,
   MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
+  MISSING_CONFIG_OPTIONS_REASON,
   OmpACPAdapter,
   OpenAIAdapter,
   OpencodeAdapter,
@@ -18669,6 +18855,7 @@ init_schemas();
   VercelAISDKAdapter,
   WebSocketDisconnectError,
   agentFailure,
+  applySessionConfigSelections,
   deliverReply,
   deriveDefaultRestUrl,
   isDirectExecution,

package/dist/index.d.cts

@@ -9,7 +9,7 @@ import { P as PlatformMessage } from './types-DtcOLALn.cjs';
 export { A as AgentConfig, a as AgentInput, C as ContactEvent, b as ContactEventCallback, c as ContactEventConfig, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, f as PlatformEvent, R as ReconnectedEvent, S as SessionConfig } from './types-DtcOLALn.cjs';
 export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-Cctmg1SN.cjs';
 export { C as CustomToolDef } from './customTools-Bfecd0mJ.cjs';
-export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as ACPClientAdapter, d as ACPClientAdapterBaseOptions, e as ACPClientAdapterOptions, f as ACPClientStdioOptions, g as ACPClientTcpOptions, h as ACPConfigRequest, i as ACPConfigSelections, j as AnthropicAdapter, k as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, l as CODEX_REASONING_SUMMARIES, m as CODEX_WEB_SEARCH_MODES, n as ClaudePermissionMode, o as ClaudeSDKAdapter, p as ClaudeSDKAdapterOptions, q as CodexAdapter, r as CodexAdapterConfig, s as CodexApprovalPolicy, t as CodexReasoningEffort, u as CodexReasoningSummary, v as CodexSandboxMode, w as CodexWebSearchMode, x as CopilotACPAdapter, y as CopilotACPAdapterOptions, z as CopilotACPStdioOptions, B as CopilotACPTcpOptions, D as DEFAULT_COPILOT_ACP_COMMAND, E as DEFAULT_OMP_ACP_COMMAND, G as GeminiAdapter, F as GeminiAdapterOptions, H as GenericAdapter, I as GenericAdapterHandler, J as GoogleADKAdapter, K as GoogleADKAdapterOptions, L as LangGraphAdapter, M as LangGraphAdapterOptions, N as LangGraphGraph, O as LettaAdapter, P as LettaAdapterOptions, Q as OmpACPAdapter, R as OmpACPAdapterOptions, S as OpenAIAdapter, T as OpenAIAdapterOptions, U as OpencodeAdapter, V as OpencodeAdapterConfig, W as OpencodeApprovalMode, X as OpencodeApprovalReply, Y as OpencodeQuestionMode, Z as ParlantAdapter, _ as ParlantAdapterOptions, $ as ToolCallingModel, a0 as VercelAISDKAdapter, a1 as VercelAISDKAdapterOptions } from './CopilotACPAdapter-Clid9xGR.cjs';
+export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as ACPClientAdapter, d as ACPClientAdapterBaseOptions, e as ACPClientAdapterOptions, f as ACPClientStdioOptions, g as ACPClientTcpOptions, h as ACPConfigRequest, i as ACPConfigSelections, j as AcpSessionConfigError, k as AnthropicAdapter, l as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, m as CODEX_REASONING_SUMMARIES, n as CODEX_WEB_SEARCH_MODES, o as ClaudePermissionMode, p as ClaudeSDKAdapter, q as ClaudeSDKAdapterOptions, r as CodexAdapter, s as CodexAdapterConfig, t as CodexApprovalPolicy, u as CodexReasoningEffort, v as CodexReasoningSummary, w as CodexSandboxMode, x as CodexWebSearchMode, y as CopilotACPAdapter, z as CopilotACPAdapterOptions, B as CopilotACPStdioOptions, D as CopilotACPTcpOptions, E as DEFAULT_COPILOT_ACP_COMMAND, F as DEFAULT_OMP_ACP_COMMAND, G as FAILURE_CODE_SESSION_CONFIG, H as GeminiAdapter, I as GeminiAdapterOptions, J as GenericAdapter, K as GenericAdapterHandler, L as GoogleADKAdapter, M as GoogleADKAdapterOptions, N as LangGraphAdapter, O as LangGraphAdapterOptions, P as LangGraphGraph, Q as LettaAdapter, R as LettaAdapterOptions, S as MISSING_CONFIG_OPTIONS_REASON, T as OmpACPAdapter, U as OmpACPAdapterOptions, V as OpenAIAdapter, W as OpenAIAdapterOptions, X as OpencodeAdapter, Y as OpencodeAdapterConfig, Z as OpencodeApprovalMode, _ as OpencodeApprovalReply, $ as OpencodeQuestionMode, a0 as ParlantAdapter, a1 as ParlantAdapterOptions, a2 as ToolCallingModel, a3 as VercelAISDKAdapter, a4 as VercelAISDKAdapterOptions, a5 as applySessionConfigSelections } from './CopilotACPAdapter-HRvat7CP.cjs';
 export { S as SimpleAdapter } from './simpleAdapter-D75rcz9n.cjs';
 export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './acp-client-D-I_5lK-.cjs';
 export { AgentFailure } from '@band-ai/band-sdk-core';

package/dist/index.d.ts

@@ -9,7 +9,7 @@ import { P as PlatformMessage } from './types-CKU1N0SK.js';
 export { A as AgentConfig, a as AgentInput, C as ContactEvent, b as ContactEventCallback, c as ContactEventConfig, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, f as PlatformEvent, R as ReconnectedEvent, S as SessionConfig } from './types-CKU1N0SK.js';
 export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-Cctmg1SN.js';
 export { C as CustomToolDef } from './customTools-Bfecd0mJ.js';
-export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as ACPClientAdapter, d as ACPClientAdapterBaseOptions, e as ACPClientAdapterOptions, f as ACPClientStdioOptions, g as ACPClientTcpOptions, h as ACPConfigRequest, i as ACPConfigSelections, j as AnthropicAdapter, k as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, l as CODEX_REASONING_SUMMARIES, m as CODEX_WEB_SEARCH_MODES, n as ClaudePermissionMode, o as ClaudeSDKAdapter, p as ClaudeSDKAdapterOptions, q as CodexAdapter, r as CodexAdapterConfig, s as CodexApprovalPolicy, t as CodexReasoningEffort, u as CodexReasoningSummary, v as CodexSandboxMode, w as CodexWebSearchMode, x as CopilotACPAdapter, y as CopilotACPAdapterOptions, z as CopilotACPStdioOptions, B as CopilotACPTcpOptions, D as DEFAULT_COPILOT_ACP_COMMAND, E as DEFAULT_OMP_ACP_COMMAND, G as GeminiAdapter, F as GeminiAdapterOptions, H as GenericAdapter, I as GenericAdapterHandler, J as GoogleADKAdapter, K as GoogleADKAdapterOptions, L as LangGraphAdapter, M as LangGraphAdapterOptions, N as LangGraphGraph, O as LettaAdapter, P as LettaAdapterOptions, Q as OmpACPAdapter, R as OmpACPAdapterOptions, S as OpenAIAdapter, T as OpenAIAdapterOptions, U as OpencodeAdapter, V as OpencodeAdapterConfig, W as OpencodeApprovalMode, X as OpencodeApprovalReply, Y as OpencodeQuestionMode, Z as ParlantAdapter, _ as ParlantAdapterOptions, $ as ToolCallingModel, a0 as VercelAISDKAdapter, a1 as VercelAISDKAdapterOptions } from './CopilotACPAdapter-B_AVyAl6.js';
+export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as ACPClientAdapter, d as ACPClientAdapterBaseOptions, e as ACPClientAdapterOptions, f as ACPClientStdioOptions, g as ACPClientTcpOptions, h as ACPConfigRequest, i as ACPConfigSelections, j as AcpSessionConfigError, k as AnthropicAdapter, l as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, m as CODEX_REASONING_SUMMARIES, n as CODEX_WEB_SEARCH_MODES, o as ClaudePermissionMode, p as ClaudeSDKAdapter, q as ClaudeSDKAdapterOptions, r as CodexAdapter, s as CodexAdapterConfig, t as CodexApprovalPolicy, u as CodexReasoningEffort, v as CodexReasoningSummary, w as CodexSandboxMode, x as CodexWebSearchMode, y as CopilotACPAdapter, z as CopilotACPAdapterOptions, B as CopilotACPStdioOptions, D as CopilotACPTcpOptions, E as DEFAULT_COPILOT_ACP_COMMAND, F as DEFAULT_OMP_ACP_COMMAND, G as FAILURE_CODE_SESSION_CONFIG, H as GeminiAdapter, I as GeminiAdapterOptions, J as GenericAdapter, K as GenericAdapterHandler, L as GoogleADKAdapter, M as GoogleADKAdapterOptions, N as LangGraphAdapter, O as LangGraphAdapterOptions, P as LangGraphGraph, Q as LettaAdapter, R as LettaAdapterOptions, S as MISSING_CONFIG_OPTIONS_REASON, T as OmpACPAdapter, U as OmpACPAdapterOptions, V as OpenAIAdapter, W as OpenAIAdapterOptions, X as OpencodeAdapter, Y as OpencodeAdapterConfig, Z as OpencodeApprovalMode, _ as OpencodeApprovalReply, $ as OpencodeQuestionMode, a0 as ParlantAdapter, a1 as ParlantAdapterOptions, a2 as ToolCallingModel, a3 as VercelAISDKAdapter, a4 as VercelAISDKAdapterOptions, a5 as applySessionConfigSelections } from './CopilotACPAdapter-Bj6NRdqd.js';
 export { S as SimpleAdapter } from './simpleAdapter-eLvsAQNo.js';
 export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './acp-client-DUXyczlF.js';
 export { AgentFailure } from '@band-ai/band-sdk-core';

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   ACPClientAdapter,
+  AcpSessionConfigError,
   AnthropicAdapter,
   CODEX_REASONING_EFFORTS,
   CODEX_REASONING_SUMMARIES,
@@ -9,16 +10,19 @@ import {
   CopilotACPAdapter,
   DEFAULT_COPILOT_ACP_COMMAND,
   DEFAULT_OMP_ACP_COMMAND,
+  FAILURE_CODE_SESSION_CONFIG,
   GeminiAdapter,
   GenericAdapter,
   GoogleADKAdapter,
   LangGraphAdapter,
   LettaAdapter,
+  MISSING_CONFIG_OPTIONS_REASON,
   OmpACPAdapter,
   OpenAIAdapter,
   OpencodeAdapter,
-  VercelAISDKAdapter
-} from "./chunk-UFO6XMCV.js";
+  VercelAISDKAdapter,
+  applySessionConfigSelections
+} from "./chunk-KXLV645N.js";
 import "./chunk-UL3Y5C4J.js";
 import "./chunk-JDW5WSGF.js";
 import {
@@ -267,6 +271,7 @@ export {
   A2AAdapter,
   A2AGatewayAdapter,
   ACPClientAdapter,
+  AcpSessionConfigError,
   Agent,
   AgentFailure,
   AgentRuntime,
@@ -282,6 +287,7 @@ export {
   DEFAULT_OMP_ACP_COMMAND,
   DefaultPreprocessor,
   DeliveryFailedError,
+  FAILURE_CODE_SESSION_CONFIG,
   FAILURE_EVENT_TYPE,
   FAILURE_METADATA_KEY,
   GeminiAdapter,
@@ -291,6 +297,7 @@ export {
   LettaAdapter,
   MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
+  MISSING_CONFIG_OPTIONS_REASON,
   OmpACPAdapter,
   OpenAIAdapter,
   OpencodeAdapter,
@@ -303,6 +310,7 @@ export {
   VercelAISDKAdapter,
   WebSocketDisconnectError,
   agentFailure,
+  applySessionConfigSelections,
   deliverReply,
   deriveDefaultRestUrl,
   isDirectExecution,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@band-ai/sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Band TypeScript SDK core runtime",
   "license": "MIT",
   "repository": {
@@ -82,7 +82,13 @@
     "lint": "eslint .",
     "clean": "rm -rf dist",
     "dev:linear": "tsx --env-file-if-exists=.env.local examples/linear-band/linear-band-bridge-server.ts",
-    "start:linear": "tsx examples/linear-band/linear-band-bridge-server.ts"
+    "start:linear": "tsx examples/linear-band/linear-band-bridge-server.ts",
+    "examples:config": "python3 scripts/generate-agent-config-for-examples.py",
+    "examples:a2a-stub": "node scripts/a2a-stub-server.mjs",
+    "examples:discover": "node scripts/examples-discover.mjs",
+    "examples:smoke": "node scripts/examples-smoke-startup.mjs --env-file ../../.env.test",
+    "examples:run-plan": "tsx --env-file ../../.env.test scripts/example-runner.ts",
+    "examples:tom-jerry": "tsx --env-file ../../.env.test scripts/tom-jerry-cross-room.ts"
   },
   "engines": {
     "node": ">=22.12"