@essentialai/cogent-bridge 1.0.0

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const SERVER_NAME = "Cogent Bridge from Essential AI Solutions (essentialai.uk)";
+export declare const SERVER_VERSION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,+DAA+D,CAAC;AACxF,eAAO,MAAM,cAAc,QAAc,CAAC"}

package/dist/constants.js

@@ -0,0 +1,6 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+export const SERVER_NAME = "Cogent Bridge from Essential AI Solutions (essentialai.uk)";
+export const SERVER_VERSION = pkg.version;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG,4DAA4D,CAAC;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/dist/e2e/helpers.d.ts

@@ -0,0 +1,101 @@
+/**
+ * E2E test helpers for cloud mode integration testing.
+ *
+ * Provides utilities to stand up a real Hono server (with WebSocket support)
+ * and create MCP client instances whose HttpBackend talks to that server.
+ * This enables full-stack testing: MCP tool call -> HttpBackend -> REST API
+ * -> server -> file persistence -> WebSocket push.
+ */
+import WebSocket from "ws";
+import type { ServerType } from "@hono/node-server";
+import { SessionStore } from "../../server/src/services/session-store.js";
+import { ConnectionManager } from "../../server/src/services/connection-manager.js";
+import { MessageQueueService } from "../../server/src/services/message-queue.js";
+import type { WsServerFrame } from "../../server/src/ws/frames.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { HttpClient } from "../cloud/http-client.js";
+import { HttpBackend } from "../backend/http-backend.js";
+export type { WsServerFrame };
+export interface E2EServer {
+    port: number;
+    server: ServerType;
+    sessionStore: SessionStore;
+    connectionManager: ConnectionManager;
+    messageQueue: MessageQueueService;
+    stateDir: string;
+    /** Build a ws:// URL for the given session, token, and peerId. */
+    wsUrl: (sessionId: string, token: string, peerId: string) => string;
+    /** Shut down the HTTP server and close all WS connections. */
+    shutdown: () => Promise<void>;
+    /** Remove the temp state directory (only if it was created by this call). */
+    cleanup: () => Promise<void>;
+}
+/**
+ * Create a real Hono server with WebSocket support on an ephemeral port.
+ *
+ * Follows the same pattern as `server/src/__tests__/helpers.ts` createTestWsApp
+ * but tailored for E2E testing with separate MCP clients.
+ *
+ * @param existingStateDir - Optional state directory for server restart tests.
+ *   When provided, skips mkdtemp and uses the given dir; cleanup() only
+ *   removes the dir if it was created by this call.
+ */
+export declare function createE2EServer(existingStateDir?: string): Promise<E2EServer>;
+export interface E2EClient {
+    client: Client;
+    mcpServer: McpServer;
+    backend: HttpBackend;
+    httpClient: HttpClient;
+    /**
+     * Swap the module-level backend singleton to this client's backend.
+     * Must be called BEFORE invoking any tools on this client.
+     */
+    activate: () => void;
+    /** Close the MCP transport pair. */
+    close: () => Promise<void>;
+}
+/**
+ * Create an MCP Server + Client pair connected via InMemoryTransport,
+ * backed by an HttpBackend pointed at the given E2E server.
+ *
+ * Since tool handlers call getBackend() at runtime (module-level singleton),
+ * call activate() before each tool invocation to swap the backend.
+ */
+export declare function createE2EClient(port: number, sessionId: string, token: string, tempDir: string): Promise<E2EClient>;
+/**
+ * Create a new cloud session via direct fetch.
+ * Returns the sessionId and bearer token.
+ */
+export declare function createCloudSession(port: number, secret: string): Promise<{
+    sessionId: string;
+    token: string;
+}>;
+/**
+ * Join an existing cloud session via direct fetch.
+ * Returns a bearer token for the joining client.
+ */
+export declare function joinCloudSession(port: number, sessionId: string, secret: string): Promise<{
+    token: string;
+}>;
+/**
+ * Extract and JSON.parse the text from an MCP tool result content array.
+ * Copied from src/integration.test.ts.
+ */
+export declare function parseResult(result: {
+    content: unknown;
+}): Record<string, unknown>;
+/** Small delay helper for async settling. */
+export declare const tick: (ms?: number) => Promise<void>;
+/**
+ * Wait for the next parsed JSON message from a WebSocket connection.
+ * Optionally filters by frame type (ignoring non-matching frames).
+ * Times out after the specified duration.
+ */
+export declare function waitForWsMessage(ws: WebSocket, type?: string, timeoutMs?: number): Promise<WsServerFrame>;
+/**
+ * Open a WebSocket connection and wait until it's fully open.
+ * Rejects on connection error.
+ */
+export declare function connectWs(url: string): Promise<WebSocket>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/e2e/helpers.d.ts.map

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

package/dist/e2e/helpers.js

@@ -0,0 +1,228 @@
+/**
+ * E2E test helpers for cloud mode integration testing.
+ *
+ * Provides utilities to stand up a real Hono server (with WebSocket support)
+ * and create MCP client instances whose HttpBackend talks to that server.
+ * This enables full-stack testing: MCP tool call -> HttpBackend -> REST API
+ * -> server -> file persistence -> WebSocket push.
+ */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import WebSocket from "ws";
+import { createAdaptorServer } from "@hono/node-server";
+import { SessionStore } from "../../server/src/services/session-store.js";
+import { AuthService } from "../../server/src/services/auth-service.js";
+import { ConnectionManager } from "../../server/src/services/connection-manager.js";
+import { MessageQueueService } from "../../server/src/services/message-queue.js";
+import { createApp } from "../../server/src/app.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { HttpClient } from "../cloud/http-client.js";
+import { HttpBackend } from "../backend/http-backend.js";
+import { initBackend, resetBackend } from "../backend/backend-provider.js";
+import { resetConfig, loadConfig } from "../config.js";
+import { registerRegisterPeerTool } from "../tools/register-peer.js";
+import { registerDeregisterPeerTool } from "../tools/deregister-peer.js";
+import { registerSendMessageTool } from "../tools/send-message.js";
+import { registerListPeersTool } from "../tools/list-peers.js";
+import { registerGetHistoryTool } from "../tools/get-history.js";
+import { registerHealthCheckTool } from "../tools/health-check.js";
+/**
+ * Create a real Hono server with WebSocket support on an ephemeral port.
+ *
+ * Follows the same pattern as `server/src/__tests__/helpers.ts` createTestWsApp
+ * but tailored for E2E testing with separate MCP clients.
+ *
+ * @param existingStateDir - Optional state directory for server restart tests.
+ *   When provided, skips mkdtemp and uses the given dir; cleanup() only
+ *   removes the dir if it was created by this call.
+ */
+export async function createE2EServer(existingStateDir) {
+    const ownsDir = !existingStateDir;
+    const stateDir = existingStateDir ?? await fs.mkdtemp(path.join(os.tmpdir(), "e2e-test-"));
+    const sessionStore = new SessionStore(stateDir, 500);
+    const authService = new AuthService(4); // Low rounds for fast tests
+    const connectionManager = new ConnectionManager(30_000);
+    const messageQueue = new MessageQueueService(sessionStore);
+    await sessionStore.init();
+    const { app, injectWebSocket } = createApp({
+        sessionStore,
+        authService,
+        startTime: Date.now(),
+        maxMessages: 500,
+        connectionManager,
+        messageQueue,
+        heartbeatIntervalMs: 30_000,
+        heartbeatMaxMissed: 3,
+    });
+    const server = createAdaptorServer(app);
+    injectWebSocket(server);
+    return new Promise((resolve) => {
+        server.listen(0, () => {
+            const addr = server.address();
+            const port = typeof addr === "object" && addr ? addr.port : 0;
+            resolve({
+                port,
+                server,
+                sessionStore,
+                connectionManager,
+                messageQueue,
+                stateDir,
+                wsUrl: (sessionId, token, peerId) => `ws://localhost:${port}/ws/${sessionId}?token=${encodeURIComponent(token)}&peerId=${encodeURIComponent(peerId)}`,
+                shutdown: async () => {
+                    connectionManager.closeAll(1012, "Test shutdown");
+                    return new Promise((res, rej) => {
+                        server.close((err) => (err ? rej(err) : res()));
+                    });
+                },
+                cleanup: async () => {
+                    if (ownsDir) {
+                        await fs.rm(stateDir, { recursive: true, force: true });
+                    }
+                },
+            });
+        });
+    });
+}
+/**
+ * Create an MCP Server + Client pair connected via InMemoryTransport,
+ * backed by an HttpBackend pointed at the given E2E server.
+ *
+ * Since tool handlers call getBackend() at runtime (module-level singleton),
+ * call activate() before each tool invocation to swap the backend.
+ */
+export async function createE2EClient(port, sessionId, token, tempDir) {
+    const httpClient = new HttpClient(`http://localhost:${port}`, token);
+    const backend = new HttpBackend(httpClient, sessionId);
+    const mcpServer = new McpServer({ name: "e2e-test", version: "1.0.0" });
+    // Register all 6 standard tools
+    registerRegisterPeerTool(mcpServer);
+    registerDeregisterPeerTool(mcpServer);
+    registerSendMessageTool(mcpServer);
+    registerListPeersTool(mcpServer);
+    registerGetHistoryTool(mcpServer);
+    registerHealthCheckTool(mcpServer);
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+    const client = new Client({ name: "e2e-client", version: "1.0.0" });
+    await Promise.all([
+        mcpServer.connect(serverTransport),
+        client.connect(clientTransport),
+    ]);
+    return {
+        client,
+        mcpServer,
+        backend,
+        httpClient,
+        activate: () => {
+            // Swap the module-level backend singleton to this client's backend
+            resetBackend();
+            initBackend(backend);
+            // Ensure config is loaded with cloud endpoint pointing at the E2E server
+            resetConfig();
+            loadConfig({
+                CC_BRIDGE_STATE_PATH: tempDir,
+                CC_BRIDGE_ENDPOINT: `http://localhost:${port}`,
+                CC_BRIDGE_SESSION_ID: sessionId,
+                CC_BRIDGE_TIMEOUT_MS: "10000",
+                CC_BRIDGE_LOG_LEVEL: "error",
+            });
+        },
+        close: async () => {
+            await client.close();
+            await mcpServer.close();
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Cloud session REST helpers
+// ---------------------------------------------------------------------------
+/**
+ * Create a new cloud session via direct fetch.
+ * Returns the sessionId and bearer token.
+ */
+export async function createCloudSession(port, secret) {
+    const res = await fetch(`http://localhost:${port}/api/sessions`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ secret }),
+    });
+    if (!res.ok) {
+        throw new Error(`createCloudSession failed: HTTP ${res.status}`);
+    }
+    return (await res.json());
+}
+/**
+ * Join an existing cloud session via direct fetch.
+ * Returns a bearer token for the joining client.
+ */
+export async function joinCloudSession(port, sessionId, secret) {
+    const res = await fetch(`http://localhost:${port}/api/sessions/${sessionId}/join`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ secret }),
+    });
+    if (!res.ok) {
+        throw new Error(`joinCloudSession failed: HTTP ${res.status}`);
+    }
+    return (await res.json());
+}
+// ---------------------------------------------------------------------------
+// MCP result parser
+// ---------------------------------------------------------------------------
+/**
+ * Extract and JSON.parse the text from an MCP tool result content array.
+ * Copied from src/integration.test.ts.
+ */
+export function parseResult(result) {
+    return JSON.parse(result.content[0].text);
+}
+// ---------------------------------------------------------------------------
+// Async utilities
+// ---------------------------------------------------------------------------
+/** Small delay helper for async settling. */
+export const tick = (ms = 100) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Wait for the next parsed JSON message from a WebSocket connection.
+ * Optionally filters by frame type (ignoring non-matching frames).
+ * Times out after the specified duration.
+ */
+export function waitForWsMessage(ws, type, timeoutMs = 5000) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            ws.off("message", handler);
+            reject(new Error(`Timed out waiting for WS message${type ? ` of type "${type}"` : ""}`));
+        }, timeoutMs);
+        const handler = (data) => {
+            const frame = JSON.parse(data.toString());
+            if (!type || frame.type === type) {
+                clearTimeout(timeout);
+                ws.off("message", handler);
+                resolve(frame);
+            }
+        };
+        ws.on("message", handler);
+    });
+}
+/**
+ * Open a WebSocket connection and wait until it's fully open.
+ * Rejects on connection error.
+ */
+export function connectWs(url) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(url);
+        const onClose = (code) => {
+            if (ws.readyState !== WebSocket.OPEN) {
+                reject(new Error(`WebSocket closed during connect with code ${code}`));
+            }
+        };
+        ws.on("open", () => {
+            ws.off("close", onClose);
+            resolve(ws);
+        });
+        ws.on("error", (err) => reject(err));
+        ws.on("close", onClose);
+    });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/e2e/helpers.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+export declare enum BridgeErrorCode {
+    CLI_NOT_FOUND = "CLI_NOT_FOUND",
+    CLI_TIMEOUT = "CLI_TIMEOUT",
+    CLI_EXEC_FAILED = "CLI_EXEC_FAILED",
+    STATE_CORRUPT = "STATE_CORRUPT",
+    STATE_WRITE_FAILED = "STATE_WRITE_FAILED",
+    LOCK_TIMEOUT = "LOCK_TIMEOUT",
+    LOCK_STALE = "LOCK_STALE",
+    PEER_NOT_FOUND = "PEER_NOT_FOUND",
+    INVALID_INPUT = "INVALID_INPUT",
+    STARTUP_FAILED = "STARTUP_FAILED",
+    DIR_NOT_WRITABLE = "DIR_NOT_WRITABLE"
+}
+export declare class BridgeError extends Error {
+    readonly code: BridgeErrorCode;
+    readonly suggestion?: string;
+    constructor(code: BridgeErrorCode, message: string, suggestion?: string);
+}
+export declare function toolResult(text: string, isError?: boolean): {
+    isError?: true | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function errorResult(error: unknown): {
+    isError?: true | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function successResult(data: Record<string, unknown>): {
+    isError?: true | undefined;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;CACtC;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CASxE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;;;;;;EAKzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO;;;;;;EA8BzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;EAE1D"}

package/dist/errors.js

@@ -0,0 +1,53 @@
+export var BridgeErrorCode;
+(function (BridgeErrorCode) {
+    BridgeErrorCode["CLI_NOT_FOUND"] = "CLI_NOT_FOUND";
+    BridgeErrorCode["CLI_TIMEOUT"] = "CLI_TIMEOUT";
+    BridgeErrorCode["CLI_EXEC_FAILED"] = "CLI_EXEC_FAILED";
+    BridgeErrorCode["STATE_CORRUPT"] = "STATE_CORRUPT";
+    BridgeErrorCode["STATE_WRITE_FAILED"] = "STATE_WRITE_FAILED";
+    BridgeErrorCode["LOCK_TIMEOUT"] = "LOCK_TIMEOUT";
+    BridgeErrorCode["LOCK_STALE"] = "LOCK_STALE";
+    BridgeErrorCode["PEER_NOT_FOUND"] = "PEER_NOT_FOUND";
+    BridgeErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    BridgeErrorCode["STARTUP_FAILED"] = "STARTUP_FAILED";
+    BridgeErrorCode["DIR_NOT_WRITABLE"] = "DIR_NOT_WRITABLE";
+})(BridgeErrorCode || (BridgeErrorCode = {}));
+export class BridgeError extends Error {
+    code;
+    suggestion;
+    constructor(code, message, suggestion) {
+        const fullMessage = suggestion
+            ? `${code}: ${message}. ${suggestion}`
+            : `${code}: ${message}`;
+        super(fullMessage);
+        this.name = "BridgeError";
+        this.code = code;
+        this.suggestion = suggestion;
+    }
+}
+export function toolResult(text, isError) {
+    return {
+        content: [{ type: "text", text }],
+        ...(isError ? { isError: true } : {}),
+    };
+}
+export function errorResult(error) {
+    if (error instanceof BridgeError) {
+        return toolResult(JSON.stringify({
+            success: false,
+            error: error.code,
+            message: error.message,
+            suggestion: error.suggestion,
+        }, null, 2), true);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return toolResult(JSON.stringify({
+        success: false,
+        error: "INTERNAL_ERROR",
+        message,
+    }, null, 2), true);
+}
+export function successResult(data) {
+    return toolResult(JSON.stringify(data, null, 2), false);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,eAYX;AAZD,WAAY,eAAe;IACzB,kDAA+B,CAAA;IAC/B,8CAA2B,CAAA;IAC3B,sDAAmC,CAAA;IACnC,kDAA+B,CAAA;IAC/B,4DAAyC,CAAA;IACzC,gDAA6B,CAAA;IAC7B,4CAAyB,CAAA;IACzB,oDAAiC,CAAA;IACjC,kDAA+B,CAAA;IAC/B,oDAAiC,CAAA;IACjC,wDAAqC,CAAA;AACvC,CAAC,EAZW,eAAe,KAAf,eAAe,QAY1B;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,IAAI,CAAkB;IACtB,UAAU,CAAU;IAEpC,YAAY,IAAqB,EAAE,OAAe,EAAE,UAAmB;QACrE,MAAM,WAAW,GAAG,UAAU;YAC5B,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,KAAK,UAAU,EAAE;YACtC,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAiB;IACxD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,UAAU,CACf,IAAI,CAAC,SAAS,CACZ;YACE,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,EACD,IAAI,EACJ,CAAC,CACF,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,UAAU,CACf,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,gBAAgB;QACvB,OAAO;KACR,EACD,IAAI,EACJ,CAAC,CACF,EACD,IAAI,CACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA6B;IACzD,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,108 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SERVER_NAME, SERVER_VERSION } from "./constants.js";
+import { runStartup, cloudWsClient, cloudInbox } from "./startup.js";
+import { logger } from "./logger.js";
+import { registerRegisterPeerTool } from "./tools/register-peer.js";
+import { registerSendMessageTool } from "./tools/send-message.js";
+import { registerListPeersTool } from "./tools/list-peers.js";
+import { registerGetHistoryTool } from "./tools/get-history.js";
+import { registerDeregisterPeerTool } from "./tools/deregister-peer.js";
+import { registerHealthCheckTool } from "./tools/health-check.js";
+import { registerCreateSessionTool } from "./tools/create-session.js";
+import { registerJoinSessionTool } from "./tools/join-session.js";
+// ---------------------------------------------------------------------------
+// Global error handlers -- registered FIRST before anything else
+// ---------------------------------------------------------------------------
+process.on("uncaughtException", (err) => {
+    // EPIPE means the parent process disconnected -- exit cleanly
+    if (err.code === "EPIPE") {
+        logger.close();
+        process.exit(0);
+        return;
+    }
+    logger.error(`Uncaught exception: ${err.message}`, { stack: err.stack });
+    // Do NOT exit -- MCP server should try to continue
+});
+process.on("unhandledRejection", (reason) => {
+    const msg = reason instanceof Error ? reason.message : String(reason);
+    logger.error(`Unhandled rejection: ${msg}`);
+});
+// ---------------------------------------------------------------------------
+// Graceful shutdown handlers
+// ---------------------------------------------------------------------------
+process.on("SIGTERM", () => {
+    logger.info("SIGTERM received, shutting down");
+    if (cloudWsClient) {
+        cloudWsClient.disconnect();
+    }
+    logger.close();
+    process.exit(0);
+});
+process.on("SIGINT", () => {
+    logger.info("SIGINT received, shutting down");
+    if (cloudWsClient) {
+        cloudWsClient.disconnect();
+    }
+    logger.close();
+    process.exit(0);
+});
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+async function main() {
+    // Startup MUST complete before MCP transport starts
+    // (handles first-run prompt, config loading, logger init, validation)
+    await runStartup();
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+    // Register all 8 tools (6 existing + create-session + join-session)
+    registerRegisterPeerTool(server);
+    registerDeregisterPeerTool(server);
+    registerSendMessageTool(server);
+    registerListPeersTool(server);
+    registerGetHistoryTool(server);
+    registerHealthCheckTool(server);
+    registerCreateSessionTool(server);
+    registerJoinSessionTool(server);
+    // Register MCP inbox resource if cloud mode is active
+    if (cloudInbox) {
+        server.registerResource("cogent_inbox", "cogent://inbox", {
+            description: "Incoming messages received via cloud bridge WebSocket. Read this resource to see new messages from other peers.",
+            mimeType: "application/json",
+        }, async (uri) => ({
+            contents: [{
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        messages: cloudInbox.getUnread(),
+                        lastMessageId: cloudInbox.getLastMessageId(),
+                    }),
+                }],
+        }));
+        // When WS messages arrive, notify the MCP host (Claude Code) that new messages are available
+        cloudInbox.onNewMessage(() => {
+            try {
+                server.server.sendResourceUpdated({ uri: "cogent://inbox" });
+            }
+            catch (err) {
+                // sendResourceUpdated may fail if transport is not connected yet
+                logger.warn(`Failed to send resource update notification: ${err}`);
+            }
+        });
+    }
+    // Connect stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Startup banner: always prints regardless of log level
+    process.stderr.write(`${SERVER_NAME} v${SERVER_VERSION} running on stdio\n`);
+    logger.info("Server ready. Tools: cogent_register_peer, cogent_deregister_peer, cogent_send_message, cogent_list_peers, cogent_get_history, cogent_health_check, cogent_create_session, cogent_join_session");
+}
+main().catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.error(`Fatal startup error: ${msg}`);
+    // Fallback to stderr in case logger failed
+    process.stderr.write(`Fatal error: ${msg}\n`);
+    logger.close();
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,22 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare class Logger {
+    private readonly threshold;
+    private textStream;
+    private jsonStream;
+    constructor(level: LogLevel, logDir?: string);
+    private log;
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+    close(): void;
+}
+export declare function createLogger(level: LogLevel, logDir?: string): Logger;
+/** Pre-config logger: stderr-only at info level. Replaced after startup. */
+export declare let logger: Logger;
+/**
+ * Initialize the fully-configured logger with file outputs.
+ * Replaces the module-level `logger` export.
+ */
+export declare function initLogger(level: LogLevel, logDir?: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,UAAU,CAA+B;gBAErC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAsB5C,OAAO,CAAC,GAAG;IAoBX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,KAAK,IAAI,IAAI;CAId;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,4EAA4E;AAC5E,eAAO,IAAI,MAAM,EAAE,MAA2B,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAGjE"}