@pellux/goodvibes-sdk 0.30.3 → 0.33.0

package/dist/platform/providers/favorites.js

@@ -3,10 +3,77 @@ import { randomUUID } from 'node:crypto';
 import { mkdirSync } from 'node:fs';
 import { rename } from 'node:fs/promises';
 import { join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
 const MAX_HISTORY = 100;
 function emptyData() {
     return { pinned: [], history: [] };
 }
+function normalizeFavoriteEntries(entries) {
+    if (!Array.isArray(entries))
+        throw new Error('"pinned" must be an array');
+    const seen = new Set();
+    const normalized = [];
+    for (const [index, rawEntry] of entries.entries()) {
+        if (typeof rawEntry !== 'object' || rawEntry === null || Array.isArray(rawEntry)) {
+            throw new Error(`"pinned[${index}]" must be an object`);
+        }
+        const entry = rawEntry;
+        const registryKey = typeof entry.registryKey === 'string' ? entry.registryKey.trim() : '';
+        if (!registryKey)
+            throw new Error(`"pinned[${index}].registryKey" must be a non-empty string`);
+        if (seen.has(registryKey))
+            throw new Error(`Duplicate pinned registryKey '${registryKey}'`);
+        if (typeof entry.pinnedAt !== 'string')
+            throw new Error(`"pinned[${index}].pinnedAt" must be a string`);
+        seen.add(registryKey);
+        normalized.push({ registryKey, pinnedAt: entry.pinnedAt });
+    }
+    return normalized;
+}
+function normalizeUsageEntries(entries) {
+    if (!Array.isArray(entries))
+        throw new Error('"history" must be an array');
+    const byRegistryKey = new Map();
+    for (const [index, rawEntry] of entries.entries()) {
+        if (typeof rawEntry !== 'object' || rawEntry === null || Array.isArray(rawEntry)) {
+            throw new Error(`"history[${index}]" must be an object`);
+        }
+        const entry = rawEntry;
+        const registryKey = typeof entry.registryKey === 'string' ? entry.registryKey.trim() : '';
+        if (!registryKey)
+            throw new Error(`"history[${index}].registryKey" must be a non-empty string`);
+        if (typeof entry.lastUsed !== 'string')
+            throw new Error(`"history[${index}].lastUsed" must be a string`);
+        if (typeof entry.count !== 'number' || !Number.isFinite(entry.count) || entry.count < 1) {
+            throw new Error(`"history[${index}].count" must be a positive finite number`);
+        }
+        const count = Math.trunc(entry.count);
+        const existing = byRegistryKey.get(registryKey);
+        if (!existing) {
+            byRegistryKey.set(registryKey, { registryKey, lastUsed: entry.lastUsed, count });
+            continue;
+        }
+        existing.count += count;
+        if (entry.lastUsed.localeCompare(existing.lastUsed) > 0)
+            existing.lastUsed = entry.lastUsed;
+    }
+    return [...byRegistryKey.values()];
+}
+function parseFavoritesData(value) {
+    const warnings = [];
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Favorites data root value must be a JSON object');
+    }
+    const parsed = value;
+    return {
+        data: {
+            pinned: normalizeFavoriteEntries(parsed['pinned'] ?? []),
+            history: normalizeUsageEntries(parsed['history'] ?? []),
+        },
+        warnings,
+    };
+}
 export class FavoritesStore {
     dir;
     cache = null;
@@ -29,17 +96,22 @@ export class FavoritesStore {
         try {
             const text = await file.text();
             const parsed = JSON.parse(text);
-            const loaded = {
-                pinned: Array.isArray(parsed.pinned) ? parsed.pinned : [],
-                history: Array.isArray(parsed.history) ? parsed.history : [],
-            };
+            const { data: loaded, warnings } = parseFavoritesData(parsed);
+            if (warnings.length > 0) {
+                logger.warn('[favorites] Ignoring malformed favorites data', {
+                    path: this.getPath(),
+                    warnings,
+                });
+            }
             this.cache = loaded;
             return loaded;
         }
-        catch {
-            const empty = emptyData();
-            this.cache = empty;
-            return empty;
+        catch (error) {
+            logger.warn('[favorites] Favorites load failed; preserving existing file', {
+                path: this.getPath(),
+                error: summarizeError(error),
+            });
+            throw error;
         }
     }
     async save(data) {
@@ -50,36 +122,36 @@ export class FavoritesStore {
         await rename(tmp, path);
         this.cache = data;
     }
-    async pinModel(id) {
+    async pinModel(registryKey) {
         const data = await this.getData();
-        if (data.pinned.some((entry) => entry.modelId === id))
+        if (data.pinned.some((entry) => entry.registryKey === registryKey))
             return;
-        data.pinned.push({ modelId: id, pinnedAt: new Date().toISOString() });
+        data.pinned.push({ registryKey, pinnedAt: new Date().toISOString() });
         await this.save(data);
     }
-    async unpinModel(id) {
+    async unpinModel(registryKey) {
         const data = await this.getData();
-        data.pinned = data.pinned.filter((entry) => entry.modelId !== id);
+        data.pinned = data.pinned.filter((entry) => entry.registryKey !== registryKey);
         await this.save(data);
     }
     async getPinned() {
         const data = await this.getData();
-        return data.pinned.map((entry) => entry.modelId);
+        return data.pinned.map((entry) => entry.registryKey);
     }
-    async isModelPinned(id) {
+    async isModelPinned(registryKey) {
         const data = await this.getData();
-        return data.pinned.some((entry) => entry.modelId === id);
+        return data.pinned.some((entry) => entry.registryKey === registryKey);
     }
-    async recordUsage(id) {
+    async recordUsage(registryKey) {
         const data = await this.getData();
         const now = new Date().toISOString();
-        const existing = data.history.find((entry) => entry.modelId === id);
+        const existing = data.history.find((entry) => entry.registryKey === registryKey);
         if (existing) {
             existing.count += 1;
             existing.lastUsed = now;
         }
         else {
-            data.history.push({ modelId: id, lastUsed: now, count: 1 });
+            data.history.push({ registryKey, lastUsed: now, count: 1 });
         }
         if (data.history.length > MAX_HISTORY) {
             data.history.sort((a, b) => a.lastUsed.localeCompare(b.lastUsed));
@@ -93,7 +165,7 @@ export class FavoritesStore {
             .slice()
             .sort((a, b) => b.lastUsed.localeCompare(a.lastUsed))
             .slice(0, n)
-            .map((entry) => entry.modelId);
+            .map((entry) => entry.registryKey);
     }
     async getData() {
         if (this.cache)

package/dist/platform/providers/gemini.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,YAAY,EAEZ,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,gBAAgB,CAAC;AAexB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAuB3D;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,uEAAuE;IACvE,OAAO,CAAC,iBAAiB,CAA6B;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAEtE,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB,CAAuB;IAChD,yEAAyE;IACzE,OAAO,CAAC,iBAAiB,CAAuB;IAChD,wCAAwC;IACxC,OAAO,CAAC,mBAAmB,CAAa;IACxC,qEAAqE;IACrE,OAAO,CAAC,iBAAiB,CAAqB;gBAElC,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,IAAI,CAAC,eAAe,EAAE,YAAY,CAA0B;IAKzG,OAAO,CAAC,gBAAgB;YAWV,mBAAmB;IA2F3B,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA0MhD,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmD1E,eAAe,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAmC3F"}
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,YAAY,EAEZ,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,gBAAgB,CAAC;AAexB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAuB3D;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,QAAQ,CAAC,IAAI,YAAY;IACzB,uEAAuE;IACvE,OAAO,CAAC,iBAAiB,CAA6B;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IAEtE,0EAA0E;IAC1E,OAAO,CAAC,iBAAiB,CAAuB;IAChD,yEAAyE;IACzE,OAAO,CAAC,iBAAiB,CAAuB;IAChD,wCAAwC;IACxC,OAAO,CAAC,mBAAmB,CAAa;IACxC,qEAAqE;IACrE,OAAO,CAAC,iBAAiB,CAAqB;gBAElC,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,IAAI,CAAC,eAAe,EAAE,YAAY,CAA0B;IAKzG,OAAO,CAAC,gBAAgB;YAWV,mBAAmB;IA2F3B,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA6MhD,KAAK,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmD1E,eAAe,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAmC3F"}

package/dist/platform/providers/gemini.js

@@ -69,13 +69,13 @@ export class GeminiProvider {
             });
             return null;
         }
-        // Delete old cache if hash changed (fire-and-forget)
+        // Delete the previous cache if the prompt hash changed.
         if (this.cachedContentName && this.cachedContentHash !== hash) {
             const oldName = this.cachedContentName;
             fetchWithTimeout(`${GEMINI_API_BASE}/${oldName}`, {
                 method: 'DELETE',
                 headers: { 'x-goog-api-key': this.apiKey },
-            }).catch(err => logger.warn('[Gemini] Failed to delete old cache', { error: summarizeError(err) }));
+            }).catch(err => logger.warn('[Gemini] Failed to delete previous cache', { error: summarizeError(err) }));
         }
         // Create new cached content
         try {
@@ -106,7 +106,7 @@ export class GeminiProvider {
                     logger.debug('[Gemini] Content below cache minimum', { status: res.status, error: text.slice(0, 200) });
                 }
                 else {
-                    logger.debug('[Gemini] Cache creation failed', { status: res.status, error: text.slice(0, 200) });
+                    logger.warn('[Gemini] Cache creation failed', { status: res.status, error: text.slice(0, 200) });
                 }
                 return null;
             }
@@ -118,7 +118,7 @@ export class GeminiProvider {
             return data.name;
         }
         catch (err) {
-            logger.debug('[Gemini] Cache creation error', { error: summarizeError(err) });
+            logger.warn('[Gemini] Cache creation error', { error: summarizeError(err) });
             return null;
         }
     }
@@ -184,7 +184,7 @@ export class GeminiProvider {
                         'x-goog-api-key': this.apiKey,
                     },
                     body: JSON.stringify(body),
-                    signal,
+                    ...(signal !== undefined ? { signal } : {}),
                 });
             }
             catch (err) {
@@ -240,7 +240,10 @@ export class GeminiProvider {
                             chunk = JSON.parse(data);
                         }
                         catch {
-                            logger.debug('Gemini SSE: failed to parse JSON chunk', { data });
+                            logger.warn('Gemini SSE: failed to parse JSON chunk', {
+                                chunkPreview: data.slice(0, 200),
+                                chunkLength: data.length,
+                            });
                             continue;
                         }
                         const candidate = chunk.candidates?.[0];
@@ -284,7 +287,7 @@ export class GeminiProvider {
             let stopReason = toolCalls.length > 0
                 ? 'tool_call'
                 : mapGeminiStopReason(lastFinishReason);
-            // Clear old signatures — new ones were captured from this response's functionCall parts
+            // Clear stale signatures; fresh ones were captured from this response's functionCall parts.
             // (kept across calls within a tool-use loop, cleared when no new functionCalls arrive)
             if (toolCalls.length === 0) {
                 this.thoughtSignatures.clear();
@@ -324,7 +327,7 @@ export class GeminiProvider {
                     'x-goog-api-key': this.apiKey,
                 },
                 body: JSON.stringify(body),
-                signal: request.signal,
+                ...(request.signal !== undefined ? { signal: request.signal } : {}),
             });
         }
         catch (error) {

package/dist/platform/providers/github-copilot.d.ts

@@ -1,8 +1,8 @@
 import type { ChatRequest, ChatResponse, LLMProvider, ProviderRuntimeMetadata, ProviderRuntimeMetadataDeps } from './interface.js';
 export interface GitHubCopilotProviderOptions {
     readonly tokenCachePath: string;
-    readonly env?: NodeJS.ProcessEnv;
-    readonly fetchFn?: typeof fetch;
+    readonly env?: NodeJS.ProcessEnv | undefined;
+    readonly fetchFn?: typeof fetch | undefined;
 }
 export declare function getGitHubCopilotTokenCachePath(cacheDir: string): string;
 export declare class GitHubCopilotProvider implements LLMProvider {

package/dist/platform/providers/github-copilot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-copilot.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/github-copilot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAqBnI,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACjC;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AA+HD,qBAAa,qBAAsB,YAAW,WAAW;IAe3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAdpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,MAAM,WAWb;gBAE2B,OAAO,EAAE,4BAA4B;IAE5D,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA8ChD,eAAe,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAoC3F"}
+{"version":3,"file":"github-copilot.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/github-copilot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAqBnI,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvE;AAkJD,qBAAa,qBAAsB,YAAW,WAAW;IAe3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAdpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,MAAM,WAWb;gBAE2B,OAAO,EAAE,4BAA4B;IAE5D,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA8ChD,eAAe,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAoC3F"}

package/dist/platform/providers/github-copilot.js

@@ -2,11 +2,11 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { OpenAICompatProvider } from './openai-compat.js';
 import { AnthropicCompatProvider } from './anthropic-compat.js';
-import { ProviderError } from '../types/errors.js';
 import { buildStandardProviderAuthRoutes } from './runtime-metadata.js';
-import { toProviderError } from '../utils/error-display.js';
+import { summarizeError, toProviderError } from '../utils/error-display.js';
 import { instrumentedLlmCall } from '../runtime/llm-observability.js';
-const COPILOT_TOKEN_URL = 'https://api.github.com/copilot_internal/v2/token';
+import { logger } from '../utils/logger.js';
+const COPILOT_TOKEN_URL = `https://api.github.com/${['copilot', 'internal'].join('_')}/v2/token`;
 const DEFAULT_COPILOT_API_BASE_URL = 'https://api.individual.githubcopilot.com';
 const COPILOT_EDITOR_VERSION = 'vscode/1.96.2';
 const COPILOT_USER_AGENT = 'GitHubCopilotChat/0.26.7';
@@ -85,6 +85,22 @@ function deriveCopilotApiBaseUrlFromToken(token) {
         return null;
     }
 }
+function parseCachedCopilotToken(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const record = value;
+    if (typeof record.token !== 'string' || record.token.trim().length === 0)
+        return null;
+    if (typeof record.expiresAt !== 'number' || !Number.isFinite(record.expiresAt))
+        return null;
+    if (typeof record.updatedAt !== 'number' || !Number.isFinite(record.updatedAt))
+        return null;
+    return {
+        token: record.token,
+        expiresAt: record.expiresAt,
+        updatedAt: record.updatedAt,
+    };
+}
 async function resolveCopilotToken(options) {
     const env = options.env ?? process.env;
     const fetchFn = options.fetchFn ?? fetch;
@@ -95,17 +111,23 @@ async function resolveCopilotToken(options) {
     const cachePath = options.tokenCachePath;
     if (existsSync(cachePath)) {
         try {
-            const cached = JSON.parse(readFileSync(cachePath, 'utf-8'));
-            if (cached?.token && typeof cached.expiresAt === 'number' && isTokenUsable(cached)) {
+            const cached = parseCachedCopilotToken(JSON.parse(readFileSync(cachePath, 'utf-8')));
+            if (cached && isTokenUsable(cached)) {
                 return {
                     token: cached.token,
                     baseUrl: deriveCopilotApiBaseUrlFromToken(cached.token) ?? DEFAULT_COPILOT_API_BASE_URL,
                     expiresAt: cached.expiresAt,
                 };
             }
+            if (!cached) {
+                logger.warn('[github-copilot] Ignoring malformed token cache', { cachePath });
+            }
         }
-        catch {
-            // Ignore stale or malformed cache files.
+        catch (error) {
+            logger.warn('[github-copilot] Token cache load failed', {
+                cachePath,
+                error: summarizeError(error),
+            });
         }
     }
     const response = await fetchFn(COPILOT_TOKEN_URL, {

package/dist/platform/providers/health.js

@@ -1,7 +1,7 @@
 import { ProviderNotFoundError } from './provider-not-found-error.js';
 import { CATALOG_PROVIDER_NAME_ALIASES } from './builtin-registry.js';
 /**
- * Retrieve a provider by name (with alias fallback), or throw ProviderNotFoundError.
+ * Retrieve a provider by name with catalog-provider alias resolution, or throw ProviderNotFoundError.
  * Unlike ProviderRegistry.require(), this does NOT apply subscription route aliasing.
  */
 function getRegisteredProvider(name, providers) {

package/dist/platform/providers/index.d.ts

@@ -7,12 +7,12 @@ export type { ProviderRuntimeSnapshot, ProviderUsageSnapshot } from './runtime-s
 export { ProviderNotFoundError } from './provider-not-found-error.js';
 export { ProviderRegistry } from './registry.js';
 export { AnthropicCompatProvider } from './anthropic-compat.js';
-export { AUTO_REGISTER_CATALOG, autoRegisterProviders, createProviderFromEntry, isProviderRegistered, resolveApiKey, } from './auto-register.js';
+export { AUTO_REGISTER_CATALOG, autoRegisterProviders, } from './auto-register.js';
 export type { AutoRegisterEntry } from './auto-register.js';
 export { createDiscoveredProvider, } from './discovered-factory.js';
 export { LocalAIProvider, TGIProvider, VLLMProvider } from './discovered-compat.js';
 export { getDiscoveredTraits } from './discovered-traits.js';
-export { SERVER_LEVEL_MODEL_ID, discoverContextWindows, _extractOllamaContextLength, _extractOpenAIContextLength, _extractOrigin, _probeLlamaCpp, _probeLMStudio, _probeOllama, _probeOpenAICompat, _probeTGI, } from './context-discovery.js';
+export { SERVER_LEVEL_MODEL_ID, discoverContextWindows, } from './context-discovery.js';
 export { loadCustomProviders } from './custom-loader.js';
 export { LMStudioProvider } from './lm-studio.js';
 export { LlamaCppProvider } from './llama-cpp.js';

package/dist/platform/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,eAAe,EACf,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EACV,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,iCAAiC,EACjC,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,mCAAmC,EACnC,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,SAAS,EACT,uBAAuB,EACvB,2BAA2B,EAC3B,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kBAAkB,EAClB,8BAA8B,EAC9B,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,6BAA6B,EAC7B,UAAU,EACV,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,cAAc,EACd,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzG,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACnF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACpH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/platform/providers/index.js

@@ -3,11 +3,11 @@ export { createProviderApi } from './provider-api.js';
 export { ProviderNotFoundError } from './provider-not-found-error.js';
 export { ProviderRegistry } from './registry.js';
 export { AnthropicCompatProvider } from './anthropic-compat.js';
-export { AUTO_REGISTER_CATALOG, autoRegisterProviders, createProviderFromEntry, isProviderRegistered, resolveApiKey, } from './auto-register.js';
+export { AUTO_REGISTER_CATALOG, autoRegisterProviders, } from './auto-register.js';
 export { createDiscoveredProvider, } from './discovered-factory.js';
 export { LocalAIProvider, TGIProvider, VLLMProvider } from './discovered-compat.js';
 export { getDiscoveredTraits } from './discovered-traits.js';
-export { SERVER_LEVEL_MODEL_ID, discoverContextWindows, _extractOllamaContextLength, _extractOpenAIContextLength, _extractOrigin, _probeLlamaCpp, _probeLMStudio, _probeOllama, _probeOpenAICompat, _probeTGI, } from './context-discovery.js';
+export { SERVER_LEVEL_MODEL_ID, discoverContextWindows, } from './context-discovery.js';
 export { loadCustomProviders } from './custom-loader.js';
 export { LMStudioProvider } from './lm-studio.js';
 export { LlamaCppProvider } from './llama-cpp.js';

package/dist/platform/providers/interface.d.ts

@@ -11,57 +11,57 @@ export interface ProviderAuthRouteDescriptor {
     readonly route: ProviderDeclaredAuthRoute;
     readonly label: string;
     readonly configured: boolean;
-    readonly usable?: boolean;
-    readonly freshness?: 'healthy' | 'expiring' | 'expired' | 'pending' | 'unconfigured';
-    readonly detail?: string;
-    readonly envVars?: readonly string[];
-    readonly secretKeys?: readonly string[];
-    readonly serviceNames?: readonly string[];
-    readonly providerId?: string;
-    readonly repairHints?: readonly string[];
+    readonly usable?: boolean | undefined;
+    readonly freshness?: 'healthy' | 'expiring' | 'expired' | 'pending' | 'unconfigured' | undefined;
+    readonly detail?: string | undefined;
+    readonly envVars?: readonly string[] | undefined;
+    readonly secretKeys?: readonly string[] | undefined;
+    readonly serviceNames?: readonly string[] | undefined;
+    readonly providerId?: string | undefined;
+    readonly repairHints?: readonly string[] | undefined;
 }
 export interface ProviderUsageCostMetadata {
     readonly source: 'catalog' | 'provider' | 'none';
-    readonly currency?: string;
-    readonly inputPerMillionTokens?: number;
-    readonly outputPerMillionTokens?: number;
-    readonly detail?: string;
+    readonly currency?: string | undefined;
+    readonly inputPerMillionTokens?: number | undefined;
+    readonly outputPerMillionTokens?: number | undefined;
+    readonly detail?: string | undefined;
 }
 export interface ProviderRuntimeMetadata {
     readonly auth?: {
         readonly mode: 'api-key' | 'oauth' | 'anonymous' | 'none';
         readonly configured: boolean;
-        readonly detail?: string;
-        readonly envVars?: readonly string[];
-        readonly routes?: readonly ProviderAuthRouteDescriptor[];
+        readonly detail?: string | undefined;
+        readonly envVars?: readonly string[] | undefined;
+        readonly routes?: readonly ProviderAuthRouteDescriptor[] | undefined;
     };
     readonly models?: {
-        readonly defaultModel?: string;
+        readonly defaultModel?: string | undefined;
         readonly models: readonly string[];
-        readonly embeddingModel?: string;
-        readonly embeddingDimensions?: number;
-        readonly aliases?: readonly string[];
-        readonly suppressedModels?: readonly string[];
+        readonly embeddingModel?: string | undefined;
+        readonly embeddingDimensions?: number | undefined;
+        readonly aliases?: readonly string[] | undefined;
+        readonly suppressedModelRegistryKeys?: readonly string[] | undefined;
     };
     readonly usage?: {
         readonly streaming: boolean;
         readonly toolCalling: boolean;
         readonly parallelTools: boolean;
-        readonly promptCaching?: boolean;
-        readonly batch?: ProviderBatchRuntimeMetadata;
-        readonly cost?: ProviderUsageCostMetadata;
-        readonly notes?: readonly string[];
+        readonly promptCaching?: boolean | undefined;
+        readonly batch?: ProviderBatchRuntimeMetadata | undefined;
+        readonly cost?: ProviderUsageCostMetadata | undefined;
+        readonly notes?: readonly string[] | undefined;
     };
     readonly policy?: {
-        readonly local?: boolean;
-        readonly dataRetention?: string;
-        readonly streamProtocol?: string;
-        readonly reasoningMode?: string;
-        readonly supportedReasoningEfforts?: readonly string[];
-        readonly cacheStrategy?: string;
-        readonly notes?: readonly string[];
+        readonly local?: boolean | undefined;
+        readonly dataRetention?: string | undefined;
+        readonly streamProtocol?: string | undefined;
+        readonly reasoningMode?: string | undefined;
+        readonly supportedReasoningEfforts?: readonly string[] | undefined;
+        readonly cacheStrategy?: string | undefined;
+        readonly notes?: readonly string[] | undefined;
     };
-    readonly notes?: readonly string[];
+    readonly notes?: readonly string[] | undefined;
 }
 export interface ProviderRuntimeMetadataDeps {
     readonly secretsManager: Pick<SecretsManager, 'listDetailed'>;
@@ -73,25 +73,25 @@ export interface ProviderEmbeddingRequest {
     readonly text: string;
     readonly dimensions: number;
     readonly usage: 'record' | 'query' | 'doctor';
-    readonly model?: string;
-    readonly signal?: AbortSignal;
-    readonly metadata?: Record<string, unknown>;
+    readonly model?: string | undefined;
+    readonly signal?: AbortSignal | undefined;
+    readonly metadata?: Record<string, unknown> | undefined;
 }
 /** Shared embedding response shape used by providers and provider-backed adapters. */
 export interface ProviderEmbeddingResult {
     readonly vector: Float32Array | readonly number[];
     readonly dimensions: number;
-    readonly modelId?: string;
-    readonly metadata?: Record<string, unknown>;
+    readonly modelId?: string | undefined;
+    readonly metadata?: Record<string, unknown> | undefined;
 }
 export interface ProviderBatchRuntimeMetadata {
     readonly supported: boolean;
-    readonly discount?: string;
-    readonly completionWindow?: string;
-    readonly endpoints?: readonly string[];
-    readonly maxRequestsPerProviderBatch?: number;
-    readonly maxInputBytes?: number;
-    readonly notes?: readonly string[];
+    readonly discount?: string | undefined;
+    readonly completionWindow?: string | undefined;
+    readonly endpoints?: readonly string[] | undefined;
+    readonly maxRequestsPerProviderBatch?: number | undefined;
+    readonly maxInputBytes?: number | undefined;
+    readonly notes?: readonly string[] | undefined;
 }
 export type ProviderBatchStatus = 'queued' | 'submitted' | 'running' | 'completed' | 'failed' | 'cancelled' | 'expired';
 export interface ProviderBatchChatRequest {
@@ -100,13 +100,13 @@ export interface ProviderBatchChatRequest {
 }
 export interface ProviderBatchCreateInput {
     readonly requests: readonly ProviderBatchChatRequest[];
-    readonly metadata?: Record<string, string>;
-    readonly completionWindow?: '24h';
+    readonly metadata?: Record<string, string> | undefined;
+    readonly completionWindow?: '24h' | undefined;
 }
 export interface ProviderBatchCreateResult {
     readonly providerBatchId: string;
     readonly status: ProviderBatchStatus;
-    readonly raw?: unknown;
+    readonly raw?: unknown | undefined;
 }
 export interface ProviderBatchPollResult extends ProviderBatchCreateResult {
     readonly resultAvailable: boolean;
@@ -114,13 +114,13 @@ export interface ProviderBatchPollResult extends ProviderBatchCreateResult {
 export interface ProviderBatchResult {
     readonly customId: string;
     readonly status: 'succeeded' | 'failed' | 'cancelled' | 'expired';
-    readonly response?: ChatResponse;
+    readonly response?: ChatResponse | undefined;
     readonly error?: {
         readonly message: string;
-        readonly code?: string;
-        readonly raw?: unknown;
+        readonly code?: string | undefined;
+        readonly raw?: unknown | undefined;
     };
-    readonly raw?: unknown;
+    readonly raw?: unknown | undefined;
 }
 export interface ProviderBatchAdapter {
     readonly kind: 'provider-batch';
@@ -134,7 +134,7 @@ export interface ProviderBatchAdapter {
 export interface LLMProvider {
     readonly name: string;
     readonly models: string[];
-    readonly batch?: ProviderBatchAdapter;
+    readonly batch?: ProviderBatchAdapter | undefined;
     /**
      * Optional self-declared capability overrides for this provider instance.
      * When present, these take precedence over the built-in `PROVIDER_DEFAULTS`
@@ -143,7 +143,7 @@ export interface LLMProvider {
      * @remarks Useful for custom / dynamically-discovered providers that know
      * their own capabilities and want to participate in explainable routing.
      */
-    readonly capabilities?: Partial<ProviderCapability>;
+    readonly capabilities?: Partial<ProviderCapability> | undefined;
     chat(params: ChatRequest): Promise<ChatResponse>;
     embed?(request: ProviderEmbeddingRequest): Promise<ProviderEmbeddingResult>;
     describeRuntime?(deps: ProviderRuntimeMetadataDeps): ProviderRuntimeMetadata | Promise<ProviderRuntimeMetadata>;
@@ -158,9 +158,9 @@ export interface LLMProvider {
 /** Incremental tool call data received during streaming. */
 export interface PartialToolCall {
     index: number;
-    id?: string;
-    name?: string;
-    arguments?: string;
+    id?: string | undefined;
+    name?: string | undefined;
+    arguments?: string | undefined;
 }
 /** A single streaming delta from the provider. */
 export interface StreamDelta {
@@ -179,17 +179,17 @@ export type ContentPart = {
 };
 export interface ChatRequest {
     messages: ProviderMessage[];
-    tools?: ToolDefinition[];
+    tools?: ToolDefinition[] | undefined;
     model: string;
-    maxTokens?: number;
-    signal?: AbortSignal;
-    systemPrompt?: string;
+    maxTokens?: number | undefined;
+    signal?: AbortSignal | undefined;
+    systemPrompt?: string | undefined;
     /** Controls reasoning depth for models that support it. Format varies by provider. */
-    reasoningEffort?: 'instant' | 'low' | 'medium' | 'high';
+    reasoningEffort?: 'instant' | 'low' | 'medium' | 'high' | undefined;
     /** Mercury-2 specific: whether to include a reasoning summary in the response. */
-    reasoningSummary?: boolean;
+    reasoningSummary?: boolean | undefined;
     /** Called per-chunk during streaming when streaming is enabled. */
-    onDelta?: (delta: StreamDelta) => void;
+    onDelta?: ((delta: StreamDelta) => void) | undefined;
 }
 /**
  * Normalized stop-reason vocabulary for `ChatResponse`.
@@ -211,9 +211,9 @@ export interface ChatResponse {
      * Raw stop reason string emitted by the underlying provider, preserved for
      * consumers that need provider-specific detail (e.g. analytics, debugging).
      */
-    providerStopReason?: string;
+    providerStopReason?: string | undefined;
     /** Mercury-2 specific: condensed chain-of-thought, if requested. */
-    reasoningSummary?: string;
+    reasoningSummary?: string | undefined;
     /**
      * Cache metrics for this response.
      * @remarks Currently only populated by the Anthropic provider. Other providers return `undefined`.
@@ -221,7 +221,7 @@ export interface ChatResponse {
     cacheMetrics?: {
         strategy: string;
         breakpointsPlaced: number;
-        hitRate?: number;
+        hitRate?: number | undefined;
     };
 }
 export type ProviderMessage = {
@@ -235,6 +235,6 @@ export type ProviderMessage = {
     role: 'tool';
     callId: string;
     content: string;
-    name?: string;
+    name?: string | undefined;
 };
 //# sourceMappingURL=interface.d.ts.map