oneshot-python 0.39.0__tar.gz → 0.40.1__tar.gz

oneshot_python-0.40.1/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 0.40.1
+
+- Restore synchronous pause/resume calls when no event loop is current.
+- Send person quote IDs through the request header, excluding them from tool payloads.
+- Describe Changes queries for published dataset attributes.
+
+## 0.40.0 — breaking release (#1336)
+
+- Renamed `commerce_search()` / `acommerce_search()` → `product_find()` / `aproduct_find()`, without aliases.
+- Product discovery now calls `POST /v1/tools/find/product` (price key `find/product`), replacing `POST /v1/tools/commerce/search` (`commerce/search`). Input, results and Purchase compatibility are unchanged.
+- Release together with the person/company and other tool renames in #1334 and #1382; publish only with the coordinated server release.

{oneshot_python-0.39.0 → oneshot_python-0.40.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: oneshot-python
-Version: 0.39.0
+Version: 0.40.1
 Summary: Core Python SDK for the OneShot API — HTTP client with x402 payment handling — 48 tools
 License-Expression: MIT
 Requires-Python: >=3.10

{oneshot_python-0.39.0 → oneshot_python-0.40.1}/README.md

@@ -34,6 +34,11 @@ balance = client.call_free_get("/v1/wallet/balance")
 
 ### Async
 
+Blocking `OneShotClient` methods reuse the current open event loop, or run on a
+temporary loop when none is available (including after `asyncio.run()`). Inside
+a running event loop, use the async method instead; blocking calls raise an
+error naming the async method to await.
+
 ```python
 import asyncio
 from oneshot import OneShotClient
@@ -343,3 +348,18 @@ async form).
 ## License
 
 MIT
+
+## Optional phone lookup
+
+Phone lookup is off by default. Source-returned numbers and published business or record numbers still appear. `include_phone=True` adds the per-person add-on listed on the pricing page × the requested search limit (default 100) for a search, or once for profile/dossier, for up to that many people with no guaranteed hit. Fallbacks and callbacks cost nothing extra. A completed lookup with no phone match is charged; a failed job is refunded.
+
+`max_cost` and per-transaction budgets apply to the full quote before authorization, even when credits cover it. Wallet and access-token sessions both obtain a quote before execution and retry with `x-quote-id`.
+
+```python
+people = client.person_find(job_titles=["CTO"], limit=3, include_phone=True, max_cost=1, wait_for_phones=True)
+profile = client.person_profile(email="jane@example.com", include_phone=True, max_cost=1, wait_for_phones=True)
+dossier = client.person_dossier(email="jane@example.com", include_phone=True, max_cost=1, wait_for_phones=True, timeout_sec=600)
+# Async equivalents: await client.aperson_find(...), aperson_profile(...), aperson_dossier(...).
+```
+
+`wait=False` returns the job and receipt IDs immediately. `wait_for_phones=True` keeps polling for pending phone callbacks after completion; it does not buy phones by itself. On timeout, the latest result can still have `phones_pending: True`.