@ottocode/sdk 0.1.247 → 0.1.249

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ottocode/sdk",
-	"version": "0.1.247",
+	"version": "0.1.249",
 	"description": "AI agent SDK for building intelligent assistants - tree-shakable and comprehensive",
 	"author": "nitishxyz",
 	"license": "MIT",

package/src/config/src/paths.ts

@@ -110,18 +110,24 @@ export function getLocalDataDir(projectRoot: string): string {
 	return joinPath(projectRoot, '.otto');
 }
 
+async function loadFsPromises(): Promise<typeof import('node:fs/promises')> {
+	return Function('specifier', 'return import(specifier)')('node:fs/promises');
+}
+
 export async function ensureDir(dir: string) {
-	try {
-		// Attempt to create a marker file to ensure directory exists
-		await Bun.write(joinPath(dir, '.keep'), '');
-	} catch {
-		const { promises: fs } = await import('node:fs');
-		await fs.mkdir(dir, { recursive: true }).catch(() => {});
-	}
+	const { mkdir, writeFile } = await loadFsPromises();
+	await mkdir(dir, { recursive: true }).catch(() => {});
+	await writeFile(joinPath(dir, '.keep'), '').catch(() => {});
 }
 
 export async function fileExists(p: string) {
-	return await Bun.file(p).exists();
+	try {
+		const { access } = await loadFsPromises();
+		await access(p);
+		return true;
+	} catch {
+		return false;
+	}
 }
 
 export { joinPath };

package/src/index.ts

@@ -40,6 +40,20 @@ export type {
 // Providers (from internal providers module)
 // =======================
 export { catalog } from './providers/src/index.ts';
+export {
+	DEFAULT_REMOTE_MODEL_CATALOG_URL,
+	getCachedProviderCatalogEntry,
+	getModelCatalogCachePath,
+	mergeCachedModelCatalog,
+	normalizeModelCatalogPayload,
+	readCachedModelCatalog,
+	readCachedModelCatalogSync,
+	writeCachedModelCatalog,
+} from './providers/src/index.ts';
+export type {
+	CachedModelCatalog,
+	CachedProviderCatalogEntry,
+} from './providers/src/index.ts';
 export {
 	isProviderId,
 	providerIds,

package/src/providers/src/catalog-manual.ts

@@ -104,7 +104,7 @@ function buildOllamaCloudEntry(): ProviderCatalogEntry {
 export function mergeManualCatalog(
 	base: CatalogMap,
 ): Record<BuiltInProviderId, ProviderCatalogEntry> {
-	const ollamaCloudEntry = buildOllamaCloudEntry();
+	const ollamaCloudEntry = base[OLLAMA_CLOUD_ID] ?? buildOllamaCloudEntry();
 	const manualEntry = buildOttoRouterEntry();
 	const merged: Record<BuiltInProviderId, ProviderCatalogEntry> = {
 		...(base as Record<BuiltInProviderId, ProviderCatalogEntry>),

package/src/providers/src/catalog.ts

@@ -3567,6 +3567,56 @@ export const catalog: Partial<Record<BuiltInProviderId, ProviderCatalogEntry>> =
 						output: 65536,
 					},
 				},
+				{
+					id: 'deepseek/deepseek-v4-flash',
+					label: 'DeepSeek V4 Flash',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					temperature: true,
+					knowledge: '2025-05',
+					releaseDate: '2026-04-24',
+					lastUpdated: '2026-04-24',
+					openWeights: true,
+					cost: {
+						input: 0.14,
+						output: 0.28,
+						cacheRead: 0.028,
+					},
+					limit: {
+						context: 1048576,
+						output: 393216,
+					},
+				},
+				{
+					id: 'deepseek/deepseek-v4-pro',
+					label: 'DeepSeek V4 Pro',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					temperature: true,
+					knowledge: '2025-05',
+					releaseDate: '2026-04-24',
+					lastUpdated: '2026-04-24',
+					openWeights: true,
+					cost: {
+						input: 1.74,
+						output: 3.48,
+						cacheRead: 0.145,
+					},
+					limit: {
+						context: 1048576,
+						output: 393216,
+					},
+				},
 				{
 					id: 'google/gemini-2.0-flash-001',
 					ownedBy: 'google',
@@ -10465,4 +10515,700 @@ export const catalog: Partial<Record<BuiltInProviderId, ProviderCatalogEntry>> =
 			api: 'https://api.githubcopilot.com',
 			doc: 'https://docs.github.com/en/copilot',
 		},
+		'ollama-cloud': {
+			id: 'ollama-cloud',
+			models: [
+				{
+					id: 'cogito-2.1:671b',
+					label: 'cogito-2.1:671b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-11-19',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 163840,
+						output: 32000,
+					},
+				},
+				{
+					id: 'deepseek-v3.1:671b',
+					label: 'deepseek-v3.1:671b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-08-21',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 163840,
+						output: 163840,
+					},
+				},
+				{
+					id: 'deepseek-v3.2',
+					label: 'deepseek-v3.2',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-06-15',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 163840,
+						output: 65536,
+					},
+				},
+				{
+					id: 'devstral-2:123b',
+					label: 'devstral-2:123b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: false,
+					releaseDate: '2025-12-09',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'devstral-small-2:24b',
+					label: 'devstral-small-2:24b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2025-12-09',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'gemini-3-flash-preview',
+					ownedBy: 'google',
+					label: 'gemini-3-flash-preview',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: true,
+					knowledge: '2025-01',
+					releaseDate: '2025-12-17',
+					lastUpdated: '2026-04-08',
+					openWeights: true,
+					limit: {
+						context: 1048576,
+						output: 65536,
+					},
+				},
+				{
+					id: 'gemma3:12b',
+					label: 'gemma3:12b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: false,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2024-12-01',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 131072,
+						output: 131072,
+					},
+				},
+				{
+					id: 'gemma3:27b',
+					label: 'gemma3:27b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: false,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2025-07-27',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 131072,
+						output: 131072,
+					},
+				},
+				{
+					id: 'gemma3:4b',
+					label: 'gemma3:4b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: false,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2024-12-01',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 131072,
+						output: 131072,
+					},
+				},
+				{
+					id: 'gemma4:31b',
+					label: 'gemma4:31b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: true,
+					knowledge: '2025-01',
+					releaseDate: '2026-04-02',
+					lastUpdated: '2026-04-08',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'glm-4.6',
+					ownedBy: 'zai',
+					label: 'glm-4.6',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-09-29',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 202752,
+						output: 131072,
+					},
+				},
+				{
+					id: 'glm-4.7',
+					ownedBy: 'zai',
+					label: 'glm-4.7',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-12-22',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 202752,
+						output: 131072,
+					},
+				},
+				{
+					id: 'glm-5',
+					ownedBy: 'zai',
+					label: 'glm-5',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2026-02-11',
+					lastUpdated: '2026-02-11',
+					openWeights: true,
+					limit: {
+						context: 202752,
+						output: 131072,
+					},
+				},
+				{
+					id: 'glm-5.1',
+					ownedBy: 'zai',
+					label: 'glm-5.1',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2026-03-27',
+					lastUpdated: '2026-04-07',
+					openWeights: true,
+					limit: {
+						context: 202752,
+						output: 131072,
+					},
+				},
+				{
+					id: 'gpt-oss:120b',
+					ownedBy: 'openai',
+					label: 'gpt-oss:120b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-08-05',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 131072,
+						output: 32768,
+					},
+				},
+				{
+					id: 'gpt-oss:20b',
+					ownedBy: 'openai',
+					label: 'gpt-oss:20b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-08-05',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 131072,
+						output: 32768,
+					},
+				},
+				{
+					id: 'kimi-k2-thinking',
+					ownedBy: 'moonshot',
+					label: 'kimi-k2-thinking',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					knowledge: '2024-08',
+					releaseDate: '2025-11-06',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'kimi-k2:1t',
+					ownedBy: 'moonshot',
+					label: 'kimi-k2:1t',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: false,
+					knowledge: '2024-10',
+					releaseDate: '2025-07-11',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'kimi-k2.5',
+					ownedBy: 'moonshot',
+					label: 'kimi-k2.5',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: true,
+					releaseDate: '2026-01-27',
+					lastUpdated: '2026-01-27',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'kimi-k2.6:cloud',
+					ownedBy: 'moonshot',
+					label: 'kimi-k2.6:cloud',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: true,
+					releaseDate: '2026-04-20',
+					lastUpdated: '2026-04-20',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'minimax-m2',
+					ownedBy: 'minimax',
+					label: 'minimax-m2',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: false,
+					releaseDate: '2025-10-23',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 204800,
+						output: 128000,
+					},
+				},
+				{
+					id: 'minimax-m2.1',
+					ownedBy: 'minimax',
+					label: 'minimax-m2.1',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-12-23',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 204800,
+						output: 131072,
+					},
+				},
+				{
+					id: 'minimax-m2.5',
+					ownedBy: 'minimax',
+					label: 'minimax-m2.5',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					knowledge: '2025-01',
+					releaseDate: '2026-02-12',
+					lastUpdated: '2026-02-12',
+					openWeights: true,
+					limit: {
+						context: 204800,
+						output: 131072,
+					},
+				},
+				{
+					id: 'minimax-m2.7',
+					ownedBy: 'minimax',
+					label: 'minimax-m2.7',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2026-03-18',
+					lastUpdated: '2026-03-18',
+					openWeights: true,
+					limit: {
+						context: 204800,
+						output: 131072,
+					},
+				},
+				{
+					id: 'ministral-3:14b',
+					label: 'ministral-3:14b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2024-12-01',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 128000,
+					},
+				},
+				{
+					id: 'ministral-3:3b',
+					label: 'ministral-3:3b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2024-10-22',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 128000,
+					},
+				},
+				{
+					id: 'ministral-3:8b',
+					label: 'ministral-3:8b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2024-12-01',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 128000,
+					},
+				},
+				{
+					id: 'mistral-large-3:675b',
+					label: 'mistral-large-3:675b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2025-12-02',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 262144,
+					},
+				},
+				{
+					id: 'nemotron-3-nano:30b',
+					label: 'nemotron-3-nano:30b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-12-15',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 1048576,
+						output: 131072,
+					},
+				},
+				{
+					id: 'nemotron-3-super',
+					label: 'nemotron-3-super',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2026-03-11',
+					lastUpdated: '2026-03-12',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 65536,
+					},
+				},
+				{
+					id: 'qwen3-coder-next',
+					label: 'qwen3-coder-next',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: false,
+					releaseDate: '2026-02-02',
+					lastUpdated: '2026-02-08',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 65536,
+					},
+				},
+				{
+					id: 'qwen3-coder:480b',
+					label: 'qwen3-coder:480b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: false,
+					releaseDate: '2025-07-22',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 65536,
+					},
+				},
+				{
+					id: 'qwen3-next:80b',
+					label: 'qwen3-next:80b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: false,
+					releaseDate: '2025-09-15',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 32768,
+					},
+				},
+				{
+					id: 'qwen3-vl:235b',
+					label: 'qwen3-vl:235b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: true,
+					releaseDate: '2025-09-22',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 32768,
+					},
+				},
+				{
+					id: 'qwen3-vl:235b-instruct',
+					label: 'qwen3-vl:235b-instruct',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: true,
+					releaseDate: '2025-09-22',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 131072,
+					},
+				},
+				{
+					id: 'qwen3.5:397b',
+					label: 'qwen3.5:397b',
+					modalities: {
+						input: ['text', 'image'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: true,
+					attachment: true,
+					releaseDate: '2026-02-15',
+					lastUpdated: '2026-02-17',
+					openWeights: true,
+					limit: {
+						context: 262144,
+						output: 81920,
+					},
+				},
+				{
+					id: 'rnj-1:8b',
+					label: 'rnj-1:8b',
+					modalities: {
+						input: ['text'],
+						output: ['text'],
+					},
+					toolCall: true,
+					reasoningText: false,
+					attachment: false,
+					releaseDate: '2025-12-06',
+					lastUpdated: '2026-01-19',
+					openWeights: true,
+					limit: {
+						context: 32768,
+						output: 4096,
+					},
+				},
+			],
+			label: 'Ollama Cloud',
+			env: ['OLLAMA_API_KEY'],
+			npm: 'ai-sdk-ollama',
+			api: 'https://ollama.com',
+			doc: 'https://docs.ollama.com/cloud',
+		},
 	} as const satisfies Partial<Record<BuiltInProviderId, ProviderCatalogEntry>>;

package/src/providers/src/index.ts

@@ -1,5 +1,19 @@
 export { isProviderAuthorized, ensureProviderEnv } from './authorization.ts';
 export { catalog } from './catalog-merged.ts';
+export {
+	DEFAULT_REMOTE_MODEL_CATALOG_URL,
+	getCachedProviderCatalogEntry,
+	getModelCatalogCachePath,
+	mergeCachedModelCatalog,
+	normalizeModelCatalogPayload,
+	readCachedModelCatalog,
+	readCachedModelCatalogSync,
+	writeCachedModelCatalog,
+} from './model-catalog-cache.ts';
+export type {
+	CachedModelCatalog,
+	CachedProviderCatalogEntry,
+} from './model-catalog-cache.ts';
 export type {
 	BuiltInProviderId,
 	ProviderId,

package/src/providers/src/model-catalog-cache.ts

@@ -0,0 +1,147 @@
+import { getGlobalConfigDir, joinPath } from '../../config/src/paths.ts';
+import type { ModelInfo, ProviderId } from '../../types/src/index.ts';
+
+export type CachedProviderCatalogEntry = {
+	id: ProviderId;
+	label?: string;
+	models: ModelInfo[];
+};
+
+export type CachedModelCatalog = {
+	version: 1;
+	updatedAt: string;
+	providers: Record<string, CachedProviderCatalogEntry>;
+};
+
+export const DEFAULT_REMOTE_MODEL_CATALOG_URL =
+	'https://ottocode.io/catalog/models.json';
+
+export function getModelCatalogCachePath(): string {
+	return joinPath(getGlobalConfigDir(), 'models-catalog.json');
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+async function loadFsPromises(): Promise<typeof import('node:fs/promises')> {
+	return Function('specifier', 'return import(specifier)')('node:fs/promises');
+}
+
+function readFileSyncCompat(path: string): string | null {
+	try {
+		const req = Function(
+			'return typeof require === "function" ? require : null',
+		)() as ((specifier: string) => typeof import('node:fs')) | null;
+		return req?.('node:fs').readFileSync(path, 'utf8') ?? null;
+	} catch {
+		return null;
+	}
+}
+
+function normalizeProviderEntry(
+	id: string,
+	value: unknown,
+): CachedProviderCatalogEntry | null {
+	if (!isRecord(value)) return null;
+	const models = Array.isArray(value.models)
+		? value.models.filter(
+				(model): model is ModelInfo =>
+					isRecord(model) && typeof model.id === 'string',
+			)
+		: [];
+	return {
+		id: (typeof value.id === 'string' ? value.id : id) as ProviderId,
+		label: typeof value.label === 'string' ? value.label : undefined,
+		models,
+	};
+}
+
+export function normalizeModelCatalogPayload(
+	payload: unknown,
+): Record<string, CachedProviderCatalogEntry> {
+	if (!isRecord(payload)) return {};
+	const source = isRecord(payload.providers) ? payload.providers : payload;
+	const providers: Record<string, CachedProviderCatalogEntry> = {};
+	for (const [id, value] of Object.entries(source)) {
+		const entry = normalizeProviderEntry(id, value);
+		if (entry) providers[id] = entry;
+	}
+	return providers;
+}
+
+export async function readCachedModelCatalog(): Promise<CachedModelCatalog | null> {
+	try {
+		const { readFile } = await loadFsPromises();
+		const payload = JSON.parse(
+			await readFile(getModelCatalogCachePath(), 'utf8'),
+		);
+		const providers = normalizeModelCatalogPayload(payload);
+		return {
+			version: 1,
+			updatedAt:
+				isRecord(payload) && typeof payload.updatedAt === 'string'
+					? payload.updatedAt
+					: new Date(0).toISOString(),
+			providers,
+		};
+	} catch {
+		return null;
+	}
+}
+
+export function readCachedModelCatalogSync(): CachedModelCatalog | null {
+	try {
+		const text = readFileSyncCompat(getModelCatalogCachePath());
+		if (!text) return null;
+		const payload = JSON.parse(text);
+		const providers = normalizeModelCatalogPayload(payload);
+		return {
+			version: 1,
+			updatedAt:
+				isRecord(payload) && typeof payload.updatedAt === 'string'
+					? payload.updatedAt
+					: new Date(0).toISOString(),
+			providers,
+		};
+	} catch {
+		return null;
+	}
+}
+
+export function getCachedProviderCatalogEntry(
+	provider: ProviderId,
+): CachedProviderCatalogEntry | undefined {
+	return readCachedModelCatalogSync()?.providers[provider];
+}
+
+export async function writeCachedModelCatalog(
+	providers: Record<string, CachedProviderCatalogEntry>,
+): Promise<void> {
+	const path = getModelCatalogCachePath();
+	const dir = path.slice(0, path.lastIndexOf('/'));
+	const { mkdir, writeFile } = await loadFsPromises();
+	await mkdir(dir, { recursive: true });
+	await writeFile(
+		path,
+		JSON.stringify(
+			{
+				version: 1,
+				updatedAt: new Date().toISOString(),
+				providers,
+			},
+			null,
+			2,
+		),
+	);
+}
+
+export async function mergeCachedModelCatalog(
+	providers: Record<string, CachedProviderCatalogEntry>,
+): Promise<void> {
+	const existing = await readCachedModelCatalog();
+	await writeCachedModelCatalog({
+		...(existing?.providers ?? {}),
+		...providers,
+	});
+}

package/src/providers/src/registry.ts

@@ -1,5 +1,6 @@
 import { catalog } from './catalog-merged.ts';
 import { providerEnvVar } from './env.ts';
+import { getCachedProviderCatalogEntry } from './model-catalog-cache.ts';
 import { getUnderlyingProviderKey, providerIds } from './utils.ts';
 import type {
 	BuiltInProviderId,
@@ -127,17 +128,21 @@ export function getProviderDefinition(
 	if (isBuiltInProviderId(provider)) {
 		const entry = catalog[provider];
 		if (!entry) return undefined;
+		const cachedEntry = getCachedProviderCatalogEntry(provider);
+		const models = cachedEntry?.models.length
+			? cachedEntry.models
+			: entry.models;
 		return {
 			id: provider,
-			label: settings?.label ?? entry.label ?? provider,
+			label: settings?.label ?? cachedEntry?.label ?? entry.label ?? provider,
 			source: 'built-in',
 			compatibility: BUILTIN_COMPATIBILITY[provider],
 			family: BUILTIN_FAMILY[provider],
-			baseURL: normalizeOptionalText(settings?.baseURL),
+			baseURL: normalizeOptionalText(settings?.baseURL) ?? entry.api,
 			apiKey: normalizeOptionalText(settings?.apiKey),
 			apiKeyEnv:
 				normalizeOptionalText(settings?.apiKeyEnv) ?? providerEnvVar(provider),
-			models: entry.models,
+			models,
 			allowAnyModel: provider === 'ollama-cloud',
 		};
 	}

package/src/providers/src/utils.ts

@@ -1,4 +1,5 @@
 import { catalog } from './catalog-merged.ts';
+import { getCachedProviderCatalogEntry } from './model-catalog-cache.ts';
 import type {
 	BuiltInProviderId,
 	ProviderId,
@@ -17,11 +18,11 @@ export function isProviderId(value: unknown): value is BuiltInProviderId {
 }
 
 export function defaultModelFor(provider: ProviderId): string | undefined {
-	return catalog[provider]?.models?.[0]?.id;
+	return getProviderModels(provider)[0]?.id;
 }
 
 export function listModels(provider: ProviderId): string[] {
-	return (catalog[provider]?.models ?? []).map((m) => m.id);
+	return getProviderModels(provider).map((m) => m.id);
 }
 
 export function hasModel(
@@ -49,7 +50,7 @@ const PREFERRED_FAST_MODELS_OAUTH: Partial<Record<ProviderId, string[]>> = {
 };
 
 export function getFastModel(provider: ProviderId): string | undefined {
-	const providerModels = catalog[provider]?.models ?? [];
+	const providerModels = getProviderModels(provider);
 	if (!providerModels.length) return undefined;
 
 	const preferred = PREFERRED_FAST_MODELS[provider] ?? [];
@@ -70,7 +71,7 @@ export function getFastModelForAuth(
 	provider: ProviderId,
 	authType: 'api' | 'oauth' | 'wallet' | undefined,
 ): string | undefined {
-	const providerModels = catalog[provider]?.models ?? [];
+	const providerModels = getProviderModels(provider);
 	if (!providerModels.length) return undefined;
 
 	const filteredModels = filterModelsForAuthType(
@@ -106,13 +107,13 @@ export function getModelNpmBinding(
 	model: string,
 ): string | undefined {
 	const entry = catalog[provider];
-	const modelInfo = entry?.models?.find((m) => m.id === model);
+	const modelInfo = getProviderModels(provider).find((m) => m.id === model);
 	if (modelInfo?.provider?.npm) return modelInfo.provider.npm;
 	if (entry?.npm) return entry.npm;
 
 	for (const key of Object.keys(catalog) as ProviderId[]) {
 		const e = catalog[key];
-		const m = e?.models?.find((x) => x.id === model);
+		const m = getProviderModels(key).find((x) => x.id === model);
 		if (m?.provider?.npm) return m.provider.npm;
 		if (m && e?.npm) return e.npm;
 	}
@@ -234,7 +235,15 @@ export function getModelInfo(
 ): ModelInfo | undefined {
 	const entry = catalog[provider];
 	if (!entry) return undefined;
-	return entry.models?.find((m) => m.id === model);
+	return getProviderModels(provider).find((m) => m.id === model);
+}
+
+function getProviderModels(provider: ProviderId): ModelInfo[] {
+	return (
+		getCachedProviderCatalogEntry(provider)?.models ??
+		catalog[provider]?.models ??
+		[]
+	);
 }
 
 export function modelSupportsReasoning(

package/src/providers/src/validate.ts

@@ -1,4 +1,5 @@
 import { catalog } from './catalog-merged.ts';
+import { getCachedProviderCatalogEntry } from './model-catalog-cache.ts';
 import type { OttoConfig, ProviderId } from '../../types/src/index.ts';
 import {
 	getProviderDefinition,
@@ -51,14 +52,15 @@ export function validateProviderModel(
 	if (!catalog[p]) {
 		throw new Error(`Provider not supported: ${provider}`);
 	}
-	const entry = catalog[p].models.find((m) => m.id === model);
+	const models = getCachedProviderCatalogEntry(p)?.models ?? catalog[p].models;
+	const entry = models.find((m) => m.id === model);
 	if (!entry) {
-		const list = catalog[p].models
+		const list = models
 			.slice(0, 10)
 			.map((m) => m.id)
 			.join(', ');
 		throw new Error(
-			`Model not found for provider ${provider}: ${model}. Example models: ${list}${catalog[p].models.length > 10 ? ', ...' : ''}`,
+			`Model not found for provider ${provider}: ${model}. Example models: ${list}${models.length > 10 ? ', ...' : ''}`,
 		);
 	}
 	applyCapabilityValidation(model, entry, effectiveCap, { strict: true });