@band-ai/sdk 0.1.2

package/dist/logger-CABQOnlR.d.cts

@@ -0,0 +1,21 @@
+interface Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+declare class NoopLogger implements Logger {
+    debug: () => void;
+    info: () => void;
+    warn: () => void;
+    error: () => void;
+}
+declare class ConsoleLogger implements Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    private emit;
+}
+
+export { ConsoleLogger as C, type Logger as L, NoopLogger as N };

package/dist/logger-CABQOnlR.d.ts

@@ -0,0 +1,21 @@
+interface Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+declare class NoopLogger implements Logger {
+    debug: () => void;
+    info: () => void;
+    warn: () => void;
+    error: () => void;
+}
+declare class ConsoleLogger implements Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    private emit;
+}
+
+export { ConsoleLogger as C, type Logger as L, NoopLogger as N };

package/dist/mcp-claude.cjs

@@ -0,0 +1,584 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/mcp/claude.ts
+var claude_exports = {};
+__export(claude_exports, {
+  createThenvoiSdkMcpServer: () => createThenvoiSdkMcpServer
+});
+module.exports = __toCommonJS(claude_exports);
+
+// src/mcp/sdk.ts
+var import_claude_agent_sdk = require("@anthropic-ai/claude-agent-sdk");
+var import_zod = require("zod");
+
+// 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 = {
+  thenvoi_send_message: {
+    description: "Send a message to the chat room. Use this to respond to users or other agents. Messages require at least one @mention in the mentions array. You MUST use this tool to communicate \u2014 plain text responses won't reach users. When delegating, send the full task context in this message instead of assuming hidden state.",
+    properties: {
+      content: {
+        type: "string",
+        description: "The message content to send."
+      },
+      mentions: {
+        type: "array",
+        items: { type: "string" },
+        minItems: 1,
+        description: "List of participant handles to @mention. At least one required. For users: @<username> (e.g., '@john'). For agents: @<username>/<agent-name> (e.g., '@john/weather-agent'). Use the handle of someone already in the room."
+      }
+    },
+    required: ["content", "mentions"]
+  },
+  thenvoi_send_event: {
+    description: "Send an event to the chat room. No mentions required. 'thought': Share your reasoning or plan BEFORE taking actions. Explain what you're about to do and why. 'error': Report an error or problem that occurred. 'task': Report task progress or completion status. Always send a thought before complex actions to keep users informed.",
+    properties: {
+      content: {
+        type: "string",
+        description: "Human-readable event content."
+      },
+      message_type: {
+        type: "string",
+        enum: [...CHAT_EVENT_TYPES],
+        description: "Type of event."
+      },
+      metadata: {
+        type: "object",
+        description: "Optional structured data for the event."
+      }
+    },
+    required: ["content", "message_type"]
+  },
+  thenvoi_add_participant: {
+    description: "Add a participant (agent or user) to the chat room by name. IMPORTANT: Use thenvoi_lookup_peers() first to find available agents. Pass the exact peer name from thenvoi_lookup_peers, not the handle. For normal delegation, omit role or use 'member'.",
+    properties: {
+      name: {
+        type: "string",
+        description: "Name of participant to add (must match a name from thenvoi_lookup_peers)."
+      },
+      role: {
+        type: "string",
+        enum: ["owner", "admin", "member"],
+        description: "Role for the participant in this room."
+      }
+    },
+    required: ["name"]
+  },
+  thenvoi_remove_participant: {
+    description: "Remove a participant from the chat room by name.",
+    properties: {
+      name: {
+        type: "string",
+        description: "Name of the participant to remove."
+      }
+    },
+    required: ["name"]
+  },
+  thenvoi_get_participants: {
+    description: "Get a list of all participants in the current chat room.",
+    properties: {},
+    required: []
+  },
+  thenvoi_lookup_peers: {
+    description: "List available peers (agents and users) that can be added to this room. Automatically excludes peers already in the room. Returns dict with 'peers' list and 'metadata' (page, page_size, total_count, total_pages). Use this to find specialized agents (e.g., Weather Agent) when you cannot answer a question directly.",
+    properties: {
+      page: {
+        type: "integer",
+        description: "Page number."
+      },
+      page_size: {
+        type: "integer",
+        description: "Items per page (max 100).",
+        maximum: 100
+      }
+    },
+    required: []
+  },
+  thenvoi_create_chatroom: {
+    description: "Create a new chat room for a specific task or conversation.",
+    properties: {
+      task_id: {
+        type: "string",
+        description: "Associated task ID (optional)."
+      }
+    },
+    required: []
+  },
+  thenvoi_list_contacts: {
+    description: "List agent's contacts with pagination.",
+    properties: {
+      page: {
+        type: "integer",
+        description: "Page number.",
+        minimum: 1
+      },
+      page_size: {
+        type: "integer",
+        description: "Items per page.",
+        minimum: 1,
+        maximum: 100
+      }
+    },
+    required: []
+  },
+  thenvoi_add_contact: {
+    description: "Send a contact request to add someone as a contact. Returns 'pending' when request is created. Returns 'approved' when inverse request existed and was auto-accepted.",
+    properties: {
+      handle: {
+        type: "string",
+        description: "Handle of user/agent to add (e.g., '@john' or '@john/agent-name')."
+      },
+      message: {
+        type: "string",
+        description: "Optional message with the request."
+      }
+    },
+    required: ["handle"]
+  },
+  thenvoi_remove_contact: {
+    description: "Remove an existing contact by handle or ID.",
+    properties: {
+      handle: {
+        type: "string",
+        description: "Contact's handle."
+      },
+      contact_id: {
+        type: "string",
+        description: "Or contact record ID (UUID)."
+      }
+    },
+    required: []
+  },
+  thenvoi_list_contact_requests: {
+    description: "List both received and sent contact requests. Received requests are always filtered to pending status. Sent requests can be filtered by status.",
+    properties: {
+      page: {
+        type: "integer",
+        description: "Page number.",
+        minimum: 1
+      },
+      page_size: {
+        type: "integer",
+        description: "Items per page per direction (max 100).",
+        minimum: 1,
+        maximum: 100
+      },
+      sent_status: {
+        type: "string",
+        enum: ["pending", "approved", "rejected", "cancelled", "all"],
+        description: "Filter sent requests by status."
+      }
+    },
+    required: []
+  },
+  thenvoi_respond_contact_request: {
+    description: "Respond to a contact request. 'approve'/'reject': For requests you RECEIVED (handle = requester's handle). 'cancel': For requests you SENT (handle = recipient's handle).",
+    properties: {
+      action: {
+        type: "string",
+        enum: ["approve", "reject", "cancel"],
+        description: "Action to take."
+      },
+      handle: {
+        type: "string",
+        description: "Other party's handle."
+      },
+      request_id: {
+        type: "string",
+        description: "Or request ID (UUID)."
+      }
+    },
+    required: ["action"]
+  },
+  thenvoi_list_memories: {
+    description: "List memories accessible to the agent. Returns memories about the specified subject (cross-agent sharing) and organization-wide shared memories.",
+    properties: {
+      subject_id: {
+        type: "string",
+        description: "Filter by subject UUID (required for subject-scoped queries)."
+      },
+      scope: {
+        type: "string",
+        enum: ["subject", "organization", "all"],
+        description: "Filter by scope."
+      },
+      system: {
+        type: "string",
+        enum: ["sensory", "working", "long_term"],
+        description: "Filter by memory system."
+      },
+      type: {
+        type: "string",
+        enum: [
+          "iconic",
+          "echoic",
+          "haptic",
+          "episodic",
+          "semantic",
+          "procedural"
+        ],
+        description: "Filter by memory type."
+      },
+      segment: {
+        type: "string",
+        enum: ["user", "agent", "tool", "guideline"],
+        description: "Filter by segment."
+      },
+      content_query: {
+        type: "string",
+        description: "Full-text search query."
+      },
+      page_size: {
+        type: "integer",
+        description: "Number of results per page.",
+        minimum: 1,
+        maximum: 50
+      },
+      status: {
+        type: "string",
+        enum: ["active", "superseded", "archived", "all"],
+        description: "Filter by status."
+      }
+    },
+    required: []
+  },
+  thenvoi_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.",
+    properties: {
+      content: {
+        type: "string",
+        description: "The memory content."
+      },
+      system: {
+        type: "string",
+        enum: ["sensory", "working", "long_term"],
+        description: "Memory system tier."
+      },
+      type: {
+        type: "string",
+        enum: [
+          "iconic",
+          "echoic",
+          "haptic",
+          "episodic",
+          "semantic",
+          "procedural"
+        ],
+        description: "Memory type (must be valid for selected system)."
+      },
+      segment: {
+        type: "string",
+        enum: ["user", "agent", "tool", "guideline"],
+        description: "Logical segment."
+      },
+      thought: {
+        type: "string",
+        description: "Agent's reasoning for storing this memory."
+      },
+      scope: {
+        type: "string",
+        enum: ["subject", "organization"],
+        description: "Visibility scope."
+      },
+      subject_id: {
+        type: "string",
+        description: "UUID of the subject this memory is about (required for subject scope)."
+      },
+      metadata: {
+        type: "object",
+        description: "Additional metadata (tags, references)."
+      }
+    },
+    required: ["content", "system", "type", "segment", "thought"]
+  },
+  thenvoi_get_memory: {
+    description: "Retrieve a specific memory by ID.",
+    properties: {
+      memory_id: {
+        type: "string",
+        description: "Memory ID (UUID)."
+      }
+    },
+    required: ["memory_id"]
+  },
+  thenvoi_supersede_memory: {
+    description: "Mark a memory as superseded (soft delete). Use when information is outdated or incorrect. The memory remains for audit trail but won't appear in normal queries. Only the source agent can supersede.",
+    properties: {
+      memory_id: {
+        type: "string",
+        description: "Memory ID (UUID)."
+      }
+    },
+    required: ["memory_id"]
+  },
+  thenvoi_archive_memory: {
+    description: "Archive a memory (hide but preserve). Use when memory is valid but not currently needed. Archived memories can be restored later by humans. Only the source agent can archive.",
+    properties: {
+      memory_id: {
+        type: "string",
+        description: "Memory ID (UUID)."
+      }
+    },
+    required: ["memory_id"]
+  }
+};
+var ALL_TOOL_NAMES = new Set(Object.keys(TOOL_MODELS));
+var MEMORY_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "thenvoi_list_memories",
+  "thenvoi_store_memory",
+  "thenvoi_get_memory",
+  "thenvoi_supersede_memory",
+  "thenvoi_archive_memory"
+]);
+var CONTACT_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "thenvoi_list_contacts",
+  "thenvoi_add_contact",
+  "thenvoi_remove_contact",
+  "thenvoi_list_contact_requests",
+  "thenvoi_respond_contact_request"
+]);
+var BASE_TOOL_NAMES = new Set(
+  [...ALL_TOOL_NAMES].filter((name) => !MEMORY_TOOL_NAMES.has(name))
+);
+var CHAT_TOOL_NAMES = new Set(
+  [...BASE_TOOL_NAMES].filter((name) => !CONTACT_TOOL_NAMES.has(name))
+);
+var MCP_TOOL_PREFIX = "mcp__thenvoi__";
+function mcpToolNames(names) {
+  return [...names].sort((a, b) => a.localeCompare(b)).map((name) => `${MCP_TOOL_PREFIX}${name}`);
+}
+function getToolDescription(name) {
+  const model = TOOL_MODELS[name];
+  return model?.description ?? `Execute ${name}`;
+}
+
+// src/contracts/protocols.ts
+var TOOL_EXECUTOR_ERROR_TYPES = [
+  "ToolArgumentsValidationError",
+  "ToolNotFoundError",
+  "ToolExecutionError"
+];
+function isToolExecutorError(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const candidate = value;
+  return candidate.ok === false && typeof candidate.errorType === "string" && TOOL_EXECUTOR_ERROR_TYPES.includes(candidate.errorType) && typeof candidate.toolName === "string" && typeof candidate.message === "string" && typeof candidate.legacyMessage === "string";
+}
+function toLegacyToolExecutorErrorMessage(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (!isToolExecutorError(value)) {
+    return null;
+  }
+  return value.legacyMessage;
+}
+
+// src/mcp/registrations.ts
+function buildRoomScopedRegistrations(resolver, options = {}) {
+  const toolNames = resolveToolNames(options);
+  const registrations = buildRegistrations(toolNames, async (toolName, args) => {
+    const roomId = asNonEmptyString(args.room_id);
+    if (!roomId) {
+      return errorResult("Missing required room_id");
+    }
+    const tools = resolver(roomId);
+    if (!tools) {
+      return errorResult(`No tool context found for room_id ${roomId}`);
+    }
+    const toolArgs = { ...args };
+    delete toolArgs.room_id;
+    return executeToolCall(tools, toolName, toolArgs);
+  }, { injectRoomId: true });
+  if (options.additionalTools) {
+    registrations.push(...options.additionalTools);
+  }
+  return registrations;
+}
+function resolveToolNames(options) {
+  const names = /* @__PURE__ */ new Set();
+  for (const name of BASE_TOOL_NAMES) {
+    if (!options.enableContactTools && CONTACT_TOOL_NAMES.has(name)) {
+      continue;
+    }
+    names.add(name);
+  }
+  if (options.enableMemoryTools) {
+    for (const name of MEMORY_TOOL_NAMES) {
+      names.add(name);
+    }
+  }
+  return names;
+}
+function buildRegistrations(toolNames, executor, opts) {
+  const registrations = [];
+  for (const toolName of toolNames) {
+    const model = TOOL_MODELS[toolName];
+    if (!model) {
+      continue;
+    }
+    const properties = { ...model.properties };
+    const required = [...model.required];
+    if (opts.injectRoomId) {
+      properties.room_id = { type: "string", description: "The room ID to execute this tool in" };
+      required.push("room_id");
+    }
+    registrations.push({
+      name: toolName,
+      description: getToolDescription(toolName),
+      inputSchema: {
+        type: "object",
+        properties,
+        required
+      },
+      execute: (args) => executor(toolName, args)
+    });
+  }
+  return registrations;
+}
+async function executeToolCall(tools, toolName, args) {
+  try {
+    const result = await tools.executeToolCall(toolName, args);
+    if (isToolExecutorError(result)) {
+      return errorResult(toLegacyToolExecutorErrorMessage(result) ?? result.message);
+    }
+    return successResult(result);
+  } catch (error) {
+    return errorResult(error instanceof Error ? error.message : String(error));
+  }
+}
+function asNonEmptyString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function successResult(value) {
+  return {
+    content: [{
+      type: "text",
+      text: serializeValue(value)
+    }]
+  };
+}
+function errorResult(message) {
+  return {
+    content: [{ type: "text", text: message }],
+    isError: true
+  };
+}
+function serializeValue(value) {
+  if (value === void 0 || value === null) {
+    return "";
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  try {
+    const json = JSON.stringify(value);
+    return typeof json === "string" ? json : String(value);
+  } catch {
+    return String(value);
+  }
+}
+
+// src/mcp/zod.ts
+function buildZodShape(z2, properties, required) {
+  const shape = {};
+  for (const [name, schema] of Object.entries(properties)) {
+    const validator = jsonSchemaToZod(z2, schema);
+    shape[name] = required.has(name) ? validator : validator.optional();
+  }
+  return shape;
+}
+function jsonSchemaToZod(z2, schema) {
+  const type = schema.type;
+  if (type === "string") {
+    if (Array.isArray(schema.enum) && schema.enum.every((v) => typeof v === "string")) {
+      const values = schema.enum;
+      if (values.length > 0) {
+        return z2.enum(values);
+      }
+    }
+    return z2.string();
+  }
+  if (type === "integer" || type === "number") {
+    return z2.number();
+  }
+  if (type === "boolean") {
+    return z2.boolean();
+  }
+  if (type === "array") {
+    const itemSchema = schema.items;
+    if (itemSchema && typeof itemSchema === "object") {
+      return z2.array(jsonSchemaToZod(z2, itemSchema));
+    }
+    return z2.array(z2.unknown());
+  }
+  if (type === "object") {
+    return z2.record(z2.string(), z2.unknown());
+  }
+  return z2.unknown();
+}
+
+// src/mcp/sdk.ts
+function createThenvoiSdkMcpServer(options) {
+  const registrations = buildRoomScopedRegistrations(
+    options.getToolsForRoom,
+    {
+      enableMemoryTools: options.enableMemoryTools,
+      enableContactTools: true,
+      additionalTools: options.additionalTools
+    }
+  );
+  const toolDefinitions = registrations.map(toSdkToolDefinition);
+  const toolNames = new Set(registrations.map((r) => r.name));
+  const serverConfig = (0, import_claude_agent_sdk.createSdkMcpServer)({
+    name: "thenvoi",
+    tools: toolDefinitions
+  });
+  return {
+    serverConfig,
+    allowedTools: mcpToolNames(toolNames),
+    toolDefinitions
+  };
+}
+function toSdkToolDefinition(registration) {
+  const shape = buildZodShape(
+    import_zod.z,
+    registration.inputSchema.properties,
+    new Set(registration.inputSchema.required)
+  );
+  return (0, import_claude_agent_sdk.tool)(
+    registration.name,
+    registration.description,
+    shape,
+    async (args) => registration.execute(args)
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createThenvoiSdkMcpServer
+});

package/dist/mcp-claude.d.cts

@@ -0,0 +1,4 @@
+export { C as CreateThenvoiSdkMcpServerOptions, T as ThenvoiSdkMcpServer, f as createThenvoiSdkMcpServer } from './claude-CwTAxhwI.cjs';
+import '@anthropic-ai/claude-agent-sdk';
+import './protocols-CInhtFpA.cjs';
+import './dtos-DUpbIu8k.cjs';

package/dist/mcp-claude.d.ts

@@ -0,0 +1,4 @@
+export { C as CreateThenvoiSdkMcpServerOptions, T as ThenvoiSdkMcpServer, f as createThenvoiSdkMcpServer } from './claude-CcnQ5OUC.js';
+import '@anthropic-ai/claude-agent-sdk';
+import './protocols-DrhzOH6K.js';
+import './dtos-DUpbIu8k.js';

package/dist/mcp-claude.js

@@ -0,0 +1,11 @@
+import "./chunk-LY55KYVI.js";
+import {
+  createThenvoiSdkMcpServer
+} from "./chunk-5CXIMAH2.js";
+import "./chunk-EDPKUUJL.js";
+import "./chunk-GVEQ3RAH.js";
+import "./chunk-3BKAC4OZ.js";
+import "./chunk-YR3BOQNW.js";
+export {
+  createThenvoiSdkMcpServer
+};