metergraph-core 0.2.56__tar.gz → 0.2.58__tar.gz

{metergraph_core-0.2.56/src/metergraph_core.egg-info → metergraph_core-0.2.58}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metergraph-core
-Version: 0.2.56
+Version: 0.2.58
 Summary: Reusable MeterGraph catalog and deterministic billing engine
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
@@ -109,6 +109,13 @@ IDs may intentionally repeat across execution profiles when gateway and
 Bedrock use different physical routes; each route therefore also has a unique
 internal `key`.
 
+A model entry may record `released`, the publisher's general-availability
+date as an ISO date. `models.release_date(canonical_id, load_catalog())`
+returns that date with basis `released`, or, when none is recorded, the
+earliest `effective_from` of the model's catalog prices with basis
+`first_price`, so a consumer can tell a launch date from a pricing date
+without computing the fallback itself.
+
 Use `validate_model_registry(models, load_catalog())` to verify that every
 route's provider-facing model ID is declared on its exact pricing channel,
 resolves to its canonical model, and has an active price on the registry

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/README.md

@@ -97,6 +97,13 @@ IDs may intentionally repeat across execution profiles when gateway and
 Bedrock use different physical routes; each route therefore also has a unique
 internal `key`.
 
+A model entry may record `released`, the publisher's general-availability
+date as an ISO date. `models.release_date(canonical_id, load_catalog())`
+returns that date with basis `released`, or, when none is recorded, the
+earliest `effective_from` of the model's catalog prices with basis
+`first_price`, so a consumer can tell a launch date from a pricing date
+without computing the fallback itself.
+
 Use `validate_model_registry(models, load_catalog())` to verify that every
 route's provider-facing model ID is declared on its exact pricing channel,
 resolves to its canonical model, and has an active price on the registry

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "metergraph-core"
-version = "0.2.56"
+version = "0.2.58"
 description = "Reusable MeterGraph catalog and deterministic billing engine"
 readme = "README.md"
 license = "Apache-2.0"

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/src/metergraph_core/__init__.py

@@ -32,6 +32,7 @@ from .models import (
     ModelRegistryError,
     ModelRoute,
     OfferGroup,
+    ReleaseDate,
     load_model_registry,
     parse_model_registry,
     validate_model_registry,
@@ -60,6 +61,7 @@ __all__ = [
     "ModelRegistryError",
     "ModelRoute",
     "OfferGroup",
+    "ReleaseDate",
     "GatewayBillingEvidence",
     "Price",
     "ResolvedPrice",

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/src/metergraph_core/catalog.py

@@ -209,19 +209,24 @@ class Price:
     # imply one: google-vertex-ai serves Anthropic's models beside Google's,
     # and the two report cache reads differently.
     publisher: str | None = None
+    # A fixed fee charged once per call on top of tokens, in USD per 1,000
+    # calls: a gateway billing a model's built-in search per request.
+    request_fee_per_1k_usd: Decimal | None = None
 
 
 @dataclass(frozen=True, slots=True)
 class CostComponents:
-    """A priced call's cost by what it paid for. The four parts sum to the
-    call's ``cost_usd`` exactly: each is quantized and the rounding residue
-    lands in the input part, so a consumer that stores them can rebuild the
-    total without a second rounding."""
+    """A priced call's cost by what it paid for. The parts sum to the call's
+    ``cost_usd`` exactly: each is quantized and the rounding residue lands in
+    the input part, so a consumer that stores them can rebuild the total
+    without a second rounding. ``request_usd`` is a per-call fee, zero on
+    every row that has none."""
 
     input_usd: Decimal
     output_usd: Decimal
     cache_read_usd: Decimal
     cache_write_usd: Decimal
+    request_usd: Decimal = Decimal("0")
 
 
 @dataclass(frozen=True, slots=True)
@@ -456,15 +461,20 @@ def _price_tokens(
             )
     if rules.get("uncaptured_fees"):
         reasons.append("uncaptured_fees")
+    request_usd = (
+        Decimal("0")
+        if price.request_fee_per_1k_usd is None
+        else price.request_fee_per_1k_usd / Decimal(1000)
+    )
 
     # The total is rounded once, as it always was; the parts are rounded
     # each and the residue goes to input, so they sum to the total exactly.
-    cost = (input_usd + output_usd + cache_read_usd + cache_write_usd).quantize(
+    cost = (input_usd + output_usd + cache_read_usd + cache_write_usd + request_usd).quantize(
         _COST_QUANTUM, rounding=ROUND_HALF_UP
     )
     parts = [
         part.quantize(_COST_QUANTUM, rounding=ROUND_HALF_UP)
-        for part in (input_usd, output_usd, cache_read_usd, cache_write_usd)
+        for part in (input_usd, output_usd, cache_read_usd, cache_write_usd, request_usd)
     ]
     parts[0] += cost - sum(parts)
     return cost, reasons, CostComponents(*parts)

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/src/metergraph_core/data/models.yaml

@@ -1,8 +1,9 @@
-version: '2026-10-07'
+version: '2026-10-09'
 models:
 - canonical_id: openai/gpt-5.6-sol
   display_name: GPT-5.6 Sol
   publisher: openai
+  released: '2026-07-09'  # https://x.com/OpenAI/status/2074704958419792299
   routes:
   - key: default:openai/gpt-5.6-sol
     id: openai/gpt-5.6-sol
@@ -29,6 +30,7 @@ models:
 - canonical_id: openai/gpt-5.6-luna
   display_name: GPT-5.6 Luna
   publisher: openai
+  released: '2026-07-09'  # https://x.com/OpenAI/status/2074704958419792299
   routes:
   - key: default:openai/gpt-5.6-luna
     id: openai/gpt-5.6-luna
@@ -55,6 +57,7 @@ models:
 - canonical_id: openai/gpt-6-luna
   display_name: GPT-6 Luna
   publisher: openai
+  released: '2026-09-22'  # https://community.openai.com/t/announcing-gpt-6-sol-and-gpt-6-luna-in-the-api-codex-and-chatgpt/1399925
   routes:
   - key: default:openai/gpt-6-luna
     id: openai/gpt-6-luna
@@ -66,6 +69,7 @@ models:
 - canonical_id: openai/gpt-6-sol
   display_name: GPT-6 Sol
   publisher: openai
+  released: '2026-09-22'  # https://community.openai.com/t/announcing-gpt-6-sol-and-gpt-6-luna-in-the-api-codex-and-chatgpt/1399925
   routes:
   - key: default:openai/gpt-6-sol
     id: openai/gpt-6-sol
@@ -77,6 +81,7 @@ models:
 - canonical_id: openai/gpt-6-astra
   display_name: GPT-6 Astra
   publisher: openai
+  released: '2026-09-04'  # https://en.wikipedia.org/wiki/GPT-6_Astra
   routes:
   - key: default:openai/gpt-6-astra
     id: openai/gpt-6-astra
@@ -88,6 +93,7 @@ models:
 - canonical_id: openai/gpt-5-mini
   display_name: GPT-5 Mini
   publisher: openai
+  released: '2025-08-07'  # https://openai.com/index/introducing-gpt-5/
   routes:
   - key: default:openai/gpt-5-mini
     id: openai/gpt-5-mini
@@ -99,6 +105,7 @@ models:
 - canonical_id: openai/gpt-5.6-terra
   display_name: GPT-5.6 Terra
   publisher: openai
+  released: '2026-07-09'  # https://x.com/OpenAI/status/2074704958419792299
   routes:
   - key: default:openai/gpt-5.6-terra
     id: openai/gpt-5.6-terra
@@ -125,6 +132,7 @@ models:
 - canonical_id: anthropic/claude-opus-5
   display_name: Claude Opus 5
   publisher: anthropic
+  released: '2026-07-24'  # https://github.com/jqueryscript/anthropic-claude-timeline
   routes:
   - key: default:anthropic/claude-opus-5
     id: anthropic/claude-opus-5
@@ -144,6 +152,7 @@ models:
 - canonical_id: anthropic/claude-sonnet-5
   display_name: Claude Sonnet 5
   publisher: anthropic
+  released: '2026-06-30'  # https://github.com/jqueryscript/anthropic-claude-timeline
   routes:
   - key: default:anthropic/claude-sonnet-5
     id: anthropic/claude-sonnet-5
@@ -170,6 +179,7 @@ models:
 - canonical_id: anthropic/claude-fable-5
   display_name: Claude Fable 5
   publisher: anthropic
+  released: '2026-06-09'  # https://github.com/jqueryscript/anthropic-claude-timeline
   routes:
   - key: default:anthropic/claude-fable-5
     id: anthropic/claude-fable-5
@@ -181,6 +191,7 @@ models:
 - canonical_id: anthropic/claude-fable-5.1
   display_name: Claude Fable 5.1
   publisher: anthropic
+  released: '2026-09-01'  # https://www.anthropic.com/claude/fable
   routes:
   - key: default:anthropic/claude-fable-5.1
     id: anthropic/claude-fable-5.1
@@ -192,6 +203,7 @@ models:
 - canonical_id: google/gemini-3.1-pro-preview
   display_name: Gemini 3.1 Pro Preview
   publisher: google
+  released: '2026-02-19'  # https://en.wikipedia.org/wiki/Gemini_(language_model)
   routes:
   - key: default:google/gemini-3.1-pro-preview
     id: google/gemini-3.1-pro-preview
@@ -203,6 +215,7 @@ models:
 - canonical_id: google/gemini-3.6-flash
   display_name: Gemini 3.6 Flash
   publisher: google
+  released: '2026-07-21'  # https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-6-flash
   routes:
   - key: default:google/gemini-3.6-flash
     id: google/gemini-3.6-flash
@@ -214,6 +227,7 @@ models:
 - canonical_id: google/gemini-3.8-flash
   display_name: Gemini 3.8 Flash
   publisher: google
+  released: '2026-09-02'  # https://emergent.sh/news/google-launches-gemini-3-8-flash-third-flash
   routes:
   - key: default:google/gemini-3.8-flash
     id: google/gemini-3.8-flash
@@ -225,6 +239,7 @@ models:
 - canonical_id: google/gemini-3.7-flash
   display_name: Gemini 3.7 Flash
   publisher: google
+  released: '2026-08-13'  # https://ai.google.dev/gemini-api/docs/models/gemini-3.7-flash
   routes:
   - key: default:google/gemini-3.7-flash
     id: google/gemini-3.7-flash
@@ -236,6 +251,7 @@ models:
 - canonical_id: google/gemini-3.5-flash
   display_name: Gemini 3.5 Flash
   publisher: google
+  released: '2026-05-19'  # https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/gemini/3-5-flash
   routes:
   - key: default:google/gemini-3.5-flash
     id: google/gemini-3.5-flash
@@ -247,6 +263,7 @@ models:
 - canonical_id: google/gemini-3.5-flash-lite
   display_name: Gemini 3.5 Flash-Lite
   publisher: google
+  released: '2026-07-21'  # https://datanorth.ai/news/google-releases-gemini-3-5-flash
   routes:
   - key: default:google/gemini-3.5-flash-lite
     id: google/gemini-3.5-flash-lite
@@ -258,6 +275,7 @@ models:
 - canonical_id: google/gemini-3.1-flash-lite
   display_name: Gemini 3.1 Flash-Lite
   publisher: google
+  released: '2026-05-07'  # https://cloud.google.com/blog/products/ai-machine-learning/gemini-3-1-flash-lite-is-now-generally-available
   routes:
   - key: default:google/gemini-3.1-flash-lite
     id: google/gemini-3.1-flash-lite
@@ -269,6 +287,7 @@ models:
 - canonical_id: google/gemma-4-31b-it
   display_name: Gemma 4 31B
   publisher: google
+  released: '2026-04-02'  # https://ai.google.dev/gemma/docs/releases
   routes:
   - key: default:google/gemma-4-31b-it
     id: google/gemma-4-31b-it
@@ -280,6 +299,7 @@ models:
 - canonical_id: google/gemma-4-26b-a4b-it
   display_name: Gemma 4 26B
   publisher: google
+  released: '2026-04-02'  # https://ai.google.dev/gemma/docs/releases
   routes:
   - key: default:google/gemma-4-26b-a4b-it
     id: google/gemma-4-26b-a4b-it
@@ -291,6 +311,7 @@ models:
 - canonical_id: moonshotai/kimi-k3
   display_name: Kimi K3
   publisher: moonshotai
+  released: '2026-07-16'  # https://en.wikipedia.org/wiki/Kimi_(AI)
   routes:
   - key: default:moonshotai/kimi-k3
     id: moonshotai/kimi-k3
@@ -302,6 +323,7 @@ models:
 - canonical_id: moonshotai/kimi-k2.5
   display_name: Kimi K2.5
   publisher: moonshotai
+  released: '2026-01-27'  # https://en.wikipedia.org/wiki/Kimi_(chatbot)
   routes:
   - key: default:moonshotai/kimi-k2.5
     id: moonshotai/kimi-k2.5
@@ -320,6 +342,7 @@ models:
 - canonical_id: minimax/minimax-m3
   display_name: MiniMax M3
   publisher: minimax
+  released: '2026-06-01'  # https://www.minimax.io/blog/minimax-m3
   routes:
   - key: default:minimax/minimax-m3
     id: minimax/minimax-m3
@@ -331,6 +354,7 @@ models:
 - canonical_id: deepseek/v4-pro
   display_name: DeepSeek V4 Pro
   publisher: deepseek
+  released: '2026-08-13'  # https://www.yottalabs.ai/post/deepseek-v4-release-date-specs-how-to-access-2026
   routes:
   - key: default:deepseek/deepseek-v4-pro
     id: deepseek/deepseek-v4-pro
@@ -342,6 +366,7 @@ models:
 - canonical_id: deepseek/v4-flash
   display_name: DeepSeek V4 Flash
   publisher: deepseek
+  released: '2026-07-31'  # https://www.lindy.ai/blog/deepseek-v4-flash
   routes:
   - key: default:deepseek/deepseek-v4-flash
     id: deepseek/deepseek-v4-flash
@@ -353,6 +378,7 @@ models:
 - canonical_id: xai/grok-4.1-fast-reasoning
   display_name: Grok 4.1 Fast Reasoning
   publisher: xai
+  released: '2025-11-19'  # https://x.ai/news/grok-4-1-fast
   routes:
   - key: default:xai/grok-4.1-fast-reasoning
     id: xai/grok-4.1-fast-reasoning
@@ -364,6 +390,7 @@ models:
 - canonical_id: xai/grok-4.1-fast-non-reasoning
   display_name: Grok 4.1 Fast
   publisher: xai
+  released: '2025-11-19'  # https://x.ai/news/grok-4-1-fast
   routes:
   - key: default:xai/grok-4.1-fast-non-reasoning
     id: xai/grok-4.1-fast-non-reasoning
@@ -375,6 +402,7 @@ models:
 - canonical_id: mistral/ministral-14b
   display_name: Ministral 3 14B
   publisher: mistral
+  released: '2025-12-02'  # https://mistral.ai/news/mistral-3
   routes:
   - key: default:mistral/ministral-14b
     id: mistral/ministral-14b
@@ -386,6 +414,7 @@ models:
 - canonical_id: nvidia/nemotron-3-super-120b-a12b
   display_name: Nemotron 3 Super
   publisher: nvidia
+  released: '2026-03-11'  # https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16
   routes:
   - key: default:nvidia/nemotron-3-super-120b-a12b
     id: nvidia/nemotron-3-super-120b-a12b
@@ -397,6 +426,7 @@ models:
 - canonical_id: zai/glm-5.3-flash
   display_name: GLM 5.3 Flash
   publisher: zai
+  released: '2026-08-26'  # https://emergent.sh/news/glm-5-3-flash-officially-launched
   routes:
   - key: default:zai/glm-5.3-flash
     id: zai/glm-5.3-flash
@@ -408,6 +438,7 @@ models:
 - canonical_id: deepseek/deepseek-v4.1-flash
   display_name: DeepSeek V4.1 Flash
   publisher: deepseek
+  released: '2026-09-10'  # https://llm-stats.com/models/deepseek-v4.1-flash
   routes:
   - key: default:deepseek/deepseek-v4.1-flash
     id: deepseek/deepseek-v4.1-flash
@@ -419,6 +450,7 @@ models:
 - canonical_id: alibaba/qwen3.8-flash
   display_name: Qwen 3.8 Flash
   publisher: alibaba
+  released: '2026-08-26'  # https://thenewstack.io/qwen38-flash-previews-qwen4/
   routes:
   - key: default:alibaba/qwen3.8-flash
     id: alibaba/qwen3.8-flash
@@ -430,6 +462,7 @@ models:
 - canonical_id: inception/mercury-2.5
   display_name: Mercury 2.5
   publisher: inception
+  released: '2026-09-08'  # https://runtimewire.com/article/inception-mercury-2-5-diffusion-language-model-launch
   routes:
   - key: default:inception/mercury-2.5
     id: inception/mercury-2.5
@@ -441,6 +474,7 @@ models:
 - canonical_id: openai/gpt-5.4-mini
   display_name: GPT-5.4 Mini
   publisher: openai
+  released: '2026-03-17'  # https://community.openai.com/t/introducing-gpt-5-4-mini-and-nano-our-most-capable-small-models-yet/1377015
   routes:
   - key: default:openai/gpt-5.4-mini
     id: openai/gpt-5.4-mini
@@ -460,6 +494,7 @@ models:
 - canonical_id: openai/gpt-5.4-nano
   display_name: GPT-5.4 Nano
   publisher: openai
+  released: '2026-03-17'  # https://community.openai.com/t/introducing-gpt-5-4-mini-and-nano-our-most-capable-small-models-yet/1377015
   routes:
   - key: default:openai/gpt-5.4-nano
     id: openai/gpt-5.4-nano
@@ -479,6 +514,7 @@ models:
 - canonical_id: anthropic/claude-opus-4.8
   display_name: Claude Opus 4.8
   publisher: anthropic
+  released: '2026-05-28'  # https://hidekazu-konishi.com/entry/anthropic_claude_model_release_timeline.html
   routes:
   - key: default:anthropic/claude-opus-4.8
     id: anthropic/claude-opus-4.8
@@ -498,6 +534,7 @@ models:
 - canonical_id: anthropic/claude-haiku-4.5
   display_name: Claude Haiku 4.5
   publisher: anthropic
+  released: '2025-10-15'  # https://www.anthropic.com/news/claude-haiku-4-5
   routes:
   - key: default:anthropic/claude-haiku-4.5
     id: anthropic/claude-haiku-4.5
@@ -517,6 +554,7 @@ models:
 - canonical_id: fireworks/glm-5p2
   display_name: GLM 5.2
   publisher: fireworks
+  released: '2026-06-13'  # https://pandaily.com/zhipu-ai-glm-5-dot-2-open-source-mit-jun2026
   routes:
   - key: default:fireworks:accounts/fireworks/models/glm-5p2
     id: fireworks:accounts/fireworks/models/glm-5p2
@@ -528,6 +566,7 @@ models:
 - canonical_id: fireworks/qwen3p7-plus
   display_name: Qwen 3.7 Plus
   publisher: fireworks
+  released: '2026-06-01'  # https://www.vals.ai/models/alibaba_qwen3.7-plus
   routes:
   - key: default:fireworks:accounts/fireworks/models/qwen3p7-plus
     id: fireworks:accounts/fireworks/models/qwen3p7-plus
@@ -539,6 +578,7 @@ models:
 - canonical_id: openai/gpt-5.4
   display_name: GPT-5.4
   publisher: openai
+  released: '2026-03-05'  # https://en.wikipedia.org/wiki/GPT-5.4
   routes:
   - key: default:openai:gpt-5.4
     id: openai:gpt-5.4
@@ -551,6 +591,7 @@ models:
 - canonical_id: google/gemma-3-27b-it
   display_name: Gemma 3 27B
   publisher: google
+  released: '2025-03-12'  # https://blog.google/technology/developers/gemma-3/
   routes:
   - key: bedrock:google/gemma-3-27b-it
     id: google/gemma-3-27b-it
@@ -562,6 +603,7 @@ models:
 - canonical_id: deepseek/v3.2
   display_name: DeepSeek V3.2
   publisher: deepseek
+  released: '2025-12-01'  # https://en.wikipedia.org/wiki/DeepSeek_(chatbot)
   routes:
   - key: bedrock:deepseek/deepseek-v3.2
     id: deepseek/deepseek-v3.2
@@ -573,6 +615,7 @@ models:
 - canonical_id: deepseek/v3.1
   display_name: DeepSeek V3.1
   publisher: deepseek
+  released: '2025-08-21'  # https://en.wikipedia.org/wiki/DeepSeek_(chatbot)
   routes:
   - key: bedrock:deepseek/deepseek-v3.1
     id: deepseek/deepseek-v3.1
@@ -584,6 +627,7 @@ models:
 - canonical_id: anthropic/claude-opus-5.5
   display_name: Claude Opus 5.5
   publisher: anthropic
+  released: '2026-09-22'  # https://www.anthropic.com/claude-opus-5-5
   routes:
   - key: default:anthropic/claude-opus-5.5
     id: anthropic/claude-opus-5.5
@@ -595,6 +639,7 @@ models:
 - canonical_id: anthropic/claude-sonnet-5.5
   display_name: Claude Sonnet 5.5
   publisher: anthropic
+  released: '2026-09-28'  # https://www.anthropic.com/claude/sonnet
   routes:
   - key: default:anthropic/claude-sonnet-5.5
     id: anthropic/claude-sonnet-5.5
@@ -606,6 +651,7 @@ models:
 - canonical_id: openai/gpt-6.1-sol
   display_name: GPT-6.1 Sol
   publisher: openai
+  released: '2026-09-29'  # https://www.sitepoint.com/gpt-6-1-sol-developers-pricing-quickstart/
   routes:
   - key: default:openai/gpt-6.1-sol
     id: openai/gpt-6.1-sol
@@ -617,6 +663,7 @@ models:
 - canonical_id: xai/grok-4.7
   display_name: Grok 4.7
   publisher: xai
+  released: '2026-09-21'  # https://x.ai/news
   routes:
   - key: default:xai/grok-4.7
     id: xai/grok-4.7
@@ -628,6 +675,7 @@ models:
 - canonical_id: moonshotai/kimi-k2.7-code
   display_name: Kimi K2.7 Code
   publisher: moonshotai
+  released: '2026-06-12'  # https://www.marktechpost.com/2026/06/12/moonshot-ai-releases-kimi-k2-7-code-a-coding-model-reporting-21-8-on-kimi-code-bench-v2-over-k2-6/
   routes:
   - key: default:moonshotai/kimi-k2.7-code
     id: moonshotai/kimi-k2.7-code
@@ -639,6 +687,7 @@ models:
 - canonical_id: zai/glm-5.3
   display_name: GLM 5.3
   publisher: zai
+  released: '2026-08-14'  # https://emergent.sh/news/glm-53-officially-launched-1e1dc
   routes:
   - key: default:zai/glm-5.3
     id: zai/glm-5.3
@@ -647,6 +696,30 @@ models:
     pricing_channel: vercel-ai-gateway
     execution_profiles:
     - default
+- canonical_id: anthropic/claude-sonnet-4.6
+  display_name: Claude Sonnet 4.6
+  publisher: anthropic
+  released: '2026-02-17'  # https://alternativeto.net/news/2026/2/anthropic-s-claude-sonnet-4-6-launches-with-faster-speeds-and-1m-token-context
+  routes:
+  - key: default:anthropic/claude-sonnet-4.6
+    id: anthropic/claude-sonnet-4.6
+    provider: vercel
+    model_id: anthropic/claude-sonnet-4.6
+    pricing_channel: vercel-ai-gateway
+    execution_profiles:
+    - default
+- canonical_id: xai/grok-4.3
+  display_name: Grok 4.3
+  publisher: xai
+  released: '2026-04-30'  # https://artificialanalysis.ai/articles/xai-launches-grok-4-3-with-improved-agentic-performance-and-lower-pricing
+  routes:
+  - key: default:xai/grok-4.3
+    id: xai/grok-4.3
+    provider: vercel
+    model_id: xai/grok-4.3
+    pricing_channel: vercel-ai-gateway
+    execution_profiles:
+    - default
 execution_profiles:
 - id: default
   routes:
@@ -705,6 +778,8 @@ execution_profiles:
   - default:anthropic:claude-opus-4-8
   - default:anthropic:claude-sonnet-5
   - default:anthropic:claude-haiku-4-5
+  - default:anthropic/claude-sonnet-4.6
+  - default:xai/grok-4.3
 - id: bedrock
   routes:
   - bedrock:anthropic/claude-sonnet-5
@@ -762,6 +837,8 @@ offer_groups:
   - default:xai/grok-4.7
   - default:moonshotai/kimi-k2.7-code
   - default:zai/glm-5.3
+  - default:anthropic/claude-sonnet-4.6
+  - default:xai/grok-4.3
 - id: fireworks
   credential: FIREWORKS_API_KEY
   routes:

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/src/metergraph_core/data/prices.yaml

@@ -2029,6 +2029,7 @@ models:
       - {provider: x-ai, alias: grok-latest, channel: xai-api}
       - {provider: bedrock, alias: xai.grok-4.3, channel: aws-bedrock}
       - {provider: vercel, alias: spacexai/grok-4.3, channel: vercel-ai-gateway}
+      - {provider: xai, alias: xai/grok-4.3, channel: vercel-ai-gateway}
       - {provider: litellm, alias: grok-4.3, channel: xai-api}
       - {provider: litellm, alias: grok-4.3-latest, channel: xai-api}
       - {provider: unknown, alias: grok-4.3, channel: xai-api}
@@ -2077,6 +2078,7 @@ models:
       - {provider: litellm, alias: sonar, channel: perplexity-api}
       - {provider: perplexity-ai, alias: perplexity/sonar, channel: perplexity-api}
       - {provider: unknown, alias: sonar, channel: perplexity-api}
+      - {provider: vercel, alias: perplexity/sonar, channel: vercel-ai-gateway}
     prices:
       - channel: perplexity-api
         region: global
@@ -2086,6 +2088,15 @@ models:
         rules:
           uncaptured_fees: true
         source_url: https://docs.perplexity.ai/docs/getting-started/pricing
+      # The gateway bills Sonar's built-in search per call, so the row carries
+      # it as a request fee and the call is priced in full.
+      - channel: vercel-ai-gateway
+        region: global
+        effective_from: "2026-10-11"
+        input_per_mtok: 0.25
+        output_per_mtok: 2.50
+        request_fee_per_1k_usd: 2.50
+        source_url: https://vercel.com/ai-gateway/models/sonar
 
   - canonical_id: openai/gpt-5-mini
     publisher: openai

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/src/metergraph_core/loader.py

@@ -305,6 +305,7 @@ def parse_catalog(
                     ),
                     batch_input_per_mtok=_decimal(price.get("batch_input_per_mtok")),
                     batch_output_per_mtok=_decimal(price.get("batch_output_per_mtok")),
+                    request_fee_per_1k_usd=_decimal(price.get("request_fee_per_1k_usd")),
                     rules=_freeze(price.get("rules") or {}),
                     effective_from=effective_from,
                     effective_to=effective_to,

{metergraph_core-0.2.56 → metergraph_core-0.2.58}/src/metergraph_core/models.py

@@ -76,6 +76,19 @@ class ModelDefinition:
     display_name: str
     publisher: str
     routes: tuple[ModelRoute, ...]
+    # The publisher's general-availability date, when recorded.
+    released: date | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class ReleaseDate:
+    """When a model became available, and what that date is based on:
+    ``released`` is the registry's recorded date; ``first_price`` is the
+    earliest price window the catalog has for the model, used when no date
+    is recorded."""
+
+    date: date
+    basis: str
 
 
 @dataclass(frozen=True, slots=True)
@@ -96,6 +109,36 @@ class ModelRegistry:
     def model(self, canonical_id: str) -> ModelDefinition:
         return self.models[canonical_id]
 
+    def release_date(
+        self, canonical_id: str, catalog: LoadedCatalog
+    ) -> ReleaseDate | None:
+        """The model's release date: recorded when the registry has one,
+        otherwise the earliest ``effective_from`` of its catalog prices, or
+        None when neither exists. Callers never compute the fallback
+        themselves, so every product reads the same answer."""
+        model = self.models.get(canonical_id)
+        if model is not None and model.released is not None:
+            return ReleaseDate(model.released, "released")
+        entry = next(
+            (
+                entry
+                for entry in catalog.document.get("models", [])
+                if entry.get("canonical_id") == canonical_id
+            ),
+            None,
+        )
+        # A price window starts on a date or a timestamp; the catalog accepts
+        # both, so both are read here.
+        first_price = min(
+            (
+                _window_day(price["effective_from"])
+                for price in (entry or {}).get("prices", [])
+                if price.get("effective_from") is not None
+            ),
+            default=None,
+        )
+        return None if first_price is None else ReleaseDate(first_price, "first_price")
+
     def route(self, route_key: str) -> ModelRoute:
         return self.routes[route_key]
 
@@ -152,6 +195,29 @@ def _unique_text_list(value: Any, field: str) -> tuple[str, ...]:
     return items
 
 
+def _window_day(value: Any) -> date:
+    """The calendar day a catalog price window starts, from a date or a
+    timestamp as the catalog loader accepts them."""
+    if isinstance(value, datetime):
+        return value.date()
+    if isinstance(value, date):
+        return value
+    return datetime.fromisoformat(str(value)).date()
+
+
+def _optional_date(value: Any, field: str) -> date | None:
+    """An ISO calendar date, or None when absent. A datetime is not accepted:
+    a release is a day, and the registry version is already a date."""
+    if value is None:
+        return None
+    if isinstance(value, date) and not isinstance(value, datetime):
+        return value
+    try:
+        return date.fromisoformat(str(value))
+    except ValueError as exc:
+        raise ModelRegistryError(f"{field} must be an ISO date") from exc
+
+
 def _registry_version_date(version: str) -> date:
     date_value, separator, revision = version.partition(".")
     try:
@@ -194,6 +260,7 @@ def parse_model_registry(document: Any) -> ModelRegistry:
             raise ModelRegistryError(
                 f"{canonical_id}: publisher {publisher!r} does not match canonical id"
             )
+        released = _optional_date(model.get("released"), f"{canonical_id}: released")
         model_routes: list[ModelRoute] = []
         route_values = _list(model.get("routes"), f"{canonical_id}: routes")
         if not route_values:
@@ -263,6 +330,7 @@ def parse_model_registry(document: Any) -> ModelRegistry:
             display_name=display_name,
             publisher=publisher,
             routes=tuple(model_routes),
+            released=released,
         )
 
     execution_profiles: dict[str, tuple[str, ...]] = {}

{metergraph_core-0.2.56 → metergraph_core-0.2.58/src/metergraph_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metergraph-core
-Version: 0.2.56
+Version: 0.2.58
 Summary: Reusable MeterGraph catalog and deterministic billing engine
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
@@ -109,6 +109,13 @@ IDs may intentionally repeat across execution profiles when gateway and
 Bedrock use different physical routes; each route therefore also has a unique
 internal `key`.
 
+A model entry may record `released`, the publisher's general-availability
+date as an ISO date. `models.release_date(canonical_id, load_catalog())`
+returns that date with basis `released`, or, when none is recorded, the
+earliest `effective_from` of the model's catalog prices with basis
+`first_price`, so a consumer can tell a launch date from a pricing date
+without computing the fallback itself.
+
 Use `validate_model_registry(models, load_catalog())` to verify that every
 route's provider-facing model ID is declared on its exact pricing channel,
 resolves to its canonical model, and has an active price on the registry