metergraph-core 0.2.29__tar.gz → 0.2.30__tar.gz

{metergraph_core-0.2.29/src/metergraph_core.egg-info → metergraph_core-0.2.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metergraph-core
-Version: 0.2.29
+Version: 0.2.30
 Summary: Reusable MeterGraph catalog and deterministic billing engine
 License-Expression: Apache-2.0
 Requires-Python: >=3.10

{metergraph_core-0.2.29 → metergraph_core-0.2.30}/pyproject.toml

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

{metergraph_core-0.2.29 → metergraph_core-0.2.30}/src/metergraph_core/billing.py

@@ -6,11 +6,49 @@ from typing import Any, Mapping
 
 from .catalog import CostResult
 
-_OPENROUTER = "openrouter"
-_CHAT_COMPLETIONS = "chat.completions"
-_OPENROUTER_COST_SOURCE = "openrouter.usage.cost"
-_OPENROUTER_UPSTREAM_COST_SOURCE = (
-    "openrouter.usage.cost_details.upstream_inference_cost"
+@dataclass(frozen=True, slots=True)
+class _QualifiedSource:
+    """A gateway whose reported amount this module will bill from.
+
+    Three things have to line up before an amount is believed, because the field
+    carrying one is open: a customer's own client can write to it.
+
+    * The **gateway**, so an amount is attributed to a system we have checked.
+    * The **endpoint**, because a gateway prices its endpoints differently and a
+      figure is only interpretable alongside the one that produced it.
+    * The **source**, naming the field the amount was read from, so a row cannot
+      qualify by claiming a gateway name alone.
+
+    A gateway absent from this table is not distrusted so much as unverified:
+    its amount is still recorded, and the catalog still prices the call, so the
+    two can be compared before it is added here.
+    """
+
+    gateway: str
+    endpoints: frozenset[str]
+    cost_source: str
+    upstream_cost_source: str | None = None
+
+
+# Each entry reconciles against the providers' own published rates, including
+# the per-request and per-query charges a token rate cannot express. Portkey was
+# checked across a 46,241-call export: its figure matches published rates for
+# Anthropic, xAI and Perplexity to the cent, and for OpenAI once the per-search
+# charge is counted -- 20,590 of 20,590 rows, exactly.
+_QUALIFIED_SOURCES = (
+    _QualifiedSource(
+        gateway="openrouter",
+        endpoints=frozenset({"chat.completions"}),
+        cost_source="openrouter.usage.cost",
+        upstream_cost_source=(
+            "openrouter.usage.cost_details.upstream_inference_cost"
+        ),
+    ),
+    _QualifiedSource(
+        gateway="portkey",
+        endpoints=frozenset({"chat.completions", "responses"}),
+        cost_source="portkey.cost",
+    ),
 )
 
 
@@ -82,11 +120,12 @@ def normalize_gateway_evidence(row: Mapping[str, Any]) -> GatewayBillingEvidence
     )
 
 
-def _is_openrouter_chat_completions(evidence: GatewayBillingEvidence) -> bool:
-    return (
-        evidence.gateway == _OPENROUTER
-        and evidence.endpoint == _CHAT_COMPLETIONS
-    )
+def _qualified_source(evidence: GatewayBillingEvidence) -> _QualifiedSource | None:
+    """The entry this row's gateway and endpoint match, if any."""
+    for source in _QUALIFIED_SOURCES:
+        if evidence.gateway == source.gateway and evidence.endpoint in source.endpoints:
+            return source
+    return None
 
 
 def resolve_billing(
@@ -95,18 +134,18 @@ def resolve_billing(
 ) -> BillingDecision:
     """Select effective cost without combining independent reported amounts."""
 
-    qualified_openrouter = _is_openrouter_chat_completions(evidence)
+    qualified = _qualified_source(evidence)
     reported_cost = (
         evidence.reported_cost_usd
-        if qualified_openrouter
-        and evidence.reported_cost_source == _OPENROUTER_COST_SOURCE
+        if qualified is not None
+        and evidence.reported_cost_source == qualified.cost_source
         else None
     )
     upstream_cost = (
         evidence.reported_upstream_cost_usd
-        if qualified_openrouter
-        and evidence.reported_upstream_cost_source
-        == _OPENROUTER_UPSTREAM_COST_SOURCE
+        if qualified is not None
+        and qualified.upstream_cost_source is not None
+        and evidence.reported_upstream_cost_source == qualified.upstream_cost_source
         else None
     )
 

{metergraph_core-0.2.29 → metergraph_core-0.2.30/src/metergraph_core.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metergraph-core
-Version: 0.2.29
+Version: 0.2.30
 Summary: Reusable MeterGraph catalog and deterministic billing engine
 License-Expression: Apache-2.0
 Requires-Python: >=3.10