tensorfeed 1.2.0__tar.gz → 1.16.0__tar.gz

{tensorfeed-1.2.0 → tensorfeed-1.16.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.16.0
+Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, 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
@@ -24,6 +24,12 @@ Description-Content-Type: text/markdown
 Provides-Extra: web3
 Requires-Dist: web3>=6.0; extra == "web3"
 Requires-Dist: eth-account>=0.10; extra == "web3"
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.3; extra == "langchain"
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.11; extra == "llamaindex"
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.70; extra == "crewai"
 
 # tensorfeed
 
@@ -102,6 +108,46 @@ 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')
+
+# Premium webhook watches (1 credit per registration, free reads)
+created = tf.create_watch(
+    spec={
+        "type": "price",
+        "model": "Claude Opus 4.7",
+        "field": "blended",
+        "op": "lt",
+        "threshold": 30,
+    },
+    callback_url="https://agent.example.com/hook",
+    secret="any-shared-secret",  # used to sign deliveries
+)
+watch_id = created["watch"]["id"]
+print(f"Watch {watch_id} active until {created['watch']['expires_at']}")
+
+# When a delivery arrives, verify it:
+#   sig = request.headers["X-TensorFeed-Signature"]  # "sha256=<hex>"
+#   import hmac, hashlib
+#   expected = "sha256=" + hmac.new(b"any-shared-secret", body, hashlib.sha256).hexdigest()
+#   assert hmac.compare_digest(sig, expected)
+
+print(tf.list_watches())          # see all your active watches
+print(tf.get_watch(watch_id))     # check fire_count, last_fired_at
+tf.delete_watch(watch_id)         # remove when done
+
 # Check remaining credits
 print(tf.balance())
 ```
@@ -197,7 +243,24 @@ except TensorFeedError as e:
 | Method | Cost | Description |
 |--------|------|-------------|
 | `tf.balance()` | Free | Check remaining credits |
+| `tf.usage()` | Free | Per-token call history (last 100 calls aggregated by endpoint) |
 | `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 |
+| `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 |
+| `tf.get_watch(watch_id)` | Free | Read one watch including fire_count and last_fired_at |
+| `tf.delete_watch(watch_id)` | Free | Remove an owned watch |
+| `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.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 |
 
 ### Auto-send (requires `tensorfeed[web3]`)
 
@@ -220,11 +283,15 @@ If any source disagrees, do not send.
 
 ## Premium Data Terms
 
-Premium API responses are licensed for inference use only. Use of TensorFeed premium data for training, fine-tuning, evaluation, or distillation of ML models is prohibited.
+Premium API responses are licensed for inference use only. Use of TensorFeed premium data for training, fine-tuning, evaluation, or distillation of ML models is prohibited (Section 17.1 of the [Terms](https://tensorfeed.ai/terms#premium)).
+
+## No refunds; credits do not expire
+
+All credit purchases are final and non-refundable per Section 17.5 of the [Terms](https://tensorfeed.ai/terms#premium). Credits never expire and are jointly redeemable on tensorfeed.ai and terminalfeed.io. The recommended pattern is to buy in small increments (for example, $1 USDC for 50 credits) until call volume is calibrated, then top up as needed.
 
-## Refunds
+## Sanctions
 
-Email `evan@tensorfeed.ai` with the tx hash within 24 hours of the charge for a manual USDC refund.
+Premium API access is unavailable to persons or entities subject to OFAC, EU, UK, or UN sanctions, and to residents of comprehensively sanctioned jurisdictions (Cuba, Iran, North Korea, Syria, Crimea, Donetsk, Luhansk). Inbound credit-purchase transactions are screened against the Chainalysis public sanctions API. See Section 17.9 of the [Terms](https://tensorfeed.ai/terms#premium).
 
 ## Links
 

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

@@ -75,6 +75,46 @@ 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')
+
+# Premium webhook watches (1 credit per registration, free reads)
+created = tf.create_watch(
+    spec={
+        "type": "price",
+        "model": "Claude Opus 4.7",
+        "field": "blended",
+        "op": "lt",
+        "threshold": 30,
+    },
+    callback_url="https://agent.example.com/hook",
+    secret="any-shared-secret",  # used to sign deliveries
+)
+watch_id = created["watch"]["id"]
+print(f"Watch {watch_id} active until {created['watch']['expires_at']}")
+
+# When a delivery arrives, verify it:
+#   sig = request.headers["X-TensorFeed-Signature"]  # "sha256=<hex>"
+#   import hmac, hashlib
+#   expected = "sha256=" + hmac.new(b"any-shared-secret", body, hashlib.sha256).hexdigest()
+#   assert hmac.compare_digest(sig, expected)
+
+print(tf.list_watches())          # see all your active watches
+print(tf.get_watch(watch_id))     # check fire_count, last_fired_at
+tf.delete_watch(watch_id)         # remove when done
+
 # Check remaining credits
 print(tf.balance())
 ```
@@ -170,7 +210,24 @@ except TensorFeedError as e:
 | Method | Cost | Description |
 |--------|------|-------------|
 | `tf.balance()` | Free | Check remaining credits |
+| `tf.usage()` | Free | Per-token call history (last 100 calls aggregated by endpoint) |
 | `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 |
+| `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 |
+| `tf.get_watch(watch_id)` | Free | Read one watch including fire_count and last_fired_at |
+| `tf.delete_watch(watch_id)` | Free | Remove an owned watch |
+| `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.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 |
 
 ### Auto-send (requires `tensorfeed[web3]`)
 
@@ -193,11 +250,15 @@ If any source disagrees, do not send.
 
 ## Premium Data Terms
 
-Premium API responses are licensed for inference use only. Use of TensorFeed premium data for training, fine-tuning, evaluation, or distillation of ML models is prohibited.
+Premium API responses are licensed for inference use only. Use of TensorFeed premium data for training, fine-tuning, evaluation, or distillation of ML models is prohibited (Section 17.1 of the [Terms](https://tensorfeed.ai/terms#premium)).
+
+## No refunds; credits do not expire
+
+All credit purchases are final and non-refundable per Section 17.5 of the [Terms](https://tensorfeed.ai/terms#premium). Credits never expire and are jointly redeemable on tensorfeed.ai and terminalfeed.io. The recommended pattern is to buy in small increments (for example, $1 USDC for 50 credits) until call volume is calibrated, then top up as needed.
 
-## Refunds
+## Sanctions
 
-Email `evan@tensorfeed.ai` with the tx hash within 24 hours of the charge for a manual USDC refund.
+Premium API access is unavailable to persons or entities subject to OFAC, EU, UK, or UN sanctions, and to residents of comprehensively sanctioned jurisdictions (Cuba, Iran, North Korea, Syria, Crimea, Donetsk, Luhansk). Inbound credit-purchase transactions are screened against the Chainalysis public sanctions API. See Section 17.9 of the [Terms](https://tensorfeed.ai/terms#premium).
 
 ## Links
 

{tensorfeed-1.2.0 → tensorfeed-1.16.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.16.0"
+description = "Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, agent payments via USDC on Base (optional web3 auto-send)"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.9"
@@ -41,6 +41,21 @@ web3 = [
     "web3>=6.0",
     "eth-account>=0.10",
 ]
+# pip install 'tensorfeed[langchain]' to enable tensorfeed.langchain
+# (StructuredTool wrappers + Document loader for AI news).
+langchain = [
+    "langchain-core>=0.3",
+]
+# pip install 'tensorfeed[llamaindex]' to enable tensorfeed.llamaindex
+# (BaseReader implementations for news and the attention index).
+llamaindex = [
+    "llama-index-core>=0.11",
+]
+# pip install 'tensorfeed[crewai]' to enable tensorfeed.crewai
+# (BaseTool wrappers for news, status, attention, harnesses, routing).
+crewai = [
+    "crewai>=0.70",
+]
 
 [project.urls]
 Homepage = "https://tensorfeed.ai"

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

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