agentinit 1.4.1 → 1.6.0

package/dist/agents/ClaudeAgent.js

@@ -0,0 +1,249 @@
+import { Agent } from './Agent.js';
+import { readFileIfExists, writeFile, ensureDirectoryExists } from '../utils/fs.js';
+/**
+ * Claude Code agent implementation
+ * Supports full MCP capabilities including stdio, HTTP, and SSE servers
+ * Native config: .mcp.json
+ * Global config: ~/.claude.json
+ *
+ * Note: Claude Code uses a unique MCP configuration format:
+ * - stdio servers: { command, args?, env? }
+ * - http servers: { type: "http", url, headers? }
+ * - sse servers: { type: "sse", url, headers? }
+ */
+export class ClaudeAgent extends Agent {
+    constructor() {
+        const definition = {
+            id: 'claude',
+            name: 'Claude Code',
+            url: 'https://docs.anthropic.com/claude/docs/claude-code',
+            capabilities: {
+                mcp: {
+                    stdio: true,
+                    http: true,
+                    sse: true
+                },
+                rules: true,
+                hooks: true,
+                commands: true,
+                subagents: true,
+                statusline: true
+            },
+            configFiles: [
+                {
+                    path: 'CLAUDE.md',
+                    purpose: 'rules',
+                    format: 'markdown',
+                    type: 'file',
+                    optional: true,
+                    description: 'Claude-specific configuration and rules'
+                },
+                {
+                    path: '.claude/config.md',
+                    purpose: 'rules',
+                    format: 'markdown',
+                    type: 'file',
+                    optional: true,
+                    description: 'Alternative Claude configuration file'
+                }
+            ],
+            nativeConfigPath: '.mcp.json',
+            globalConfigPath: '~/.claude.json'
+        };
+        super(definition);
+    }
+    /**
+     * Apply MCP configuration to Claude's native .mcp.json format
+     */
+    async applyMCPConfig(projectPath, servers) {
+        const mcpConfigPath = this.getNativeMcpPath(projectPath);
+        // Ensure the directory exists
+        await ensureDirectoryExists(mcpConfigPath);
+        // Read existing configuration
+        const existingContent = await readFileIfExists(mcpConfigPath);
+        let existingConfig = { mcpServers: {} };
+        if (existingContent) {
+            try {
+                existingConfig = JSON.parse(existingContent);
+                if (!existingConfig.mcpServers) {
+                    existingConfig.mcpServers = {};
+                }
+            }
+            catch (error) {
+                console.warn('Warning: Existing .mcp.json is invalid, creating new configuration');
+                existingConfig = { mcpServers: {} };
+            }
+        }
+        // Convert our MCP server configs to Claude's format
+        for (const server of servers) {
+            const claudeServer = {};
+            switch (server.type) {
+                case 'stdio':
+                    if (server.command) {
+                        claudeServer.command = server.command;
+                    }
+                    if (server.args && server.args.length > 0) {
+                        claudeServer.args = server.args;
+                    }
+                    if (server.env && Object.keys(server.env).length > 0) {
+                        claudeServer.env = server.env;
+                    }
+                    break;
+                case 'http':
+                    claudeServer.type = 'http';
+                    if (server.url) {
+                        claudeServer.url = server.url;
+                    }
+                    if (server.headers && Object.keys(server.headers).length > 0) {
+                        claudeServer.headers = server.headers;
+                    }
+                    break;
+                case 'sse':
+                    claudeServer.type = 'sse';
+                    if (server.url) {
+                        claudeServer.url = server.url;
+                    }
+                    if (server.headers && Object.keys(server.headers).length > 0) {
+                        claudeServer.headers = server.headers;
+                    }
+                    break;
+            }
+            // Add or update the server in the config
+            existingConfig.mcpServers[server.name] = claudeServer;
+        }
+        // Write the updated configuration
+        const configJson = JSON.stringify(existingConfig, null, 2);
+        await writeFile(mcpConfigPath, configJson);
+    }
+    /**
+     * Claude supports all MCP server types, so no filtering needed
+     */
+    filterMCPServers(servers) {
+        return servers; // Claude supports everything
+    }
+    /**
+     * Claude doesn't need any transformations
+     */
+    transformMCPServers(servers) {
+        return servers; // No transformations needed
+    }
+    /**
+     * Apply rules configuration to Claude's CLAUDE.md format
+     */
+    async applyRulesConfig(configPath, rules, existingContent) {
+        const rulesSection = this.generateRulesContent(rules.sections);
+        let content = existingContent;
+        // For markdown, we'll append rules directly
+        if (content && !content.endsWith('\n')) {
+            content += '\n';
+        }
+        if (content) {
+            content += '\n';
+        }
+        content += rulesSection;
+        return content.trim() + '\n';
+    }
+    /**
+     * Extract existing rule texts from CLAUDE.md content
+     */
+    extractExistingRules(content) {
+        // Extract rules from markdown format - look for lines starting with "- "
+        const ruleLines = content.split('\n').filter(line => line.trim().startsWith('- '));
+        return ruleLines.map(line => line.replace(/^- /, '').trim()).filter(rule => rule.length > 0);
+    }
+    /**
+     * Extract existing rule sections from CLAUDE.md content using ## headers
+     */
+    extractExistingSections(content) {
+        const lines = content.split('\n');
+        const sections = [];
+        let currentSection = null;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Check if it's a section header
+            if (trimmed.startsWith('## ') && trimmed.includes(' ')) {
+                // Start new section
+                if (currentSection) {
+                    sections.push(currentSection);
+                }
+                const sectionName = trimmed.replace(/^##\s*/, '');
+                currentSection = {
+                    templateId: sectionName.toLowerCase().replace(/\s+/g, '_'),
+                    templateName: sectionName,
+                    rules: []
+                };
+            }
+            else if (currentSection && trimmed.startsWith('- ')) {
+                // Add rule to current section
+                const rule = trimmed.replace(/^- /, '');
+                currentSection.rules.push(rule);
+            }
+        }
+        // Add the last section
+        if (currentSection) {
+            sections.push(currentSection);
+        }
+        return sections;
+    }
+    /**
+     * Generate rules content in Claude's CLAUDE.md markdown format
+     */
+    generateRulesContent(sections) {
+        let content = '';
+        if (sections && sections.length > 0) {
+            // Group rules by sections
+            for (const ruleSection of sections) {
+                content += `## ${ruleSection.templateName}\n\n`;
+                for (const rule of ruleSection.rules) {
+                    content += `- ${rule}\n`;
+                }
+                content += '\n';
+            }
+        }
+        return content;
+    }
+    /**
+     * Get existing MCP servers from Claude's .mcp.json configuration
+     */
+    async getMCPServers(projectPath) {
+        const mcpConfigPath = this.getNativeMcpPath(projectPath);
+        const configContent = await readFileIfExists(mcpConfigPath);
+        if (!configContent) {
+            return [];
+        }
+        try {
+            const config = JSON.parse(configContent);
+            const servers = [];
+            if (config.mcpServers) {
+                for (const [name, serverConfig] of Object.entries(config.mcpServers)) {
+                    const server = {
+                        name,
+                        type: (serverConfig.type || (serverConfig.command ? 'stdio' : serverConfig.type)),
+                    };
+                    if (serverConfig.command) {
+                        server.command = serverConfig.command;
+                    }
+                    if (serverConfig.args) {
+                        server.args = serverConfig.args;
+                    }
+                    if (serverConfig.env) {
+                        server.env = serverConfig.env;
+                    }
+                    if (serverConfig.url) {
+                        server.url = serverConfig.url;
+                    }
+                    if (serverConfig.headers) {
+                        server.headers = serverConfig.headers;
+                    }
+                    servers.push(server);
+                }
+            }
+            return servers;
+        }
+        catch (error) {
+            // Invalid JSON or missing mcpServers property
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=ClaudeAgent.js.map

package/dist/agents/ClaudeAgent.js.map

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

package/dist/agents/ClaudeDesktopAgent.d.ts

@@ -0,0 +1,49 @@
+import { Agent } from './Agent.js';
+import type { MCPServerConfig } from '../types/index.js';
+import type { AppliedRules, RuleSection } from '../types/rules.js';
+/**
+ * Claude Desktop app agent implementation
+ * Supports full MCP capabilities including stdio, HTTP, and SSE servers
+ * Native config: platform-specific claude_desktop_config.json
+ */
+export declare class ClaudeDesktopAgent extends Agent {
+    constructor();
+    /**
+     * Claude Desktop doesn't support project-level detection since it's a desktop app
+     */
+    detectPresence(): Promise<null>;
+    /**
+     * Claude Desktop is not used for project-level configurations
+     * This method should not be called
+     */
+    applyMCPConfig(): Promise<void>;
+    /**
+     * Apply MCP configuration to Claude Desktop's global config format
+     */
+    applyGlobalMCPConfig(servers: MCPServerConfig[]): Promise<void>;
+    /**
+     * Claude Desktop supports all MCP server types, so no filtering needed
+     */
+    filterMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Claude Desktop doesn't need any transformations
+     */
+    transformMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Claude Desktop doesn't support rules configuration
+     */
+    applyRulesConfig(configPath: string, rules: AppliedRules, existingContent: string): Promise<string>;
+    /**
+     * Claude Desktop doesn't support rules extraction
+     */
+    extractExistingRules(content: string): string[];
+    /**
+     * Claude Desktop doesn't support rules sections
+     */
+    extractExistingSections(content: string): RuleSection[];
+    /**
+     * Claude Desktop doesn't generate rules content
+     */
+    generateRulesContent(sections: RuleSection[]): string;
+}
+//# sourceMappingURL=ClaudeDesktopAgent.d.ts.map

package/dist/agents/ClaudeDesktopAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeDesktopAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ClaudeDesktopAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;;IA8B3C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DrE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;IAI/D;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;IAIlE;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC;IAIlB;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/C;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAIvD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;CAGtD"}

package/dist/agents/ClaudeDesktopAgent.js

@@ -0,0 +1,143 @@
+import { Agent } from './Agent.js';
+import { readFileIfExists, writeFile, ensureDirectoryExists } from '../utils/fs.js';
+/**
+ * Claude Desktop app agent implementation
+ * Supports full MCP capabilities including stdio, HTTP, and SSE servers
+ * Native config: platform-specific claude_desktop_config.json
+ */
+export class ClaudeDesktopAgent extends Agent {
+    constructor() {
+        const definition = {
+            id: 'claude-desktop',
+            name: 'Claude Desktop',
+            url: 'https://claude.ai/download',
+            capabilities: {
+                mcp: {
+                    stdio: true,
+                    http: true,
+                    sse: true
+                },
+                rules: false, // No .rules files support
+                hooks: false, // No hook system
+                commands: false, // No custom commands
+                subagents: false, // No subagent support
+                statusline: false // No statusline customization
+            },
+            configFiles: [], // Claude Desktop doesn't have project-specific detection files
+            nativeConfigPath: 'claude_desktop_config.json', // Not used for project-level
+            globalConfigPaths: {
+                windows: '%APPDATA%/Claude/claude_desktop_config.json',
+                darwin: '~/Library/Application Support/Claude/claude_desktop_config.json',
+                linux: '~/.config/Claude/claude_desktop_config.json'
+            }
+        };
+        super(definition);
+    }
+    /**
+     * Claude Desktop doesn't support project-level detection since it's a desktop app
+     */
+    async detectPresence() {
+        return null;
+    }
+    /**
+     * Claude Desktop is not used for project-level configurations
+     * This method should not be called
+     */
+    async applyMCPConfig() {
+        throw new Error('Claude Desktop only supports global configuration. Use --global flag.');
+    }
+    /**
+     * Apply MCP configuration to Claude Desktop's global config format
+     */
+    async applyGlobalMCPConfig(servers) {
+        const globalPath = this.getGlobalMcpPath();
+        if (!globalPath) {
+            throw new Error(`Claude Desktop global configuration path could not be determined for this platform`);
+        }
+        // Ensure the directory exists
+        await ensureDirectoryExists(globalPath);
+        // Read existing configuration
+        const existingContent = await readFileIfExists(globalPath);
+        let existingConfig = { mcpServers: {} };
+        if (existingContent) {
+            try {
+                existingConfig = JSON.parse(existingContent);
+                if (!existingConfig.mcpServers) {
+                    existingConfig.mcpServers = {};
+                }
+            }
+            catch (error) {
+                console.warn('Warning: Existing claude_desktop_config.json is invalid, creating new configuration');
+                existingConfig = { mcpServers: {} };
+            }
+        }
+        // Convert our MCP server configs to Claude Desktop's format
+        for (const server of servers) {
+            const claudeDesktopServer = {};
+            switch (server.type) {
+                case 'stdio':
+                    if (server.command) {
+                        claudeDesktopServer.command = server.command;
+                    }
+                    if (server.args && server.args.length > 0) {
+                        claudeDesktopServer.args = server.args;
+                    }
+                    if (server.env && Object.keys(server.env).length > 0) {
+                        claudeDesktopServer.env = server.env;
+                    }
+                    break;
+                case 'http':
+                case 'sse':
+                    if (server.url) {
+                        claudeDesktopServer.url = server.url;
+                    }
+                    if (server.headers && Object.keys(server.headers).length > 0) {
+                        claudeDesktopServer.headers = server.headers;
+                    }
+                    break;
+            }
+            // Add or update the server in the config
+            existingConfig.mcpServers[server.name] = claudeDesktopServer;
+        }
+        // Write the updated configuration
+        const configJson = JSON.stringify(existingConfig, null, 2);
+        await writeFile(globalPath, configJson);
+    }
+    /**
+     * Claude Desktop supports all MCP server types, so no filtering needed
+     */
+    filterMCPServers(servers) {
+        return servers; // Claude Desktop supports everything
+    }
+    /**
+     * Claude Desktop doesn't need any transformations
+     */
+    transformMCPServers(servers) {
+        return servers; // No transformations needed
+    }
+    /**
+     * Claude Desktop doesn't support rules configuration
+     */
+    async applyRulesConfig(configPath, rules, existingContent) {
+        throw new Error('Claude Desktop does not support rules configuration. Rules should be applied to a project-level agent like Claude Code.');
+    }
+    /**
+     * Claude Desktop doesn't support rules extraction
+     */
+    extractExistingRules(content) {
+        return [];
+    }
+    /**
+     * Claude Desktop doesn't support rules sections
+     */
+    extractExistingSections(content) {
+        return [];
+    }
+    /**
+     * Claude Desktop doesn't generate rules content
+     */
+    generateRulesContent(sections) {
+        return '';
+    }
+}
+//# sourceMappingURL=ClaudeDesktopAgent.js.map

package/dist/agents/ClaudeDesktopAgent.js.map

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

package/dist/agents/CodexCliAgent.d.ts

@@ -0,0 +1,48 @@
+import { Agent } from './Agent.js';
+import type { MCPServerConfig } from '../types/index.js';
+import type { AppliedRules, RuleSection } from '../types/rules.js';
+/**
+ * OpenAI Codex CLI agent implementation
+ * Supports only stdio MCP servers - transforms remote servers to stdio via mcp-remote proxy
+ * Native config: .codex/config.toml
+ */
+export declare class CodexCliAgent extends Agent {
+    constructor();
+    /**
+     * Apply MCP configuration to Codex CLI's native TOML format
+     */
+    applyMCPConfig(projectPath: string, servers: MCPServerConfig[]): Promise<void>;
+    /**
+     * Codex only supports stdio, so filter out others (they'll be transformed)
+     */
+    filterMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Transform remote (HTTP/SSE) servers to stdio using mcp-remote proxy
+     */
+    transformMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Format TOML output for Codex CLI with proper structure and comments
+     */
+    private formatTOML;
+    /**
+     * Apply rules configuration to Codex CLI's TOML format
+     */
+    applyRulesConfig(configPath: string, rules: AppliedRules, existingContent: string): Promise<string>;
+    /**
+     * Extract existing rule texts from TOML content
+     */
+    extractExistingRules(content: string): string[];
+    /**
+     * Extract existing rule sections from TOML content
+     */
+    extractExistingSections(content: string): RuleSection[];
+    /**
+     * Generate rules content in TOML format
+     */
+    generateRulesContent(sections: RuleSection[]): string;
+    /**
+     * Format TOML output for rules with proper structure and comments
+     */
+    private formatTOMLRules;
+}
+//# sourceMappingURL=CodexCliAgent.d.ts.map

package/dist/agents/CodexCliAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodexCliAgent.d.ts","sourceRoot":"","sources":["../../src/agents/CodexCliAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,EAAE,eAAe,EAAkC,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAK;;IAkCtC;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CpF;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;IAK/D;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;IAgClE;;OAEG;IACH,OAAO,CAAC,UAAU;IA6BlB;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC;IA6BlB;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAmB/C;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAuBvD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAiBrD;;OAEG;IACH,OAAO,CAAC,eAAe;CA2BxB"}