@prestyj/core 5.1.0 → 5.2.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, ModelInfo, getContextWindow, getDefaultModel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getVideoByteLimit, usesOpenAICodexTransport } from './model-registry.cjs';
+export { ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, ModelInfo, getAuthStorageKey, getAuthStorageKeys, getContextWindow, getDefaultModel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getVideoByteLimit, usesOpenAICodexTransport } from './model-registry.cjs';
 import { Provider, ThinkingLevel } from '@prestyj/ai';
 export { AppPaths, getAppPaths } from './paths.cjs';
 
@@ -71,6 +71,15 @@ interface OAuthLoginCallbacks {
  * prefer OAuth for the logical `moonshot` provider.
  */
 declare const MOONSHOT_OAUTH_KEY = "moonshot-oauth";
+/**
+ * Storage key for the Xiaomi API Credits credential (`https://api.xiaomimimo.com/v1`).
+ * Kept distinct from the `xiaomi` Token Plan entry (`token-plan-sgp.xiaomimimo.com`)
+ * so a user can configure BOTH — `mimo-v2.5-pro-ultraspeed` is API Credits-only,
+ * while `mimo-v2.5-pro`/`mimo-v2.5` prefer the Token Plan but fall back to API
+ * Credits when only that's configured. Which key(s) a model tries, and in what
+ * order, is decided per-model via `getAuthStorageKeys()` in model-registry.ts.
+ */
+declare const XIAOMI_CREDITS_KEY = "xiaomi-credits";
 declare class AuthStorage {
     private data;
     private filePath;
@@ -84,6 +93,14 @@ declare class AuthStorage {
     listProviders(): Promise<string[]>;
     /** True if credentials exist for `provider`. */
     hasCredentials(provider: string): Promise<boolean>;
+    /**
+     * First key in `keys` (in order) that has stored credentials, or `undefined`
+     * if none do. Mirrors the first-match logic `resolveCredentials({ storageKeys })`
+     * uses internally — callers that need to know WHICH credential will actually
+     * be used (e.g. to clear the right one after a 401) call this directly
+     * instead of re-deriving the same order.
+     */
+    pickStorageKey(keys: string[]): Promise<string | undefined>;
     /**
      * True if the user has any usable auth for the logical provider. For
      * `moonshot` this is satisfied by either the Kimi OAuth credential or the
@@ -98,6 +115,14 @@ declare class AuthStorage {
     isStaticApiKey(provider: string): Promise<boolean>;
     load(): Promise<void>;
     private ensureLoaded;
+    /**
+     * Force a re-read from disk, discarding the in-memory cache. Needed when
+     * another process mutates the auth file out-of-band — e.g. the desktop app
+     * writes API keys natively (Rust → ~/.ezcoder/auth.json) without going through
+     * this instance, so a long-lived daemon's cache would otherwise stay stale and
+     * never see a newly added provider key.
+     */
+    reload(): Promise<void>;
     getCredentials(provider: string): Promise<OAuthCredentials | undefined>;
     setCredentials(provider: string, creds: OAuthCredentials): Promise<void>;
     clearCredentials(provider: string): Promise<void>;
@@ -110,6 +135,7 @@ declare class AuthStorage {
      */
     resolveCredentials(provider: string, opts?: {
         forceRefresh?: boolean;
+        storageKeys?: string[];
     }): Promise<OAuthCredentials>;
     /**
      * Returns a valid access token, auto-refreshing if expired.
@@ -356,4 +382,4 @@ interface AutoUpdater {
 }
 declare function createAutoUpdater(config: AutoUpdateConfig): AutoUpdater;
 
-export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, type InlineButton, type LogLevel, MOONSHOT_OAUTH_KEY, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, type ProgressCallback, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, closeLogger, createAutoUpdater, decodeOggOpus, downmixToMono, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, isKimiCodingEndpoint, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, openLog, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, registerLogCleanup, resample, setProgressCallback, transcribeVoice, withFileLock };
+export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, type InlineButton, type LogLevel, MOONSHOT_OAUTH_KEY, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, type ProgressCallback, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, XIAOMI_CREDITS_KEY, closeLogger, createAutoUpdater, decodeOggOpus, downmixToMono, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, isKimiCodingEndpoint, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, openLog, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, registerLogCleanup, resample, setProgressCallback, transcribeVoice, withFileLock };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, ModelInfo, getContextWindow, getDefaultModel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getVideoByteLimit, usesOpenAICodexTransport } from './model-registry.js';
+export { ContextWindowOptions, DEFAULT_MAX_VIDEO_BYTES, MODELS, ModelInfo, getAuthStorageKey, getAuthStorageKeys, getContextWindow, getDefaultModel, getMaxThinkingLevel, getModel, getModelsForProvider, getSummaryModel, getVideoByteLimit, usesOpenAICodexTransport } from './model-registry.js';
 import { Provider, ThinkingLevel } from '@prestyj/ai';
 export { AppPaths, getAppPaths } from './paths.js';
 
@@ -71,6 +71,15 @@ interface OAuthLoginCallbacks {
  * prefer OAuth for the logical `moonshot` provider.
  */
 declare const MOONSHOT_OAUTH_KEY = "moonshot-oauth";
+/**
+ * Storage key for the Xiaomi API Credits credential (`https://api.xiaomimimo.com/v1`).
+ * Kept distinct from the `xiaomi` Token Plan entry (`token-plan-sgp.xiaomimimo.com`)
+ * so a user can configure BOTH — `mimo-v2.5-pro-ultraspeed` is API Credits-only,
+ * while `mimo-v2.5-pro`/`mimo-v2.5` prefer the Token Plan but fall back to API
+ * Credits when only that's configured. Which key(s) a model tries, and in what
+ * order, is decided per-model via `getAuthStorageKeys()` in model-registry.ts.
+ */
+declare const XIAOMI_CREDITS_KEY = "xiaomi-credits";
 declare class AuthStorage {
     private data;
     private filePath;
@@ -84,6 +93,14 @@ declare class AuthStorage {
     listProviders(): Promise<string[]>;
     /** True if credentials exist for `provider`. */
     hasCredentials(provider: string): Promise<boolean>;
+    /**
+     * First key in `keys` (in order) that has stored credentials, or `undefined`
+     * if none do. Mirrors the first-match logic `resolveCredentials({ storageKeys })`
+     * uses internally — callers that need to know WHICH credential will actually
+     * be used (e.g. to clear the right one after a 401) call this directly
+     * instead of re-deriving the same order.
+     */
+    pickStorageKey(keys: string[]): Promise<string | undefined>;
     /**
      * True if the user has any usable auth for the logical provider. For
      * `moonshot` this is satisfied by either the Kimi OAuth credential or the
@@ -98,6 +115,14 @@ declare class AuthStorage {
     isStaticApiKey(provider: string): Promise<boolean>;
     load(): Promise<void>;
     private ensureLoaded;
+    /**
+     * Force a re-read from disk, discarding the in-memory cache. Needed when
+     * another process mutates the auth file out-of-band — e.g. the desktop app
+     * writes API keys natively (Rust → ~/.ezcoder/auth.json) without going through
+     * this instance, so a long-lived daemon's cache would otherwise stay stale and
+     * never see a newly added provider key.
+     */
+    reload(): Promise<void>;
     getCredentials(provider: string): Promise<OAuthCredentials | undefined>;
     setCredentials(provider: string, creds: OAuthCredentials): Promise<void>;
     clearCredentials(provider: string): Promise<void>;
@@ -110,6 +135,7 @@ declare class AuthStorage {
      */
     resolveCredentials(provider: string, opts?: {
         forceRefresh?: boolean;
+        storageKeys?: string[];
     }): Promise<OAuthCredentials>;
     /**
      * Returns a valid access token, auto-refreshing if expired.
@@ -356,4 +382,4 @@ interface AutoUpdater {
 }
 declare function createAutoUpdater(config: AutoUpdateConfig): AutoUpdater;
 
-export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, type InlineButton, type LogLevel, MOONSHOT_OAUTH_KEY, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, type ProgressCallback, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, closeLogger, createAutoUpdater, decodeOggOpus, downmixToMono, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, isKimiCodingEndpoint, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, openLog, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, registerLogCleanup, resample, setProgressCallback, transcribeVoice, withFileLock };
+export { AuthStorage, type AutoUpdateConfig, type AutoUpdater, type InlineButton, type LogLevel, MOONSHOT_OAUTH_KEY, NotLoggedInError, type OAuthCredentials, type OAuthLoginCallbacks, type ProgressCallback, TelegramBot, type TelegramConfig, type TelegramMessage, type TelegramUpdate, type TelegramVoiceMessage, XIAOMI_CREDITS_KEY, closeLogger, createAutoUpdater, decodeOggOpus, downmixToMono, generatePKCE, getClaudeCliUserAgent, getClaudeCodeVersion, getNextThinkingLevel, getSessionId, getSupportedThinkingLevels, isKimiCodingEndpoint, isLoggerOpen, isModelLoaded, isThinkingLevelSupported, kimiCodeBaseUrl, kimiCodingHeaders, log, loginAnthropic, loginGemini, loginKimi, loginOpenAI, openLog, refreshAnthropicToken, refreshGeminiToken, refreshKimiToken, refreshOpenAIToken, registerLogCleanup, resample, setProgressCallback, transcribeVoice, withFileLock };