@band-ai/sdk 0.1.2

package/dist/testing.cjs

@@ -0,0 +1,217 @@
+"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/testing/index.ts
+var testing_exports = {};
+__export(testing_exports, {
+  FakeAgentTools: () => FakeAgentTools,
+  StubRestApi: () => StubRestApi
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/contracts/protocols.ts
+var DEFAULT_AGENT_TOOLS_CAPABILITIES = {
+  peers: true,
+  contacts: true,
+  memory: true
+};
+
+// src/testing/FakeAgentTools.ts
+var FakeAgentTools = class {
+  capabilities = {
+    ...DEFAULT_AGENT_TOOLS_CAPABILITIES,
+    peers: true,
+    contacts: true,
+    memory: true
+  };
+  messagesSent = [];
+  eventsSent = [];
+  participantsAdded = [];
+  participantsRemoved = [];
+  toolCalls = [];
+  messageCounter = 0;
+  eventCounter = 0;
+  failOn;
+  errorFactory;
+  constructor(options) {
+    this.failOn = new Set(options?.failOn ?? []);
+    this.errorFactory = options?.errorFactory ?? ((method) => new Error(`FakeAgentTools configured failure for ${String(method)}`));
+  }
+  async sendMessage(content, mentions) {
+    this.maybeFail("sendMessage");
+    this.messagesSent.push({ content, mentions });
+    const id = `msg-${this.messageCounter++}`;
+    return { id, status: "sent" };
+  }
+  async sendEvent(content, messageType, metadata) {
+    this.maybeFail("sendEvent");
+    this.eventsSent.push({ content, messageType, metadata });
+    const id = `evt-${this.eventCounter++}`;
+    return { id, status: "sent" };
+  }
+  async addParticipant(name, role) {
+    this.maybeFail("addParticipant");
+    this.participantsAdded.push({ name, role });
+    return { status: "ok" };
+  }
+  async removeParticipant(name) {
+    this.maybeFail("removeParticipant");
+    this.participantsRemoved.push(name);
+    return { status: "ok" };
+  }
+  async getParticipants() {
+    this.maybeFail("getParticipants");
+    return [];
+  }
+  async createChatroom(_taskId) {
+    this.maybeFail("createChatroom");
+    return `room-${Date.now()}`;
+  }
+  async lookupPeers(_page, _pageSize) {
+    this.maybeFail("lookupPeers");
+    return { data: [] };
+  }
+  getToolSchemas(_format, _options) {
+    this.maybeFail("getToolSchemas");
+    return [];
+  }
+  getAnthropicToolSchemas(_options) {
+    this.maybeFail("getAnthropicToolSchemas");
+    return [];
+  }
+  getOpenAIToolSchemas(_options) {
+    this.maybeFail("getOpenAIToolSchemas");
+    return [];
+  }
+  async executeToolCall(toolName, arguments_) {
+    this.maybeFail("executeToolCall");
+    this.toolCalls.push({ toolName, arguments: arguments_ });
+    return { status: "ok" };
+  }
+  // Contact stubs
+  async listContacts(_request) {
+    this.maybeFail("listContacts");
+    return { data: [] };
+  }
+  async addContact(_request) {
+    this.maybeFail("addContact");
+    return { status: "ok" };
+  }
+  async removeContact(_request) {
+    this.maybeFail("removeContact");
+    return { status: "ok" };
+  }
+  async listContactRequests(_request) {
+    this.maybeFail("listContactRequests");
+    return { received: [], sent: [] };
+  }
+  async respondContactRequest(_request) {
+    this.maybeFail("respondContactRequest");
+    return { status: "ok" };
+  }
+  // Memory stubs
+  async listMemories(_args) {
+    this.maybeFail("listMemories");
+    return { data: [] };
+  }
+  async storeMemory(args) {
+    this.maybeFail("storeMemory");
+    return { ...args, id: "mem-0", status: "active" };
+  }
+  async getMemory(memoryId) {
+    this.maybeFail("getMemory");
+    return { id: memoryId, status: "active" };
+  }
+  async supersedeMemory(_memoryId) {
+    this.maybeFail("supersedeMemory");
+    return { status: "ok" };
+  }
+  async archiveMemory(_memoryId) {
+    this.maybeFail("archiveMemory");
+    return { status: "ok" };
+  }
+  reset() {
+    this.messagesSent.length = 0;
+    this.eventsSent.length = 0;
+    this.participantsAdded.length = 0;
+    this.participantsRemoved.length = 0;
+    this.toolCalls.length = 0;
+    this.messageCounter = 0;
+    this.eventCounter = 0;
+  }
+  maybeFail(method) {
+    if (this.failOn.has(method)) {
+      throw this.errorFactory(method);
+    }
+  }
+};
+
+// src/testing/StubRestApi.ts
+var StubRestApi = class {
+  async getAgentMe() {
+    return { id: "stub-agent", name: "Stub Agent", description: null };
+  }
+  async createChatMessage() {
+    return { ok: true };
+  }
+  async createChatEvent() {
+    return { ok: true };
+  }
+  async createChat() {
+    return { id: "stub-room" };
+  }
+  async listChatParticipants() {
+    return [];
+  }
+  async addChatParticipant() {
+    return { ok: true };
+  }
+  async removeChatParticipant() {
+    return { ok: true };
+  }
+  async markMessageProcessing() {
+    return { ok: true };
+  }
+  async markMessageProcessed() {
+    return { ok: true };
+  }
+  async markMessageFailed() {
+    return { ok: true };
+  }
+  async listChats() {
+    return {
+      data: [],
+      metadata: { page: 1, pageSize: 100, totalCount: 0, totalPages: 1 }
+    };
+  }
+  async listPeers() {
+    return {
+      data: [],
+      metadata: { page: 1, pageSize: 100, totalCount: 0, totalPages: 1 }
+    };
+  }
+  async getNextMessage() {
+    return null;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FakeAgentTools,
+  StubRestApi
+});

package/dist/testing.d.cts

@@ -0,0 +1,126 @@
+import { A as AdapterToolsProtocol, d as PeerLookupTools, C as ContactTools, M as MemoryTools, h as AgentToolsCapabilities } from './protocols-CInhtFpA.cjs';
+import { a as MentionInput, M as MetadataMap, T as ToolOperationResult, P as ParticipantRecord, c as PaginatedList, d as PeerRecord, b as ToolSchemaRecord, 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-DUpbIu8k.cjs';
+import { R as RestApi } from './types-CSHFipIc.cjs';
+
+interface CapturedMessage {
+    content: string;
+    mentions?: MentionInput;
+}
+interface CapturedEvent {
+    content: string;
+    messageType: string;
+    metadata?: MetadataMap;
+}
+interface CapturedParticipant {
+    name: string;
+    role?: string;
+}
+interface CapturedToolCall {
+    toolName: string;
+    arguments: MetadataMap;
+}
+type FakeToolMethod = keyof AdapterToolsProtocol;
+interface FakeAgentToolsOptions {
+    failOn?: Iterable<FakeToolMethod>;
+    errorFactory?: (method: FakeToolMethod) => Error;
+}
+declare class FakeAgentTools implements AdapterToolsProtocol, PeerLookupTools, ContactTools, MemoryTools {
+    readonly capabilities: Readonly<AgentToolsCapabilities>;
+    messagesSent: CapturedMessage[];
+    eventsSent: CapturedEvent[];
+    participantsAdded: CapturedParticipant[];
+    participantsRemoved: string[];
+    toolCalls: CapturedToolCall[];
+    private messageCounter;
+    private eventCounter;
+    private readonly failOn;
+    private readonly errorFactory;
+    constructor(options?: FakeAgentToolsOptions);
+    sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
+    sendEvent(content: string, messageType: string, metadata?: MetadataMap): Promise<ToolOperationResult>;
+    addParticipant(name: string, role?: string): Promise<ToolOperationResult>;
+    removeParticipant(name: string): Promise<ToolOperationResult>;
+    getParticipants(): Promise<ParticipantRecord[]>;
+    createChatroom(_taskId?: string): Promise<string>;
+    lookupPeers(_page?: number, _pageSize?: number): Promise<PaginatedList<PeerRecord>>;
+    getToolSchemas(_format: "openai" | "anthropic", _options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getAnthropicToolSchemas(_options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getOpenAIToolSchemas(_options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    executeToolCall(toolName: string, arguments_: MetadataMap): Promise<unknown>;
+    listContacts(_request?: ListContactsArgs): Promise<PaginatedList<ContactRecord>>;
+    addContact(_request: AddContactArgs): Promise<ToolOperationResult>;
+    removeContact(_request: RemoveContactArgs): Promise<ToolOperationResult>;
+    listContactRequests(_request?: ListContactRequestsArgs): Promise<ContactRequestsResult>;
+    respondContactRequest(_request: RespondContactRequestArgs): Promise<ToolOperationResult>;
+    listMemories(_args?: ListMemoriesArgs): Promise<PaginatedList<MemoryRecord>>;
+    storeMemory(args: StoreMemoryArgs): Promise<MemoryRecord>;
+    getMemory(memoryId: string): Promise<MemoryRecord>;
+    supersedeMemory(_memoryId: string): Promise<ToolOperationResult>;
+    archiveMemory(_memoryId: string): Promise<ToolOperationResult>;
+    reset(): void;
+    private maybeFail;
+}
+
+/**
+ * No-op REST API implementation for local development and examples.
+ * Returns sensible defaults for all methods without making real API calls.
+ */
+declare class StubRestApi implements RestApi {
+    getAgentMe(): Promise<{
+        id: string;
+        name: string;
+        description: null;
+    }>;
+    createChatMessage(): Promise<{
+        ok: boolean;
+    }>;
+    createChatEvent(): Promise<{
+        ok: boolean;
+    }>;
+    createChat(): Promise<{
+        id: string;
+    }>;
+    listChatParticipants(): Promise<never[]>;
+    addChatParticipant(): Promise<{
+        ok: boolean;
+    }>;
+    removeChatParticipant(): Promise<{
+        ok: boolean;
+    }>;
+    markMessageProcessing(): Promise<{
+        ok: boolean;
+    }>;
+    markMessageProcessed(): Promise<{
+        ok: boolean;
+    }>;
+    markMessageFailed(): Promise<{
+        ok: boolean;
+    }>;
+    listChats(): Promise<{
+        data: never[];
+        metadata: {
+            page: number;
+            pageSize: number;
+            totalCount: number;
+            totalPages: number;
+        };
+    }>;
+    listPeers(): Promise<{
+        data: never[];
+        metadata: {
+            page: number;
+            pageSize: number;
+            totalCount: number;
+            totalPages: number;
+        };
+    }>;
+    getNextMessage(): Promise<null>;
+}
+
+export { FakeAgentTools, type FakeAgentToolsOptions, StubRestApi };

package/dist/testing.d.ts

@@ -0,0 +1,126 @@
+import { A as AdapterToolsProtocol, d as PeerLookupTools, C as ContactTools, M as MemoryTools, h as AgentToolsCapabilities } from './protocols-DrhzOH6K.js';
+import { a as MentionInput, M as MetadataMap, T as ToolOperationResult, P as ParticipantRecord, c as PaginatedList, d as PeerRecord, b as ToolSchemaRecord, 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-DUpbIu8k.js';
+import { R as RestApi } from './types-CxII3XkA.js';
+
+interface CapturedMessage {
+    content: string;
+    mentions?: MentionInput;
+}
+interface CapturedEvent {
+    content: string;
+    messageType: string;
+    metadata?: MetadataMap;
+}
+interface CapturedParticipant {
+    name: string;
+    role?: string;
+}
+interface CapturedToolCall {
+    toolName: string;
+    arguments: MetadataMap;
+}
+type FakeToolMethod = keyof AdapterToolsProtocol;
+interface FakeAgentToolsOptions {
+    failOn?: Iterable<FakeToolMethod>;
+    errorFactory?: (method: FakeToolMethod) => Error;
+}
+declare class FakeAgentTools implements AdapterToolsProtocol, PeerLookupTools, ContactTools, MemoryTools {
+    readonly capabilities: Readonly<AgentToolsCapabilities>;
+    messagesSent: CapturedMessage[];
+    eventsSent: CapturedEvent[];
+    participantsAdded: CapturedParticipant[];
+    participantsRemoved: string[];
+    toolCalls: CapturedToolCall[];
+    private messageCounter;
+    private eventCounter;
+    private readonly failOn;
+    private readonly errorFactory;
+    constructor(options?: FakeAgentToolsOptions);
+    sendMessage(content: string, mentions?: MentionInput): Promise<ToolOperationResult>;
+    sendEvent(content: string, messageType: string, metadata?: MetadataMap): Promise<ToolOperationResult>;
+    addParticipant(name: string, role?: string): Promise<ToolOperationResult>;
+    removeParticipant(name: string): Promise<ToolOperationResult>;
+    getParticipants(): Promise<ParticipantRecord[]>;
+    createChatroom(_taskId?: string): Promise<string>;
+    lookupPeers(_page?: number, _pageSize?: number): Promise<PaginatedList<PeerRecord>>;
+    getToolSchemas(_format: "openai" | "anthropic", _options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getAnthropicToolSchemas(_options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    getOpenAIToolSchemas(_options?: {
+        includeMemory?: boolean;
+    }): ToolSchemaRecord[];
+    executeToolCall(toolName: string, arguments_: MetadataMap): Promise<unknown>;
+    listContacts(_request?: ListContactsArgs): Promise<PaginatedList<ContactRecord>>;
+    addContact(_request: AddContactArgs): Promise<ToolOperationResult>;
+    removeContact(_request: RemoveContactArgs): Promise<ToolOperationResult>;
+    listContactRequests(_request?: ListContactRequestsArgs): Promise<ContactRequestsResult>;
+    respondContactRequest(_request: RespondContactRequestArgs): Promise<ToolOperationResult>;
+    listMemories(_args?: ListMemoriesArgs): Promise<PaginatedList<MemoryRecord>>;
+    storeMemory(args: StoreMemoryArgs): Promise<MemoryRecord>;
+    getMemory(memoryId: string): Promise<MemoryRecord>;
+    supersedeMemory(_memoryId: string): Promise<ToolOperationResult>;
+    archiveMemory(_memoryId: string): Promise<ToolOperationResult>;
+    reset(): void;
+    private maybeFail;
+}
+
+/**
+ * No-op REST API implementation for local development and examples.
+ * Returns sensible defaults for all methods without making real API calls.
+ */
+declare class StubRestApi implements RestApi {
+    getAgentMe(): Promise<{
+        id: string;
+        name: string;
+        description: null;
+    }>;
+    createChatMessage(): Promise<{
+        ok: boolean;
+    }>;
+    createChatEvent(): Promise<{
+        ok: boolean;
+    }>;
+    createChat(): Promise<{
+        id: string;
+    }>;
+    listChatParticipants(): Promise<never[]>;
+    addChatParticipant(): Promise<{
+        ok: boolean;
+    }>;
+    removeChatParticipant(): Promise<{
+        ok: boolean;
+    }>;
+    markMessageProcessing(): Promise<{
+        ok: boolean;
+    }>;
+    markMessageProcessed(): Promise<{
+        ok: boolean;
+    }>;
+    markMessageFailed(): Promise<{
+        ok: boolean;
+    }>;
+    listChats(): Promise<{
+        data: never[];
+        metadata: {
+            page: number;
+            pageSize: number;
+            totalCount: number;
+            totalPages: number;
+        };
+    }>;
+    listPeers(): Promise<{
+        data: never[];
+        metadata: {
+            page: number;
+            pageSize: number;
+            totalCount: number;
+            totalPages: number;
+        };
+    }>;
+    getNextMessage(): Promise<null>;
+}
+
+export { FakeAgentTools, type FakeAgentToolsOptions, StubRestApi };

package/dist/testing.js

@@ -0,0 +1,186 @@
+import {
+  DEFAULT_AGENT_TOOLS_CAPABILITIES
+} from "./chunk-3BKAC4OZ.js";
+
+// src/testing/FakeAgentTools.ts
+var FakeAgentTools = class {
+  capabilities = {
+    ...DEFAULT_AGENT_TOOLS_CAPABILITIES,
+    peers: true,
+    contacts: true,
+    memory: true
+  };
+  messagesSent = [];
+  eventsSent = [];
+  participantsAdded = [];
+  participantsRemoved = [];
+  toolCalls = [];
+  messageCounter = 0;
+  eventCounter = 0;
+  failOn;
+  errorFactory;
+  constructor(options) {
+    this.failOn = new Set(options?.failOn ?? []);
+    this.errorFactory = options?.errorFactory ?? ((method) => new Error(`FakeAgentTools configured failure for ${String(method)}`));
+  }
+  async sendMessage(content, mentions) {
+    this.maybeFail("sendMessage");
+    this.messagesSent.push({ content, mentions });
+    const id = `msg-${this.messageCounter++}`;
+    return { id, status: "sent" };
+  }
+  async sendEvent(content, messageType, metadata) {
+    this.maybeFail("sendEvent");
+    this.eventsSent.push({ content, messageType, metadata });
+    const id = `evt-${this.eventCounter++}`;
+    return { id, status: "sent" };
+  }
+  async addParticipant(name, role) {
+    this.maybeFail("addParticipant");
+    this.participantsAdded.push({ name, role });
+    return { status: "ok" };
+  }
+  async removeParticipant(name) {
+    this.maybeFail("removeParticipant");
+    this.participantsRemoved.push(name);
+    return { status: "ok" };
+  }
+  async getParticipants() {
+    this.maybeFail("getParticipants");
+    return [];
+  }
+  async createChatroom(_taskId) {
+    this.maybeFail("createChatroom");
+    return `room-${Date.now()}`;
+  }
+  async lookupPeers(_page, _pageSize) {
+    this.maybeFail("lookupPeers");
+    return { data: [] };
+  }
+  getToolSchemas(_format, _options) {
+    this.maybeFail("getToolSchemas");
+    return [];
+  }
+  getAnthropicToolSchemas(_options) {
+    this.maybeFail("getAnthropicToolSchemas");
+    return [];
+  }
+  getOpenAIToolSchemas(_options) {
+    this.maybeFail("getOpenAIToolSchemas");
+    return [];
+  }
+  async executeToolCall(toolName, arguments_) {
+    this.maybeFail("executeToolCall");
+    this.toolCalls.push({ toolName, arguments: arguments_ });
+    return { status: "ok" };
+  }
+  // Contact stubs
+  async listContacts(_request) {
+    this.maybeFail("listContacts");
+    return { data: [] };
+  }
+  async addContact(_request) {
+    this.maybeFail("addContact");
+    return { status: "ok" };
+  }
+  async removeContact(_request) {
+    this.maybeFail("removeContact");
+    return { status: "ok" };
+  }
+  async listContactRequests(_request) {
+    this.maybeFail("listContactRequests");
+    return { received: [], sent: [] };
+  }
+  async respondContactRequest(_request) {
+    this.maybeFail("respondContactRequest");
+    return { status: "ok" };
+  }
+  // Memory stubs
+  async listMemories(_args) {
+    this.maybeFail("listMemories");
+    return { data: [] };
+  }
+  async storeMemory(args) {
+    this.maybeFail("storeMemory");
+    return { ...args, id: "mem-0", status: "active" };
+  }
+  async getMemory(memoryId) {
+    this.maybeFail("getMemory");
+    return { id: memoryId, status: "active" };
+  }
+  async supersedeMemory(_memoryId) {
+    this.maybeFail("supersedeMemory");
+    return { status: "ok" };
+  }
+  async archiveMemory(_memoryId) {
+    this.maybeFail("archiveMemory");
+    return { status: "ok" };
+  }
+  reset() {
+    this.messagesSent.length = 0;
+    this.eventsSent.length = 0;
+    this.participantsAdded.length = 0;
+    this.participantsRemoved.length = 0;
+    this.toolCalls.length = 0;
+    this.messageCounter = 0;
+    this.eventCounter = 0;
+  }
+  maybeFail(method) {
+    if (this.failOn.has(method)) {
+      throw this.errorFactory(method);
+    }
+  }
+};
+
+// src/testing/StubRestApi.ts
+var StubRestApi = class {
+  async getAgentMe() {
+    return { id: "stub-agent", name: "Stub Agent", description: null };
+  }
+  async createChatMessage() {
+    return { ok: true };
+  }
+  async createChatEvent() {
+    return { ok: true };
+  }
+  async createChat() {
+    return { id: "stub-room" };
+  }
+  async listChatParticipants() {
+    return [];
+  }
+  async addChatParticipant() {
+    return { ok: true };
+  }
+  async removeChatParticipant() {
+    return { ok: true };
+  }
+  async markMessageProcessing() {
+    return { ok: true };
+  }
+  async markMessageProcessed() {
+    return { ok: true };
+  }
+  async markMessageFailed() {
+    return { ok: true };
+  }
+  async listChats() {
+    return {
+      data: [],
+      metadata: { page: 1, pageSize: 100, totalCount: 0, totalPages: 1 }
+    };
+  }
+  async listPeers() {
+    return {
+      data: [],
+      metadata: { page: 1, pageSize: 100, totalCount: 0, totalPages: 1 }
+    };
+  }
+  async getNextMessage() {
+    return null;
+  }
+};
+export {
+  FakeAgentTools,
+  StubRestApi
+};