metergraph-core 0.5.0__tar.gz → 0.5.2__tar.gz

{metergraph_core-0.5.0 → metergraph_core-0.5.2}/PKG-INFO

@@ -1,8 +1,26 @@
 Metadata-Version: 2.4
 Name: metergraph-core
-Version: 0.5.0
-Summary: Reusable MeterGraph catalog and deterministic billing engine
+Version: 0.5.2
+Summary: Open, effective-dated LLM pricing catalog and deterministic cost calculator for popular models across major providers and gateways, including OpenAI, Anthropic, Google Gemini, AWS Bedrock, OpenRouter, Vercel AI Gateway, and more.
+Author: Metergraph
 License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/metergraph/metergraph
+Project-URL: Documentation, https://github.com/metergraph/metergraph/tree/main/core#readme
+Project-URL: Source, https://github.com/metergraph/metergraph/tree/main/core
+Project-URL: Issues, https://github.com/metergraph/metergraph/issues
+Project-URL: Release notes, https://github.com/metergraph/metergraph/releases
+Keywords: llm,pricing,cost,token-pricing,model-catalog,llm-pricing,model-pricing,token-cost,cost-calculation,openai,anthropic,gemini,bedrock,openrouter,vercel-ai-gateway,finops
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: pyyaml>=6.0
@@ -12,22 +30,9 @@ Requires-Dist: pytest>=8; extra == "dev"
 
 # metergraph-core
 
-Reusable model registry, price catalog, and deterministic billing engine for
-MeterGraph.
-
-`metergraph-core` owns two separate public datasets. `models.yaml` records
-canonical model identity, customer-facing names, executable provider routes,
-and the ordered candidate fields MeterGraph products offer. `prices.yaml`
-records effective-dated rates and billing rules. Core parses and validates both
-datasets, resolves provider aliases and routes, calculates deterministic costs,
-and selects a qualified gateway-reported charge or catalog estimate as the
-effective call cost. A third dataset, `sources.yaml`, registers the official
-pricing sources that keep `prices.yaml` current; see
-[Source registry](#source-registry).
-
-It does not own HTTP routes, database access, migrations, authentication,
-tenancy, ingest, dashboard code, or any hosted-only concern, and it never reads
-server environment variables.
+Calculate the cost of an LLM call from its model, provider, tokens, region, and
+date. `metergraph-core` ships an open, effective-dated model pricing catalog and
+a deterministic Python cost engine.
 
 ## Install
 
@@ -53,6 +58,32 @@ result = catalog.snapshot.cost(
 print(result.canonical_model, result.price_id, result.cost_usd, result.status)
 ```
 
+The result names the canonical model and the catalog price row it was billed
+at, so every cost traces back to an effective-dated rate.
+
+## Package scope
+
+`metergraph-core` is the reusable model registry, price catalog, and
+deterministic billing engine for
+[Metergraph](https://github.com/metergraph/metergraph), which attributes LLM
+cost to the function, agent, and workflow that made each call.
+
+It owns two separate public datasets. `models.yaml` records
+canonical model identity, customer-facing names, executable provider routes,
+and the ordered candidate fields MeterGraph products offer. `prices.yaml`
+records effective-dated rates and billing rules. Core parses and validates both
+datasets, resolves provider aliases and routes, calculates deterministic costs,
+and selects a qualified gateway-reported charge or catalog estimate as the
+effective call cost. A third dataset, `sources.yaml`, registers the official
+pricing sources that keep `prices.yaml` current; see
+[Source registry](#source-registry).
+
+It does not own HTTP routes, database access, migrations, authentication,
+tenancy, ingest, dashboard code, or any hosted-only concern, and it never reads
+server environment variables.
+
+## Loading catalogs
+
 `load_catalog()` loads the catalog bundled in the installed package. Pass an
 explicit `path` for tests or a self-hosted catalog replacement. The returned
 `LoadedCatalog` exposes the declared catalog `version`, the SHA-256

metergraph_core-0.5.0/src/metergraph_core.egg-info/PKG-INFO → metergraph_core-0.5.2/README.md

@@ -1,33 +1,8 @@
-Metadata-Version: 2.4
-Name: metergraph-core
-Version: 0.5.0
-Summary: Reusable MeterGraph catalog and deterministic billing engine
-License-Expression: Apache-2.0
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: pyyaml>=6.0
-Provides-Extra: dev
-Requires-Dist: build>=1.2; extra == "dev"
-Requires-Dist: pytest>=8; extra == "dev"
-
 # metergraph-core
 
-Reusable model registry, price catalog, and deterministic billing engine for
-MeterGraph.
-
-`metergraph-core` owns two separate public datasets. `models.yaml` records
-canonical model identity, customer-facing names, executable provider routes,
-and the ordered candidate fields MeterGraph products offer. `prices.yaml`
-records effective-dated rates and billing rules. Core parses and validates both
-datasets, resolves provider aliases and routes, calculates deterministic costs,
-and selects a qualified gateway-reported charge or catalog estimate as the
-effective call cost. A third dataset, `sources.yaml`, registers the official
-pricing sources that keep `prices.yaml` current; see
-[Source registry](#source-registry).
-
-It does not own HTTP routes, database access, migrations, authentication,
-tenancy, ingest, dashboard code, or any hosted-only concern, and it never reads
-server environment variables.
+Calculate the cost of an LLM call from its model, provider, tokens, region, and
+date. `metergraph-core` ships an open, effective-dated model pricing catalog and
+a deterministic Python cost engine.
 
 ## Install
 
@@ -53,6 +28,32 @@ result = catalog.snapshot.cost(
 print(result.canonical_model, result.price_id, result.cost_usd, result.status)
 ```
 
+The result names the canonical model and the catalog price row it was billed
+at, so every cost traces back to an effective-dated rate.
+
+## Package scope
+
+`metergraph-core` is the reusable model registry, price catalog, and
+deterministic billing engine for
+[Metergraph](https://github.com/metergraph/metergraph), which attributes LLM
+cost to the function, agent, and workflow that made each call.
+
+It owns two separate public datasets. `models.yaml` records
+canonical model identity, customer-facing names, executable provider routes,
+and the ordered candidate fields MeterGraph products offer. `prices.yaml`
+records effective-dated rates and billing rules. Core parses and validates both
+datasets, resolves provider aliases and routes, calculates deterministic costs,
+and selects a qualified gateway-reported charge or catalog estimate as the
+effective call cost. A third dataset, `sources.yaml`, registers the official
+pricing sources that keep `prices.yaml` current; see
+[Source registry](#source-registry).
+
+It does not own HTTP routes, database access, migrations, authentication,
+tenancy, ingest, dashboard code, or any hosted-only concern, and it never reads
+server environment variables.
+
+## Loading catalogs
+
 `load_catalog()` loads the catalog bundled in the installed package. Pass an
 explicit `path` for tests or a self-hosted catalog replacement. The returned
 `LoadedCatalog` exposes the declared catalog `version`, the SHA-256

metergraph_core-0.5.2/pyproject.toml

@@ -0,0 +1,62 @@
+[project]
+name = "metergraph-core"
+version = "0.5.2"
+description = "Open, effective-dated LLM pricing catalog and deterministic cost calculator for popular models across major providers and gateways, including OpenAI, Anthropic, Google Gemini, AWS Bedrock, OpenRouter, Vercel AI Gateway, and more."
+readme = "README.md"
+license = "Apache-2.0"
+authors = [{ name = "Metergraph" }]
+requires-python = ">=3.10"
+keywords = [
+    "llm",
+    "pricing",
+    "cost",
+    "token-pricing",
+    "model-catalog",
+    "llm-pricing",
+    "model-pricing",
+    "token-cost",
+    "cost-calculation",
+    "openai",
+    "anthropic",
+    "gemini",
+    "bedrock",
+    "openrouter",
+    "vercel-ai-gateway",
+    "finops",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pyyaml>=6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/metergraph/metergraph"
+Documentation = "https://github.com/metergraph/metergraph/tree/main/core#readme"
+Source = "https://github.com/metergraph/metergraph/tree/main/core"
+Issues = "https://github.com/metergraph/metergraph/issues"
+"Release notes" = "https://github.com/metergraph/metergraph/releases"
+
+[project.optional-dependencies]
+dev = ["build>=1.2", "pytest>=8"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+metergraph_core = ["data/models.yaml", "data/prices.yaml", "data/sources.yaml"]

{metergraph_core-0.5.0 → metergraph_core-0.5.2}/src/metergraph_core/data/prices.yaml

@@ -6,9 +6,9 @@
 #
 # Community updates welcome: add an alias or price entry with its provider
 # source_url and open a PR. CI validates structure and date overlaps.
-version: "2026-10-20"
+version: "2026-10-21"
 currency: USD
-pricing_verified_at: "2026-10-20"
+pricing_verified_at: "2026-10-21"
 models:
   - canonical_id: openai/gpt-6-sol
     publisher: openai
@@ -2980,6 +2980,7 @@ models:
         channel: vercel-ai-gateway
         rules:
           input_includes_cache_read: true
+      - {provider: meta, alias: muse-spark-1.3, channel: meta-api, rules: {input_includes_cache_read: true}}
     prices:
       - channel: vercel-ai-gateway
         region: global
@@ -2988,6 +2989,13 @@ models:
         output_per_mtok: 4.25
         cache_read_per_mtok: 0.15
         source_url: https://ai-gateway.vercel.sh/v1/models
+      - channel: meta-api
+        region: global
+        effective_from: "2026-09-11"
+        input_per_mtok: 1.25
+        output_per_mtok: 4.25
+        cache_read_per_mtok: 0.15
+        source_url: https://vercel.com/ai-gateway/models/muse-spark-1.3
 
   - canonical_id: thinkingmachines/inkling
     publisher: thinkingmachines

{metergraph_core-0.5.0 → metergraph_core-0.5.2}/src/metergraph_core/extractors.py

@@ -192,27 +192,44 @@ def parse_anthropic(html_text: str, *, duplicates: list[str] | None = None) -> T
 
 
 _GOOGLE_LABELS = ("Input price", "Output price", "Context caching price")
+_GOOGLE_ID = re.compile(r"[a-z0-9][a-z0-9.-]*")
+
+
+def _google_ids(cells: list[str]) -> list[str]:
+    """The model ids ending a block's heading: one id, or several joined by
+    "and" when a variant shares the model's prices. A lowercase cell not
+    joined by "and" is not an id."""
+    ids: list[str] = []
+    end = len(cells)
+    while end and cells[end - 1] != "and" and _GOOGLE_ID.fullmatch(cells[end - 1]):
+        ids.insert(0, cells[end - 1])
+        if end < 2 or cells[end - 2] != "and":
+            break
+        end -= 2
+    return ids
 
 
 def parse_google(html_text: str, *, duplicates: list[str] | None = None) -> Table:
     """The Gemini API page: each model's id precedes its "Try it" link, and
     its paid-tier prices follow. Where a price is dated the first amount is
-    the one in effect; per-image output is not a token rate."""
+    the one in effect; per-image output is not a token rate. A label may name
+    the media it covers, as in "Input price (text, image, video)"."""
     parts = page_text(html_text).split("Try it in Google AI Studio")
     tier = r"(?:Free of charge \| |Not available \| )?([^|]*\$[^|]*)"
     table: Table = {}
     for before, block in zip(parts, parts[1:]):
-        cells = [c.strip() for c in before.split("|") if c.strip()]
-        if not cells or not re.fullmatch(r"[a-z0-9][a-z0-9.-]*", cells[-1]):
+        ids = _google_ids([c.strip() for c in before.split("|") if c.strip()])
+        if not ids:
             continue
-        inp = re.search(r"Input price \| " + tier, block)
+        inp = re.search(r"Input price[^|]*\| " + tier, block)
         out = re.search(r"Output price[^|]*\| " + tier, block)
         if not (inp and out):
             continue
-        cache = re.search(r"Context caching price \| " + tier, block)
+        cache = re.search(r"Context caching price[^|]*\| " + tier, block)
         output = None if "per image" in out.group(1) else dollars(out.group(1))
         rates = {"input": dollars(inp.group(1)), "output": output, "cache_read": dollars(cache.group(1)) if cache else None}
-        _keep_first(table, cells[-1], {k: v for k, v in rates.items() if v is not None}, duplicates)
+        for model_id in ids:
+            _keep_first(table, model_id, {k: v for k, v in rates.items() if v is not None}, duplicates)
     return table
 
 

metergraph_core-0.5.0/README.md → metergraph_core-0.5.2/src/metergraph_core.egg-info/PKG-INFO

@@ -1,21 +1,38 @@
-# metergraph-core
-
-Reusable model registry, price catalog, and deterministic billing engine for
-MeterGraph.
+Metadata-Version: 2.4
+Name: metergraph-core
+Version: 0.5.2
+Summary: Open, effective-dated LLM pricing catalog and deterministic cost calculator for popular models across major providers and gateways, including OpenAI, Anthropic, Google Gemini, AWS Bedrock, OpenRouter, Vercel AI Gateway, and more.
+Author: Metergraph
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/metergraph/metergraph
+Project-URL: Documentation, https://github.com/metergraph/metergraph/tree/main/core#readme
+Project-URL: Source, https://github.com/metergraph/metergraph/tree/main/core
+Project-URL: Issues, https://github.com/metergraph/metergraph/issues
+Project-URL: Release notes, https://github.com/metergraph/metergraph/releases
+Keywords: llm,pricing,cost,token-pricing,model-catalog,llm-pricing,model-pricing,token-cost,cost-calculation,openai,anthropic,gemini,bedrock,openrouter,vercel-ai-gateway,finops
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
 
-`metergraph-core` owns two separate public datasets. `models.yaml` records
-canonical model identity, customer-facing names, executable provider routes,
-and the ordered candidate fields MeterGraph products offer. `prices.yaml`
-records effective-dated rates and billing rules. Core parses and validates both
-datasets, resolves provider aliases and routes, calculates deterministic costs,
-and selects a qualified gateway-reported charge or catalog estimate as the
-effective call cost. A third dataset, `sources.yaml`, registers the official
-pricing sources that keep `prices.yaml` current; see
-[Source registry](#source-registry).
+# metergraph-core
 
-It does not own HTTP routes, database access, migrations, authentication,
-tenancy, ingest, dashboard code, or any hosted-only concern, and it never reads
-server environment variables.
+Calculate the cost of an LLM call from its model, provider, tokens, region, and
+date. `metergraph-core` ships an open, effective-dated model pricing catalog and
+a deterministic Python cost engine.
 
 ## Install
 
@@ -41,6 +58,32 @@ result = catalog.snapshot.cost(
 print(result.canonical_model, result.price_id, result.cost_usd, result.status)
 ```
 
+The result names the canonical model and the catalog price row it was billed
+at, so every cost traces back to an effective-dated rate.
+
+## Package scope
+
+`metergraph-core` is the reusable model registry, price catalog, and
+deterministic billing engine for
+[Metergraph](https://github.com/metergraph/metergraph), which attributes LLM
+cost to the function, agent, and workflow that made each call.
+
+It owns two separate public datasets. `models.yaml` records
+canonical model identity, customer-facing names, executable provider routes,
+and the ordered candidate fields MeterGraph products offer. `prices.yaml`
+records effective-dated rates and billing rules. Core parses and validates both
+datasets, resolves provider aliases and routes, calculates deterministic costs,
+and selects a qualified gateway-reported charge or catalog estimate as the
+effective call cost. A third dataset, `sources.yaml`, registers the official
+pricing sources that keep `prices.yaml` current; see
+[Source registry](#source-registry).
+
+It does not own HTTP routes, database access, migrations, authentication,
+tenancy, ingest, dashboard code, or any hosted-only concern, and it never reads
+server environment variables.
+
+## Loading catalogs
+
 `load_catalog()` loads the catalog bundled in the installed package. Pass an
 explicit `path` for tests or a self-hosted catalog replacement. The returned
 `LoadedCatalog` exposes the declared catalog `version`, the SHA-256

metergraph_core-0.5.0/pyproject.toml

@@ -1,23 +0,0 @@
-[project]
-name = "metergraph-core"
-version = "0.5.0"
-description = "Reusable MeterGraph catalog and deterministic billing engine"
-readme = "README.md"
-license = "Apache-2.0"
-requires-python = ">=3.10"
-dependencies = [
-    "pyyaml>=6.0",
-]
-
-[project.optional-dependencies]
-dev = ["build>=1.2", "pytest>=8"]
-
-[build-system]
-requires = ["setuptools>=68"]
-build-backend = "setuptools.build_meta"
-
-[tool.setuptools.packages.find]
-where = ["src"]
-
-[tool.setuptools.package-data]
-metergraph_core = ["data/models.yaml", "data/prices.yaml", "data/sources.yaml"]