agentinit 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [1.5.0](https://github.com/agentinit/agentinit/compare/v1.4.1...v1.5.0) (2025-10-01)
+
+
+### Bug Fixes
+
+* use npx tsc in build and fix Commander argument parsing ([4fa51f9](https://github.com/agentinit/agentinit/commit/4fa51f941c0fbeee2880850add90af038c3623cf))
+
+
+### Features
+
+* add library API for programmatic MCP verification ([8cf70d7](https://github.com/agentinit/agentinit/commit/8cf70d7395987221eb33c6575885d07a45717df0))
+
 ## [1.4.1](https://github.com/agentinit/agentinit/compare/v1.4.0...v1.4.1) (2025-09-26)
 
 

package/README.md

@@ -298,6 +298,215 @@ AgentInit includes a curated registry of popular MCPs:
 | supabase-mcp | database | Supabase integration |
 | git-mcp | version-control | Enhanced Git operations |
 
+## 📚 Library API
+
+AgentInit can be used as a library in your Node.js/TypeScript applications for programmatic MCP server verification and management.
+
+### Installation
+
+```bash
+npm install agentinit
+# or
+yarn add agentinit
+# or
+bun add agentinit
+```
+
+### Basic Usage
+
+```typescript
+import { MCPVerifier, MCPServerType } from 'agentinit';
+
+const verifier = new MCPVerifier();
+
+const result = await verifier.verifyServer({
+  name: 'everything',
+  type: MCPServerType.STDIO,
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-everything']
+});
+
+if (result.status === 'success') {
+  console.log(`✅ Connected to ${result.server.name}`);
+  console.log(`Tools: ${result.capabilities?.tools.length}`);
+  console.log(`Total tokens: ${result.capabilities?.totalToolTokens}`);
+}
+```
+
+### Submodule Imports
+
+For better tree-shaking, import from specific submodules:
+
+```typescript
+// Import specific modules
+import { MCPVerifier } from 'agentinit/verifier';
+import { MCPServerType } from 'agentinit/types';
+import type { MCPServerConfig, MCPVerificationResult } from 'agentinit/types';
+import { countTokens, MCPParser } from 'agentinit/utils';
+```
+
+### Examples
+
+#### Verify STDIO MCP Server
+
+```typescript
+import { MCPVerifier, MCPServerType } from 'agentinit';
+
+const verifier = new MCPVerifier(10000); // 10 second timeout
+
+const result = await verifier.verifyServer({
+  name: 'filesystem',
+  type: MCPServerType.STDIO,
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-filesystem', '/workspace'],
+  env: {
+    NODE_ENV: 'production'
+  }
+});
+
+if (result.status === 'success') {
+  result.capabilities?.tools.forEach(tool => {
+    const tokens = result.capabilities?.toolTokenCounts?.get(tool.name) || 0;
+    console.log(`  • ${tool.name} (${tokens} tokens)`);
+  });
+}
+```
+
+#### Verify HTTP MCP Server
+
+```typescript
+import { MCPVerifier, MCPServerType } from 'agentinit';
+
+const result = await verifier.verifyServer({
+  name: 'github-api',
+  type: MCPServerType.HTTP,
+  url: 'https://api.example.com/mcp',
+  headers: {
+    'Authorization': 'Bearer YOUR_TOKEN',
+    'Content-Type': 'application/json'
+  }
+});
+```
+
+#### Verify Multiple Servers
+
+```typescript
+import { MCPVerifier, MCPServerType } from 'agentinit';
+
+const servers = [
+  {
+    name: 'everything',
+    type: MCPServerType.STDIO,
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-everything']
+  },
+  {
+    name: 'api-server',
+    type: MCPServerType.HTTP,
+    url: 'https://api.example.com/mcp'
+  }
+];
+
+const verifier = new MCPVerifier();
+const results = await verifier.verifyServers(servers);
+
+// Display formatted results
+console.log(verifier.formatResults(results));
+
+// Or process results programmatically
+const successful = results.filter(r => r.status === 'success').length;
+console.log(`${successful}/${results.length} servers verified`);
+```
+
+#### Count Tokens
+
+```typescript
+import { countTokens } from 'agentinit/utils';
+
+const text = 'Hello, world!';
+const tokens = countTokens(text);
+console.log(`Token count: ${tokens}`);
+```
+
+#### Parse MCP Configuration
+
+```typescript
+import { MCPParser } from 'agentinit/utils';
+
+const args = ['--mcp-stdio', 'test', 'node', 'server.js', '--args', 'arg1 arg2'];
+const parsed = MCPParser.parseArguments(args);
+
+console.log(parsed.servers); // Array of MCPServerConfig
+```
+
+### API Reference
+
+#### MCPVerifier
+
+**Constructor**
+```typescript
+new MCPVerifier(defaultTimeout?: number)
+```
+
+**Methods**
+- `verifyServer(config: MCPServerConfig, timeout?: number): Promise<MCPVerificationResult>` - Verify a single MCP server
+- `verifyServers(configs: MCPServerConfig[], timeout?: number): Promise<MCPVerificationResult[]>` - Verify multiple servers in parallel
+- `formatResults(results: MCPVerificationResult[]): string` - Format verification results for display
+
+#### Types
+
+**MCPServerType**
+```typescript
+enum MCPServerType {
+  STDIO = 'stdio',
+  HTTP = 'http',
+  SSE = 'sse'
+}
+```
+
+**MCPServerConfig**
+```typescript
+interface MCPServerConfig {
+  name: string;
+  type: MCPServerType;
+
+  // For STDIO servers
+  command?: string;
+  args?: string[];
+  env?: Record<string, string>;
+
+  // For HTTP/SSE servers
+  url?: string;
+  headers?: Record<string, string>;
+}
+```
+
+**MCPVerificationResult**
+```typescript
+interface MCPVerificationResult {
+  server: MCPServerConfig;
+  status: 'success' | 'error' | 'timeout';
+  capabilities?: MCPCapabilities;
+  error?: string;
+  connectionTime?: number;
+}
+```
+
+**MCPCapabilities**
+```typescript
+interface MCPCapabilities {
+  tools: MCPTool[];
+  resources: MCPResource[];
+  prompts: MCPPrompt[];
+  serverInfo?: {
+    name: string;
+    version: string;
+  };
+  totalToolTokens?: number;
+  toolTokenCounts?: Map<string, number>;
+}
+```
+
 ## 🛠️ Development
 
 ### Building from Source

package/dist/agents/Agent.d.ts

@@ -0,0 +1,110 @@
+import type { AgentDefinition, MCPServerConfig, AgentDetectionResult, ConfigFileDefinition } from '../types/index.js';
+import type { AppliedRules, RuleApplicationResult, RuleSection } from '../types/rules.js';
+/**
+ * Abstract base class for AI coding agents
+ * Defines the common interface and behavior for all supported agents
+ */
+export declare abstract class Agent {
+    protected definition: AgentDefinition;
+    constructor(definition: AgentDefinition);
+    /**
+     * Get the agent's unique identifier
+     */
+    get id(): string;
+    /**
+     * Get the agent's human-readable name
+     */
+    get name(): string;
+    /**
+     * Get the agent's capabilities
+     */
+    get capabilities(): import("../types/index.js").AgentCapabilities;
+    /**
+     * Get the agent's configuration files to check for presence
+     */
+    get configFiles(): ConfigFileDefinition[];
+    /**
+     * Get the agent's configuration file paths (backward compatibility)
+     */
+    get configFilePaths(): string[];
+    /**
+     * Get the native configuration path for this agent
+     */
+    get nativeConfigPath(): string;
+    /**
+     * Detect if this agent is present in the given project path
+     */
+    detectPresence(projectPath: string): Promise<AgentDetectionResult | null>;
+    /**
+     * Get the path where this agent's native MCP configuration should be written
+     */
+    getNativeMcpPath(projectPath: string): string;
+    /**
+     * Get the global configuration path for this agent
+     * Returns null if global configuration is not supported
+     */
+    getGlobalMcpPath(): string | null;
+    /**
+     * Check if this agent supports global configuration
+     */
+    supportsGlobalConfig(): boolean;
+    /**
+     * Apply MCP configuration to this agent's native config format
+     * Must be implemented by each specific agent
+     */
+    abstract applyMCPConfig(projectPath: string, servers: MCPServerConfig[]): Promise<void>;
+    /**
+     * Get existing MCP servers from this agent's configuration
+     * Default implementation returns empty array - should be overridden by agents that support MCP
+     */
+    getMCPServers(projectPath: string): Promise<MCPServerConfig[]>;
+    /**
+     * Apply MCP configuration to this agent's global config format
+     * Default implementation uses the same logic as applyMCPConfig but with global path
+     * Can be overridden by specific agents for different global config formats
+     */
+    applyGlobalMCPConfig(servers: MCPServerConfig[]): Promise<void>;
+    /**
+     * Filter MCP servers based on this agent's capabilities
+     * Can be overridden by specific agents for custom filtering logic
+     */
+    filterMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Transform MCP servers for this agent's requirements
+     * Can be overridden by specific agents for custom transformation logic
+     */
+    transformMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Apply rules configuration to this agent's config file format
+     * Must be implemented by each specific agent
+     */
+    abstract applyRulesConfig(configPath: string, rules: AppliedRules, existingContent: string): Promise<string>;
+    /**
+     * Extract existing rule texts from config content
+     * Must be implemented by each specific agent
+     */
+    abstract extractExistingRules(content: string): string[];
+    /**
+     * Extract existing rule sections from config content
+     * Must be implemented by each specific agent
+     */
+    abstract extractExistingSections(content: string): RuleSection[];
+    /**
+     * Generate rules content in this agent's format
+     * Must be implemented by each specific agent
+     */
+    abstract generateRulesContent(sections: RuleSection[]): string;
+    /**
+     * Apply rules configuration to this agent
+     */
+    applyRules(projectPath: string, rules: AppliedRules): Promise<RuleApplicationResult>;
+    /**
+     * Apply rules configuration to this agent's global config
+     */
+    applyGlobalRules(rules: AppliedRules): Promise<RuleApplicationResult>;
+    /**
+     * Get a summary of this agent
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/agents/Agent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE1F;;;GAGG;AACH,8BAAsB,KAAK;IACzB,SAAS,CAAC,UAAU,EAAE,eAAe,CAAC;gBAE1B,UAAU,EAAE,eAAe;IAIvC;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,YAAY,kDAEf;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,oBAAoB,EAAE,CAExC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,EAAE,CAE9B;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAa/E;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI7C;;;OAGG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC;IAEhB;;;OAGG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIpE;;;;OAIG;IACG,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBrE;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;IAe/D;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE;IAKlE;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAExD;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAEhE;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAE9D;;OAEG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,qBAAqB,CAAC;IAKjC;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiB3E;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/agents/Agent.js

@@ -0,0 +1,174 @@
+import { resolve } from 'path';
+import { pathExists } from '../utils/fs.js';
+import { getFullGlobalConfigPath } from '../utils/paths.js';
+import { RulesApplicator } from '../core/rulesApplicator.js';
+/**
+ * Abstract base class for AI coding agents
+ * Defines the common interface and behavior for all supported agents
+ */
+export class Agent {
+    definition;
+    constructor(definition) {
+        this.definition = definition;
+    }
+    /**
+     * Get the agent's unique identifier
+     */
+    get id() {
+        return this.definition.id;
+    }
+    /**
+     * Get the agent's human-readable name
+     */
+    get name() {
+        return this.definition.name;
+    }
+    /**
+     * Get the agent's capabilities
+     */
+    get capabilities() {
+        return this.definition.capabilities;
+    }
+    /**
+     * Get the agent's configuration files to check for presence
+     */
+    get configFiles() {
+        return this.definition.configFiles;
+    }
+    /**
+     * Get the agent's configuration file paths (backward compatibility)
+     */
+    get configFilePaths() {
+        return this.definition.configFiles.map(config => config.path);
+    }
+    /**
+     * Get the native configuration path for this agent
+     */
+    get nativeConfigPath() {
+        return this.definition.nativeConfigPath;
+    }
+    /**
+     * Detect if this agent is present in the given project path
+     */
+    async detectPresence(projectPath) {
+        for (const configFile of this.configFiles) {
+            const fullPath = resolve(projectPath, configFile.path);
+            if (await pathExists(fullPath, configFile.type)) {
+                return {
+                    agent: this,
+                    configPath: fullPath
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Get the path where this agent's native MCP configuration should be written
+     */
+    getNativeMcpPath(projectPath) {
+        return resolve(projectPath, this.nativeConfigPath);
+    }
+    /**
+     * Get the global configuration path for this agent
+     * Returns null if global configuration is not supported
+     */
+    getGlobalMcpPath() {
+        return getFullGlobalConfigPath(this.definition.globalConfigPath, this.definition.globalConfigPaths);
+    }
+    /**
+     * Check if this agent supports global configuration
+     */
+    supportsGlobalConfig() {
+        return this.getGlobalMcpPath() !== null;
+    }
+    /**
+     * Get existing MCP servers from this agent's configuration
+     * Default implementation returns empty array - should be overridden by agents that support MCP
+     */
+    async getMCPServers(projectPath) {
+        return [];
+    }
+    /**
+     * Apply MCP configuration to this agent's global config format
+     * Default implementation uses the same logic as applyMCPConfig but with global path
+     * Can be overridden by specific agents for different global config formats
+     */
+    async applyGlobalMCPConfig(servers) {
+        const globalPath = this.getGlobalMcpPath();
+        if (!globalPath) {
+            throw new Error(`Agent ${this.name} does not support global configuration`);
+        }
+        // Extract directory from global path and use it as "project path"
+        // This allows reusing the existing applyMCPConfig logic
+        const lastSlashIndex = Math.max(globalPath.lastIndexOf('/'), globalPath.lastIndexOf('\\'));
+        const globalDir = lastSlashIndex > 0 ? globalPath.substring(0, lastSlashIndex) : '';
+        // Temporarily override the native config path to point to global config
+        const originalNativeConfigPath = this.definition.nativeConfigPath;
+        const globalFileName = globalPath.substring(lastSlashIndex + 1);
+        this.definition.nativeConfigPath = globalFileName;
+        try {
+            await this.applyMCPConfig(globalDir, servers);
+        }
+        finally {
+            // Restore original native config path
+            this.definition.nativeConfigPath = originalNativeConfigPath;
+        }
+    }
+    /**
+     * Filter MCP servers based on this agent's capabilities
+     * Can be overridden by specific agents for custom filtering logic
+     */
+    filterMCPServers(servers) {
+        return servers.filter(server => {
+            switch (server.type) {
+                case 'stdio':
+                    return this.capabilities.mcp.stdio;
+                case 'http':
+                    return this.capabilities.mcp.http;
+                case 'sse':
+                    return this.capabilities.mcp.sse;
+                default:
+                    return false;
+            }
+        });
+    }
+    /**
+     * Transform MCP servers for this agent's requirements
+     * Can be overridden by specific agents for custom transformation logic
+     */
+    transformMCPServers(servers) {
+        // Default: no transformations
+        return servers;
+    }
+    /**
+     * Apply rules configuration to this agent
+     */
+    async applyRules(projectPath, rules) {
+        const applicator = new RulesApplicator();
+        return applicator.applyRulesToAgent(this, rules, projectPath, false);
+    }
+    /**
+     * Apply rules configuration to this agent's global config
+     */
+    async applyGlobalRules(rules) {
+        const applicator = new RulesApplicator();
+        if (!this.supportsGlobalConfig()) {
+            return {
+                success: false,
+                rulesApplied: 0,
+                agent: this.name,
+                configPath: '',
+                errors: [`Agent ${this.name} does not support global configuration`]
+            };
+        }
+        // Use empty string as project path for global config
+        return applicator.applyRulesToAgent(this, rules, '', true);
+    }
+    /**
+     * Get a summary of this agent
+     */
+    toString() {
+        return `${this.name} (${this.id})`;
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/dist/agents/Agent.js.map

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

package/dist/agents/ClaudeAgent.d.ts

@@ -0,0 +1,50 @@
+import { Agent } from './Agent.js';
+import type { MCPServerConfig } from '../types/index.js';
+import type { AppliedRules, RuleSection } from '../types/rules.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 declare class ClaudeAgent extends Agent {
+    constructor();
+    /**
+     * Apply MCP configuration to Claude's native .mcp.json format
+     */
+    applyMCPConfig(projectPath: string, servers: MCPServerConfig[]): Promise<void>;
+    /**
+     * Claude supports all MCP server types, so no filtering needed
+     */
+    filterMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Claude doesn't need any transformations
+     */
+    transformMCPServers(servers: MCPServerConfig[]): MCPServerConfig[];
+    /**
+     * Apply rules configuration to Claude's CLAUDE.md format
+     */
+    applyRulesConfig(configPath: string, rules: AppliedRules, existingContent: string): Promise<string>;
+    /**
+     * Extract existing rule texts from CLAUDE.md content
+     */
+    extractExistingRules(content: string): string[];
+    /**
+     * Extract existing rule sections from CLAUDE.md content using ## headers
+     */
+    extractExistingSections(content: string): RuleSection[];
+    /**
+     * Generate rules content in Claude's CLAUDE.md markdown format
+     */
+    generateRulesContent(sections: RuleSection[]): string;
+    /**
+     * Get existing MCP servers from Claude's .mcp.json configuration
+     */
+    getMCPServers(projectPath: string): Promise<MCPServerConfig[]>;
+}
+//# sourceMappingURL=ClaudeAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeAgent.d.ts","sourceRoot":"","sources":["../../src/agents/ClaudeAgent.ts"],"names":[],"mappings":"AACA,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;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,KAAK;;IA2CpC;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqEpF;;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;IAiBlB;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAM/C;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAmCvD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAiBrD;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CA6CrE"}