@dexto/core 1.6.0 → 1.6.2

package/dist/llm/executor/turn-executor.js

@@ -11,7 +11,7 @@ import {
 } from "ai";
 import { trace } from "@opentelemetry/api";
 import { StreamProcessor } from "./stream-processor.js";
-import { buildProviderOptions } from "./provider-options.js";
+import { buildProviderOptions, getEffectiveReasoningBudgetTokens } from "./provider-options.js";
 import { DextoLogComponent } from "../../logger/v2/types.js";
 import { defer } from "../../utils/defer.js";
 import { DextoRuntimeError } from "../../errors/DextoRuntimeError.js";
@@ -46,18 +46,24 @@ class TurnExecutor {
   compactionStrategy = null;
   /**
    * Map to track tool-call metadata by toolCallId.
-   * Used to pass execution-time info (approval + display name) to result persistence.
+   * Used to pass execution-time info (approval + presentation snapshot) to result persistence.
    */
   toolCallMetadata = /* @__PURE__ */ new Map();
   /**
    * Get StreamProcessor config from TurnExecutor state.
    * @param estimatedInputTokens Optional estimated input tokens for analytics
    */
-  getStreamProcessorConfig(estimatedInputTokens) {
+  getStreamProcessorConfig(estimatedInputTokens, reasoning) {
     return {
       provider: this.llmContext.provider,
       model: this.llmContext.model,
-      ...estimatedInputTokens !== void 0 && { estimatedInputTokens }
+      ...estimatedInputTokens !== void 0 && { estimatedInputTokens },
+      ...reasoning?.reasoningVariant !== void 0 && {
+        reasoningVariant: reasoning.reasoningVariant
+      },
+      ...reasoning?.reasoningBudgetTokens !== void 0 && {
+        reasoningBudgetTokens: reasoning.reasoningBudgetTokens
+      }
     };
   }
   /**
@@ -153,43 +159,59 @@ class TurnExecutor {
           }
           this.logger.debug(`Step ${stepCount}: Starting`);
           const tools = supportsTools ? await this.createTools() : {};
+          const providerOptions = buildProviderOptions({
+            provider: this.llmContext.provider,
+            model: this.llmContext.model,
+            reasoning: this.config.reasoning
+          });
+          this.logger.debug("LLM request options", {
+            provider: this.llmContext.provider,
+            model: this.llmContext.model,
+            requestedReasoning: {
+              variant: this.config.reasoning?.variant,
+              budgetTokens: this.config.reasoning?.budgetTokens
+            },
+            providerOptions
+          });
+          const reasoningVariant = this.config.reasoning?.variant;
+          const reasoningBudgetTokens = getEffectiveReasoningBudgetTokens(providerOptions);
+          const reasoningForStream = reasoningVariant !== void 0 || reasoningBudgetTokens !== void 0 ? {
+            ...reasoningVariant !== void 0 && { reasoningVariant },
+            ...reasoningBudgetTokens !== void 0 && { reasoningBudgetTokens }
+          } : void 0;
           const streamProcessor = new StreamProcessor(
             this.contextManager,
             this.eventBus,
             this.resourceManager,
             this.stepAbortController.signal,
-            this.getStreamProcessorConfig(estimatedTokens),
+            this.getStreamProcessorConfig(estimatedTokens, reasoningForStream),
             this.logger,
             streaming,
             this.toolCallMetadata
           );
-          const providerOptions = buildProviderOptions({
-            provider: this.llmContext.provider,
-            model: this.llmContext.model,
-            reasoningEffort: this.config.reasoningEffort
-          });
-          const streamOptions = {
-            model: this.model,
-            stopWhen: stepCountIs(1),
-            tools,
-            abortSignal: this.stepAbortController.signal,
-            messages: prepared.formattedMessages,
-            ...this.config.maxOutputTokens !== void 0 && {
-              maxOutputTokens: this.config.maxOutputTokens
-            },
-            ...this.config.temperature !== void 0 && {
-              temperature: this.config.temperature
-            },
-            // Provider-specific options (caching, reasoning, etc.)
-            ...providerOptions !== void 0 && {
-              providerOptions
-            },
-            // Log stream-level errors (tool errors, API errors during streaming)
-            onError: (error) => {
-              this.logger.error("Stream error", { error });
-            }
-          };
-          const result = await streamProcessor.process(() => streamText(streamOptions));
+          const result = await streamProcessor.process(
+            () => streamText({
+              model: this.model,
+              stopWhen: stepCountIs(1),
+              tools,
+              abortSignal: this.stepAbortController.signal,
+              messages: prepared.formattedMessages,
+              ...this.config.maxOutputTokens !== void 0 && {
+                maxOutputTokens: this.config.maxOutputTokens
+              },
+              ...this.config.temperature !== void 0 && {
+                temperature: this.config.temperature
+              },
+              // Provider-specific options (caching, reasoning, etc.)
+              ...providerOptions !== void 0 && {
+                providerOptions
+              },
+              // Log stream-level errors (tool errors, API errors during streaming)
+              onError: (error) => {
+                this.logger.error("Stream error", { error });
+              }
+            })
+          );
           lastStepTokens = result.usage;
           lastFinishReason = result.finishReason;
           lastText = result.text;
@@ -433,8 +455,8 @@ class TurnExecutor {
                   );
                   const metadata = (() => {
                     const meta = {};
-                    if (executionResult.toolDisplayName !== void 0) {
-                      meta.toolDisplayName = executionResult.toolDisplayName;
+                    if (executionResult.presentationSnapshot !== void 0) {
+                      meta.presentationSnapshot = executionResult.presentationSnapshot;
                     }
                     if (executionResult.requireApproval !== void 0) {
                       meta.requireApproval = executionResult.requireApproval;

package/dist/llm/formatters/vercel.cjs

@@ -113,7 +113,15 @@ class VercelMessageFormatter {
           }
           break;
         case "assistant":
-          formatted.push({ role: "assistant", ...this.formatAssistantMessage(msg) });
+          formatted.push({
+            role: "assistant",
+            ...this.formatAssistantMessage(msg, {
+              // OpenAI/OpenRouter reasoning items can require strict output-item replay.
+              // Keep those providers on "no reasoning replay" to avoid invalid_request errors.
+              // For other providers we continue to round-trip reasoning where available.
+              includeReasoning: this.shouldRoundTripReasoning(context)
+            })
+          });
           if (msg.toolCalls && msg.toolCalls.length > 0) {
             for (const toolCall of msg.toolCalls) {
               pendingToolCalls.set(toolCall.id, toolCall.function.name);
@@ -166,10 +174,14 @@ class VercelMessageFormatter {
   formatSystemPrompt() {
     return null;
   }
+  shouldRoundTripReasoning(context) {
+    return context.provider !== "openai" && context.provider !== "openai-compatible" && context.provider !== "openrouter" && context.provider !== "dexto-nova";
+  }
   // Helper to format Assistant messages (with optional tool calls and reasoning)
-  formatAssistantMessage(msg) {
+  formatAssistantMessage(msg, config) {
     const contentParts = [];
-    if (msg.reasoning) {
+    const includeReasoning = config?.includeReasoning ?? false;
+    if (includeReasoning && msg.reasoning) {
       const reasoningPart = {
         type: "reasoning",
         text: msg.reasoning,

package/dist/llm/formatters/vercel.d.ts

@@ -32,6 +32,7 @@ export declare class VercelMessageFormatter {
      * @returns null as Vercel doesn't need a separate system prompt
      */
     formatSystemPrompt(): null;
+    private shouldRoundTripReasoning;
     private formatAssistantMessage;
     private formatToolMessage;
 }

package/dist/llm/formatters/vercel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/llm/formatters/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiD,MAAM,IAAI,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAmBvD;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAG1B;;;;;;OAMG;IACH,MAAM,CACF,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,EACpC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC5B,YAAY,EAAE;IAsJjB;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAK1B,OAAO,CAAC,sBAAsB;IA0F9B,OAAO,CAAC,iBAAiB;CAoE5B"}
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/llm/formatters/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiD,MAAM,IAAI,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,wBAAwB,CAAC;AAE7F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAmBvD;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAG1B;;;;;;OAMG;IACH,MAAM,CACF,OAAO,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC,EACpC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC5B,YAAY,EAAE;IA8JjB;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAI1B,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,sBAAsB;IAmG9B,OAAO,CAAC,iBAAiB;CAoE5B"}

package/dist/llm/formatters/vercel.js

@@ -91,7 +91,15 @@ class VercelMessageFormatter {
           }
           break;
         case "assistant":
-          formatted.push({ role: "assistant", ...this.formatAssistantMessage(msg) });
+          formatted.push({
+            role: "assistant",
+            ...this.formatAssistantMessage(msg, {
+              // OpenAI/OpenRouter reasoning items can require strict output-item replay.
+              // Keep those providers on "no reasoning replay" to avoid invalid_request errors.
+              // For other providers we continue to round-trip reasoning where available.
+              includeReasoning: this.shouldRoundTripReasoning(context)
+            })
+          });
           if (msg.toolCalls && msg.toolCalls.length > 0) {
             for (const toolCall of msg.toolCalls) {
               pendingToolCalls.set(toolCall.id, toolCall.function.name);
@@ -144,10 +152,14 @@ class VercelMessageFormatter {
   formatSystemPrompt() {
     return null;
   }
+  shouldRoundTripReasoning(context) {
+    return context.provider !== "openai" && context.provider !== "openai-compatible" && context.provider !== "openrouter" && context.provider !== "dexto-nova";
+  }
   // Helper to format Assistant messages (with optional tool calls and reasoning)
-  formatAssistantMessage(msg) {
+  formatAssistantMessage(msg, config) {
     const contentParts = [];
-    if (msg.reasoning) {
+    const includeReasoning = config?.includeReasoning ?? false;
+    if (includeReasoning && msg.reasoning) {
       const reasoningPart = {
         type: "reasoning",
         text: msg.reasoning,

package/dist/llm/index.cjs

@@ -19,13 +19,16 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var llm_exports = {};
 __export(llm_exports, {
+  getCachedOpenRouterModelsWithInfo: () => import_openrouter_model_registry.getCachedOpenRouterModelsWithInfo,
   getLlmRegistryAutoUpdateStatus: () => import_auto_update.getLlmRegistryAutoUpdateStatus,
+  getOpenRouterModelCacheInfo: () => import_openrouter_model_registry.getOpenRouterModelCacheInfo,
   getOpenRouterModelContextLength: () => import_openrouter_model_registry.getOpenRouterModelContextLength,
   getOpenRouterModelInfo: () => import_openrouter_model_registry.getOpenRouterModelInfo,
   loadLlmRegistryCache: () => import_auto_update.loadLlmRegistryCache,
   lookupOpenRouterModel: () => import_openrouter_model_registry.lookupOpenRouterModel,
   refreshLlmRegistryCache: () => import_auto_update.refreshLlmRegistryCache,
   refreshOpenRouterModelCache: () => import_openrouter_model_registry.refreshOpenRouterModelCache,
+  scheduleOpenRouterModelRefresh: () => import_openrouter_model_registry.scheduleOpenRouterModelRefresh,
   startLlmRegistryAutoUpdate: () => import_auto_update.startLlmRegistryAutoUpdate
 });
 module.exports = __toCommonJS(llm_exports);
@@ -35,6 +38,7 @@ __reExport(llm_exports, require("./registry/index.js"), module.exports);
 __reExport(llm_exports, require("./curation.js"), module.exports);
 __reExport(llm_exports, require("./validation.js"), module.exports);
 __reExport(llm_exports, require("./types.js"), module.exports);
+__reExport(llm_exports, require("./reasoning/profile.js"), module.exports);
 __reExport(llm_exports, require("./services/index.js"), module.exports);
 __reExport(llm_exports, require("./schemas.js"), module.exports);
 var import_openrouter_model_registry = require("./providers/openrouter-model-registry.js");
@@ -42,13 +46,16 @@ var import_auto_update = require("./registry/auto-update.js");
 __reExport(llm_exports, require("./providers/local/index.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getCachedOpenRouterModelsWithInfo,
   getLlmRegistryAutoUpdateStatus,
+  getOpenRouterModelCacheInfo,
   getOpenRouterModelContextLength,
   getOpenRouterModelInfo,
   loadLlmRegistryCache,
   lookupOpenRouterModel,
   refreshLlmRegistryCache,
   refreshOpenRouterModelCache,
+  scheduleOpenRouterModelRefresh,
   startLlmRegistryAutoUpdate,
   ...require("./errors.js"),
   ...require("./error-codes.js"),
@@ -56,6 +63,7 @@ __reExport(llm_exports, require("./providers/local/index.js"), module.exports);
   ...require("./curation.js"),
   ...require("./validation.js"),
   ...require("./types.js"),
+  ...require("./reasoning/profile.js"),
   ...require("./services/index.js"),
   ...require("./schemas.js"),
   ...require("./providers/local/index.js")

package/dist/llm/index.d.ts

@@ -4,9 +4,10 @@ export * from './registry/index.js';
 export * from './curation.js';
 export * from './validation.js';
 export * from './types.js';
+export * from './reasoning/profile.js';
 export * from './services/index.js';
 export * from './schemas.js';
-export { lookupOpenRouterModel, refreshOpenRouterModelCache, getOpenRouterModelContextLength, getOpenRouterModelInfo, type LookupStatus, type OpenRouterModelInfo, } from './providers/openrouter-model-registry.js';
+export { getCachedOpenRouterModelsWithInfo, lookupOpenRouterModel, scheduleOpenRouterModelRefresh, refreshOpenRouterModelCache, getOpenRouterModelCacheInfo, getOpenRouterModelContextLength, getOpenRouterModelInfo, type LookupStatus, type OpenRouterModelInfo, } from './providers/openrouter-model-registry.js';
 export { startLlmRegistryAutoUpdate, refreshLlmRegistryCache, loadLlmRegistryCache, getLlmRegistryAutoUpdateStatus, type LlmRegistryAutoUpdateStatus, } from './registry/auto-update.js';
 export * from './providers/local/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,OAAO,EACH,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GAC3B,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EACH,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,2BAA2B,GACnC,MAAM,2BAA2B,CAAC;AAGnC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,OAAO,EACH,iCAAiC,EACjC,qBAAqB,EACrB,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GAC3B,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EACH,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,2BAA2B,GACnC,MAAM,2BAA2B,CAAC;AAGnC,cAAc,4BAA4B,CAAC"}

package/dist/llm/index.js

@@ -5,11 +5,15 @@ export * from "./registry/index.js";
 export * from "./curation.js";
 export * from "./validation.js";
 export * from "./types.js";
+export * from "./reasoning/profile.js";
 export * from "./services/index.js";
 export * from "./schemas.js";
 import {
+  getCachedOpenRouterModelsWithInfo,
   lookupOpenRouterModel,
+  scheduleOpenRouterModelRefresh,
   refreshOpenRouterModelCache,
+  getOpenRouterModelCacheInfo,
   getOpenRouterModelContextLength,
   getOpenRouterModelInfo
 } from "./providers/openrouter-model-registry.js";
@@ -21,12 +25,15 @@ import {
 } from "./registry/auto-update.js";
 export * from "./providers/local/index.js";
 export {
+  getCachedOpenRouterModelsWithInfo,
   getLlmRegistryAutoUpdateStatus,
+  getOpenRouterModelCacheInfo,
   getOpenRouterModelContextLength,
   getOpenRouterModelInfo,
   loadLlmRegistryCache,
   lookupOpenRouterModel,
   refreshLlmRegistryCache,
   refreshOpenRouterModelCache,
+  scheduleOpenRouterModelRefresh,
   startLlmRegistryAutoUpdate
 };

package/dist/llm/providers/local/schemas.d.ts

@@ -51,7 +51,7 @@ export declare const LocalModelInfoSchema: z.ZodObject<{
     quantization: "Q2_K" | "Q3_K_S" | "Q3_K_M" | "Q3_K_L" | "Q4_0" | "Q4_K_S" | "Q4_K_M" | "Q5_0" | "Q5_K_S" | "Q5_K_M" | "Q6_K" | "Q8_0" | "F16" | "F32";
     sizeBytes: number;
     contextLength: number;
-    categories: ("reasoning" | "small" | "general" | "coding" | "vision")[];
+    categories: ("small" | "reasoning" | "general" | "coding" | "vision")[];
     license?: string | undefined;
     supportsVision?: boolean | undefined;
     supportsTools?: boolean | undefined;
@@ -68,7 +68,7 @@ export declare const LocalModelInfoSchema: z.ZodObject<{
     quantization: "Q2_K" | "Q3_K_S" | "Q3_K_M" | "Q3_K_L" | "Q4_0" | "Q4_K_S" | "Q4_K_M" | "Q5_0" | "Q5_K_S" | "Q5_K_M" | "Q6_K" | "Q8_0" | "F16" | "F32";
     sizeBytes: number;
     contextLength: number;
-    categories: ("reasoning" | "small" | "general" | "coding" | "vision")[];
+    categories: ("small" | "reasoning" | "general" | "coding" | "vision")[];
     license?: string | undefined;
     supportsVision?: boolean | undefined;
     supportsTools?: boolean | undefined;

package/dist/llm/providers/openrouter-model-registry.cjs

@@ -30,6 +30,7 @@ var openrouter_model_registry_exports = {};
 __export(openrouter_model_registry_exports, {
   __TEST_ONLY__: () => __TEST_ONLY__,
   getCachedOpenRouterModels: () => getCachedOpenRouterModels,
+  getCachedOpenRouterModelsWithInfo: () => getCachedOpenRouterModelsWithInfo,
   getOpenRouterModelCacheInfo: () => getOpenRouterModelCacheInfo,
   getOpenRouterModelContextLength: () => getOpenRouterModelContextLength,
   getOpenRouterModelInfo: () => getOpenRouterModelInfo,
@@ -61,6 +62,23 @@ class OpenRouterModelRegistry {
   refreshPromise = null;
   lastRefreshAttemptAt = null;
   lastUsedApiKey;
+  parseExpirationDateEndUtc(expirationDate) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(expirationDate.trim());
+    if (!match) return null;
+    const year = Number(match[1]);
+    const monthIndex = Number(match[2]) - 1;
+    const day = Number(match[3]);
+    if (!Number.isFinite(year) || !Number.isFinite(monthIndex) || !Number.isFinite(day)) {
+      return null;
+    }
+    return Date.UTC(year, monthIndex, day, 23, 59, 59, 999);
+  }
+  isExpired(model) {
+    if (!model.expirationDate) return false;
+    const expiresAt = this.parseExpirationDateEndUtc(model.expirationDate);
+    if (!expiresAt) return false;
+    return Date.now() > expiresAt;
+  }
   /**
    * Look up a model ID against the OpenRouter catalog.
    * @returns 'valid' if model exists, 'invalid' if not found, 'unknown' if cache is stale/empty
@@ -78,7 +96,11 @@ class OpenRouterModelRegistry {
       this.scheduleRefresh();
       return "unknown";
     }
-    return this.models.has(normalized) ? "valid" : "invalid";
+    const info = this.models.get(normalized);
+    if (info && this.isExpired(info)) {
+      return "invalid";
+    }
+    return info ? "valid" : "invalid";
   }
   /**
    * Get context length for a model ID.
@@ -93,6 +115,7 @@ class OpenRouterModelRegistry {
       return null;
     }
     const info = this.models.get(normalized);
+    if (info && this.isExpired(info)) return null;
     return info?.contextLength ?? null;
   }
   /**
@@ -107,7 +130,9 @@ class OpenRouterModelRegistry {
     if (!this.models || this.models.size === 0 || !this.isCacheFresh()) {
       return null;
     }
-    return this.models.get(normalized) ?? null;
+    const info = this.models.get(normalized) ?? null;
+    if (info && this.isExpired(info)) return null;
+    return info;
   }
   /**
    * Schedule a non-blocking background refresh of the model cache.
@@ -117,6 +142,9 @@ class OpenRouterModelRegistry {
     if (apiKey) {
       this.lastUsedApiKey = apiKey;
     }
+    if ((process.env.NODE_ENV === "test" || process.env.VITEST) && options?.allowInTests !== true) {
+      return;
+    }
     if (this.refreshPromise) {
       return;
     }
@@ -125,7 +153,7 @@ class OpenRouterModelRegistry {
       return;
     }
     this.lastRefreshAttemptAt = now;
-    this.refreshPromise = this.refreshInternal(apiKey).catch((error) => {
+    this.refreshPromise = this.refreshInternal(apiKey, options?.timeoutMs).catch((error) => {
       import_logger.logger.warn(
         `Failed to refresh OpenRouter model registry: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -141,6 +169,9 @@ class OpenRouterModelRegistry {
     if (apiKey) {
       this.lastUsedApiKey = apiKey;
     }
+    if ((process.env.NODE_ENV === "test" || process.env.VITEST) && options?.allowInTests !== true) {
+      return;
+    }
     if (!options?.force && this.refreshPromise) {
       await this.refreshPromise;
       return;
@@ -157,7 +188,7 @@ class OpenRouterModelRegistry {
     } else {
       this.lastRefreshAttemptAt = Date.now();
     }
-    const promise = this.refreshInternal(apiKey).finally(() => {
+    const promise = this.refreshInternal(apiKey, options?.timeoutMs).finally(() => {
       this.refreshPromise = null;
     });
     this.refreshPromise = promise;
@@ -170,7 +201,12 @@ class OpenRouterModelRegistry {
     if (!this.models || this.models.size === 0) {
       return null;
     }
-    return Array.from(this.models.keys());
+    const ids = [];
+    for (const info of this.models.values()) {
+      if (this.isExpired(info)) continue;
+      ids.push(info.id);
+    }
+    return ids;
   }
   /**
    * Get all cached model info (or null if cache is empty).
@@ -179,19 +215,20 @@ class OpenRouterModelRegistry {
     if (!this.models || this.models.size === 0) {
       return null;
     }
-    return Array.from(this.models.values());
+    return Array.from(this.models.values()).filter((info) => !this.isExpired(info));
   }
   /**
    * Get cache metadata for debugging/monitoring.
    */
   getCacheMetadata() {
+    const modelCount = this.models ? Array.from(this.models.values()).filter((info) => !this.isExpired(info)).length : 0;
     return {
       lastFetchedAt: this.lastFetchedAt ? new Date(this.lastFetchedAt) : null,
-      modelCount: this.models ? this.models.size : 0,
+      modelCount,
       isFresh: this.isCacheFresh()
     };
   }
-  async refreshInternal(apiKey) {
+  async refreshInternal(apiKey, timeoutMs) {
     try {
       const headers = {
         Accept: "application/json"
@@ -200,7 +237,10 @@ class OpenRouterModelRegistry {
         headers.Authorization = `Bearer ${apiKey}`;
       }
       import_logger.logger.debug("Refreshing OpenRouter model registry from remote source");
-      const response = await fetch(OPENROUTER_MODELS_ENDPOINT, { headers });
+      const response = await fetch(OPENROUTER_MODELS_ENDPOINT, {
+        headers,
+        signal: AbortSignal.timeout(timeoutMs ?? 3e4)
+      });
       if (!response.ok) {
         const body = await response.text();
         throw new Error(`HTTP ${response.status}: ${body}`);
@@ -229,7 +269,7 @@ class OpenRouterModelRegistry {
       }
       this.models = /* @__PURE__ */ new Map();
       for (const model of parsed.models) {
-        if (typeof model === "object" && model.id && typeof model.contextLength === "number") {
+        if (typeof model === "object" && typeof model.id === "string" && model.id.trim().length > 0 && typeof model.contextLength === "number") {
           this.models.set(model.id.toLowerCase(), model);
         }
       }
@@ -294,7 +334,18 @@ class OpenRouterModelRegistry {
           } else if (record.top_provider && typeof record.top_provider === "object" && typeof record.top_provider.context_length === "number") {
             contextLength = record.top_provider.context_length;
           }
-          models.push({ id, contextLength });
+          const displayName = typeof record.name === "string" && record.name.trim().length > 0 ? record.name : void 0;
+          const expirationDate = typeof record.expiration_date === "string" && record.expiration_date.trim().length > 0 ? record.expiration_date : void 0;
+          const supportedParameters = Array.isArray(record.supported_parameters) ? record.supported_parameters.filter(
+            (p) => typeof p === "string" && p.trim().length > 0
+          ) : void 0;
+          models.push({
+            id,
+            contextLength,
+            ...displayName ? { displayName } : {},
+            ...expirationDate ? { expirationDate } : {},
+            ...supportedParameters ? { supportedParameters } : {}
+          });
         }
       }
     }
@@ -323,6 +374,9 @@ async function refreshOpenRouterModelCache(options) {
 function getCachedOpenRouterModels() {
   return openRouterModelRegistry.getCachedModels();
 }
+function getCachedOpenRouterModelsWithInfo() {
+  return openRouterModelRegistry.getCachedModelsWithInfo();
+}
 function getOpenRouterModelContextLength(modelId) {
   return openRouterModelRegistry.getContextLength(modelId);
 }
@@ -340,6 +394,7 @@ const __TEST_ONLY__ = {
 0 && (module.exports = {
   __TEST_ONLY__,
   getCachedOpenRouterModels,
+  getCachedOpenRouterModelsWithInfo,
   getOpenRouterModelCacheInfo,
   getOpenRouterModelContextLength,
   getOpenRouterModelInfo,

package/dist/llm/providers/openrouter-model-registry.d.ts

@@ -15,10 +15,29 @@ export type LookupStatus = 'valid' | 'invalid' | 'unknown';
 export interface OpenRouterModelInfo {
     id: string;
     contextLength: number;
+    /**
+     * Human-friendly model name from OpenRouter (e.g. "Claude Sonnet 4.5").
+     */
+    displayName?: string;
+    /**
+     * OpenRouter expiration date (YYYY-MM-DD) when present.
+     * Models past this date should be treated as invalid/deprecated.
+     */
+    expirationDate?: string;
+    /**
+     * OpenRouter supported parameters (e.g. includes "reasoning" for reasoning-capable models).
+     */
+    supportedParameters?: string[];
 }
 interface RefreshOptions {
     apiKey?: string;
     force?: boolean;
+    timeoutMs?: number;
+    /**
+     * Test-only escape hatch for unit tests that want to validate refresh behavior.
+     * Network fetch is disabled by default when NODE_ENV === 'test' or VITEST is set.
+     */
+    allowInTests?: boolean;
 }
 declare class OpenRouterModelRegistry {
     private readonly cachePath;
@@ -29,6 +48,8 @@ declare class OpenRouterModelRegistry {
     private lastRefreshAttemptAt;
     private lastUsedApiKey?;
     constructor(cachePath: string);
+    private parseExpirationDateEndUtc;
+    private isExpired;
     /**
      * Look up a model ID against the OpenRouter catalog.
      * @returns 'valid' if model exists, 'invalid' if not found, 'unknown' if cache is stale/empty
@@ -94,6 +115,11 @@ export declare function refreshOpenRouterModelCache(options?: RefreshOptions): P
  * Get all cached OpenRouter model IDs (or null if cache is empty).
  */
 export declare function getCachedOpenRouterModels(): string[] | null;
+/**
+ * Get all cached OpenRouter model info (or null if cache is empty).
+ * Expired models are filtered out.
+ */
+export declare function getCachedOpenRouterModelsWithInfo(): OpenRouterModelInfo[] | null;
 /**
  * Get context length for an OpenRouter model.
  * @returns context length if model is in cache, null if not found or cache is stale

package/dist/llm/providers/openrouter-model-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter-model-registry.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openrouter-model-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;CACzB;AAOD,UAAU,cAAc;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAKD,cAAM,uBAAuB;IAQb,OAAO,CAAC,QAAQ,CAAC,SAAS;IAPtC,iDAAiD;IACjD,OAAO,CAAC,MAAM,CAAiD;IAC/D,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,cAAc,CAAC,CAAS;gBAEH,SAAS,EAAE,MAAM;IAI9C;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAqBrC;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAchD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAazD;;OAEG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IA+B/C;;OAEG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCtD;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE,GAAG,IAAI;IAOlC;;OAEG;IACH,uBAAuB,IAAI,mBAAmB,EAAE,GAAG,IAAI;IAOvD;;OAEG;IACH,gBAAgB,IAAI;QAAE,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;YAQ1E,eAAe;IA6B7B,OAAO,CAAC,iBAAiB;IAsCzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,YAAY;YAON,UAAU;IAwBxB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,WAAW;CAQtB;AAID,eAAO,MAAM,uBAAuB,yBAAyC,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAEnE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAElF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI;IAC3C,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACpB,CAEA;AAGD,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}
+{"version":3,"file":"openrouter-model-registry.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openrouter-model-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3D,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAOD,UAAU,cAAc;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAKD,cAAM,uBAAuB;IAQb,OAAO,CAAC,QAAQ,CAAC,SAAS;IAPtC,iDAAiD;IACjD,OAAO,CAAC,MAAM,CAAiD;IAC/D,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,cAAc,CAAC,CAAS;gBAEH,SAAS,EAAE,MAAM;IAI9C,OAAO,CAAC,yBAAyB;IAcjC,OAAO,CAAC,SAAS;IAOjB;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IA0BrC;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAehD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAezD;;OAEG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAsC/C;;OAEG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CtD;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE,GAAG,IAAI;IAYlC;;OAEG;IACH,uBAAuB,IAAI,mBAAmB,EAAE,GAAG,IAAI;IAOvD;;OAEG;IACH,gBAAgB,IAAI;QAAE,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;YAW1E,eAAe;IAgC7B,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,YAAY;YAON,UAAU;IAwBxB,OAAO,CAAC,aAAa;IA4DrB,OAAO,CAAC,WAAW;CAQtB;AAID,eAAO,MAAM,uBAAuB,yBAAyC,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAEnE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,IAAI,mBAAmB,EAAE,GAAG,IAAI,CAEhF;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAElF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI;IAC3C,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACpB,CAEA;AAGD,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}