@band-ai/sdk 0.3.4 → 0.4.0

package/dist/linear.d.ts

@@ -1,10 +1,11 @@
 import { LinearClient, LinearDocument } from '@linear/sdk';
-import { R as RestApi } from './types-BivGO7I9.js';
+import { R as RestApi } from './types-CjxZekMH.js';
 import { AppUserNotificationWebhookPayloadWithNotification, AgentSessionEventWebhookPayload, AppUserTeamAccessChangedWebhookPayload, OAuthAppWebhookPayload } from '@linear/sdk/webhooks';
 import { L as Logger } from './logger-CABQOnlR.js';
-import { C as CustomToolDef } from './customTools-BzF0IISO.js';
+import { C as CustomToolDef } from './customTools-Bfecd0mJ.js';
 import { IncomingMessage, ServerResponse } from 'node:http';
-import './dtos-B8KU_q4d.js';
+import './dtos-CjQsN1_h.js';
+import '@band-ai/band-sdk-core';
 import 'zod';
 
 interface CandidateRepositoryInput {

package/dist/linear.js

@@ -1,9 +1,9 @@
 import {
-  NoopLogger
-} from "./chunk-OD2G5LFQ.js";
+  resolveLogger
+} from "./chunk-ZYOXI4JL.js";
 import {
   UnsupportedFeatureError
-} from "./chunk-JY75VSQK.js";
+} from "./chunk-4OVNFDD7.js";
 
 // src/integrations/linear/bridge/handler.ts
 import { LinearDocument as L2 } from "@linear/sdk";
@@ -128,7 +128,7 @@ var StaleSessionGuard = class {
   constructor(options) {
     this.store = options.store;
     this.linearClient = options.linearClient;
-    this.logger = options.logger ?? new NoopLogger();
+    this.logger = resolveLogger(options.logger);
     this.checkIntervalMs = options.checkIntervalMs ?? STALE_SESSION_CHECK_INTERVAL_MS;
     this.staleThresholdMs = options.staleThresholdMs ?? STALE_SESSION_THRESHOLD_MS;
     this.keepAliveMessage = options.keepAliveMessage ?? DEFAULT_KEEPALIVE_MESSAGE;
@@ -439,7 +439,7 @@ function getAgentSessionEventKey(payload) {
   ].join(":");
 }
 async function handleAgentSessionEvent(input, options) {
-  const logger = input.deps.logger ?? new NoopLogger();
+  const logger = resolveLogger(input.deps.logger);
   const config = normalizeConfig(input.config);
   const action = normalizeAction(input.payload.action);
   const runtime = options?.runtime ?? createLinearBridgeRuntime();
@@ -1830,9 +1830,9 @@ function createLinearTools(options) {
     session_id: z.string().describe("The Linear agent session ID"),
     body: z.string().describe("The message body in Markdown format")
   });
-  const issueIdInputSchema = z.object({
+  const issueIdInputSchema = z.looseObject({
     issue_id: z.string().optional().describe("The Linear issue ID (UUID) from the session context")
-  }).passthrough();
+  });
   const issueCommentLimitSchema = z.number().int().min(1).max(50).optional().describe("Maximum number of recent comments to return");
   const requiredIssueIdSchema = issueIdInputSchema;
   const optionalIssueIdSchema = issueIdInputSchema;
@@ -2526,7 +2526,7 @@ import {
 var DISPATCH_RETRY_LIMIT = 2;
 var DISPATCH_RETRY_BASE_DELAY_MS = 1e3;
 function createInlineLinearBridgeDispatcher(options) {
-  const logger = options?.logger ?? new NoopLogger();
+  const logger = resolveLogger(options?.logger);
   const runtime = createLinearBridgeRuntime();
   return {
     dispatch: async (job) => {
@@ -2568,7 +2568,7 @@ function createInlineLinearBridgeDispatcher(options) {
   };
 }
 function createInProcessLinearBridgeDispatcher(options) {
-  const logger = options?.logger ?? new NoopLogger();
+  const logger = resolveLogger(options?.logger);
   const runtime = createLinearBridgeRuntime();
   const queued = /* @__PURE__ */ new Set();
   const inFlight = /* @__PURE__ */ new Set();
@@ -2650,7 +2650,7 @@ function createInProcessLinearBridgeDispatcher(options) {
   };
 }
 function createLinearWebhookHandler(options) {
-  const logger = options.deps.logger ?? new NoopLogger();
+  const logger = resolveLogger(options.deps.logger);
   const runtime = createLinearBridgeRuntime();
   const dispatcher = options.dispatcher ?? createInlineLinearBridgeDispatcher({ logger });
   const webhookClient = new LinearWebhookClient(options.config.linearWebhookSecret);

package/dist/mcp-claude.cjs

@@ -31,6 +31,7 @@ var CHAT_EVENT_TYPES = ["tool_call", "tool_result", "thought", "error", "task"];
 var CHAT_MESSAGE_TYPES = ["text", ...CHAT_EVENT_TYPES];
 
 // src/contracts/memory.ts
+var import_band_sdk_core = require("@band-ai/band-sdk-core");
 var SENSORY_MEMORY_TYPES = [
   "iconic",
   // Visual input
@@ -74,18 +75,22 @@ var MEMORY_SEGMENTS = [
   // Behavioral rules or policies
 ];
 var MEMORY_STORE_SCOPES = [
+  "agent",
+  // Private to the storing agent; omit subject_id
   "subject",
   // About one person/agent; requires subject_id
   "organization"
   // Shared org-wide
 ];
 var MEMORY_LIST_SCOPES = [
+  "agent",
+  // Caller's private agent-scoped memories only
   "subject",
   // Subject-scoped memories only
   "organization",
   // Organization-scoped memories only
   "all"
-  // Both scopes (no scope filter)
+  // All scopes (no scope filter)
 ];
 var MEMORY_STATUSES = [
   "active",
@@ -281,7 +286,7 @@ var TOOL_MODELS = {
     required: ["action"]
   },
   band_list_memories: {
-    description: "List memories accessible to the agent. Returns memories about the specified subject (cross-agent sharing) and organization-wide shared memories.",
+    description: `List memories accessible to the agent. Use scope="agent" for the caller's private memories, scope="subject" for memories about a specific person or agent, and scope="organization" for org-wide shared memories. Omit scope or use scope="all" to search across scopes.`,
     properties: {
       subject_id: {
         type: "string",
@@ -290,7 +295,7 @@ var TOOL_MODELS = {
       scope: {
         type: "string",
         enum: [...MEMORY_LIST_SCOPES],
-        description: "Filter by scope."
+        description: `Filter by scope. "agent" returns the caller's private memories; "subject" and "organization" filter to those audiences; "all" omits the filter.`
       },
       system: {
         type: "string",
@@ -326,7 +331,7 @@ var TOOL_MODELS = {
     required: []
   },
   band_store_memory: {
-    description: "Store a new memory entry. The memory will be associated with the authenticated agent as the source. For subject-scoped memories, provide a subject_id. For organization-scoped memories, omit subject_id.",
+    description: 'Store a new memory entry. The memory will be associated with the authenticated agent as the source. Use scope="agent" for information private to this agent (no subject_id). Use scope="subject" with a subject_id for memories about a specific person or agent. Use scope="organization" for knowledge genuinely shared across the organization.',
     properties: {
       content: {
         type: "string",
@@ -354,11 +359,11 @@ var TOOL_MODELS = {
       scope: {
         type: "string",
         enum: [...MEMORY_STORE_SCOPES],
-        description: "Visibility scope."
+        description: 'Visibility scope. "agent" is private to this agent; "subject" requires subject_id; "organization" is shared org-wide.'
       },
       subject_id: {
         type: "string",
-        description: "UUID of the subject this memory is about (required for subject scope)."
+        description: "UUID of the subject this memory is about (required for subject scope; omit for agent scope)."
       },
       metadata: {
         type: "object",

package/dist/mcp-claude.d.cts

@@ -1,4 +1,5 @@
 import '@anthropic-ai/claude-agent-sdk';
-import './protocols-Bz1rxcUg.cjs';
-export { B as BandSdkMcpServer, C as CreateBandSdkMcpServerOptions, G as GetSystemPromptContextOptions, g as GetSystemPromptContextResult, h as createBandSdkMcpServer } from './sdk-BTciSLRQ.cjs';
-import './dtos-B8KU_q4d.cjs';
+import './protocols-CabgO52c.cjs';
+export { B as BandSdkMcpServer, C as CreateBandSdkMcpServerOptions, G as GetSystemPromptContextOptions, g as GetSystemPromptContextResult, h as createBandSdkMcpServer } from './sdk-CXNqzoY1.cjs';
+import '@band-ai/band-sdk-core';
+import './dtos-CjQsN1_h.cjs';

package/dist/mcp-claude.d.ts

@@ -1,4 +1,5 @@
 import '@anthropic-ai/claude-agent-sdk';
-import './protocols-Bwwcql0h.js';
-export { B as BandSdkMcpServer, C as CreateBandSdkMcpServerOptions, G as GetSystemPromptContextOptions, g as GetSystemPromptContextResult, h as createBandSdkMcpServer } from './sdk-qKJtMma_.js';
-import './dtos-B8KU_q4d.js';
+import './protocols-Dpci6uae.js';
+export { B as BandSdkMcpServer, C as CreateBandSdkMcpServerOptions, G as GetSystemPromptContextOptions, g as GetSystemPromptContextResult, h as createBandSdkMcpServer } from './sdk-Cin80BTC.js';
+import '@band-ai/band-sdk-core';
+import './dtos-CjQsN1_h.js';

package/dist/mcp-claude.js

@@ -3,14 +3,13 @@ import {
   buildSingleContextRegistrations,
   buildZodShape,
   resolveSingleRoomTools
-} from "./chunk-XWHWJP4I.js";
+} from "./chunk-JDW5WSGF.js";
 import {
   MCP_SERVER_NAME,
   mcpToolNames
-} from "./chunk-MQY74R7D.js";
-import "./chunk-F63TPOI3.js";
-import "./chunk-JADCAMZY.js";
-import "./chunk-JY75VSQK.js";
+} from "./chunk-SHZBLLDQ.js";
+import "./chunk-TGDDFBYS.js";
+import "./chunk-4OVNFDD7.js";
 
 // src/mcp/sdk.ts
 import {

package/dist/mcp.cjs

@@ -52,10 +52,11 @@ var init_chatEvents = __esm({
 function namedValues(values) {
   return Object.fromEntries(values.map((value) => [value, value]));
 }
-var SENSORY_MEMORY_TYPES, COGNITIVE_MEMORY_TYPES, MEMORY_SYSTEM_TYPES, MEMORY_SYSTEMS, MEMORY_TYPES, MEMORY_SEGMENTS, MEMORY_STORE_SCOPES, MEMORY_LIST_SCOPES, MEMORY_STATUSES, MEMORY_SYSTEM, MEMORY_TYPE, MEMORY_SEGMENT, MEMORY_STORE_SCOPE;
+var import_band_sdk_core, SENSORY_MEMORY_TYPES, COGNITIVE_MEMORY_TYPES, MEMORY_SYSTEM_TYPES, MEMORY_SYSTEMS, MEMORY_TYPES, MEMORY_SEGMENTS, MEMORY_STORE_SCOPES, MEMORY_LIST_SCOPES, MEMORY_STATUSES, MEMORY_SYSTEM, MEMORY_TYPE, MEMORY_SEGMENT, MEMORY_STORE_SCOPE;
 var init_memory = __esm({
   "src/contracts/memory.ts"() {
     "use strict";
+    import_band_sdk_core = require("@band-ai/band-sdk-core");
     SENSORY_MEMORY_TYPES = [
       "iconic",
       // Visual input
@@ -96,18 +97,22 @@ var init_memory = __esm({
       // Behavioral rules or policies
     ];
     MEMORY_STORE_SCOPES = [
+      "agent",
+      // Private to the storing agent; omit subject_id
       "subject",
       // About one person/agent; requires subject_id
       "organization"
       // Shared org-wide
     ];
     MEMORY_LIST_SCOPES = [
+      "agent",
+      // Caller's private agent-scoped memories only
       "subject",
       // Subject-scoped memories only
       "organization",
       // Organization-scoped memories only
       "all"
-      // Both scopes (no scope filter)
+      // All scopes (no scope filter)
     ];
     MEMORY_STATUSES = [
       "active",
@@ -318,7 +323,7 @@ var init_schemas = __esm({
         required: ["action"]
       },
       band_list_memories: {
-        description: "List memories accessible to the agent. Returns memories about the specified subject (cross-agent sharing) and organization-wide shared memories.",
+        description: `List memories accessible to the agent. Use scope="agent" for the caller's private memories, scope="subject" for memories about a specific person or agent, and scope="organization" for org-wide shared memories. Omit scope or use scope="all" to search across scopes.`,
         properties: {
           subject_id: {
             type: "string",
@@ -327,7 +332,7 @@ var init_schemas = __esm({
           scope: {
             type: "string",
             enum: [...MEMORY_LIST_SCOPES],
-            description: "Filter by scope."
+            description: `Filter by scope. "agent" returns the caller's private memories; "subject" and "organization" filter to those audiences; "all" omits the filter.`
           },
           system: {
             type: "string",
@@ -363,7 +368,7 @@ var init_schemas = __esm({
         required: []
       },
       band_store_memory: {
-        description: "Store a new memory entry. The memory will be associated with the authenticated agent as the source. For subject-scoped memories, provide a subject_id. For organization-scoped memories, omit subject_id.",
+        description: 'Store a new memory entry. The memory will be associated with the authenticated agent as the source. Use scope="agent" for information private to this agent (no subject_id). Use scope="subject" with a subject_id for memories about a specific person or agent. Use scope="organization" for knowledge genuinely shared across the organization.',
         properties: {
           content: {
             type: "string",
@@ -391,11 +396,11 @@ var init_schemas = __esm({
           scope: {
             type: "string",
             enum: [...MEMORY_STORE_SCOPES],
-            description: "Visibility scope."
+            description: 'Visibility scope. "agent" is private to this agent; "subject" requires subject_id; "organization" is shared org-wide.'
           },
           subject_id: {
             type: "string",
-            description: "UUID of the subject this memory is about (required for subject scope)."
+            description: "UUID of the subject this memory is about (required for subject scope; omit for agent scope)."
           },
           metadata: {
             type: "object",
@@ -482,6 +487,7 @@ var TOOL_EXECUTOR_ERROR_TYPES;
 var init_protocols = __esm({
   "src/contracts/protocols.ts"() {
     "use strict";
+    init_chatEvents();
     TOOL_EXECUTOR_ERROR_TYPES = [
       "ToolArgumentsValidationError",
       "ToolNotFoundError",

package/dist/mcp.d.cts

@@ -1,10 +1,11 @@
-export { B as BandMcpBackend, a as BandMcpBackendKind, C as CreateBandMcpBackendOptions, c as createBandMcpBackend, g as getBandSdkMcpServerConfig } from './backends-ZLxmQrTZ.cjs';
-import { M as McpToolRegistration } from './sdk-BTciSLRQ.cjs';
-export { a as BuildRegistrationsOptions, b as McpToolInputSchema, c as McpToolResult, d as buildRoomScopedRegistrations, e as buildSingleContextRegistrations, f as errorResult, s as successResult } from './sdk-BTciSLRQ.cjs';
-import { A as AdapterToolsProtocol } from './protocols-Bz1rxcUg.cjs';
+export { B as BandMcpBackend, a as BandMcpBackendKind, C as CreateBandMcpBackendOptions, c as createBandMcpBackend, g as getBandSdkMcpServerConfig } from './backends-Dh2WXcHQ.cjs';
+import { M as McpToolRegistration } from './sdk-CXNqzoY1.cjs';
+export { a as BuildRegistrationsOptions, b as McpToolInputSchema, c as McpToolResult, d as buildRoomScopedRegistrations, e as buildSingleContextRegistrations, f as errorResult, s as successResult } from './sdk-CXNqzoY1.cjs';
+import { A as AdapterToolsProtocol } from './protocols-CabgO52c.cjs';
 import { Readable, Writable } from 'node:stream';
 import '@anthropic-ai/claude-agent-sdk';
-import './dtos-B8KU_q4d.cjs';
+import '@band-ai/band-sdk-core';
+import './dtos-CjQsN1_h.cjs';
 
 interface BandMcpServerOptions {
     /** Single tools instance (no room scoping) or a resolver function for room-scoped tools. */

package/dist/mcp.d.ts

@@ -1,10 +1,11 @@
-export { B as BandMcpBackend, a as BandMcpBackendKind, C as CreateBandMcpBackendOptions, c as createBandMcpBackend, g as getBandSdkMcpServerConfig } from './backends-D-dBdDm-.js';
-import { M as McpToolRegistration } from './sdk-qKJtMma_.js';
-export { a as BuildRegistrationsOptions, b as McpToolInputSchema, c as McpToolResult, d as buildRoomScopedRegistrations, e as buildSingleContextRegistrations, f as errorResult, s as successResult } from './sdk-qKJtMma_.js';
-import { A as AdapterToolsProtocol } from './protocols-Bwwcql0h.js';
+export { B as BandMcpBackend, a as BandMcpBackendKind, C as CreateBandMcpBackendOptions, c as createBandMcpBackend, g as getBandSdkMcpServerConfig } from './backends-CgsPQa9B.js';
+import { M as McpToolRegistration } from './sdk-Cin80BTC.js';
+export { a as BuildRegistrationsOptions, b as McpToolInputSchema, c as McpToolResult, d as buildRoomScopedRegistrations, e as buildSingleContextRegistrations, f as errorResult, s as successResult } from './sdk-Cin80BTC.js';
+import { A as AdapterToolsProtocol } from './protocols-Dpci6uae.js';
 import { Readable, Writable } from 'node:stream';
 import '@anthropic-ai/claude-agent-sdk';
-import './dtos-B8KU_q4d.js';
+import '@band-ai/band-sdk-core';
+import './dtos-CjQsN1_h.js';
 
 interface BandMcpServerOptions {
     /** Single tools instance (no room scoping) or a resolver function for room-scoped tools. */

package/dist/mcp.js

@@ -4,17 +4,16 @@ import {
   BandMcpStdioServer,
   createBandMcpBackend,
   getBandSdkMcpServerConfig
-} from "./chunk-WA7CHXUS.js";
+} from "./chunk-UL3Y5C4J.js";
 import {
   buildRoomScopedRegistrations,
   buildSingleContextRegistrations,
   errorResult,
   successResult
-} from "./chunk-XWHWJP4I.js";
-import "./chunk-MQY74R7D.js";
-import "./chunk-F63TPOI3.js";
-import "./chunk-JADCAMZY.js";
-import "./chunk-JY75VSQK.js";
+} from "./chunk-JDW5WSGF.js";
+import "./chunk-SHZBLLDQ.js";
+import "./chunk-TGDDFBYS.js";
+import "./chunk-4OVNFDD7.js";
 export {
   BandMcpServer,
   BandMcpSseServer,

package/dist/{pagination-DqdkQArT.d.cts → pagination-BZDhB_nO.d.cts}

@@ -1,5 +1,5 @@
-import { P as PaginatedResponse, a as PaginationMetadata } from './types-BgYFd_Yw.cjs';
-import { M as MetadataMap } from './dtos-B8KU_q4d.cjs';
+import { P as PaginatedResponse, a as PaginationMetadata } from './types-42-HWeX8.cjs';
+import { M as MetadataMap } from './dtos-CjQsN1_h.cjs';
 
 interface FetchPageRequest {
     page: number;

package/dist/{pagination-BgEx-HeL.d.ts → pagination-CPz0J_vQ.d.ts}

@@ -1,5 +1,5 @@
-import { P as PaginatedResponse, a as PaginationMetadata } from './types-BivGO7I9.js';
-import { M as MetadataMap } from './dtos-B8KU_q4d.js';
+import { P as PaginatedResponse, a as PaginationMetadata } from './types-CjxZekMH.js';
+import { M as MetadataMap } from './dtos-CjQsN1_h.js';
 
 interface FetchPageRequest {
     page: number;

package/dist/{protocols-Bz1rxcUg.d.cts → protocols-CabgO52c.d.cts}

@@ -1,4 +1,12 @@
-import { a as MentionInput, T as ToolOperationResult, M as MetadataMap, P as ParticipantRecord, b as ToolSchemaRecord, c as PaginatedList, d as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs } from './dtos-B8KU_q4d.cjs';
+import { AgentFailure } from '@band-ai/band-sdk-core';
+import { h as MentionInput, T as ToolOperationResult, M as MetadataMap, g as ParticipantRecord, j as ToolSchemaRecord, i as PaginatedList, P as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, b as ListContactRequestsArgs, c as ContactRequestsResult, d as RespondContactRequestArgs, e as ListMemoriesArgs, f as MemoryRecord, S as StoreMemoryArgs } from './dtos-CjQsN1_h.cjs';
+
+declare const CHAT_EVENT_TYPES: readonly ["tool_call", "tool_result", "thought", "error", "task"];
+type ChatEventType = (typeof CHAT_EVENT_TYPES)[number];
+declare const CHAT_MESSAGE_TYPES: readonly ["text", "tool_call", "tool_result", "thought", "error", "task"];
+type ChatMessageType = (typeof CHAT_MESSAGE_TYPES)[number];
+declare function isChatEventType(value: string): value is ChatEventType;
+declare function assertChatEventType(value: string): asserts value is ChatEventType;
 
 interface HistoryConverter<T> {
     convert(raw: MetadataMap[]): T;
@@ -21,8 +29,35 @@ interface HistoryLike {
 }
 interface MessagingTools {
     sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
+    /**
+     * Room telemetry, unlike `sendMessage`: a *failed post* resolves
+     * `{ ok: false, status: "failed" }` rather than rejecting, so reporting
+     * something about a turn can never abort the turn over a transport error.
+     * `sendFailure`, which delegates here, inherits that.
+     *
+     * It is not unconditionally non-throwing: an implementation still rejects
+     * when it cannot post at all — `ContactCallbackTools` throws for an event
+     * with no room context, and for a REST adapter without the endpoint. A
+     * caller reporting from a `catch` on such a path has to guard it, the way
+     * `safeSendFailure` (`core/providerFailure.ts`) does.
+     */
     sendEvent(content: string, messageType: string, metadata?: MetadataMap): Promise<ToolOperationResult>;
-}
+    sendFailure(failure: AgentFailure): Promise<ToolOperationResult>;
+}
+/** The chat event type every failure is posted as. */
+declare const FAILURE_EVENT_TYPE: ChatEventType;
+/**
+ * Metadata key nesting the serialized `AgentFailure`. Part of the wire
+ * contract — clients read `metadata.failure` to render a failure — so it is
+ * defined here once rather than spelled out at each posting site.
+ */
+declare const FAILURE_METADATA_KEY = "failure";
+/** The complete event every `sendFailure` implementation posts for a failure. */
+declare function toFailureEvent(failure: AgentFailure): {
+    content: string;
+    messageType: ChatEventType;
+    metadata: MetadataMap;
+};
 interface RoomParticipantTools {
     addParticipant(name: string, role?: string): Promise<ToolOperationResult>;
     removeParticipant(name: string): Promise<ToolOperationResult>;
@@ -113,4 +148,4 @@ interface Preprocessor<TEvent extends EventEnvelope = EventEnvelope> {
     process(context: PreprocessorContext, event: TEvent, agentId: string): Promise<FrameworkAdapterInput | null>;
 }
 
-export type { AdapterToolsProtocol as A, ContactTools as C, FrameworkAdapter as F, HistoryConverter as H, MemoryTools as M, ParticipantTools as P, RoomParticipantTools as R, ToolExecutor as T, AgentToolsProtocol as a, FrameworkAdapterInput as b, MessagingTools as c, PeerLookupTools as d, Preprocessor as e, ToolSchemaProvider as f, PlatformMessageLike as g, AgentToolsCapabilities as h, PreprocessorContext as i };
+export { type AdapterToolsProtocol as A, type ContactTools as C, type FrameworkAdapter as F, type HistoryConverter as H, type MemoryTools as M, type PlatformMessageLike as P, type RoomParticipantTools as R, type ToolExecutor as T, type FrameworkAdapterInput as a, type AgentToolsProtocol as b, FAILURE_EVENT_TYPE as c, FAILURE_METADATA_KEY as d, type MessagingTools as e, type ParticipantTools as f, type PeerLookupTools as g, type Preprocessor as h, type ToolSchemaProvider as i, type AgentToolsCapabilities as j, CHAT_EVENT_TYPES as k, CHAT_MESSAGE_TYPES as l, type ChatEventType as m, type ChatMessageType as n, assertChatEventType as o, isChatEventType as p, type PreprocessorContext as q, toFailureEvent as t };

package/dist/{protocols-Bwwcql0h.d.ts → protocols-Dpci6uae.d.ts}

@@ -1,4 +1,12 @@
-import { a as MentionInput, T as ToolOperationResult, M as MetadataMap, P as ParticipantRecord, b as ToolSchemaRecord, c as PaginatedList, d as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs } from './dtos-B8KU_q4d.js';
+import { AgentFailure } from '@band-ai/band-sdk-core';
+import { h as MentionInput, T as ToolOperationResult, M as MetadataMap, g as ParticipantRecord, j as ToolSchemaRecord, i as PaginatedList, P as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, b as ListContactRequestsArgs, c as ContactRequestsResult, d as RespondContactRequestArgs, e as ListMemoriesArgs, f as MemoryRecord, S as StoreMemoryArgs } from './dtos-CjQsN1_h.js';
+
+declare const CHAT_EVENT_TYPES: readonly ["tool_call", "tool_result", "thought", "error", "task"];
+type ChatEventType = (typeof CHAT_EVENT_TYPES)[number];
+declare const CHAT_MESSAGE_TYPES: readonly ["text", "tool_call", "tool_result", "thought", "error", "task"];
+type ChatMessageType = (typeof CHAT_MESSAGE_TYPES)[number];
+declare function isChatEventType(value: string): value is ChatEventType;
+declare function assertChatEventType(value: string): asserts value is ChatEventType;
 
 interface HistoryConverter<T> {
     convert(raw: MetadataMap[]): T;
@@ -21,8 +29,35 @@ interface HistoryLike {
 }
 interface MessagingTools {
     sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
+    /**
+     * Room telemetry, unlike `sendMessage`: a *failed post* resolves
+     * `{ ok: false, status: "failed" }` rather than rejecting, so reporting
+     * something about a turn can never abort the turn over a transport error.
+     * `sendFailure`, which delegates here, inherits that.
+     *
+     * It is not unconditionally non-throwing: an implementation still rejects
+     * when it cannot post at all — `ContactCallbackTools` throws for an event
+     * with no room context, and for a REST adapter without the endpoint. A
+     * caller reporting from a `catch` on such a path has to guard it, the way
+     * `safeSendFailure` (`core/providerFailure.ts`) does.
+     */
     sendEvent(content: string, messageType: string, metadata?: MetadataMap): Promise<ToolOperationResult>;
-}
+    sendFailure(failure: AgentFailure): Promise<ToolOperationResult>;
+}
+/** The chat event type every failure is posted as. */
+declare const FAILURE_EVENT_TYPE: ChatEventType;
+/**
+ * Metadata key nesting the serialized `AgentFailure`. Part of the wire
+ * contract — clients read `metadata.failure` to render a failure — so it is
+ * defined here once rather than spelled out at each posting site.
+ */
+declare const FAILURE_METADATA_KEY = "failure";
+/** The complete event every `sendFailure` implementation posts for a failure. */
+declare function toFailureEvent(failure: AgentFailure): {
+    content: string;
+    messageType: ChatEventType;
+    metadata: MetadataMap;
+};
 interface RoomParticipantTools {
     addParticipant(name: string, role?: string): Promise<ToolOperationResult>;
     removeParticipant(name: string): Promise<ToolOperationResult>;
@@ -113,4 +148,4 @@ interface Preprocessor<TEvent extends EventEnvelope = EventEnvelope> {
     process(context: PreprocessorContext, event: TEvent, agentId: string): Promise<FrameworkAdapterInput | null>;
 }
 
-export type { AdapterToolsProtocol as A, ContactTools as C, FrameworkAdapter as F, HistoryConverter as H, MemoryTools as M, ParticipantTools as P, RoomParticipantTools as R, ToolExecutor as T, AgentToolsProtocol as a, FrameworkAdapterInput as b, MessagingTools as c, PeerLookupTools as d, Preprocessor as e, ToolSchemaProvider as f, PlatformMessageLike as g, AgentToolsCapabilities as h, PreprocessorContext as i };
+export { type AdapterToolsProtocol as A, type ContactTools as C, type FrameworkAdapter as F, type HistoryConverter as H, type MemoryTools as M, type PlatformMessageLike as P, type RoomParticipantTools as R, type ToolExecutor as T, type FrameworkAdapterInput as a, type AgentToolsProtocol as b, FAILURE_EVENT_TYPE as c, FAILURE_METADATA_KEY as d, type MessagingTools as e, type ParticipantTools as f, type PeerLookupTools as g, type Preprocessor as h, type ToolSchemaProvider as i, type AgentToolsCapabilities as j, CHAT_EVENT_TYPES as k, CHAT_MESSAGE_TYPES as l, type ChatEventType as m, type ChatMessageType as n, assertChatEventType as o, isChatEventType as p, type PreprocessorContext as q, toFailureEvent as t };

package/dist/rest.cjs

@@ -226,14 +226,56 @@ var DEFAULT_REQUEST_OPTIONS = {
 };
 var MESSAGE_SEND_MAX_RETRIES = 2;
 
+// src/core/sensitiveTerms.ts
+var SENSITIVE_KEY_TERMS = "authorization|api[-_ ]?key|token|secret|password|cookie";
+var GATEWAY_FREE_TEXT_SENSITIVE_KEY_TERMS = `${SENSITIVE_KEY_TERMS}|session`;
+
 // src/core/logger.ts
 var noop = () => void 0;
+var SENSITIVE_KEY_PATTERN = new RegExp(`(${SENSITIVE_KEY_TERMS})`, "i");
 var NoopLogger = class {
   debug = noop;
   info = noop;
   warn = noop;
   error = noop;
 };
+function resolveLogger(logger) {
+  if (!logger) {
+    return new NoopLogger();
+  }
+  return logger instanceof GuardedLogger ? logger : new GuardedLogger(logger);
+}
+var GuardedLogger = class {
+  constructor(inner) {
+    this.inner = inner;
+  }
+  debug(message, context) {
+    return this.emit("debug", message, context);
+  }
+  info(message, context) {
+    return this.emit("info", message, context);
+  }
+  warn(message, context) {
+    return this.emit("warn", message, context);
+  }
+  error(message, context) {
+    return this.emit("error", message, context);
+  }
+  emit(level, message, context) {
+    try {
+      const result = this.inner[level](message, context);
+      if (result instanceof Promise) {
+        result.catch(noop);
+      }
+      return result;
+    } catch {
+    }
+  }
+};
+
+// src/contracts/chatEvents.ts
+var CHAT_EVENT_TYPES = ["tool_call", "tool_result", "thought", "error", "task"];
+var CHAT_MESSAGE_TYPES = ["text", ...CHAT_EVENT_TYPES];
 
 // src/adapters/shared/coercion.ts
 function asOptionalRecord(value) {
@@ -868,7 +910,7 @@ var RestFacade = class {
   logger;
   constructor(options) {
     this.api = options.api;
-    this.logger = options.logger ?? new NoopLogger();
+    this.logger = resolveLogger(options.logger);
   }
   async getAgentMe(options) {
     return this.forward("getAgentMe", () => this.api.getAgentMe(options));

package/dist/rest.d.cts

@@ -1,9 +1,10 @@
-import { R as RestApi, F as FernBandClientLike, b as RestRequestOptions, A as AgentIdentity, C as ChatParticipant, c as PlatformChatMessage, P as PaginatedResponse } from './types-BgYFd_Yw.cjs';
-export { d as ChatMessageMention, D as DEFAULT_REQUEST_OPTIONS, a as PaginationMetadata } from './types-BgYFd_Yw.cjs';
-import { P as PaginationOptions } from './pagination-DqdkQArT.cjs';
-export { f as fetchPaginated, n as normalizePaginationMetadata } from './pagination-DqdkQArT.cjs';
+import { R as RestApi, F as FernBandClientLike, b as RestRequestOptions, A as AgentIdentity, C as ChatParticipant, c as PlatformChatMessage, P as PaginatedResponse } from './types-42-HWeX8.cjs';
+export { d as ChatMessageMention, D as DEFAULT_REQUEST_OPTIONS, a as PaginationMetadata } from './types-42-HWeX8.cjs';
+import { P as PaginationOptions } from './pagination-BZDhB_nO.cjs';
+export { f as fetchPaginated, n as normalizePaginationMetadata } from './pagination-BZDhB_nO.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
-import { M as MetadataMap, j as MentionReference, T as ToolOperationResult, d as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs } from './dtos-B8KU_q4d.cjs';
+import { M as MetadataMap, a as MentionReference, T as ToolOperationResult, P as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, b as ListContactRequestsArgs, c as ContactRequestsResult, d as RespondContactRequestArgs, e as ListMemoriesArgs, f as MemoryRecord, S as StoreMemoryArgs } from './dtos-CjQsN1_h.cjs';
+import '@band-ai/band-sdk-core';
 
 declare class FernRestAdapter implements RestApi {
     private readonly client;

package/dist/rest.d.ts

@@ -1,9 +1,10 @@
-import { R as RestApi, F as FernBandClientLike, b as RestRequestOptions, A as AgentIdentity, C as ChatParticipant, c as PlatformChatMessage, P as PaginatedResponse } from './types-BivGO7I9.js';
-export { d as ChatMessageMention, D as DEFAULT_REQUEST_OPTIONS, a as PaginationMetadata } from './types-BivGO7I9.js';
-import { P as PaginationOptions } from './pagination-BgEx-HeL.js';
-export { f as fetchPaginated, n as normalizePaginationMetadata } from './pagination-BgEx-HeL.js';
+import { R as RestApi, F as FernBandClientLike, b as RestRequestOptions, A as AgentIdentity, C as ChatParticipant, c as PlatformChatMessage, P as PaginatedResponse } from './types-CjxZekMH.js';
+export { d as ChatMessageMention, D as DEFAULT_REQUEST_OPTIONS, a as PaginationMetadata } from './types-CjxZekMH.js';
+import { P as PaginationOptions } from './pagination-CPz0J_vQ.js';
+export { f as fetchPaginated, n as normalizePaginationMetadata } from './pagination-CPz0J_vQ.js';
 import { L as Logger } from './logger-CABQOnlR.js';
-import { M as MetadataMap, j as MentionReference, T as ToolOperationResult, d as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs } from './dtos-B8KU_q4d.js';
+import { M as MetadataMap, a as MentionReference, T as ToolOperationResult, P as PeerRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, b as ListContactRequestsArgs, c as ContactRequestsResult, d as RespondContactRequestArgs, e as ListMemoriesArgs, f as MemoryRecord, S as StoreMemoryArgs } from './dtos-CjQsN1_h.js';
+import '@band-ai/band-sdk-core';
 
 declare class FernRestAdapter implements RestApi {
     private readonly client;

package/dist/rest.js

@@ -4,11 +4,12 @@ import {
   RestFacade,
   fetchPaginated,
   normalizePaginationMetadata
-} from "./chunk-W5IAI6Z4.js";
-import "./chunk-KXJ74J73.js";
-import "./chunk-JADCAMZY.js";
-import "./chunk-OD2G5LFQ.js";
-import "./chunk-JY75VSQK.js";
+} from "./chunk-OVXVZUPO.js";
+import "./chunk-JIZE4EC6.js";
+import "./chunk-6BE2EG5P.js";
+import "./chunk-TGDDFBYS.js";
+import "./chunk-ZYOXI4JL.js";
+import "./chunk-4OVNFDD7.js";
 export {
   DEFAULT_REQUEST_OPTIONS,
   FernRestAdapter,