@band-ai/sdk 0.3.4 → 0.4.1

package/dist/{chunk-WA7CHXUS.js → chunk-UL3Y5C4J.js}

@@ -3,11 +3,11 @@ import {
   buildSingleContextRegistrations,
   buildZodShape,
   resolveSingleRoomTools
-} from "./chunk-XWHWJP4I.js";
+} from "./chunk-JDW5WSGF.js";
 import {
   MCP_SERVER_NAME,
   mcpToolNames
-} from "./chunk-MQY74R7D.js";
+} from "./chunk-SHZBLLDQ.js";
 
 // src/mcp/stdio.ts
 var BandMcpStdioServer = class {

package/dist/{chunk-WL2HNJZ6.js → chunk-VOMJRQOM.js}

@@ -1,10 +1,10 @@
 import {
   ValidationError
-} from "./chunk-JY75VSQK.js";
+} from "./chunk-4OVNFDD7.js";
 
 // src/config/loader.ts
 import { readFileSync } from "fs";
-import yaml from "js-yaml";
+import { load as loadYaml, JSON_SCHEMA } from "js-yaml";
 var DEFAULT_CONFIG_PATH = "./agent_config.yaml";
 var DEFAULT_ENV_PREFIX = "BAND_";
 var LEGACY_ENV_PREFIX = "THENVOI_";
@@ -82,7 +82,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 = yaml.load(raw, { schema: yaml.JSON_SCHEMA });
+  const parsed = loadYaml(raw, { schema: JSON_SCHEMA });
   if (!parsed || typeof parsed !== "object") {
     throw new ValidationError(`Invalid config file: ${filePath}. Expected a YAML object.`);
   }

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) {