Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
/**
* v0.32.7 CJK wave — embedding model pricing lookup table.
*
* Sibling to `anthropic-pricing.ts`. Used by `gbrain upgrade`'s post-upgrade
* cost-estimate prompt so users with large brains see a dollar figure
* before the chunker-version sweep re-embeds.
*
* Prices in USD per 1M tokens. Every entry carries the official page it came
* from plus the date it was last read against that page — re-verify alongside
* the Anthropic-pricing refresh cycle; drift here produces estimates that
* mislead operators. This table is for EMBEDDINGS only; chat/completion
* pricing lives in `model-pricing.ts` (different unit) and must never be
* mixed in here.
*
* Codex outside-voice C3 fold: embedding providers with no entry below
* (Hunyuan, Dashscope, etc.) return UNKNOWN_PROVIDER from `lookupPrice`
* so the cost-estimate prompt can fall back to a "estimate unavailable
* for <provider>; press Ctrl-C in 10s to abort" message rather than
* fabricate numbers.
*/
export interface EmbeddingPricing {
/** USD per 1M tokens (embedding cost; embeddings have no separate output rate). */
pricePerMTok: number;
}
/**
* `provider:model` keyed pricing. The colon-separated key matches
* gateway model strings (e.g. 'openai:text-embedding-3-large').
*/
export const EMBEDDING_PRICING: Record<string, EmbeddingPricing> = {
// TypeSafe Jev (reranker + decide; https://docs.typesafe.ai/models, verified 2026-09-30).
// System One bills input tokens only; rerank- and decide-kind budgets price through this table.
'typesafe:jev-1.13.0': { pricePerMTok: 0.042 },
'typesafe:jev-latest': { pricePerMTok: 0.042 },
'typesafe:jev-preview': { pricePerMTok: 0.042 },
// OpenAI (https://developers.openai.com/api/docs/pricing, verified 2026-07-28)
'openai:text-embedding-3-large': { pricePerMTok: 0.13 },
'openai:text-embedding-3-small': { pricePerMTok: 0.02 },
// Legacy OpenAI ada (still common in older brains)
'openai:text-embedding-ada-002': { pricePerMTok: 0.10 },
// Voyage (https://docs.voyageai.com/docs/pricing, verified 2026-08-21)
'voyage:voyage-4-large': { pricePerMTok: 0.12 },
'voyage:voyage-4': { pricePerMTok: 0.06 },
'voyage:voyage-4-lite': { pricePerMTok: 0.02 },
'voyage:voyage-code-4': { pricePerMTok: 0.12 },
// Domain + multimodal models (current-models section; multimodal rate is
// per 1M TEXT tokens — image pixel-token pricing is out of scope here).
'voyage:voyage-finance-2': { pricePerMTok: 0.12 },
'voyage:voyage-law-2': { pricePerMTok: 0.12 },
'voyage:voyage-multimodal-3': { pricePerMTok: 0.12 },
'voyage:rerank-2.5': { pricePerMTok: 0.05 },
'voyage:rerank-2.5-lite': { pricePerMTok: 0.02 },
'voyage:rerank-3': { pricePerMTok: 0.05 },
'voyage:rerank-3-lite': { pricePerMTok: 0.02 },
// voyage-4-nano is deliberately absent: it's the open-weight variant (see
// src/core/ai/recipes/voyage.ts) and Voyage's pricing page lists no hosted
// rate for it. A 0 entry would under-estimate anyone paying for it via the
// hosted API; no entry means lookupEmbeddingPrice returns `unknown` and the
// caller prints "estimate unavailable" instead of a wrong number.
// Legacy Voyage models (same page, "older models" section — no free tokens):
// #4344: voyage-3.5 / voyage-3.5-lite are in the hosted recipe list but had
// no rows, so upgrade cost estimates showed "unavailable" for their users.
'voyage:voyage-3.5': { pricePerMTok: 0.06 },
'voyage:voyage-3.5-lite': { pricePerMTok: 0.02 },
'voyage:voyage-3-large': { pricePerMTok: 0.18 },
'voyage:voyage-3': { pricePerMTok: 0.06 },
'voyage:voyage-3-lite': { pricePerMTok: 0.02 },
'voyage:voyage-code-3': { pricePerMTok: 0.18 },
// Mistral (https://mistral.ai/pricing/api/, verified 2026-07-28)
'mistral:mistral-embed': { pricePerMTok: 0.10 },
'mistral:mistral-embed-2312': { pricePerMTok: 0.10 },
// Perplexity (https://docs.perplexity.ai/getting-started/pricing, verified 2026-07-28)
'perplexity:pplx-embed-v1-0.6b': { pricePerMTok: 0.004 },
'perplexity:pplx-embed-v1-4b': { pricePerMTok: 0.03 },
// Google (https://ai.google.dev/gemini-api/docs/pricing, verified 2026-09-07).
// #4344 class: both models are in the hosted recipe list
// (src/core/ai/recipes/google.ts) but had no rows, so cost estimates read
// "unavailable" for every brain on them — including the OpenRouter-routed
// ones, since `openrouter:google/gemini-embedding-001` resolves here through
// the #2504 nested-vendor retry. The two rates differ, so one shared row
// would misprice whichever model it didn't come from.
'google:gemini-embedding-001': { pricePerMTok: 0.15 },
// gemini-embedding-2 is multimodal and priced per input kind ($0.45/1M image,
// $6.50 audio, $12.00 video). Same convention as voyage-multimodal-3 above:
// the TEXT rate is the row, pixel/audio token pricing is out of scope here.
'google:gemini-embedding-2': { pricePerMTok: 0.20 },
};
export type PriceLookupResult =
| { kind: 'known'; pricePerMTok: number; key: string }
| { kind: 'unknown'; provider: string; model: string };
/**
* Provider aliases resolved on a lookup miss (#4032). Azure deployments of
* OpenAI embedding models bill at the same per-token rates as OpenAI-hosted,
* so `azure-openai:<model>` falls back to the `openai:<model>` row. An alias
* (not duplicated rows) so new openai entries never drift from their Azure
* twins. A model with no twin in the alias target stays `unknown` — fail
* closed rather than fabricate a rate. OpenRouter names Voyage's models
* `voyageai/<model>` and bills Voyage's rates (#7034), so the nested
* `voyageai` vendor falls back to the `voyage:<model>` row.
*/
const EMBEDDING_PROVIDER_ALIASES: Record<string, string> = {
'azure-openai': 'openai',
voyageai: 'voyage',
};
/**
* Resolve a model string into a price-per-1M-tokens. Accepts both
* `provider:model` and bare `model` forms (bare assumes openai).
*/
export function lookupEmbeddingPrice(modelString: string): PriceLookupResult {
const [providerRaw, modelRaw] = modelString.includes(':')
? modelString.split(':', 2)
: ['openai', modelString];
const provider = providerRaw.trim().toLowerCase();
const model = (modelRaw ?? '').trim();
const key = `${provider}:${model}`;
const hit = EMBEDDING_PRICING[key];
if (hit) return { kind: 'known', pricePerMTok: hit.pricePerMTok, key };
const alias = EMBEDDING_PROVIDER_ALIASES[provider];
if (alias) {
const aliasKey = `${alias}:${model}`;
const aliasHit = EMBEDDING_PRICING[aliasKey];
if (aliasHit) return { kind: 'known', pricePerMTok: aliasHit.pricePerMTok, key: aliasKey };
}
// #2504 — nested gateway ids: router providers wrap the upstream vendor in
// the model segment ('openrouter:openai/text-embedding-3-large'). On a
// miss, re-key on the nested vendor prefix and retry (provider aliases
// included via the recursion) — routers bill the upstream vendor's
// per-token rate, so the vendor row is the honest estimate. No nested
// match → still `unknown` (fail closed, never fabricate). Bounded: each
// recursion strips one '/segment'.
const slash = model.indexOf('/');
if (slash > 0 && slash < model.length - 1) {
const nested = lookupEmbeddingPrice(`${model.slice(0, slash)}:${model.slice(slash + 1)}`);
if (nested.kind === 'known') return nested;
}
return { kind: 'unknown', provider, model };
}
/**
* Estimate USD cost for embedding `charCount` characters. Uses
* 3.5 chars/token as the OpenAI tiktoken-shaped approximation for English;
* CJK-heavy brains will under-estimate by ~2x (one char ≈ one token), but
* we'd rather under-estimate than spook users with a 10x worst-case figure.
*/
export function estimateCostFromChars(charCount: number, pricePerMTok: number): number {
const tokens = Math.ceil(charCount / 3.5);
return (tokens / 1_000_000) * pricePerMTok;
}