metergraph-core 0.4.0__tar.gz → 0.5.1__tar.gz

{metergraph_core-0.4.0 → metergraph_core-0.5.1}/PKG-INFO

@@ -1,8 +1,26 @@
 Metadata-Version: 2.4
 Name: metergraph-core
-Version: 0.4.0
-Summary: Reusable MeterGraph catalog and deterministic billing engine
+Version: 0.5.1
+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
@@ -229,7 +260,7 @@ A pricing delta proposes changes to a catalog's price rows. It is a change
 artifact to review and apply, never a catalog to serve.
 
 ```yaml
-schema_version: 1
+schema_version: 2
 kind: pricing_delta
 provenance:
   observations: [openai-api-pricing@2026-10-20]
@@ -326,12 +357,12 @@ only the labels, headers and key paths that parser relies on, so a price change
 or a newly listed model keeps the fingerprint and a format change alters it.
 Extractors never fetch. The package adds no browser or LLM dependency.
 
-## Refresh and discovery scripts
+## Pricing maintenance scripts
 
-Two repository scripts run the registry against live sources. Neither holds
-credentials, applies a delta, writes the catalog, publishes, or touches GitHub.
+The repository scripts run the registry against live sources without credentials
+or GitHub access.
 
-Neither ever emits, stores or redistributes raw fetched page content. Their
+The fetch-capable scripts never emit, store or redistribute raw page content. Their
 reports and evidence files hold only structural fingerprints, normalized
 extracted values (row labels as slugs, parsed amounts, numeric candidates),
 candidates, operations and short non-verbatim diagnostics. No output may name
@@ -354,7 +385,7 @@ an escalation, and 1 on error.
 behind a refresh report's escalations (`--escalations`), and new-source content
 from a file or stdin (`--new-source`, never a URL). It prints evidence for each:
 candidate and prior values, the reason for review, normalized page facts, and a
-proposed delta for changed catalog rows. An optional adapter
+proposed delta for supported catalog changes. An optional adapter
 (`--llm-adapter module:callable`) is called as
 `propose(source, content, current_rows)` and returns delta operations. Its
 output is kept as review evidence only after it passes schema validation and
@@ -362,7 +393,20 @@ encodes as strict JSON. Adapter failures and rejected items are reported with
 stable codes, never with the adapter's own text. Everything discovery emits
 requires review.
 
-Both read `<source-id>.*` files from `--content-dir` instead of fetching. The
+For structured gateway feeds, discovery also proposes `add_model` and
+`add_alias` operations when an exact model identity is safe to extend. Free,
+conditional, tiered, regional and unsupported-charge rows remain exclusions.
+After review, `scripts/apply_price_delta.py --reviewed` writes additive operations
+to a new catalog path while preserving existing comments. It rejects in-place
+writes and history-changing operations, then verifies the rendered catalog
+against the pure delta result.
+
+Apply overlapping gateway sources sequentially. Run discovery for the next
+source against the prior candidate so a shared new model becomes an alias and
+price on one canonical entry instead of a conflicting second `add_model`.
+
+The fetch-capable scripts read `<source-id>.*` files from `--content-dir` instead
+of fetching. The
 tests use one synthetic fixture per low-risk source, plus OpenAI's, in
 `tests/fixtures/sources/`, reproducing only the structure its parser reads;
 the generic discovery parsers are tested on small inline synthetic pages.

metergraph_core-0.4.0/src/metergraph_core.egg-info/PKG-INFO → metergraph_core-0.5.1/README.md

@@ -1,33 +1,8 @@
-Metadata-Version: 2.4
-Name: metergraph-core
-Version: 0.4.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
@@ -229,7 +230,7 @@ A pricing delta proposes changes to a catalog's price rows. It is a change
 artifact to review and apply, never a catalog to serve.
 
 ```yaml
-schema_version: 1
+schema_version: 2
 kind: pricing_delta
 provenance:
   observations: [openai-api-pricing@2026-10-20]
@@ -326,12 +327,12 @@ only the labels, headers and key paths that parser relies on, so a price change
 or a newly listed model keeps the fingerprint and a format change alters it.
 Extractors never fetch. The package adds no browser or LLM dependency.
 
-## Refresh and discovery scripts
+## Pricing maintenance scripts
 
-Two repository scripts run the registry against live sources. Neither holds
-credentials, applies a delta, writes the catalog, publishes, or touches GitHub.
+The repository scripts run the registry against live sources without credentials
+or GitHub access.
 
-Neither ever emits, stores or redistributes raw fetched page content. Their
+The fetch-capable scripts never emit, store or redistribute raw page content. Their
 reports and evidence files hold only structural fingerprints, normalized
 extracted values (row labels as slugs, parsed amounts, numeric candidates),
 candidates, operations and short non-verbatim diagnostics. No output may name
@@ -354,7 +355,7 @@ an escalation, and 1 on error.
 behind a refresh report's escalations (`--escalations`), and new-source content
 from a file or stdin (`--new-source`, never a URL). It prints evidence for each:
 candidate and prior values, the reason for review, normalized page facts, and a
-proposed delta for changed catalog rows. An optional adapter
+proposed delta for supported catalog changes. An optional adapter
 (`--llm-adapter module:callable`) is called as
 `propose(source, content, current_rows)` and returns delta operations. Its
 output is kept as review evidence only after it passes schema validation and
@@ -362,7 +363,20 @@ encodes as strict JSON. Adapter failures and rejected items are reported with
 stable codes, never with the adapter's own text. Everything discovery emits
 requires review.
 
-Both read `<source-id>.*` files from `--content-dir` instead of fetching. The
+For structured gateway feeds, discovery also proposes `add_model` and
+`add_alias` operations when an exact model identity is safe to extend. Free,
+conditional, tiered, regional and unsupported-charge rows remain exclusions.
+After review, `scripts/apply_price_delta.py --reviewed` writes additive operations
+to a new catalog path while preserving existing comments. It rejects in-place
+writes and history-changing operations, then verifies the rendered catalog
+against the pure delta result.
+
+Apply overlapping gateway sources sequentially. Run discovery for the next
+source against the prior candidate so a shared new model becomes an alias and
+price on one canonical entry instead of a conflicting second `add_model`.
+
+The fetch-capable scripts read `<source-id>.*` files from `--content-dir` instead
+of fetching. The
 tests use one synthetic fixture per low-risk source, plus OpenAI's, in
 `tests/fixtures/sources/`, reproducing only the structure its parser reads;
 the generic discovery parsers are tested on small inline synthetic pages.

metergraph_core-0.5.1/pyproject.toml

@@ -0,0 +1,62 @@
+[project]
+name = "metergraph-core"
+version = "0.5.1"
+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.4.0 → metergraph_core-0.5.1}/src/metergraph_core/__init__.py

@@ -50,7 +50,7 @@ from .retrieval import (
     RetrievalPrice,
 )
 from .catalog_delta import (
-    PRICING_DELTA_SCHEMA_VERSION,
+    CATALOG_DELTA_SCHEMA_VERSION,
     CatalogDelta,
     CatalogDeltaConflict,
     CatalogDeltaError,
@@ -85,6 +85,7 @@ from .sources import (
 
 __all__ = [
     "CatalogDelta",
+    "CATALOG_DELTA_SCHEMA_VERSION",
     "CatalogDeltaConflict",
     "CatalogDeltaError",
     "DeltaConflict",
@@ -93,7 +94,6 @@ __all__ = [
     "Extraction",
     "LowRiskPolicy",
     "Observation",
-    "PRICING_DELTA_SCHEMA_VERSION",
     "PriceRowKey",
     "PriceSource",
     "RefreshResult",

{metergraph_core-0.4.0 → metergraph_core-0.5.1}/src/metergraph_core/catalog.py

@@ -30,6 +30,7 @@ _DIRECT_CHANNEL_BY_PROVIDER = {
     "openai": "openai-api",
     "google": "google-api",
     "vercel": "vercel-ai-gateway",
+    "openrouter": "openrouter-api",
     "vertex-ai": "google-vertex-ai",
     "fireworks": "fireworks-api",
     "bedrock": "aws-bedrock",