tensorfeed 1.2.0__tar.gz → 1.3.0__tar.gz

{tensorfeed-1.2.0 → tensorfeed-1.3.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: tensorfeed
-Version: 1.2.0
-Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, and agent-payable premium routing (USDC on Base, optional auto-send via web3)
+Version: 1.3.0
+Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium history series + routing, agent payments via USDC on Base (optional web3 auto-send)
 Author-email: "TensorFeed.ai" <feedback@tensorfeed.ai>
 License-Expression: MIT
 Project-URL: Homepage, https://tensorfeed.ai
@@ -102,6 +102,21 @@ rec = tf.routing(
     weights={"quality": 0.6, "cost": 0.3, "availability": 0.1, "latency": 0.0},
 )
 
+# Premium history series (1 credit each, range default = last 30 days, max 90)
+prices = tf.pricing_series(model="Claude Opus 4.7")
+print(f'Price changed {prices["summary"]["delta_pct_blended"]}% over the window')
+
+scores = tf.benchmark_series(model="Claude Opus 4.7", benchmark="swe_bench")
+print(f'SWE-bench moved {scores["summary"]["delta_pp"]} pp')
+
+uptime = tf.status_uptime(provider="anthropic")
+print(f'Anthropic uptime: {uptime["uptime_pct"]}% over {uptime["days_with_data"]} days')
+
+diff = tf.history_compare(
+    from_date="2026-04-01", to_date="2026-04-27", snapshot_type="pricing",
+)
+print(f'{len(diff["changed"])} price changes, {len(diff["added"])} new models')
+
 # Check remaining credits
 print(tf.balance())
 ```
@@ -198,6 +213,10 @@ except TensorFeedError as e:
 |--------|------|-------------|
 | `tf.balance()` | Free | Check remaining credits |
 | `tf.routing(task=, budget=, top_n=, weights=)` | 1 credit | Top-N ranked routing with full detail |
+| `tf.pricing_series(model=, from_date=, to_date=)` | 1 credit | Daily price points for one model with min/max/delta summary |
+| `tf.benchmark_series(model=, benchmark=, from_date=, to_date=)` | 1 credit | Score evolution for a benchmark on one model, returns delta_pp |
+| `tf.status_uptime(provider=, from_date=, to_date=)` | 1 credit | Uptime % per provider with incident days (degraded = half) |
+| `tf.history_compare(from_date=, to_date=, snapshot_type=)` | 1 credit | Diff two snapshots: added, removed, changed entries with deltas |
 
 ### Auto-send (requires `tensorfeed[web3]`)
 

{tensorfeed-1.2.0 → tensorfeed-1.3.0}/README.md

@@ -75,6 +75,21 @@ rec = tf.routing(
     weights={"quality": 0.6, "cost": 0.3, "availability": 0.1, "latency": 0.0},
 )
 
+# Premium history series (1 credit each, range default = last 30 days, max 90)
+prices = tf.pricing_series(model="Claude Opus 4.7")
+print(f'Price changed {prices["summary"]["delta_pct_blended"]}% over the window')
+
+scores = tf.benchmark_series(model="Claude Opus 4.7", benchmark="swe_bench")
+print(f'SWE-bench moved {scores["summary"]["delta_pp"]} pp')
+
+uptime = tf.status_uptime(provider="anthropic")
+print(f'Anthropic uptime: {uptime["uptime_pct"]}% over {uptime["days_with_data"]} days')
+
+diff = tf.history_compare(
+    from_date="2026-04-01", to_date="2026-04-27", snapshot_type="pricing",
+)
+print(f'{len(diff["changed"])} price changes, {len(diff["added"])} new models')
+
 # Check remaining credits
 print(tf.balance())
 ```
@@ -171,6 +186,10 @@ except TensorFeedError as e:
 |--------|------|-------------|
 | `tf.balance()` | Free | Check remaining credits |
 | `tf.routing(task=, budget=, top_n=, weights=)` | 1 credit | Top-N ranked routing with full detail |
+| `tf.pricing_series(model=, from_date=, to_date=)` | 1 credit | Daily price points for one model with min/max/delta summary |
+| `tf.benchmark_series(model=, benchmark=, from_date=, to_date=)` | 1 credit | Score evolution for a benchmark on one model, returns delta_pp |
+| `tf.status_uptime(provider=, from_date=, to_date=)` | 1 credit | Uptime % per provider with incident days (degraded = half) |
+| `tf.history_compare(from_date=, to_date=, snapshot_type=)` | 1 credit | Diff two snapshots: added, removed, changed entries with deltas |
 
 ### Auto-send (requires `tensorfeed[web3]`)
 

{tensorfeed-1.2.0 → tensorfeed-1.3.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tensorfeed"
-version = "1.2.0"
-description = "Python SDK for the TensorFeed.ai API: AI news, status, model pricing, and agent-payable premium routing (USDC on Base, optional auto-send via web3)"
+version = "1.3.0"
+description = "Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium history series + routing, agent payments via USDC on Base (optional web3 auto-send)"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.9"

{tensorfeed-1.2.0 → tensorfeed-1.3.0}/tensorfeed/__init__.py

@@ -21,4 +21,4 @@ __all__ = [
     "PaymentRequired",
     "RateLimited",
 ]
-__version__ = "1.2.0"
+__version__ = "1.3.0"

{tensorfeed-1.2.0 → tensorfeed-1.3.0}/tensorfeed/client.py

@@ -18,7 +18,7 @@ from typing import Any  # noqa: F401  (re-exported by purchase_credits return ty
 
 
 DEFAULT_BASE_URL = "https://tensorfeed.ai/api"
-DEFAULT_USER_AGENT = "TensorFeed-SDK-Python/1.1"
+DEFAULT_USER_AGENT = "TensorFeed-SDK-Python/1.3"
 
 
 class TensorFeedError(Exception):
@@ -405,3 +405,145 @@ class TensorFeed:
         return self._request(
             "GET", "/premium/routing", params=params, require_token=True
         )
+
+    # ── Paid: history series (Tier 1, 1 credit/call) ───────────────
+
+    def _require_token(self, name: str) -> None:
+        if not self.token:
+            raise ValueError(
+                f"{name}() requires a token. Buy credits via buy_credits() and "
+                "confirm(), or pass an existing token to TensorFeed(token=...)."
+            )
+
+    def pricing_series(
+        self,
+        *,
+        model: str,
+        from_date: str | None = None,
+        to_date: str | None = None,
+    ) -> dict[str, Any]:
+        """Daily price points for one model with min/max/delta summary.
+
+        Costs 1 credit per call. Range capped at 90 days; default 30 days
+        back from today.
+
+        Args:
+            model: Model id or display name (e.g. "Claude Opus 4.7" or
+                "claude-opus-4-7"). Case-insensitive.
+            from_date: Start date in YYYY-MM-DD UTC. Defaults to 30 days ago.
+            to_date: End date in YYYY-MM-DD UTC. Defaults to today.
+
+        Returns:
+            Dict with ``points`` (list of {date, input, output, blended}),
+            ``summary`` (first/latest/min/max/delta_pct/changes_detected),
+            ``range``, and ``billing``.
+
+        Raises:
+            ValueError: if no token is set on the client
+            PaymentRequired: if the token has insufficient credits
+        """
+        self._require_token("pricing_series")
+        return self._request(
+            "GET",
+            "/premium/history/pricing/series",
+            params={"model": model, "from": from_date, "to": to_date},
+            require_token=True,
+        )
+
+    def benchmark_series(
+        self,
+        *,
+        model: str,
+        benchmark: str,
+        from_date: str | None = None,
+        to_date: str | None = None,
+    ) -> dict[str, Any]:
+        """Score evolution for a single benchmark on one model.
+
+        Costs 1 credit per call. Range capped at 90 days; default 30 days
+        back from today.
+
+        Args:
+            model: Model id or display name. Case-insensitive.
+            benchmark: Benchmark key (e.g. "swe_bench", "mmlu_pro",
+                "gpqa_diamond", "math", "human_eval"). Case-insensitive.
+            from_date: Start date in YYYY-MM-DD UTC. Defaults to 30 days ago.
+            to_date: End date in YYYY-MM-DD UTC. Defaults to today.
+
+        Returns:
+            Dict with ``points`` (list of {date, score}), ``summary``
+            (first/latest/min_score/max_score/delta_pp), ``range``, and ``billing``.
+        """
+        self._require_token("benchmark_series")
+        return self._request(
+            "GET",
+            "/premium/history/benchmarks/series",
+            params={
+                "model": model,
+                "benchmark": benchmark,
+                "from": from_date,
+                "to": to_date,
+            },
+            require_token=True,
+        )
+
+    def status_uptime(
+        self,
+        *,
+        provider: str,
+        from_date: str | None = None,
+        to_date: str | None = None,
+    ) -> dict[str, Any]:
+        """Daily uptime rollup for one provider.
+
+        Costs 1 credit per call. Operational days count fully, degraded
+        days count as half, missing-data days are excluded from the
+        denominator.
+
+        Args:
+            provider: Provider name (e.g. "anthropic", "openai", "google").
+                Case-insensitive.
+            from_date: Start date in YYYY-MM-DD UTC. Defaults to 30 days ago.
+            to_date: End date in YYYY-MM-DD UTC. Defaults to today.
+
+        Returns:
+            Dict with ``uptime_pct``, day counts by status, ``incident_days``,
+            and ``billing``.
+        """
+        self._require_token("status_uptime")
+        return self._request(
+            "GET",
+            "/premium/history/status/uptime",
+            params={"provider": provider, "from": from_date, "to": to_date},
+            require_token=True,
+        )
+
+    def history_compare(
+        self,
+        *,
+        from_date: str,
+        to_date: str,
+        snapshot_type: str = "pricing",
+    ) -> dict[str, Any]:
+        """Diff two daily snapshots: added, removed, and changed entries.
+
+        Costs 1 credit per call.
+
+        Args:
+            from_date: Earlier snapshot date in YYYY-MM-DD UTC.
+            to_date: Later snapshot date in YYYY-MM-DD UTC.
+            snapshot_type: "pricing" (default) or "benchmarks".
+
+        Returns:
+            For pricing: ``added``, ``removed``, ``changed`` (with
+            field/from/to/delta_pct), and ``unchanged_count``.
+            For benchmarks: ``added_models``, ``removed_models``, and
+            ``changed`` (with model/benchmark/from/to/delta_pp).
+        """
+        self._require_token("history_compare")
+        return self._request(
+            "GET",
+            "/premium/history/compare",
+            params={"from": from_date, "to": to_date, "type": snapshot_type},
+            require_token=True,
+        )

{tensorfeed-1.2.0 → tensorfeed-1.3.0}/tensorfeed.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: tensorfeed
-Version: 1.2.0
-Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, and agent-payable premium routing (USDC on Base, optional auto-send via web3)
+Version: 1.3.0
+Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium history series + routing, agent payments via USDC on Base (optional web3 auto-send)
 Author-email: "TensorFeed.ai" <feedback@tensorfeed.ai>
 License-Expression: MIT
 Project-URL: Homepage, https://tensorfeed.ai
@@ -102,6 +102,21 @@ rec = tf.routing(
     weights={"quality": 0.6, "cost": 0.3, "availability": 0.1, "latency": 0.0},
 )
 
+# Premium history series (1 credit each, range default = last 30 days, max 90)
+prices = tf.pricing_series(model="Claude Opus 4.7")
+print(f'Price changed {prices["summary"]["delta_pct_blended"]}% over the window')
+
+scores = tf.benchmark_series(model="Claude Opus 4.7", benchmark="swe_bench")
+print(f'SWE-bench moved {scores["summary"]["delta_pp"]} pp')
+
+uptime = tf.status_uptime(provider="anthropic")
+print(f'Anthropic uptime: {uptime["uptime_pct"]}% over {uptime["days_with_data"]} days')
+
+diff = tf.history_compare(
+    from_date="2026-04-01", to_date="2026-04-27", snapshot_type="pricing",
+)
+print(f'{len(diff["changed"])} price changes, {len(diff["added"])} new models')
+
 # Check remaining credits
 print(tf.balance())
 ```
@@ -198,6 +213,10 @@ except TensorFeedError as e:
 |--------|------|-------------|
 | `tf.balance()` | Free | Check remaining credits |
 | `tf.routing(task=, budget=, top_n=, weights=)` | 1 credit | Top-N ranked routing with full detail |
+| `tf.pricing_series(model=, from_date=, to_date=)` | 1 credit | Daily price points for one model with min/max/delta summary |
+| `tf.benchmark_series(model=, benchmark=, from_date=, to_date=)` | 1 credit | Score evolution for a benchmark on one model, returns delta_pp |
+| `tf.status_uptime(provider=, from_date=, to_date=)` | 1 credit | Uptime % per provider with incident days (degraded = half) |
+| `tf.history_compare(from_date=, to_date=, snapshot_type=)` | 1 credit | Diff two snapshots: added, removed, changed entries with deltas |
 
 ### Auto-send (requires `tensorfeed[web3]`)