@compilr-dev/sdk 0.2.2 → 0.2.3

package/dist/index.d.ts

@@ -61,5 +61,7 @@ export { defineTool, createSuccessResult, createErrorResult, mergeHooks, createL
 export type { Tool, HooksConfig, AgentEvent, Message, LLMProvider, AnchorInput, ToolExecutionResult, AgentRunResult, PermissionHandler, ToolPermission, AgentTypeConfig, GuardrailTriggeredHandler, BeforeLLMHookResult, BeforeToolHook, BeforeToolHookResult, AfterToolHook, AgentState, AgentConfig, SessionInfo, Anchor, AnchorScope, AnchorClearOptions, AnchorPriority, AnchorQueryOptions, FileAccessType, FileAccess, GuardrailResult, GuardrailContext, MCPClient, MCPToolDefinition, } from '@compilr-dev/agents';
 export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permissionLevelLabel, } from './permissions.js';
 export type { PermissionRule, PermissionMode, PermissionLevel } from './permissions.js';
+export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';
+export type { MCPServerEntry, MCPConfigFile, ResolvedMCPServer } from './mcp-config.js';
 export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
 export { gitStatusTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, gitStashTool, gitBlameTool, gitFileHistoryTool, detectProjectTool, findProjectRootTool, runTestsTool, runLintTool, runBuildTool, runFormatTool, findDefinitionTool, findReferencesTool, findTodosTool, checkOutdatedTool, findVulnerabilitiesTool, analyzeTestCoverageTool, getFileStructureTool, getComplexityTool, allCodingTools, unifiedTools, } from '@compilr-dev/agents-coding';

package/dist/index.js

@@ -157,6 +157,10 @@ AgentError, ProviderError, ToolError, ToolTimeoutError, MaxIterationsError, Abor
 // =============================================================================
 export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permissionLevelLabel, } from './permissions.js';
 // =============================================================================
+// Shared MCP Configuration
+// =============================================================================
+export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';
+// =============================================================================
 // Individual Tool Re-exports (for consumers that build custom tool registries)
 // =============================================================================
 // Base tools from @compilr-dev/agents

package/dist/mcp-config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * MCP Configuration — shared types and file I/O for mcp.json
+ *
+ * Used by both @compilr-dev/cli and compilr-dev-desktop.
+ * Config format is compatible with Claude Desktop / Gemini CLI.
+ *
+ * File structure:
+ *   { "mcpServers": { "name": { command?, url?, ... } } }
+ */
+/**
+ * Single MCP server entry in the config file.
+ * If `command` is present → stdio transport.
+ * If `url` is present → HTTP transport.
+ */
+export interface MCPServerEntry {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    disabled?: boolean;
+    timeout?: number;
+}
+/**
+ * Shape of the mcp.json config file.
+ */
+export interface MCPConfigFile {
+    mcpServers: Record<string, MCPServerEntry>;
+}
+/**
+ * Resolved MCP server config ready for MCPManager.
+ */
+export interface ResolvedMCPServer {
+    name: string;
+    transport: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Read and parse an mcp.json file. Returns empty record on any error.
+ */
+export declare function readMCPConfigFile(filePath: string): Record<string, MCPServerEntry>;
+/**
+ * Write servers to an mcp.json file (creates directory if needed).
+ */
+export declare function writeMCPConfigFile(filePath: string, servers: Record<string, MCPServerEntry>): void;
+/**
+ * Convert an MCPServerEntry to a ResolvedMCPServer.
+ * Returns null if the entry is invalid (neither command nor url) or disabled.
+ */
+export declare function resolveServerEntry(name: string, entry: MCPServerEntry): ResolvedMCPServer | null;
+/**
+ * Load and resolve MCP servers from one or more config file paths.
+ * Later paths override earlier ones (by server name).
+ */
+export declare function loadMCPServers(...configPaths: string[]): ResolvedMCPServer[];
+/**
+ * Save a single MCP server entry to a config file (add or overwrite by name).
+ */
+export declare function saveMCPServerEntry(filePath: string, name: string, entry: MCPServerEntry): void;
+/**
+ * Delete a single MCP server entry from a config file.
+ */
+export declare function deleteMCPServerEntry(filePath: string, name: string): void;
+/**
+ * Get all server names from one or more config files.
+ */
+export declare function getServerNames(...configPaths: string[]): Set<string>;

package/dist/mcp-config.js

@@ -0,0 +1,124 @@
+/**
+ * MCP Configuration — shared types and file I/O for mcp.json
+ *
+ * Used by both @compilr-dev/cli and compilr-dev-desktop.
+ * Config format is compatible with Claude Desktop / Gemini CLI.
+ *
+ * File structure:
+ *   { "mcpServers": { "name": { command?, url?, ... } } }
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+// =============================================================================
+// File I/O
+// =============================================================================
+/**
+ * Read and parse an mcp.json file. Returns empty record on any error.
+ */
+export function readMCPConfigFile(filePath) {
+    try {
+        if (!existsSync(filePath))
+            return {};
+        const data = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(data);
+        if (parsed.mcpServers && typeof parsed.mcpServers === 'object') {
+            return parsed.mcpServers;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write servers to an mcp.json file (creates directory if needed).
+ */
+export function writeMCPConfigFile(filePath, servers) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const config = { mcpServers: servers };
+    writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+// =============================================================================
+// Resolution
+// =============================================================================
+/**
+ * Convert an MCPServerEntry to a ResolvedMCPServer.
+ * Returns null if the entry is invalid (neither command nor url) or disabled.
+ */
+export function resolveServerEntry(name, entry) {
+    if (entry.disabled)
+        return null;
+    if (entry.command) {
+        return {
+            name,
+            transport: 'stdio',
+            command: entry.command,
+            args: entry.args,
+            env: entry.env,
+            cwd: entry.cwd,
+            timeout: entry.timeout,
+        };
+    }
+    if (entry.url) {
+        return {
+            name,
+            transport: 'http',
+            url: entry.url,
+            headers: entry.headers,
+            timeout: entry.timeout,
+        };
+    }
+    return null;
+}
+// =============================================================================
+// High-level helpers
+// =============================================================================
+/**
+ * Load and resolve MCP servers from one or more config file paths.
+ * Later paths override earlier ones (by server name).
+ */
+export function loadMCPServers(...configPaths) {
+    const merged = {};
+    for (const p of configPaths) {
+        const servers = readMCPConfigFile(p);
+        Object.assign(merged, servers);
+    }
+    const resolved = [];
+    for (const [name, entry] of Object.entries(merged)) {
+        const server = resolveServerEntry(name, entry);
+        if (server)
+            resolved.push(server);
+    }
+    return resolved;
+}
+/**
+ * Save a single MCP server entry to a config file (add or overwrite by name).
+ */
+export function saveMCPServerEntry(filePath, name, entry) {
+    const servers = readMCPConfigFile(filePath);
+    servers[name] = entry;
+    writeMCPConfigFile(filePath, servers);
+}
+/**
+ * Delete a single MCP server entry from a config file.
+ */
+export function deleteMCPServerEntry(filePath, name) {
+    const servers = readMCPConfigFile(filePath);
+    const { [name]: _, ...rest } = servers;
+    writeMCPConfigFile(filePath, rest);
+}
+/**
+ * Get all server names from one or more config files.
+ */
+export function getServerNames(...configPaths) {
+    const names = new Set();
+    for (const p of configPaths) {
+        for (const name of Object.keys(readMCPConfigFile(p))) {
+            names.add(name);
+        }
+    }
+    return names;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",