tensorfeed 2.2.0__tar.gz → 3.0.0__tar.gz

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tensorfeed
-Version: 2.2.0
+Version: 3.0.0
 Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, LangChain/CrewAI tool factories, agent payments via USDC on Base (optional web3 auto-send)
 Author-email: "TensorFeed.ai" <feedback@tensorfeed.ai>
 License-Expression: MIT
@@ -141,8 +141,9 @@ from tensorfeed import TensorFeed, PaymentRequired
 
 tf = TensorFeed()
 
-# Step 1: get a 30-minute quote
-quote = tf.buy_credits(amount_usd=1.00)
+# Step 1: get a 30-minute quote. sender_wallet is the Base wallet you will
+# send the USDC from (required); quote['wallet'] below is where you send it.
+quote = tf.buy_credits(amount_usd=1.00, sender_wallet="0xYourBaseWallet")
 print(f"Send {quote['amount_usd']} USDC on Base to {quote['wallet']}")
 print(f"Memo: {quote['memo']} (expires in {quote['ttl_seconds']}s)")
 print(f"Will get: {quote['credits']} credits")
@@ -176,11 +177,6 @@ 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')
-
 # Premium webhook watches (1 credit per registration, free reads)
 created = tf.create_watch(
     spec={
@@ -321,7 +317,7 @@ except TensorFeedError as e:
 | `tf.routing_preview(task=)` | Top-1 routing recommendation (5/day/IP) |
 | `tf.health()` | API health check |
 | `tf.payment_info()` | Wallet, pricing, supported payment flows |
-| `tf.buy_credits(amount_usd=)` | Generate a 30-min payment quote |
+| `tf.buy_credits(amount_usd=, sender_wallet=)` | Generate a 30-min payment quote |
 | `tf.confirm(tx_hash=, nonce=)` | Verify USDC tx, mint credit token |
 
 ### Token-required
@@ -334,7 +330,6 @@ except TensorFeedError as e:
 | `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 |
 | `tf.create_watch(spec=, callback_url=, secret=, fire_cap=)` | 1 credit | Register a webhook watch (price / status / digest) |
 | `tf.create_digest_watch(cadence=, callback_url=, secret=, fire_cap=)` | 1 credit | Convenience: scheduled daily/weekly digest of pricing changes |
 | `tf.list_watches()` | Free | List all active watches owned by the current token |
@@ -343,8 +338,7 @@ except TensorFeedError as e:
 | `tf.premium_agents_directory(category=, status=, sort=, limit=, ...)` | 1 credit | Enriched directory: status, news, traffic, pricing, trending_score per agent |
 | `tf.news_search(q=, from_date=, to_date=, provider=, category=, limit=)` | 1 credit | Full-text news search with date/provider filters, relevance scoring, recency boost |
 | `tf.cost_projection(models=, input_tokens_per_day=, output_tokens_per_day=, horizon=)` | 1 credit | Project workload cost across 1-10 models, 4 horizons, cheapest-monthly ranking |
-| `tf.forecast(target=, model=, field=, benchmark=, lookback=, horizon=)` | 1 credit | Linear-regression forecast for a price or benchmark series with 95% CI and confidence label |
-| `tf.provider_deepdive(provider)` | 1 credit | One provider's full profile: status + all models + benchmarks joined + news + traffic |
+| `tf.provider_deepdive(provider)` | 5 credits | One provider's full profile: status + all models + benchmarks joined + news + traffic |
 | `tf.compare_models(ids=)` | 1 credit | Side-by-side compare of 2-5 models with normalized benchmarks + rankings |
 | `tf.whats_new(days=, news_limit=)` | 1 credit | Agent morning brief: pricing changes + incidents + top news from last 1-7 days |
 

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/README.md

@@ -108,8 +108,9 @@ from tensorfeed import TensorFeed, PaymentRequired
 
 tf = TensorFeed()
 
-# Step 1: get a 30-minute quote
-quote = tf.buy_credits(amount_usd=1.00)
+# Step 1: get a 30-minute quote. sender_wallet is the Base wallet you will
+# send the USDC from (required); quote['wallet'] below is where you send it.
+quote = tf.buy_credits(amount_usd=1.00, sender_wallet="0xYourBaseWallet")
 print(f"Send {quote['amount_usd']} USDC on Base to {quote['wallet']}")
 print(f"Memo: {quote['memo']} (expires in {quote['ttl_seconds']}s)")
 print(f"Will get: {quote['credits']} credits")
@@ -143,11 +144,6 @@ 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')
-
 # Premium webhook watches (1 credit per registration, free reads)
 created = tf.create_watch(
     spec={
@@ -288,7 +284,7 @@ except TensorFeedError as e:
 | `tf.routing_preview(task=)` | Top-1 routing recommendation (5/day/IP) |
 | `tf.health()` | API health check |
 | `tf.payment_info()` | Wallet, pricing, supported payment flows |
-| `tf.buy_credits(amount_usd=)` | Generate a 30-min payment quote |
+| `tf.buy_credits(amount_usd=, sender_wallet=)` | Generate a 30-min payment quote |
 | `tf.confirm(tx_hash=, nonce=)` | Verify USDC tx, mint credit token |
 
 ### Token-required
@@ -301,7 +297,6 @@ except TensorFeedError as e:
 | `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 |
 | `tf.create_watch(spec=, callback_url=, secret=, fire_cap=)` | 1 credit | Register a webhook watch (price / status / digest) |
 | `tf.create_digest_watch(cadence=, callback_url=, secret=, fire_cap=)` | 1 credit | Convenience: scheduled daily/weekly digest of pricing changes |
 | `tf.list_watches()` | Free | List all active watches owned by the current token |
@@ -310,8 +305,7 @@ except TensorFeedError as e:
 | `tf.premium_agents_directory(category=, status=, sort=, limit=, ...)` | 1 credit | Enriched directory: status, news, traffic, pricing, trending_score per agent |
 | `tf.news_search(q=, from_date=, to_date=, provider=, category=, limit=)` | 1 credit | Full-text news search with date/provider filters, relevance scoring, recency boost |
 | `tf.cost_projection(models=, input_tokens_per_day=, output_tokens_per_day=, horizon=)` | 1 credit | Project workload cost across 1-10 models, 4 horizons, cheapest-monthly ranking |
-| `tf.forecast(target=, model=, field=, benchmark=, lookback=, horizon=)` | 1 credit | Linear-regression forecast for a price or benchmark series with 95% CI and confidence label |
-| `tf.provider_deepdive(provider)` | 1 credit | One provider's full profile: status + all models + benchmarks joined + news + traffic |
+| `tf.provider_deepdive(provider)` | 5 credits | One provider's full profile: status + all models + benchmarks joined + news + traffic |
 | `tf.compare_models(ids=)` | 1 credit | Side-by-side compare of 2-5 models with normalized benchmarks + rankings |
 | `tf.whats_new(days=, news_limit=)` | 1 credit | Agent morning brief: pricing changes + incidents + top news from last 1-7 days |
 

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tensorfeed"
-version = "2.2.0"
+version = "3.0.0"
 description = "Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, LangChain/CrewAI tool factories, agent payments via USDC on Base (optional web3 auto-send)"
 readme = "README.md"
 license = "MIT"

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/tensorfeed/__init__.py

@@ -21,4 +21,4 @@ __all__ = [
     "PaymentRequired",
     "RateLimited",
 ]
-__version__ = "2.1.0"
+__version__ = "3.0.0"

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/tensorfeed/_premium_tools.py

@@ -158,14 +158,14 @@ DESCRIPTIONS: dict[str, str] = {
         "limit (1-100, default 25)."
     ),
     "tensorfeed_provider_deepdive": (
-        "PAID, 1 credit. One AI provider's full profile in a single "
+        "PAID, 5 credits. One AI provider's full profile in a single "
         "call: live status, every model with pricing and benchmarks "
         "joined in, recent news, and agent-traffic attribution. Doing "
         "this from free endpoints takes several round-trips and a "
         "non-trivial join. Input: provider (id or display name)."
     ),
     "tensorfeed_status_leaderboard": (
-        "PAID, 1 credit. Cross-provider AI uptime leaderboard over the "
+        "PAID, 5 credits. Cross-provider AI uptime leaderboard over the "
         "full 90-day retention window, with incident_count and "
         "mttr_minutes per provider. Built for vendor selection and "
         "post-incident review. Inputs: from_date, to_date (optional, "

{tensorfeed-2.2.0 → tensorfeed-3.0.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/2.2"
+DEFAULT_USER_AGENT = "TensorFeed-SDK-Python/3.0"
 
 
 class TensorFeedError(Exception):
@@ -105,10 +105,18 @@ class TensorFeed:
         # Premium endpoints, balance, and explicit-require-token paths get
         # the Authorization header. Free endpoints do not advertise a token
         # (avoids accidentally leaking it to public-data endpoints).
+        # Paths handed to _request are RELATIVE: base_url already ends in /api,
+        # and url is built as f"{base_url}{path}". The old fallback tested for
+        # "/api/premium/" and "/api/payment/balance" in that relative path, so
+        # neither could ever match and the whole fallback was dead code. Every
+        # premium method happened to pass require_token=True explicitly, except
+        # attention_series, which therefore called a paid endpoint with no
+        # Authorization header at all and 402'd for customers holding credits.
+        # Matching the relative form makes the safety net real.
         needs_auth = (
             require_token
-            or "/api/premium/" in path
-            or path == "/api/payment/balance"
+            or path.startswith("/premium/")
+            or path == "/payment/balance"
         )
         if needs_auth and self.token:
             headers["Authorization"] = f"Bearer {self.token}"
@@ -380,7 +388,9 @@ class TensorFeed:
             kwargs["from"] = from_date
         if to_date is not None:
             kwargs["to"] = to_date
-        return self._get("/premium/attention/series", **kwargs)
+        return self._request(
+            "GET", "/premium/attention/series", params=kwargs, require_token=True
+        )
 
     def agent_activity(self) -> dict[str, Any]:
         """Get agent traffic metrics. Free."""
@@ -510,7 +520,7 @@ class TensorFeed:
 
         For windows up to 90 days plus ``incident_count`` and
         ``mttr_minutes`` per provider, use ``status_leaderboard()``
-        (premium, 1 credit).
+        (premium, 5 credits).
 
         Args:
             days: 1 to 7 (default 7).
@@ -976,7 +986,7 @@ class TensorFeed:
         from_date: str | None = None,
         to_date: str | None = None,
     ) -> dict[str, Any]:
-        """Cross-provider uptime leaderboard. Costs 1 credit.
+        """Cross-provider uptime leaderboard. Costs 5 credits.
 
         Same minute-resolution counter source as the free
         ``status_leaderboard_free()`` but extends the window to the full
@@ -1184,12 +1194,12 @@ class TensorFeed:
             fire_cap=fire_cap,
         )
 
-    # ── Paid: provider deep-dive (Tier 1, 1 credit) ────────────────
+    # ── Paid: provider deep-dive (Tier 3, 5 credits) ────────────────
 
     def provider_deepdive(self, provider: str) -> dict[str, Any]:
         """Everything about a provider in one paid call.
 
-        Costs 1 credit. Returns the live status + status_page_url +
+        Costs 5 credits. Returns the live status + status_page_url +
         components, all of the provider's models with pricing, tier,
         context window, capabilities, and benchmark scores joined in,
         recent news mentions, and agent-traffic attribution.
@@ -1338,8 +1348,8 @@ class TensorFeed:
 
         Free, no auth. Single edge-cached endpoint that fans out across
         every daily TensorFeed feed (news, 3 paper feeds, HF
-        models/datasets/Spaces, hot GitHub issues, Reddit threads,
-        OpenRouter catalog summary, provider status) and returns a
+        models/datasets/Spaces, hot GitHub issues, OpenRouter catalog
+        summary, provider status) and returns a
         structured response. Saves an agent from orchestrating 9
         separate calls.
 
@@ -1455,31 +1465,6 @@ class TensorFeed:
         """
         return self._request("GET", "/openrouter/models")
 
-    def get_reddit_trending(self) -> dict[str, Any]:
-        """Currently-hot Reddit threads in 7 AI-relevant subreddits.
-
-        Free, no auth. Subreddits queried: LocalLLaMA, MachineLearning,
-        ClaudeAI, OpenAI, singularity, artificial, AI_Agents. Pulls each
-        subreddit's "hot" listing, dedups by post id, drops stickied and
-        NSFW posts, ranks by score, top 30. Refreshed daily at 13:00 UTC.
-        Companion to ``get_hot_issues()``: that surfaces developer-side
-        conversation on GitHub, this surfaces community-side conversation
-        on Reddit.
-
-        Titles pass through TensorFeed's prompt-injection sanitization at
-        capture time, so role-confusion tokens and bidi/zero-width
-        spoofing characters in Reddit posts cannot reach an agent.
-
-        Returns:
-            Dict with ``ok`` and ``snapshot`` keys. Snapshot includes
-            ``date``, ``capturedAt``, ``total_posts``, ``subreddits_queried``,
-            ``posts`` (each with id, subreddit, title, author, score,
-            upvote_ratio, num_comments, permalink, url, created_utc,
-            flair, is_self, is_video), and ``summary`` (by_subreddit,
-            top_authors).
-        """
-        return self._request("GET", "/reddit/trending")
-
     def get_hot_issues(self) -> dict[str, Any]:
         """Currently-hot GitHub issues across the AI ecosystem.
 
@@ -1520,7 +1505,7 @@ class TensorFeed:
         """
         return self._request("GET", "/probe/latest")
 
-    # ── Paid: LLM probe time series (Tier 1, 1 credit) ─────────────
+    # ── Paid: LLM probe time series (Tier 3, 5 credits) ─────────────
 
     def get_probe_series(
         self,
@@ -1531,7 +1516,7 @@ class TensorFeed:
     ) -> dict[str, Any]:
         """Daily SLA series for one LLM provider, measured by TensorFeed.
 
-        Costs 1 credit. Returns per-day count, success rate, ttfb
+        Costs 5 credits. Returns per-day count, success rate, ttfb
         p50/p95/p99, total p50/p95/p99, incident-hour count for each
         day in the requested window. Provider status pages are
         politically managed; this is the measured truth.

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/tensorfeed/web3_signer.py

@@ -172,7 +172,7 @@ def auto_purchase_credits(
     if not result.get("ok"):
         raise RuntimeError(
             f"Tx {tx_hash} mined but TensorFeed rejected confirm: {result}. "
-            f"Email evan@tensorfeed.ai with the tx hash for a manual reconciliation."
+            f"Email contact@tensorfeed.ai with the tx hash for a manual reconciliation."
         )
 
     return {

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/tensorfeed.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tensorfeed
-Version: 2.2.0
+Version: 3.0.0
 Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, LangChain/CrewAI tool factories, agent payments via USDC on Base (optional web3 auto-send)
 Author-email: "TensorFeed.ai" <feedback@tensorfeed.ai>
 License-Expression: MIT
@@ -141,8 +141,9 @@ from tensorfeed import TensorFeed, PaymentRequired
 
 tf = TensorFeed()
 
-# Step 1: get a 30-minute quote
-quote = tf.buy_credits(amount_usd=1.00)
+# Step 1: get a 30-minute quote. sender_wallet is the Base wallet you will
+# send the USDC from (required); quote['wallet'] below is where you send it.
+quote = tf.buy_credits(amount_usd=1.00, sender_wallet="0xYourBaseWallet")
 print(f"Send {quote['amount_usd']} USDC on Base to {quote['wallet']}")
 print(f"Memo: {quote['memo']} (expires in {quote['ttl_seconds']}s)")
 print(f"Will get: {quote['credits']} credits")
@@ -176,11 +177,6 @@ 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')
-
 # Premium webhook watches (1 credit per registration, free reads)
 created = tf.create_watch(
     spec={
@@ -321,7 +317,7 @@ except TensorFeedError as e:
 | `tf.routing_preview(task=)` | Top-1 routing recommendation (5/day/IP) |
 | `tf.health()` | API health check |
 | `tf.payment_info()` | Wallet, pricing, supported payment flows |
-| `tf.buy_credits(amount_usd=)` | Generate a 30-min payment quote |
+| `tf.buy_credits(amount_usd=, sender_wallet=)` | Generate a 30-min payment quote |
 | `tf.confirm(tx_hash=, nonce=)` | Verify USDC tx, mint credit token |
 
 ### Token-required
@@ -334,7 +330,6 @@ except TensorFeedError as e:
 | `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 |
 | `tf.create_watch(spec=, callback_url=, secret=, fire_cap=)` | 1 credit | Register a webhook watch (price / status / digest) |
 | `tf.create_digest_watch(cadence=, callback_url=, secret=, fire_cap=)` | 1 credit | Convenience: scheduled daily/weekly digest of pricing changes |
 | `tf.list_watches()` | Free | List all active watches owned by the current token |
@@ -343,8 +338,7 @@ except TensorFeedError as e:
 | `tf.premium_agents_directory(category=, status=, sort=, limit=, ...)` | 1 credit | Enriched directory: status, news, traffic, pricing, trending_score per agent |
 | `tf.news_search(q=, from_date=, to_date=, provider=, category=, limit=)` | 1 credit | Full-text news search with date/provider filters, relevance scoring, recency boost |
 | `tf.cost_projection(models=, input_tokens_per_day=, output_tokens_per_day=, horizon=)` | 1 credit | Project workload cost across 1-10 models, 4 horizons, cheapest-monthly ranking |
-| `tf.forecast(target=, model=, field=, benchmark=, lookback=, horizon=)` | 1 credit | Linear-regression forecast for a price or benchmark series with 95% CI and confidence label |
-| `tf.provider_deepdive(provider)` | 1 credit | One provider's full profile: status + all models + benchmarks joined + news + traffic |
+| `tf.provider_deepdive(provider)` | 5 credits | One provider's full profile: status + all models + benchmarks joined + news + traffic |
 | `tf.compare_models(ids=)` | 1 credit | Side-by-side compare of 2-5 models with normalized benchmarks + rankings |
 | `tf.whats_new(days=, news_limit=)` | 1 credit | Agent morning brief: pricing changes + incidents + top news from last 1-7 days |
 

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/tensorfeed.egg-info/SOURCES.txt

@@ -12,5 +12,6 @@ tensorfeed.egg-info/SOURCES.txt
 tensorfeed.egg-info/dependency_links.txt
 tensorfeed.egg-info/requires.txt
 tensorfeed.egg-info/top_level.txt
+tests/test_premium_auth_header.py
 tests/test_premium_tools.py
 tests/test_route_verdict.py

tensorfeed-3.0.0/tests/test_premium_auth_header.py

@@ -0,0 +1,148 @@
+"""Every premium method must send the Authorization header.
+
+A customer buys credits, calls a documented premium method, and gets a 402
+because the SDK never attached their token. That shipped in 2.2.1:
+``attention_series`` was the only premium method of twenty that omitted
+``require_token=True``, and the fallback meant to catch exactly that mistake
+was dead code.
+
+The fallback tested ``"/api/premium/" in path``. Paths handed to ``_request``
+are relative, because ``base_url`` already ends in ``/api`` and the URL is
+built as ``f"{base_url}{path}"``. So the substring could never match and the
+safety net never fired for anything.
+
+Two guards here, because either one alone is escapable:
+
+1. Behavioral. Drive every premium method through a stub transport and assert
+   the header is actually present on the wire. Catches a missing flag no
+   matter how the method is written.
+2. Static. Assert the fallback still matches the relative path form, so the
+   net cannot silently go dead again while every method happens to pass the
+   flag explicitly.
+
+Network-free. Run from sdk/python::
+
+    python -m unittest discover -s tests -t .
+"""
+
+from __future__ import annotations
+
+import inspect
+import json
+import unittest
+from unittest import mock
+
+from tensorfeed import TensorFeed
+from tensorfeed import client as client_mod
+
+TOKEN = "tf_live_testtoken0000000000"
+
+
+class _StubResponse:
+    """Minimal stand-in for the urlopen context manager."""
+
+    status = 200
+    headers: dict[str, str] = {}
+
+    def read(self) -> bytes:
+        return json.dumps({"ok": True}).encode()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc):
+        return False
+
+
+def _premium_methods():
+    """Public methods whose source calls a /premium/ path."""
+    for name, fn in inspect.getmembers(TensorFeed, predicate=inspect.isfunction):
+        if name.startswith("_"):
+            continue
+        try:
+            src = inspect.getsource(fn)
+        except OSError:  # pragma: no cover
+            continue
+        if '"/premium/' in src or "'/premium/" in src:
+            yield name, fn
+
+
+class PremiumMethodsSendTheToken(unittest.TestCase):
+    def test_at_least_a_dozen_premium_methods_are_discovered(self):
+        found = list(_premium_methods())
+        self.assertGreater(
+            len(found), 12, f"expected to discover many premium methods, got {len(found)}"
+        )
+
+    def test_every_premium_method_attaches_authorization(self):
+        tf = TensorFeed(token=TOKEN)
+        offenders: list[str] = []
+
+        for name, fn in _premium_methods():
+            sig = inspect.signature(fn)
+            # Supply a placeholder for every required positional parameter so the
+            # method reaches the transport. Values are irrelevant: the stub
+            # answers everything with 200 and we only inspect the request.
+            args: list[object] = []
+            kwargs: dict[str, object] = {}
+            for pname, p in list(sig.parameters.items())[1:]:
+                if p.default is not inspect.Parameter.empty:
+                    continue
+                if p.kind in (p.VAR_POSITIONAL, p.VAR_KEYWORD):
+                    continue
+                # Numeric-sounding params need a number; everything else takes a
+                # plausible string. The value never reaches a real service.
+                filler: object = 1000 if "tokens" in pname or pname.endswith("_per_day") else "anthropic"
+                if p.kind is p.KEYWORD_ONLY:
+                    kwargs[pname] = filler
+                else:
+                    args.append(filler)
+
+            captured: dict[str, object] = {}
+
+            def _fake_urlopen(req, *a, **kw):
+                captured["headers"] = {k.lower(): v for k, v in req.headers.items()}
+                captured["url"] = req.full_url
+                return _StubResponse()
+
+            with mock.patch.object(client_mod.urllib.request, "urlopen", _fake_urlopen):
+                try:
+                    getattr(tf, name)(*args, **kwargs)
+                except Exception as exc:  # noqa: BLE001
+                    offenders.append(f"{name}: raised before transport ({exc!r})")
+                    continue
+
+            headers = captured.get("headers") or {}
+            if headers.get("authorization") != f"Bearer {TOKEN}":
+                offenders.append(
+                    f"{name}: no Authorization header on {captured.get('url')}"
+                )
+
+        self.assertEqual(
+            offenders,
+            [],
+            "These premium methods call a paid endpoint without the customer's token, so a "
+            "customer holding credits gets a 402 instead of data:\n  " + "\n  ".join(offenders),
+        )
+
+
+class TheAuthFallbackIsNotDeadCode(unittest.TestCase):
+    def test_fallback_matches_the_relative_path_form(self):
+        src = inspect.getsource(client_mod.TensorFeed._request)
+        self.assertIn(
+            'path.startswith("/premium/")',
+            src,
+            "The premium auth fallback must match the RELATIVE path form. base_url already "
+            "ends in /api, so a check for '/api/premium/' in path can never be true and the "
+            "safety net is dead code.",
+        )
+        self.assertNotIn(
+            '"/api/premium/" in path',
+            src,
+            "This is the dead check that let attention_series ship without a token.",
+        )
+
+    def test_base_url_still_ends_in_api(self):
+        # The premise of the test above. If this ever changes, the relative-path
+        # assumption changes with it.
+        self.assertTrue(client_mod.DEFAULT_BASE_URL.endswith("/api"))

{tensorfeed-2.2.0 → tensorfeed-3.0.0}/tests/test_premium_tools.py

@@ -182,7 +182,13 @@ class Formatters(unittest.TestCase):
         self.assertEqual(set(pt.DESCRIPTIONS), set(pt.FORMATTERS))
         self.assertEqual(set(pt.PREMIUM_TOOL_NAMES), set(pt.DESCRIPTIONS))
         for name, desc in pt.DESCRIPTIONS.items():
-            self.assertIn("1 credit", desc, msg=name)
+            # Every tool description must state its real credit cost. Most are
+            # 1 credit; the Tier 3 endpoints (provider deep-dive, status
+            # leaderboard) are 5 credits.
+            self.assertTrue(
+                "1 credit" in desc or "5 credits" in desc,
+                msg=f"{name} description must state its credit cost (1 or 5)",
+            )
 
 
 class ClientIntegrationOffline(unittest.TestCase):