@cdoing/core 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * MCP (Model Context Protocol) Server Support
+ *
+ * MCP is an open protocol that lets AI models connect to external
+ * data sources and tools. Think of it as "USB for AI" — a standard
+ * way to plug in capabilities.
+ *
+ * How it works:
+ *   1. User configures MCP servers in .cdoing/mcp.json or settings
+ *   2. On startup, we connect to each configured server
+ *   3. Discover available tools from each server
+ *   4. Register those tools so the agent can call them
+ *   5. Route tool calls through the MCP protocol
+ *
+ * Configuration format (.cdoing/mcp.json):
+ *   {
+ *     "servers": [
+ *       {
+ *         "name": "jira",
+ *         "command": "npx",
+ *         "args": ["-y", "@modelcontextprotocol/server-jira"],
+ *         "env": { "JIRA_URL": "https://..." }
+ *       }
+ *     ]
+ *   }
+ *
+ * Learning note: MCP uses JSON-RPC over stdio or SSE (Server-Sent Events).
+ * Each server is a separate process that we spawn and communicate with
+ * through its stdin/stdout. This isolation means a buggy MCP server
+ * can't crash the main agent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpManager = void 0;
+var manager_1 = require("./manager");
+Object.defineProperty(exports, "McpManager", { enumerable: true, get: function () { return manager_1.McpManager; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;AAEH,qCAA2E;AAAlE,qGAAA,UAAU,OAAA"}

package/dist/mcp/manager.d.ts

@@ -0,0 +1,123 @@
+/**
+ * MCP Manager — Manages connections to MCP (Model Context Protocol) servers.
+ *
+ * Handles:
+ *   - Loading server configurations
+ *   - Spawning and connecting to server processes
+ *   - Tool discovery (listing available tools from each server)
+ *   - Routing tool calls to the correct server
+ *   - Graceful shutdown of server processes
+ *
+ * Learning note: This uses JSON-RPC 2.0 over stdio for communication.
+ * Each message is a JSON object separated by newlines. The protocol
+ * is stateless — each request gets exactly one response.
+ */
+/**
+ * Configuration for a single MCP server.
+ */
+export interface McpServerConfig {
+    /** Human-readable name for this server */
+    name: string;
+    /** Command to run the server (e.g., "npx", "python") */
+    command: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Environment variables for the server process */
+    env?: Record<string, string>;
+    /** Working directory for the server */
+    cwd?: string;
+    /** Whether this server is enabled (default: true) */
+    enabled?: boolean;
+}
+/**
+ * A tool discovered from an MCP server.
+ */
+export interface McpTool {
+    /** Tool name (namespaced: "server_name.tool_name") */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for the tool's input parameters */
+    inputSchema: Record<string, unknown>;
+    /** Which MCP server provides this tool */
+    serverName: string;
+}
+export declare class McpManager {
+    /** Active server connections */
+    private connections;
+    /** Working directory for resolving config paths */
+    private workingDir;
+    constructor(workingDir: string);
+    /**
+     * Load MCP server configurations from config files.
+     *
+     * Checks these locations (in order):
+     *   1. .cdoing/mcp.json (project-specific)
+     *   2. ~/.cdoing/mcp.json (global)
+     *
+     * Learning note: Project configs take precedence over global ones.
+     * This lets you have project-specific MCP servers (e.g., a Jira
+     * server for one project, a Notion server for another).
+     */
+    loadConfig(): McpServerConfig[];
+    /**
+     * Connect to all configured MCP servers.
+     * Spawns each server process and discovers its tools.
+     */
+    connectAll(): Promise<void>;
+    /**
+     * Connect to a single MCP server.
+     *
+     * Learning note: We spawn the server as a child process and
+     * communicate via JSON-RPC over stdio. The "initialize" handshake
+     * tells the server our capabilities, and "tools/list" discovers
+     * what tools it offers.
+     */
+    connect(config: McpServerConfig): Promise<void>;
+    /**
+     * Send a JSON-RPC request to an MCP server.
+     *
+     * Learning note: JSON-RPC uses numeric IDs to match requests
+     * with responses. We store pending requests in a Map and resolve
+     * the Promise when we get the matching response.
+     */
+    private sendRequest;
+    /**
+     * Handle an incoming message from an MCP server.
+     */
+    private handleServerMessage;
+    /**
+     * Get all tools from all connected MCP servers.
+     */
+    getAllTools(): McpTool[];
+    /**
+     * Call a tool on an MCP server.
+     *
+     * @param toolName - Namespaced tool name (e.g., "jira_create_issue")
+     * @param input - Tool input parameters
+     * @returns Tool execution result
+     */
+    callTool(toolName: string, input: Record<string, unknown>): Promise<{
+        success: boolean;
+        output: string;
+        error?: string;
+    }>;
+    /**
+     * Check if a tool name belongs to an MCP server.
+     */
+    isMcpTool(toolName: string): boolean;
+    /**
+     * Get connected server names.
+     */
+    getConnectedServers(): string[];
+    /**
+     * Disconnect from all MCP servers.
+     * Sends a graceful shutdown signal to each server process.
+     */
+    disconnectAll(): Promise<void>;
+    /**
+     * Update the working directory.
+     */
+    setWorkingDir(dir: string): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/mcp/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/mcp/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAiBD,qBAAa,UAAU;IACrB,gCAAgC;IAChC,OAAO,CAAC,WAAW,CAAoC;IAEvD,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAI9B;;;;;;;;;;OAUG;IACH,UAAU,IAAI,eAAe,EAAE;IA8B/B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA+ErD;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAQxB;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QACxE,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA8BF;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASpC;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGjC"}

package/dist/mcp/manager.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * MCP Manager — Manages connections to MCP (Model Context Protocol) servers.
+ *
+ * Handles:
+ *   - Loading server configurations
+ *   - Spawning and connecting to server processes
+ *   - Tool discovery (listing available tools from each server)
+ *   - Routing tool calls to the correct server
+ *   - Graceful shutdown of server processes
+ *
+ * Learning note: This uses JSON-RPC 2.0 over stdio for communication.
+ * Each message is a JSON object separated by newlines. The protocol
+ * is stateless — each request gets exactly one response.
+ */
+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.McpManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+class McpManager {
+    /** Active server connections */
+    connections = new Map();
+    /** Working directory for resolving config paths */
+    workingDir;
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+    }
+    /**
+     * Load MCP server configurations from config files.
+     *
+     * Checks these locations (in order):
+     *   1. .cdoing/mcp.json (project-specific)
+     *   2. ~/.cdoing/mcp.json (global)
+     *
+     * Learning note: Project configs take precedence over global ones.
+     * This lets you have project-specific MCP servers (e.g., a Jira
+     * server for one project, a Notion server for another).
+     */
+    loadConfig() {
+        const configs = [];
+        const paths = [
+            path.join(this.workingDir, ".cdoing", "mcp.json"),
+            path.join(os.homedir(), ".cdoing", "mcp.json"),
+        ];
+        for (const configPath of paths) {
+            try {
+                if (fs.existsSync(configPath)) {
+                    const raw = fs.readFileSync(configPath, "utf-8");
+                    const parsed = JSON.parse(raw);
+                    if (parsed.servers && Array.isArray(parsed.servers)) {
+                        for (const server of parsed.servers) {
+                            // Don't add duplicates (project config overrides global)
+                            if (!configs.some((c) => c.name === server.name)) {
+                                configs.push(server);
+                            }
+                        }
+                    }
+                }
+            }
+            catch {
+                // Skip invalid config files
+            }
+        }
+        return configs;
+    }
+    /**
+     * Connect to all configured MCP servers.
+     * Spawns each server process and discovers its tools.
+     */
+    async connectAll() {
+        const configs = this.loadConfig();
+        for (const config of configs) {
+            if (config.enabled === false)
+                continue;
+            try {
+                await this.connect(config);
+            }
+            catch (err) {
+                console.error(`[MCP] Failed to connect to ${config.name}:`, err);
+            }
+        }
+    }
+    /**
+     * Connect to a single MCP server.
+     *
+     * Learning note: We spawn the server as a child process and
+     * communicate via JSON-RPC over stdio. The "initialize" handshake
+     * tells the server our capabilities, and "tools/list" discovers
+     * what tools it offers.
+     */
+    async connect(config) {
+        // Spawn the server process
+        const child = (0, child_process_1.spawn)(config.command, config.args || [], {
+            cwd: config.cwd || this.workingDir,
+            env: { ...process.env, ...config.env },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const connection = {
+            config,
+            process: child,
+            tools: [],
+            requestId: 0,
+            pendingRequests: new Map(),
+            buffer: "",
+        };
+        // Handle incoming messages from the server
+        child.stdout?.on("data", (data) => {
+            connection.buffer += data.toString();
+            // Process complete JSON-RPC messages (delimited by newlines)
+            let newlineIndex;
+            while ((newlineIndex = connection.buffer.indexOf("\n")) >= 0) {
+                const line = connection.buffer.substring(0, newlineIndex).trim();
+                connection.buffer = connection.buffer.substring(newlineIndex + 1);
+                if (!line)
+                    continue;
+                try {
+                    const message = JSON.parse(line);
+                    this.handleServerMessage(config.name, message, connection);
+                }
+                catch {
+                    // Skip non-JSON lines (e.g., server startup logs)
+                }
+            }
+        });
+        // Handle server errors
+        child.stderr?.on("data", (data) => {
+            // Log but don't crash — server stderr is often debug output
+            const text = data.toString().trim();
+            if (text) {
+                console.error(`[MCP:${config.name}] ${text}`);
+            }
+        });
+        child.on("exit", (code) => {
+            this.connections.delete(config.name);
+        });
+        this.connections.set(config.name, connection);
+        // Perform MCP handshake
+        try {
+            await this.sendRequest(config.name, "initialize", {
+                protocolVersion: "2024-11-05",
+                capabilities: {},
+                clientInfo: { name: "cdoing-agent", version: "0.1.0" },
+            });
+            // Discover tools
+            const toolsResult = await this.sendRequest(config.name, "tools/list", {});
+            if (toolsResult?.tools) {
+                connection.tools = toolsResult.tools.map((t) => ({
+                    name: `${config.name}_${t.name}`,
+                    description: `[${config.name}] ${t.description || t.name}`,
+                    inputSchema: t.inputSchema || { type: "object", properties: {} },
+                    serverName: config.name,
+                }));
+            }
+        }
+        catch (err) {
+            // If handshake fails, clean up
+            child.kill();
+            this.connections.delete(config.name);
+            throw err;
+        }
+    }
+    /**
+     * Send a JSON-RPC request to an MCP server.
+     *
+     * Learning note: JSON-RPC uses numeric IDs to match requests
+     * with responses. We store pending requests in a Map and resolve
+     * the Promise when we get the matching response.
+     */
+    sendRequest(serverName, method, params) {
+        const connection = this.connections.get(serverName);
+        if (!connection) {
+            return Promise.reject(new Error(`MCP server not connected: ${serverName}`));
+        }
+        return new Promise((resolve, reject) => {
+            const id = ++connection.requestId;
+            connection.pendingRequests.set(id, { resolve, reject });
+            const message = JSON.stringify({
+                jsonrpc: "2.0",
+                id,
+                method,
+                params,
+            });
+            connection.process.stdin?.write(message + "\n");
+            // Timeout after 30 seconds
+            setTimeout(() => {
+                const pending = connection.pendingRequests.get(id);
+                if (pending) {
+                    connection.pendingRequests.delete(id);
+                    pending.reject(new Error(`MCP request timeout: ${method}`));
+                }
+            }, 30000);
+        });
+    }
+    /**
+     * Handle an incoming message from an MCP server.
+     */
+    handleServerMessage(serverName, message, connection) {
+        // JSON-RPC response (has an "id" field)
+        if (message.id !== undefined) {
+            const pending = connection.pendingRequests.get(message.id);
+            if (pending) {
+                connection.pendingRequests.delete(message.id);
+                if (message.error) {
+                    pending.reject(new Error(message.error.message || "MCP error"));
+                }
+                else {
+                    pending.resolve(message.result);
+                }
+            }
+        }
+        // JSON-RPC notification (no "id" field) — log but ignore
+    }
+    /**
+     * Get all tools from all connected MCP servers.
+     */
+    getAllTools() {
+        const tools = [];
+        for (const connection of this.connections.values()) {
+            tools.push(...connection.tools);
+        }
+        return tools;
+    }
+    /**
+     * Call a tool on an MCP server.
+     *
+     * @param toolName - Namespaced tool name (e.g., "jira_create_issue")
+     * @param input - Tool input parameters
+     * @returns Tool execution result
+     */
+    async callTool(toolName, input) {
+        // Find which server provides this tool
+        for (const connection of this.connections.values()) {
+            const tool = connection.tools.find((t) => t.name === toolName);
+            if (tool) {
+                // Strip the server name prefix to get the original tool name
+                const originalName = toolName.replace(`${tool.serverName}_`, "");
+                try {
+                    const result = await this.sendRequest(tool.serverName, "tools/call", {
+                        name: originalName,
+                        arguments: input,
+                    });
+                    // MCP tool results have a "content" array
+                    const output = result?.content
+                        ?.map((c) => c.text || JSON.stringify(c))
+                        .join("\n") || JSON.stringify(result);
+                    return { success: true, output };
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    return { success: false, output: "", error: message };
+                }
+            }
+        }
+        return { success: false, output: "", error: `Unknown MCP tool: ${toolName}` };
+    }
+    /**
+     * Check if a tool name belongs to an MCP server.
+     */
+    isMcpTool(toolName) {
+        for (const connection of this.connections.values()) {
+            if (connection.tools.some((t) => t.name === toolName)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get connected server names.
+     */
+    getConnectedServers() {
+        return Array.from(this.connections.keys());
+    }
+    /**
+     * Disconnect from all MCP servers.
+     * Sends a graceful shutdown signal to each server process.
+     */
+    async disconnectAll() {
+        for (const [name, connection] of this.connections) {
+            try {
+                connection.process.kill("SIGTERM");
+            }
+            catch {
+                // Process may already be dead
+            }
+        }
+        this.connections.clear();
+    }
+    /**
+     * Update the working directory.
+     */
+    setWorkingDir(dir) {
+        this.workingDir = dir;
+    }
+}
+exports.McpManager = McpManager;
+//# sourceMappingURL=manager.js.map

package/dist/mcp/manager.js.map

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

package/dist/oauth.d.ts

@@ -0,0 +1,33 @@
+/**
+ * OAuth 2.0 (PKCE) for Claude — Shared Core Module
+ *
+ * All credential storage, token management, and OAuth flow logic lives here.
+ * Both CLI and VS Code extension import from this module.
+ *
+ * Credential storage:
+ *  - macOS: encrypted Keychain via `security` CLI
+ *  - Linux: libsecret via `secret-tool` if available, else file fallback
+ *  - Windows: Windows Credential Manager via `cmdkey`, else file fallback
+ */
+export interface OAuthTokens {
+    access_token: string;
+    refresh_token?: string;
+    expires_at?: number;
+    token_type: string;
+}
+export declare function saveOAuthTokens(tokens: OAuthTokens): void;
+export declare function loadOAuthTokens(): OAuthTokens | null;
+export declare function clearOAuthTokens(): void;
+export declare function isOAuthExpired(tokens: OAuthTokens): boolean;
+export declare function refreshAccessToken(refreshToken: string): Promise<OAuthTokens | null>;
+export declare function resolveOAuthToken(): Promise<string | null>;
+export declare function generateOAuthUrl(): {
+    url: string;
+    codeVerifier: string;
+};
+export declare function exchangeOAuthCode(code: string, codeVerifier: string): Promise<OAuthTokens>;
+export declare function getOAuthStatus(): {
+    status: "none" | "active" | "expired";
+    expiresAt?: number;
+};
+//# sourceMappingURL=oauth.d.ts.map

package/dist/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAEzD;AAED,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CASpD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAG3D;AAID,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA2B1F;AAID,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUhE;AAID,wBAAgB,gBAAgB,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAgBxE;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8BhG;AAID,wBAAgB,cAAc,IAAI;IAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAK9F"}