@nexus-cortex/core 4.26.0

package/dist/models/registry/ModelAliasResolver.js

@@ -0,0 +1,255 @@
+/**
+ * Model Alias Resolver
+ *
+ * Resolves model aliases (like 'sonnet', 'opus', 'haiku') to full model IDs.
+ * Used by the sub-agent system to support convenient model specification
+ * in agent definitions.
+ *
+ * @module models/registry/ModelAliasResolver
+ * @version 1.0.0
+ */
+/**
+ * Standard model aliases mapping to full model IDs
+ *
+ * These aliases provide convenient shortcuts for common models.
+ * Aliases are case-insensitive when resolved.
+ */
+export const MODEL_ALIASES = {
+    // ─────────────────────────────────────────────────────────────────
+    // Anthropic Claude Models
+    // ─────────────────────────────────────────────────────────────────
+    'sonnet': 'claude-sonnet-4-5-20250929',
+    'claude-sonnet': 'claude-sonnet-4-5-20250929',
+    'sonnet-4': 'claude-sonnet-4-5-20250929',
+    'sonnet-4.5': 'claude-sonnet-4-5-20250929',
+    'opus': 'claude-opus-4-1-20250805',
+    'claude-opus': 'claude-opus-4-1-20250805',
+    'opus-4': 'claude-opus-4-1-20250805',
+    'haiku': 'claude-3-5-haiku-20241022',
+    'claude-haiku': 'claude-3-5-haiku-20241022',
+    'haiku-3.5': 'claude-3-5-haiku-20241022',
+    // ─────────────────────────────────────────────────────────────────
+    // Google Gemini Models
+    // ─────────────────────────────────────────────────────────────────
+    'gemini': 'gemini-2.5-pro',
+    'gemini-pro': 'gemini-2.5-pro',
+    'gemini-2.5': 'gemini-2.5-pro',
+    'gemini-flash': 'gemini-2.5-flash',
+    'flash': 'gemini-2.5-flash',
+    'gemini-thinking': 'gemini-2.5-flash-thinking',
+    // ─────────────────────────────────────────────────────────────────
+    // OpenAI Models
+    // ─────────────────────────────────────────────────────────────────
+    'gpt4': 'gpt-4.1',
+    'gpt-4': 'gpt-4.1',
+    'gpt4o': 'gpt-4o',
+    'gpt-4o': 'gpt-4o',
+    'gpt4o-mini': 'gpt-4o-mini',
+    'o1': 'o1',
+    'o1-mini': 'o1-mini',
+    'o1-preview': 'o1-preview',
+    'o3': 'o3',
+    'o3-mini': 'o3-mini',
+    'o4-mini': 'o4-mini',
+    // ─────────────────────────────────────────────────────────────────
+    // X.AI Grok Models
+    // ─────────────────────────────────────────────────────────────────
+    'grok': 'grok-4.1-fast-reasoning',
+    'grok-4': 'grok-4.1-fast-reasoning',
+    'grok-fast': 'grok-4.1-fast-reasoning',
+    'grok-mini': 'grok-3-mini-fast-beta',
+    // ─────────────────────────────────────────────────────────────────
+    // DeepSeek Models
+    // deepseek-chat / deepseek-reasoner are deprecated by DeepSeek on 2026-07-24
+    // (cards removed 2026-06-10). The old names redirect to their V4 successors so
+    // existing agent configs and sessions keep resolving. 'deepseek-coder' was never
+    // a registered card, so its self-alias is dropped.
+    // ─────────────────────────────────────────────────────────────────
+    'deepseek': 'deepseek-v4-pro',
+    'deepseek-chat': 'deepseek-v4-flash',
+    'reasoner': 'deepseek-v4-pro',
+    'deepseek-reasoner': 'deepseek-v4-pro',
+    // ─────────────────────────────────────────────────────────────────
+    // Mistral Models
+    // ─────────────────────────────────────────────────────────────────
+    'mistral': 'mistral-large-latest',
+    'mistral-large': 'mistral-large-latest',
+    'codestral': 'codestral-latest',
+    'pixtral': 'pixtral-large-latest',
+    // ─────────────────────────────────────────────────────────────────
+    // Cohere Models
+    // ─────────────────────────────────────────────────────────────────
+    'command-r': 'command-r-plus',
+    'cohere': 'command-r-plus',
+};
+/**
+ * Model Alias Resolver
+ *
+ * Provides resolution of model aliases to full model IDs with optional
+ * validation against a model registry.
+ */
+export class ModelAliasResolver {
+    aliases;
+    constructor(customAliases) {
+        // Build case-insensitive alias map
+        this.aliases = new Map();
+        // Add standard aliases
+        for (const [alias, modelId] of Object.entries(MODEL_ALIASES)) {
+            this.aliases.set(alias.toLowerCase(), modelId);
+        }
+        // Add custom aliases (override if conflicts)
+        if (customAliases) {
+            for (const [alias, modelId] of Object.entries(customAliases)) {
+                this.aliases.set(alias.toLowerCase(), modelId);
+            }
+        }
+    }
+    /**
+     * Resolve a model specification to a full model ID
+     *
+     * @param modelSpec - Can be:
+     *   - 'inherit': Returns null (use parent's model)
+     *   - An alias like 'sonnet': Returns the full model ID
+     *   - A full model ID: Returns as-is (optionally validated)
+     * @param options - Resolution options
+     * @returns Resolved model info, or null for 'inherit'
+     * @throws Error if strict mode and model is unknown
+     */
+    resolve(modelSpec, options = {}) {
+        const { strict = true, registry } = options;
+        const normalized = modelSpec.trim().toLowerCase();
+        // Handle 'inherit' special case
+        if (normalized === 'inherit') {
+            return null;
+        }
+        // Check if it's a known alias
+        const aliasedModelId = this.aliases.get(normalized);
+        if (aliasedModelId) {
+            return {
+                modelId: aliasedModelId,
+                wasAlias: true,
+                originalInput: modelSpec,
+            };
+        }
+        // Not an alias - treat as full model ID
+        // Optionally validate against registry
+        if (registry) {
+            if (!registry.hasModel(modelSpec)) {
+                if (strict) {
+                    const available = this.getAvailableAliases().slice(0, 10).join(', ');
+                    throw new Error(`Unknown model: "${modelSpec}". ` +
+                        `Use an alias (${available}, ...) or a valid model ID from the registry.`);
+                }
+                return null;
+            }
+        }
+        // Return the model ID as-is
+        return {
+            modelId: modelSpec,
+            wasAlias: false,
+            originalInput: modelSpec,
+        };
+    }
+    /**
+     * Quick resolution without options
+     * Returns the model ID string or null for 'inherit'
+     * Throws on unknown models
+     */
+    resolveToId(modelSpec) {
+        const result = this.resolve(modelSpec, { strict: false });
+        return result?.modelId ?? null;
+    }
+    /**
+     * Check if a string is a known alias
+     */
+    isAlias(spec) {
+        return this.aliases.has(spec.toLowerCase());
+    }
+    /**
+     * Get all available alias names
+     */
+    getAvailableAliases() {
+        return Array.from(this.aliases.keys()).sort();
+    }
+    /**
+     * Get the target model ID for an alias
+     * Returns undefined if not an alias
+     */
+    getAliasTarget(alias) {
+        return this.aliases.get(alias.toLowerCase());
+    }
+    /**
+     * Add a custom alias
+     */
+    addAlias(alias, modelId) {
+        this.aliases.set(alias.toLowerCase(), modelId);
+    }
+    /**
+     * Remove an alias
+     */
+    removeAlias(alias) {
+        return this.aliases.delete(alias.toLowerCase());
+    }
+    /**
+     * Get all aliases grouped by provider
+     */
+    getAliasesByProvider() {
+        const grouped = {
+            anthropic: [],
+            google: [],
+            openai: [],
+            xai: [],
+            deepseek: [],
+            mistral: [],
+            cohere: [],
+            other: [],
+        };
+        for (const [alias, modelId] of this.aliases) {
+            if (modelId.startsWith('claude')) {
+                grouped.anthropic.push(alias);
+            }
+            else if (modelId.startsWith('gemini')) {
+                grouped.google.push(alias);
+            }
+            else if (modelId.startsWith('gpt') || modelId.startsWith('o1') || modelId.startsWith('o3') || modelId.startsWith('o4')) {
+                grouped.openai.push(alias);
+            }
+            else if (modelId.startsWith('grok')) {
+                grouped.xai.push(alias);
+            }
+            else if (modelId.startsWith('deepseek')) {
+                grouped.deepseek.push(alias);
+            }
+            else if (modelId.startsWith('mistral') || modelId.startsWith('codestral') || modelId.startsWith('pixtral')) {
+                grouped.mistral.push(alias);
+            }
+            else if (modelId.startsWith('command')) {
+                grouped.cohere.push(alias);
+            }
+            else {
+                grouped.other.push(alias);
+            }
+        }
+        return grouped;
+    }
+}
+/**
+ * Default singleton instance
+ */
+let defaultResolver = null;
+/**
+ * Get the default resolver instance
+ */
+export function getDefaultResolver() {
+    if (!defaultResolver) {
+        defaultResolver = new ModelAliasResolver();
+    }
+    return defaultResolver;
+}
+/**
+ * Convenience function: resolve a model spec using the default resolver
+ */
+export function resolveModelAlias(modelSpec) {
+    return getDefaultResolver().resolveToId(modelSpec);
+}
+//# sourceMappingURL=ModelAliasResolver.js.map

package/dist/models/registry/ModelAliasResolver.js.map

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

package/dist/models/registry/ModelCardLoader.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Model Card Loader
+ * Auto-discovers and loads model cards from the cards/ directory
+ *
+ * Phase 2: Modular Registry Architecture
+ */
+import type { ModelConfig } from '../ModelConfig.interface.js';
+export interface ModelCardLoaderOptions {
+    /**
+     * Directory to search for model cards
+     * Default: packages/core/src/models/cards/
+     */
+    cardsPath?: string;
+    /**
+     * Provider filter (e.g., 'xai', 'anthropic')
+     * Default: undefined (load all providers)
+     */
+    provider?: string;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+}
+export declare class ModelCardLoader {
+    private cardsPath;
+    private provider?;
+    private debug;
+    constructor(options?: ModelCardLoaderOptions);
+    /**
+     * Discover and load all model cards
+     * Returns array of ModelConfig objects
+     */
+    loadModelCards(): Promise<ModelConfig[]>;
+    /**
+     * Load a single model card file
+     * Supports both default and named exports
+     */
+    private loadCardFile;
+    /**
+     * Type guard to check if an object is a ModelConfig
+     */
+    private isModelConfig;
+}
+//# sourceMappingURL=ModelCardLoader.d.ts.map

package/dist/models/registry/ModelCardLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelCardLoader.d.ts","sourceRoot":"","sources":["../../../src/models/registry/ModelCardLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAK/D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAU;gBAEX,OAAO,GAAE,sBAA2B;IAMhD;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IA+C9C;;;OAGG;YACW,YAAY;IA0C1B;;OAEG;IACH,OAAO,CAAC,aAAa;CAkBtB"}

package/dist/models/registry/ModelCardLoader.js

@@ -0,0 +1,124 @@
+/**
+ * Model Card Loader
+ * Auto-discovers and loads model cards from the cards/ directory
+ *
+ * Phase 2: Modular Registry Architecture
+ */
+import { glob } from 'glob';
+import { pathToFileURL } from 'url';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class ModelCardLoader {
+    cardsPath;
+    provider;
+    debug;
+    constructor(options = {}) {
+        this.cardsPath = options.cardsPath || path.join(__dirname, '../cards');
+        this.provider = options.provider;
+        this.debug = options.debug || false;
+    }
+    /**
+     * Discover and load all model cards
+     * Returns array of ModelConfig objects
+     */
+    async loadModelCards() {
+        const models = [];
+        try {
+            // Build glob pattern
+            const pattern = this.provider
+                ? `${this.provider}/**/*.ts`
+                : '**/*.ts';
+            if (this.debug) {
+                console.log(`[ModelCardLoader] Searching for model cards:`);
+                console.log(` Path: ${this.cardsPath}`);
+                console.log(` Pattern: ${pattern}`);
+            }
+            // Find all model card files
+            const cardFiles = await glob.glob(pattern, {
+                cwd: this.cardsPath,
+                ignore: ['**/index.ts', '**/*.test.ts', '**/*.spec.ts'],
+                absolute: false
+            });
+            if (this.debug) {
+                console.log(`[ModelCardLoader] Found ${cardFiles.length} model card files`);
+            }
+            // Load each card file
+            for (const file of cardFiles) {
+                try {
+                    const models = await this.loadCardFile(file);
+                    models.push(...models);
+                }
+                catch (error) {
+                    console.error(`[ModelCardLoader] Failed to load ${file}:`, error);
+                }
+            }
+            if (this.debug) {
+                console.log(`[ModelCardLoader] Loaded ${models.length} models total`);
+            }
+            return models;
+        }
+        catch (error) {
+            console.error('[ModelCardLoader] Error during model card discovery:', error);
+            return [];
+        }
+    }
+    /**
+     * Load a single model card file
+     * Supports both default and named exports
+     */
+    async loadCardFile(file) {
+        const models = [];
+        const fullPath = path.join(this.cardsPath, file);
+        const fileUrl = pathToFileURL(fullPath).href;
+        if (this.debug) {
+            console.log(`[ModelCardLoader] Loading: ${file}`);
+        }
+        try {
+            // Dynamic import
+            const module = await import(fileUrl);
+            // Check for default export
+            if (module.default && this.isModelConfig(module.default)) {
+                models.push(module.default);
+                if (this.debug) {
+                    console.log(` ✓ Found default export: ${module.default.id}`);
+                }
+            }
+            // Check for named exports
+            for (const [key, value] of Object.entries(module)) {
+                if (key !== 'default' && this.isModelConfig(value)) {
+                    models.push(value);
+                    if (this.debug) {
+                        console.log(` ✓ Found named export '${key}': ${value.id}`);
+                    }
+                }
+            }
+            if (models.length === 0 && this.debug) {
+                console.log(` ⚠ No ModelConfig exports found in ${file}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to import ${file}: ${error}`);
+        }
+        return models;
+    }
+    /**
+     * Type guard to check if an object is a ModelConfig
+     */
+    isModelConfig(obj) {
+        if (!obj || typeof obj !== 'object') {
+            return false;
+        }
+        const config = obj;
+        return (typeof config.id === 'string' &&
+            typeof config.provider === 'string' &&
+            typeof config.displayName === 'string' &&
+            typeof config.family === 'string' &&
+            config.api !== undefined &&
+            config.tools !== undefined &&
+            config.parameters !== undefined &&
+            config.limits !== undefined);
+    }
+}
+//# sourceMappingURL=ModelCardLoader.js.map

package/dist/models/registry/ModelCardLoader.js.map

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

package/dist/models/registry/ModularModelRegistry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Modular Model Registry
+ * Loads all model cards from modular files
+ *
+ * Phase 3: Complete Modular Implementation
+ * - 100% model cards (no fallback)
+ * - All providers: XAI, DeepSeek, Anthropic, Gemma, Google, OpenAI, GLM, Qwen, Moonshot, MiniMax, Mercury, Cloudflare
+ * - The card files are the source of truth for the model count — run `cortex models list`
+ *
+ * Benefits:
+ * - One model = one file = clear git history
+ * - Easy to add/modify models (< 2 minutes)
+ * - Type-safe with configurator pattern
+ * - No monolithic registry maintenance
+ */
+import type { ModelConfig, ModelRegistry } from '../ModelConfig.interface.js';
+export interface ModularModelRegistryOptions {
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Filter function to selectively load models
+     */
+    filter?: (model: ModelConfig) => boolean;
+}
+/**
+ * Modular Model Registry
+ *
+ * Implements the ModelRegistry interface using imported model cards
+ */
+export declare class ModularModelRegistry implements ModelRegistry {
+    private models;
+    private options;
+    constructor(options?: ModularModelRegistryOptions);
+    /**
+     * Load model cards from modular imports
+     */
+    private loadModelCards;
+    /**
+     * Register model aliases
+     * Maps alternative model IDs to the same model configuration
+     */
+    private registerAliases;
+    /**
+     * Register a model
+     */
+    registerModel(model: ModelConfig): void;
+    /**
+     * Get model by ID
+     * @throws Error if model not found
+     */
+    getModel(modelId: string): ModelConfig;
+    /**
+     * List all registered model IDs
+     */
+    listModels(): string[];
+    /**
+     * Check if model exists
+     */
+    hasModel(modelId: string): boolean;
+    /**
+     * Get all models for a specific provider
+     */
+    getModelsByProvider(provider: string): ModelConfig[];
+    /**
+     * Get all models in a specific family
+     */
+    getModelsByFamily(family: string): ModelConfig[];
+    /**
+     * Get helper model for a provider
+     * Returns the most cost-effective model suitable for helper tasks
+     */
+    getHelperModel(provider: string): ModelConfig;
+    /**
+     * Calculate compaction threshold for a model
+     * Returns the token count at which compaction should be triggered
+     */
+    getCompactionThreshold(modelId: string): number;
+    /**
+     * Get all model configurations
+     * Helper method (not part of ModelRegistry interface) for convenience
+     */
+    getAllModels(): ModelConfig[];
+}
+//# sourceMappingURL=ModularModelRegistry.d.ts.map

package/dist/models/registry/ModularModelRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModularModelRegistry.d.ts","sourceRoot":"","sources":["../../../src/models/registry/ModularModelRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAiB9E,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC;CAC1C;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,OAAO,CAA8B;gBAEjC,OAAO,GAAE,2BAAgC;IAKrD;;OAEG;IACH,OAAO,CAAC,cAAc;IAyJtB;;;OAGG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIvC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAgBtC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAMpD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAMhD;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAuB7C;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAiB/C;;;OAGG;IACH,YAAY,IAAI,WAAW,EAAE;CAG9B"}