@openweave/weave-link 0.2.0 → 0.5.0

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"}

package/dist/installer/config-generator.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Config Generator — M8: Client Integrations
+ *
+ * Generates MCP server configuration objects compatible with
+ * Claude Desktop, Cursor, VS Code, and other MCP clients.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigGenerator = void 0;
+// ──────────────────────────────────────────────────────────
+// ConfigGenerator
+// ──────────────────────────────────────────────────────────
+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) {
+        const args = ['@openweave/weave-link', 'start', '--mode', 'stdio'];
+        if (config?.port) {
+            args.push('--port', String(config.port));
+        }
+        const env = {};
+        if (config?.apiKey) {
+            env['WEAVE_API_KEY'] = config.apiKey;
+        }
+        const entry = { command: 'npx', args };
+        if (Object.keys(env).length > 0) {
+            entry.env = env;
+        }
+        return entry;
+    }
+    /**
+     * Generate an MCP HTTP-mode entry for remote WeaveLink connections.
+     */
+    static httpEntry(config) {
+        const host = config?.host ?? '127.0.0.1';
+        const port = config?.port ?? 3001;
+        const args = ['@openweave/weave-link', 'start', '--mode', 'http', '--port', String(port), '--host', host];
+        const env = {};
+        if (config?.apiKey) {
+            env['WEAVE_API_KEY'] = config.apiKey;
+        }
+        const entry = { command: 'npx', args };
+        if (Object.keys(env).length > 0) {
+            entry.env = env;
+        }
+        return entry;
+    }
+    /**
+     * Build a full `mcpServers` config block, ready to merge into the client's JSON.
+     */
+    static buildMCPConfig(serverName = 'openweave', mode = 'stdio', config) {
+        const entry = mode === 'http'
+            ? ConfigGenerator.httpEntry(config)
+            : ConfigGenerator.stdioEntry(config);
+        return {
+            mcpServers: {
+                [serverName]: entry,
+            },
+        };
+    }
+    /**
+     * Format a config object as indented JSON for writing to disk.
+     */
+    static toJSON(config) {
+        return JSON.stringify(config, null, 2);
+    }
+    /**
+     * 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, serverName = 'openweave', mode = 'stdio', config) {
+        const entry = mode === 'http'
+            ? ConfigGenerator.httpEntry(config)
+            : ConfigGenerator.stdioEntry(config);
+        return {
+            ...existing,
+            mcpServers: {
+                ...(existing.mcpServers ?? {}),
+                [serverName]: entry,
+            },
+        };
+    }
+}
+exports.ConfigGenerator = ConfigGenerator;
+//# sourceMappingURL=config-generator.js.map

package/dist/installer/config-generator.js.map

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

package/dist/installer/cursor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Cursor Installer — M8: Client Integrations
+ *
+ * Generates or updates Cursor's MCP config file.
+ *
+ * Cursor MCP config path:
+ *   Global : ~/.cursor/mcp.json
+ *   Project: <workspaceRoot>/.cursor/mcp.json
+ *
+ * The project-level config takes priority over the global one.
+ */
+import { MCPClientsConfig, WeaveLinkConfig } from './config-generator';
+export type CursorScope = 'global' | 'project';
+export interface CursorInstallResult {
+    success: boolean;
+    configPath: string;
+    scope: CursorScope;
+    message: string;
+    configWritten?: string;
+}
+export declare class CursorInstaller {
+    /**
+     * Resolve the Cursor MCP config path for the given scope.
+     *
+     * @param scope         'global' (default) or 'project'
+     * @param workspaceRoot Required when scope is 'project'
+     */
+    static getConfigPath(scope?: CursorScope, workspaceRoot?: string): string;
+    /**
+     * Read the current Cursor MCP config.
+     * Returns `{ mcpServers: {} }` if the file doesn't exist yet.
+     */
+    static readConfig(configPath: string): Promise<MCPClientsConfig>;
+    /**
+     * Install (or update) the WeaveLink entry in Cursor's MCP config.
+     *
+     * @param scope         'global' (default) or 'project'
+     * @param workspaceRoot Path to workspace root (required for project scope)
+     * @param config        Optional WeaveLink connection config
+     * @param mode          'stdio' (default) or 'http'
+     */
+    static install(scope?: CursorScope, workspaceRoot?: string, config?: WeaveLinkConfig, mode?: 'stdio' | 'http'): Promise<CursorInstallResult>;
+    /**
+     * Remove the WeaveLink entry from Cursor's MCP config.
+     */
+    static uninstall(scope?: CursorScope, workspaceRoot?: string): Promise<CursorInstallResult>;
+    /**
+     * Check if Cursor is installed by looking for the ~/.cursor directory.
+     */
+    static isInstalled(): Promise<boolean>;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/installer/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/installer/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAmB,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExF,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,GAAE,WAAsB,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM;IAQnF;;;OAGG;WACU,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAStE;;;;;;;OAOG;WACU,OAAO,CAClB,KAAK,GAAE,WAAsB,EAC7B,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,eAAe,EACxB,IAAI,GAAE,OAAO,GAAG,MAAgB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IA6B/B;;OAEG;WACU,SAAS,CACpB,KAAK,GAAE,WAAsB,EAC7B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC;IAsC/B;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ7C"}

package/dist/installer/cursor.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Cursor Installer — M8: Client Integrations
+ *
+ * Generates or updates Cursor's MCP config file.
+ *
+ * Cursor MCP config path:
+ *   Global : ~/.cursor/mcp.json
+ *   Project: <workspaceRoot>/.cursor/mcp.json
+ *
+ * The project-level config takes priority over the global one.
+ */
+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.CursorInstaller = 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");
+// ──────────────────────────────────────────────────────────
+// CursorInstaller
+// ──────────────────────────────────────────────────────────
+class CursorInstaller {
+    /**
+     * Resolve the Cursor MCP config path for the given scope.
+     *
+     * @param scope         'global' (default) or 'project'
+     * @param workspaceRoot Required when scope is 'project'
+     */
+    static getConfigPath(scope = 'global', workspaceRoot) {
+        if (scope === 'project') {
+            const root = workspaceRoot ?? process.cwd();
+            return path.join(root, '.cursor', 'mcp.json');
+        }
+        return path.join(os.homedir(), '.cursor', 'mcp.json');
+    }
+    /**
+     * Read the current Cursor MCP config.
+     * Returns `{ mcpServers: {} }` if the file doesn't exist yet.
+     */
+    static async readConfig(configPath) {
+        try {
+            const raw = await node_fs_1.promises.readFile(configPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return { mcpServers: {} };
+        }
+    }
+    /**
+     * Install (or update) the WeaveLink entry in Cursor's MCP config.
+     *
+     * @param scope         'global' (default) or 'project'
+     * @param workspaceRoot Path to workspace root (required for project scope)
+     * @param config        Optional WeaveLink connection config
+     * @param mode          'stdio' (default) or 'http'
+     */
+    static async install(scope = 'global', workspaceRoot, config, mode = 'stdio') {
+        const cfgPath = CursorInstaller.getConfigPath(scope, workspaceRoot);
+        try {
+            await node_fs_1.promises.mkdir(path.dirname(cfgPath), { recursive: true });
+            const existing = await CursorInstaller.readConfig(cfgPath);
+            const updated = config_generator_1.ConfigGenerator.mergeIntoExisting(existing, 'openweave', mode, config);
+            const json = config_generator_1.ConfigGenerator.toJSON(updated);
+            await node_fs_1.promises.writeFile(cfgPath, json, 'utf-8');
+            return {
+                success: true,
+                configPath: cfgPath,
+                scope,
+                message: `WeaveLink MCP entry added to Cursor ${scope} config.\nRestart Cursor to apply changes.`,
+                configWritten: json,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                configPath: cfgPath,
+                scope,
+                message: `Failed to install: ${err.message}`,
+            };
+        }
+    }
+    /**
+     * Remove the WeaveLink entry from Cursor's MCP config.
+     */
+    static async uninstall(scope = 'global', workspaceRoot) {
+        const cfgPath = CursorInstaller.getConfigPath(scope, workspaceRoot);
+        try {
+            const existing = await CursorInstaller.readConfig(cfgPath);
+            if (!existing.mcpServers?.['openweave']) {
+                return {
+                    success: true,
+                    configPath: cfgPath,
+                    scope,
+                    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,
+                scope,
+                message: `WeaveLink MCP entry removed from Cursor ${scope} config.`,
+                configWritten: json,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                configPath: cfgPath,
+                scope,
+                message: `Failed to uninstall: ${err.message}`,
+            };
+        }
+    }
+    /**
+     * Check if Cursor is installed by looking for the ~/.cursor directory.
+     */
+    static async isInstalled() {
+        try {
+            await node_fs_1.promises.access(path.join(os.homedir(), '.cursor'));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.CursorInstaller = CursorInstaller;
+//# sourceMappingURL=cursor.js.map

package/dist/installer/cursor.js.map

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

package/dist/installer/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Installer — M8: Client Integrations
+ * Exports all client installers
+ */
+export type { WeaveLinkConfig, MCPClientEntry, MCPClientsConfig } from './config-generator';
+export { ConfigGenerator } from './config-generator';
+export type { InstallResult } from './claude-desktop';
+export { ClaudeDesktopInstaller } from './claude-desktop';
+export type { CursorInstallResult, CursorScope } from './cursor';
+export { CursorInstaller } from './cursor';
+//# sourceMappingURL=index.d.ts.map

package/dist/installer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/installer/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Installer — M8: Client Integrations
+ * Exports all client installers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CursorInstaller = exports.ClaudeDesktopInstaller = exports.ConfigGenerator = void 0;
+var config_generator_1 = require("./config-generator");
+Object.defineProperty(exports, "ConfigGenerator", { enumerable: true, get: function () { return config_generator_1.ConfigGenerator; } });
+var claude_desktop_1 = require("./claude-desktop");
+Object.defineProperty(exports, "ClaudeDesktopInstaller", { enumerable: true, get: function () { return claude_desktop_1.ClaudeDesktopInstaller; } });
+var cursor_1 = require("./cursor");
+Object.defineProperty(exports, "CursorInstaller", { enumerable: true, get: function () { return cursor_1.CursorInstaller; } });
+//# sourceMappingURL=index.js.map

package/dist/installer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,mDAA0D;AAAjD,wHAAA,sBAAsB,OAAA;AAG/B,mCAA2C;AAAlC,yGAAA,eAAe,OAAA"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,75 @@
+import { MCPServerConfig, MCPResponse, MCPTool } from "./types";
+export declare class WeaveLinkServer {
+    private config;
+    private sessions;
+    constructor(config?: MCPServerConfig);
+    /**
+     * Initialize server (setup, load state, etc.)
+     */
+    initialize(): Promise<void>;
+    /**
+     * List available tools
+     */
+    listTools(): MCPTool[];
+    /**
+     * Get tool by name
+     */
+    getTool(name: string): MCPTool | undefined;
+    /**
+     * Handle tool call
+     */
+    callTool(toolName: string, args: Record<string, unknown>): Promise<MCPResponse<unknown>>;
+    /**
+     * Handler: save_node
+     */
+    private handleSaveNode;
+    /**
+     * Handler: query_graph
+     */
+    private handleQueryGraph;
+    /**
+     * Handler: suppress_error
+     */
+    private handleSuppressError;
+    /**
+     * Handler: update_roadmap
+     */
+    private handleUpdateRoadmap;
+    /**
+     * Handler: get_session_context
+     */
+    private handleGetSessionContext;
+    /**
+     * Handler: get_next_action
+     */
+    private handleGetNextAction;
+    /**
+     * Handler: list_orphans
+     */
+    private handleListOrphans;
+    /**
+     * Helper: get or create session
+     */
+    private getOrCreateSession;
+    /**
+     * Helper: success response
+     */
+    private success;
+    /**
+     * Helper: error response
+     */
+    private error;
+    /**
+     * Get server info
+     */
+    getServerInfo(): {
+        name: string | undefined;
+        version: string | undefined;
+        description: string | undefined;
+        tools: {
+            name: string;
+            description: string;
+        }[];
+    };
+}
+//# sourceMappingURL=mcp-server.d.ts.map