agentinit 1.6.0 → 1.8.0

package/dist/core/managedState.js

@@ -0,0 +1,194 @@
+import { promises as fs } from 'fs';
+import { dirname, join, relative, resolve } from 'path';
+import { fileExists } from '../utils/fs.js';
+const MANAGED_STATE_FILE = 'managed-state.json';
+const BACKUPS_DIR = 'backups';
+function toPosixPath(value) {
+    return value.replace(/\\/g, '/');
+}
+async function pathType(targetPath) {
+    try {
+        const stat = await fs.stat(targetPath);
+        return stat.isDirectory() ? 'directory' : 'file';
+    }
+    catch {
+        return null;
+    }
+}
+async function copyDirectory(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirectory(srcPath, destPath);
+        }
+        else {
+            await fs.mkdir(dirname(destPath), { recursive: true });
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+async function copyPath(src, dest) {
+    const type = await pathType(src);
+    if (!type) {
+        return;
+    }
+    await fs.mkdir(dirname(dest), { recursive: true });
+    if (type === 'directory') {
+        await copyDirectory(src, dest);
+    }
+    else {
+        await fs.copyFile(src, dest);
+    }
+}
+export class ManagedStateStore {
+    projectPath;
+    state;
+    constructor(projectPath, state) {
+        this.projectPath = projectPath;
+        this.state = state;
+    }
+    static async open(projectPath) {
+        const agentInitDir = join(projectPath, '.agentinit');
+        const statePath = join(agentInitDir, MANAGED_STATE_FILE);
+        const emptyState = { version: 1, entries: [] };
+        try {
+            const raw = await fs.readFile(statePath, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.entries)) {
+                return new ManagedStateStore(projectPath, emptyState);
+            }
+            return new ManagedStateStore(projectPath, parsed);
+        }
+        catch {
+            return new ManagedStateStore(projectPath, emptyState);
+        }
+    }
+    get agentInitDir() {
+        return join(this.projectPath, '.agentinit');
+    }
+    get stateFilePath() {
+        return join(this.agentInitDir, MANAGED_STATE_FILE);
+    }
+    get backupsDir() {
+        return join(this.agentInitDir, BACKUPS_DIR);
+    }
+    normalizeRelativePath(targetPath, preserveTrailingSlash = false) {
+        const hasTrailingSlash = preserveTrailingSlash && /[\\/]$/.test(targetPath);
+        const relativePath = relative(this.projectPath, resolve(targetPath));
+        const normalizedPath = toPosixPath(relativePath);
+        if (hasTrailingSlash && normalizedPath) {
+            return normalizedPath.endsWith('/') ? normalizedPath : `${normalizedPath}/`;
+        }
+        return normalizedPath;
+    }
+    getEntry(targetPath) {
+        const relativePath = this.normalizeRelativePath(targetPath);
+        return this.state.entries.find(entry => entry.path === relativePath);
+    }
+    async createBackup(targetPath) {
+        if (!(await fileExists(targetPath))) {
+            return undefined;
+        }
+        const relativeTargetPath = this.normalizeRelativePath(targetPath);
+        const backupPath = join(this.backupsDir, relativeTargetPath);
+        if (!(await fileExists(backupPath))) {
+            await copyPath(targetPath, backupPath);
+        }
+        return this.normalizeRelativePath(backupPath);
+    }
+    async trackGeneratedPath(targetPath, options) {
+        const existing = this.getEntry(targetPath);
+        if (existing) {
+            if (options.ignorePath && !existing.ignorePath) {
+                existing.ignorePath = this.normalizeRelativePath(options.ignorePath);
+            }
+            return existing;
+        }
+        const existedBefore = await fileExists(targetPath);
+        const backupPath = existedBefore ? await this.createBackup(targetPath) : undefined;
+        const entry = {
+            path: this.normalizeRelativePath(targetPath),
+            kind: options.kind,
+            source: options.source,
+            existedBefore,
+            ...(backupPath ? { backupPath } : {}),
+            ...(options.ignorePath ? { ignorePath: this.normalizeRelativePath(options.ignorePath, true) } : {}),
+        };
+        this.state.entries.push(entry);
+        return entry;
+    }
+    getEntries() {
+        return [...this.state.entries];
+    }
+    getIgnorePaths() {
+        if (this.state.entries.length === 0) {
+            return [];
+        }
+        const paths = new Set([
+            '.agentinit/managed-state.json',
+            '.agentinit/backups/',
+        ]);
+        for (const entry of this.state.entries) {
+            if (entry.ignorePath) {
+                paths.add(entry.ignorePath);
+            }
+        }
+        return [...paths];
+    }
+    async save() {
+        await fs.mkdir(this.agentInitDir, { recursive: true });
+        await fs.writeFile(this.stateFilePath, JSON.stringify(this.state, null, 2), 'utf8');
+    }
+    async revertAll(options = {}) {
+        const summary = {
+            restored: 0,
+            removed: 0,
+            backupsRemoved: 0,
+        };
+        const entries = [...this.state.entries].sort((a, b) => b.path.length - a.path.length);
+        for (const entry of entries) {
+            const absolutePath = resolve(this.projectPath, entry.path);
+            const backupPath = entry.backupPath ? resolve(this.projectPath, entry.backupPath) : null;
+            if (entry.existedBefore && backupPath && (await fileExists(backupPath))) {
+                if (!options.dryRun) {
+                    await fs.rm(absolutePath, { recursive: true, force: true }).catch(() => { });
+                    await copyPath(backupPath, absolutePath);
+                }
+                summary.restored++;
+            }
+            else {
+                if (!options.dryRun) {
+                    await fs.rm(absolutePath, { recursive: true, force: true }).catch(() => { });
+                }
+                summary.removed++;
+            }
+            if (!options.keepBackups && backupPath && (await fileExists(backupPath))) {
+                if (!options.dryRun) {
+                    await fs.rm(backupPath, { recursive: true, force: true }).catch(() => { });
+                }
+                summary.backupsRemoved++;
+            }
+        }
+        if (!options.dryRun) {
+            this.state.entries.length = 0;
+            await fs.rm(this.stateFilePath, { force: true }).catch(() => { });
+            if (!options.keepBackups) {
+                await fs.rm(this.backupsDir, { recursive: true, force: true }).catch(() => { });
+            }
+            try {
+                const remainingEntries = await fs.readdir(this.agentInitDir);
+                if (remainingEntries.length === 0) {
+                    await fs.rm(this.agentInitDir, { recursive: true, force: true });
+                }
+            }
+            catch {
+                // Ignore cleanup errors when the directory does not exist.
+            }
+        }
+        return summary;
+    }
+}
+//# sourceMappingURL=managedState.js.map

package/dist/core/managedState.js.map

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

package/dist/core/mcpClient.d.ts

@@ -1,27 +1,129 @@
-import type { MCPServerConfig, MCPVerificationResult } from '../types/index.js';
+import type { MCPServerConfig, MCPVerificationResult, MCPVerificationOptions } from '../types/index.js';
 export declare class MCPVerificationError extends Error {
     readonly serverName: string;
     constructor(message: string, serverName: string);
 }
 export declare class MCPVerifier {
     private defaultTimeout;
+    /**
+     * Creates a new MCP server verifier instance
+     *
+     * @param defaultTimeout - Default connection timeout in milliseconds (default: 30000)
+     *
+     * @example
+     * ```typescript
+     * const verifier = new MCPVerifier();
+     * // or with custom timeout
+     * const verifier = new MCPVerifier(15000);
+     * ```
+     */
     constructor(defaultTimeout?: number);
     /**
      * Color utility function for token display
      */
     private colorizeTokenCount;
+    /**
+     * Check if tool has valid input schema with properties
+     */
+    private hasValidInputSchema;
+    /**
+     * Format type information from schema property
+     */
+    private formatType;
+    /**
+     * Format number range constraints
+     */
+    private formatNumberRange;
+    /**
+     * Format string length constraints
+     */
+    private formatStringLength;
+    /**
+     * Format array item constraints
+     */
+    private formatArrayConstraints;
+    /**
+     * Collect all constraints for a parameter
+     */
+    private formatConstraints;
+    /**
+     * Format a single parameter for display
+     */
+    private formatParameter;
+    /**
+     * Format tool parameters from inputSchema for display
+     */
+    private formatToolParameters;
     /**
      * Calculate token counts for MCP tools based on how they appear in Claude's context
      */
     private calculateToolTokens;
     /**
-     * Verify a single MCP server
+     * Verifies a single MCP server and retrieves its capabilities
+     *
+     * @param server - MCP server configuration
+     * @param options - Verification options
+     * @param options.timeout - Connection timeout in milliseconds (overrides default)
+     * @param options.includeResourceContents - Fetch actual resource data (may be slow for large resources)
+     * @param options.includePromptDetails - Fetch prompt templates with full message content
+     * @param options.includeTokenCounts - Calculate token usage for tools (default: true)
+     * @returns Verification result with server capabilities, connection time, and status
+     *
+     * @example
+     * ```typescript
+     * const verifier = new MCPVerifier();
+     * const result = await verifier.verifyServer(
+     *   {
+     *     name: 'filesystem',
+     *     type: MCPServerType.STDIO,
+     *     command: 'npx',
+     *     args: ['-y', '@modelcontextprotocol/server-filesystem', '/workspace']
+     *   },
+     *   {
+     *     timeout: 10000,
+     *     includeResourceContents: true,
+     *     includePromptDetails: true
+     *   }
+     * );
+     *
+     * if (result.status === 'success') {
+     *   console.log(`Tools: ${result.capabilities.tools.length}`);
+     *   console.log(`Total tokens: ${result.capabilities.totalToolTokens}`);
+     * }
+     * ```
      */
-    verifyServer(server: MCPServerConfig, timeout?: number): Promise<MCPVerificationResult>;
+    verifyServer(server: MCPServerConfig, options?: MCPVerificationOptions): Promise<MCPVerificationResult>;
     /**
-     * Verify multiple MCP servers
+     * Verifies multiple MCP servers in parallel
+     *
+     * @param servers - Array of MCP server configurations to verify
+     * @param options - Verification options (applied to all servers)
+     * @returns Array of verification results for each server
+     *
+     * @example
+     * ```typescript
+     * const verifier = new MCPVerifier();
+     * const servers = [
+     *   {
+     *     name: 'filesystem',
+     *     type: MCPServerType.STDIO,
+     *     command: 'npx',
+     *     args: ['-y', '@modelcontextprotocol/server-filesystem', '/workspace']
+     *   },
+     *   {
+     *     name: 'github',
+     *     type: MCPServerType.HTTP,
+     *     url: 'https://api.githubcopilot.com/mcp/',
+     *     headers: { Authorization: 'Bearer YOUR_TOKEN' }
+     *   }
+     * ];
+     *
+     * const results = await verifier.verifyServers(servers, { timeout: 15000 });
+     * const successCount = results.filter(r => r.status === 'success').length;
+     * console.log(`${successCount}/${results.length} servers verified successfully`);
+     * ```
      */
-    verifyServers(servers: MCPServerConfig[], timeout?: number): Promise<MCPVerificationResult[]>;
+    verifyServers(servers: MCPServerConfig[], options?: MCPVerificationOptions): Promise<MCPVerificationResult[]>;
     /**
      * Create the appropriate transport for the server type
      */
@@ -31,7 +133,23 @@ export declare class MCPVerifier {
      */
     private connectAndVerify;
     /**
-     * Format verification results for display
+     * Formats verification results for console display with color-coded output
+     *
+     * @param results - Array of verification results to format
+     * @returns Formatted string with tools, resources, prompts, and connection status
+     *
+     * @remarks
+     * - Token counts are color-coded: green (≤5k), yellow (5k-15k), red (>15k)
+     * - Resources and prompts are shown when DEBUG=1 or when content/templates are fetched
+     * - Failed servers display connection details for debugging
+     *
+     * @example
+     * ```typescript
+     * const verifier = new MCPVerifier();
+     * const results = await verifier.verifyServers(servers);
+     * const formatted = verifier.formatResults(results);
+     * console.log(formatted);
+     * ```
      */
     formatResults(results: MCPVerificationResult[]): string;
 }

package/dist/core/mcpClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpClient.d.ts","sourceRoot":"","sources":["../../src/core/mcpClient.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAKtB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,oBAAqB,SAAQ,KAAK;aACA,UAAU,EAAE,MAAM;gBAAnD,OAAO,EAAE,MAAM,EAAkB,UAAU,EAAE,MAAM;CAIhE;AAGD,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,GAAE,MAAsC;IAIlE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsE3B;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiF7F;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAsBnG;;OAEG;YACW,eAAe;IA0C7B;;OAEG;YACW,gBAAgB;IA8G9B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,MAAM;CAiFxD"}
+{"version":3,"file":"mcpClient.d.ts","sourceRoot":"","sources":["../../src/core/mcpClient.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAKrB,sBAAsB,EAGvB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,oBAAqB,SAAQ,KAAK;aACA,UAAU,EAAE,MAAM;gBAAnD,OAAO,EAAE,MAAM,EAAkB,UAAU,EAAE,MAAM;CAIhE;AAGD,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAS;IAE/B;;;;;;;;;;;OAWG;gBACS,cAAc,GAAE,MAAsC;IAIlE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoF3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiF7G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAsBnH;;OAEG;YACW,eAAe;IA0C7B;;OAEG;YACW,gBAAgB;IAkN9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,MAAM;CAsHxD"}