@polpo-ai/llm 0.5.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenPolpo Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/api-keys.d.ts

@@ -0,0 +1,28 @@
+/**
+ * API key resolution for LLM providers.
+ *
+ * Resolves API keys from environment variables using the canonical
+ * PROVIDER_ENV_MAP from @polpo-ai/core.
+ */
+export { PROVIDER_ENV_MAP } from "@polpo-ai/core";
+/**
+ * Resolve API key for a provider (synchronous).
+ * Reads from process.env using the PROVIDER_ENV_MAP.
+ */
+export declare function resolveApiKey(provider: string): string | undefined;
+/**
+ * Resolve API key for a provider (async, full resolution chain).
+ * Priority: 1) polpo.json overrides (if they had apiKey), 2) env var lookup, 3) stored OAuth profiles.
+ *
+ * Returns the API key from env vars or provider config.
+ */
+export declare function resolveApiKeyAsync(provider: string): Promise<string | undefined>;
+/**
+ * Check if there are any stored OAuth profiles for a provider (synchronous).
+ * Used by the sync validation path so OAuth-based providers (openai-codex,
+ * github-copilot, anthropic, etc.) aren't rejected before spawn.
+ *
+ * Reads auth-profiles.json directly to stay synchronous in ESM context.
+ */
+export declare function hasOAuthProfiles(provider: string): boolean;
+//# sourceMappingURL=api-keys.d.ts.map

package/dist/api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../src/api-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIlE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEtF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAa1D"}

package/dist/api-keys.js

@@ -0,0 +1,54 @@
+/**
+ * API key resolution for LLM providers.
+ *
+ * Resolves API keys from environment variables using the canonical
+ * PROVIDER_ENV_MAP from @polpo-ai/core.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// Re-export the canonical env map from @polpo-ai/core.
+export { PROVIDER_ENV_MAP } from "@polpo-ai/core";
+import { PROVIDER_ENV_MAP } from "@polpo-ai/core";
+/**
+ * Resolve API key for a provider (synchronous).
+ * Reads from process.env using the PROVIDER_ENV_MAP.
+ */
+export function resolveApiKey(provider) {
+    const envVar = PROVIDER_ENV_MAP[provider];
+    if (!envVar)
+        return undefined;
+    return process.env[envVar] || undefined;
+}
+/**
+ * Resolve API key for a provider (async, full resolution chain).
+ * Priority: 1) polpo.json overrides (if they had apiKey), 2) env var lookup, 3) stored OAuth profiles.
+ *
+ * Returns the API key from env vars or provider config.
+ */
+export async function resolveApiKeyAsync(provider) {
+    return resolveApiKey(provider);
+}
+/**
+ * Check if there are any stored OAuth profiles for a provider (synchronous).
+ * Used by the sync validation path so OAuth-based providers (openai-codex,
+ * github-copilot, anthropic, etc.) aren't rejected before spawn.
+ *
+ * Reads auth-profiles.json directly to stay synchronous in ESM context.
+ */
+export function hasOAuthProfiles(provider) {
+    try {
+        const globalPolpoDir = join(homedir(), ".polpo");
+        const profilePath = join(globalPolpoDir, "auth-profiles.json");
+        if (!existsSync(profilePath))
+            return false;
+        const data = JSON.parse(readFileSync(profilePath, "utf-8"));
+        if (!data?.profiles)
+            return false;
+        return Object.values(data.profiles).some((p) => p.provider === provider);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=api-keys.js.map

package/dist/api-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.js","sourceRoot":"","sources":["../src/api-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,EAAE,QAAQ;YAAE,OAAO,KAAK,CAAC;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CACtC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CACpC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/cooldown.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Provider cooldown / failback logic.
+ *
+ * Tracks provider-level errors and applies exponential backoff cooldowns
+ * to avoid hammering failing providers.
+ */
+/**
+ * Check if a provider is currently in cooldown.
+ */
+export declare function isProviderInCooldown(provider: string): boolean;
+/**
+ * Mark a provider as temporarily unavailable (cooldown).
+ */
+export declare function markProviderCooldown(provider: string, reason?: string): void;
+/**
+ * Clear cooldown for a provider (e.g. after successful call).
+ */
+export declare function clearProviderCooldown(provider: string): void;
+/**
+ * Get current cooldown state for all providers.
+ */
+export declare function getProviderCooldowns(): Record<string, {
+    until: number;
+    errorCount: number;
+    reason?: string;
+}>;
+/**
+ * Classify an error to determine if it should trigger cooldown or failover.
+ */
+export declare function classifyProviderError(err: unknown): {
+    shouldCooldown: boolean;
+    shouldFailover: boolean;
+    reason: string;
+};
+//# sourceMappingURL=cooldown.d.ts.map

package/dist/cooldown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldown.d.ts","sourceRoot":"","sources":["../src/cooldown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAW5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7G;AAID;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG;IACnD,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB,CA4CA"}

package/dist/cooldown.js

@@ -0,0 +1,97 @@
+/**
+ * Provider cooldown / failback logic.
+ *
+ * Tracks provider-level errors and applies exponential backoff cooldowns
+ * to avoid hammering failing providers.
+ */
+// ─── State ───────────────────────────────────────────
+const providerCooldowns = new Map();
+const COOLDOWN_STEPS = [60_000, 300_000, 1_500_000, 3_600_000]; // 1m, 5m, 25m, 1h
+// ─── Cooldown Management ─────────────────────────────
+/**
+ * Check if a provider is currently in cooldown.
+ */
+export function isProviderInCooldown(provider) {
+    const entry = providerCooldowns.get(provider);
+    if (!entry)
+        return false;
+    if (Date.now() >= entry.until) {
+        providerCooldowns.delete(provider);
+        return false;
+    }
+    return true;
+}
+/**
+ * Mark a provider as temporarily unavailable (cooldown).
+ */
+export function markProviderCooldown(provider, reason) {
+    const existing = providerCooldowns.get(provider);
+    const errorCount = (existing?.errorCount ?? 0) + 1;
+    const stepIdx = Math.min(errorCount - 1, COOLDOWN_STEPS.length - 1);
+    const cooldownMs = COOLDOWN_STEPS[stepIdx];
+    providerCooldowns.set(provider, {
+        until: Date.now() + cooldownMs,
+        errorCount,
+        reason,
+    });
+}
+/**
+ * Clear cooldown for a provider (e.g. after successful call).
+ */
+export function clearProviderCooldown(provider) {
+    providerCooldowns.delete(provider);
+}
+/**
+ * Get current cooldown state for all providers.
+ */
+export function getProviderCooldowns() {
+    const result = {};
+    for (const [provider, entry] of providerCooldowns) {
+        if (Date.now() < entry.until) {
+            result[provider] = { ...entry };
+        }
+    }
+    return result;
+}
+// ─── Error Classification ────────────────────────────
+/**
+ * Classify an error to determine if it should trigger cooldown or failover.
+ */
+export function classifyProviderError(err) {
+    if (!(err instanceof Error)) {
+        return { shouldCooldown: false, shouldFailover: false, reason: "unknown" };
+    }
+    const msg = err.message.toLowerCase();
+    // Auth errors — cooldown + failover
+    if (msg.includes("401") || msg.includes("unauthorized") || msg.includes("invalid api key") ||
+        msg.includes("authentication") || msg.includes("forbidden") || msg.includes("403")) {
+        return { shouldCooldown: true, shouldFailover: true, reason: "auth" };
+    }
+    // Rate limit — cooldown + failover
+    if (msg.includes("429") || msg.includes("rate limit") || msg.includes("too many requests") ||
+        msg.includes("quota exceeded")) {
+        return { shouldCooldown: true, shouldFailover: true, reason: "rate_limit" };
+    }
+    // Billing — long cooldown + failover
+    if (msg.includes("insufficient") || msg.includes("credit") || msg.includes("billing") ||
+        msg.includes("payment required") || msg.includes("402")) {
+        return { shouldCooldown: true, shouldFailover: true, reason: "billing" };
+    }
+    // Server errors — short cooldown, failover
+    if (msg.includes("500") || msg.includes("502") || msg.includes("503") || msg.includes("504") ||
+        msg.includes("overloaded") || msg.includes("service unavailable")) {
+        return { shouldCooldown: true, shouldFailover: true, reason: "server_error" };
+    }
+    // Transient network — no cooldown, retry
+    if (msg.includes("timeout") || msg.includes("econnreset") || msg.includes("econnrefused") ||
+        msg.includes("socket hang up")) {
+        return { shouldCooldown: false, shouldFailover: false, reason: "network" };
+    }
+    // Non-retryable errors (bad request, invalid model, etc.)
+    if (msg.includes("400") || msg.includes("invalid") || msg.includes("not found") ||
+        msg.includes("404")) {
+        return { shouldCooldown: false, shouldFailover: false, reason: "client_error" };
+    }
+    return { shouldCooldown: false, shouldFailover: false, reason: "unknown" };
+}
+//# sourceMappingURL=cooldown.js.map

package/dist/cooldown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldown.js","sourceRoot":"","sources":["../src/cooldown.ts"],"names":[],"mappings":"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"}

package/dist/cost.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Cost estimation for LLM calls.
+ *
+ * Calculates cost from AI SDK usage data and model pricing metadata.
+ */
+import type { LanguageModelUsage } from "ai";
+import type { ResolvedModel } from "./model-resolver.js";
+export type { LanguageModelUsage };
+export interface CostEstimate {
+    inputCost: number;
+    outputCost: number;
+    cacheReadCost: number;
+    cacheWriteCost: number;
+    totalCost: number;
+    currency: string;
+}
+/**
+ * Calculate the cost of an LLM call from AI SDK usage data.
+ * Uses pricing from the resolved model metadata.
+ * Returns cost in USD.
+ */
+export declare function estimateCost(model: ResolvedModel, usage: LanguageModelUsage): CostEstimate;
+//# sourceMappingURL=cost.d.ts.map

package/dist/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAInC,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAoB1F"}

package/dist/cost.js

@@ -0,0 +1,31 @@
+/**
+ * Cost estimation for LLM calls.
+ *
+ * Calculates cost from AI SDK usage data and model pricing metadata.
+ */
+// ─── Cost Calculation ────────────────────────────────
+/**
+ * Calculate the cost of an LLM call from AI SDK usage data.
+ * Uses pricing from the resolved model metadata.
+ * Returns cost in USD.
+ */
+export function estimateCost(model, usage) {
+    const inputTokens = usage.inputTokens ?? 0;
+    const outputTokens = usage.outputTokens ?? 0;
+    const cacheReadTokens = usage.inputTokenDetails?.cacheReadTokens ?? 0;
+    const cacheWriteTokens = usage.inputTokenDetails?.cacheWriteTokens ?? 0;
+    // Cost per token (pricing is per-token from gateway)
+    const inputCost = inputTokens * model.cost.input;
+    const outputCost = outputTokens * model.cost.output;
+    const cacheReadCost = cacheReadTokens * model.cost.cacheRead;
+    const cacheWriteCost = cacheWriteTokens * model.cost.cacheWrite;
+    return {
+        inputCost,
+        outputCost,
+        cacheReadCost,
+        cacheWriteCost,
+        totalCost: inputCost + outputCost + cacheReadCost + cacheWriteCost,
+        currency: "USD",
+    };
+}
+//# sourceMappingURL=cost.js.map

package/dist/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,wDAAwD;AAExD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,KAAyB;IAC1E,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;IAC7C,MAAM,eAAe,GAAG,KAAK,CAAC,iBAAiB,EAAE,eAAe,IAAI,CAAC,CAAC;IACtE,MAAM,gBAAgB,GAAG,KAAK,CAAC,iBAAiB,EAAE,gBAAgB,IAAI,CAAC,CAAC;IAExE,qDAAqD;IACrD,MAAM,SAAS,GAAG,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;IACjD,MAAM,UAAU,GAAG,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IACpD,MAAM,aAAa,GAAG,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;IAC7D,MAAM,cAAc,GAAG,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IAEhE,OAAO;QACL,SAAS;QACT,UAAU;QACV,aAAa;QACb,cAAc;QACd,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,cAAc;QAClE,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC"}

package/dist/gateway-catalog.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AI Gateway model catalog — fetching, caching, and querying.
+ *
+ * Uses the public AI Gateway endpoint to list available models and pricing.
+ * The catalog is fetched lazily and cached for 1 hour.
+ */
+import type { GatewayLanguageModelEntry } from "@ai-sdk/gateway";
+export type { GatewayLanguageModelEntry };
+/**
+ * Fetch and cache the AI Gateway model catalog.
+ * Uses the public endpoint (no auth required for listing).
+ */
+export declare function fetchCatalog(): Promise<GatewayLanguageModelEntry[]>;
+/**
+ * Get the cached catalog synchronously (returns empty array if not yet fetched).
+ * Triggers a background fetch if cache is stale.
+ */
+export declare function getCatalogSync(): GatewayLanguageModelEntry[];
+export interface ModelInfo {
+    id: string;
+    name: string;
+    provider: string;
+    reasoning: boolean;
+    input: string[];
+    contextWindow: number;
+    maxTokens: number;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+}
+//# sourceMappingURL=gateway-catalog.d.ts.map

package/dist/gateway-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-catalog.d.ts","sourceRoot":"","sources":["../src/gateway-catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAIjE,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAS1C;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA6BzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,yBAAyB,EAAE,CAO5D;AAID,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF"}

package/dist/gateway-catalog.js

@@ -0,0 +1,57 @@
+/**
+ * AI Gateway model catalog — fetching, caching, and querying.
+ *
+ * Uses the public AI Gateway endpoint to list available models and pricing.
+ * The catalog is fetched lazily and cached for 1 hour.
+ */
+// ─── Cached gateway catalog ──────────────────────────
+let catalogCache = null;
+let catalogFetchPromise = null;
+let catalogFetchedAt = 0;
+const CATALOG_TTL_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Fetch and cache the AI Gateway model catalog.
+ * Uses the public endpoint (no auth required for listing).
+ */
+export async function fetchCatalog() {
+    const now = Date.now();
+    if (catalogCache && now - catalogFetchedAt < CATALOG_TTL_MS) {
+        return catalogCache;
+    }
+    if (catalogFetchPromise && now - catalogFetchedAt < CATALOG_TTL_MS) {
+        return catalogFetchPromise;
+    }
+    catalogFetchPromise = (async () => {
+        try {
+            const resp = await fetch("https://ai-gateway.vercel.sh/v1/models");
+            if (!resp.ok) {
+                throw new Error(`Gateway catalog fetch failed: ${resp.status}`);
+            }
+            const data = (await resp.json());
+            const models = data.data ?? [];
+            catalogCache = models;
+            catalogFetchedAt = Date.now();
+            return models;
+        }
+        catch (err) {
+            // On failure, return stale cache if available
+            if (catalogCache)
+                return catalogCache;
+            throw err;
+        }
+    })();
+    return catalogFetchPromise;
+}
+/**
+ * Get the cached catalog synchronously (returns empty array if not yet fetched).
+ * Triggers a background fetch if cache is stale.
+ */
+export function getCatalogSync() {
+    const now = Date.now();
+    if (!catalogCache || now - catalogFetchedAt > CATALOG_TTL_MS) {
+        // Trigger background refresh — don't block
+        fetchCatalog().catch(() => { });
+    }
+    return catalogCache ?? [];
+}
+//# sourceMappingURL=gateway-catalog.js.map

package/dist/gateway-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-catalog.js","sourceRoot":"","sources":["../src/gateway-catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wDAAwD;AAExD,IAAI,YAAY,GAAuC,IAAI,CAAC;AAC5D,IAAI,mBAAmB,GAAgD,IAAI,CAAC;AAC5E,IAAI,gBAAgB,GAAG,CAAC,CAAC;AACzB,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAEhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,YAAY,IAAI,GAAG,GAAG,gBAAgB,GAAG,cAAc,EAAE,CAAC;QAC5D,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,mBAAmB,IAAI,GAAG,GAAG,gBAAgB,GAAG,cAAc,EAAE,CAAC;QACnE,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,mBAAmB,GAAG,CAAC,KAAK,IAAI,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,wCAAwC,CAAC,CAAC;YACnE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA2C,CAAC;YAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC/B,YAAY,GAAG,MAAM,CAAC;YACtB,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,8CAA8C;YAC9C,IAAI,YAAY;gBAAE,OAAO,YAAY,CAAC;YACtC,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC,YAAY,IAAI,GAAG,GAAG,gBAAgB,GAAG,cAAc,EAAE,CAAC;QAC7D,2CAA2C;QAC3C,YAAY,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,YAAY,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @polpo-ai/llm — Multi-provider LLM abstraction built on Vercel AI SDK + AI Gateway.
+ *
+ * Provides model resolution, streaming, cost tracking, provider cooldown/failover,
+ * and API key resolution for all major LLM providers.
+ */
+export { fetchCatalog, getCatalogSync, } from "./gateway-catalog.js";
+export type { GatewayLanguageModelEntry, ModelInfo } from "./gateway-catalog.js";
+export { parseModelSpec, resolveModel, resolveModelSpec, resolveModelWithFallback, resolveModelWithFallbackAsync, getModelInfo, listProviders, listModels, buildModelListingForPrompt, setProviderOverrides, getProviderOverrides, setModelAllowlist, getModelAllowlist, isModelAllowed, enforceModelAllowlist, validateProviderKeys, validateProviderKeysDetailed, } from "./model-resolver.js";
+export type { ResolvedModel, ParsedModelSpec, ProviderValidationResult } from "./model-resolver.js";
+export { createCustomProviderModel, createGatewayModel, mapReasoningToProviderOptions, buildStreamOpts, } from "./provider-factory.js";
+export { resolveApiKey, resolveApiKeyAsync, hasOAuthProfiles, PROVIDER_ENV_MAP, } from "./api-keys.js";
+export { estimateCost } from "./cost.js";
+export type { CostEstimate, LanguageModelUsage } from "./cost.js";
+export { isProviderInCooldown, markProviderCooldown, clearProviderCooldown, getProviderCooldowns, classifyProviderError, } from "./cooldown.js";
+export { queryText, queryStream, queryTextWithFallback, } from "./query.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjF,OAAO,EAEL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY,EAEZ,aAAa,EACb,UAAU,EACV,0BAA0B,EAE1B,oBAAoB,EACpB,oBAAoB,EAEpB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EAErB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAGpG,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGlE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @polpo-ai/llm — Multi-provider LLM abstraction built on Vercel AI SDK + AI Gateway.
+ *
+ * Provides model resolution, streaming, cost tracking, provider cooldown/failover,
+ * and API key resolution for all major LLM providers.
+ */
+// ─── Gateway Catalog ─���───────────────────────────────
+export { fetchCatalog, getCatalogSync, } from "./gateway-catalog.js";
+// ─── Model Resolution ────────────────────────────────
+export { 
+// Core resolution
+parseModelSpec, resolveModel, resolveModelSpec, resolveModelWithFallback, resolveModelWithFallbackAsync, getModelInfo, 
+// Catalog listing (uses resolver state)
+listProviders, listModels, buildModelListingForPrompt, 
+// Provider overrides
+setProviderOverrides, getProviderOverrides, 
+// Model allowlist
+setModelAllowlist, getModelAllowlist, isModelAllowed, enforceModelAllowlist, 
+// Provider validation
+validateProviderKeys, validateProviderKeysDetailed, } from "./model-resolver.js";
+// ─── Provider Factory ──────���─────────────────────────
+export { createCustomProviderModel, createGatewayModel, mapReasoningToProviderOptions, buildStreamOpts, } from "./provider-factory.js";
+// ─── API Keys ────────────────────────────────────────
+export { resolveApiKey, resolveApiKeyAsync, hasOAuthProfiles, PROVIDER_ENV_MAP, } from "./api-keys.js";
+// ─── Cost ─���──────────────────────────────────────────
+export { estimateCost } from "./cost.js";
+// ─── Cooldown ────────────────────────────────────────
+export { isProviderInCooldown, markProviderCooldown, clearProviderCooldown, getProviderCooldowns, classifyProviderError, } from "./cooldown.js";
+// ─── Query Functions ──────────���──────────────────────
+export { queryText, queryStream, queryTextWithFallback, } from "./query.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0DAA0D;AAC1D,OAAO,EACL,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,wDAAwD;AACxD,OAAO;AACL,kBAAkB;AAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY;AACZ,wCAAwC;AACxC,aAAa,EACb,UAAU,EACV,0BAA0B;AAC1B,qBAAqB;AACrB,oBAAoB,EACpB,oBAAoB;AACpB,kBAAkB;AAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,qBAAqB;AACrB,sBAAsB;AACtB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAG7B,0DAA0D;AAC1D,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,wDAAwD;AACxD,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,0DAA0D;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,wDAAwD;AACxD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,0DAA0D;AAC1D,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/model-resolver.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Model resolution — resolves model specs to AI SDK LanguageModel instances
+ * with full metadata. Handles provider overrides, model allowlists,
+ * fallback chains, and provider key validation.
+ */
+import type { LanguageModel } from "ai";
+import type { ProviderConfig, ModelConfig, ModelAllowlistEntry } from "@polpo-ai/core";
+export type { ParsedModelSpec } from "@polpo-ai/core";
+import { type ModelInfo } from "./gateway-catalog.js";
+/**
+ * A resolved model: metadata (from gateway catalog or custom provider config)
+ * plus an AI SDK LanguageModel instance ready for generateText/streamText.
+ */
+export interface ResolvedModel {
+    /** Model identifier (e.g. "claude-sonnet-4.5"). */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Provider name (e.g. "anthropic", "openai"). */
+    provider: string;
+    /** Whether the model supports reasoning/thinking. */
+    reasoning: boolean;
+    /** Supported input modalities. */
+    input: string[];
+    /** Context window size in tokens. */
+    contextWindow: number;
+    /** Max output tokens. */
+    maxTokens: number;
+    /** Cost per token (in USD). */
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    /** The AI SDK model instance to pass to generateText/streamText. */
+    aiModel: LanguageModel;
+}
+export declare function setProviderOverrides(overrides: Record<string, ProviderConfig>): void;
+export declare function getProviderOverrides(): Record<string, ProviderConfig>;
+export declare function setModelAllowlist(allowlist: Record<string, ModelAllowlistEntry> | undefined): void;
+export declare function getModelAllowlist(): Record<string, ModelAllowlistEntry> | undefined;
+/**
+ * Check if a model spec is allowed by the allowlist.
+ * Returns true if no allowlist is set (everything allowed) or the model is in the list.
+ */
+export declare function isModelAllowed(spec: string): boolean;
+/**
+ * Enforce model allowlist. Throws if the model is not allowed.
+ */
+export declare function enforceModelAllowlist(spec: string): void;
+/**
+ * Parse a model spec string into provider + modelId.
+ * Falls back to POLPO_MODEL env var. Throws if no model is available.
+ */
+export declare function parseModelSpec(spec?: string): {
+    provider: string;
+    modelId: string;
+};
+/**
+ * Resolve a model spec to a ResolvedModel with metadata + AI SDK model instance.
+ *
+ * Resolution order:
+ * 1. If provider has an override with custom baseUrl -> create OpenAI-compatible model
+ * 2. Otherwise -> use AI Gateway (provider/modelId format)
+ *
+ * This ensures custom providers (Ollama, vLLM, etc.) work without being in the gateway.
+ */
+export declare function resolveModel(spec?: string): ResolvedModel;
+/**
+ * Get detailed model info for a specific model spec.
+ */
+export declare function getModelInfo(spec: string): ModelInfo | undefined;
+/**
+ * List all available providers from the AI Gateway catalog.
+ * Returns synchronously from the cache; triggers background refresh if stale.
+ */
+export declare function listProviders(): string[];
+/**
+ * List all models for a given provider (or all providers if none specified).
+ */
+export declare function listModels(provider?: string): ModelInfo[];
+/**
+ * Build a dynamic model listing string for system prompts.
+ * Uses the gateway catalog instead of hardcoded lists.
+ */
+export declare function buildModelListingForPrompt(): string;
+/**
+ * Normalize a model spec that may be string or ModelConfig into a plain string.
+ * Useful for APIs that only accept a string model spec.
+ */
+export declare function resolveModelSpec(spec: string | ModelConfig | undefined): string | undefined;
+/**
+ * Resolve a model from a fallback chain (synchronous).
+ * Tries primary first, then each fallback in order.
+ * Returns the first model that has a valid API key.
+ */
+export declare function resolveModelWithFallback(config: ModelConfig): {
+    model: ResolvedModel;
+    spec: string;
+};
+/**
+ * Resolve a model from a fallback chain (async).
+ * Tries primary first, then each fallback in order.
+ * Checks the FULL API key resolution chain including OAuth profiles with auto-refresh.
+ */
+export declare function resolveModelWithFallbackAsync(config: ModelConfig): Promise<{
+    model: ResolvedModel;
+    spec: string;
+}>;
+export interface ProviderValidationResult {
+    provider: string;
+    modelSpec: string;
+    hasKey: boolean;
+    envVar?: string;
+}
+/**
+ * Validate that all required providers have API keys available.
+ * Returns detailed validation results for all model specs.
+ */
+export declare function validateProviderKeys(modelSpecs: string[]): {
+    provider: string;
+    modelSpec: string;
+}[];
+/**
+ * Get detailed validation for a set of model specs — including which env var to set.
+ */
+export declare function validateProviderKeysDetailed(modelSpecs: string[]): ProviderValidationResult[];
+//# sourceMappingURL=model-resolver.d.ts.map

package/dist/model-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../src/model-resolver.ts"],"names":[],"mappings":"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"}