@prestyj/core 5.24.0 → 5.25.1

package/dist/index.d.cts

@@ -168,13 +168,39 @@ declare function closeLogger(opts?: {
  */
 declare function withFileLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
 
+/**
+ * Compare two dotted version strings numerically.
+ *
+ * Returns >0 when `a` is newer, <0 when older, 0 when equal. Segment-wise
+ * numeric comparison matters here: Claude Code is deep into 2.1.x, where a
+ * lexical compare puts "2.1.9" above "2.1.280" and would happily serve a UA
+ * that Anthropic rejects.
+ */
+declare function compareClaudeCodeVersions(a: string, b: string): number;
 /**
  * Resolve the current Claude Code release version for spoofing the claude-cli
- * User-Agent on OAuth and inference requests. Cached in-memory for the process
- * lifetime and on disk for 24h. Falls back to a hardcoded constant if the npm
- * registry is unreachable and no cache exists.
+ * User-Agent on OAuth and inference requests.
+ *
+ * A cached value under an hour old is served straight away. An older one is
+ * still served immediately — the hot path never waits on npm — but triggers a
+ * background refresh, so a client-version gate on a newly released model costs
+ * at most one request instead of a full day of lockout. Past 24h the cache is
+ * refreshed synchronously, and only falls back to the stale value (then the
+ * bundled constant) if npm cannot be reached at all.
  */
 declare function getClaudeCodeVersion(): Promise<string>;
+/**
+ * Learn the minimum client version from a provider rejection.
+ *
+ * Anthropic gates newly released models on a minimum Claude Code version and
+ * names it in the error ("version 2.1.280 or newer is required"). That message
+ * is authoritative — more current than the npm registry can be at launch — so
+ * we pin it as a floor, persist it, and drop the memoised value. The next
+ * request builds its User-Agent from the floor and succeeds.
+ *
+ * Returns the newly applied floor, or null when the error is unrelated.
+ */
+declare function recordRequiredClaudeCodeVersion(message: string): string | null;
 /** Build the User-Agent string Anthropic's OAuth + inference edges expect. */
 declare function getClaudeCliUserAgent(): Promise<string>;
 
@@ -752,4 +778,4 @@ interface AutoUpdater {
 }
 declare function createAutoUpdater(config: AutoUpdateConfig): AutoUpdater;
 
-export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, DEFAULT_LOCAL_ENDPOINTS, type DiscoverOptions, type DiscoveryResult, type DualAuthProvider, FALLBACK_CONTEXT_WINDOW, type InlineButton, LOCAL_API_KEY_PLACEHOLDER, LOCAL_AUTH_KEY_PREFIX, type LocalEndpoint, type LocalEndpointKind, type LocalEndpointProbe, type LocalModel, type LogLevel, MOONSHOT_OAUTH_KEY, ModelInfo, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, PLAN_MODE_THINKING_CAP, type ProbeOptions, type ProgressCallback, SubscriptionUsageError, type SubscriptionUsageProvider, type SubscriptionUsageSnapshot, type SubscriptionUsageWindow, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, XAI_OAUTH_KEY, XIAOMI_CREDITS_KEY, clampThinkingForPlanMode, clearLocalDiscoveryCache, closeLogger, createAutoUpdater, decodeOggOpus, discoverLocalModels, downmixToMono, dualAuthProvider, dualAuthProviderByOAuthKey, endpointRoot, fetchSubscriptionUsage, findProbedModel, formatLocalModelId, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, grokCliBaseUrl, grokCliHeaders, isGrokCliEndpoint, isKimiCodingEndpoint, isLocalModelId, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, localAuthStorageKey, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, loginXai, oauthStorageKey, openLog, parseLocalModelId, probeEndpoint, providerStorageKeys, readStoredBaseUrlSync, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, refreshXaiToken, registerLogCleanup, resample, setProgressCallback, toModelInfo, transcribeVoice, withFileLock };
+export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, DEFAULT_LOCAL_ENDPOINTS, type DiscoverOptions, type DiscoveryResult, type DualAuthProvider, FALLBACK_CONTEXT_WINDOW, type InlineButton, LOCAL_API_KEY_PLACEHOLDER, LOCAL_AUTH_KEY_PREFIX, type LocalEndpoint, type LocalEndpointKind, type LocalEndpointProbe, type LocalModel, type LogLevel, MOONSHOT_OAUTH_KEY, ModelInfo, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, PLAN_MODE_THINKING_CAP, type ProbeOptions, type ProgressCallback, SubscriptionUsageError, type SubscriptionUsageProvider, type SubscriptionUsageSnapshot, type SubscriptionUsageWindow, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, XAI_OAUTH_KEY, XIAOMI_CREDITS_KEY, clampThinkingForPlanMode, clearLocalDiscoveryCache, closeLogger, compareClaudeCodeVersions, createAutoUpdater, decodeOggOpus, discoverLocalModels, downmixToMono, dualAuthProvider, dualAuthProviderByOAuthKey, endpointRoot, fetchSubscriptionUsage, findProbedModel, formatLocalModelId, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, grokCliBaseUrl, grokCliHeaders, isGrokCliEndpoint, isKimiCodingEndpoint, isLocalModelId, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, localAuthStorageKey, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, loginXai, oauthStorageKey, openLog, parseLocalModelId, probeEndpoint, providerStorageKeys, readStoredBaseUrlSync, recordRequiredClaudeCodeVersion, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, refreshXaiToken, registerLogCleanup, resample, setProgressCallback, toModelInfo, transcribeVoice, withFileLock };

package/dist/index.d.ts

@@ -168,13 +168,39 @@ declare function closeLogger(opts?: {
  */
 declare function withFileLock<T>(filePath: string, fn: () => Promise<T>): Promise<T>;
 
+/**
+ * Compare two dotted version strings numerically.
+ *
+ * Returns >0 when `a` is newer, <0 when older, 0 when equal. Segment-wise
+ * numeric comparison matters here: Claude Code is deep into 2.1.x, where a
+ * lexical compare puts "2.1.9" above "2.1.280" and would happily serve a UA
+ * that Anthropic rejects.
+ */
+declare function compareClaudeCodeVersions(a: string, b: string): number;
 /**
  * Resolve the current Claude Code release version for spoofing the claude-cli
- * User-Agent on OAuth and inference requests. Cached in-memory for the process
- * lifetime and on disk for 24h. Falls back to a hardcoded constant if the npm
- * registry is unreachable and no cache exists.
+ * User-Agent on OAuth and inference requests.
+ *
+ * A cached value under an hour old is served straight away. An older one is
+ * still served immediately — the hot path never waits on npm — but triggers a
+ * background refresh, so a client-version gate on a newly released model costs
+ * at most one request instead of a full day of lockout. Past 24h the cache is
+ * refreshed synchronously, and only falls back to the stale value (then the
+ * bundled constant) if npm cannot be reached at all.
  */
 declare function getClaudeCodeVersion(): Promise<string>;
+/**
+ * Learn the minimum client version from a provider rejection.
+ *
+ * Anthropic gates newly released models on a minimum Claude Code version and
+ * names it in the error ("version 2.1.280 or newer is required"). That message
+ * is authoritative — more current than the npm registry can be at launch — so
+ * we pin it as a floor, persist it, and drop the memoised value. The next
+ * request builds its User-Agent from the floor and succeeds.
+ *
+ * Returns the newly applied floor, or null when the error is unrelated.
+ */
+declare function recordRequiredClaudeCodeVersion(message: string): string | null;
 /** Build the User-Agent string Anthropic's OAuth + inference edges expect. */
 declare function getClaudeCliUserAgent(): Promise<string>;
 
@@ -752,4 +778,4 @@ interface AutoUpdater {
 }
 declare function createAutoUpdater(config: AutoUpdateConfig): AutoUpdater;
 
-export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, DEFAULT_LOCAL_ENDPOINTS, type DiscoverOptions, type DiscoveryResult, type DualAuthProvider, FALLBACK_CONTEXT_WINDOW, type InlineButton, LOCAL_API_KEY_PLACEHOLDER, LOCAL_AUTH_KEY_PREFIX, type LocalEndpoint, type LocalEndpointKind, type LocalEndpointProbe, type LocalModel, type LogLevel, MOONSHOT_OAUTH_KEY, ModelInfo, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, PLAN_MODE_THINKING_CAP, type ProbeOptions, type ProgressCallback, SubscriptionUsageError, type SubscriptionUsageProvider, type SubscriptionUsageSnapshot, type SubscriptionUsageWindow, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, XAI_OAUTH_KEY, XIAOMI_CREDITS_KEY, clampThinkingForPlanMode, clearLocalDiscoveryCache, closeLogger, createAutoUpdater, decodeOggOpus, discoverLocalModels, downmixToMono, dualAuthProvider, dualAuthProviderByOAuthKey, endpointRoot, fetchSubscriptionUsage, findProbedModel, formatLocalModelId, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, grokCliBaseUrl, grokCliHeaders, isGrokCliEndpoint, isKimiCodingEndpoint, isLocalModelId, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, localAuthStorageKey, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, loginXai, oauthStorageKey, openLog, parseLocalModelId, probeEndpoint, providerStorageKeys, readStoredBaseUrlSync, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, refreshXaiToken, registerLogCleanup, resample, setProgressCallback, toModelInfo, transcribeVoice, withFileLock };
+export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, DEFAULT_LOCAL_ENDPOINTS, type DiscoverOptions, type DiscoveryResult, type DualAuthProvider, FALLBACK_CONTEXT_WINDOW, type InlineButton, LOCAL_API_KEY_PLACEHOLDER, LOCAL_AUTH_KEY_PREFIX, type LocalEndpoint, type LocalEndpointKind, type LocalEndpointProbe, type LocalModel, type LogLevel, MOONSHOT_OAUTH_KEY, ModelInfo, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, PLAN_MODE_THINKING_CAP, type ProbeOptions, type ProgressCallback, SubscriptionUsageError, type SubscriptionUsageProvider, type SubscriptionUsageSnapshot, type SubscriptionUsageWindow, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, XAI_OAUTH_KEY, XIAOMI_CREDITS_KEY, clampThinkingForPlanMode, clearLocalDiscoveryCache, closeLogger, compareClaudeCodeVersions, createAutoUpdater, decodeOggOpus, discoverLocalModels, downmixToMono, dualAuthProvider, dualAuthProviderByOAuthKey, endpointRoot, fetchSubscriptionUsage, findProbedModel, formatLocalModelId, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, grokCliBaseUrl, grokCliHeaders, isGrokCliEndpoint, isKimiCodingEndpoint, isLocalModelId, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, localAuthStorageKey, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, loginXai, oauthStorageKey, openLog, parseLocalModelId, probeEndpoint, providerStorageKeys, readStoredBaseUrlSync, recordRequiredClaudeCodeVersion, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, refreshXaiToken, registerLogCleanup, resample, setProgressCallback, toModelInfo, transcribeVoice, withFileLock };

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   XIAOMI_CREDITS_KEY,
   clearRuntimeModels,
   closeLogger,
+  compareClaudeCodeVersions,
   dualAuthProvider,
   dualAuthProviderByOAuthKey,
   generatePKCE,
@@ -45,6 +46,7 @@ import {
   openLog,
   providerStorageKeys,
   readStoredBaseUrlSync,
+  recordRequiredClaudeCodeVersion,
   refreshAnthropicToken,
   refreshGeminiToken,
   refreshKimiToken,
@@ -54,7 +56,7 @@ import {
   registerRuntimeModels,
   usesOpenAICodexTransport,
   withFileLock
-} from "./chunk-SQLBQOQH.js";
+} from "./chunk-THUBQC6I.js";
 import {
   getAppPaths
 } from "./chunk-CRU3SSNX.js";
@@ -1185,6 +1187,7 @@ export {
   clearLocalDiscoveryCache,
   clearRuntimeModels,
   closeLogger,
+  compareClaudeCodeVersions,
   createAutoUpdater,
   decodeOggOpus,
   discoverLocalModels,
@@ -1238,6 +1241,7 @@ export {
   probeEndpoint,
   providerStorageKeys,
   readStoredBaseUrlSync,
+  recordRequiredClaudeCodeVersion,
   refreshAnthropicToken,
   refreshGeminiToken,
   refreshKimiToken,