@band-ai/sdk 0.1.2

package/dist/chunk-YR3BOQNW.js

@@ -0,0 +1,39 @@
+// src/core/errors.ts
+var ThenvoiSdkError = class extends Error {
+  constructor(message, cause) {
+    super(message, cause !== void 0 ? { cause } : void 0);
+    this.name = "ThenvoiSdkError";
+  }
+};
+var UnsupportedFeatureError = class extends ThenvoiSdkError {
+  constructor(message) {
+    super(message);
+    this.name = "UnsupportedFeatureError";
+  }
+};
+var ValidationError = class extends ThenvoiSdkError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "ValidationError";
+  }
+};
+var TransportError = class extends ThenvoiSdkError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "TransportError";
+  }
+};
+var RuntimeStateError = class extends ThenvoiSdkError {
+  constructor(message) {
+    super(message);
+    this.name = "RuntimeStateError";
+  }
+};
+
+export {
+  ThenvoiSdkError,
+  UnsupportedFeatureError,
+  ValidationError,
+  TransportError,
+  RuntimeStateError
+};

package/dist/chunk-ZZJRRBPQ.js

@@ -0,0 +1,82 @@
+import {
+  toLegacyToolExecutorErrorMessage
+} from "./chunk-3BKAC4OZ.js";
+
+// src/adapters/shared/coercion.ts
+function asOptionalRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function asRecord(value, context = "value") {
+  const record = asOptionalRecord(value);
+  if (!record) {
+    throw new TypeError(`Expected ${context} to be an object record.`);
+  }
+  return record;
+}
+function asNonEmptyString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function asString(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function asNullableString(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (value === null) {
+    return null;
+  }
+  return asString(value);
+}
+function toDisplayText(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (value == null) {
+    return "";
+  }
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function toWireString(value) {
+  const legacyErrorMessage = toLegacyToolExecutorErrorMessage(value);
+  if (legacyErrorMessage !== null) {
+    return legacyErrorMessage;
+  }
+  if (value === void 0 || value === null) {
+    return "";
+  }
+  try {
+    const json = JSON.stringify(value);
+    return typeof json === "string" ? json : String(value);
+  } catch {
+    return String(value);
+  }
+}
+function asErrorMessage(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
+
+export {
+  asOptionalRecord,
+  asRecord,
+  asNonEmptyString,
+  asString,
+  asNullableString,
+  toDisplayText,
+  toWireString,
+  asErrorMessage
+};

package/dist/claude-CcnQ5OUC.d.ts

@@ -0,0 +1,53 @@
+import { McpSdkServerConfigWithInstance, SdkMcpToolDefinition } from '@anthropic-ai/claude-agent-sdk';
+import { A as AdapterToolsProtocol } from './protocols-DrhzOH6K.js';
+
+interface McpToolRegistration {
+    name: string;
+    description: string;
+    inputSchema: McpToolInputSchema;
+    execute: (args: Record<string, unknown>) => Promise<McpToolResult>;
+}
+interface McpToolInputSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required: string[];
+}
+interface McpToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: true;
+}
+interface BuildRegistrationsOptions {
+    enableMemoryTools?: boolean;
+    enableContactTools?: boolean;
+    additionalTools?: McpToolRegistration[];
+}
+type ToolResolver = (roomId: string) => AdapterToolsProtocol | undefined;
+/**
+ * Build MCP tool registrations with room-scoped tool resolution.
+ * Each tool call requires a `room_id` argument to look up the correct tools instance.
+ */
+declare function buildRoomScopedRegistrations(resolver: ToolResolver, options?: BuildRegistrationsOptions): McpToolRegistration[];
+/**
+ * Build MCP tool registrations for a single tools instance (no room_id needed).
+ */
+declare function buildSingleContextRegistrations(tools: AdapterToolsProtocol, options?: BuildRegistrationsOptions): McpToolRegistration[];
+declare function successResult(value: unknown): McpToolResult;
+declare function errorResult(message: string): McpToolResult;
+
+interface CreateThenvoiSdkMcpServerOptions {
+    enableMemoryTools: boolean;
+    getToolsForRoom: (roomId: string) => AdapterToolsProtocol | undefined;
+    additionalTools?: McpToolRegistration[];
+}
+interface ThenvoiSdkMcpServer {
+    serverConfig: McpSdkServerConfigWithInstance;
+    allowedTools: string[];
+    toolDefinitions: Array<SdkMcpToolDefinition<any>>;
+}
+declare function createThenvoiSdkMcpServer(options: CreateThenvoiSdkMcpServerOptions): ThenvoiSdkMcpServer;
+
+export { type BuildRegistrationsOptions as B, type CreateThenvoiSdkMcpServerOptions as C, type McpToolRegistration as M, type ThenvoiSdkMcpServer as T, type McpToolInputSchema as a, type McpToolResult as b, buildRoomScopedRegistrations as c, buildSingleContextRegistrations as d, errorResult as e, createThenvoiSdkMcpServer as f, successResult as s };

package/dist/claude-CwTAxhwI.d.cts

@@ -0,0 +1,53 @@
+import { McpSdkServerConfigWithInstance, SdkMcpToolDefinition } from '@anthropic-ai/claude-agent-sdk';
+import { A as AdapterToolsProtocol } from './protocols-CInhtFpA.cjs';
+
+interface McpToolRegistration {
+    name: string;
+    description: string;
+    inputSchema: McpToolInputSchema;
+    execute: (args: Record<string, unknown>) => Promise<McpToolResult>;
+}
+interface McpToolInputSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required: string[];
+}
+interface McpToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: true;
+}
+interface BuildRegistrationsOptions {
+    enableMemoryTools?: boolean;
+    enableContactTools?: boolean;
+    additionalTools?: McpToolRegistration[];
+}
+type ToolResolver = (roomId: string) => AdapterToolsProtocol | undefined;
+/**
+ * Build MCP tool registrations with room-scoped tool resolution.
+ * Each tool call requires a `room_id` argument to look up the correct tools instance.
+ */
+declare function buildRoomScopedRegistrations(resolver: ToolResolver, options?: BuildRegistrationsOptions): McpToolRegistration[];
+/**
+ * Build MCP tool registrations for a single tools instance (no room_id needed).
+ */
+declare function buildSingleContextRegistrations(tools: AdapterToolsProtocol, options?: BuildRegistrationsOptions): McpToolRegistration[];
+declare function successResult(value: unknown): McpToolResult;
+declare function errorResult(message: string): McpToolResult;
+
+interface CreateThenvoiSdkMcpServerOptions {
+    enableMemoryTools: boolean;
+    getToolsForRoom: (roomId: string) => AdapterToolsProtocol | undefined;
+    additionalTools?: McpToolRegistration[];
+}
+interface ThenvoiSdkMcpServer {
+    serverConfig: McpSdkServerConfigWithInstance;
+    allowedTools: string[];
+    toolDefinitions: Array<SdkMcpToolDefinition<any>>;
+}
+declare function createThenvoiSdkMcpServer(options: CreateThenvoiSdkMcpServerOptions): ThenvoiSdkMcpServer;
+
+export { type BuildRegistrationsOptions as B, type CreateThenvoiSdkMcpServerOptions as C, type McpToolRegistration as M, type ThenvoiSdkMcpServer as T, type McpToolInputSchema as a, type McpToolResult as b, buildRoomScopedRegistrations as c, buildSingleContextRegistrations as d, errorResult as e, createThenvoiSdkMcpServer as f, successResult as s };

package/dist/config.cjs

@@ -0,0 +1,164 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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
+var config_exports = {};
+__export(config_exports, {
+  loadAgentConfig: () => loadAgentConfig,
+  loadAgentConfigFromEnv: () => loadAgentConfigFromEnv
+});
+module.exports = __toCommonJS(config_exports);
+
+// src/config/loader.ts
+var import_node_fs = require("fs");
+var import_js_yaml = __toESM(require("js-yaml"), 1);
+
+// src/core/errors.ts
+var ThenvoiSdkError = class extends Error {
+  constructor(message, cause) {
+    super(message, cause !== void 0 ? { cause } : void 0);
+    this.name = "ThenvoiSdkError";
+  }
+};
+var ValidationError = class extends ThenvoiSdkError {
+  constructor(message, cause) {
+    super(message, cause);
+    this.name = "ValidationError";
+  }
+};
+
+// src/config/loader.ts
+var DEFAULT_CONFIG_PATH = "./agent_config.yaml";
+var DEFAULT_ENV_PREFIX = "THENVOI_";
+var REQUIRED_FIELDS = ["agent_id", "api_key"];
+var UNSAFE_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype", "toString", "valueOf"]);
+function toSnakeCase(key) {
+  return key.replace(/([A-Z])/g, "_$1").toLowerCase();
+}
+function normalizeKeys(obj) {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    result[toSnakeCase(key)] = value;
+  }
+  return result;
+}
+function toAgentConfigResult(section, sourceLabel) {
+  const missing = REQUIRED_FIELDS.filter((field) => !section[field]);
+  if (missing.length > 0) {
+    throw new ValidationError(
+      `Missing required fields in ${sourceLabel}: ${missing.join(", ")}`
+    );
+  }
+  const invalid = REQUIRED_FIELDS.filter(
+    (field) => {
+      const value = section[field];
+      return typeof value !== "string" || value.trim() === "";
+    }
+  );
+  if (invalid.length > 0) {
+    throw new ValidationError(
+      `Invalid fields in ${sourceLabel}: ${invalid.join(", ")} must be non-empty strings`
+    );
+  }
+  const { agent_id, api_key, ws_url, rest_url, ...rest } = section;
+  if (ws_url !== void 0 && typeof ws_url !== "string") {
+    throw new ValidationError(`ws_url in ${sourceLabel} must be a string`);
+  }
+  if (rest_url !== void 0 && typeof rest_url !== "string") {
+    throw new ValidationError(`rest_url in ${sourceLabel} must be a string`);
+  }
+  const safeRest = {};
+  for (const [key, value] of Object.entries(rest)) {
+    if (!UNSAFE_KEYS.has(key)) {
+      safeRest[key] = value;
+    }
+  }
+  return {
+    agentId: agent_id.trim(),
+    apiKey: api_key.trim(),
+    ...typeof ws_url === "string" && ws_url.trim() !== "" ? { wsUrl: ws_url.trim() } : {},
+    ...typeof rest_url === "string" && rest_url.trim() !== "" ? { restUrl: rest_url.trim() } : {},
+    ...safeRest
+  };
+}
+function loadAgentConfig(agentKey, configPath) {
+  const filePath = configPath ?? DEFAULT_CONFIG_PATH;
+  let raw;
+  try {
+    raw = (0, import_node_fs.readFileSync)(filePath, "utf-8");
+  } catch {
+    throw new ValidationError(
+      `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 });
+  if (!parsed || typeof parsed !== "object") {
+    throw new ValidationError(`Invalid config file: ${filePath}. Expected a YAML object.`);
+  }
+  const config = parsed;
+  let section;
+  if (agentKey && agentKey in config) {
+    const keyed = config[agentKey];
+    if (!keyed || typeof keyed !== "object") {
+      throw new ValidationError(
+        `Config key "${agentKey}" in ${filePath} must be an object with agent_id and api_key.`
+      );
+    }
+    section = normalizeKeys(keyed);
+  } else {
+    section = normalizeKeys(config);
+  }
+  const sourceLabel = agentKey && agentKey in config ? `${filePath} under key "${agentKey}"` : filePath;
+  return toAgentConfigResult(section, sourceLabel);
+}
+function loadAgentConfigFromEnv(options) {
+  const env = options?.env ?? process.env;
+  const prefix = options?.prefix === void 0 ? DEFAULT_ENV_PREFIX : options.prefix === "" || options.prefix.endsWith("_") ? options.prefix : `${options.prefix}_`;
+  const section = normalizeKeys({
+    agent_id: env[`${prefix}AGENT_ID`],
+    api_key: env[`${prefix}API_KEY`],
+    ws_url: env[`${prefix}WS_URL`],
+    rest_url: env[`${prefix}REST_URL`]
+  });
+  try {
+    return toAgentConfigResult(section, `environment variables (${prefix}AGENT_ID, ${prefix}API_KEY)`);
+  } catch (error) {
+    if (error instanceof ValidationError) {
+      throw new ValidationError(
+        `${error.message}. Set ${prefix}AGENT_ID and ${prefix}API_KEY, or use loadAgentConfig() for agent_config.yaml.`
+      );
+    }
+    throw error;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadAgentConfig,
+  loadAgentConfigFromEnv
+});

package/dist/config.d.cts

@@ -0,0 +1,19 @@
+interface AgentCredentials {
+    agentId: string;
+    apiKey: string;
+    wsUrl?: string;
+    restUrl?: string;
+}
+interface AgentConfigResult extends AgentCredentials {
+    [key: string]: unknown;
+}
+interface LoadAgentConfigFromEnvOptions {
+    env?: Record<string, string | undefined>;
+    prefix?: string;
+}
+/** Load agent credentials from a YAML config file (defaults to `./agent_config.yaml`). */
+declare function loadAgentConfig(agentKey?: string, configPath?: string): AgentConfigResult;
+/** Load agent credentials from environment variables (prefix defaults to `THENVOI_`). */
+declare function loadAgentConfigFromEnv(options?: LoadAgentConfigFromEnvOptions): AgentCredentials;
+
+export { type AgentConfigResult, type AgentCredentials, type LoadAgentConfigFromEnvOptions, loadAgentConfig, loadAgentConfigFromEnv };

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+interface AgentCredentials {
+    agentId: string;
+    apiKey: string;
+    wsUrl?: string;
+    restUrl?: string;
+}
+interface AgentConfigResult extends AgentCredentials {
+    [key: string]: unknown;
+}
+interface LoadAgentConfigFromEnvOptions {
+    env?: Record<string, string | undefined>;
+    prefix?: string;
+}
+/** Load agent credentials from a YAML config file (defaults to `./agent_config.yaml`). */
+declare function loadAgentConfig(agentKey?: string, configPath?: string): AgentConfigResult;
+/** Load agent credentials from environment variables (prefix defaults to `THENVOI_`). */
+declare function loadAgentConfigFromEnv(options?: LoadAgentConfigFromEnvOptions): AgentCredentials;
+
+export { type AgentConfigResult, type AgentCredentials, type LoadAgentConfigFromEnvOptions, loadAgentConfig, loadAgentConfigFromEnv };

package/dist/config.js

@@ -0,0 +1,9 @@
+import {
+  loadAgentConfig,
+  loadAgentConfigFromEnv
+} from "./chunk-IZPV6QS6.js";
+import "./chunk-YR3BOQNW.js";
+export {
+  loadAgentConfig,
+  loadAgentConfigFromEnv
+};