add-model-price

Add Model Price

Use this skill for model pricing changes in worker/ and shared LLM type updates in packages/shared/.

When to Apply

• Editing worker/src/constants/default-model-prices.json
• Editing packages/shared/src/server/llm/types.ts
• Adding a new priced model
• Updating provider prices, cache pricing, or tier conditions
• Expanding regex coverage for Bedrock, Vertex, Azure, or provider-prefixed model names
• Auditing default model prices for stale, missing, or unmatched provider pricing
• Auditing official provider docs for newly released major models that should receive default pricing and, when appropriate, selectable-model coverage
• Removing retired or shut-down models from the selectable model lists

How to Read This Skill

• Use this SKILL.md as the high-level workflow and helper index.
• Open only the specific reference file that matches the task.

Quick Start Checklist

Adding a New Model

• Gather official pricing from the provider documentation.
• Generate a lowercase UUID for the model entry.
• Create a matchPattern that covers supported provider formats.
• Add at least one default pricing tier.
• Write every per-token price as <USD per MTok>e-6 (0.1e-6, not 1e-7).
• Map every supported semantic usage bucket to the provider aliases Langfuse may persist.
• Insert the pricing entry into worker/src/constants/default-model-prices.json.
• Update packages/shared/src/server/llm/types.ts if the model should be selectable in playground or evaluation flows.
• Validate the JSON after editing.

Retiring a Selectable Model

• Confirm the shutdown or retirement on the provider's official lifecycle page.
• Remove the model from the selectable arrays in packages/shared/src/server/llm/types.ts so the model picker stops offering it.
• Keep its entry in default-model-prices.json for historical cost lookups.
• Do not reorder the arrays; if the first (default) entry retires, the next entry becomes the default.

Updating an Existing Model

• Update the relevant prices, keys, tiers, or regexes.
• Refresh updatedAt to today's ISO-8601 timestamp.
• Validate the JSON after editing.

Reference Map

Topic	Read this when	File
Schema and tier rules	You need the entry shape or pricing-tier invariants	references/schema-and-tiers.md
Provider sources and price keys	You need official pricing URLs, per-token conversion, or provider-specific usage keys	references/provider-sources-and-price-keys.md
Provider usage-key matrix	You are adding or changing OpenAI, Gemini, Anthropic, or Bedrock usage keys	references/provider-usage-key-matrix.md
Match patterns	You are editing matchPattern regexes or provider coverage	references/match-patterns.md
Workflow and validation	You are applying the end-to-end edit process or checking common mistakes	references/workflow-and-validation.md
Automated audit mode	You are running a scheduled/default-price audit and need CI-safe edit rules	references/automated-audit.md
Audit memory	You need optional per-model context retained from a useful prior automated audit	references/model-audit-memory.md

Deterministic Helpers

• Pricing file validator: node .agents/skills/add-model-price/scripts/validate-pricing-file.mjs
• Match-pattern tester: node .agents/skills/add-model-price/scripts/test-match-pattern.mjs --model <modelName> --accept <sample...> --reject <sample...>
• Direct regex tester: node .agents/skills/add-model-price/scripts/test-match-pattern.mjs --pattern '(?i)^(openai/)?(gpt-4o)$' --accept gpt-4o openai/gpt-4o --reject gpt-4o-mini