mcp-agent-foundry 1.0.0

package/dist/config/validator.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Configuration Validator for AgentRouter
+ *
+ * Validates configuration objects against a JSON Schema using AJV.
+ * Provides detailed, human-readable error messages on validation failure.
+ */
+import { type ErrorObject } from 'ajv';
+import { type Config } from '../types.js';
+/**
+ * Validation result returned by the validator.
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Array of error messages (empty if valid) */
+    errors: string[];
+    /** Detailed error objects from AJV */
+    details?: ErrorObject[];
+}
+/**
+ * Configuration validator using AJV.
+ */
+export declare class ConfigValidator {
+    private ajv;
+    private validateFull;
+    private validatePartial;
+    constructor();
+    /**
+     * Validate a complete configuration object.
+     * Throws ConfigurationError if validation fails.
+     *
+     * @param config - Configuration object to validate
+     * @returns The validated config (typed as Config)
+     * @throws ConfigurationError if validation fails
+     */
+    validate(config: unknown): Config;
+    /**
+     * Validate a partial configuration object (for merging).
+     * Throws ConfigurationError if validation fails.
+     *
+     * @param config - Partial configuration object to validate
+     * @returns The validated partial config
+     * @throws ConfigurationError if validation fails
+     */
+    validatePartialConfig(config: unknown): Partial<Config>;
+    /**
+     * Validate configuration and return a result object instead of throwing.
+     *
+     * @param config - Configuration object to validate
+     * @param partial - Whether to validate as partial config
+     * @returns ValidationResult with valid flag and any errors
+     */
+    validateConfig(config: unknown, partial?: boolean): ValidationResult;
+    /**
+     * Perform semantic validation beyond schema validation.
+     * Checks for logical consistency like provider references.
+     *
+     * @param config - Config object that passed schema validation
+     * @throws ConfigurationError if semantic validation fails
+     */
+    private validateSemantics;
+    /**
+     * Format AJV errors into human-readable messages.
+     *
+     * @param errors - Array of AJV error objects
+     * @returns Array of formatted error strings
+     */
+    private formatErrors;
+    /**
+     * Get a human-readable message for an AJV error.
+     *
+     * @param error - AJV error object
+     * @returns Human-readable error message
+     */
+    private getErrorMessage;
+}
+/**
+ * Convenience function to validate a configuration object.
+ * Creates a new validator instance and validates the config.
+ *
+ * @param config - Configuration object to validate
+ * @returns The validated config
+ * @throws ConfigurationError if validation fails
+ */
+export declare function validateConfig(config: unknown): Config;
+/**
+ * Convenience function to check if a config is valid without throwing.
+ *
+ * @param config - Configuration object to check
+ * @returns True if valid, false otherwise
+ */
+export declare function isValidConfig(config: unknown): config is Config;
+/**
+ * Export the schema for external use (e.g., generating schema.json).
+ */
+export declare const configSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly type: "object";
+    readonly required: readonly ["version", "defaults", "roles", "providers"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly version: {
+            readonly type: "string";
+            readonly pattern: "^\\d+\\.\\d+$";
+            readonly description: "Configuration schema version (e.g., \"1.0\")";
+        };
+        readonly defaults: {
+            readonly type: "object";
+            readonly required: readonly ["temperature", "max_tokens", "timeout_ms"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly temperature: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 2;
+                    readonly description: "Default temperature for LLM requests (0-2)";
+                };
+                readonly max_tokens: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 200000;
+                    readonly description: "Default maximum tokens for LLM responses";
+                };
+                readonly timeout_ms: {
+                    readonly type: "integer";
+                    readonly minimum: 1000;
+                    readonly maximum: 600000;
+                    readonly description: "Default timeout in milliseconds (1s-10min)";
+                };
+            };
+        };
+        readonly roles: {
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: {
+                readonly $ref: "#/$defs/roleConfig";
+            };
+            readonly description: "Role definitions mapping role names to configurations";
+        };
+        readonly providers: {
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: {
+                readonly $ref: "#/$defs/providerConfig";
+            };
+            readonly description: "Provider configurations";
+        };
+    };
+    readonly $defs: {
+        readonly roleConfig: {
+            readonly type: "object";
+            readonly required: readonly ["provider", "model"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly provider: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Provider name (must match a key in providers)";
+                };
+                readonly model: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Model identifier";
+                };
+                readonly system_prompt: {
+                    readonly type: "string";
+                    readonly description: "System prompt / persona for this role";
+                };
+                readonly temperature: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 2;
+                    readonly description: "Temperature override (0-2)";
+                };
+                readonly max_tokens: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 200000;
+                    readonly description: "Max tokens override";
+                };
+                readonly timeout_ms: {
+                    readonly type: "integer";
+                    readonly minimum: 1000;
+                    readonly maximum: 600000;
+                    readonly description: "Timeout override in milliseconds";
+                };
+                readonly fallback: {
+                    readonly $ref: "#/$defs/fallbackConfig";
+                };
+            };
+        };
+        readonly fallbackConfig: {
+            readonly type: "object";
+            readonly required: readonly ["provider", "model"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly provider: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Fallback provider name";
+                };
+                readonly model: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Fallback model identifier";
+                };
+            };
+        };
+        readonly providerConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly api_key: {
+                    readonly type: "string";
+                    readonly description: "API key (supports ${ENV_VAR} interpolation)";
+                };
+                readonly base_url: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "Base URL for the provider API";
+                };
+                readonly organization: {
+                    readonly type: "string";
+                    readonly description: "Organization ID (OpenAI)";
+                };
+                readonly project: {
+                    readonly type: "string";
+                    readonly description: "Project ID (Google Cloud)";
+                };
+                readonly location: {
+                    readonly type: "string";
+                    readonly description: "Region/location (Google Cloud)";
+                };
+                readonly headers: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Additional headers for API requests";
+                };
+                readonly access_mode: {
+                    readonly type: "string";
+                    readonly enum: readonly ["api", "subscription"];
+                    readonly description: "Access mode: \"api\" for pay-per-token or \"subscription\" for CLI tools";
+                };
+                readonly default_model: {
+                    readonly type: "string";
+                    readonly description: "Default model for this provider";
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=validator.d.ts.map

package/dist/config/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/config/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAmB,EAAE,KAAK,WAAW,EAA8C,MAAM,KAAK,CAAC;AAE/F,OAAO,EAAsB,KAAM,MAAM,EAAE,MAAM,aAAa,CAAC;AAuL/D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sCAAsC;IACtC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAU;IACrB,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,eAAe,CAAmB;;IAgB1C;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAejC;;;;;;;OAOG;IACH,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAYvD;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,UAAQ,GAAG,gBAAgB;IAyBlE;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAsCxB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAI/D;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAgB,CAAC"}

package/dist/config/validator.js

@@ -0,0 +1,363 @@
+/**
+ * Configuration Validator for AgentRouter
+ *
+ * Validates configuration objects against a JSON Schema using AJV.
+ * Provides detailed, human-readable error messages on validation failure.
+ */
+import AjvDefault from 'ajv';
+import { ConfigurationError } from '../types.js';
+// Handle ESM/CJS interop - AJV exports both default and named export
+const Ajv = AjvDefault.default ?? AjvDefault;
+/**
+ * JSON Schema for AgentRouter configuration.
+ * Defines the structure and constraints for config files.
+ */
+const CONFIG_SCHEMA = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    type: 'object',
+    required: ['version', 'defaults', 'roles', 'providers'],
+    additionalProperties: false,
+    properties: {
+        version: {
+            type: 'string',
+            pattern: '^\\d+\\.\\d+$',
+            description: 'Configuration schema version (e.g., "1.0")',
+        },
+        defaults: {
+            type: 'object',
+            required: ['temperature', 'max_tokens', 'timeout_ms'],
+            additionalProperties: false,
+            properties: {
+                temperature: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 2,
+                    description: 'Default temperature for LLM requests (0-2)',
+                },
+                max_tokens: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 200000,
+                    description: 'Default maximum tokens for LLM responses',
+                },
+                timeout_ms: {
+                    type: 'integer',
+                    minimum: 1000,
+                    maximum: 600000,
+                    description: 'Default timeout in milliseconds (1s-10min)',
+                },
+            },
+        },
+        roles: {
+            type: 'object',
+            minProperties: 1,
+            additionalProperties: {
+                $ref: '#/$defs/roleConfig',
+            },
+            description: 'Role definitions mapping role names to configurations',
+        },
+        providers: {
+            type: 'object',
+            minProperties: 1,
+            additionalProperties: {
+                $ref: '#/$defs/providerConfig',
+            },
+            description: 'Provider configurations',
+        },
+    },
+    $defs: {
+        roleConfig: {
+            type: 'object',
+            required: ['provider', 'model'],
+            additionalProperties: false,
+            properties: {
+                provider: {
+                    type: 'string',
+                    minLength: 1,
+                    description: 'Provider name (must match a key in providers)',
+                },
+                model: {
+                    type: 'string',
+                    minLength: 1,
+                    description: 'Model identifier',
+                },
+                system_prompt: {
+                    type: 'string',
+                    description: 'System prompt / persona for this role',
+                },
+                temperature: {
+                    type: 'number',
+                    minimum: 0,
+                    maximum: 2,
+                    description: 'Temperature override (0-2)',
+                },
+                max_tokens: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: 200000,
+                    description: 'Max tokens override',
+                },
+                timeout_ms: {
+                    type: 'integer',
+                    minimum: 1000,
+                    maximum: 600000,
+                    description: 'Timeout override in milliseconds',
+                },
+                fallback: {
+                    $ref: '#/$defs/fallbackConfig',
+                },
+            },
+        },
+        fallbackConfig: {
+            type: 'object',
+            required: ['provider', 'model'],
+            additionalProperties: false,
+            properties: {
+                provider: {
+                    type: 'string',
+                    minLength: 1,
+                    description: 'Fallback provider name',
+                },
+                model: {
+                    type: 'string',
+                    minLength: 1,
+                    description: 'Fallback model identifier',
+                },
+            },
+        },
+        providerConfig: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                api_key: {
+                    type: 'string',
+                    description: 'API key (supports ${ENV_VAR} interpolation)',
+                },
+                base_url: {
+                    type: 'string',
+                    format: 'uri',
+                    description: 'Base URL for the provider API',
+                },
+                organization: {
+                    type: 'string',
+                    description: 'Organization ID (OpenAI)',
+                },
+                project: {
+                    type: 'string',
+                    description: 'Project ID (Google Cloud)',
+                },
+                location: {
+                    type: 'string',
+                    description: 'Region/location (Google Cloud)',
+                },
+                headers: {
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                    description: 'Additional headers for API requests',
+                },
+                access_mode: {
+                    type: 'string',
+                    enum: ['api', 'subscription'],
+                    description: 'Access mode: "api" for pay-per-token or "subscription" for CLI tools',
+                },
+                default_model: {
+                    type: 'string',
+                    description: 'Default model for this provider',
+                },
+            },
+        },
+    },
+};
+/**
+ * Schema for partial configuration (used during merging).
+ * All top-level fields are optional.
+ */
+const PARTIAL_CONFIG_SCHEMA = {
+    ...CONFIG_SCHEMA,
+    required: [],
+    properties: {
+        ...CONFIG_SCHEMA.properties,
+        defaults: {
+            type: 'object',
+            additionalProperties: false,
+            properties: CONFIG_SCHEMA.properties.defaults.properties,
+        },
+    },
+};
+/**
+ * Configuration validator using AJV.
+ */
+export class ConfigValidator {
+    ajv;
+    validateFull;
+    validatePartial;
+    constructor() {
+        this.ajv = new Ajv({
+            allErrors: true,
+            verbose: true,
+            strict: true,
+            formats: {
+                uri: /^https?:\/\/.+/,
+            },
+        });
+        this.validateFull = this.ajv.compile(CONFIG_SCHEMA);
+        this.validatePartial = this.ajv.compile(PARTIAL_CONFIG_SCHEMA);
+    }
+    /**
+     * Validate a complete configuration object.
+     * Throws ConfigurationError if validation fails.
+     *
+     * @param config - Configuration object to validate
+     * @returns The validated config (typed as Config)
+     * @throws ConfigurationError if validation fails
+     */
+    validate(config) {
+        const result = this.validateConfig(config, false);
+        if (!result.valid) {
+            throw new ConfigurationError(`Invalid configuration:\n${result.errors.map((e) => `  - ${e}`).join('\n')}`);
+        }
+        // Additional semantic validation
+        this.validateSemantics(config);
+        return config;
+    }
+    /**
+     * Validate a partial configuration object (for merging).
+     * Throws ConfigurationError if validation fails.
+     *
+     * @param config - Partial configuration object to validate
+     * @returns The validated partial config
+     * @throws ConfigurationError if validation fails
+     */
+    validatePartialConfig(config) {
+        const result = this.validateConfig(config, true);
+        if (!result.valid) {
+            throw new ConfigurationError(`Invalid partial configuration:\n${result.errors.map((e) => `  - ${e}`).join('\n')}`);
+        }
+        return config;
+    }
+    /**
+     * Validate configuration and return a result object instead of throwing.
+     *
+     * @param config - Configuration object to validate
+     * @param partial - Whether to validate as partial config
+     * @returns ValidationResult with valid flag and any errors
+     */
+    validateConfig(config, partial = false) {
+        const validator = partial ? this.validatePartial : this.validateFull;
+        const valid = validator(config);
+        if (valid) {
+            return { valid: true, errors: [] };
+        }
+        const errors = this.formatErrors(validator.errors ?? []);
+        const details = validator.errors ?? undefined;
+        if (details) {
+            return {
+                valid: false,
+                errors,
+                details,
+            };
+        }
+        return {
+            valid: false,
+            errors,
+        };
+    }
+    /**
+     * Perform semantic validation beyond schema validation.
+     * Checks for logical consistency like provider references.
+     *
+     * @param config - Config object that passed schema validation
+     * @throws ConfigurationError if semantic validation fails
+     */
+    validateSemantics(config) {
+        const errors = [];
+        const providerNames = new Set(Object.keys(config.providers));
+        // Check that all role providers exist
+        for (const [roleName, roleConfig] of Object.entries(config.roles)) {
+            if (!providerNames.has(roleConfig.provider)) {
+                errors.push(`Role "${roleName}" references undefined provider "${roleConfig.provider}"`);
+            }
+            // Check fallback provider exists
+            if (roleConfig.fallback && !providerNames.has(roleConfig.fallback.provider)) {
+                errors.push(`Role "${roleName}" fallback references undefined provider "${roleConfig.fallback.provider}"`);
+            }
+        }
+        if (errors.length > 0) {
+            throw new ConfigurationError(`Configuration semantic errors:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+        }
+    }
+    /**
+     * Format AJV errors into human-readable messages.
+     *
+     * @param errors - Array of AJV error objects
+     * @returns Array of formatted error strings
+     */
+    formatErrors(errors) {
+        return errors.map((error) => {
+            const path = error.instancePath || 'root';
+            const message = this.getErrorMessage(error);
+            return `${path}: ${message}`;
+        });
+    }
+    /**
+     * Get a human-readable message for an AJV error.
+     *
+     * @param error - AJV error object
+     * @returns Human-readable error message
+     */
+    getErrorMessage(error) {
+        const params = error.params;
+        switch (error.keyword) {
+            case 'required':
+                return `missing required property "${params['missingProperty']}"`;
+            case 'additionalProperties':
+                return `unexpected property "${params['additionalProperty']}"`;
+            case 'type':
+                return `expected ${params['type']}, got ${typeof error.data}`;
+            case 'minimum':
+                return `value ${error.data} is less than minimum ${params['limit']}`;
+            case 'maximum':
+                return `value ${error.data} is greater than maximum ${params['limit']}`;
+            case 'minLength':
+                return `string is too short (minimum ${params['limit']} characters)`;
+            case 'pattern':
+                return `string does not match required pattern "${params['pattern']}"`;
+            case 'format':
+                return `invalid format, expected ${params['format']}`;
+            case 'minProperties':
+                return `object must have at least ${params['limit']} properties`;
+            case 'enum':
+                return `must be one of: ${params['allowedValues'].join(', ')}`;
+            default:
+                return error.message ?? 'validation failed';
+        }
+    }
+}
+/**
+ * Convenience function to validate a configuration object.
+ * Creates a new validator instance and validates the config.
+ *
+ * @param config - Configuration object to validate
+ * @returns The validated config
+ * @throws ConfigurationError if validation fails
+ */
+export function validateConfig(config) {
+    const validator = new ConfigValidator();
+    return validator.validate(config);
+}
+/**
+ * Convenience function to check if a config is valid without throwing.
+ *
+ * @param config - Configuration object to check
+ * @returns True if valid, false otherwise
+ */
+export function isValidConfig(config) {
+    const validator = new ConfigValidator();
+    const result = validator.validateConfig(config, false);
+    return result.valid;
+}
+/**
+ * Export the schema for external use (e.g., generating schema.json).
+ */
+export const configSchema = CONFIG_SCHEMA;
+//# sourceMappingURL=validator.js.map

package/dist/config/validator.js.map

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

package/dist/config/worktree-defaults.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Default Worktree Configuration
+ *
+ * Defines which roles need worktrees and default worktree settings.
+ */
+import type { WorktreeConfig } from '../types.js';
+/**
+ * Roles that need isolated worktrees by default
+ */
+export declare const ROLES_NEEDING_WORKTREE: Set<string>;
+/**
+ * Check if a role needs a worktree
+ */
+export declare function roleNeedsWorktree(role: string, configOverride?: boolean): boolean;
+/**
+ * Default worktree configuration
+ */
+export declare const DEFAULT_WORKTREE_CONFIG: WorktreeConfig;
+/**
+ * Merge user config with defaults
+ */
+export declare function mergeWorktreeConfig(userConfig?: Partial<WorktreeConfig>): WorktreeConfig;
+//# sourceMappingURL=worktree-defaults.d.ts.map

package/dist/config/worktree-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-defaults.d.ts","sourceRoot":"","sources":["../../src/config/worktree-defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAK7C,CAAC;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAOjF;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAqBrC,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAuBxF"}