agentmesh-ai 0.3.1 → 0.4.0

package/dist/memory/write-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-utils.d.ts","sourceRoot":"","sources":["../../src/memory/write-utils.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9G,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CAEtG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CA8BrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAa9F;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAatF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAiBN"}
+{"version":3,"file":"write-utils.d.ts","sourceRoot":"","sources":["../../src/memory/write-utils.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9H,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CAEtG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CA8BrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAa9F;AAYD,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAa3E;AAED,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAIlD;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAkBtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAiBN"}

package/dist/memory/write-utils.js

@@ -59,15 +59,52 @@ export function validateContent(content) {
     }
     return { warnings: scanResult.warnings };
 }
+/** Tag-to-category mapping for automatic inference. */
+const TAG_TO_CATEGORY = {
+    'api': 'api', 'endpoint': 'api', 'route': 'api', 'rest': 'api', 'graphql': 'api', 'interface': 'api',
+    'convention': 'convention', 'naming': 'convention', 'style': 'convention', 'pattern': 'convention', 'standard': 'convention',
+    'bug': 'gotcha', 'gotcha': 'gotcha', 'workaround': 'gotcha', 'pitfall': 'gotcha', 'fix': 'gotcha',
+    'decision': 'decision', 'architecture': 'decision', 'tech-stack': 'decision', 'choice': 'decision', 'design': 'decision',
+    'dependency': 'dependency', 'library': 'dependency', 'package': 'dependency', 'framework': 'dependency', 'tool': 'dependency',
+    'preference': 'user_pref', 'user': 'user_pref',
+};
+/** Infer category from tags and topic when not explicitly provided. */
+export function inferCategory(tags, topic) {
+    // Check tags first
+    for (const tag of tags) {
+        const cat = TAG_TO_CATEGORY[tag.toLowerCase()];
+        if (cat)
+            return cat;
+    }
+    // Check topic words
+    const topicWords = topic.toLowerCase().split(/\s+/);
+    for (const word of topicWords) {
+        const cat = TAG_TO_CATEGORY[word];
+        if (cat)
+            return cat;
+    }
+    return 'project_fact';
+}
+/** Check if an entry represents a rule (convention or protected decision). */
+export function isRule(entry) {
+    const status = getEffectiveStatus(entry);
+    const category = entry.category ?? inferCategory(entry.tags, entry.topic);
+    return category === 'convention' || (category === 'decision' && status === 'protected');
+}
 /** Build a new MemoryEntry from write options. */
 export function buildMemoryEntry(options, now) {
     const resolvedStatus = getEffectiveStatus({ status: options.status, protected: options.protected });
+    const category = options.category ?? inferCategory(options.tags, options.topic);
+    const summary = options.summary ?? options.content.slice(0, 60).replace(/\n/g, ' ');
     return {
         topic: options.topic,
         tags: options.tags,
         content: options.content,
         date: now,
         status: resolvedStatus,
+        category,
+        summary,
+        ...(options.scope === 'private' ? { scope: 'private' } : {}),
         ...(options.decided_with ? { decided_with: options.decided_with } : {}),
         ...(resolvedStatus === 'protected' ? { protected: true } : {}),
         ...(options.owner ? { owner: options.owner } : {}),

package/dist/memory/write-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-utils.js","sourceRoot":"","sources":["../../src/memory/write-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write-utils.js","sourceRoot":"","sources":["../../src/memory/write-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,KAAqD;IACtF,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,WAA8B,EAC9B,OAAe,EACf,KAAa;IAEb,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO;YAAE,SAAS;QAEvC,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CACnD,CAAC;QACF,IAAI,CAAC,aAAa;YAAE,SAAS;QAE7B,MAAM,eAAe,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;QAE1D,IAAI,eAAe,KAAK,WAAW,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;YAClD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE;wBACP,OAAO,EAAE,KAAK;wBACd,OAAO,EAAE,IAAI;wBACb,MAAM,EAAE,UAAU,KAAK,oDAAoD,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,aAAa,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,sNAAsN,KAAK,MAAM,OAAO,UAAU;qBAC1Y;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,eAAe,KAAK,UAAU,EAAE,CAAC;YAC1C,OAAO;gBACL,eAAe,EAAE,SAAS,MAAM,CAAC,KAAK,uBAAuB,aAAa,CAAC,KAAK,wEAAwE;aACzJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,oEAAoE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,8CAA8C;aACzJ;YACD,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,uDAAuD;AACvD,MAAM,eAAe,GAAmC;IACtD,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK;IACpG,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY;IAC5H,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;IACjG,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU;IACxH,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY;IAC7H,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW;CAC/C,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,KAAa;IACzD,mBAAmB;IACnB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/C,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IACD,oBAAoB;IACpB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1E,OAAO,QAAQ,KAAK,YAAY,IAAI,CAAC,QAAQ,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW,CAAC,CAAC;AAC1F,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,OAA2B,EAAE,GAAW;IACvE,MAAM,cAAc,GAAG,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpG,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEpF,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,cAAc;QACtB,QAAQ;QACR,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,cAAc,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAAsB,EACtB,QAAqB,EACrB,OAA2B;IAE3B,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CACrC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAC5D,CAAC;IAEF,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,UAAU,CAAC,EAAE,CAAC;YACrG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;YAC5B,IAAI,SAAS,KAAK,WAAW;gBAAE,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;YACzD,IAAI,QAAQ,CAAC,KAAK;gBAAE,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/sdk.d.ts

@@ -0,0 +1,95 @@
+import type { MemoryCategory, MemoryStatus, MemoryScope, MergedMemoryEntry, WriteResult } from './memory/types.js';
+import type { HealthReport } from './memory/consolidator.js';
+import type { StoredMessage } from './conversation/protocol.js';
+/** Options for creating an AgentMeshClient. */
+export interface AgentMeshClientOptions {
+    /** Cloud team ID (e.g. 'team-a1b2c3d4e5f6a7b8'). */
+    teamId: string;
+    /** Unique ID for this agent (e.g. 'researcher', 'writer-agent'). */
+    agentId: string;
+    /** Human-readable role (e.g. 'Research Agent'). Default: 'agent'. */
+    agentRole?: string;
+    /** The framework/tool name (e.g. 'crewai', 'autogen'). Default: 'sdk'. */
+    agentTool?: string;
+}
+/** Options for reading memory. */
+export interface ReadMemoryOpts {
+    /** Read full details for specific topics only. */
+    topics?: string[];
+    /** Filter by tags. */
+    tags?: string[];
+    /** Filter by category. */
+    category?: MemoryCategory;
+    /** Filter by a specific agent. */
+    agent?: string;
+    /** Max entries (default 50). */
+    limit?: number;
+}
+/** Options for writing memory. */
+export interface WriteMemoryOpts {
+    topic: string;
+    content: string;
+    tags: string[];
+    category?: MemoryCategory;
+    summary?: string;
+    status?: MemoryStatus;
+    scope?: MemoryScope;
+    decided_with?: string[];
+    owner?: string;
+}
+/** Options for searching memory. */
+export interface SearchMemoryOpts {
+    category?: MemoryCategory;
+    limit?: number;
+}
+/** Options for waiting for replies. */
+export interface WaitForRepliesOpts {
+    /** Max wait time in ms (default 60000). */
+    timeoutMs?: number;
+    /** Poll interval in ms (default 5000). */
+    pollIntervalMs?: number;
+}
+/**
+ * AgentMesh SDK client for programmatic access to shared memory and messaging.
+ *
+ * Designed for agent frameworks (CrewAI, AutoGen, LangGraph, etc.) and
+ * any Node.js application that needs persistent cross-agent knowledge sharing.
+ */
+export declare class AgentMeshClient {
+    private teamId;
+    private agentId;
+    private agentRole;
+    private agentTool;
+    constructor(options: AgentMeshClientOptions);
+    /**
+     * Read shared memory.
+     * Without `topics`: returns all entries (filtered by tags/category/agent).
+     * With `topics`: returns full details for specific topics only.
+     */
+    readMemory(opts?: ReadMemoryOpts): Promise<MergedMemoryEntry[]>;
+    /**
+     * Read memory and return a formatted string (index or full details).
+     * Useful for injecting into agent prompts.
+     */
+    readMemoryFormatted(opts?: ReadMemoryOpts): Promise<string>;
+    /** Write a knowledge entry to shared memory. */
+    writeMemory(opts: WriteMemoryOpts): Promise<WriteResult>;
+    /** Search shared memory by keyword. */
+    searchMemory(query: string, opts?: SearchMemoryOpts): Promise<MergedMemoryEntry[]>;
+    /** Analyze memory health — find duplicates, stale entries, conflicts. */
+    consolidate(): Promise<HealthReport>;
+    /** Get a formatted health report string. */
+    consolidateFormatted(): Promise<string>;
+    /** Send a message to a discussion topic (REST mode, no WebSocket needed). */
+    sendMessage(topic: string, content: string): Promise<void>;
+    /** Get messages for a topic, optionally since a timestamp. */
+    getMessages(topic: string, opts?: {
+        since?: string;
+    }): Promise<StoredMessage[]>;
+    /**
+     * Wait for replies on a topic by polling the database.
+     * Returns new messages from other agents, or empty array on timeout.
+     */
+    waitForReplies(topic: string, opts?: WaitForRepliesOpts): Promise<StoredMessage[]>;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}

package/dist/sdk.js

@@ -0,0 +1,177 @@
+/**
+ * AgentMesh SDK — programmatic access to shared memory and conversation.
+ *
+ * Use this when integrating AgentMesh into agent frameworks (CrewAI, AutoGen,
+ * LangGraph, etc.) or any Node.js/TypeScript application.
+ *
+ * @example
+ * ```typescript
+ * import { AgentMeshClient } from 'agentmesh-ai';
+ *
+ * const client = new AgentMeshClient({
+ *   teamId: 'team-a1b2c3d4e5f6a7b8',
+ *   agentId: 'researcher',
+ *   agentRole: 'Research Agent',
+ *   agentTool: 'crewai',
+ * });
+ *
+ * // Read team knowledge
+ * const memories = await client.readMemory();
+ *
+ * // Write knowledge
+ * await client.writeMemory({
+ *   topic: 'Data Sources',
+ *   content: 'Bloomberg API is reliable for financial data',
+ *   tags: ['data', 'api'],
+ *   category: 'project_fact',
+ * });
+ *
+ * // Search
+ * const results = await client.searchMemory('authentication');
+ *
+ * // Send a message to other agents
+ * await client.sendMessage('API Design', 'I suggest REST over GraphQL');
+ * ```
+ */
+import { cloudReadAllMemories, cloudWriteMemory, getSupabaseClient, } from './cloud/supabase-client.js';
+import { searchMemories } from './memory/searcher.js';
+import { mergeMemories, formatMemoryIndex, formatMergedMemories } from './memory/merge-view.js';
+import { analyzeMemoryHealth, formatHealthReport } from './memory/consolidator.js';
+/**
+ * AgentMesh SDK client for programmatic access to shared memory and messaging.
+ *
+ * Designed for agent frameworks (CrewAI, AutoGen, LangGraph, etc.) and
+ * any Node.js application that needs persistent cross-agent knowledge sharing.
+ */
+export class AgentMeshClient {
+    teamId;
+    agentId;
+    agentRole;
+    agentTool;
+    constructor(options) {
+        this.teamId = options.teamId;
+        this.agentId = options.agentId;
+        this.agentRole = options.agentRole ?? 'agent';
+        this.agentTool = options.agentTool ?? 'sdk';
+    }
+    /**
+     * Read shared memory.
+     * Without `topics`: returns all entries (filtered by tags/category/agent).
+     * With `topics`: returns full details for specific topics only.
+     */
+    async readMemory(opts) {
+        const memories = await cloudReadAllMemories(this.teamId);
+        return mergeMemories(memories, {
+            topics: opts?.topics,
+            tags: opts?.tags,
+            agent: opts?.agent,
+            limit: opts?.topics ? undefined : (opts?.limit ?? 50),
+        });
+    }
+    /**
+     * Read memory and return a formatted string (index or full details).
+     * Useful for injecting into agent prompts.
+     */
+    async readMemoryFormatted(opts) {
+        const entries = await this.readMemory(opts);
+        if (opts?.topics && opts.topics.length > 0) {
+            return formatMergedMemories(entries);
+        }
+        return formatMemoryIndex(entries, this.agentId);
+    }
+    /** Write a knowledge entry to shared memory. */
+    async writeMemory(opts) {
+        return cloudWriteMemory(this.teamId, this.agentId, this.agentRole, this.agentTool, {
+            topic: opts.topic,
+            content: opts.content,
+            tags: opts.tags,
+            category: opts.category,
+            summary: opts.summary,
+            status: opts.status,
+            scope: opts.scope,
+            decided_with: opts.decided_with,
+            owner: opts.owner,
+        });
+    }
+    /** Search shared memory by keyword. */
+    async searchMemory(query, opts) {
+        const memories = await cloudReadAllMemories(this.teamId);
+        return searchMemories(memories, query, {
+            category: opts?.category,
+            limit: opts?.limit,
+        });
+    }
+    /** Analyze memory health — find duplicates, stale entries, conflicts. */
+    async consolidate() {
+        const memories = await cloudReadAllMemories(this.teamId);
+        const allEntries = mergeMemories(memories, { limit: 999 });
+        return analyzeMemoryHealth(allEntries);
+    }
+    /** Get a formatted health report string. */
+    async consolidateFormatted() {
+        const report = await this.consolidate();
+        return formatHealthReport(report);
+    }
+    /** Send a message to a discussion topic (REST mode, no WebSocket needed). */
+    async sendMessage(topic, content) {
+        const supabase = getSupabaseClient();
+        const { error } = await supabase.from('team_messages').insert({
+            team_id: this.teamId,
+            topic,
+            agent_id: this.agentId,
+            agent_display_name: this.agentId,
+            agent_role: this.agentRole,
+            agent_tool: this.agentTool,
+            content,
+            message_type: 'message',
+        });
+        if (error) {
+            throw new Error(`Failed to send message: ${error.message}`);
+        }
+    }
+    /** Get messages for a topic, optionally since a timestamp. */
+    async getMessages(topic, opts) {
+        const supabase = getSupabaseClient();
+        let query = supabase
+            .from('team_messages')
+            .select('*')
+            .eq('team_id', this.teamId)
+            .eq('topic', topic)
+            .order('created_at', { ascending: true });
+        if (opts?.since) {
+            query = query.gt('created_at', opts.since);
+        }
+        const { data } = await query;
+        return (data ?? []).map(row => ({
+            from: {
+                id: row.agent_id,
+                displayName: row.agent_display_name,
+                role: row.agent_role,
+                tool: row.agent_tool,
+            },
+            topic: row.topic,
+            content: row.content,
+            timestamp: row.created_at,
+        }));
+    }
+    /**
+     * Wait for replies on a topic by polling the database.
+     * Returns new messages from other agents, or empty array on timeout.
+     */
+    async waitForReplies(topic, opts) {
+        const timeoutMs = opts?.timeoutMs ?? 60000;
+        const pollIntervalMs = opts?.pollIntervalMs ?? 5000;
+        const since = new Date().toISOString();
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+            const replies = await this.getMessages(topic, { since });
+            const fromOthers = replies.filter(m => m.from.id !== this.agentId);
+            if (fromOthers.length > 0) {
+                return fromOthers;
+            }
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}

package/dist/utils/id.d.ts

@@ -1,4 +1,4 @@
-/** Generate a unique team ID (short, human-friendly). */
+/** Generate a unique team ID. 16 hex chars = 8 bytes = 2^64 possibilities (unguessable). */
 export declare function generateTeamId(): string;
 /** Generate a slug-style agent ID from display name and tool. */
 export declare function generateAgentId(displayName: string, tool: string): string;

package/dist/utils/id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAKA,yDAAyD;AACzD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASzE"}
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAKA,4FAA4F;AAC5F,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASzE"}

package/dist/utils/id.js

@@ -2,9 +2,9 @@
  * Agent ID generation utilities.
  */
 import { randomBytes } from 'node:crypto';
-/** Generate a unique team ID (short, human-friendly). */
+/** Generate a unique team ID. 16 hex chars = 8 bytes = 2^64 possibilities (unguessable). */
 export function generateTeamId() {
-    return `team-${randomBytes(4).toString('hex')}`;
+    return `team-${randomBytes(8).toString('hex')}`;
 }
 /** Generate a slug-style agent ID from display name and tool. */
 export function generateAgentId(displayName, tool) {

package/dist/utils/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,yDAAyD;AACzD,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,IAAY;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,qFAAqF;IACrF,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,QAAQ,IAAI,QAAQ,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IAEtE,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,mFAAmF;AACnF,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG;SACP,WAAW,EAAE;SACb,IAAI,EAAE;QACP,2DAA2D;SAC1D,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAG,0CAA0C;SACpE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAO,4BAA4B;SACtD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAI,gCAAgC;AAC/D,CAAC"}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,4FAA4F;AAC5F,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,IAAY;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,qFAAqF;IACrF,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,QAAQ,IAAI,QAAQ,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IAEtE,OAAO,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,mFAAmF;AACnF,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG;SACP,WAAW,EAAE;SACb,IAAI,EAAE;QACP,2DAA2D;SAC1D,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAG,0CAA0C;SACpE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAO,4BAA4B;SACtD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAI,gCAAgC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmesh-ai",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Let your AI agents share knowledge and talk to each other",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,6 +14,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./sdk": {
+      "types": "./dist/sdk.d.ts",
+      "default": "./dist/sdk.js"
+    },
     "./mcp": {
       "types": "./dist/mcp/index.d.ts",
       "default": "./dist/mcp/index.js"

package/test-realtime.mjs

@@ -0,0 +1,97 @@
+import { createClient } from '@supabase/supabase-js';
+
+const SUPABASE_URL = 'https://hbdrhdeqyioxkzmoxnjp.supabase.co';
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImhiZHJoZGVxeWlveGt6bW94bmpwIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzUxMzY4MTYsImV4cCI6MjA5MDcxMjgxNn0.BDKzJt4XQ1yS9eIoO0dp2Mx7flxU2eEwxfD8kAIlw_w';
+
+console.log('=== Supabase Realtime Diagnostic ===\n');
+
+// Test 1: REST API
+console.log('Test 1: REST API...');
+const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
+try {
+  const { data, error } = await supabase.from('team_memories').select('count').limit(1);
+  if (error) console.log('  REST FAIL:', error.message);
+  else console.log('  REST OK');
+} catch (e) {
+  console.log('  REST FAIL:', e.message);
+}
+
+// Test 2: WebSocket URL reachability
+console.log('\nTest 2: WebSocket URL...');
+const wsUrl = SUPABASE_URL.replace('https://', 'wss://') + '/realtime/v1/websocket?apikey=' + SUPABASE_ANON_KEY + '&vsn=1.0.0';
+console.log('  URL:', wsUrl.slice(0, 80) + '...');
+
+try {
+  const { default: WebSocket } = await import('ws');
+  const ws = new WebSocket(wsUrl);
+
+  await new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      ws.close();
+      reject(new Error('WebSocket connection timeout (15s)'));
+    }, 15000);
+
+    ws.on('open', () => {
+      clearTimeout(timeout);
+      console.log('  WebSocket OPEN - connected!');
+      ws.close();
+      resolve();
+    });
+
+    ws.on('error', (err) => {
+      clearTimeout(timeout);
+      console.log('  WebSocket ERROR:', err.message);
+      reject(err);
+    });
+
+    ws.on('close', (code, reason) => {
+      console.log('  WebSocket CLOSED: code=' + code, 'reason=' + reason.toString());
+    });
+  });
+} catch (e) {
+  console.log('  WebSocket FAIL:', e.message);
+}
+
+// Test 3: Supabase Realtime channel
+console.log('\nTest 3: Supabase Realtime channel subscribe...');
+try {
+  const channel = supabase.channel('test-diagnostic', {
+    config: { broadcast: { self: true } },
+  });
+
+  const result = await new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      supabase.removeChannel(channel);
+      reject(new Error('Channel subscribe timeout (20s)'));
+    }, 20000);
+
+    channel.subscribe((status) => {
+      console.log('  Channel status:', status);
+      if (status === 'SUBSCRIBED') {
+        clearTimeout(timeout);
+        resolve('OK');
+      } else if (status === 'CHANNEL_ERROR' || status === 'TIMED_OUT') {
+        clearTimeout(timeout);
+        reject(new Error('Channel status: ' + status));
+      }
+    });
+  });
+
+  console.log('  Channel subscribe:', result);
+
+  // Test 4: Try sending a broadcast
+  console.log('\nTest 4: Broadcast test...');
+  const sendResult = await channel.send({
+    type: 'broadcast',
+    event: 'test',
+    payload: { msg: 'hello from diagnostic' },
+  });
+  console.log('  Broadcast result:', sendResult);
+
+  supabase.removeChannel(channel);
+} catch (e) {
+  console.log('  Channel FAIL:', e.message);
+}
+
+console.log('\n=== Diagnostic complete ===');
+process.exit(0);

package/test-realtime2.mjs

@@ -0,0 +1,43 @@
+import { createClient } from '@supabase/supabase-js';
+
+const SUPABASE_URL = 'https://hbdrhdeqyioxkzmoxnjp.supabase.co';
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImhiZHJoZGVxeWlveGt6bW94bmpwIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzUxMzY4MTYsImV4cCI6MjA5MDcxMjgxNn0.BDKzJt4XQ1yS9eIoO0dp2Mx7flxU2eEwxfD8kAIlw_w';
+
+console.log('=== Realtime Deep Diagnostic ===\n');
+
+const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
+
+// Test A: Simple broadcast channel
+console.log('Test A: Broadcast-only channel...');
+const chA = supabase.channel('test-broadcast-only');
+chA.subscribe((status, err) => {
+  console.log('  [A] status:', status, err ? 'error: ' + err.message : '');
+});
+
+// Test B: Postgres Changes channel
+console.log('Test B: Postgres Changes channel...');
+const chB = supabase.channel('test-db-changes')
+  .on('postgres_changes', { event: 'INSERT', schema: 'public', table: 'team_messages' }, (payload) => {
+    console.log('  [B] DB change:', payload);
+  });
+chB.subscribe((status, err) => {
+  console.log('  [B] status:', status, err ? 'error: ' + err.message : '');
+});
+
+// Test C: Presence channel
+console.log('Test C: Presence channel...');
+const chC = supabase.channel('test-presence');
+chC.subscribe(async (status, err) => {
+  console.log('  [C] status:', status, err ? 'error: ' + err.message : '');
+  if (status === 'SUBSCRIBED') {
+    await chC.track({ user: 'diagnostic-test' });
+    console.log('  [C] presence tracked!');
+  }
+});
+
+console.log('\nWaiting 25 seconds...\n');
+await new Promise(resolve => setTimeout(resolve, 25000));
+
+supabase.removeAllChannels();
+console.log('\n=== Done ===');
+process.exit(0);

package/test-realtime3.mjs

@@ -0,0 +1,73 @@
+import { createClient } from '@supabase/supabase-js';
+
+const SUPABASE_URL = 'https://hbdrhdeqyioxkzmoxnjp.supabase.co';
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImhiZHJoZGVxeWlveGt6bW94bmpwIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzUxMzY4MTYsImV4cCI6MjA5MDcxMjgxNn0.BDKzJt4XQ1yS9eIoO0dp2Mx7flxU2eEwxfD8kAIlw_w';
+
+console.log('=== Realtime Fix Attempts ===\n');
+
+// Attempt 1: With explicit timeout and transport config
+console.log('Attempt 1: Explicit realtime config...');
+const supabase1 = createClient(SUPABASE_URL, SUPABASE_ANON_KEY, {
+  realtime: {
+    timeout: 30000,
+    heartbeatIntervalMs: 15000,
+  },
+});
+
+const ch1 = supabase1.channel('fix-test-1');
+const result1 = await new Promise((resolve) => {
+  const t = setTimeout(() => resolve('TIMEOUT'), 15000);
+  ch1.subscribe((status) => {
+    console.log('  [1] status:', status);
+    if (status === 'SUBSCRIBED') { clearTimeout(t); resolve('OK'); }
+    if (status === 'TIMED_OUT' || status === 'CHANNEL_ERROR') { clearTimeout(t); resolve(status); }
+  });
+});
+console.log('  [1] result:', result1);
+supabase1.removeAllChannels();
+
+// Attempt 2: With custom WebSocket URL
+console.log('\nAttempt 2: Custom realtime URL with wss://...');
+const supabase2 = createClient(SUPABASE_URL, SUPABASE_ANON_KEY, {
+  realtime: {
+    url: 'wss://hbdrhdeqyioxkzmoxnjp.supabase.co/realtime/v1',
+  },
+});
+
+const ch2 = supabase2.channel('fix-test-2');
+const result2 = await new Promise((resolve) => {
+  const t = setTimeout(() => resolve('TIMEOUT'), 15000);
+  ch2.subscribe((status) => {
+    console.log('  [2] status:', status);
+    if (status === 'SUBSCRIBED') { clearTimeout(t); resolve('OK'); }
+    if (status === 'TIMED_OUT' || status === 'CHANNEL_ERROR') { clearTimeout(t); resolve(status); }
+  });
+});
+console.log('  [2] result:', result2);
+supabase2.removeAllChannels();
+
+// Attempt 3: Connect then subscribe
+console.log('\nAttempt 3: Manual connect first...');
+const supabase3 = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
+// Force connect the realtime client
+supabase3.realtime.setAuth(SUPABASE_ANON_KEY);
+supabase3.realtime.connect();
+
+// Wait for socket to open
+await new Promise(resolve => setTimeout(resolve, 3000));
+console.log('  Socket state:', supabase3.realtime.connectionState?.() ?? 'unknown');
+
+const ch3 = supabase3.channel('fix-test-3');
+const result3 = await new Promise((resolve) => {
+  const t = setTimeout(() => resolve('TIMEOUT'), 15000);
+  ch3.subscribe((status) => {
+    console.log('  [3] status:', status);
+    if (status === 'SUBSCRIBED') { clearTimeout(t); resolve('OK'); }
+    if (status === 'TIMED_OUT' || status === 'CHANNEL_ERROR') { clearTimeout(t); resolve(status); }
+  });
+});
+console.log('  [3] result:', result3);
+supabase3.removeAllChannels();
+
+console.log('\n=== Done ===');
+process.exit(0);