society-protocol 1.0.0

package/dist/bridges/a2a-bridge.js

@@ -0,0 +1,337 @@
+/**
+ * Society Protocol — A2A (Agent-to-Agent) Bridge
+ *
+ * Implements Google's Agent-to-Agent protocol bridge,
+ * enabling interoperability between A2A-compliant agents
+ * and Society Protocol's P2P network.
+ *
+ * A2A spec: Agent Card, Tasks, Streaming, Push Notifications
+ *
+ * - Inbound: A2A task requests → Society CoC chains
+ * - Outbound: Society chains → A2A task responses
+ */
+import { EventEmitter } from 'events';
+import { ulid } from 'ulid';
+// ─── A2A Bridge ─────────────────────────────────────────────────
+export class A2ABridge extends EventEmitter {
+    identity;
+    storage;
+    rooms;
+    coc;
+    knowledge;
+    defaultRoom;
+    exposedSkills;
+    baseUrl;
+    taskMappings = new Map();
+    constructor(config) {
+        super();
+        this.identity = config.identity;
+        this.storage = config.storage;
+        this.rooms = config.rooms;
+        this.coc = config.coc;
+        this.knowledge = config.knowledge;
+        this.defaultRoom = config.defaultRoom;
+        this.exposedSkills = config.exposedSkills ?? [];
+        this.baseUrl = config.baseUrl ?? 'http://localhost:8080';
+        this.setupCocListeners();
+    }
+    // ─── Agent Card ──────────────────────────────────────────────
+    getAgentCard() {
+        return {
+            name: this.identity.displayName,
+            description: 'Society Protocol agent — P2P multi-agent collaboration',
+            url: this.baseUrl,
+            version: '1.0.0',
+            capabilities: {
+                streaming: true,
+                pushNotifications: false,
+                stateTransitionHistory: true,
+            },
+            skills: this.exposedSkills.length > 0
+                ? this.exposedSkills
+                : this.getDefaultSkills(),
+            defaultInputModes: ['text/plain', 'application/json'],
+            defaultOutputModes: ['text/plain', 'application/json'],
+        };
+    }
+    getDefaultSkills() {
+        return [
+            {
+                id: 'collaborate',
+                name: 'Multi-Agent Collaboration',
+                description: 'Coordinate complex tasks across a P2P network of AI agents',
+                tags: ['collaboration', 'p2p', 'multi-agent'],
+            },
+            {
+                id: 'research',
+                name: 'Distributed Research',
+                description: 'Conduct research using a swarm of specialized agents',
+                tags: ['research', 'swarm', 'knowledge'],
+            },
+            {
+                id: 'knowledge_query',
+                name: 'Knowledge Pool Query',
+                description: 'Search and retrieve from a distributed CRDT knowledge base',
+                tags: ['knowledge', 'search', 'crdt'],
+            },
+        ];
+    }
+    // ─── Task Send (Inbound) ─────────────────────────────────────
+    async handleTaskSend(params) {
+        const sessionId = params.sessionId || ulid();
+        // Extract text from the message
+        const text = params.message.parts
+            .filter((p) => p.type === 'text')
+            .map(p => p.text)
+            .join('\n');
+        if (!text) {
+            return this.createErrorTask(params.id, sessionId, 'No text content in message');
+        }
+        // Create a CoC chain from the A2A task
+        const roomId = params.metadata?.room_id || this.defaultRoom;
+        const chainId = await this.coc.openChain(roomId, text, {
+            priority: 'normal',
+        });
+        // Create task mapping
+        const mapping = {
+            a2aTaskId: params.id,
+            chainId,
+            roomId,
+            sessionId,
+            state: 'working',
+            history: [params.message],
+            artifacts: [],
+            createdAt: Date.now(),
+        };
+        this.taskMappings.set(params.id, mapping);
+        this.emit('a2a:task:created', params.id, chainId);
+        return {
+            id: params.id,
+            sessionId,
+            status: {
+                state: 'working',
+                message: {
+                    role: 'agent',
+                    parts: [{
+                            type: 'text',
+                            text: `Task accepted. Chain ${chainId} created for: ${text.slice(0, 100)}`,
+                        }],
+                },
+            },
+            history: mapping.history,
+            metadata: { chainId, roomId },
+        };
+    }
+    // ─── Task Get ────────────────────────────────────────────────
+    getTask(taskId) {
+        const mapping = this.taskMappings.get(taskId);
+        if (!mapping)
+            return undefined;
+        // Sync state from CoC
+        this.syncTaskState(mapping);
+        return {
+            id: mapping.a2aTaskId,
+            sessionId: mapping.sessionId,
+            status: {
+                state: mapping.state,
+                message: this.getStatusMessage(mapping),
+            },
+            history: mapping.history,
+            artifacts: mapping.artifacts,
+            metadata: { chainId: mapping.chainId, roomId: mapping.roomId },
+        };
+    }
+    // ─── Task Cancel ─────────────────────────────────────────────
+    async cancelTask(taskId) {
+        const mapping = this.taskMappings.get(taskId);
+        if (!mapping) {
+            return this.createErrorTask(taskId, '', 'Task not found');
+        }
+        await this.coc.closeChain(mapping.roomId, mapping.chainId, 'cancelled', 'Cancelled via A2A');
+        mapping.state = 'canceled';
+        return {
+            id: taskId,
+            sessionId: mapping.sessionId,
+            status: {
+                state: 'canceled',
+                message: {
+                    role: 'agent',
+                    parts: [{ type: 'text', text: 'Task cancelled.' }],
+                },
+            },
+        };
+    }
+    // ─── JSON-RPC Handler ────────────────────────────────────────
+    async handleJsonRpc(request) {
+        const { id, method, params } = request;
+        try {
+            switch (method) {
+                case 'tasks/send':
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result: await this.handleTaskSend(params),
+                    };
+                case 'tasks/get':
+                    const task = this.getTask(params?.id);
+                    if (!task) {
+                        return {
+                            jsonrpc: '2.0',
+                            id,
+                            error: { code: -32602, message: 'Task not found' },
+                        };
+                    }
+                    return { jsonrpc: '2.0', id, result: task };
+                case 'tasks/cancel':
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        result: await this.cancelTask(params?.id),
+                    };
+                case 'agent/authenticatedExtendedCard':
+                    return { jsonrpc: '2.0', id, result: this.getAgentCard() };
+                default:
+                    return {
+                        jsonrpc: '2.0',
+                        id,
+                        error: { code: -32601, message: `Method not found: ${method}` },
+                    };
+            }
+        }
+        catch (err) {
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: { code: -32603, message: err.message },
+            };
+        }
+    }
+    // ─── Outbound: Society → A2A ─────────────────────────────────
+    /**
+     * Convert a completed Society chain into an A2A task response.
+     */
+    chainToA2ATask(chainId) {
+        // Find mapping by chainId
+        let mapping;
+        for (const m of this.taskMappings.values()) {
+            if (m.chainId === chainId) {
+                mapping = m;
+                break;
+            }
+        }
+        if (!mapping)
+            return undefined;
+        this.syncTaskState(mapping);
+        return this.getTask(mapping.a2aTaskId);
+    }
+    /**
+     * Create A2A message from Society step output.
+     */
+    stepToA2AMessage(stepOutput) {
+        const parts = [{ type: 'text', text: stepOutput.memo }];
+        if (stepOutput.artifacts) {
+            for (const art of stepOutput.artifacts) {
+                if (art.content) {
+                    parts.push({
+                        type: 'data',
+                        data: { artifact_type: art.artifact_type, content: art.content },
+                    });
+                }
+            }
+        }
+        return { role: 'agent', parts };
+    }
+    // ─── Internal Helpers ────────────────────────────────────────
+    syncTaskState(mapping) {
+        const chain = this.coc.getChain(mapping.chainId);
+        if (!chain) {
+            mapping.state = 'unknown';
+            return;
+        }
+        switch (chain.status) {
+            case 'open':
+            case 'running':
+                mapping.state = 'working';
+                break;
+            case 'completed':
+                mapping.state = 'completed';
+                break;
+            case 'failed':
+                mapping.state = 'failed';
+                break;
+            default:
+                mapping.state = 'working';
+        }
+    }
+    getStatusMessage(mapping) {
+        const chain = this.coc.getChain(mapping.chainId);
+        const text = chain
+            ? `Chain ${mapping.chainId}: ${chain.status} (${chain.steps?.length || 0} steps)`
+            : `Chain ${mapping.chainId}: status unknown`;
+        return {
+            role: 'agent',
+            parts: [{ type: 'text', text }],
+        };
+    }
+    createErrorTask(taskId, sessionId, error) {
+        return {
+            id: taskId,
+            sessionId,
+            status: {
+                state: 'failed',
+                message: {
+                    role: 'agent',
+                    parts: [{ type: 'text', text: `Error: ${error}` }],
+                },
+            },
+        };
+    }
+    setupCocListeners() {
+        this.coc.on('chain:completed', (chainId) => {
+            for (const mapping of this.taskMappings.values()) {
+                if (mapping.chainId === chainId) {
+                    mapping.state = 'completed';
+                    this.emit('a2a:task:completed', mapping.a2aTaskId, chainId);
+                    break;
+                }
+            }
+        });
+        this.coc.on('step:submitted', (chainId, stepId, submission) => {
+            for (const mapping of this.taskMappings.values()) {
+                if (mapping.chainId === chainId && submission) {
+                    const message = this.stepToA2AMessage(submission);
+                    mapping.history.push(message);
+                    if (submission.artifacts) {
+                        for (const art of submission.artifacts) {
+                            mapping.artifacts.push({
+                                name: art.artifact_type || 'output',
+                                parts: [{ type: 'text', text: art.content || '' }],
+                            });
+                        }
+                    }
+                    break;
+                }
+            }
+        });
+    }
+    // ─── Stats ───────────────────────────────────────────────────
+    getStats() {
+        let completed = 0, failed = 0;
+        for (const m of this.taskMappings.values()) {
+            if (m.state === 'completed')
+                completed++;
+            if (m.state === 'failed')
+                failed++;
+        }
+        return {
+            activeTasks: this.taskMappings.size - completed - failed,
+            completedTasks: completed,
+            failedTasks: failed,
+        };
+    }
+    destroy() {
+        this.taskMappings.clear();
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=a2a-bridge.js.map

package/dist/bridges/a2a-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-bridge.js","sourceRoot":"","sources":["../../src/bridges/a2a-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAsH5B,mEAAmE;AAEnE,MAAM,OAAO,SAAU,SAAQ,YAAY;IAC/B,QAAQ,CAAW;IACnB,OAAO,CAAU;IACjB,KAAK,CAAc;IACnB,GAAG,CAAY;IACf,SAAS,CAAgB;IACzB,WAAW,CAAS;IACpB,aAAa,CAAa;IAC1B,OAAO,CAAS;IAChB,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEtD,YAAY,MAAuB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,uBAAuB,CAAC;QAEzD,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED,gEAAgE;IAEhE,YAAY;QACR,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW;YAC/B,WAAW,EAAE,wDAAwD;YACrE,GAAG,EAAE,IAAI,CAAC,OAAO;YACjB,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE;gBACV,SAAS,EAAE,IAAI;gBACf,iBAAiB,EAAE,KAAK;gBACxB,sBAAsB,EAAE,IAAI;aAC/B;YACD,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,aAAa;gBACpB,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC7B,iBAAiB,EAAE,CAAC,YAAY,EAAE,kBAAkB,CAAC;YACrD,kBAAkB,EAAE,CAAC,YAAY,EAAE,kBAAkB,CAAC;SACzD,CAAC;IACN,CAAC;IAEO,gBAAgB;QACpB,OAAO;YACH;gBACI,EAAE,EAAE,aAAa;gBACjB,IAAI,EAAE,2BAA2B;gBACjC,WAAW,EAAE,4DAA4D;gBACzE,IAAI,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,aAAa,CAAC;aAChD;YACD;gBACI,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EAAE,sDAAsD;gBACnE,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC;aAC3C;YACD;gBACI,EAAE,EAAE,iBAAiB;gBACrB,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EAAE,4DAA4D;gBACzE,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC;aACxC;SACJ,CAAC;IACN,CAAC;IAED,gEAAgE;IAEhE,KAAK,CAAC,cAAc,CAAC,MAAyB;QAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;QAE7C,gCAAgC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAClD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAChB,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;QACpF,CAAC;QAED,uCAAuC;QACvC,MAAM,MAAM,GAAI,MAAM,CAAC,QAAQ,EAAE,OAAkB,IAAI,IAAI,CAAC,WAAW,CAAC;QACxE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE;YACnD,QAAQ,EAAE,QAAQ;SACrB,CAAC,CAAC;QAEH,sBAAsB;QACtB,MAAM,OAAO,GAAgB;YACzB,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,OAAO;YACP,MAAM;YACN,SAAS;YACT,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;YACzB,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAE1C,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAElD,OAAO;YACH,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,SAAS;YACT,MAAM,EAAE;gBACJ,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,CAAC;4BACJ,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,wBAAwB,OAAO,iBAAiB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;yBAC7E,CAAC;iBACL;aACJ;YACD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;SAChC,CAAC;IACN,CAAC;IAED,gEAAgE;IAEhE,OAAO,CAAC,MAAc;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,sBAAsB;QACtB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAE5B,OAAO;YACH,EAAE,EAAE,OAAO,CAAC,SAAS;YACrB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE;gBACJ,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;aAC1C;YACD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;SACjE,CAAC;IACN,CAAC;IAED,gEAAgE;IAEhE,KAAK,CAAC,UAAU,CAAC,MAAc;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CACrB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,OAAO,EACf,WAAW,EACX,mBAAmB,CACtB,CAAC;QAEF,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC;QAE3B,OAAO;YACH,EAAE,EAAE,MAAM;YACV,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE;gBACJ,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;iBACrD;aACJ;SACJ,CAAC;IACN,CAAC;IAED,gEAAgE;IAEhE,KAAK,CAAC,aAAa,CAAC,OAKnB;QAMG,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAEvC,IAAI,CAAC;YACD,QAAQ,MAAM,EAAE,CAAC;gBACb,KAAK,YAAY;oBACb,OAAO;wBACH,OAAO,EAAE,KAAK;wBACd,EAAE;wBACF,MAAM,EAAE,MAAM,IAAI,CAAC,cAAc,CAAC,MAAsC,CAAC;qBAC5E,CAAC;gBACN,KAAK,WAAW;oBACZ,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAY,CAAC,CAAC;oBAChD,IAAI,CAAC,IAAI,EAAE,CAAC;wBACR,OAAO;4BACH,OAAO,EAAE,KAAK;4BACd,EAAE;4BACF,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE;yBACrD,CAAC;oBACN,CAAC;oBACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBAChD,KAAK,cAAc;oBACf,OAAO;wBACH,OAAO,EAAE,KAAK;wBACd,EAAE;wBACF,MAAM,EAAE,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAY,CAAC;qBACtD,CAAC;gBACN,KAAK,iCAAiC;oBAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;gBAC/D;oBACI,OAAO;wBACH,OAAO,EAAE,KAAK;wBACd,EAAE;wBACF,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,qBAAqB,MAAM,EAAE,EAAE;qBAClE,CAAC;YACV,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAG,GAAa,CAAC,OAAO,EAAE;aAC3D,CAAC;QACN,CAAC;IACL,CAAC;IAED,gEAAgE;IAEhE;;OAEG;IACH,cAAc,CAAC,OAAe;QAC1B,0BAA0B;QAC1B,IAAI,OAAgC,CAAC;QACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBAAC,OAAO,GAAG,CAAC,CAAC;gBAAC,MAAM;YAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,UAGhB;QACG,MAAM,KAAK,GAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAEnE,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;gBACrC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBACd,KAAK,CAAC,IAAI,CAAC;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;qBACnE,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,gEAAgE;IAExD,aAAa,CAAC,OAAoB;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;YAC1B,OAAO;QACX,CAAC;QAED,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC;YACZ,KAAK,SAAS;gBACV,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;gBAC1B,MAAM;YACV,KAAK,WAAW;gBACZ,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;gBAC5B,MAAM;YACV,KAAK,QAAQ;gBACT,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;gBACzB,MAAM;YACV;gBACI,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;QAClC,CAAC;IACL,CAAC;IAEO,gBAAgB,CAAC,OAAoB;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK;YACd,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,SAAS;YACjF,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,kBAAkB,CAAC;QAEjD,OAAO;YACH,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClC,CAAC;IACN,CAAC;IAEO,eAAe,CAAC,MAAc,EAAE,SAAiB,EAAE,KAAa;QACpE,OAAO;YACH,EAAE,EAAE,MAAM;YACV,SAAS;YACT,MAAM,EAAE;gBACJ,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC;iBACrD;aACJ;SACJ,CAAC;IACN,CAAC;IAEO,iBAAiB;QACrB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,OAAe,EAAE,EAAE;YAC/C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC/C,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;oBAC9B,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;oBAC5B,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;oBAC5D,MAAM;gBACV,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,OAAe,EAAE,MAAc,EAAE,UAAe,EAAE,EAAE;YAC/E,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC/C,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,UAAU,EAAE,CAAC;oBAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;oBAClD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBAE9B,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;wBACvB,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;4BACrC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;gCACnB,IAAI,EAAE,GAAG,CAAC,aAAa,IAAI,QAAQ;gCACnC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;6BACrD,CAAC,CAAC;wBACP,CAAC;oBACL,CAAC;oBACD,MAAM;gBACV,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED,gEAAgE;IAEhE,QAAQ;QAKJ,IAAI,SAAS,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,CAAC,KAAK,KAAK,WAAW;gBAAE,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;gBAAE,MAAM,EAAE,CAAC;QACvC,CAAC;QACD,OAAO;YACH,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,SAAS,GAAG,MAAM;YACxD,cAAc,EAAE,SAAS;YACzB,WAAW,EAAE,MAAM;SACtB,CAAC;IACN,CAAC;IAED,OAAO;QACH,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC9B,CAAC;CACJ"}

package/dist/bridges/mcp-bridge.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Society Protocol — MCP Bridge
+ *
+ * Bidirectional bridge allowing external MCP-compatible agents
+ * (Claude, Cursor, etc.) to participate in Society Protocol
+ * workflows natively.
+ *
+ * - Inbound: MCP tool calls → Society SWP actions
+ * - Outbound: Society events → MCP notifications/resources
+ */
+import { EventEmitter } from 'events';
+import type { Storage } from '../storage.js';
+import type { RoomManager } from '../rooms.js';
+import type { CocEngine } from '../coc.js';
+import type { KnowledgePool } from '../knowledge.js';
+import type { Identity } from '../identity.js';
+export interface MCPBridgeConfig {
+    identity: Identity;
+    storage: Storage;
+    rooms: RoomManager;
+    coc: CocEngine;
+    knowledge: KnowledgePool;
+    /** Limit concurrent bridge sessions */
+    maxSessions?: number;
+}
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface MCPToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface MCPToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export interface MCPResource {
+    uri: string;
+    name: string;
+    mimeType: string;
+    description?: string;
+}
+export interface MCPBridgeSession {
+    sessionId: string;
+    mcpClientId: string;
+    adapterId?: string;
+    joinedRooms: Set<string>;
+    createdAt: number;
+    lastActivity: number;
+}
+export declare class MCPBridge extends EventEmitter {
+    private sessions;
+    private identity;
+    private storage;
+    private rooms;
+    private coc;
+    private knowledge;
+    private maxSessions;
+    constructor(config: MCPBridgeConfig);
+    createSession(mcpClientId: string): MCPBridgeSession;
+    destroySession(sessionId: string): void;
+    getSession(sessionId: string): MCPBridgeSession | undefined;
+    getToolDefinitions(): MCPToolDefinition[];
+    executeTool(sessionId: string, call: MCPToolCall): Promise<MCPToolResult>;
+    getResources(sessionId: string): MCPResource[];
+    private handleJoinRoom;
+    private handleSendMessage;
+    private handleOpenChain;
+    private handleSubmitStep;
+    private handleListPeers;
+    private handleSearchKnowledge;
+    private handleListChains;
+    private setupEventForwarding;
+    private textResult;
+    private errorResult;
+    getStats(): {
+        activeSessions: number;
+        totalRooms: number;
+    };
+    destroy(): void;
+}
+//# sourceMappingURL=mcp-bridge.d.ts.map

package/dist/bridges/mcp-bridge.d.ts.map

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