@dexto/core 1.6.1 → 1.6.2

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: ("small" | "general" | "reasoning" | "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: ("small" | "general" | "reasoning" | "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":"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"}

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

@@ -21,6 +21,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
@@ -38,7 +55,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.
@@ -53,6 +74,7 @@ class OpenRouterModelRegistry {
       return null;
     }
     const info = this.models.get(normalized);
+    if (info && this.isExpired(info)) return null;
     return info?.contextLength ?? null;
   }
   /**
@@ -67,7 +89,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.
@@ -77,6 +101,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;
     }
@@ -85,7 +112,7 @@ class OpenRouterModelRegistry {
       return;
     }
     this.lastRefreshAttemptAt = now;
-    this.refreshPromise = this.refreshInternal(apiKey).catch((error) => {
+    this.refreshPromise = this.refreshInternal(apiKey, options?.timeoutMs).catch((error) => {
       logger.warn(
         `Failed to refresh OpenRouter model registry: ${error instanceof Error ? error.message : String(error)}`
       );
@@ -101,6 +128,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;
@@ -117,7 +147,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;
@@ -130,7 +160,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).
@@ -139,19 +174,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"
@@ -160,7 +196,10 @@ class OpenRouterModelRegistry {
         headers.Authorization = `Bearer ${apiKey}`;
       }
       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}`);
@@ -189,7 +228,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);
         }
       }
@@ -254,7 +293,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 } : {}
+          });
         }
       }
     }
@@ -283,6 +333,9 @@ async function refreshOpenRouterModelCache(options) {
 function getCachedOpenRouterModels() {
   return openRouterModelRegistry.getCachedModels();
 }
+function getCachedOpenRouterModelsWithInfo() {
+  return openRouterModelRegistry.getCachedModelsWithInfo();
+}
 function getOpenRouterModelContextLength(modelId) {
   return openRouterModelRegistry.getContextLength(modelId);
 }
@@ -299,6 +352,7 @@ const __TEST_ONLY__ = {
 export {
   __TEST_ONLY__,
   getCachedOpenRouterModels,
+  getCachedOpenRouterModelsWithInfo,
   getOpenRouterModelCacheInfo,
   getOpenRouterModelContextLength,
   getOpenRouterModelInfo,

package/dist/llm/reasoning/anthropic-betas.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var anthropic_betas_exports = {};
+__export(anthropic_betas_exports, {
+  ANTHROPIC_BETA_HEADER: () => ANTHROPIC_BETA_HEADER,
+  ANTHROPIC_INTERLEAVED_THINKING_BETA: () => ANTHROPIC_INTERLEAVED_THINKING_BETA
+});
+module.exports = __toCommonJS(anthropic_betas_exports);
+const ANTHROPIC_BETA_HEADER = "anthropic-beta";
+const ANTHROPIC_INTERLEAVED_THINKING_BETA = "interleaved-thinking-2025-05-14";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ANTHROPIC_BETA_HEADER,
+  ANTHROPIC_INTERLEAVED_THINKING_BETA
+});

package/dist/llm/reasoning/anthropic-betas.d.ts

@@ -0,0 +1,3 @@
+export declare const ANTHROPIC_BETA_HEADER = "anthropic-beta";
+export declare const ANTHROPIC_INTERLEAVED_THINKING_BETA = "interleaved-thinking-2025-05-14";
+//# sourceMappingURL=anthropic-betas.d.ts.map

package/dist/llm/reasoning/anthropic-betas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-betas.d.ts","sourceRoot":"","sources":["../../../src/llm/reasoning/anthropic-betas.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAMtD,eAAO,MAAM,mCAAmC,oCAAoC,CAAC"}

package/dist/llm/reasoning/anthropic-betas.js

@@ -0,0 +1,7 @@
+import "../../chunk-PTJYTZNU.js";
+const ANTHROPIC_BETA_HEADER = "anthropic-beta";
+const ANTHROPIC_INTERLEAVED_THINKING_BETA = "interleaved-thinking-2025-05-14";
+export {
+  ANTHROPIC_BETA_HEADER,
+  ANTHROPIC_INTERLEAVED_THINKING_BETA
+};

package/dist/llm/reasoning/anthropic-thinking.cjs

@@ -0,0 +1,79 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var anthropic_thinking_exports = {};
+__export(anthropic_thinking_exports, {
+  isAnthropicAdaptiveThinkingModel: () => isAnthropicAdaptiveThinkingModel,
+  isAnthropicOpusAdaptiveThinkingModel: () => isAnthropicOpusAdaptiveThinkingModel,
+  isClaudeVersionAtLeast: () => isClaudeVersionAtLeast,
+  parseClaudeVersion: () => parseClaudeVersion,
+  supportsAnthropicInterleavedThinking: () => supportsAnthropicInterleavedThinking
+});
+module.exports = __toCommonJS(anthropic_thinking_exports);
+function parseClaudeVersion(model) {
+  const modelLower = model.toLowerCase();
+  const variantFirst = /claude-(opus|sonnet|haiku)-(\d+)(?:[.-](\d{1,2})(?!\d))?/i.exec(
+    modelLower
+  );
+  if (variantFirst) {
+    const [, variant, majorRaw, minorRaw] = variantFirst;
+    if (!variant || !majorRaw) return null;
+    const major = Number.parseInt(majorRaw, 10);
+    const minor = minorRaw ? Number.parseInt(minorRaw, 10) : 0;
+    if (!Number.isFinite(major) || !Number.isFinite(minor)) return null;
+    return { major, minor, variant };
+  }
+  const versionFirst = /claude-(\d+)(?:[.-](\d{1,2})(?!\d))?-(opus|sonnet|haiku)/i.exec(
+    modelLower
+  );
+  if (versionFirst) {
+    const [, majorRaw, minorRaw, variant] = versionFirst;
+    if (!majorRaw || !variant) return null;
+    const major = Number.parseInt(majorRaw, 10);
+    const minor = minorRaw ? Number.parseInt(minorRaw, 10) : 0;
+    if (!Number.isFinite(major) || !Number.isFinite(minor)) return null;
+    return { major, minor, variant };
+  }
+  return null;
+}
+function isClaudeVersionAtLeast(version, min) {
+  return version.major > min.major || version.major === min.major && version.minor >= min.minor;
+}
+function isAnthropicAdaptiveThinkingModel(model) {
+  const version = parseClaudeVersion(model);
+  if (!version) return false;
+  return isClaudeVersionAtLeast(version, { major: 4, minor: 6 });
+}
+function isAnthropicOpusAdaptiveThinkingModel(model) {
+  const version = parseClaudeVersion(model);
+  if (!version || version.variant !== "opus") return false;
+  return isClaudeVersionAtLeast(version, { major: 4, minor: 6 });
+}
+function supportsAnthropicInterleavedThinking(model) {
+  const version = parseClaudeVersion(model);
+  if (!version) return false;
+  return version.major >= 4;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isAnthropicAdaptiveThinkingModel,
+  isAnthropicOpusAdaptiveThinkingModel,
+  isClaudeVersionAtLeast,
+  parseClaudeVersion,
+  supportsAnthropicInterleavedThinking
+});

package/dist/llm/reasoning/anthropic-thinking.d.ts

@@ -0,0 +1,15 @@
+export type ClaudeVariant = 'opus' | 'sonnet' | 'haiku';
+export type ParsedClaudeVersion = {
+    major: number;
+    minor: number;
+    variant?: ClaudeVariant;
+};
+export declare function parseClaudeVersion(model: string): ParsedClaudeVersion | null;
+export declare function isClaudeVersionAtLeast(version: Pick<ParsedClaudeVersion, 'major' | 'minor'>, min: {
+    major: number;
+    minor: number;
+}): boolean;
+export declare function isAnthropicAdaptiveThinkingModel(model: string): boolean;
+export declare function isAnthropicOpusAdaptiveThinkingModel(model: string): boolean;
+export declare function supportsAnthropicInterleavedThinking(model: string): boolean;
+//# sourceMappingURL=anthropic-thinking.d.ts.map

package/dist/llm/reasoning/anthropic-thinking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-thinking.d.ts","sourceRoot":"","sources":["../../../src/llm/reasoning/anthropic-thinking.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAmC5E;AAED,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,OAAO,CAAC,EACrD,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAET;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMvE;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI3E;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAM3E"}

package/dist/llm/reasoning/anthropic-thinking.js

@@ -0,0 +1,52 @@
+import "../../chunk-PTJYTZNU.js";
+function parseClaudeVersion(model) {
+  const modelLower = model.toLowerCase();
+  const variantFirst = /claude-(opus|sonnet|haiku)-(\d+)(?:[.-](\d{1,2})(?!\d))?/i.exec(
+    modelLower
+  );
+  if (variantFirst) {
+    const [, variant, majorRaw, minorRaw] = variantFirst;
+    if (!variant || !majorRaw) return null;
+    const major = Number.parseInt(majorRaw, 10);
+    const minor = minorRaw ? Number.parseInt(minorRaw, 10) : 0;
+    if (!Number.isFinite(major) || !Number.isFinite(minor)) return null;
+    return { major, minor, variant };
+  }
+  const versionFirst = /claude-(\d+)(?:[.-](\d{1,2})(?!\d))?-(opus|sonnet|haiku)/i.exec(
+    modelLower
+  );
+  if (versionFirst) {
+    const [, majorRaw, minorRaw, variant] = versionFirst;
+    if (!majorRaw || !variant) return null;
+    const major = Number.parseInt(majorRaw, 10);
+    const minor = minorRaw ? Number.parseInt(minorRaw, 10) : 0;
+    if (!Number.isFinite(major) || !Number.isFinite(minor)) return null;
+    return { major, minor, variant };
+  }
+  return null;
+}
+function isClaudeVersionAtLeast(version, min) {
+  return version.major > min.major || version.major === min.major && version.minor >= min.minor;
+}
+function isAnthropicAdaptiveThinkingModel(model) {
+  const version = parseClaudeVersion(model);
+  if (!version) return false;
+  return isClaudeVersionAtLeast(version, { major: 4, minor: 6 });
+}
+function isAnthropicOpusAdaptiveThinkingModel(model) {
+  const version = parseClaudeVersion(model);
+  if (!version || version.variant !== "opus") return false;
+  return isClaudeVersionAtLeast(version, { major: 4, minor: 6 });
+}
+function supportsAnthropicInterleavedThinking(model) {
+  const version = parseClaudeVersion(model);
+  if (!version) return false;
+  return version.major >= 4;
+}
+export {
+  isAnthropicAdaptiveThinkingModel,
+  isAnthropicOpusAdaptiveThinkingModel,
+  isClaudeVersionAtLeast,
+  parseClaudeVersion,
+  supportsAnthropicInterleavedThinking
+};