agentmesh-ai 0.1.0

package/dist/mcp/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * AgentHub MCP Server entry point.
+ *
+ * This runs as a stdio MCP server, exposing shared memory tools
+ * to AI coding tools like Claude Code and Cursor.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerMemoryTools } from './memory-tools.js';
+import { registerConversationTools } from './conversation-tools.js';
+import { registerResources } from './resources.js';
+import { findAgentHubDir } from '../utils/git.js';
+import { ConversationClient } from '../conversation/client.js';
+import { readHubConfig } from '../memory/reader.js';
+async function main() {
+    const server = new McpServer({
+        name: 'AgentHub',
+        version: '0.1.0',
+    });
+    // Resolve .agenthub directory from current working directory
+    const cwd = process.cwd();
+    let agentHubDir = findAgentHubDir(cwd);
+    // Read agent identity from environment variables (set during setup)
+    const agentId = process.env.AGENTHUB_AGENT_ID ?? 'default-agent';
+    const getDir = () => {
+        if (!agentHubDir) {
+            // Try again in case it was created after MCP started
+            agentHubDir = findAgentHubDir(cwd);
+            if (!agentHubDir) {
+                throw new Error('No .agenthub/ directory found. Run "npx agenthub init" first.');
+            }
+        }
+        return agentHubDir;
+    };
+    const getAgentId = () => agentId;
+    // Try to connect to conversation space if available
+    let conversationClient = null;
+    const serverUrl = process.env.AGENTHUB_SERVER_URL;
+    if (serverUrl) {
+        try {
+            const hub = await readHubConfig(getDir());
+            const agentInfo = hub?.agents.find(a => a.id === agentId);
+            conversationClient = new ConversationClient({
+                url: serverUrl,
+                agent: {
+                    id: agentId,
+                    displayName: agentInfo?.display_name ?? agentId,
+                    role: agentInfo?.role ?? 'developer',
+                    tool: agentInfo?.tool ?? 'unknown',
+                },
+                key: process.env.AGENTHUB_SERVER_KEY,
+            });
+            await conversationClient.connect();
+            // Auto-sync local memory to conversation space
+            try {
+                const { readAgentMemory } = await import('../memory/reader.js');
+                const { join } = await import('node:path');
+                const myMemory = await readAgentMemory(join(getDir(), 'memory', `${agentId}.yaml`));
+                if (myMemory && myMemory.entries.length > 0) {
+                    conversationClient.syncMemory(myMemory.entries);
+                }
+            }
+            catch {
+                // Memory sync is best-effort
+            }
+        }
+        catch {
+            // Conversation space not available — memory tools still work fine
+            conversationClient = null;
+        }
+    }
+    const getClient = () => conversationClient;
+    // Register tools and resources
+    registerMemoryTools(server, getDir, getAgentId, getClient);
+    registerConversationTools(server, getDir, getAgentId, getClient);
+    registerResources(server, getDir);
+    // Connect via stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('AgentHub MCP server failed to start:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,6DAA6D;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEvC,oEAAoE;IACpE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,eAAe,CAAC;IAEjE,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,qDAAqD;YACrD,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;IAEjC,oDAAoD;IACpD,IAAI,kBAAkB,GAA8B,IAAI,CAAC;IACzD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAElD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;YAE1D,kBAAkB,GAAG,IAAI,kBAAkB,CAAC;gBAC1C,GAAG,EAAE,SAAS;gBACd,KAAK,EAAE;oBACL,EAAE,EAAE,OAAO;oBACX,WAAW,EAAE,SAAS,EAAE,YAAY,IAAI,OAAO;oBAC/C,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,WAAW;oBACpC,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,SAAS;iBACnC;gBACD,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;aACrC,CAAC,CAAC;YAEH,MAAM,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAEnC,+CAA+C;YAC/C,IAAI,CAAC;gBACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;gBAChE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC3C,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC,CAAC;gBACpF,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5C,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;YAClE,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC;IAE3C,+BAA+B;IAC/B,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC3D,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACjE,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/memory-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ConversationClient } from '../conversation/client.js';
+export declare function registerMemoryTools(server: McpServer, getAgentHubDir: () => string, getAgentId: () => string, getClient?: () => ConversationClient | null): void;
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/mcp/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/memory-tools.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,MAAM,EAC5B,UAAU,EAAE,MAAM,MAAM,EACxB,SAAS,CAAC,EAAE,MAAM,kBAAkB,GAAG,IAAI,QAkO5C"}

package/dist/mcp/memory-tools.js

@@ -0,0 +1,195 @@
+/**
+ * MCP tool definitions for shared memory operations.
+ */
+import { z } from 'zod';
+import { readAllAgentMemories, readHubConfig } from '../memory/reader.js';
+import { writeMemoryEntry } from '../memory/writer.js';
+import { searchMemories } from '../memory/searcher.js';
+import { mergeMemories, formatMergedMemories } from '../memory/merge-view.js';
+export function registerMemoryTools(server, getAgentHubDir, getAgentId, getClient) {
+    server.tool('read_memory', `Read the project's shared memory — all knowledge recorded by all AI agents working on this project.
+
+Call this tool when you start a new task or need to understand the project context.
+It returns everything the team knows: tech stack, APIs, conventions, decisions, gotchas.`, {
+        tags: z.array(z.string()).optional().describe('Filter by tags (e.g. ["api", "user-service"])'),
+        agent: z.string().optional().describe('Only read one specific agent\'s memory'),
+        limit: z.number().optional().describe('Max entries to return (default 50). Use search_memory for targeted lookups.'),
+    }, async ({ tags, agent, limit }) => {
+        const dir = getAgentHubDir();
+        const memories = await readAllAgentMemories(dir);
+        // Merge in synced memories from conversation space (may be newer than local Git files)
+        const client = getClient?.();
+        if (client?.isConnected) {
+            for (const synced of client.syncedMemories) {
+                const localExists = memories.some(m => m.agent === synced.agent.id);
+                if (!localExists) {
+                    const agentMemory = {
+                        agent: synced.agent.id,
+                        role: synced.agent.role,
+                        tool: synced.agent.tool,
+                        last_active: new Date().toISOString(),
+                        entries: synced.entries,
+                    };
+                    memories.push(agentMemory);
+                    // Persist to local disk so it survives server restart
+                    try {
+                        const { writeYaml } = await import('../utils/yaml.js');
+                        const { join } = await import('node:path');
+                        await writeYaml(join(dir, 'memory', `${synced.agent.id}.yaml`), agentMemory);
+                    }
+                    catch {
+                        // Best-effort persistence
+                    }
+                }
+            }
+        }
+        // mergeMemories without limit to get total count, then with limit
+        const allMerged = mergeMemories(memories, { tags, agent });
+        const totalCount = allMerged.length;
+        const limited = mergeMemories(memories, { tags, agent, limit: limit ?? 50 });
+        let text = formatMergedMemories(limited, totalCount);
+        // Check for active discussions that need attention
+        if (client?.isConnected) {
+            const topics = client.topics;
+            const myId = getAgentId();
+            // Find topics where we haven't spoken yet
+            const pendingTopics = [];
+            for (const topic of topics) {
+                const messages = client.getTopicMessages(topic);
+                const iSpoke = messages.some(m => m.from.id === myId);
+                if (!iSpoke && messages.length > 0) {
+                    pendingTopics.push(topic);
+                }
+            }
+            if (pendingTopics.length > 0) {
+                text += '\n\n⚠️ ACTIVE DISCUSSIONS WAITING FOR YOUR INPUT:\n';
+                for (const topic of pendingTopics) {
+                    const messages = client.getTopicMessages(topic);
+                    const lastMsg = messages[messages.length - 1];
+                    text += `  → "${topic}" — last message from ${lastMsg.from.displayName}: "${lastMsg.content.slice(0, 80)}..."\n`;
+                }
+                text += '\nUse the discuss tool to join these discussions.\n';
+            }
+            // Check for pending decisions that need this human's vote
+            const pendingDecisions = client.pendingDecisions;
+            if (pendingDecisions.length > 0) {
+                text += '\n\n🗳️ PENDING DECISIONS REQUIRING YOUR HUMAN\'S VOTE:\n';
+                for (const d of pendingDecisions) {
+                    text += `  → "${d.topic}" — proposed by ${d.proposedBy.displayName}`;
+                    if (d.recommendation)
+                        text += ` (recommends: ${d.recommendation})`;
+                    text += `\n    Options: ${d.options.map(o => o.label).join(', ')}`;
+                    text += `\n    Decision ID: ${d.decisionId}\n`;
+                }
+                text += '\nUse the vote_on_decision tool to ask your human to vote.\n';
+            }
+            // Check for meetings waiting for this agent
+            const meetings = client.meetings;
+            const myMeetings = meetings.filter(m => m.status === 'waiting' && m.missingAgents.includes(myId));
+            if (myMeetings.length > 0) {
+                text += '\n\n📢 MEETINGS WAITING FOR YOU:\n';
+                for (const m of myMeetings) {
+                    text += `  → "${m.topic}" — started by ${m.startedBy}\n`;
+                    text += `    Present: ${m.presentAgents.join(', ')}\n`;
+                    text += `    Missing: ${m.missingAgents.join(', ')}\n`;
+                }
+                text += '\nYou are already connected — the meeting will start automatically.\n';
+            }
+            const activeMeetings = meetings.filter(m => m.status === 'active');
+            if (activeMeetings.length > 0) {
+                text += '\n\n🟢 ACTIVE MEETINGS:\n';
+                for (const m of activeMeetings) {
+                    text += `  → "${m.topic}" — all members present. Use discuss tool to participate.\n`;
+                }
+            }
+        }
+        return { content: [{ type: 'text', text }] };
+    });
+    server.tool('write_memory', `Record important project knowledge to shared memory so other AI agents can benefit.
+
+WHEN TO USE — record after you:
+✅ Create or modify API endpoints (paths, params, return types)
+✅ Define data models (fields, types, constraints)
+✅ Make a tech decision and why (e.g. chose PostgreSQL for transactions)
+✅ Discover a gotcha or fix a tricky bug (so others don't repeat it)
+✅ Use an important dependency or library
+✅ Establish a convention that affects others (naming, error handling)
+✅ Complete a significant module or feature
+
+WHEN NOT TO USE — don't record:
+❌ Implementation details visible in the code itself
+❌ Temporary debug info or experiments
+❌ Info only relevant to yourself, not the team
+❌ Things already in README or code comments
+
+FORMAT: Be concise. Lead with the most important info.
+Think: "What would a new AI agent need to know about this?"
+
+HUMAN-IN-THE-LOOP — use the right status level:
+  auto    → Routine facts (APIs, models, gotchas). Record directly, no need to ask.
+  proposal → Important decisions that affect the team (tech stack, architecture, conventions).
+             Show the user what you plan to record and ask for confirmation first.
+             Other agents will see it marked as 📋 proposal.
+  protected → Only after team-wide vote/confirmation via escalate_to_human.
+              Becomes a hard constraint that no other agent can override.`, {
+        topic: z.string().describe('Short title for this knowledge (e.g. "User Service API", "Database Choice")'),
+        content: z.string().describe('The knowledge to record — concise, structured, important info first'),
+        tags: z.array(z.string()).describe('Categorization tags (e.g. ["api", "user-service"], ["convention", "naming"])'),
+        decided_with: z.array(z.string()).optional().describe('Other agent IDs who participated in this decision'),
+        status: z.enum(['auto', 'proposal', 'protected']).optional().describe('Memory status level:\n' +
+            '  auto (default) — routine knowledge, recorded automatically\n' +
+            '  proposal — important decision that needs team discussion/confirmation\n' +
+            '  protected — confirmed team consensus, cannot be overwritten by others'),
+        owner: z.string().optional().describe('Agent ID who owns this protected entry. Defaults to you.'),
+    }, async ({ topic, content, tags, decided_with, status, owner }) => {
+        const dir = getAgentHubDir();
+        const agentId = getAgentId();
+        const hub = await readHubConfig(dir);
+        const agentInfo = hub?.agents.find(a => a.id === agentId);
+        const result = await writeMemoryEntry(dir, agentId, agentInfo?.role ?? 'developer', agentInfo?.tool ?? 'unknown', { topic, content, tags, decided_with, status, owner });
+        // Auto-sync to conversation space after successful write
+        if (result.success && getClient) {
+            const syncClient = getClient();
+            if (syncClient?.isConnected) {
+                try {
+                    const { readAgentMemory } = await import('../memory/reader.js');
+                    const { join } = await import('node:path');
+                    const myMemory = await readAgentMemory(join(dir, 'memory', `${agentId}.yaml`));
+                    if (myMemory) {
+                        syncClient.syncMemory(myMemory.entries);
+                    }
+                }
+                catch {
+                    // Sync is best-effort
+                }
+            }
+        }
+        if (result.blocked) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `⚠️ Blocked: ${result.reason}`
+                    }]
+            };
+        }
+        const statusLabel = status === 'protected' ? ' 🔒' : status === 'proposal' ? ' 📋' : '';
+        let msg = `✅ Recorded to shared memory: "${topic}" [${tags.join(', ')}]${statusLabel}`;
+        if (result.warnings && result.warnings.length > 0) {
+            msg += `\n\n⚠️ Warnings:\n${result.warnings.join('\n')}`;
+        }
+        return {
+            content: [{ type: 'text', text: msg }]
+        };
+    });
+    server.tool('search_memory', `Search the shared memory for specific information.
+Use this when you need to find something specific, like "how is the user API defined" or "what database are we using".`, {
+        query: z.string().describe('Search keywords (e.g. "user api", "database", "authentication")'),
+    }, async ({ query }) => {
+        const dir = getAgentHubDir();
+        const memories = await readAllAgentMemories(dir);
+        const results = searchMemories(memories, query);
+        const text = formatMergedMemories(results);
+        return { content: [{ type: 'text', text }] };
+    });
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/mcp/memory-tools.js.map

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

package/dist/mcp/resources.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerResources(server: McpServer, getAgentHubDir: () => string): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,MAAM,QA4BhF"}

package/dist/mcp/resources.js

@@ -0,0 +1,23 @@
+/**
+ * MCP resource definitions for read-only access to shared memory.
+ */
+import { readAllAgentMemories, readHubConfig } from '../memory/reader.js';
+import { mergeMemories, formatMergedMemories } from '../memory/merge-view.js';
+export function registerResources(server, getAgentHubDir) {
+    server.resource('memory-all', 'agenthub://memory', { description: 'Complete shared memory — all knowledge from all agents', mimeType: 'text/plain' }, async () => {
+        const dir = getAgentHubDir();
+        const memories = await readAllAgentMemories(dir);
+        const merged = mergeMemories(memories);
+        const text = formatMergedMemories(merged);
+        return { contents: [{ uri: 'agenthub://memory', text, mimeType: 'text/plain' }] };
+    });
+    server.resource('hub-config', 'agenthub://hub', { description: 'Project configuration and registered agents', mimeType: 'text/plain' }, async () => {
+        const dir = getAgentHubDir();
+        const hub = await readHubConfig(dir);
+        const text = hub
+            ? `Project: ${hub.project}\nVersion: ${hub.version}\nAgents:\n${hub.agents.map(a => `  - ${a.display_name} (${a.role}) using ${a.tool}`).join('\n')}`
+            : 'No hub.yaml found.';
+        return { contents: [{ uri: 'agenthub://hub', text, mimeType: 'text/plain' }] };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG9E,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,cAA4B;IAE/E,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ,mBAAmB,EACnB,EAAE,WAAW,EAAE,wDAAwD,EAAE,QAAQ,EAAE,YAAY,EAAE,EACjG,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACpF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,YAAY,EACZ,gBAAgB,EAChB,EAAE,WAAW,EAAE,6CAA6C,EAAE,QAAQ,EAAE,YAAY,EAAE,EACtF,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,GAAG;YACd,CAAC,CAAC,YAAY,GAAG,CAAC,OAAO,cAAc,GAAG,CAAC,OAAO,cAAc,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACrJ,CAAC,CAAC,oBAAoB,CAAC;QACzB,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACjF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/memory/index.d.ts

@@ -0,0 +1,7 @@
+export { readHubConfig, readAgentMemory, readAllAgentMemories } from './reader.js';
+export { scanForSecrets } from './secret-scanner.js';
+export { writeMemoryEntry } from './writer.js';
+export { searchMemories } from './searcher.js';
+export { mergeMemories, formatMergedMemories } from './merge-view.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtE,mBAAmB,YAAY,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,6 @@
+export { readHubConfig, readAgentMemory, readAllAgentMemories } from './reader.js';
+export { scanForSecrets } from './secret-scanner.js';
+export { writeMemoryEntry } from './writer.js';
+export { searchMemories } from './searcher.js';
+export { mergeMemories, formatMergedMemories } from './merge-view.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/memory/merge-view.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Merge multiple agent memory files into a unified view.
+ */
+import type { AgentMemoryFile, MergedMemoryEntry, ReadMemoryOptions } from './types.js';
+/** Merge all agent memories into a single sorted list, with optional filtering. */
+export declare function mergeMemories(memories: AgentMemoryFile[], options?: ReadMemoryOptions): MergedMemoryEntry[];
+/** Format merged entries as a human-readable string for AI consumption. */
+export declare function formatMergedMemories(entries: MergedMemoryEntry[], totalBeforeLimit?: number): string;
+//# sourceMappingURL=merge-view.d.ts.map

package/dist/memory/merge-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-view.d.ts","sourceRoot":"","sources":["../../src/memory/merge-view.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAExF,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,iBAAiB,EAAE,CAyCrB;AAsBD,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAmCpG"}

package/dist/memory/merge-view.js

@@ -0,0 +1,88 @@
+/** Merge all agent memories into a single sorted list, with optional filtering. */
+export function mergeMemories(memories, options) {
+    let entries = [];
+    for (const memory of memories) {
+        // Filter by agent if specified
+        if (options?.agent && memory.agent !== options.agent) {
+            continue;
+        }
+        for (const entry of memory.entries) {
+            // Filter by tags if specified
+            if (options?.tags && options.tags.length > 0) {
+                const hasMatchingTag = options.tags.some(tag => entry.tags.includes(tag));
+                if (!hasMatchingTag)
+                    continue;
+            }
+            entries.push({
+                ...entry,
+                agent: memory.agent,
+                agent_role: memory.role,
+            });
+        }
+    }
+    // Sort by relevance: status weight + recency
+    const now = Date.now();
+    const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
+    entries.sort((a, b) => {
+        const scoreA = entryScore(a, now, sevenDaysMs);
+        const scoreB = entryScore(b, now, sevenDaysMs);
+        return scoreB - scoreA;
+    });
+    // Apply limit
+    const limit = options?.limit ?? 50;
+    if (entries.length > limit) {
+        entries = entries.slice(0, limit);
+    }
+    return entries;
+}
+function entryScore(entry, now, recentWindow) {
+    let score = 0;
+    // Status weight: protected > proposal > auto
+    const status = entry.status ?? (entry.protected ? 'protected' : 'auto');
+    if (status === 'protected')
+        score += 100;
+    else if (status === 'proposal')
+        score += 50;
+    // Recency weight: entries within last 7 days get a boost
+    const entryTime = new Date(entry.date).getTime();
+    if (now - entryTime < recentWindow) {
+        score += 30;
+    }
+    // Tie-break by date (newest first)
+    score += entryTime / 1e15; // tiny fractional component for ordering
+    return score;
+}
+/** Format merged entries as a human-readable string for AI consumption. */
+export function formatMergedMemories(entries, totalBeforeLimit) {
+    if (entries.length === 0) {
+        return 'No shared memories found.';
+    }
+    const lines = [];
+    lines.push(`# Shared Memory (${entries.length} entries)\n`);
+    for (const entry of entries) {
+        const effectiveStatus = entry.status ?? (entry.protected ? 'protected' : 'auto');
+        const badge = effectiveStatus === 'protected' ? ' 🔒' : effectiveStatus === 'proposal' ? ' 📋' : '';
+        lines.push(`## ${entry.topic}${badge}`);
+        lines.push(`Agent: ${entry.agent} (${entry.agent_role})`);
+        lines.push(`Date: ${entry.date}`);
+        if (effectiveStatus !== 'auto') {
+            lines.push(`Status: ${effectiveStatus}${entry.owner ? ` (owner: ${entry.owner})` : ''}`);
+        }
+        if (entry.tags.length > 0) {
+            lines.push(`Tags: ${entry.tags.join(', ')}`);
+        }
+        if (entry.decided_with && entry.decided_with.length > 0) {
+            lines.push(`Decided with: ${entry.decided_with.join(', ')}`);
+        }
+        lines.push('');
+        lines.push(entry.content.trim());
+        lines.push('');
+        lines.push('---');
+        lines.push('');
+    }
+    if (totalBeforeLimit && totalBeforeLimit > entries.length) {
+        lines.push(`(Showing ${entries.length} of ${totalBeforeLimit} entries. Use search_memory for specific lookups.)\n`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=merge-view.js.map

package/dist/memory/merge-view.js.map

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

package/dist/memory/reader.d.ts

@@ -0,0 +1,8 @@
+import type { AgentMemoryFile, HubConfig } from './types.js';
+/** Read the hub.yaml config file. */
+export declare function readHubConfig(agentHubDir: string): Promise<HubConfig | null>;
+/** Read a single agent's memory file. Returns null if invalid or missing. */
+export declare function readAgentMemory(filePath: string): Promise<AgentMemoryFile | null>;
+/** Read all agent memory files from the memory directory. */
+export declare function readAllAgentMemories(agentHubDir: string): Promise<AgentMemoryFile[]>;
+//# sourceMappingURL=reader.d.ts.map

package/dist/memory/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/memory/reader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7D,qCAAqC;AACrC,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAUlF;AAED,6EAA6E;AAC7E,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAWvF;AAED,6DAA6D;AAC7D,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAqB1F"}

package/dist/memory/reader.js

@@ -0,0 +1,53 @@
+/**
+ * Memory reader - reads individual agent memory files and the hub config.
+ */
+import { join } from 'node:path';
+import { readdir } from 'node:fs/promises';
+import { readYaml } from '../utils/yaml.js';
+import { agentMemoryFileSchema, hubConfigSchema } from './schema.js';
+/** Read the hub.yaml config file. */
+export async function readHubConfig(agentHubDir) {
+    const raw = await readYaml(join(agentHubDir, 'hub.yaml'));
+    if (!raw)
+        return null;
+    const result = hubConfigSchema.safeParse(raw);
+    if (!result.success) {
+        console.error('Warning: hub.yaml has invalid format, using defaults');
+        return null;
+    }
+    return result.data;
+}
+/** Read a single agent's memory file. Returns null if invalid or missing. */
+export async function readAgentMemory(filePath) {
+    const raw = await readYaml(filePath);
+    if (!raw)
+        return null;
+    const result = agentMemoryFileSchema.safeParse(raw);
+    if (!result.success) {
+        // Tolerate parse errors - skip this file rather than crash
+        console.error(`Warning: ${filePath} has invalid format, skipping`);
+        return null;
+    }
+    return result.data;
+}
+/** Read all agent memory files from the memory directory. */
+export async function readAllAgentMemories(agentHubDir) {
+    const memoryDir = join(agentHubDir, 'memory');
+    let files;
+    try {
+        files = await readdir(memoryDir);
+    }
+    catch {
+        return [];
+    }
+    const yamlFiles = files.filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+    const memories = [];
+    for (const file of yamlFiles) {
+        const memory = await readAgentMemory(join(memoryDir, file));
+        if (memory) {
+            memories.push(memory);
+        }
+    }
+    return memories;
+}
+//# sourceMappingURL=reader.js.map

package/dist/memory/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../src/memory/reader.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGrE,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAU,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAU,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,2DAA2D;QAC3D,OAAO,CAAC,KAAK,CAAC,YAAY,QAAQ,+BAA+B,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE9C,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/E,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}