society-protocol 1.0.0

package/dist/bridges/mcp-bridge.js

@@ -0,0 +1,332 @@
+/**
+ * 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 { ulid } from 'ulid';
+// ─── MCP Bridge ─────────────────────────────────────────────────
+export class MCPBridge extends EventEmitter {
+    sessions = new Map();
+    identity;
+    storage;
+    rooms;
+    coc;
+    knowledge;
+    maxSessions;
+    constructor(config) {
+        super();
+        this.identity = config.identity;
+        this.storage = config.storage;
+        this.rooms = config.rooms;
+        this.coc = config.coc;
+        this.knowledge = config.knowledge;
+        this.maxSessions = config.maxSessions ?? 100;
+        this.setupEventForwarding();
+    }
+    // ─── Session Management ──────────────────────────────────────
+    createSession(mcpClientId) {
+        if (this.sessions.size >= this.maxSessions) {
+            // Evict oldest session
+            let oldest;
+            for (const s of this.sessions.values()) {
+                if (!oldest || s.lastActivity < oldest.lastActivity)
+                    oldest = s;
+            }
+            if (oldest)
+                this.destroySession(oldest.sessionId);
+        }
+        const session = {
+            sessionId: ulid(),
+            mcpClientId,
+            joinedRooms: new Set(),
+            createdAt: Date.now(),
+            lastActivity: Date.now(),
+        };
+        this.sessions.set(session.sessionId, session);
+        this.emit('session:created', session);
+        return session;
+    }
+    destroySession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        this.sessions.delete(sessionId);
+        this.emit('session:destroyed', sessionId);
+    }
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    // ─── Tool Definitions ────────────────────────────────────────
+    getToolDefinitions() {
+        return [
+            {
+                name: 'society_join_room',
+                description: 'Join a Society Protocol room to collaborate with agents',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        room_id: { type: 'string', description: 'Room identifier' },
+                    },
+                    required: ['room_id'],
+                },
+            },
+            {
+                name: 'society_send_message',
+                description: 'Send a message to a Society room',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        room_id: { type: 'string', description: 'Room ID' },
+                        message: { type: 'string', description: 'Message text' },
+                    },
+                    required: ['room_id', 'message'],
+                },
+            },
+            {
+                name: 'society_open_chain',
+                description: 'Start a Chain of Collaboration workflow with a goal',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        room_id: { type: 'string', description: 'Room for the chain' },
+                        goal: { type: 'string', description: 'Goal to achieve' },
+                        priority: { type: 'string', enum: ['low', 'normal', 'high', 'critical'] },
+                    },
+                    required: ['room_id', 'goal'],
+                },
+            },
+            {
+                name: 'society_submit_step',
+                description: 'Submit results for an assigned step in a CoC chain',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        room_id: { type: 'string' },
+                        chain_id: { type: 'string' },
+                        step_id: { type: 'string' },
+                        status: { type: 'string', enum: ['completed', 'failed', 'partial'] },
+                        memo: { type: 'string', description: 'Output text' },
+                    },
+                    required: ['room_id', 'chain_id', 'step_id', 'status', 'memo'],
+                },
+            },
+            {
+                name: 'society_list_peers',
+                description: 'List online peers in the network',
+                inputSchema: { type: 'object', properties: {} },
+            },
+            {
+                name: 'society_search_knowledge',
+                description: 'Search the distributed knowledge pool',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Search query' },
+                        limit: { type: 'number', description: 'Max results' },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'society_list_chains',
+                description: 'List active CoC chains in a room',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        room_id: { type: 'string' },
+                    },
+                    required: ['room_id'],
+                },
+            },
+        ];
+    }
+    // ─── Tool Execution ──────────────────────────────────────────
+    async executeTool(sessionId, call) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return this.errorResult('Session not found. Create a session first.');
+        }
+        session.lastActivity = Date.now();
+        try {
+            switch (call.name) {
+                case 'society_join_room':
+                    return await this.handleJoinRoom(session, call.arguments);
+                case 'society_send_message':
+                    return await this.handleSendMessage(session, call.arguments);
+                case 'society_open_chain':
+                    return await this.handleOpenChain(session, call.arguments);
+                case 'society_submit_step':
+                    return await this.handleSubmitStep(session, call.arguments);
+                case 'society_list_peers':
+                    return this.handleListPeers();
+                case 'society_search_knowledge':
+                    return this.handleSearchKnowledge(call.arguments);
+                case 'society_list_chains':
+                    return this.handleListChains(call.arguments);
+                default:
+                    return this.errorResult(`Unknown tool: ${call.name}`);
+            }
+        }
+        catch (err) {
+            return this.errorResult(`Tool execution failed: ${err.message}`);
+        }
+    }
+    // ─── Resource Listing ────────────────────────────────────────
+    getResources(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return [];
+        const resources = [];
+        // Rooms as resources
+        for (const roomId of session.joinedRooms) {
+            resources.push({
+                uri: `society://room/${roomId}`,
+                name: `Room: ${roomId}`,
+                mimeType: 'application/json',
+                description: `Society Protocol room ${roomId}`,
+            });
+        }
+        // Active chains as resources
+        const chains = this.coc.getActiveChains();
+        for (const chain of chains) {
+            resources.push({
+                uri: `society://chain/${chain.chain_id}`,
+                name: `Chain: ${chain.goal.slice(0, 50)}`,
+                mimeType: 'application/json',
+                description: `CoC chain ${chain.chain_id} — ${chain.status}`,
+            });
+        }
+        return resources;
+    }
+    // ─── Tool Handlers ───────────────────────────────────────────
+    async handleJoinRoom(session, args) {
+        const roomId = args.room_id;
+        if (!roomId)
+            return this.errorResult('room_id is required');
+        await this.rooms.joinRoom(roomId);
+        session.joinedRooms.add(roomId);
+        this.emit('mcp:room:joined', session.sessionId, roomId);
+        return this.textResult(`Joined room ${roomId} successfully.`);
+    }
+    async handleSendMessage(session, args) {
+        const roomId = args.room_id;
+        const message = args.message;
+        if (!roomId || !message)
+            return this.errorResult('room_id and message are required');
+        await this.rooms.sendChatMessage(roomId, message, { formatting: 'plain' });
+        return this.textResult(`Message sent to room ${roomId}.`);
+    }
+    async handleOpenChain(session, args) {
+        const roomId = args.room_id;
+        const goal = args.goal;
+        const priority = args.priority || 'normal';
+        if (!roomId || !goal)
+            return this.errorResult('room_id and goal are required');
+        const chainId = await this.coc.openChain(roomId, goal, {
+            priority: priority,
+        });
+        this.emit('mcp:chain:opened', session.sessionId, chainId, goal);
+        return this.textResult(`Chain opened: ${chainId}\nGoal: ${goal}\nPriority: ${priority}`);
+    }
+    async handleSubmitStep(session, args) {
+        const roomId = args.room_id;
+        const chainId = args.chain_id;
+        const stepId = args.step_id;
+        const status = args.status;
+        const memo = args.memo;
+        if (!roomId || !chainId || !stepId || !status || !memo) {
+            return this.errorResult('room_id, chain_id, step_id, status, and memo are required');
+        }
+        await this.coc.submitStep(roomId, chainId, stepId, status, memo, []);
+        return this.textResult(`Step ${stepId} submitted with status: ${status}`);
+    }
+    handleListPeers() {
+        const peers = this.rooms.getOnlinePeers();
+        const peerList = peers.map(p => ({
+            did: p.peer_did,
+            name: p.peer_name || 'Unknown',
+            status: p.status,
+        }));
+        return this.textResult(JSON.stringify(peerList, null, 2));
+    }
+    handleSearchKnowledge(args) {
+        const query = args.query;
+        const limit = args.limit || 10;
+        if (!query)
+            return this.errorResult('query is required');
+        const cards = this.knowledge.queryCards({ query, limit });
+        const results = cards.map(c => ({
+            id: c.id,
+            title: c.title,
+            domain: c.domain,
+            confidence: c.confidence,
+        }));
+        return this.textResult(JSON.stringify(results, null, 2));
+    }
+    handleListChains(args) {
+        const roomId = args.room_id;
+        if (!roomId)
+            return this.errorResult('room_id is required');
+        const chains = this.coc.getActiveChains().filter(c => c.room_id === roomId);
+        const list = chains.map(c => ({
+            chain_id: c.chain_id,
+            goal: c.goal,
+            status: c.status,
+            steps: c.steps.length,
+        }));
+        return this.textResult(JSON.stringify(list, null, 2));
+    }
+    // ─── Event Forwarding ────────────────────────────────────────
+    setupEventForwarding() {
+        this.coc.on('step:unlocked', (chainId, stepId, step) => {
+            this.emit('mcp:notification', {
+                method: 'society/stepUnlocked',
+                params: { chainId, stepId, kind: step.kind, title: step.title },
+            });
+        });
+        this.coc.on('chain:completed', (chainId) => {
+            this.emit('mcp:notification', {
+                method: 'society/chainCompleted',
+                params: { chainId },
+            });
+        });
+        this.rooms.on('chat:message', (roomId, envelope) => {
+            this.emit('mcp:notification', {
+                method: 'society/chatMessage',
+                params: {
+                    roomId,
+                    from: envelope.from,
+                    text: envelope.body?.text,
+                },
+            });
+        });
+    }
+    // ─── Helpers ─────────────────────────────────────────────────
+    textResult(text) {
+        return { content: [{ type: 'text', text }] };
+    }
+    errorResult(message) {
+        return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
+    }
+    // ─── Stats ───────────────────────────────────────────────────
+    getStats() {
+        let totalRooms = 0;
+        for (const s of this.sessions.values()) {
+            totalRooms += s.joinedRooms.size;
+        }
+        return { activeSessions: this.sessions.size, totalRooms };
+    }
+    destroy() {
+        for (const sessionId of this.sessions.keys()) {
+            this.destroySession(sessionId);
+        }
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

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

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

package/dist/cache.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Society Protocol - Caching Layer
+ *
+ * LRU cache with TTL support for frequently accessed data.
+ * Reduces database load and improves response times.
+ */
+import { EventEmitter } from 'events';
+export interface CacheEntry<T> {
+    value: T;
+    expiresAt: number;
+    hits: number;
+}
+export interface CacheOptions {
+    maxSize?: number;
+    defaultTtlMs?: number;
+    checkIntervalMs?: number;
+}
+/**
+ * LRU Cache with TTL support
+ */
+export declare class LRUCache<K, V> extends EventEmitter {
+    private cache;
+    private maxSize;
+    private defaultTtlMs;
+    private cleanupInterval?;
+    private stats;
+    constructor(options?: CacheOptions);
+    /**
+     * Get value from cache
+     */
+    get(key: K): V | undefined;
+    /**
+     * Set value in cache
+     */
+    set(key: K, value: V, ttlMs?: number): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: K): boolean;
+    /**
+     * Delete key from cache
+     */
+    delete(key: K): boolean;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get all keys
+     */
+    keys(): IterableIterator<K>;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+        hitRate: number;
+        hits: number;
+        misses: number;
+        evictions: number;
+        expirations: number;
+    };
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Clean up expired entries
+     */
+    private cleanup;
+    /**
+     * Destroy cache and stop cleanup interval
+     */
+    destroy(): void;
+}
+/**
+ * Knowledge-specific cache with space invalidation
+ */
+export declare class KnowledgeCache extends LRUCache<string, any> {
+    private spaceIndex;
+    constructor(options?: CacheOptions);
+    /**
+     * Cache card with space tracking
+     */
+    setCard(cardId: string, card: any, spaceId: string, ttlMs?: number): void;
+    /**
+     * Get cached card
+     */
+    getCard(cardId: string): any | undefined;
+    /**
+     * Invalidate all cards in a space
+     */
+    invalidateSpace(spaceId: string): number;
+    /**
+     * Cache space metadata
+     */
+    setSpace(spaceId: string, space: any, ttlMs?: number): void;
+    /**
+     * Get cached space
+     */
+    getSpace(spaceId: string): any | undefined;
+}
+/**
+ * Federation cache with policy caching
+ */
+export declare class FederationCache extends LRUCache<string, any> {
+    constructor(options?: CacheOptions);
+    /**
+     * Cache federation
+     */
+    setFederation(fedId: string, federation: any): void;
+    /**
+     * Get cached federation
+     */
+    getFederation(fedId: string): any | undefined;
+    /**
+     * Cache policy check result
+     */
+    setPolicyCheck(action: string, actor: string, result: any): void;
+    /**
+     * Get cached policy check
+     */
+    getPolicyCheck(action: string, actor: string): any | undefined;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,YAAY;IAC5C,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,KAAK,CAKX;gBAEU,OAAO,GAAE,YAAiB;IAWtC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IA0B1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAsB3C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAUpB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAQvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC;IAI3B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ;;;;;;;;;IAYR;;OAEG;IACH,UAAU,IAAI,IAAI;IASlB;;OAEG;IACH,OAAO,CAAC,OAAO;IAkBf;;OAEG;IACH,OAAO,IAAI,IAAI;CAQlB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrD,OAAO,CAAC,UAAU,CAAuC;gBAE7C,OAAO,GAAE,YAAiB;IAItC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAUzE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAIxC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAexC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;CAG7C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;gBAC1C,OAAO,GAAE,YAAiB;IAItC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,IAAI;IAInD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAI7C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAIhE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;CAGjE"}