Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
import type { Recipe } from '../types.ts';
/**
* Model-family prompt-cache capability for OpenAI ids.
*
* OpenAI caches prompt prefixes automatically — no request mutation and no
* client opt-in — but only from the `gpt-4o` / `gpt-4.1` / o-series generation
* onward. Earlier ids (`gpt-4-turbo`, `gpt-4`, `gpt-3.5-turbo`) predate it, and
* recipe model lists are advisory, so any id a user configures reaches here.
*
* A per-model predicate rather than a provider-wide boolean for exactly that
* reason: a blanket `true` would suppress the cost warning on a legacy id that
* really does run hot, which is the same wrong-advice failure — pointing the
* other way — as the blanket `false` this replaces.
*
* Every branch is boundary-anchored (family token then `-`, `.` or end), so an
* unrecognized id that merely shares a prefix — `gpt-4oops`, `o9anything`, a
* custom base-url alias — does NOT inherit the family's answer. Unrecognized
* ids return false on purpose: under-claiming costs an operator one unnecessary
* warning, over-claiming silently hides a real cost regression.
*
* Shared with the OpenRouter predicate so the same model cannot report
* different capabilities depending on the route taken to reach it.
*/
export function openaiModelSupportsPromptCache(modelId: string): boolean {
let normalized = modelId.trim().toLowerCase();
// Fine-tunes are `ft:<base>:<org>::<id>` and inherit the base model's
// caching behavior, so match on the base.
if (normalized.startsWith('ft:')) normalized = normalized.slice(3).split(':', 1)[0] ?? '';
return (
// gpt-4o, gpt-4o-mini, dated snapshots.
/^gpt-4o(?:[-.]|$)/.test(normalized) ||
// gpt-4.1 (incl. mini/nano) and gpt-4.5-preview.
/^gpt-4\.[15](?:[-.]|$)/.test(normalized) ||
// gpt-5 and any later numbered family.
/^gpt-(?:[5-9]|\d{2,})(?:[-.]|$)/.test(normalized) ||
// Reasoning series: o1, o3, o4, …
/^o[1-9]\d*(?:[-.]|$)/.test(normalized)
);
}
export const openai: Recipe = {
id: 'openai',
name: 'OpenAI',
tier: 'native',
implementation: 'native-openai',
auth_env: {
required: ['OPENAI_API_KEY'],
optional: ['OPENAI_ORG_ID', 'OPENAI_PROJECT'],
setup_url: 'https://platform.openai.com/api-keys',
},
touchpoints: {
embedding: {
models: ['text-embedding-3-large', 'text-embedding-3-small'],
// [R13] audit: documented 8,191-token per-input limit. Above the
// 2000-token default chunk cap, so chunking is unchanged; it bounds the
// per-request reservation and names the cap for the heal pass.
max_input_tokens: { 'text-embedding-3-large': 8191, 'text-embedding-3-small': 8191 },
default_dims: 1536,
dims_options: [256, 512, 768, 1024, 1536, 3072],
cost_per_1m_tokens_usd: 0.13,
price_last_verified: '2026-04-20',
// OpenAI per-request hard cap is 300K tokens. Free/Tier-1 TPM is 1M.
// Cap batches conservatively at 100K to handle token-dense content
// (Discord/Slack markdown+JSON tokenizes at ~chars/2.7, not the chars/4
// estimate the batcher uses). 100K estimated = ~150K real tokens worst-case,
// safely under both the 300K per-request and 1M TPM ceilings.
max_batch_tokens: 100_000,
},
expansion: {
models: ['gpt-5.6-luna', 'gpt-4o-mini'],
cost_per_1m_tokens_usd: 0.20, // gpt-5.6-luna baseline (price cut 2026-07-30)
price_last_verified: '2026-08-29',
},
chat: {
// STATIC FALLBACK ONLY — the runtime default is discovered from the
// account's own /v1/models via src/core/ai/openai-latest.ts (ranked by
// the same tier grammar), so this list matters only before the first
// keyed connect or when discovery is disabled/offline. Order is not
// semantic (the ranker classifies by suffix); keep it current-ish at
// release time, not perfectly.
// gpt-5.2 stays listed: the cross-modal + takes-quality eval judge
// panels pin it for baseline reproducibility, and their recipe-
// consistency guards require panel models to be listed entry points.
models: ['gpt-5.6', 'gpt-5.6-terra', 'gpt-5.6-luna', 'gpt-5.5', 'gpt-5.2', 'gpt-4o-mini'],
supports_tools: true,
supports_subagent_loop: true,
supports_prompt_cache: openaiModelSupportsPromptCache,
max_context_tokens: 1_050_000, // gpt-5.6 family window (GA 2026-07-09)
cost_per_1m_input_usd: 2.50, // gpt-5.6-terra baseline (the reasoning-tier default)
cost_per_1m_output_usd: 15.0,
price_last_verified: '2026-08-17',
},
},
setup_hint: 'Get an API key at https://platform.openai.com/api-keys, then `export OPENAI_API_KEY=...`',
};