@agi-cli/sdk 0.1.135 → 0.1.137

package/package.json

@@ -1,17 +1,17 @@
 {
 	"name": "@agi-cli/sdk",
-	"version": "0.1.135",
+	"version": "0.1.137",
 	"description": "AI agent SDK for building intelligent assistants - tree-shakable and comprehensive",
-	"author": "ntishxyz",
+	"author": "nitishxyz",
 	"license": "MIT",
-	"homepage": "https://github.com/ntishxyz/agi#readme",
+	"homepage": "https://github.com/nitishxyz/agi#readme",
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/ntishxyz/agi.git",
+		"url": "git+https://github.com/nitishxyz/agi.git",
 		"directory": "packages/sdk"
 	},
 	"bugs": {
-		"url": "https://github.com/ntishxyz/agi/issues"
+		"url": "https://github.com/nitishxyz/agi/issues"
 	},
 	"type": "module",
 	"main": "./src/index.ts",
@@ -21,6 +21,10 @@
 			"import": "./src/index.ts",
 			"types": "./src/index.ts"
 		},
+		"./browser": {
+			"import": "./src/browser.ts",
+			"types": "./src/browser.ts"
+		},
 		"./tools/builtin/fs": {
 			"import": "./src/core/src/tools/builtin/fs/index.ts",
 			"types": "./src/core/src/tools/builtin/fs/index.ts"

package/src/browser.ts

@@ -0,0 +1,31 @@
+// ============================================================================
+// @agi-cli/sdk/browser - Browser-safe exports
+// ============================================================================
+// This module exports only browser-compatible code (no Bun, no Node.js APIs).
+// Use this entry point for web applications like web-sdk.
+//
+// Usage:
+//   import { estimateModelCostUsd, type ProviderId } from '@agi-cli/sdk/browser';
+// ============================================================================
+
+// Types (pure TypeScript, no runtime dependencies)
+export type {
+	ProviderId,
+	ModelInfo,
+	ModelProviderBinding,
+	ProviderCatalogEntry,
+} from './types/src/index.ts';
+
+// Pricing utilities (pure TypeScript)
+export { estimateModelCostUsd } from './providers/src/pricing.ts';
+
+// Catalog data (pure TypeScript)
+export { catalog } from './providers/src/catalog-merged.ts';
+
+// Provider utilities (pure TypeScript - imported directly to avoid pulling in Bun deps)
+export {
+	isProviderId,
+	providerIds,
+	defaultModelFor,
+	hasModel,
+} from './providers/src/utils.ts';

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

@@ -16,6 +16,8 @@ const isAllowedOpenAIModel = (id: string): boolean => {
 };
 
 const isAllowedAnthropicModel = (id: string): boolean => {
+	if (id.includes('-3-5-') || id.includes('-3.5-')) return true;
+	if (id.match(/claude-(haiku|sonnet|opus)-3/)) return true;
 	if (id.includes('-4-') || id.includes('-4.')) return true;
 	if (id.match(/claude-(haiku|sonnet|opus)-4/)) return true;
 	return false;

package/src/providers/src/catalog.ts

@@ -1026,6 +1026,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.8,
 					output: 4,
 					cacheRead: 0.08,
+					cacheWrite: 1,
 				},
 				limit: {
 					context: 200000,
@@ -1051,6 +1052,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.8,
 					output: 4,
 					cacheRead: 0.08,
+					cacheWrite: 1,
 				},
 				limit: {
 					context: 200000,
@@ -1076,6 +1078,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -1101,6 +1104,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -1126,6 +1130,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -1151,6 +1156,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -1176,6 +1182,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.25,
 					output: 1.25,
 					cacheRead: 0.03,
+					cacheWrite: 0.3,
 				},
 				limit: {
 					context: 200000,
@@ -1201,6 +1208,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -1226,6 +1234,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 0.3,
 				},
 				limit: {
 					context: 200000,
@@ -1251,6 +1260,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 1,
 					output: 5,
 					cacheRead: 0.1,
+					cacheWrite: 1.25,
 				},
 				limit: {
 					context: 200000,
@@ -1276,6 +1286,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 1,
 					output: 5,
 					cacheRead: 0.1,
+					cacheWrite: 1.25,
 				},
 				limit: {
 					context: 200000,
@@ -1301,6 +1312,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -1326,6 +1338,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -1351,6 +1364,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -1376,6 +1390,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -1401,6 +1416,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 5,
 					output: 25,
 					cacheRead: 0.5,
+					cacheWrite: 6.25,
 				},
 				limit: {
 					context: 200000,
@@ -1426,6 +1442,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 5,
 					output: 25,
 					cacheRead: 0.5,
+					cacheWrite: 6.25,
 				},
 				limit: {
 					context: 200000,
@@ -1451,6 +1468,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -1476,6 +1494,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -1501,6 +1520,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -1526,6 +1546,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -2213,6 +2234,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.8,
 					output: 4,
 					cacheRead: 0.08,
+					cacheWrite: 1,
 				},
 				limit: {
 					context: 200000,
@@ -2238,6 +2260,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -2263,6 +2286,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 1,
 					output: 5,
 					cacheRead: 0.1,
+					cacheWrite: 1.25,
 				},
 				limit: {
 					context: 200000,
@@ -2288,6 +2312,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -2313,6 +2338,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -2338,6 +2364,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 5,
 					output: 25,
 					cacheRead: 0.5,
+					cacheWrite: 6.25,
 				},
 				limit: {
 					context: 200000,
@@ -2363,6 +2390,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 200000,
@@ -2388,6 +2416,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 1000000,
@@ -3343,6 +3372,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.28,
 					output: 1.15,
 					cacheRead: 0.28,
+					cacheWrite: 1.15,
 				},
 				limit: {
 					context: 196600,
@@ -5258,6 +5288,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.75,
+					cacheWrite: 15,
 				},
 				limit: {
 					context: 131072,
@@ -5283,6 +5314,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.75,
+					cacheWrite: 15,
 				},
 				limit: {
 					context: 131072,
@@ -5308,6 +5340,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.3,
 					output: 0.5,
 					cacheRead: 0.075,
+					cacheWrite: 0.5,
 				},
 				limit: {
 					context: 131072,
@@ -5333,6 +5366,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.3,
 					output: 0.5,
 					cacheRead: 0.075,
+					cacheWrite: 0.5,
 				},
 				limit: {
 					context: 131072,
@@ -5358,6 +5392,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.75,
+					cacheWrite: 15,
 				},
 				limit: {
 					context: 256000,
@@ -5383,6 +5418,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.2,
 					output: 0.5,
 					cacheRead: 0.05,
+					cacheWrite: 0.05,
 				},
 				limit: {
 					context: 2000000,
@@ -5408,6 +5444,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.2,
 					output: 0.5,
 					cacheRead: 0.05,
+					cacheWrite: 0.05,
 				},
 				limit: {
 					context: 2000000,
@@ -5623,59 +5660,6 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 	opencode: {
 		id: 'opencode',
 		models: [
-			{
-				id: 'alpha-gd4',
-				label: 'Alpha GD4',
-				modalities: {
-					input: ['text'],
-					output: ['text'],
-				},
-				toolCall: true,
-				reasoning: true,
-				attachment: false,
-				temperature: true,
-				knowledge: '2025-01',
-				releaseDate: '2025-01-01',
-				lastUpdated: '2025-01-01',
-				openWeights: true,
-				cost: {
-					input: 0.5,
-					output: 2,
-					cacheRead: 0.15,
-				},
-				limit: {
-					context: 262144,
-					output: 32768,
-				},
-				provider: {
-					npm: '@ai-sdk/anthropic',
-				},
-			},
-			{
-				id: 'alpha-glm-4.7',
-				label: 'Alpha GLM-4.7',
-				modalities: {
-					input: ['text'],
-					output: ['text'],
-				},
-				toolCall: true,
-				reasoning: true,
-				attachment: false,
-				temperature: true,
-				knowledge: '2025-04',
-				releaseDate: '2025-12-22',
-				lastUpdated: '2025-12-22',
-				openWeights: true,
-				cost: {
-					input: 0.6,
-					output: 2.2,
-					cacheRead: 0.6,
-				},
-				limit: {
-					context: 204800,
-					output: 131072,
-				},
-			},
 			{
 				id: 'big-pickle',
 				label: 'Big Pickle',
@@ -5695,6 +5679,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 200000,
@@ -5720,6 +5705,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.8,
 					output: 4,
 					cacheRead: 0.08,
+					cacheWrite: 1,
 				},
 				limit: {
 					context: 200000,
@@ -5748,6 +5734,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 1,
 					output: 5,
 					cacheRead: 0.1,
+					cacheWrite: 1.25,
 				},
 				limit: {
 					context: 200000,
@@ -5776,6 +5763,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 15,
 					output: 75,
 					cacheRead: 1.5,
+					cacheWrite: 18.75,
 				},
 				limit: {
 					context: 200000,
@@ -5804,6 +5792,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 5,
 					output: 25,
 					cacheRead: 0.5,
+					cacheWrite: 6.25,
 				},
 				limit: {
 					context: 200000,
@@ -5832,6 +5821,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 1000000,
@@ -5860,6 +5850,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 3,
 					output: 15,
 					cacheRead: 0.3,
+					cacheWrite: 3.75,
 				},
 				limit: {
 					context: 1000000,
@@ -6270,6 +6261,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 256000,
@@ -6407,6 +6399,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.6,
 					output: 2.2,
 					cacheRead: 0.11,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 131072,
@@ -6432,6 +6425,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.2,
 					output: 1.1,
 					cacheRead: 0.03,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 131072,
@@ -6457,6 +6451,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 131072,
@@ -6506,6 +6501,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.6,
 					output: 2.2,
 					cacheRead: 0.11,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 204800,
@@ -6555,6 +6551,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0.6,
 					output: 2.2,
 					cacheRead: 0.11,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 204800,
@@ -6590,6 +6587,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 131072,
@@ -6615,6 +6613,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 131072,
@@ -6640,6 +6639,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 131072,
@@ -6689,6 +6689,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 204800,
@@ -6738,6 +6739,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 204800,
@@ -6763,6 +6765,7 @@ export const catalog: Partial<Record<ProviderId, ProviderCatalogEntry>> = {
 					input: 0,
 					output: 0,
 					cacheRead: 0,
+					cacheWrite: 0,
 				},
 				limit: {
 					context: 200000,

package/src/providers/src/pricing.ts

@@ -6,6 +6,8 @@ type ProviderName = ProviderId;
 type UsageLike = {
 	inputTokens?: number | null;
 	outputTokens?: number | null;
+	cachedInputTokens?: number | null;
+	cacheCreationInputTokens?: number | null;
 };
 
 type PricingEntry = {
@@ -119,7 +121,19 @@ export function estimateModelCostUsd(
 		typeof usage.inputTokens === 'number' ? usage.inputTokens : 0;
 	const outputTokens =
 		typeof usage.outputTokens === 'number' ? usage.outputTokens : 0;
-	if (!inputTokens && !outputTokens) return undefined;
+	const cachedInputTokens =
+		typeof usage.cachedInputTokens === 'number' ? usage.cachedInputTokens : 0;
+	const cacheCreationInputTokens =
+		typeof usage.cacheCreationInputTokens === 'number'
+			? usage.cacheCreationInputTokens
+			: 0;
+	if (
+		!inputTokens &&
+		!outputTokens &&
+		!cachedInputTokens &&
+		!cacheCreationInputTokens
+	)
+		return undefined;
 
 	// Prefer centralized catalog costs when available
 	const m = findCatalogModel(provider, model);
@@ -128,9 +142,16 @@ export function estimateModelCostUsd(
 			typeof m.cost?.input === 'number' ? m.cost.input : 0;
 		const outputPerMillion =
 			typeof m.cost?.output === 'number' ? m.cost.output : 0;
+		const cacheReadPerMillion =
+			typeof m.cost?.cacheRead === 'number' ? m.cost.cacheRead : 0;
+		const cacheWritePerMillion =
+			typeof m.cost?.cacheWrite === 'number' ? m.cost.cacheWrite : 0;
 		const inputCost = (inputTokens * inputPerMillion) / 1_000_000;
 		const outputCost = (outputTokens * outputPerMillion) / 1_000_000;
-		const total = inputCost + outputCost;
+		const cacheReadCost = (cachedInputTokens * cacheReadPerMillion) / 1_000_000;
+		const cacheWriteCost =
+			(cacheCreationInputTokens * cacheWritePerMillion) / 1_000_000;
+		const total = inputCost + outputCost + cacheReadCost + cacheWriteCost;
 		return Number.isFinite(total) ? Number(total.toFixed(6)) : undefined;
 	}
 

package/src/providers/src/solforge-client.ts

@@ -9,6 +9,34 @@ import { createOpenAI } from '@ai-sdk/openai';
 import { createAnthropic } from '@ai-sdk/anthropic';
 import { addAnthropicCacheControl } from './anthropic-caching.ts';
 
+function simplifyPaymentError(errMsg: string): string {
+	const lower = errMsg.toLowerCase();
+	if (
+		lower.includes('insufficient') ||
+		lower.includes('not enough') ||
+		lower.includes('balance')
+	) {
+		return 'Insufficient USDC balance';
+	}
+	if (lower.includes('simulation') || lower.includes('compute unit')) {
+		return 'Transaction simulation failed';
+	}
+	if (lower.includes('blockhash') || lower.includes('expired')) {
+		return 'Transaction expired, please retry';
+	}
+	if (lower.includes('timeout') || lower.includes('timed out')) {
+		return 'Transaction timed out';
+	}
+	if (lower.includes('rejected') || lower.includes('cancelled')) {
+		return 'Transaction rejected';
+	}
+	if (lower.includes('network') || lower.includes('connection')) {
+		return 'Network error';
+	}
+	const short = errMsg.split('.')[0].slice(0, 80);
+	return short.length < errMsg.length ? `${short}...` : errMsg;
+}
+
 const DEFAULT_BASE_URL = 'https://router.solforge.sh';
 const DEFAULT_RPC_URL = 'https://api.mainnet-beta.solana.com';
 const DEFAULT_MAX_ATTEMPTS = 3;
@@ -330,13 +358,7 @@ async function processSinglePayment(args: {
 		paymentPayload = await createPaymentPayload(args);
 	} catch (err) {
 		const errMsg = err instanceof Error ? err.message : String(err);
-		const isInsufficientFunds =
-			errMsg.toLowerCase().includes('insufficient') ||
-			errMsg.toLowerCase().includes('not enough') ||
-			errMsg.toLowerCase().includes('balance');
-		const userMsg = isInsufficientFunds
-			? 'Insufficient USDC balance in wallet for payment'
-			: `Payment failed: ${errMsg}`;
+		const userMsg = `Payment failed: ${simplifyPaymentError(errMsg)}`;
 		args.callbacks.onPaymentError?.(userMsg);
 		throw new Error(`Solforge: ${userMsg}`);
 	}

package/src/providers/src/utils.ts

@@ -37,11 +37,16 @@ const PREFERRED_FAST_MODELS: Partial<Record<ProviderId, string[]>> = {
 		'gemini-2.5-flash-lite',
 	],
 	openrouter: [
+		'anthropic/claude-3.5-haiku',
 		'openai/gpt-4o-mini',
 		'google/gemini-2.0-flash-001',
-		'anthropic/claude-3.5-haiku',
 	],
-	opencode: ['gpt-5-nano', 'claude-3-5-haiku', 'gemini-3-flash'],
+	opencode: ['claude-3-5-haiku', 'gpt-5-nano', 'gemini-3-flash'],
+	solforge: [
+		'claude-3-5-haiku-latest',
+		'claude-3-5-haiku-20241022',
+		'codex-mini-latest',
+	],
 	zai: ['glm-4.5-flash', 'glm-4.5-air'],
 };
 

package/src/types/src/provider.ts

@@ -33,7 +33,12 @@ export type ModelInfo = {
 	releaseDate?: string;
 	lastUpdated?: string;
 	openWeights?: boolean;
-	cost?: { input?: number; output?: number; cacheRead?: number };
+	cost?: {
+		input?: number;
+		output?: number;
+		cacheRead?: number;
+		cacheWrite?: number;
+	};
 	limit?: { context?: number; output?: number };
 	provider?: ModelProviderBinding;
 };