@cleocode/mcp-server 0.86.0

package/dist/lib/config.js

@@ -0,0 +1,248 @@
+/**
+ * Configuration loader for CLEO MCP Server
+ *
+ * Loads configuration from:
+ * 1. Environment variables (CLEO_MCP_*)
+ * 2. Config file (.cleo/config.json)
+ * 3. Defaults (fallback values)
+ *
+ * @task T2928
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { DEFAULT_CONFIG, DEFAULT_LIFECYCLE_ENFORCEMENT, DEFAULT_PROTOCOL_VALIDATION, DEFAULT_RATE_LIMITING, ENV_PREFIX, CONFIG_SCHEMA, } from './defaults.js';
+/**
+ * Configuration validation error
+ */
+export class ConfigValidationError extends Error {
+    field;
+    value;
+    constraint;
+    constructor(field, value, constraint) {
+        super(`Invalid config field '${field}': ${constraint} (got ${value})`);
+        this.field = field;
+        this.value = value;
+        this.constraint = constraint;
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Load configuration value from environment variable
+ */
+function loadFromEnv(key) {
+    const envKey = `${ENV_PREFIX}${key.toUpperCase()}`;
+    return process.env[envKey];
+}
+/**
+ * Parse environment variable to appropriate type
+ */
+function parseEnvValue(key, value) {
+    const schema = CONFIG_SCHEMA[key];
+    if (schema.type === 'boolean') {
+        return value.toLowerCase() === 'true' || value === '1';
+    }
+    if (schema.type === 'number') {
+        const num = parseInt(value, 10);
+        if (isNaN(num)) {
+            throw new ConfigValidationError(key, value, 'must be a number');
+        }
+        return num;
+    }
+    return value;
+}
+/**
+ * Load configuration from .cleo/config.json file
+ */
+function loadFromFile(projectRoot) {
+    const root = projectRoot || process.cwd();
+    const configPath = join(root, '.cleo', 'config.json');
+    if (!existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        // Extract MCP-specific config if nested
+        const result = {};
+        if (config.mcp) {
+            if (config.mcp.cliPath !== undefined)
+                result.cliPath = config.mcp.cliPath;
+            if (config.mcp.timeout !== undefined)
+                result.timeout = config.mcp.timeout;
+            if (config.mcp.logLevel !== undefined)
+                result.logLevel = config.mcp.logLevel;
+            if (config.mcp.enableMetrics !== undefined)
+                result.enableMetrics = config.mcp.enableMetrics;
+            if (config.mcp.maxRetries !== undefined)
+                result.maxRetries = config.mcp.maxRetries;
+            if (config.mcp.features?.queryCache !== undefined)
+                result.queryCache = config.mcp.features.queryCache;
+            if (config.mcp.features?.queryCacheTtl !== undefined)
+                result.queryCacheTtl = config.mcp.features.queryCacheTtl;
+            if (config.mcp.features?.auditLog !== undefined)
+                result.auditLog = config.mcp.features.auditLog;
+            if (config.mcp.features?.strictValidation !== undefined)
+                result.strictValidation = config.mcp.features.strictValidation;
+        }
+        // Extract lifecycle enforcement config (Section 12.2)
+        if (config.lifecycleEnforcement) {
+            result.lifecycleEnforcement = {
+                ...DEFAULT_LIFECYCLE_ENFORCEMENT,
+                ...config.lifecycleEnforcement,
+            };
+        }
+        // Extract protocol validation config (Section 12.3)
+        if (config.protocolValidation) {
+            result.protocolValidation = {
+                ...DEFAULT_PROTOCOL_VALIDATION,
+                ...config.protocolValidation,
+            };
+        }
+        // Extract rate limiting config (Section 13.3)
+        if (config.rateLimiting || config.mcp?.rateLimiting) {
+            const rlConfig = config.rateLimiting || config.mcp?.rateLimiting;
+            result.rateLimiting = {
+                ...DEFAULT_RATE_LIMITING,
+                ...rlConfig,
+                query: { ...DEFAULT_RATE_LIMITING.query, ...rlConfig?.query },
+                mutate: { ...DEFAULT_RATE_LIMITING.mutate, ...rlConfig?.mutate },
+                spawn: { ...DEFAULT_RATE_LIMITING.spawn, ...rlConfig?.spawn },
+            };
+        }
+        // If no mcp block, check for flat config keys
+        if (!config.mcp) {
+            return config;
+        }
+        return result;
+    }
+    catch (error) {
+        // Log error but don't fail - fall back to defaults
+        console.error(`Warning: Failed to load config file: ${error}`);
+        return {};
+    }
+}
+/**
+ * Validate configuration field
+ */
+function validateField(key, value) {
+    const schema = CONFIG_SCHEMA[key];
+    if (!schema) {
+        return; // Unknown fields are ignored
+    }
+    // Type check
+    const actualType = typeof value;
+    if (actualType !== schema.type) {
+        throw new ConfigValidationError(key, value, `must be of type ${schema.type}`);
+    }
+    // Enum check
+    if ('enum' in schema && schema.enum && !schema.enum.includes(value)) {
+        throw new ConfigValidationError(key, value, `must be one of: ${schema.enum.join(', ')}`);
+    }
+    // Range check for numbers
+    if (schema.type === 'number') {
+        const numValue = value;
+        if ('min' in schema && numValue < schema.min) {
+            throw new ConfigValidationError(key, value, `must be >= ${schema.min}`);
+        }
+        if ('max' in schema && numValue > schema.max) {
+            throw new ConfigValidationError(key, value, `must be <= ${schema.max}`);
+        }
+    }
+}
+/**
+ * Validate complete configuration
+ */
+export function validateConfig(config) {
+    for (const [key, value] of Object.entries(config)) {
+        validateField(key, value);
+    }
+    // Required field check
+    for (const [key, schema] of Object.entries(CONFIG_SCHEMA)) {
+        if ('required' in schema && schema.required) {
+            if (config[key] === undefined) {
+                throw new ConfigValidationError(key, undefined, 'is required');
+            }
+        }
+    }
+}
+/**
+ * Load configuration from all sources
+ *
+ * Priority order:
+ * 1. Environment variables (CLEO_MCP_*)
+ * 2. Config file (.cleo/config.json)
+ * 3. Defaults
+ */
+export function loadConfig(projectRoot) {
+    // Start with defaults (deep copy nested objects)
+    const config = {
+        ...DEFAULT_CONFIG,
+        lifecycleEnforcement: { ...DEFAULT_LIFECYCLE_ENFORCEMENT },
+        protocolValidation: { ...DEFAULT_PROTOCOL_VALIDATION },
+        rateLimiting: {
+            ...DEFAULT_RATE_LIMITING,
+            query: { ...DEFAULT_RATE_LIMITING.query },
+            mutate: { ...DEFAULT_RATE_LIMITING.mutate },
+            spawn: { ...DEFAULT_RATE_LIMITING.spawn },
+        },
+    };
+    // Load from file (overrides defaults)
+    const fileConfig = loadFromFile(projectRoot);
+    // Merge nested objects carefully
+    if (fileConfig.lifecycleEnforcement) {
+        config.lifecycleEnforcement = {
+            ...config.lifecycleEnforcement,
+            ...fileConfig.lifecycleEnforcement,
+        };
+        delete fileConfig.lifecycleEnforcement;
+    }
+    if (fileConfig.protocolValidation) {
+        config.protocolValidation = {
+            ...config.protocolValidation,
+            ...fileConfig.protocolValidation,
+        };
+        delete fileConfig.protocolValidation;
+    }
+    if (fileConfig.rateLimiting) {
+        config.rateLimiting = {
+            ...config.rateLimiting,
+            ...fileConfig.rateLimiting,
+            query: { ...config.rateLimiting.query, ...fileConfig.rateLimiting.query },
+            mutate: { ...config.rateLimiting.mutate, ...fileConfig.rateLimiting.mutate },
+            spawn: { ...config.rateLimiting.spawn, ...fileConfig.rateLimiting.spawn },
+        };
+        delete fileConfig.rateLimiting;
+    }
+    Object.assign(config, fileConfig);
+    // Load from environment (overrides file and defaults)
+    for (const key of Object.keys(DEFAULT_CONFIG)) {
+        const envValue = loadFromEnv(key);
+        if (envValue !== undefined) {
+            config[key] = parseEnvValue(key, envValue);
+        }
+    }
+    // Validate final configuration
+    validateConfig(config);
+    return config;
+}
+/**
+ * Global configuration singleton
+ * Loaded once at module initialization
+ */
+let globalConfig = null;
+/**
+ * Get global configuration (singleton)
+ */
+export function getConfig() {
+    if (globalConfig === null) {
+        globalConfig = loadConfig();
+    }
+    return globalConfig;
+}
+/**
+ * Reset global configuration (for testing)
+ */
+export function resetConfig() {
+    globalConfig = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/defaults.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Default configuration values for CLEO MCP Server
+ *
+ * @task T2928
+ * @task T3145
+ * @task T2916 - Rate limiting configuration (Section 13.3)
+ */
+import type { RateLimitingConfig } from './rate-limiter.js';
+export type { RateLimitingConfig } from './rate-limiter.js';
+export { DEFAULT_RATE_LIMITING } from './rate-limiter.js';
+/**
+ * Lifecycle enforcement configuration (Section 12.2)
+ */
+export interface LifecycleEnforcementConfig {
+    /** Enforcement mode: strict blocks, advisory warns, off skips */
+    mode: 'strict' | 'advisory' | 'off';
+    /** Stages that may be skipped without failing gates */
+    allowSkip: string[];
+    /** Emergency bypass flag - disables all gate checks */
+    emergencyBypass: boolean;
+}
+/**
+ * Protocol validation configuration (Section 12.3)
+ */
+export interface ProtocolValidationConfig {
+    /** Enable strict protocol validation */
+    strictMode: boolean;
+    /** Block operations on protocol violations */
+    blockOnViolation: boolean;
+    /** Log protocol violations to audit trail */
+    logViolations: boolean;
+}
+export interface MCPConfig {
+    /** Path to CLEO CLI binary (default: 'cleo') */
+    cliPath: string;
+    /** Operation timeout in milliseconds (default: 30000) */
+    timeout: number;
+    /** Logging verbosity level (default: 'info') */
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    /** Enable token tracking metrics (default: false) */
+    enableMetrics: boolean;
+    /** Retry count for failed operations (default: 3) */
+    maxRetries: number;
+    /** Enable query cache (default: true) */
+    queryCache: boolean;
+    /** Query cache TTL in milliseconds (default: 30000) */
+    queryCacheTtl: number;
+    /** Enable audit logging (default: true) */
+    auditLog: boolean;
+    /** Strict validation mode (default: true) */
+    strictValidation: boolean;
+    /** Lifecycle enforcement configuration (Section 12.2) */
+    lifecycleEnforcement: LifecycleEnforcementConfig;
+    /** Protocol validation configuration (Section 12.3) */
+    protocolValidation: ProtocolValidationConfig;
+    /** Rate limiting configuration (Section 13.3) */
+    rateLimiting: RateLimitingConfig;
+}
+/**
+ * Default lifecycle enforcement configuration
+ */
+export declare const DEFAULT_LIFECYCLE_ENFORCEMENT: LifecycleEnforcementConfig;
+/**
+ * Default protocol validation configuration
+ */
+export declare const DEFAULT_PROTOCOL_VALIDATION: ProtocolValidationConfig;
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: MCPConfig;
+/**
+ * Environment variable prefix for CLEO configuration
+ */
+export declare const ENV_PREFIX = "CLEO_MCP_";
+/**
+ * Configuration schema for validation
+ */
+export declare const CONFIG_SCHEMA: {
+    readonly cliPath: {
+        readonly type: "string";
+        readonly required: true;
+    };
+    readonly timeout: {
+        readonly type: "number";
+        readonly min: 1000;
+        readonly max: 300000;
+    };
+    readonly logLevel: {
+        readonly type: "string";
+        readonly enum: readonly ["debug", "info", "warn", "error"];
+    };
+    readonly enableMetrics: {
+        readonly type: "boolean";
+    };
+    readonly maxRetries: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 10;
+    };
+    readonly queryCache: {
+        readonly type: "boolean";
+    };
+    readonly queryCacheTtl: {
+        readonly type: "number";
+        readonly min: 0;
+        readonly max: 600000;
+    };
+    readonly auditLog: {
+        readonly type: "boolean";
+    };
+    readonly strictValidation: {
+        readonly type: "boolean";
+    };
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/lib/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/lib/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;IACpC,uDAAuD;IACvD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uDAAuD;IACvD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE9C,qDAAqD;IACrD,aAAa,EAAE,OAAO,CAAC;IAEvB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,UAAU,EAAE,OAAO,CAAC;IAEpB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IAEtB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAElB,6CAA6C;IAC7C,gBAAgB,EAAE,OAAO,CAAC;IAE1B,yDAAyD;IACzD,oBAAoB,EAAE,0BAA0B,CAAC;IAEjD,uDAAuD;IACvD,kBAAkB,EAAE,wBAAwB,CAAC;IAE7C,iDAAiD;IACjD,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,0BAI3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,wBAIzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAa5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,cAAc,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUhB,CAAC"}

package/dist/lib/defaults.js

@@ -0,0 +1,61 @@
+/**
+ * Default configuration values for CLEO MCP Server
+ *
+ * @task T2928
+ * @task T3145
+ * @task T2916 - Rate limiting configuration (Section 13.3)
+ */
+import { DEFAULT_RATE_LIMITING } from './rate-limiter.js';
+export { DEFAULT_RATE_LIMITING } from './rate-limiter.js';
+/**
+ * Default lifecycle enforcement configuration
+ */
+export const DEFAULT_LIFECYCLE_ENFORCEMENT = {
+    mode: 'strict',
+    allowSkip: ['consensus'],
+    emergencyBypass: false,
+};
+/**
+ * Default protocol validation configuration
+ */
+export const DEFAULT_PROTOCOL_VALIDATION = {
+    strictMode: true,
+    blockOnViolation: true,
+    logViolations: true,
+};
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    cliPath: 'cleo',
+    timeout: 30000, // 30 seconds
+    logLevel: 'info',
+    enableMetrics: false,
+    maxRetries: 3,
+    queryCache: true,
+    queryCacheTtl: 30000, // 30 seconds
+    auditLog: true,
+    strictValidation: true,
+    lifecycleEnforcement: { ...DEFAULT_LIFECYCLE_ENFORCEMENT },
+    protocolValidation: { ...DEFAULT_PROTOCOL_VALIDATION },
+    rateLimiting: { ...DEFAULT_RATE_LIMITING },
+};
+/**
+ * Environment variable prefix for CLEO configuration
+ */
+export const ENV_PREFIX = 'CLEO_MCP_';
+/**
+ * Configuration schema for validation
+ */
+export const CONFIG_SCHEMA = {
+    cliPath: { type: 'string', required: true },
+    timeout: { type: 'number', min: 1000, max: 300000 },
+    logLevel: { type: 'string', enum: ['debug', 'info', 'warn', 'error'] },
+    enableMetrics: { type: 'boolean' },
+    maxRetries: { type: 'number', min: 0, max: 10 },
+    queryCache: { type: 'boolean' },
+    queryCacheTtl: { type: 'number', min: 0, max: 600000 },
+    auditLog: { type: 'boolean' },
+    strictValidation: { type: 'boolean' },
+};
+//# sourceMappingURL=defaults.js.map

package/dist/lib/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/lib/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAgE1D;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA+B;IACvE,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC,WAAW,CAAC;IACxB,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAA6B;IACnE,UAAU,EAAE,IAAI;IAChB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,KAAK,EAAE,aAAa;IAC7B,QAAQ,EAAE,MAAM;IAChB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,KAAK,EAAE,aAAa;IACnC,QAAQ,EAAE,IAAI;IACd,gBAAgB,EAAE,IAAI;IACtB,oBAAoB,EAAE,EAAE,GAAG,6BAA6B,EAAE;IAC1D,kBAAkB,EAAE,EAAE,GAAG,2BAA2B,EAAE;IACtD,YAAY,EAAE,EAAE,GAAG,qBAAqB,EAAE;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE;IACnD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IACtE,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE;IACtD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC7B,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAC7B,CAAC"}

package/dist/lib/error-handler.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Error handler for CLEO CLI operations
+ *
+ * @task T2913
+ * @epic T2908
+ *
+ * Processes CLI errors, generates contextual fix commands,
+ * and formats error responses with recovery suggestions.
+ */
+import { ErrorSeverity, ErrorCategory, type ErrorAlternative } from './exit-codes.js';
+/**
+ * CLI error context
+ */
+export interface CLIErrorContext {
+    command: string;
+    args: string[];
+    stderr?: string;
+    stdout?: string;
+    details?: Record<string, string>;
+}
+/**
+ * Formatted error response
+ */
+export interface FormattedError {
+    code: string;
+    name: string;
+    exitCode: number;
+    message: string;
+    description: string;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    retryable: boolean;
+    fix?: string;
+    alternatives?: ErrorAlternative[];
+    context?: Record<string, string>;
+    documentation?: string;
+}
+/**
+ * Handle CLI error and format response
+ */
+export declare function handleCLIError(exitCode: number, context: CLIErrorContext): FormattedError;
+/**
+ * Check if error is recoverable (can be fixed by user action)
+ */
+export declare function isRecoverable(exitCode: number): boolean;
+/**
+ * Format error for MCP response
+ */
+export declare function formatErrorForMCP(error: FormattedError): {
+    success: false;
+    error: {
+        code: string;
+        exitCode: number;
+        message: string;
+        details?: Record<string, unknown>;
+        fix?: string;
+        alternatives?: ErrorAlternative[];
+    };
+};
+/**
+ * Add error context from operation details
+ */
+export declare function addErrorContext(context: CLIErrorContext, additionalDetails: Record<string, string>): CLIErrorContext;
+/**
+ * Create error context from operation
+ */
+export declare function createErrorContext(command: string, args: string[], stderr?: string, stdout?: string, details?: Record<string, string>): CLIErrorContext;
+/**
+ * Error with exit code information for retry logic
+ *
+ * @task T3142
+ */
+export interface CLIError extends Error {
+    exitCode: number;
+}
+/**
+ * Result of a retried operation, including retry metadata
+ *
+ * @task T3142
+ */
+export interface RetryResult<T> {
+    result: T;
+    attempts: number;
+    retriedExitCodes: number[];
+}
+/**
+ * Retry an operation with exponential backoff for retryable errors.
+ *
+ * Per MCP-SERVER-SPECIFICATION Section 9.1:
+ * - Exit codes 7, 20-22, 60-63 support retry with exponential backoff
+ * - Max 3 attempts by default
+ * - Backoff: 2^attempt seconds
+ * - Tracks retry count in response metadata
+ *
+ * Non-recoverable errors (Section 9.2) are never retried and
+ * immediately rethrown.
+ *
+ * @task T3142
+ */
+export declare function retryOperation<T>(fn: () => Promise<T>, maxAttempts?: number): Promise<RetryResult<T>>;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/lib/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,aAAa,EACb,aAAa,EAQb,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,GACvB,cAAc,CA0BhB;AAuHD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgDvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG;IACxD,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;KACnC,CAAC;CACH,CAmBA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,eAAe,CAQjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,eAAe,CAQjB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAS,SAAQ,KAAK;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AASD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,GAAE,MAA6B,GACzC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAuCzB"}