@cuylabs/agent-core 4.8.1 → 4.10.0

package/dist/models/cache/adapters.d.ts

@@ -0,0 +1,4 @@
+import type { StorageAdapter } from "./types.js";
+import type { Logger } from "../../logger/types.js";
+export declare function createCapabilityCacheAdapter(cachePath: string, logger?: Logger): StorageAdapter;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/models/cache/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/models/cache/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAyHpD,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,CAUhB"}

package/dist/models/cache/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Capability cache storage adapters and source integration.
+ */
+export { CapabilityCache, CacheCapabilitySource } from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/models/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/models/cache/manager.d.ts

@@ -0,0 +1,32 @@
+import type { CapabilitySource, ModelEntry, ResolverOptions, SourceResult } from "../types.js";
+import { SourcePriority } from "../types.js";
+import type { Logger } from "../../logger/types.js";
+export declare class CapabilityCache {
+    private adapter;
+    private memoryCache;
+    private ttlMs;
+    private loaded;
+    private readonly log;
+    constructor(options?: Partial<ResolverOptions>, logger?: Logger);
+    private load;
+    get(modelId: string, provider?: string): Promise<ModelEntry | undefined>;
+    set(entry: ModelEntry): Promise<void>;
+    setMany(entries: ModelEntry[]): Promise<void>;
+    persist(): Promise<void>;
+    clear(): Promise<void>;
+    stats(): {
+        size: number;
+        loaded: boolean;
+    };
+    getAll(): Promise<ModelEntry[]>;
+    getAllByProvider(): Promise<Record<string, ModelEntry[]>>;
+}
+export declare class CacheCapabilitySource implements CapabilitySource {
+    private cache;
+    readonly priority = SourcePriority.LocalCache;
+    readonly name = "Local Cache";
+    constructor(cache: CapabilityCache);
+    lookup(modelId: string, provider?: string): Promise<SourceResult>;
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/models/cache/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/models/cache/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAA4B,cAAc,EAAE,MAAM,aAAa,CAAC;AAGvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAC;IAChB,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,EAAE,MAAM,CAAC,EAAE,MAAM;YAOrD,IAAI;IAoBZ,GAAG,CACP,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAK5B,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,KAAK,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE;IAOpC,MAAM,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAK/B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;CAYhE;AAED,qBAAa,qBAAsB,YAAW,gBAAgB;IAIhD,OAAO,CAAC,KAAK;IAHzB,QAAQ,CAAC,QAAQ,6BAA6B;IAC9C,QAAQ,CAAC,IAAI,iBAAiB;gBAEV,KAAK,EAAE,eAAe;IAEpC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiBjE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/models/cache/types.d.ts

@@ -0,0 +1,17 @@
+import type { ModelEntry } from "../types.js";
+export interface CacheData {
+    version: number;
+    updatedAt: string;
+    expiresAt: string;
+    models: Record<string, ModelEntry>;
+    source?: string;
+}
+export interface StorageAdapter {
+    read(): Promise<CacheData | undefined>;
+    write(data: CacheData): Promise<void>;
+    clear(): Promise<void>;
+}
+export declare const CACHE_VERSION = 1;
+export declare function cacheKey(modelId: string, provider?: string): string;
+export declare function isExpired(data: CacheData): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/models/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/models/cache/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAElD"}

package/dist/models/capability-resolver.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Model Capability Resolver for @cuylabs/agent-core
+ *
+ * Main orchestrator that combines multiple capability sources:
+ * 1. User overrides (highest priority)
+ * 2. Local cache (fast, persisted)
+ * 3. Pattern matching (always available)
+ * 4. Remote API (optional, network-dependent)
+ *
+ * Designed for the Vercel AI SDK v6 ecosystem.
+ */
+import type { LanguageModel } from "ai";
+import type { ModelEntry, ModelCapabilities, ResolverOptions, ProviderCompatibility } from "./types.js";
+import { SourcePriority } from "./types.js";
+import { type NetworkStatus } from "./remote/index.js";
+import type { Logger } from "../logger/types.js";
+/**
+ * Resolution result with source information
+ */
+export interface ResolutionResult {
+    /** The resolved model entry */
+    entry: ModelEntry;
+    /** Which source provided the primary result */
+    source: SourcePriority;
+    /** Whether this is a confident match */
+    confident: boolean;
+    /** Resolution timing in ms */
+    resolveTimeMs: number;
+}
+/**
+ * Model Capability Resolver
+ *
+ * Provides a unified API for querying model capabilities with
+ * automatic fallback through multiple sources.
+ */
+export declare class ModelCapabilityResolver {
+    private options;
+    private cache;
+    private sources;
+    private initialized;
+    private initPromise;
+    private readonly log;
+    constructor(options?: Partial<ResolverOptions>, logger?: Logger);
+    /**
+     * Initialize the resolver (load cache, optionally fetch remote)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Resolve capabilities for a model
+     */
+    resolve(model: LanguageModel): Promise<ResolutionResult>;
+    /**
+     * Quick check if a model supports reasoning
+     * Uses cache/patterns only for speed
+     */
+    supportsReasoning(model: LanguageModel): Promise<boolean>;
+    /**
+     * Get capabilities for a model
+     */
+    getCapabilities(model: LanguageModel): Promise<ModelCapabilities>;
+    /**
+     * Get provider compatibility settings
+     */
+    getCompatibility(model: LanguageModel): Promise<ProviderCompatibility | undefined>;
+    /**
+     * Force refresh from remote API
+     */
+    refreshRemote(): Promise<void>;
+    /**
+     * Get current network status
+     */
+    getNetworkStatus(): NetworkStatus;
+    /**
+     * Get resolver statistics
+     */
+    getStats(): {
+        cacheSize: number;
+        cacheLoaded: boolean;
+        remoteFetchEnabled: boolean;
+        networkOnline: boolean;
+    };
+    /**
+     * Clear all cached data
+     */
+    clearCache(): Promise<void>;
+    /**
+     * List all available models
+     * Fetches from remote if cache is empty and remote is enabled
+     */
+    listModels(): Promise<ModelEntry[]>;
+    /**
+     * List all available models grouped by provider
+     */
+    listModelsByProvider(): Promise<Record<string, ModelEntry[]>>;
+}
+/**
+ * Get the default resolver instance
+ */
+export declare function getDefaultResolver(): ModelCapabilityResolver;
+/**
+ * Configure the default resolver with custom options
+ */
+export declare function configureResolver(options: Partial<ResolverOptions>): void;
+//# sourceMappingURL=capability-resolver.d.ts.map

package/dist/models/capability-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-resolver.d.ts","sourceRoot":"","sources":["../../src/models/capability-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAGjB,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAA4B,MAAM,YAAY,CAAC;AAMtE,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAOjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,+CAA+C;IAC/C,MAAM,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAoBnE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BjC;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0D9D;;;OAGG;IACG,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAc/D;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKvE;;OAEG;IACG,gBAAgB,CACpB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAK7C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAcpC;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,aAAa,EAAE,OAAO,CAAC;KACxB;IAYD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAoBzC;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;CAkBpE;AAQD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,uBAAuB,CAQ5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAEzE"}

package/dist/models/identifiers.d.ts

@@ -0,0 +1,23 @@
+import type { LanguageModel } from "ai";
+/**
+ * Extract a model ID string from a LanguageModel instance.
+ */
+export declare function getModelId(model: LanguageModel): string;
+/**
+ * Extract a provider identifier from a LanguageModel instance.
+ */
+export declare function getProviderId(model: LanguageModel): string | undefined;
+/**
+ * Extract model ID from a LanguageModel.
+ *
+ * Canonical helper — use this instead of `getModelId` in consumer code.
+ */
+export declare const extractModelId: (model: LanguageModel) => string;
+/**
+ * Extract provider from a LanguageModel.
+ *
+ * Tries the model's `.provider` property first, then falls back
+ * to pattern-matching the model ID via `inferProvider`.
+ */
+export declare function extractProvider(model: LanguageModel): string | undefined;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/models/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../src/models/identifiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxC;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAMvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAYtE;AAID;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAmB,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAGxE"}

package/dist/models/index.d.ts

@@ -1,261 +1,40 @@
-import { LanguageModel } from 'ai';
-import { C as CapabilitySource, S as SourcePriority, b as SourceResult, P as ProviderCompatibility, R as ResolverOptions, a as ModelEntry, M as ModelCapabilities } from '../index-BCqEGzBj.js';
-export { D as DEFAULT_RESOLVER_OPTIONS, I as InputModality, O as OutputModality, c as buildAnthropicOptions, d as buildBedrockOptions, e as buildGoogleOptions, f as buildGroqOptions, g as buildOpenAIOptions, h as buildOpenRouterOptions, i as buildReasoningOptions, j as buildReasoningOptionsSync, k as buildXAIOptions, l as getProviderOptionsKey, m as getReasoningConfig, n as getReasoningConfigSync, s as supportsReasoning, o as supportsReasoningSync } from '../index-BCqEGzBj.js';
-import { L as Logger } from '../types-RSCv7nQ4.js';
-export { E as EXTENDED_LEVELS, F as FIXED_LEVELS, a as ReasoningConfig, R as ReasoningLevel, S as STANDARD_LEVELS, s as shouldIncludeReasoningSummary } from '../types-CQaXbRsS.js';
-import '@ai-sdk/provider-utils';
-
 /**
- * Extract a model ID string from a LanguageModel instance.
- */
-declare function getModelId(model: LanguageModel): string;
-/**
- * Extract a provider identifier from a LanguageModel instance.
- */
-declare function getProviderId(model: LanguageModel): string | undefined;
-/**
- * Extract model ID from a LanguageModel.
- *
- * Canonical helper — use this instead of `getModelId` in consumer code.
- */
-declare const extractModelId: (model: LanguageModel) => string;
-/**
- * Extract provider from a LanguageModel.
- *
- * Tries the model's `.provider` property first, then falls back
- * to pattern-matching the model ID via `inferProvider`.
- */
-declare function extractProvider(model: LanguageModel): string | undefined;
-
-type AdapterKind = "openai" | "anthropic" | "google" | "openai-compatible" | "openrouter" | "azure" | "bedrock" | "vertex" | "xai" | "mistral" | "groq";
-type AdapterSettings = {
-    apiKey?: string;
-    baseUrl?: string;
-    headers?: Record<string, string>;
-    extra?: Record<string, unknown>;
-};
-type EngineSpec = {
-    adapter: AdapterKind | string;
-    settings?: AdapterSettings;
-    build?: (modelId: string, settings: AdapterSettings) => LanguageModel;
-};
-type ModelSpec = {
-    engine: string;
-    id: string;
-    settings?: AdapterSettings;
-};
-type Directory = {
-    engines: Record<string, EngineSpec>;
-    entries?: Record<string, ModelSpec>;
-};
-type Resolver = (key: string) => Promise<LanguageModel>;
-declare function createResolver(directory: Directory): Resolver;
-
-/**
- * Profile-Based Capability Detection for @cuylabs/agent-core
- *
- * Static pattern matching for model capabilities when no external data is available.
- * This is the fallback layer — always works offline.
- */
-
-/**
- * Infer context window size (in tokens) from a model ID.
+ * Models Module for @cuylabs/agent-core
  *
- * Uses local pattern matching — no network calls, always fast.
- * Returns `undefined` if the model isn't recognized.
- */
-declare function inferContextWindow(modelId: string): number | undefined;
-/**
- * Infer provider from model ID
- */
-declare function inferProvider(modelId: string): string | undefined;
-/**
- * Pattern-based capability source
- * Always available, uses heuristics to detect capabilities
- */
-declare class PatternCapabilitySource implements CapabilitySource {
-    readonly priority = SourcePriority.PatternMatch;
-    readonly name = "Pattern Matching";
-    lookup(modelId: string, providerHint?: string): Promise<SourceResult>;
-    isAvailable(): Promise<boolean>;
-}
-/**
- * Quick check if a model ID likely supports reasoning
- */
-declare function likelySupportsReasoning(modelId: string): boolean;
-/**
- * Get provider compatibility for a model
- */
-declare function getProviderCompatibility(modelId: string, provider?: string): ProviderCompatibility | undefined;
-
-type CapabilityOverrides = ResolverOptions["modelOverrides"];
-type OverrideLookup = {
-    override?: Partial<ModelCapabilities>;
-    matchedKey?: string;
-};
-declare function findCapabilityOverride(overrides: CapabilityOverrides, modelId: string, provider?: string): OverrideLookup;
-declare function applyCapabilityOverride(entry: ModelEntry, override?: Partial<ModelCapabilities>): ModelEntry;
-
-declare class CapabilityCache {
-    private adapter;
-    private memoryCache;
-    private ttlMs;
-    private loaded;
-    private readonly log;
-    constructor(options?: Partial<ResolverOptions>, logger?: Logger);
-    private load;
-    get(modelId: string, provider?: string): Promise<ModelEntry | undefined>;
-    set(entry: ModelEntry): Promise<void>;
-    setMany(entries: ModelEntry[]): Promise<void>;
-    persist(): Promise<void>;
-    clear(): Promise<void>;
-    stats(): {
-        size: number;
-        loaded: boolean;
-    };
-    getAll(): Promise<ModelEntry[]>;
-    getAllByProvider(): Promise<Record<string, ModelEntry[]>>;
-}
-declare class CacheCapabilitySource implements CapabilitySource {
-    private cache;
-    readonly priority = SourcePriority.LocalCache;
-    readonly name = "Local Cache";
-    constructor(cache: CapabilityCache);
-    lookup(modelId: string, provider?: string): Promise<SourceResult>;
-    isAvailable(): Promise<boolean>;
-}
-
-interface NetworkStatus {
-    online: boolean;
-    lastSuccess?: number;
-    lastError?: string;
-    failureCount: number;
-}
-
-declare function getNetworkStatus(): NetworkStatus;
-
-declare class RemoteCapabilityFetcher {
-    private apiUrl;
-    private timeoutMs;
-    private cache;
-    private lastFetchTime;
-    private minFetchInterval;
-    constructor(cache: CapabilityCache, options?: Partial<ResolverOptions>);
-    fetchAll(): Promise<ModelEntry[]>;
-    ping(): Promise<boolean>;
-}
-
-declare class RemoteCapabilitySource implements CapabilitySource {
-    readonly priority = SourcePriority.RemoteAPI;
-    readonly name = "Remote API (models.dev)";
-    private fetcher;
-    private cache;
-    private fetchPromise;
-    private enabled;
-    constructor(cache: CapabilityCache, options?: Partial<ResolverOptions>);
-    lookup(modelId: string, provider?: string): Promise<SourceResult>;
-    isAvailable(): Promise<boolean>;
-    refresh(): Promise<void>;
-}
-
-/**
- * Model Capability Resolver for @cuylabs/agent-core
+ * Everything about models lives here:
+ * - **identifiers** — extract model/provider IDs from LanguageModel instances
+ * - **resolver** — resolve string references into live Vercel AI SDK model objects
+ * - **profiles** — static pattern matching for model capability detection
+ * - **capability-resolver** — orchestrated capability resolution with cache/remote
+ * - **overrides** — user-provided per-model capability overrides
+ * - **cache/** — capability cache storage adapters
+ * - **remote/** — models.dev API fetching
  *
- * Main orchestrator that combines multiple capability sources:
- * 1. User overrides (highest priority)
- * 2. Local cache (fast, persisted)
- * 3. Pattern matching (always available)
- * 4. Remote API (optional, network-dependent)
+ * @example
+ * ```typescript
+ * import { createResolver, type Directory } from "./models";
  *
- * Designed for the Vercel AI SDK v6 ecosystem.
- */
-
-/**
- * Resolution result with source information
- */
-interface ResolutionResult {
-    /** The resolved model entry */
-    entry: ModelEntry;
-    /** Which source provided the primary result */
-    source: SourcePriority;
-    /** Whether this is a confident match */
-    confident: boolean;
-    /** Resolution timing in ms */
-    resolveTimeMs: number;
-}
-/**
- * Model Capability Resolver
+ * const directory: Directory = {
+ *   engines: {
+ *     ollama: {
+ *       adapter: "openai-compatible",
+ *       settings: { baseUrl: "http://localhost:11434/v1", extra: { name: "ollama" } },
+ *     },
+ *   },
+ * };
  *
- * Provides a unified API for querying model capabilities with
- * automatic fallback through multiple sources.
- */
-declare class ModelCapabilityResolver {
-    private options;
-    private cache;
-    private sources;
-    private initialized;
-    private initPromise;
-    private readonly log;
-    constructor(options?: Partial<ResolverOptions>, logger?: Logger);
-    /**
-     * Initialize the resolver (load cache, optionally fetch remote)
-     */
-    initialize(): Promise<void>;
-    /**
-     * Resolve capabilities for a model
-     */
-    resolve(model: LanguageModel): Promise<ResolutionResult>;
-    /**
-     * Quick check if a model supports reasoning
-     * Uses cache/patterns only for speed
-     */
-    supportsReasoning(model: LanguageModel): Promise<boolean>;
-    /**
-     * Get capabilities for a model
-     */
-    getCapabilities(model: LanguageModel): Promise<ModelCapabilities>;
-    /**
-     * Get provider compatibility settings
-     */
-    getCompatibility(model: LanguageModel): Promise<ProviderCompatibility | undefined>;
-    /**
-     * Force refresh from remote API
-     */
-    refreshRemote(): Promise<void>;
-    /**
-     * Get current network status
-     */
-    getNetworkStatus(): NetworkStatus;
-    /**
-     * Get resolver statistics
-     */
-    getStats(): {
-        cacheSize: number;
-        cacheLoaded: boolean;
-        remoteFetchEnabled: boolean;
-        networkOnline: boolean;
-    };
-    /**
-     * Clear all cached data
-     */
-    clearCache(): Promise<void>;
-    /**
-     * List all available models
-     * Fetches from remote if cache is empty and remote is enabled
-     */
-    listModels(): Promise<ModelEntry[]>;
-    /**
-     * List all available models grouped by provider
-     */
-    listModelsByProvider(): Promise<Record<string, ModelEntry[]>>;
-}
-/**
- * Get the default resolver instance
- */
-declare function getDefaultResolver(): ModelCapabilityResolver;
-/**
- * Configure the default resolver with custom options
- */
-declare function configureResolver(options: Partial<ResolverOptions>): void;
-
-export { type AdapterSettings, CacheCapabilitySource, CapabilityCache, type CapabilityOverrides, CapabilitySource, type Directory, type EngineSpec, ModelCapabilities, ModelCapabilityResolver, ModelEntry, type ModelSpec, type NetworkStatus, PatternCapabilitySource, ProviderCompatibility, RemoteCapabilityFetcher, RemoteCapabilitySource, type ResolutionResult, type Resolver, ResolverOptions, SourcePriority, SourceResult, applyCapabilityOverride, configureResolver, createResolver, extractModelId, extractProvider, findCapabilityOverride, getDefaultResolver, getModelId, getNetworkStatus, getProviderCompatibility, getProviderId, inferContextWindow, inferProvider, likelySupportsReasoning };
+ * const resolve = createResolver(directory);
+ * const model = await resolve("ollama/llama3");
+ * ```
+ */
+export { extractModelId, extractProvider, getModelId, getProviderId, } from "./identifiers.js";
+export { createResolver, type AdapterSettings, type EngineSpec, type ModelSpec, type Directory, type Resolver, } from "./resolver.js";
+export type { ModelCapabilities, ModelEntry, ProviderCompatibility, InputModality, OutputModality, SourceResult, CapabilitySource, ResolverOptions, } from "./types.js";
+export { SourcePriority, DEFAULT_RESOLVER_OPTIONS } from "./types.js";
+export { PatternCapabilitySource, likelySupportsReasoning, getProviderCompatibility, inferProvider, inferContextWindow, } from "./profiles.js";
+export { applyCapabilityOverride, findCapabilityOverride, type CapabilityOverrides, } from "./overrides.js";
+export { CapabilityCache, CacheCapabilitySource } from "./cache/index.js";
+export { RemoteCapabilitySource, RemoteCapabilityFetcher, getNetworkStatus, type NetworkStatus, } from "./remote/index.js";
+export { ModelCapabilityResolver, getDefaultResolver, configureResolver, type ResolutionResult, } from "./capability-resolver.js";
+export * from "./reasoning/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EACL,cAAc,EACd,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,aAAa,EACb,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG1E,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,cAAc,sBAAsB,CAAC"}

package/dist/models/index.js

@@ -28,7 +28,7 @@ import {
   shouldIncludeReasoningSummary,
   supportsReasoning,
   supportsReasoningSync
-} from "../chunk-GJFP5L2V.js";
+} from "../chunk-CNM6OROH.js";
 import {
   DEFAULT_RESOLVER_OPTIONS,
   PatternCapabilitySource,

package/dist/models/overrides.d.ts

@@ -0,0 +1,10 @@
+import type { ModelCapabilities, ModelEntry, ResolverOptions } from "./types.js";
+export type CapabilityOverrides = ResolverOptions["modelOverrides"];
+type OverrideLookup = {
+    override?: Partial<ModelCapabilities>;
+    matchedKey?: string;
+};
+export declare function findCapabilityOverride(overrides: CapabilityOverrides, modelId: string, provider?: string): OverrideLookup;
+export declare function applyCapabilityOverride(entry: ModelEntry, override?: Partial<ModelCapabilities>): ModelEntry;
+export {};
+//# sourceMappingURL=overrides.d.ts.map

package/dist/models/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/models/overrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAEpE,KAAK,cAAc,GAAG;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAOF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,mBAAmB,EAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAqBhB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACpC,UAAU,CAUZ"}

package/dist/models/profiles.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Profile-Based Capability Detection for @cuylabs/agent-core
+ *
+ * Static pattern matching for model capabilities when no external data is available.
+ * This is the fallback layer — always works offline.
+ */
+import type { ProviderCompatibility, SourceResult, CapabilitySource } from "./types.js";
+import { SourcePriority } from "./types.js";
+/**
+ * Infer context window size (in tokens) from a model ID.
+ *
+ * Uses local pattern matching — no network calls, always fast.
+ * Returns `undefined` if the model isn't recognized.
+ */
+export declare function inferContextWindow(modelId: string): number | undefined;
+/**
+ * Infer provider from model ID
+ */
+export declare function inferProvider(modelId: string): string | undefined;
+/**
+ * Pattern-based capability source
+ * Always available, uses heuristics to detect capabilities
+ */
+export declare class PatternCapabilitySource implements CapabilitySource {
+    readonly priority = SourcePriority.PatternMatch;
+    readonly name = "Pattern Matching";
+    lookup(modelId: string, providerHint?: string): Promise<SourceResult>;
+    isAvailable(): Promise<boolean>;
+}
+/**
+ * Quick check if a model ID likely supports reasoning
+ */
+export declare function likelySupportsReasoning(modelId: string): boolean;
+/**
+ * Get provider compatibility for a model
+ */
+export declare function getProviderCompatibility(modelId: string, provider?: string): ProviderCompatibility | undefined;
+//# sourceMappingURL=profiles.d.ts.map

package/dist/models/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/models/profiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAGV,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoL5C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQtE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAejE;AAiDD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,QAAQ,CAAC,QAAQ,+BAA+B;IAChD,QAAQ,CAAC,IAAI,sBAAsB;IAE7B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA0CrE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,qBAAqB,GAAG,SAAS,CAGnC"}

package/dist/models/reasoning/config.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Reasoning Configuration & Option Builders
+ *
+ * Orchestrates capability detection and provider-specific option
+ * building to produce ready-to-use `providerOptions` for the
+ * Vercel AI SDK.
+ *
+ * Two flavours of every function are provided:
+ * - **Async** (`getReasoningConfig`, `buildReasoningOptions`) —
+ *   uses the full capability resolver (network + cache).
+ * - **Sync** (`getReasoningConfigSync`, `buildReasoningOptionsSync`) —
+ *   uses fast pattern-matching only (no network).
+ */
+import type { LanguageModel } from "ai";
+import type { ProviderOptions } from "@ai-sdk/provider-utils";
+import { type ReasoningLevel, type ReasoningConfig } from "./types.js";
+/**
+ * Get the reasoning configuration for a model.
+ *
+ * Uses the full capability resolver (including network lookups)
+ * for the most accurate result.
+ */
+export declare function getReasoningConfig(model: LanguageModel): Promise<ReasoningConfig>;
+/**
+ * Synchronous reasoning config using pattern-matching only.
+ *
+ * Faster but less accurate than {@link getReasoningConfig}.
+ * Good for hot paths where async is impractical.
+ */
+export declare function getReasoningConfigSync(model: LanguageModel): ReasoningConfig;
+/**
+ * Build `providerOptions` for a reasoning level (async).
+ *
+ * Returns `undefined` when reasoning is off or unsupported.
+ */
+export declare function buildReasoningOptions(model: LanguageModel, level: ReasoningLevel): Promise<ProviderOptions | undefined>;
+/**
+ * Build `providerOptions` for a reasoning level (sync / pattern-only).
+ */
+export declare function buildReasoningOptionsSync(model: LanguageModel, level: ReasoningLevel): ProviderOptions | undefined;
+/**
+ * Check whether a model supports reasoning (async, full resolver).
+ */
+export declare function supportsReasoning(model: LanguageModel): Promise<boolean>;
+/**
+ * Synchronous check using pattern-matching only.
+ */
+export declare function supportsReasoningSync(model: LanguageModel): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/models/reasoning/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/models/reasoning/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAS9D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EAKrB,MAAM,YAAY,CAAC;AAiBpB;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,eAAe,CAAC,CAgH1B;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CA+D5E;AAMD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAkBtC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,cAAc,GACpB,eAAe,GAAG,SAAS,CAiB7B;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAEnE"}