@agentick/shared 0.0.1

package/dist/model-catalog.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Model Catalog
+ *
+ * Reference data for known models including context windows and capabilities.
+ * This is a best-effort catalog - actual limits may change.
+ *
+ * Architecture:
+ * - MODEL_CATALOG is static reference data (defaults)
+ * - Adapters are source of truth and can override via ModelMetadata
+ * - Runtime additions via registerModel() for dynamic discovery
+ * - Lookup order: runtime > static catalog
+ *
+ * Sources (as of February 2026):
+ * - Anthropic: https://platform.claude.com/docs/en/about-claude/models/overview
+ * - OpenAI: https://platform.openai.com/docs/models
+ * - Google: https://ai.google.dev/gemini-api/docs/models
+ * - Mistral: https://mistral.ai/models
+ * - Meta: https://www.llama.com/models/llama-4/
+ */
+export interface ModelInfo {
+    /** Display name */
+    name: string;
+    /** Provider name */
+    provider: string;
+    /** Context window size in tokens */
+    contextWindow: number;
+    /** Max output tokens (if different from context window) */
+    maxOutputTokens?: number;
+    /** Model release/version date */
+    releaseDate?: string;
+    /** Whether the model supports vision/images */
+    supportsVision?: boolean;
+    /** Whether the model supports tool use */
+    supportsToolUse?: boolean;
+    /** Whether this is a reasoning model (extended thinking) */
+    isReasoningModel?: boolean;
+}
+/**
+ * Register a model at runtime.
+ * Use this for models discovered dynamically or provided by adapters.
+ *
+ * @param modelId - The model ID
+ * @param info - Model information
+ */
+export declare function registerModel(modelId: string, info: ModelInfo): void;
+/**
+ * Register multiple models at once.
+ *
+ * @param models - Map of model ID to model info
+ */
+export declare function registerModels(models: Record<string, ModelInfo>): void;
+/**
+ * Clear all runtime-registered models.
+ * Primarily for testing.
+ */
+export declare function clearRuntimeModels(): void;
+/**
+ * Get all runtime-registered models.
+ */
+export declare function getRuntimeModels(): Map<string, ModelInfo>;
+/**
+ * Known model context windows and capabilities.
+ *
+ * Keys are model IDs (case-insensitive matching recommended).
+ * Includes common aliases and versioned names.
+ *
+ * Last updated: February 2026
+ */
+export declare const MODEL_CATALOG: Record<string, ModelInfo>;
+/**
+ * Get model info by ID.
+ * Checks runtime registry first, then static catalog.
+ * Uses case-insensitive and partial matching.
+ *
+ * @param modelId - The model ID to look up
+ * @returns Model info or undefined if not found
+ */
+export declare function getModelInfo(modelId: string): ModelInfo | undefined;
+/**
+ * Get the context window size for a model.
+ *
+ * @param modelId - The model ID
+ * @returns Context window in tokens, or undefined if unknown
+ */
+export declare function getContextWindow(modelId: string): number | undefined;
+/**
+ * Calculate context utilization percentage.
+ *
+ * @param modelId - The model ID
+ * @param usedTokens - Number of tokens used
+ * @returns Utilization percentage (0-100), or undefined if model not found
+ */
+export declare function getContextUtilization(modelId: string, usedTokens: number): number | undefined;
+/**
+ * Format context window for display.
+ *
+ * @param tokens - Number of tokens
+ * @returns Formatted string like "128K" or "1M" or "10M"
+ */
+export declare function formatContextWindow(tokens: number): string;
+/**
+ * Create ModelInfo from partial data with sensible defaults.
+ * Useful for adapters that want to register models.
+ */
+export declare function createModelInfo(partial: Partial<ModelInfo> & {
+    name: string;
+    provider: string;
+}): ModelInfo;
+/**
+ * Adapter metadata shape (partial - what adapters might provide).
+ * Adapters are source of truth when they provide these values.
+ */
+export interface AdapterModelMetadata {
+    id?: string;
+    model?: string;
+    provider?: string;
+    contextWindow?: number;
+    maxOutputTokens?: number;
+    supportsVision?: boolean;
+    supportsToolUse?: boolean;
+    isReasoningModel?: boolean;
+}
+/**
+ * Get effective model info by merging adapter metadata with catalog.
+ *
+ * Priority:
+ * 1. Adapter-provided values (source of truth)
+ * 2. Runtime registry
+ * 3. Static MODEL_CATALOG
+ *
+ * @param adapterMetadata - Metadata from the adapter (if available)
+ * @param modelId - Model ID to look up in catalog (fallback)
+ * @returns Merged model info, or undefined if nothing found
+ */
+export declare function getEffectiveModelInfo(adapterMetadata?: AdapterModelMetadata, modelId?: string): ModelInfo | undefined;
+/**
+ * Get effective context window, prioritizing adapter metadata.
+ *
+ * @param adapterMetadata - Metadata from the adapter
+ * @param modelId - Model ID for catalog lookup
+ * @returns Context window size, or undefined if unknown
+ */
+export declare function getEffectiveContextWindow(adapterMetadata?: AdapterModelMetadata, modelId?: string): number | undefined;
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,SAAS;IACxB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAItE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAEzD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAspBnD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAmCnE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC/D,SAAS,CAQX;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,CAAC,EAAE,oBAAoB,EACtC,OAAO,CAAC,EAAE,MAAM,GACf,SAAS,GAAG,SAAS,CAiDvB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,CAAC,EAAE,oBAAoB,EACtC,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAQpB"}