@band-ai/sdk 0.3.4 → 0.4.0

package/dist/{chunk-OD2G5LFQ.js → chunk-ZYOXI4JL.js}

@@ -1,14 +1,51 @@
+// 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 REDACTED_VALUE = "[REDACTED]";
 var CIRCULAR_VALUE = "[Circular]";
-var SENSITIVE_KEY_PATTERN = /(authorization|api[-_]?key|token|secret|password|cookie)/i;
+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 {
+    }
+  }
+};
 var ConsoleLogger = class {
   debug(message, context) {
     this.emit("debug", message, context);
@@ -25,7 +62,7 @@ var ConsoleLogger = class {
 `);
   }
   emit(level, message, context) {
-    const fn = console[level];
+    const fn = console[level].bind(console);
     if (context === void 0) {
       fn(message);
       return;
@@ -73,6 +110,8 @@ function sanitizeValue(value, seen = /* @__PURE__ */ new WeakSet()) {
 }
 
 export {
+  GATEWAY_FREE_TEXT_SENSITIVE_KEY_TERMS,
   NoopLogger,
+  resolveLogger,
   ConsoleLogger
 };

package/dist/config.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/config/index.ts
@@ -37,7 +27,7 @@ module.exports = __toCommonJS(config_exports);
 
 // src/config/loader.ts
 var import_node_fs = require("fs");
-var import_js_yaml = __toESM(require("js-yaml"), 1);
+var import_js_yaml = require("js-yaml");
 
 // src/core/errors.ts
 var BandSdkError = class extends Error {
@@ -131,7 +121,7 @@ function loadAgentConfig(agentKey, configPath) {
       `Config file not found: ${filePath}. Copy agent_config.yaml.example to agent_config.yaml and configure your agents.`
     );
   }
-  const parsed = import_js_yaml.default.load(raw, { schema: import_js_yaml.default.JSON_SCHEMA });
+  const parsed = (0, import_js_yaml.load)(raw, { schema: import_js_yaml.JSON_SCHEMA });
   if (!parsed || typeof parsed !== "object") {
     throw new ValidationError(`Invalid config file: ${filePath}. Expected a YAML object.`);
   }

package/dist/config.js

@@ -1,8 +1,8 @@
 import {
   loadAgentConfig,
   loadAgentConfigFromEnv
-} from "./chunk-WL2HNJZ6.js";
-import "./chunk-JY75VSQK.js";
+} from "./chunk-VOMJRQOM.js";
+import "./chunk-4OVNFDD7.js";
 export {
   loadAgentConfig,
   loadAgentConfigFromEnv

package/dist/converters.cjs

@@ -240,6 +240,17 @@ var VercelAISDKHistoryConverter = class {
 // src/adapters/a2a/A2AAdapter.ts
 var import_node_crypto = require("crypto");
 
+// 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 SENSITIVE_KEY_PATTERN = new RegExp(`(${SENSITIVE_KEY_TERMS})`, "i");
+
+// 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) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -255,6 +266,9 @@ function asNonEmptyString(value) {
   return trimmed.length > 0 ? trimmed : null;
 }
 
+// src/core/providerFailure.ts
+var import_band_sdk_core = require("@band-ai/band-sdk-core");
+
 // src/adapters/shared/history.ts
 function findLatestTaskMetadata(raw, predicate) {
   for (let index = raw.length - 1; index >= 0; index -= 1) {
@@ -491,6 +505,13 @@ var import_node_crypto3 = require("crypto");
 // src/adapters/a2a-gateway/statusEvent.ts
 var import_node_crypto2 = require("crypto");
 
+// src/adapters/a2a-gateway/failure.ts
+var import_band_sdk_core2 = require("@band-ai/band-sdk-core");
+var SENSITIVE_VALUE_PATTERN = new RegExp(
+  `(${GATEWAY_FREE_TEXT_SENSITIVE_KEY_TERMS})"?\\s*(?:[A-Za-z]+\\s*)?[:=]\\s*"?(?:[A-Za-z][\\w-]*\\s+)?[^\\s,;"]+`,
+  "gi"
+);
+
 // src/adapters/a2a-gateway/A2AGatewayAdapter.ts
 var DEFAULT_PORT = 1e4;
 var DEFAULT_GATEWAY_URL = `http://localhost:${DEFAULT_PORT}`;
@@ -576,6 +597,7 @@ var BASE_INSTRUCTIONS = [
 ].join("\n\n") + "\n";
 
 // src/contracts/memory.ts
+var import_band_sdk_core3 = require("@band-ai/band-sdk-core");
 var SENSORY_MEMORY_TYPES = [
   "iconic",
   // Visual input
@@ -619,18 +641,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",
@@ -647,10 +673,6 @@ var MEMORY_TYPE = namedValues(MEMORY_TYPES);
 var MEMORY_SEGMENT = namedValues(MEMORY_SEGMENTS);
 var MEMORY_STORE_SCOPE = namedValues(MEMORY_STORE_SCOPES);
 
-// src/contracts/chatEvents.ts
-var CHAT_EVENT_TYPES = ["tool_call", "tool_result", "thought", "error", "task"];
-var CHAT_MESSAGE_TYPES = ["text", ...CHAT_EVENT_TYPES];
-
 // src/runtime/tools/schemas.ts
 var TOOL_MODELS = {
   band_send_message: {
@@ -830,7 +852,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",
@@ -839,7 +861,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",
@@ -875,7 +897,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",
@@ -903,11 +925,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",
@@ -987,6 +1009,7 @@ function longTermPattern(label, type, segment, scope) {
   };
 }
 var COMMON_MEMORY_PATTERNS = [
+  longTermPattern("Private notes for this agent only", MEMORY_TYPE.semantic, MEMORY_SEGMENT.guideline, MEMORY_STORE_SCOPE.agent),
   longTermPattern("Facts learned about a specific agent/entity", MEMORY_TYPE.semantic, MEMORY_SEGMENT.agent, MEMORY_STORE_SCOPE.subject),
   longTermPattern("Events involving a specific person/agent", MEMORY_TYPE.episodic, MEMORY_SEGMENT.agent, MEMORY_STORE_SCOPE.subject),
   longTermPattern("A user's preferences or profile info", MEMORY_TYPE.semantic, MEMORY_SEGMENT.user, MEMORY_STORE_SCOPE.subject),
@@ -999,7 +1022,9 @@ var MEMORY_COMMON_PATTERNS = [
   "Common patterns:",
   ...COMMON_MEMORY_PATTERNS.map(renderMemoryPattern)
 ].join("\n");
-var MEMORY_SCOPE_GUIDANCE = `Prefer \`scope="${MEMORY_STORE_SCOPE.subject}"\` whenever the memory is about a specific person or agent, so it
+var MEMORY_SCOPE_GUIDANCE = `Use \`scope="${MEMORY_STORE_SCOPE.agent}"\` for information private to this agent that is not about an
+identified subject. Omitting \`scope\` and \`subject_id\` on store defaults to agent scope on the platform.
+Prefer \`scope="${MEMORY_STORE_SCOPE.subject}"\` whenever the memory is about a specific person or agent, so it
 stays attached to that subject rather than leaking org-wide. Storing with \`scope="${MEMORY_STORE_SCOPE.subject}"\` requires a
 real \`subject_id\` UUID, so resolve it first via \`band_lookup_peers\` or the participant list.
 Reserve \`scope="${MEMORY_STORE_SCOPE.organization}"\` for knowledge that is genuinely shared across the whole organization and

package/dist/converters.d.cts

@@ -1,8 +1,10 @@
-export { b as ACPClientHistoryConverter, A as ACPClientSessionState, c as ACPServerHistoryConverter, a as ACPServerSessionState, G as GatewayHistoryConverter } from './acp-server-Dlj7D563.cjs';
-import { H as HistoryConverter } from './protocols-Bz1rxcUg.cjs';
-export { A as A2AAuth, d as A2AHistoryConverter, e as A2ASessionState, G as GatewaySessionState, q as GoogleADKHistoryConverter, r as GoogleADKMessage, s as GoogleADKMessages, O as OpencodeHistoryConverter, t as OpencodeSessionState, P as ParlantHistoryConverter, m as ParlantMessage, n as ParlantMessages, p as buildA2AAuthHeaders, u as extractGoogleAdkSessionId, v as extractOpencodeSessionId } from './opencode-2YdscIc1.cjs';
-import './dtos-B8KU_q4d.cjs';
-import './types-BgYFd_Yw.cjs';
+export { A as A2AAuth, d as A2AHistoryConverter, e as A2ASessionState, q as ACPClientHistoryConverter, r as ACPClientSessionState, G as GatewaySessionState, s as GoogleADKHistoryConverter, t as GoogleADKMessage, u as GoogleADKMessages, O as OpencodeHistoryConverter, v as OpencodeSessionState, P as ParlantHistoryConverter, m as ParlantMessage, n as ParlantMessages, p as buildA2AAuthHeaders, w as extractGoogleAdkSessionId, x as extractOpencodeSessionId } from './acp-client-D-I_5lK-.cjs';
+export { a as ACPServerHistoryConverter, A as ACPServerSessionState, G as GatewayHistoryConverter } from './acp-server-CJhclo6P.cjs';
+import { H as HistoryConverter } from './protocols-CabgO52c.cjs';
+import './types-42-HWeX8.cjs';
+import './dtos-CjQsN1_h.cjs';
+import '@band-ai/band-sdk-core';
+import './logger-CABQOnlR.cjs';
 
 type VercelAISDKMessage = {
     role: "system";

package/dist/converters.d.ts

@@ -1,8 +1,10 @@
-export { b as ACPClientHistoryConverter, A as ACPClientSessionState, c as ACPServerHistoryConverter, a as ACPServerSessionState, G as GatewayHistoryConverter } from './acp-server-CiUqN3G3.js';
-import { H as HistoryConverter } from './protocols-Bwwcql0h.js';
-export { A as A2AAuth, d as A2AHistoryConverter, e as A2ASessionState, G as GatewaySessionState, q as GoogleADKHistoryConverter, r as GoogleADKMessage, s as GoogleADKMessages, O as OpencodeHistoryConverter, t as OpencodeSessionState, P as ParlantHistoryConverter, m as ParlantMessage, n as ParlantMessages, p as buildA2AAuthHeaders, u as extractGoogleAdkSessionId, v as extractOpencodeSessionId } from './opencode-Bld62x5t.js';
-import './dtos-B8KU_q4d.js';
-import './types-BivGO7I9.js';
+export { A as A2AAuth, d as A2AHistoryConverter, e as A2ASessionState, q as ACPClientHistoryConverter, r as ACPClientSessionState, G as GatewaySessionState, s as GoogleADKHistoryConverter, t as GoogleADKMessage, u as GoogleADKMessages, O as OpencodeHistoryConverter, v as OpencodeSessionState, P as ParlantHistoryConverter, m as ParlantMessage, n as ParlantMessages, p as buildA2AAuthHeaders, w as extractGoogleAdkSessionId, x as extractOpencodeSessionId } from './acp-client-DUXyczlF.js';
+export { a as ACPServerHistoryConverter, A as ACPServerSessionState, G as GatewayHistoryConverter } from './acp-server-BlcYMxKt.js';
+import { H as HistoryConverter } from './protocols-Dpci6uae.js';
+import './types-CjxZekMH.js';
+import './dtos-CjQsN1_h.js';
+import '@band-ai/band-sdk-core';
+import './logger-CABQOnlR.js';
 
 type VercelAISDKMessage = {
     role: "system";

package/dist/converters.js

@@ -1,9 +1,7 @@
-import {
-  ACPClientHistoryConverter,
-  ACPServerHistoryConverter
-} from "./chunk-V5TSWS7P.js";
 import {
   A2AHistoryConverter,
+  ACPClientHistoryConverter,
+  ACPServerHistoryConverter,
   ClaudeSDKHistoryConverter,
   GatewayHistoryConverter,
   GoogleADKHistoryConverter,
@@ -18,15 +16,15 @@ import {
   parseDate,
   parseToolCall,
   parseToolResult
-} from "./chunk-K5KAEYPF.js";
-import "./chunk-AVVDPXP4.js";
-import "./chunk-YJ42AZO4.js";
-import "./chunk-MQY74R7D.js";
-import "./chunk-F63TPOI3.js";
-import "./chunk-KXJ74J73.js";
-import "./chunk-JADCAMZY.js";
-import "./chunk-OD2G5LFQ.js";
-import "./chunk-JY75VSQK.js";
+} from "./chunk-HNWZZXAE.js";
+import "./chunk-OGOXY43L.js";
+import "./chunk-RJNJUISR.js";
+import "./chunk-SHZBLLDQ.js";
+import "./chunk-JIZE4EC6.js";
+import "./chunk-6BE2EG5P.js";
+import "./chunk-TGDDFBYS.js";
+import "./chunk-ZYOXI4JL.js";
+import "./chunk-4OVNFDD7.js";
 
 // src/converters/vercel-ai-sdk.ts
 function flushPendingToolCalls(messages, pendingToolCalls) {

package/dist/core.cjs

@@ -20,15 +20,25 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/core/index.ts
 var core_exports = {};
 __export(core_exports, {
+  AgentFailure: () => import_band_sdk_core3.AgentFailure,
   BandSdkError: () => BandSdkError,
   ConsoleLogger: () => ConsoleLogger,
+  DeliveryFailedError: () => DeliveryFailedError,
+  FAILURE_EVENT_TYPE: () => FAILURE_EVENT_TYPE,
+  FAILURE_METADATA_KEY: () => FAILURE_METADATA_KEY,
   NoopLogger: () => NoopLogger,
+  ProviderTurnFailedError: () => ProviderTurnFailedError,
+  RecoverableTurnError: () => RecoverableTurnError,
   RuntimeStateError: () => RuntimeStateError,
   SimpleAdapter: () => SimpleAdapter,
   TransportError: () => TransportError,
   UnsupportedFeatureError: () => UnsupportedFeatureError,
   ValidationError: () => ValidationError,
-  WebSocketDisconnectError: () => WebSocketDisconnectError
+  WebSocketDisconnectError: () => WebSocketDisconnectError,
+  agentFailure: () => agentFailure,
+  deliverReply: () => deliverReply,
+  reportTurnFailure: () => reportTurnFailure,
+  toFailureEvent: () => toFailureEvent
 });
 module.exports = __toCommonJS(core_exports);
 
@@ -68,6 +78,9 @@ var SimpleAdapter = class {
   }
 };
 
+// src/core/index.ts
+var import_band_sdk_core3 = require("@band-ai/band-sdk-core");
+
 // src/core/errors.ts
 var BandSdkError = class extends Error {
   constructor(message, cause) {
@@ -99,9 +112,36 @@ var RuntimeStateError = class extends BandSdkError {
     this.name = "RuntimeStateError";
   }
 };
+var RecoverableTurnError = class extends BandSdkError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "RecoverableTurnError";
+  }
+};
+
+// src/contracts/chatEvents.ts
+var CHAT_EVENT_TYPES = ["tool_call", "tool_result", "thought", "error", "task"];
+var CHAT_MESSAGE_TYPES = ["text", ...CHAT_EVENT_TYPES];
+var VISIBLE_CONTENT_PATTERN = /[\p{L}\p{N}\p{P}\p{S}]/u;
+function isBlankEventContent(content) {
+  return !VISIBLE_CONTENT_PATTERN.test(content);
+}
+
+// src/contracts/protocols.ts
+var FAILURE_EVENT_TYPE = "error";
+var FAILURE_METADATA_KEY = "failure";
+function toFailureEvent(failure) {
+  const content = isBlankEventContent(failure.message) ? `${failure.provider} failed without an error message.` : failure.message;
+  return {
+    content,
+    messageType: FAILURE_EVENT_TYPE,
+    metadata: { [FAILURE_METADATA_KEY]: failure.toObject() }
+  };
+}
 
 // src/platform/streaming/disconnectReason.ts
 var import_zod = require("zod");
+var import_band_sdk_core = require("@band-ai/band-sdk-core");
 var UPGRADE_CODES = [
   "invalid_on_conflict",
   "connection_conflict",
@@ -130,7 +170,7 @@ var upgradeErrorSchema = import_zod.z.object({
       })
     })
   ),
-  headers: import_zod.z.record(import_zod.z.unknown()).optional()
+  headers: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
 });
 var WebSocketDisconnectError = class extends Error {
   reason;
@@ -141,11 +181,15 @@ var WebSocketDisconnectError = class extends Error {
   }
 };
 
+// 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 REDACTED_VALUE = "[REDACTED]";
 var CIRCULAR_VALUE = "[Circular]";
-var SENSITIVE_KEY_PATTERN = /(authorization|api[-_]?key|token|secret|password|cookie)/i;
+var SENSITIVE_KEY_PATTERN = new RegExp(`(${SENSITIVE_KEY_TERMS})`, "i");
 var NoopLogger = class {
   debug = noop;
   info = noop;
@@ -168,7 +212,7 @@ var ConsoleLogger = class {
 `);
   }
   emit(level, message, context) {
-    const fn = console[level];
+    const fn = console[level].bind(console);
     if (context === void 0) {
       fn(message);
       return;
@@ -214,15 +258,205 @@ function sanitizeValue(value, seen = /* @__PURE__ */ new WeakSet()) {
   }
   return sanitized;
 }
+
+// src/core/coercion.ts
+var MAX_ERROR_CAUSE_DEPTH = 5;
+var MAX_ERROR_DETAIL_LENGTH = 500;
+var LENGTH_TRUNCATED_MARKER = "... (truncated)";
+var DEPTH_TRUNCATED_MARKER = "... (cause chain truncated)";
+function asOptionalRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function asNonEmptyString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function toDisplayText(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (value == null) {
+    return "";
+  }
+  try {
+    const json = JSON.stringify(value);
+    return typeof json === "string" ? json : String(value);
+  } catch {
+    return String(value);
+  }
+}
+function asErrorMessage(error) {
+  return formatCaughtError(error, 0);
+}
+function formatCaughtError(error, depth) {
+  if (typeof error !== "object" || error === null) {
+    return truncate(String(error));
+  }
+  const message = truncate(asNestedMessage(error) ?? String(error));
+  const detail = selectDetail(asOptionalRecord(error));
+  if (detail === void 0) {
+    return message;
+  }
+  if (depth >= MAX_ERROR_CAUSE_DEPTH) {
+    return `${message} (${DEPTH_TRUNCATED_MARKER})`;
+  }
+  return `${message} (${formatErrorDetail(detail, depth + 1)})`;
+}
+function selectDetail(record) {
+  if (isPresentDetail(record?.data)) {
+    return record?.data;
+  }
+  if (isPresentDetail(record?.cause)) {
+    return record?.cause;
+  }
+  return void 0;
+}
+function isPresentDetail(value) {
+  if (value === void 0 || value === null) {
+    return false;
+  }
+  if (typeof value === "string") {
+    return asNonEmptyString(value) !== null;
+  }
+  if (value instanceof Error) {
+    return true;
+  }
+  if (Array.isArray(value)) {
+    return value.length > 0;
+  }
+  if (typeof value === "object") {
+    return isPlainObject(value) ? Object.keys(value).length > 0 : true;
+  }
+  return true;
+}
+function isPlainObject(value) {
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function formatErrorDetail(detail, depth) {
+  if (detail instanceof Error || selectDetail(asOptionalRecord(detail)) !== void 0) {
+    return formatCaughtError(detail, depth);
+  }
+  return truncate(formatLeafDetail(detail));
+}
+function formatLeafDetail(detail) {
+  if (typeof detail === "string") {
+    return detail;
+  }
+  if (typeof detail === "number" && !Number.isFinite(detail)) {
+    return String(detail);
+  }
+  const builtin = formatNonEnumerableDetail(detail);
+  if (builtin !== null) {
+    return builtin;
+  }
+  const nested = asNestedMessage(detail);
+  if (nested !== null) {
+    return nested;
+  }
+  return toDisplayText(detail);
+}
+function formatNonEnumerableDetail(detail) {
+  if (detail instanceof RegExp) {
+    return detail.toString();
+  }
+  if (detail instanceof Map) {
+    return `Map ${toDisplayText([...detail])}`;
+  }
+  if (detail instanceof Set) {
+    return `Set ${toDisplayText([...detail])}`;
+  }
+  return null;
+}
+function truncate(text) {
+  return text.length > MAX_ERROR_DETAIL_LENGTH ? `${text.slice(0, MAX_ERROR_DETAIL_LENGTH)}${LENGTH_TRUNCATED_MARKER}` : text;
+}
+function asNestedMessage(value) {
+  const record = asOptionalRecord(value);
+  return asNonEmptyString(record?.message);
+}
+
+// src/core/deliveryFailedError.ts
+var DeliveryFailedError = class extends RecoverableTurnError {
+  constructor(cause) {
+    super(asErrorMessage(cause), cause);
+    this.cause = cause;
+    this.name = "DeliveryFailedError";
+  }
+};
+async function deliverReply(tools, content, mentions = []) {
+  try {
+    return await tools.sendMessage(content, mentions);
+  } catch (error) {
+    throw new DeliveryFailedError(error);
+  }
+}
+
+// src/core/providerFailure.ts
+var import_band_sdk_core2 = require("@band-ai/band-sdk-core");
+var ProviderTurnFailedError = class extends RecoverableTurnError {
+  constructor(failure) {
+    super(failure.message);
+    this.failure = failure;
+    this.name = "ProviderTurnFailedError";
+  }
+};
+async function trySendFailure(tools, failure, logger, logContext) {
+  logger?.warn("provider_failure.reported", {
+    provider: failure.provider,
+    code: failure.code,
+    ...logContext
+  });
+  try {
+    await tools.sendFailure(failure);
+  } catch (error) {
+    logger?.warn("provider_failure.report_failed", {
+      provider: failure.provider,
+      code: failure.code,
+      ...logContext,
+      error
+    });
+  }
+}
+async function reportTurnFailure(tools, failure, logger, logContext) {
+  await trySendFailure(tools, failure, logger, logContext);
+  throw new ProviderTurnFailedError(failure);
+}
+function agentFailure(provider, message, code, detail) {
+  if (detail === void 0) {
+    return new import_band_sdk_core2.AgentFailure(provider, message, code);
+  }
+  try {
+    return new import_band_sdk_core2.AgentFailure(provider, message, code, detail);
+  } catch {
+    return new import_band_sdk_core2.AgentFailure(provider, message, code);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AgentFailure,
   BandSdkError,
   ConsoleLogger,
+  DeliveryFailedError,
+  FAILURE_EVENT_TYPE,
+  FAILURE_METADATA_KEY,
   NoopLogger,
+  ProviderTurnFailedError,
+  RecoverableTurnError,
   RuntimeStateError,
   SimpleAdapter,
   TransportError,
   UnsupportedFeatureError,
   ValidationError,
-  WebSocketDisconnectError
+  WebSocketDisconnectError,
+  agentFailure,
+  deliverReply,
+  reportTurnFailure,
+  toFailureEvent
 });