@animus-labs/cortex 0.2.2 → 0.2.4

package/dist/provider-registry.js

@@ -4,7 +4,7 @@
  * This module contains:
  * 1. PROVIDER_REGISTRY: metadata for all known providers (auth methods, env vars, key prefixes)
  * 2. OAUTH_PROVIDER_IDS: the subset of providers that support OAuth
- * 3. UTILITY_MODEL_DEFAULTS: per-provider cheapest-capable model for utility operations
+ * 3. UTILITY_MODEL_OVERRIDES: per-provider utility model overrides for inference exceptions
  *
  * OAuth flows are resolved through pi-ai's OAuth provider registry at runtime.
  *
@@ -224,16 +224,8 @@ export const OAUTH_PROVIDER_IDS = [
     'github-copilot',
 ];
 // ---------------------------------------------------------------------------
-// Utility Model Defaults
+// Model Defaults
 // ---------------------------------------------------------------------------
-/**
- * Default utility model IDs per provider.
- * Used when utilityModel is 'default' or undefined.
- *
- * These are the cheapest capable models for each provider,
- * suitable for internal operations like WebFetch summarization
- * and safety classification.
- */
 /**
  * Default primary model IDs per provider.
  * Used when a user first connects a provider and no model is explicitly selected.
@@ -242,20 +234,20 @@ export const OAUTH_PROVIDER_IDS = [
 export const PRIMARY_MODEL_DEFAULTS = {
     anthropic: 'claude-sonnet-4-6',
     openai: 'gpt-5.4',
+    'openai-codex': 'gpt-5.5',
     google: 'gemini-3.1-pro-preview',
+    xai: 'grok-4',
     groq: 'openai/gpt-oss-120b',
     cerebras: 'gpt-oss-120b',
     mistral: 'mistral-large-2512',
 };
-export const UTILITY_MODEL_DEFAULTS = {
-    anthropic: 'claude-haiku-4-5-20251001', // $1.00/$5.00 per 1M tokens
-    openai: 'gpt-4.1-nano', // $0.10/$0.40 per 1M tokens
-    'openai-codex': 'gpt-5.4-mini', // Current small Codex-capable model
-    google: 'gemini-2.5-flash-lite', // $0.10/$0.40 per 1M tokens
-    groq: 'llama-3.1-8b-instant', // ~$0.05/$0.08 per 1M tokens
-    cerebras: 'llama3.1-8b', // ~$0.10/$0.10 per 1M tokens
-    mistral: 'mistral-small-2506', // $0.06/$0.18 per 1M tokens
-};
+/**
+ * Per-provider utility model overrides for inference exceptions.
+ * Leave empty unless dynamic inference picks a bad utility model for a provider.
+ */
+export const UTILITY_MODEL_OVERRIDES = {};
+/** Backwards-compatible alias. Prefer UTILITY_MODEL_OVERRIDES for new code. */
+export const UTILITY_MODEL_DEFAULTS = UTILITY_MODEL_OVERRIDES;
 /**
  * Cache configuration for all known providers.
  *

package/dist/provider-registry.js.map

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

package/dist/utility-model-inference.d.ts

@@ -0,0 +1,5 @@
+type RawModel = Record<string, unknown>;
+export declare function inferUtilityModel(models: readonly RawModel[] | null | undefined): RawModel | null;
+export declare function inferUtilityModelId(models: readonly RawModel[] | null | undefined): string | null;
+export {};
+//# sourceMappingURL=utility-model-inference.d.ts.map

package/dist/utility-model-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-model-inference.d.ts","sourceRoot":"","sources":["../src/utility-model-inference.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA+BxC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAcjG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMjG"}

package/dist/utility-model-inference.js

@@ -0,0 +1,174 @@
+const MIN_UTILITY_CONTEXT_WINDOW = 32_000;
+const SPECIAL_PURPOSE_MODEL_PATTERN = /(?:embedding|embed|rerank|moderation|whisper|tts|audio|speech|image-generation|vision|live|deep-research|safety|safeguard|guard|search|transcrib)/i;
+const UTILITY_TERMS = [
+    { pattern: /(?:^|[\s._/-])flash[\s._/-]?lite(?:$|[\s._/-])/, score: 110 },
+    { pattern: /(?:^|[\s._/-])nano(?:$|[\s._/-])/, score: 100 },
+    { pattern: /(?:^|[\s._/-])mini(?:$|[\s._/-])/, score: 95 },
+    { pattern: /(?:^|[\s._/-])haiku(?:$|[\s._/-])/, score: 95 },
+    { pattern: /(?:^|[\s._/-])small(?:$|[\s._/-])/, score: 85 },
+    { pattern: /(?:^|[\s._/-])fast(?:$|[\s._/-])/, score: 80 },
+    { pattern: /(?:^|[\s._/-])spark(?:$|[\s._/-])/, score: 80 },
+    { pattern: /(?:^|[\s._/-])instant(?:$|[\s._/-])/, score: 75 },
+    { pattern: /(?:^|[\s._/-])lite(?:$|[\s._/-])/, score: 70 },
+    { pattern: /(?:^|[\s._/-])flash(?:$|[\s._/-])/, score: 65 },
+    { pattern: /(?:^|[\s._/-])(?:7|8)b(?:$|[\s._/-])/, score: 65 },
+    { pattern: /(?:^|[\s._/-])(?:12|20)b(?:$|[\s._/-])/, score: 45 },
+    { pattern: /(?:^|[\s._/-])32b(?:$|[\s._/-])/, score: 25 },
+];
+export function inferUtilityModel(models) {
+    if (!Array.isArray(models))
+        return null;
+    const capable = models
+        .map(toUtilityCandidate)
+        .filter((candidate) => candidate !== null);
+    const utilityCandidates = capable.filter(candidate => candidate.utilityScore > 0);
+    if (utilityCandidates.length > 0) {
+        return [...utilityCandidates].sort(compareUtilityCandidates)[0].model;
+    }
+    if (capable.length === 0)
+        return null;
+    return [...capable].sort(compareFallbackCandidates)[0].model;
+}
+export function inferUtilityModelId(models) {
+    const model = inferUtilityModel(models);
+    const id = model?.['id'];
+    if (typeof id === 'string')
+        return id;
+    const name = model?.['name'];
+    return typeof name === 'string' ? name : null;
+}
+function toUtilityCandidate(model) {
+    const id = getString(model['id']) ?? getString(model['name']);
+    if (!id)
+        return null;
+    const name = getString(model['name']) ?? id;
+    const searchable = `${id} ${name}`.toLowerCase();
+    if (SPECIAL_PURPOSE_MODEL_PATTERN.test(searchable))
+        return null;
+    if (!supportsText(model))
+        return null;
+    const contextWindow = getNumber(model['contextWindow']) ?? 0;
+    if (contextWindow > 0 && contextWindow < MIN_UTILITY_CONTEXT_WINDOW)
+        return null;
+    return {
+        model,
+        id,
+        name,
+        utilityScore: inferUtilityScore(searchable),
+        recencyScore: inferRecencyScore(searchable),
+        costScore: inferCostScore(model),
+    };
+}
+function compareUtilityCandidates(a, b) {
+    if (b.recencyScore !== a.recencyScore)
+        return b.recencyScore - a.recencyScore;
+    if (a.costScore !== b.costScore)
+        return a.costScore - b.costScore;
+    if (b.utilityScore !== a.utilityScore)
+        return b.utilityScore - a.utilityScore;
+    return a.id.localeCompare(b.id);
+}
+function compareFallbackCandidates(a, b) {
+    if (a.costScore !== b.costScore)
+        return a.costScore - b.costScore;
+    if (b.recencyScore !== a.recencyScore)
+        return b.recencyScore - a.recencyScore;
+    return a.id.localeCompare(b.id);
+}
+function supportsText(model) {
+    const input = model['input'];
+    if (!Array.isArray(input))
+        return true;
+    return input.includes('text');
+}
+function inferUtilityScore(searchable) {
+    let score = 0;
+    for (const term of UTILITY_TERMS) {
+        if (term.pattern.test(searchable)) {
+            score = Math.max(score, term.score);
+        }
+    }
+    return score;
+}
+function inferRecencyScore(searchable) {
+    const dateScore = inferDateScore(searchable);
+    const versionScore = inferVersionScore(searchable);
+    return Math.max(dateScore, versionScore);
+}
+function inferDateScore(searchable) {
+    let score = 0;
+    for (const match of searchable.matchAll(/20\d{6}/g)) {
+        const value = Number(match[0]);
+        if (isValidDateScore(value)) {
+            score = Math.max(score, value);
+        }
+    }
+    for (const match of searchable.matchAll(/(20\d{2})[-_/](0[1-9]|1[0-2])/g)) {
+        score = Math.max(score, Number(match[1]) * 10_000 + Number(match[2]) * 100);
+    }
+    for (const match of searchable.matchAll(/(0[1-9]|1[0-2])[-_/](20\d{2})/g)) {
+        score = Math.max(score, Number(match[2]) * 10_000 + Number(match[1]) * 100);
+    }
+    for (const match of searchable.matchAll(/(?:^|[^\d])(\d{4})(?:$|[^\da-z])/g)) {
+        const raw = match[1];
+        const year = Number(raw.slice(0, 2));
+        const month = Number(raw.slice(2, 4));
+        if (year >= 20 && year <= 40 && month >= 1 && month <= 12) {
+            score = Math.max(score, 20_000_000 + year * 10_000 + month * 100);
+        }
+    }
+    return score;
+}
+function inferVersionScore(searchable) {
+    const scrubbed = searchable
+        .replace(/20\d{6}/g, ' ')
+        .replace(/(20\d{2})[-_/](0[1-9]|1[0-2])/g, ' ')
+        .replace(/(0[1-9]|1[0-2])[-_/](20\d{2})/g, ' ')
+        .replace(/(?:^|[^\d])(\d{4})(?:$|[^\da-z])/g, ' ')
+        .replace(/\b\d+(?:\.\d+)?b\b/g, ' ');
+    let score = 0;
+    for (const match of scrubbed.matchAll(/\d+(?:\.\d+)+/g)) {
+        score = Math.max(score, scoreVersionParts(match[0].split('.').map(Number)));
+    }
+    const tokens = scrubbed.split(/[^a-z0-9]+/).filter(Boolean);
+    for (let i = 0; i < tokens.length; i++) {
+        if (!/^\d+$/.test(tokens[i]))
+            continue;
+        const parts = [];
+        for (let j = i; j < tokens.length && /^\d+$/.test(tokens[j]) && parts.length < 4; j++) {
+            parts.push(Number(tokens[j]));
+        }
+        if (parts.length >= 2) {
+            score = Math.max(score, scoreVersionParts(parts));
+        }
+    }
+    return score;
+}
+function scoreVersionParts(parts) {
+    const weights = [1_000_000, 10_000, 100, 1];
+    return parts.slice(0, weights.length).reduce((score, part, index) => (Number.isFinite(part) ? score + part * weights[index] : score), 0);
+}
+function inferCostScore(model) {
+    const cost = model['cost'] ?? model['pricing'];
+    if (!cost || typeof cost !== 'object')
+        return Number.MAX_SAFE_INTEGER;
+    const rawCost = cost;
+    const input = getNumber(rawCost['input']) ?? 0;
+    const output = getNumber(rawCost['output']) ?? 0;
+    if (input === 0 && output === 0)
+        return Number.MAX_SAFE_INTEGER - 1;
+    return input + output * 3;
+}
+function isValidDateScore(value) {
+    const year = Math.floor(value / 10_000);
+    const month = Math.floor((value % 10_000) / 100);
+    const day = value % 100;
+    return year >= 2020 && year <= 2040 && month >= 1 && month <= 12 && day >= 1 && day <= 31;
+}
+function getString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+function getNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+//# sourceMappingURL=utility-model-inference.js.map

package/dist/utility-model-inference.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-labs/cortex",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Production-grade agent framework with structured context management, compaction, tools, and MCP support",
   "license": "MIT",
   "author": "Animus Labs",

package/src/cortex-agent.ts

@@ -26,7 +26,9 @@ import type { PiEventSource } from './event-bridge.js';
 import { BudgetGuard } from './budget-guard.js';
 import { classifyError } from './error-classifier.js';
 import { parseWorkingTags } from './working-tags.js';
-import { UTILITY_MODEL_DEFAULTS } from './provider-registry.js';
+import { getModel as getPiModel, getModels as getPiModels } from '@earendil-works/pi-ai';
+import { UTILITY_MODEL_OVERRIDES } from './provider-registry.js';
+import { inferUtilityModel } from './utility-model-inference.js';
 import { McpClientManager } from './mcp-client.js';
 import { CompactionManager, buildCompactionConfig } from './compaction/index.js';
 import { isContextOverflow } from './compaction/failsafe.js';
@@ -2863,6 +2865,25 @@ export class CortexAgent {
    * If 'default' or undefined, look up the provider default and preserve
    * the raw provider-specific fields from the primary pi-ai model.
    */
+  private inferDefaultUtilityModel(provider: string): PiModel | null {
+    const overrideModelId = UTILITY_MODEL_OVERRIDES[provider];
+    if (overrideModelId) {
+      try {
+        const overrideModel = (getPiModel as unknown as (provider: string, modelId: string) => unknown)(provider, overrideModelId);
+        if (overrideModel) return overrideModel as PiModel;
+      } catch {
+        return null;
+      }
+    }
+
+    try {
+      const models = (getPiModels as unknown as (provider: string) => PiModel[])(provider);
+      return inferUtilityModel(models as unknown as Array<Record<string, unknown>>) as PiModel | null;
+    } catch {
+      return null;
+    }
+  }
+
   private resolveUtilityModels(
     primaryModel: CortexModel,
     primaryPiModel: PiModel,
@@ -2874,26 +2895,24 @@ export class CortexAgent {
     const primaryProvider = primaryModel.provider;
 
     if (!utilityModelConfig || utilityModelConfig === 'default') {
-      const defaultModelId = UTILITY_MODEL_DEFAULTS[primaryProvider];
-      if (!defaultModelId) {
+      const utilityPiModel = this.inferDefaultUtilityModel(primaryProvider);
+      if (!utilityPiModel) {
         return {
           utilityModel: primaryModel,
           utilityPiModel: primaryPiModel,
         };
       }
 
-      const utilityPiModel = {
-        ...primaryPiModel,
-        name: defaultModelId,
-        id: defaultModelId,
-      };
+      const rawUtilityId = utilityPiModel['id'];
+      const rawUtilityName = utilityPiModel['name'];
+      const utilityModelId = typeof rawUtilityId === 'string' ? rawUtilityId : String(rawUtilityId ?? rawUtilityName);
 
       return {
         utilityPiModel,
         utilityModel: wrapModel(
           utilityPiModel,
           primaryProvider,
-          defaultModelId,
+          utilityModelId,
           utilityPiModel.contextWindow ?? primaryModel.contextWindow,
         ),
       };

package/src/index.ts

@@ -260,11 +260,13 @@ export type {
 // Model Wrapper (Phase 1D)
 export { wrapModel, unwrapModel, isCortexModel } from './model-wrapper.js';
 export type { CortexModel } from './model-wrapper.js';
+export { inferUtilityModel, inferUtilityModelId } from './utility-model-inference.js';
 
 // Provider Registry (Phase 1D)
 export {
   PROVIDER_REGISTRY,
   OAUTH_PROVIDER_IDS,
+  UTILITY_MODEL_OVERRIDES,
   UTILITY_MODEL_DEFAULTS,
   PRIMARY_MODEL_DEFAULTS,
   PROVIDER_CACHE_CONFIG,
@@ -279,8 +281,9 @@ export type {
 } from './provider-registry.js';
 
 // Provider Manager (Phase 1D)
-export { ProviderManager } from './provider-manager.js';
+export { ProviderManager, OAuthError } from './provider-manager.js';
 export type {
+  OAuthErrorCode,
   IProviderManager,
   OAuthCallbacks,
   OAuthCallbackPageContext,