@openweave/weave-link 0.2.0 → 0.4.0

package/dist/http-transport.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * HTTP Transport — M9: Remote WeaveLink
+ *
+ * Provides an HTTP server with JSON-RPC-style endpoints and
+ * optional Server-Sent Events (SSE) for push notifications.
+ *
+ * Endpoints:
+ *   GET  /              → server info (no auth)
+ *   GET  /health        → liveness check (no auth)
+ *   GET  /tools         → list available tools (auth optional)
+ *   POST /tools/call    → invoke a tool (auth required)
+ *   GET  /events        → SSE stream (auth required)
+ *
+ * Zero runtime dependencies — uses Node built-ins only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpTransport = void 0;
+const node_http_1 = require("node:http");
+const mcp_server_1 = require("./mcp-server");
+const auth_1 = require("./auth");
+/** Maximum number of concurrent SSE clients (VULN-011) */
+const MAX_SSE_CLIENTS = 100;
+/** Maximum request body size in bytes — 1 MB (VULN-010) */
+const MAX_BODY_BYTES = 1_048_576;
+// ──────────────────────────────────────────────────────────
+// WeaveLink HTTP Transport
+// ──────────────────────────────────────────────────────────
+class HttpTransport {
+    server = null;
+    weaveLinkServer;
+    auth;
+    config;
+    sseClients = new Map();
+    startTime = null;
+    constructor(weaveLinkServer, auth, config) {
+        this.weaveLinkServer = weaveLinkServer || new mcp_server_1.WeaveLinkServer();
+        // VULN-009: auth is enabled by default — callers must explicitly disable it for local stdio use
+        this.auth = auth || new auth_1.AuthManager({ enabled: true });
+        this.config = {
+            port: config?.port ?? 3001,
+            host: config?.host ?? '127.0.0.1',
+            // VULN-008: CORS off by default — callers must opt-in with a specific origin
+            cors: config?.cors ?? false,
+            verbose: config?.verbose ?? false,
+        };
+    }
+    // ── Lifecycle ─────────────────────────────────────────────
+    /**
+     * Start listening on the configured port.
+     */
+    async start() {
+        await this.weaveLinkServer.initialize();
+        // VULN-009: refuse to start if auth is on but no keys are configured
+        if (this.auth.isEnabled() && this.auth.getKeyCount() === 0) {
+            throw new Error('[WeaveLink] Cannot start HTTP server: auth is enabled but no API keys are configured. ' +
+                'Provide at least one key via AuthManager or set WEAVE_API_KEY.');
+        }
+        return new Promise((resolve, reject) => {
+            this.server = (0, node_http_1.createServer)((req, res) => this.dispatch(req, res));
+            this.server.on('error', (err) => reject(err));
+            this.server.listen(this.config.port, this.config.host, () => {
+                this.startTime = new Date();
+                if (this.config.verbose) {
+                    console.log(`[WeaveLink] HTTP transport listening on http://${this.config.host}:${this.config.port}`);
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the server and disconnect all SSE clients.
+     */
+    async stop() {
+        // Close all SSE connections
+        for (const client of this.sseClients.values()) {
+            client.res.end();
+        }
+        this.sseClients.clear();
+        return new Promise((resolve, reject) => {
+            if (!this.server)
+                return resolve();
+            this.server.close((err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    isRunning() {
+        return this.server?.listening ?? false;
+    }
+    getPort() {
+        return this.config.port;
+    }
+    getConnectedClients() {
+        return this.sseClients.size;
+    }
+    // ── Request dispatcher ────────────────────────────────────
+    dispatch(req, res) {
+        if (this.config.cors) {
+            res.setHeader('Access-Control-Allow-Origin', '*');
+            res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+            res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-API-Key');
+        }
+        // Preflight
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        const url = new URL(req.url ?? '/', `http://${this.config.host}`);
+        const path = url.pathname;
+        // Public endpoints (no auth)
+        if (path === '/' && req.method === 'GET')
+            return this.handleInfo(req, res);
+        if (path === '/health' && req.method === 'GET')
+            return this.handleHealth(req, res);
+        // Protected endpoints
+        if (path === '/tools' && req.method === 'GET') {
+            return this.auth.middleware(req, res, () => this.handleListTools(req, res));
+        }
+        if (path === '/tools/call' && req.method === 'POST') {
+            return this.auth.middleware(req, res, () => this.handleCallTool(req, res));
+        }
+        if (path === '/events' && req.method === 'GET') {
+            return this.auth.middleware(req, res, () => this.handleSSE(req, res));
+        }
+        // 404
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: `Not found: ${req.method} ${path}` }));
+    }
+    // ── Route handlers ────────────────────────────────────────
+    handleInfo(_req, res) {
+        const info = this.weaveLinkServer.getServerInfo();
+        this.json(res, 200, {
+            ...info,
+            transport: 'http',
+            uptime_ms: this.startTime ? Date.now() - this.startTime.getTime() : 0,
+        });
+    }
+    handleHealth(_req, res) {
+        this.json(res, 200, {
+            status: 'ok',
+            timestamp: new Date().toISOString(),
+            sse_clients: this.sseClients.size,
+        });
+    }
+    handleListTools(_req, res) {
+        const tools = this.weaveLinkServer.listTools();
+        this.json(res, 200, { tools, count: tools.length });
+    }
+    handleCallTool(req, res) {
+        this.readBody(req)
+            .then(async (body) => {
+            let parsed;
+            try {
+                parsed = JSON.parse(body);
+            }
+            catch {
+                this.json(res, 400, { error: 'Invalid JSON body' });
+                return;
+            }
+            const { tool, args = {} } = parsed;
+            if (!tool || typeof tool !== 'string') {
+                this.json(res, 400, { error: 'Missing required field: tool' });
+                return;
+            }
+            const result = await this.weaveLinkServer.callTool(tool, args);
+            // Notify SSE clients of the tool invocation
+            this.broadcast({
+                event: 'tool_called',
+                data: { tool, timestamp: new Date().toISOString() },
+            });
+            this.json(res, 200, result);
+        })
+            .catch((err) => {
+            const e = err;
+            if (e.statusCode === 413) {
+                this.json(res, 413, { error: 'Payload too large — request body must not exceed 1 MB' });
+            }
+            else {
+                this.json(res, 500, { error: `Internal error: ${e.message}` });
+            }
+        });
+    }
+    handleSSE(req, res) {
+        // VULN-011: cap concurrent SSE connections to prevent memory exhaustion
+        if (this.sseClients.size >= MAX_SSE_CLIENTS) {
+            res.writeHead(503, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'SSE connection limit reached — try again later' }));
+            return;
+        }
+        const clientId = `client-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+            'X-Accel-Buffering': 'no', // Disable nginx buffering
+        });
+        // Send a welcome event
+        this.sendSSE(res, 'connected', { clientId, serverTime: new Date().toISOString() });
+        this.sseClients.set(clientId, { id: clientId, res });
+        // Remove client on disconnect
+        req.on('close', () => {
+            this.sseClients.delete(clientId);
+        });
+    }
+    // ── SSE helpers ───────────────────────────────────────────
+    sendSSE(res, event, data) {
+        const payload = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+        res.write(payload);
+    }
+    /**
+     * Broadcast a message to all connected SSE clients.
+     */
+    broadcast(message) {
+        if (this.sseClients.size === 0)
+            return;
+        const payload = `event: ${message.event}\ndata: ${JSON.stringify(message.data)}\n\n`;
+        const toRemove = [];
+        for (const [id, client] of this.sseClients) {
+            try {
+                client.res.write(payload);
+            }
+            catch {
+                // Client disconnected but didn't fire 'close' — clean up
+                toRemove.push(id);
+            }
+        }
+        for (const id of toRemove) {
+            this.sseClients.delete(id);
+        }
+    }
+    // ── Utility ───────────────────────────────────────────────
+    // VULN-010: enforce a 1 MB body limit to prevent memory exhaustion DoS
+    readBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            let totalBytes = 0;
+            req.on('data', (chunk) => {
+                totalBytes += chunk.byteLength;
+                if (totalBytes > MAX_BODY_BYTES) {
+                    req.destroy();
+                    const err = Object.assign(new Error('Payload too large'), { statusCode: 413 });
+                    return reject(err);
+                }
+                chunks.push(chunk);
+            });
+            req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+            req.on('error', reject);
+        });
+    }
+    json(res, status, data) {
+        const body = JSON.stringify(data);
+        res.writeHead(status, {
+            'Content-Type': 'application/json',
+            'Content-Length': Buffer.byteLength(body),
+        });
+        res.end(body);
+    }
+}
+exports.HttpTransport = HttpTransport;
+//# sourceMappingURL=http-transport.js.map

package/dist/http-transport.js.map

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

package/dist/index.d.ts

@@ -2,5 +2,18 @@
  * WeaveLink - MCP Server
  * Model Context Protocol server for integrating WeaveGraph with AI clients
  */
-export declare const version = "0.1.0";
+export * from './types';
+export { ALL_TOOLS, getTool, TOOL_SAVE_NODE, TOOL_QUERY_GRAPH, TOOL_SUPPRESS_ERROR, TOOL_UPDATE_ROADMAP, TOOL_GET_SESSION_CONTEXT, TOOL_GET_NEXT_ACTION, TOOL_LIST_ORPHANS, } from './tools';
+export { WeaveLinkServer } from './mcp-server';
+export { AuthManager, generateApiKey } from './auth';
+export type { AuthConfig, AuthResult } from './auth';
+export { HttpTransport } from './http-transport';
+export type { HttpTransportConfig } from './http-transport';
+export { ConfigGenerator } from './installer/config-generator';
+export type { WeaveLinkConfig, MCPClientEntry, MCPClientsConfig } from './installer/config-generator';
+export { ClaudeDesktopInstaller } from './installer/claude-desktop';
+export type { InstallResult } from './installer/claude-desktop';
+export { CursorInstaller } from './installer/cursor';
+export type { CursorInstallResult, CursorScope } from './installer/cursor';
+export declare const version = "0.2.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,SAAS,EACT,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACtG,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE3E,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,50 @@
+"use strict";
 /**
  * WeaveLink - MCP Server
  * Model Context Protocol server for integrating WeaveGraph with AI clients
  */
-export const version = "0.1.0";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.version = exports.CursorInstaller = exports.ClaudeDesktopInstaller = exports.ConfigGenerator = exports.HttpTransport = exports.generateApiKey = exports.AuthManager = exports.WeaveLinkServer = exports.TOOL_LIST_ORPHANS = exports.TOOL_GET_NEXT_ACTION = exports.TOOL_GET_SESSION_CONTEXT = exports.TOOL_UPDATE_ROADMAP = exports.TOOL_SUPPRESS_ERROR = exports.TOOL_QUERY_GRAPH = exports.TOOL_SAVE_NODE = exports.getTool = exports.ALL_TOOLS = void 0;
+// Core MCP server
+__exportStar(require("./types"), exports);
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "ALL_TOOLS", { enumerable: true, get: function () { return tools_1.ALL_TOOLS; } });
+Object.defineProperty(exports, "getTool", { enumerable: true, get: function () { return tools_1.getTool; } });
+Object.defineProperty(exports, "TOOL_SAVE_NODE", { enumerable: true, get: function () { return tools_1.TOOL_SAVE_NODE; } });
+Object.defineProperty(exports, "TOOL_QUERY_GRAPH", { enumerable: true, get: function () { return tools_1.TOOL_QUERY_GRAPH; } });
+Object.defineProperty(exports, "TOOL_SUPPRESS_ERROR", { enumerable: true, get: function () { return tools_1.TOOL_SUPPRESS_ERROR; } });
+Object.defineProperty(exports, "TOOL_UPDATE_ROADMAP", { enumerable: true, get: function () { return tools_1.TOOL_UPDATE_ROADMAP; } });
+Object.defineProperty(exports, "TOOL_GET_SESSION_CONTEXT", { enumerable: true, get: function () { return tools_1.TOOL_GET_SESSION_CONTEXT; } });
+Object.defineProperty(exports, "TOOL_GET_NEXT_ACTION", { enumerable: true, get: function () { return tools_1.TOOL_GET_NEXT_ACTION; } });
+Object.defineProperty(exports, "TOOL_LIST_ORPHANS", { enumerable: true, get: function () { return tools_1.TOOL_LIST_ORPHANS; } });
+var mcp_server_1 = require("./mcp-server");
+Object.defineProperty(exports, "WeaveLinkServer", { enumerable: true, get: function () { return mcp_server_1.WeaveLinkServer; } });
+// M9 · Remote WeaveLink
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "AuthManager", { enumerable: true, get: function () { return auth_1.AuthManager; } });
+Object.defineProperty(exports, "generateApiKey", { enumerable: true, get: function () { return auth_1.generateApiKey; } });
+var http_transport_1 = require("./http-transport");
+Object.defineProperty(exports, "HttpTransport", { enumerable: true, get: function () { return http_transport_1.HttpTransport; } });
+// M8 · Client Integrations
+var config_generator_1 = require("./installer/config-generator");
+Object.defineProperty(exports, "ConfigGenerator", { enumerable: true, get: function () { return config_generator_1.ConfigGenerator; } });
+var claude_desktop_1 = require("./installer/claude-desktop");
+Object.defineProperty(exports, "ClaudeDesktopInstaller", { enumerable: true, get: function () { return claude_desktop_1.ClaudeDesktopInstaller; } });
+var cursor_1 = require("./installer/cursor");
+Object.defineProperty(exports, "CursorInstaller", { enumerable: true, get: function () { return cursor_1.CursorInstaller; } });
+exports.version = '0.2.0';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,kBAAkB;AAClB,0CAAwB;AACxB,iCAUiB;AATf,kGAAA,SAAS,OAAA;AACT,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,yGAAA,gBAAgB,OAAA;AAChB,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,iHAAA,wBAAwB,OAAA;AACxB,6GAAA,oBAAoB,OAAA;AACpB,0GAAA,iBAAiB,OAAA;AAEnB,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAExB,wBAAwB;AACxB,+BAAqD;AAA5C,mGAAA,WAAW,OAAA;AAAE,sGAAA,cAAc,OAAA;AAEpC,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAGtB,2BAA2B;AAC3B,iEAA+D;AAAtD,mHAAA,eAAe,OAAA;AAExB,6DAAoE;AAA3D,wHAAA,sBAAsB,OAAA;AAE/B,6CAAqD;AAA5C,yGAAA,eAAe,OAAA;AAGX,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/installer/claude-desktop.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Claude Desktop Installer — M8: Client Integrations
+ *
+ * Locates the Claude Desktop MCP config file on the current OS,
+ * reads it, injects the WeaveLink `mcpServers` entry, and writes
+ * the result back to disk.
+ *
+ * Claude Desktop config paths:
+ *   Windows : %APPDATA%\Claude\claude_desktop_config.json
+ *   macOS   : ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   Linux   : ~/.config/Claude/claude_desktop_config.json
+ */
+import { MCPClientsConfig, WeaveLinkConfig } from './config-generator';
+export interface InstallResult {
+    success: boolean;
+    configPath: string;
+    message: string;
+    /** The final JSON written to disk (for inspection/logging) */
+    configWritten?: string;
+}
+export declare class ClaudeDesktopInstaller {
+    /**
+     * Resolve Claude Desktop's config file path for the current OS.
+     */
+    static getConfigPath(): string;
+    /**
+     * Check whether the Claude Desktop config directory exists.
+     * Returns `true` if Claude Desktop appears to be installed.
+     */
+    static isInstalled(configPath?: string): Promise<boolean>;
+    /**
+     * Read the current Claude Desktop config.
+     * Returns an empty `{ mcpServers: {} }` structure if the file doesn't exist yet.
+     */
+    static readConfig(configPath?: string): Promise<MCPClientsConfig>;
+    /**
+     * Install (or update) the WeaveLink entry in Claude Desktop's config.
+     *
+     * @param config  Optional WeaveLink connection config.
+     * @param mode    'stdio' (default) or 'http'.
+     * @param configPath  Override the config file path (useful for testing).
+     */
+    static install(config?: WeaveLinkConfig, mode?: 'stdio' | 'http', configPath?: string): Promise<InstallResult>;
+    /**
+     * Remove the WeaveLink entry from Claude Desktop's config.
+     */
+    static uninstall(configPath?: string): Promise<InstallResult>;
+}
+//# sourceMappingURL=claude-desktop.d.ts.map

package/dist/installer/claude-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../src/installer/claude-desktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAmB,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,qBAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM;IAgB9B;;;OAGG;WACU,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/D;;;OAGG;WACU,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUvE;;;;;;OAMG;WACU,OAAO,CAClB,MAAM,CAAC,EAAE,eAAe,EACxB,IAAI,GAAE,OAAO,GAAG,MAAgB,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC;IAgCzB;;OAEG;WACU,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAkCpE"}

package/dist/installer/claude-desktop.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Claude Desktop Installer — M8: Client Integrations
+ *
+ * Locates the Claude Desktop MCP config file on the current OS,
+ * reads it, injects the WeaveLink `mcpServers` entry, and writes
+ * the result back to disk.
+ *
+ * Claude Desktop config paths:
+ *   Windows : %APPDATA%\Claude\claude_desktop_config.json
+ *   macOS   : ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   Linux   : ~/.config/Claude/claude_desktop_config.json
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeDesktopInstaller = void 0;
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const config_generator_1 = require("./config-generator");
+// ──────────────────────────────────────────────────────────
+// ClaudeDesktopInstaller
+// ──────────────────────────────────────────────────────────
+class ClaudeDesktopInstaller {
+    /**
+     * Resolve Claude Desktop's config file path for the current OS.
+     */
+    static getConfigPath() {
+        const platform = process.platform;
+        if (platform === 'win32') {
+            const appData = process.env['APPDATA'] ?? path.join(os.homedir(), 'AppData', 'Roaming');
+            return path.join(appData, 'Claude', 'claude_desktop_config.json');
+        }
+        if (platform === 'darwin') {
+            return path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+        }
+        // Linux / other
+        return path.join(os.homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+    }
+    /**
+     * Check whether the Claude Desktop config directory exists.
+     * Returns `true` if Claude Desktop appears to be installed.
+     */
+    static async isInstalled(configPath) {
+        const cfgPath = configPath ?? ClaudeDesktopInstaller.getConfigPath();
+        try {
+            await node_fs_1.promises.access(path.dirname(cfgPath));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Read the current Claude Desktop config.
+     * Returns an empty `{ mcpServers: {} }` structure if the file doesn't exist yet.
+     */
+    static async readConfig(configPath) {
+        const cfgPath = configPath ?? ClaudeDesktopInstaller.getConfigPath();
+        try {
+            const raw = await node_fs_1.promises.readFile(cfgPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return { mcpServers: {} };
+        }
+    }
+    /**
+     * Install (or update) the WeaveLink entry in Claude Desktop's config.
+     *
+     * @param config  Optional WeaveLink connection config.
+     * @param mode    'stdio' (default) or 'http'.
+     * @param configPath  Override the config file path (useful for testing).
+     */
+    static async install(config, mode = 'stdio', configPath) {
+        const cfgPath = configPath ?? ClaudeDesktopInstaller.getConfigPath();
+        try {
+            // Ensure the directory exists
+            await node_fs_1.promises.mkdir(path.dirname(cfgPath), { recursive: true });
+            // Read existing config
+            const existing = await ClaudeDesktopInstaller.readConfig(cfgPath);
+            // Merge WeaveLink entry
+            const updated = config_generator_1.ConfigGenerator.mergeIntoExisting(existing, 'openweave', mode, config);
+            const json = config_generator_1.ConfigGenerator.toJSON(updated);
+            // Write back
+            await node_fs_1.promises.writeFile(cfgPath, json, 'utf-8');
+            return {
+                success: true,
+                configPath: cfgPath,
+                message: `WeaveLink MCP entry added to Claude Desktop config.\nRestart Claude Desktop to apply changes.`,
+                configWritten: json,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                configPath: cfgPath,
+                message: `Failed to install: ${err.message}`,
+            };
+        }
+    }
+    /**
+     * Remove the WeaveLink entry from Claude Desktop's config.
+     */
+    static async uninstall(configPath) {
+        const cfgPath = configPath ?? ClaudeDesktopInstaller.getConfigPath();
+        try {
+            const existing = await ClaudeDesktopInstaller.readConfig(cfgPath);
+            if (!existing.mcpServers?.['openweave']) {
+                return {
+                    success: true,
+                    configPath: cfgPath,
+                    message: 'WeaveLink entry not found — nothing to remove.',
+                };
+            }
+            const { ['openweave']: _removed, ...rest } = existing.mcpServers;
+            const updated = { ...existing, mcpServers: rest };
+            const json = config_generator_1.ConfigGenerator.toJSON(updated);
+            await node_fs_1.promises.writeFile(cfgPath, json, 'utf-8');
+            return {
+                success: true,
+                configPath: cfgPath,
+                message: 'WeaveLink MCP entry removed from Claude Desktop config.',
+                configWritten: json,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                configPath: cfgPath,
+                message: `Failed to uninstall: ${err.message}`,
+            };
+        }
+    }
+}
+exports.ClaudeDesktopInstaller = ClaudeDesktopInstaller;
+//# sourceMappingURL=claude-desktop.js.map

package/dist/installer/claude-desktop.js.map

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

package/dist/installer/config-generator.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Config Generator — M8: Client Integrations
+ *
+ * Generates MCP server configuration objects compatible with
+ * Claude Desktop, Cursor, VS Code, and other MCP clients.
+ */
+export interface WeaveLinkConfig {
+    host?: string;
+    port?: number;
+    apiKey?: string;
+}
+export interface MCPClientEntry {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+}
+export interface MCPClientsConfig {
+    mcpServers: Record<string, MCPClientEntry>;
+}
+export declare class ConfigGenerator {
+    /**
+     * Generate an MCP stdio-mode entry for a client's config file.
+     * This is the standard mode for Claude Desktop and Cursor.
+     *
+     * The entry runs `weave-link start` via `npx` so no global install is needed.
+     */
+    static stdioEntry(config?: WeaveLinkConfig): MCPClientEntry;
+    /**
+     * Generate an MCP HTTP-mode entry for remote WeaveLink connections.
+     */
+    static httpEntry(config?: WeaveLinkConfig): MCPClientEntry;
+    /**
+     * Build a full `mcpServers` config block, ready to merge into the client's JSON.
+     */
+    static buildMCPConfig(serverName?: string, mode?: 'stdio' | 'http', config?: WeaveLinkConfig): MCPClientsConfig;
+    /**
+     * Format a config object as indented JSON for writing to disk.
+     */
+    static toJSON(config: unknown): string;
+    /**
+     * Deep-merge a WeaveLink entry into an existing client config object.
+     * Preserves all existing `mcpServers` entries and only overwrites the
+     * `openweave` key.
+     */
+    static mergeIntoExisting(existing: MCPClientsConfig, serverName?: string, mode?: 'stdio' | 'http', config?: WeaveLinkConfig): MCPClientsConfig;
+}
+//# sourceMappingURL=config-generator.d.ts.map

package/dist/installer/config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-generator.d.ts","sourceRoot":"","sources":["../../src/installer/config-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAMD,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,cAAc;IAoB3D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,cAAc;IAkB1D;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,UAAU,SAAc,EACxB,IAAI,GAAE,OAAO,GAAG,MAAgB,EAChC,MAAM,CAAC,EAAE,eAAe,GACvB,gBAAgB;IAYnB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAItC;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,SAAc,EACxB,IAAI,GAAE,OAAO,GAAG,MAAgB,EAChC,MAAM,CAAC,EAAE,eAAe,GACvB,gBAAgB;CAapB"}