cognitive-kit 1.0.0-alpha.1

package/dist/federation/FederationClient.js

@@ -0,0 +1,122 @@
+import { EventEmitter } from 'node:events';
+import { request } from 'node:http';
+import { FederationMessageType } from './FederationProtocol.js';
+export class FederationClient extends EventEmitter {
+    peerId;
+    remoteUrl;
+    connected = false;
+    remoteInfo = null;
+    constructor(peerId, remoteUrl) {
+        super();
+        this.peerId = peerId;
+        this.remoteUrl = remoteUrl.replace(/\/$/, '');
+    }
+    get isConnected() { return this.connected; }
+    get remotePeerInfo() { return this.remoteInfo; }
+    async connect() {
+        try {
+            const result = await this.sendMessage({
+                type: FederationMessageType.HANDSHAKE,
+                peerId: this.peerId,
+                timestamp: Date.now(),
+                payload: {
+                    peerId: this.peerId,
+                    hostName: 'federation-client',
+                    hostType: 'client',
+                    version: '1.0.0',
+                    tools: [],
+                    capabilities: [],
+                    sovereignty: 0.5,
+                    address: this.remoteUrl,
+                    port: 0,
+                },
+            });
+            if (result?.type === FederationMessageType.HANDSHAKE_ACK) {
+                this.connected = true;
+                this.remoteInfo = result.payload;
+                this.emit('connected', this.remoteInfo);
+                return true;
+            }
+            return false;
+        }
+        catch (err) {
+            this.emit('error', err);
+            return false;
+        }
+    }
+    async disconnect() {
+        this.connected = false;
+        this.remoteInfo = null;
+        this.emit('disconnected');
+    }
+    async discover() {
+        if (!this.connected)
+            await this.connect();
+        const result = await this.sendMessage({
+            type: FederationMessageType.DISCOVER,
+            peerId: this.peerId,
+            timestamp: Date.now(),
+            payload: {},
+        });
+        if (result?.type === FederationMessageType.DISCOVER_RESPONSE) {
+            return result.payload;
+        }
+        return null;
+    }
+    async executeTool(toolId, params, sovereignty = 0.5) {
+        const result = await this.sendMessage({
+            type: FederationMessageType.EXECUTE_TOOL,
+            peerId: this.peerId,
+            timestamp: Date.now(),
+            payload: { toolId, params, requesterSovereignty: sovereignty },
+        });
+        if (result?.type === FederationMessageType.EXECUTE_TOOL_RESPONSE) {
+            return result.payload;
+        }
+        return { success: false, data: null, error: 'No response from remote', sovereignty: 0, peerId: '' };
+    }
+    async ping() {
+        const result = await this.sendMessage({
+            type: FederationMessageType.PING,
+            peerId: this.peerId,
+            timestamp: Date.now(),
+            payload: {},
+        });
+        if (result?.type === FederationMessageType.PONG) {
+            return result.payload?.timestamp ?? null;
+        }
+        return null;
+    }
+    sendMessage(msg) {
+        return new Promise((resolve, reject) => {
+            const data = JSON.stringify(msg);
+            const url = new URL('/message', this.remoteUrl);
+            const req = request({
+                hostname: url.hostname,
+                port: url.port,
+                path: url.pathname,
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(data),
+                },
+            }, (res) => {
+                let body = '';
+                res.on('data', (chunk) => (body += chunk));
+                res.on('end', () => {
+                    try {
+                        resolve(JSON.parse(body));
+                    }
+                    catch {
+                        resolve(null);
+                    }
+                });
+            });
+            req.on('error', reject);
+            req.write(data);
+            req.end();
+            setTimeout(() => reject(new Error('Federation request timed out')), 10000);
+        });
+    }
+}
+//# sourceMappingURL=FederationClient.js.map

package/dist/federation/FederationClient.js.map

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

package/dist/federation/FederationManager.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from 'node:events';
+import type { ToolRegistry } from '../mcp/ToolRegistry.js';
+import type { ToolContext } from '../types.js';
+import type { FederationExecuteResponse } from './FederationProtocol.js';
+export interface FederationConfig {
+    peerId: string;
+    hostName: string;
+    enableServer?: boolean;
+    serverPort?: number;
+    knownPeers?: string[];
+}
+export declare class FederationManager extends EventEmitter {
+    private server;
+    private clients;
+    private config;
+    constructor(config: FederationConfig, toolRegistry: ToolRegistry, contextProvider: () => ToolContext);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    connectTo(url: string): Promise<boolean>;
+    disconnectFrom(url: string): Promise<void>;
+    discoverPeers(): Promise<Array<{
+        url: string;
+        tools: any[];
+        peers: any[];
+    }>>;
+    executeOnPeer(url: string, toolId: string, params: Record<string, unknown>): Promise<FederationExecuteResponse>;
+    get serverUrl(): string | null;
+    get connectedPeers(): string[];
+    get peerCount(): number;
+}

package/dist/federation/FederationManager.js

@@ -0,0 +1,96 @@
+import { EventEmitter } from 'node:events';
+import { FederationServer } from './FederationServer.js';
+import { FederationClient } from './FederationClient.js';
+import { DEFAULT_FEDERATION_PORT } from './FederationProtocol.js';
+export class FederationManager extends EventEmitter {
+    server = null;
+    clients = new Map();
+    config;
+    constructor(config, toolRegistry, contextProvider) {
+        super();
+        this.config = {
+            peerId: config.peerId,
+            hostName: config.hostName,
+            enableServer: config.enableServer ?? true,
+            serverPort: config.serverPort ?? DEFAULT_FEDERATION_PORT,
+            knownPeers: config.knownPeers ?? [],
+        };
+        if (this.config.enableServer) {
+            this.server = new FederationServer(this.config.peerId, this.config.hostName, toolRegistry, contextProvider, this.config.serverPort);
+            this.server.on('peer-joined', (info) => {
+                this.emit('peer-joined', info);
+            });
+            this.server.on('tool-executed', (data) => {
+                this.emit('remote-tool-executed', data);
+            });
+        }
+    }
+    async start() {
+        if (this.server) {
+            await this.server.start();
+        }
+        for (const url of this.config.knownPeers) {
+            await this.connectTo(url).catch(() => { });
+        }
+    }
+    async stop() {
+        for (const [url, client] of this.clients) {
+            await client.disconnect();
+        }
+        this.clients.clear();
+        await this.server?.stop();
+    }
+    async connectTo(url) {
+        if (this.clients.has(url))
+            return true;
+        const client = new FederationClient(this.config.peerId, url);
+        client.on('error', (err) => this.emit('connection-error', { url, error: err }));
+        const connected = await client.connect();
+        if (connected) {
+            this.clients.set(url, client);
+            this.emit('connected', { url, info: client.remotePeerInfo });
+        }
+        return connected;
+    }
+    async disconnectFrom(url) {
+        const client = this.clients.get(url);
+        if (client) {
+            await client.disconnect();
+            this.clients.delete(url);
+            this.emit('disconnected', url);
+        }
+    }
+    async discoverPeers() {
+        const results = [];
+        for (const [url, client] of this.clients) {
+            try {
+                const info = await client.discover();
+                if (info)
+                    results.push({ url, tools: info.tools, peers: info.peers });
+            }
+            catch { }
+        }
+        return results;
+    }
+    async executeOnPeer(url, toolId, params) {
+        const client = this.clients.get(url);
+        if (!client) {
+            return { success: false, data: null, error: `Not connected to ${url}`, sovereignty: 0, peerId: '' };
+        }
+        const result = await client.executeTool(toolId, params);
+        this.emit('peer-executed', { url, toolId, success: result.success });
+        return result;
+    }
+    get serverUrl() {
+        if (!this.server)
+            return null;
+        return `http://localhost:${this.config.serverPort}`;
+    }
+    get connectedPeers() {
+        return Array.from(this.clients.keys());
+    }
+    get peerCount() {
+        return (this.server?.peerCount ?? 0) + this.clients.size;
+    }
+}
+//# sourceMappingURL=FederationManager.js.map

package/dist/federation/FederationManager.js.map

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

package/dist/federation/FederationProtocol.d.ts

@@ -0,0 +1,45 @@
+export declare const FEDERATION_VERSION = "1.0.0";
+export declare const DEFAULT_FEDERATION_PORT = 4200;
+export declare enum FederationMessageType {
+    HANDSHAKE = "federation:handshake",
+    HANDSHAKE_ACK = "federation:handshake:ack",
+    DISCOVER = "federation:discover",
+    DISCOVER_RESPONSE = "federation:discover:response",
+    EXECUTE_TOOL = "federation:execute:tool",
+    EXECUTE_TOOL_RESPONSE = "federation:execute:tool:response",
+    SHARE_MEMORY = "federation:share:memory",
+    SHARE_SKILLS = "federation:share:skills",
+    SKILLS_RESPONSE = "federation:share:skills:response",
+    PING = "federation:ping",
+    PONG = "federation:pong",
+    ERROR = "federation:error"
+}
+export interface FederationPeerInfo {
+    peerId: string;
+    hostName: string;
+    hostType: string;
+    version: string;
+    tools: string[];
+    capabilities: string[];
+    sovereignty: number;
+    address: string;
+    port: number;
+}
+export interface FederationMessage {
+    type: FederationMessageType;
+    peerId: string;
+    timestamp: number;
+    payload: Record<string, unknown>;
+}
+export interface FederationExecuteRequest {
+    toolId: string;
+    params: Record<string, unknown>;
+    requesterSovereignty: number;
+}
+export interface FederationExecuteResponse {
+    success: boolean;
+    data: unknown;
+    error?: string;
+    sovereignty: number;
+    peerId: string;
+}

package/dist/federation/FederationProtocol.js

@@ -0,0 +1,18 @@
+export const FEDERATION_VERSION = '1.0.0';
+export const DEFAULT_FEDERATION_PORT = 4200;
+export var FederationMessageType;
+(function (FederationMessageType) {
+    FederationMessageType["HANDSHAKE"] = "federation:handshake";
+    FederationMessageType["HANDSHAKE_ACK"] = "federation:handshake:ack";
+    FederationMessageType["DISCOVER"] = "federation:discover";
+    FederationMessageType["DISCOVER_RESPONSE"] = "federation:discover:response";
+    FederationMessageType["EXECUTE_TOOL"] = "federation:execute:tool";
+    FederationMessageType["EXECUTE_TOOL_RESPONSE"] = "federation:execute:tool:response";
+    FederationMessageType["SHARE_MEMORY"] = "federation:share:memory";
+    FederationMessageType["SHARE_SKILLS"] = "federation:share:skills";
+    FederationMessageType["SKILLS_RESPONSE"] = "federation:share:skills:response";
+    FederationMessageType["PING"] = "federation:ping";
+    FederationMessageType["PONG"] = "federation:pong";
+    FederationMessageType["ERROR"] = "federation:error";
+})(FederationMessageType || (FederationMessageType = {}));
+//# sourceMappingURL=FederationProtocol.js.map

package/dist/federation/FederationProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FederationProtocol.js","sourceRoot":"","sources":["../../src/federation/FederationProtocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,MAAM,CAAN,IAAY,qBAaX;AAbD,WAAY,qBAAqB;IAC/B,2DAAkC,CAAA;IAClC,mEAA0C,CAAA;IAC1C,yDAAgC,CAAA;IAChC,2EAAkD,CAAA;IAClD,iEAAwC,CAAA;IACxC,mFAA0D,CAAA;IAC1D,iEAAwC,CAAA;IACxC,iEAAwC,CAAA;IACxC,6EAAoD,CAAA;IACpD,iDAAwB,CAAA;IACxB,iDAAwB,CAAA;IACxB,mDAA0B,CAAA;AAC5B,CAAC,EAbW,qBAAqB,KAArB,qBAAqB,QAahC"}

package/dist/federation/FederationServer.d.ts

@@ -0,0 +1,20 @@
+import { EventEmitter } from 'node:events';
+import type { ToolRegistry } from '../mcp/ToolRegistry.js';
+import type { ToolContext } from '../types.js';
+import type { FederationPeerInfo } from './FederationProtocol.js';
+export declare class FederationServer extends EventEmitter {
+    private server;
+    private port;
+    private peerId;
+    private hostName;
+    private toolRegistry;
+    private contextProvider;
+    private peers;
+    private running;
+    constructor(peerId: string, hostName: string, toolRegistry: ToolRegistry, contextProvider: () => ToolContext, port?: number);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    get peerCount(): number;
+    get peerList(): FederationPeerInfo[];
+    private handleMessage;
+}

package/dist/federation/FederationServer.js

@@ -0,0 +1,193 @@
+import { createServer } from 'node:http';
+import { EventEmitter } from 'node:events';
+import { FederationMessageType, DEFAULT_FEDERATION_PORT } from './FederationProtocol.js';
+export class FederationServer extends EventEmitter {
+    server = null;
+    port;
+    peerId;
+    hostName;
+    toolRegistry;
+    contextProvider;
+    peers = new Map();
+    running = false;
+    constructor(peerId, hostName, toolRegistry, contextProvider, port) {
+        super();
+        this.peerId = peerId;
+        this.hostName = hostName;
+        this.toolRegistry = toolRegistry;
+        this.contextProvider = contextProvider;
+        this.port = port ?? DEFAULT_FEDERATION_PORT;
+    }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.server = createServer((req, res) => {
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204);
+                res.end();
+                return;
+            }
+            if (req.method === 'GET' && req.url === '/health') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    peerId: this.peerId,
+                    hostName: this.hostName,
+                    tools: this.toolRegistry.list().map(t => t.id),
+                    activePeers: this.peers.size,
+                    uptime: Date.now(),
+                }));
+                return;
+            }
+            if (req.method === 'GET' && req.url === '/sse') {
+                res.writeHead(200, {
+                    'Content-Type': 'text/event-stream',
+                    'Cache-Control': 'no-cache',
+                    Connection: 'keep-alive',
+                });
+                res.write(`data: ${JSON.stringify({ type: FederationMessageType.HANDSHAKE, peerId: this.peerId, payload: { hostName: this.hostName, tools: this.toolRegistry.list().map(t => t.id) } })}\n\n`);
+                const keepAlive = setInterval(() => {
+                    res.write(`:keepalive\n\n`);
+                }, 15000);
+                req.on('close', () => {
+                    clearInterval(keepAlive);
+                });
+                return;
+            }
+            if (req.method === 'POST' && req.url === '/message') {
+                let body = '';
+                req.on('data', (chunk) => (body += chunk));
+                req.on('end', () => {
+                    try {
+                        const msg = JSON.parse(body);
+                        this.handleMessage(msg, res);
+                    }
+                    catch {
+                        res.writeHead(400);
+                        res.end(JSON.stringify({ error: 'Invalid JSON' }));
+                    }
+                });
+                return;
+            }
+            res.writeHead(404);
+            res.end();
+        });
+        return new Promise((resolve) => {
+            this.server.listen(this.port, () => {
+                console.error(`[federation] Server listening on port ${this.port}`);
+                this.emit('ready', { port: this.port });
+                resolve();
+            });
+        });
+    }
+    async stop() {
+        this.running = false;
+        this.peers.clear();
+        return new Promise((resolve) => {
+            this.server?.close(() => resolve());
+            this.server = null;
+        });
+    }
+    get peerCount() { return this.peers.size; }
+    get peerList() {
+        return Array.from(this.peers.values());
+    }
+    async handleMessage(msg, res) {
+        const sendResponse = (data) => {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(data));
+        };
+        const sendError = (message) => {
+            res.writeHead(400);
+            res.end(JSON.stringify({ type: FederationMessageType.ERROR, error: message }));
+        };
+        try {
+            switch (msg.type) {
+                case FederationMessageType.HANDSHAKE: {
+                    const info = msg.payload;
+                    this.peers.set(msg.peerId, info);
+                    this.emit('peer-joined', info);
+                    sendResponse({
+                        type: FederationMessageType.HANDSHAKE_ACK,
+                        peerId: this.peerId,
+                        payload: {
+                            hostName: this.hostName,
+                            tools: this.toolRegistry.list().map(t => t.id),
+                        },
+                    });
+                    break;
+                }
+                case FederationMessageType.DISCOVER: {
+                    sendResponse({
+                        type: FederationMessageType.DISCOVER_RESPONSE,
+                        peerId: this.peerId,
+                        payload: {
+                            hostName: this.hostName,
+                            tools: this.toolRegistry.list().map(t => ({
+                                id: t.id,
+                                name: t.name,
+                                description: t.description,
+                                category: t.category,
+                            })),
+                            peers: this.peerList.map(p => ({ peerId: p.peerId, hostName: p.hostName, hostType: p.hostType })),
+                        },
+                    });
+                    break;
+                }
+                case FederationMessageType.EXECUTE_TOOL: {
+                    const { toolId, params, requesterSovereignty } = msg.payload;
+                    if (!toolId) {
+                        sendError('toolId is required');
+                        return;
+                    }
+                    const ctx = this.contextProvider();
+                    if (requesterSovereignty < 0.1) {
+                        sendError('Insufficient federation sovereignty');
+                        return;
+                    }
+                    const result = await this.toolRegistry.execute(toolId, params ?? {}, ctx);
+                    sendResponse({
+                        type: FederationMessageType.EXECUTE_TOOL_RESPONSE,
+                        peerId: this.peerId,
+                        payload: {
+                            success: result.success,
+                            data: result.data,
+                            error: result.error,
+                            sovereignty: ctx.identity.sovereignty,
+                        },
+                    });
+                    this.emit('tool-executed', {
+                        toolId,
+                        peerId: msg.peerId,
+                        success: result.success,
+                    });
+                    break;
+                }
+                case FederationMessageType.SHARE_SKILLS: {
+                    sendResponse({
+                        type: FederationMessageType.SKILLS_RESPONSE,
+                        peerId: this.peerId,
+                        payload: {
+                            skills: [],
+                            message: 'Skill sharing acknowledged',
+                        },
+                    });
+                    break;
+                }
+                case FederationMessageType.PING: {
+                    sendResponse({ type: FederationMessageType.PONG, peerId: this.peerId, payload: { timestamp: Date.now() } });
+                    break;
+                }
+                default:
+                    sendError(`Unknown message type: ${msg.type}`);
+            }
+        }
+        catch (err) {
+            sendError(err instanceof Error ? err.message : String(err));
+        }
+    }
+}
+//# sourceMappingURL=FederationServer.js.map

package/dist/federation/FederationServer.js.map

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

package/dist/forge/ForgeRegistry.d.ts

@@ -0,0 +1,25 @@
+import type { SkillDefinition } from '../types.js';
+import type { SkillRegistry } from '../skills/SkillRegistry.js';
+import type { PatternDetector } from './PatternDetector.js';
+import type { SkillForger } from './SkillForger.js';
+export interface ForgeOptions {
+    minPatternFrequency?: number;
+    autoForgeThreshold?: number;
+    maxForgedSkills?: number;
+}
+export declare class ForgeRegistry {
+    private skillRegistry;
+    private detector;
+    private forger;
+    private forgedSkills;
+    private options;
+    private lastAutoForge;
+    constructor(skillRegistry: SkillRegistry, detector: PatternDetector, forger: SkillForger, options?: ForgeOptions);
+    recordUsage(toolId: string, success: boolean, params: Record<string, unknown>): void;
+    forgeFromPatterns(force?: boolean): SkillDefinition[];
+    autoForge(): SkillDefinition[];
+    listForged(): SkillDefinition[];
+    clearForged(): void;
+    get detector_(): PatternDetector;
+    get forger_(): SkillForger;
+}

package/dist/forge/ForgeRegistry.js

@@ -0,0 +1,60 @@
+export class ForgeRegistry {
+    skillRegistry;
+    detector;
+    forger;
+    forgedSkills = [];
+    options;
+    lastAutoForge = 0;
+    constructor(skillRegistry, detector, forger, options) {
+        this.skillRegistry = skillRegistry;
+        this.detector = detector;
+        this.forger = forger;
+        this.options = {
+            minPatternFrequency: options?.minPatternFrequency ?? 2,
+            autoForgeThreshold: options?.autoForgeThreshold ?? 3,
+            maxForgedSkills: options?.maxForgedSkills ?? 20,
+        };
+    }
+    recordUsage(toolId, success, params) {
+        this.detector.recordUsage(toolId, success, params);
+    }
+    forgeFromPatterns(force) {
+        const patterns = this.detector.detectPatterns(force ? 1 : this.options.minPatternFrequency);
+        const newSkills = [];
+        for (const pattern of patterns) {
+            if (this.forgedSkills.length >= this.options.maxForgedSkills)
+                break;
+            const exists = this.forgedSkills.some(s => s.toolsRequired.length === pattern.toolSequence.length &&
+                s.toolsRequired.every((t, i) => t === pattern.toolSequence[i]));
+            if (exists)
+                continue;
+            const skill = this.forger.forge(pattern);
+            this.forgedSkills.push(skill);
+            this.skillRegistry.add(skill);
+            newSkills.push(skill);
+        }
+        return newSkills;
+    }
+    autoForge() {
+        const now = Date.now();
+        if (now - this.lastAutoForge < 60000)
+            return [];
+        this.lastAutoForge = now;
+        const stats = this.detector.getStats();
+        if (stats.totalCalls >= this.options.autoForgeThreshold) {
+            return this.forgeFromPatterns(false);
+        }
+        return [];
+    }
+    listForged() {
+        return [...this.forgedSkills];
+    }
+    clearForged() {
+        for (const skill of this.forgedSkills) {
+        }
+        this.forgedSkills = [];
+    }
+    get detector_() { return this.detector; }
+    get forger_() { return this.forger; }
+}
+//# sourceMappingURL=ForgeRegistry.js.map

package/dist/forge/ForgeRegistry.js.map

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