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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: oneshot-python
-Version: 0.38.0
+Version: 0.39.0
 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.38.0 → oneshot_python-0.39.0}/README.md

@@ -244,7 +244,7 @@ except LinkedInConnectRequiredError:
 
 Account reads stop offering reconnect after confirming upstream deletion.
 Missing accounts are excluded from the active list; `include_revoked=True`
-lets you inspect their `deleted_upstream` status and `reconnect_required=False`.
+lets you inspect their `connection_deleted` status and `reconnect_required=False`.
 Authentication failures and timeouts remain ordinary errors and do not instruct
 the consumer to create a new connection.
 

{oneshot_python-0.38.0 → oneshot_python-0.39.0}/oneshot/client.py

@@ -60,13 +60,13 @@ try:
 
     SDK_VERSION = _pkg_version("oneshot-python")
 except Exception:  # pragma: no cover - editable/source runs without dist metadata
-    SDK_VERSION = "0.38.0"
+    SDK_VERSION = "0.39.0"
 
 _BASE_URL = "https://win.oneshotagent.com"
 _HUNT_BASE_URL = "https://api.soulhunt.ai"
 _ACCESS_TOKEN_RE = re.compile(r"^oneshot_[0-9a-f]{64}$")
 # Endpoints whose admission reads a "submit"-scoped agent proof (same list as the TypeScript SDK).
-_DURABLE_ADMISSION_ENDPOINT = re.compile(r"(enrich/(profile|email)|verify/email|physical-mail/send)$")
+_DURABLE_ADMISSION_ENDPOINT = re.compile(r"(lookup/person-(profile|email|email-status)|lookup/place-permits|physical-mail/send)$")
 _CHAIN_ID = 8453
 _USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
 
@@ -2073,37 +2073,37 @@ class OneShotClient:
         approval_id = kwargs.pop("approval_id", None)
         return await self.acall_tool("/v1/tools/sms/send", {"message": message, "to_number": to_number, **kwargs}, approval_id=approval_id)
 
-    def people_search(self, **kwargs: Any) -> Any:
+    def person_find(self, **kwargs: Any) -> Any:
         """Search for people by job title, company, etc. Blocking."""
-        return self.call_tool("/v1/tools/research/people", kwargs)
+        return self.call_tool("/v1/tools/find/person", kwargs)
 
-    async def apeople_search(self, **kwargs: Any) -> Any:
+    async def aperson_find(self, **kwargs: Any) -> Any:
         """Search for people by job title, company, etc. Async."""
-        return await self.acall_tool("/v1/tools/research/people", kwargs)
+        return await self.acall_tool("/v1/tools/find/person", kwargs)
 
-    def enrich_profile(self, **kwargs: Any) -> Any:
+    def person_profile(self, **kwargs: Any) -> Any:
         """Enrich a person's profile from LinkedIn URL, email, or name. Blocking."""
-        return self.call_tool("/v1/tools/enrich/profile", kwargs)
+        return self.call_tool("/v1/tools/lookup/person-profile", kwargs)
 
-    async def aenrich_profile(self, **kwargs: Any) -> Any:
+    async def aperson_profile(self, **kwargs: Any) -> Any:
         """Enrich a person's profile from LinkedIn URL, email, or name. Async."""
-        return await self.acall_tool("/v1/tools/enrich/profile", kwargs)
+        return await self.acall_tool("/v1/tools/lookup/person-profile", kwargs)
 
-    def company_search(self, **kwargs: Any) -> Any:
+    def company_find(self, **kwargs: Any) -> Any:
         """Search for companies by name, domain, industry, location, size, etc. Blocking."""
-        return self.call_tool("/v1/tools/research/company", kwargs)
+        return self.call_tool("/v1/tools/find/company", kwargs)
 
-    async def acompany_search(self, **kwargs: Any) -> Any:
+    async def acompany_find(self, **kwargs: Any) -> Any:
         """Search for companies by name, domain, industry, location, size, etc. Async."""
-        return await self.acall_tool("/v1/tools/research/company", kwargs)
+        return await self.acall_tool("/v1/tools/find/company", kwargs)
 
-    def enrich_company(self, **kwargs: Any) -> Any:
+    def company_profile(self, **kwargs: Any) -> Any:
         """Enrich a company from domain, name, LinkedIn URL, or ticker. Blocking."""
-        return self.call_tool("/v1/tools/enrich/company", kwargs)
+        return self.call_tool("/v1/tools/lookup/company-profile", kwargs)
 
-    async def aenrich_company(self, **kwargs: Any) -> Any:
+    async def acompany_profile(self, **kwargs: Any) -> Any:
         """Enrich a company from domain, name, LinkedIn URL, or ticker. Async."""
-        return await self.acall_tool("/v1/tools/enrich/company", kwargs)
+        return await self.acall_tool("/v1/tools/lookup/company-profile", kwargs)
 
     def business_find(self, **kwargs: Any) -> Any:
         """Discover local businesses (restaurants, contractors, practices) by category/keywords x location. Blocking."""
@@ -2129,7 +2129,7 @@ class OneShotClient:
         """Federal Sources Sought / Presolicitation notices (SAM.gov) by NAICS code with the contracting officer's contact. Result carries `data_as_of` (snapshot behind the rows). Async."""
         return await self.acall_tool("/v1/tools/find/record-solicitations", {"naics": naics, **kwargs})
 
-    def find_email(self, company_domain: str, *, full_name: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, **kwargs: Any) -> Any:
+    def person_email(self, company_domain: str, *, full_name: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, **kwargs: Any) -> Any:
         """Find a person's email address. Blocking."""
         payload: dict[str, Any] = {"company_domain": company_domain, **kwargs}
         if full_name:
@@ -2138,9 +2138,9 @@ class OneShotClient:
             payload["first_name"] = first_name
         if last_name:
             payload["last_name"] = last_name
-        return self.call_tool("/v1/tools/enrich/email", payload)
+        return self.call_tool("/v1/tools/lookup/person-email", payload)
 
-    async def afind_email(self, company_domain: str, *, full_name: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, **kwargs: Any) -> Any:
+    async def aperson_email(self, company_domain: str, *, full_name: Optional[str] = None, first_name: Optional[str] = None, last_name: Optional[str] = None, **kwargs: Any) -> Any:
         """Find a person's email address. Async."""
         payload: dict[str, Any] = {"company_domain": company_domain, **kwargs}
         if full_name:
@@ -2149,63 +2149,63 @@ class OneShotClient:
             payload["first_name"] = first_name
         if last_name:
             payload["last_name"] = last_name
-        return await self.acall_tool("/v1/tools/enrich/email", payload)
+        return await self.acall_tool("/v1/tools/lookup/person-email", payload)
 
-    def verify_email(self, email: str) -> Any:
+    def person_email_status(self, email: str) -> Any:
         """Verify email deliverability. Blocking."""
-        return self.call_tool("/v1/tools/verify/email", {"email": email})
+        return self.call_tool("/v1/tools/lookup/person-email-status", {"email": email})
 
-    async def averify_email(self, email: str) -> Any:
+    async def aperson_email_status(self, email: str) -> Any:
         """Verify email deliverability. Async."""
-        return await self.acall_tool("/v1/tools/verify/email", {"email": email})
+        return await self.acall_tool("/v1/tools/lookup/person-email-status", {"email": email})
 
-    def deep_research_person(self, **kwargs: Any) -> Any:
+    def person_dossier(self, **kwargs: Any) -> Any:
         """Deep research on a person. Blocking."""
-        return self.call_tool("/v1/tools/research/person", kwargs)
+        return self.call_tool("/v1/tools/lookup/person-dossier", kwargs)
 
-    async def adeep_research_person(self, **kwargs: Any) -> Any:
+    async def aperson_dossier(self, **kwargs: Any) -> Any:
         """Deep research on a person. Async."""
-        return await self.acall_tool("/v1/tools/research/person", kwargs)
+        return await self.acall_tool("/v1/tools/lookup/person-dossier", kwargs)
 
-    def social_profiles(self, **kwargs: Any) -> Any:
+    def person_social_accounts(self, **kwargs: Any) -> Any:
         """Discover social media profiles. Blocking."""
-        return self.call_tool("/v1/tools/research/social", kwargs)
+        return self.call_tool("/v1/tools/lookup/person-social-accounts", kwargs)
 
-    async def asocial_profiles(self, **kwargs: Any) -> Any:
+    async def aperson_social_accounts(self, **kwargs: Any) -> Any:
         """Discover social media profiles. Async."""
-        return await self.acall_tool("/v1/tools/research/social", kwargs)
+        return await self.acall_tool("/v1/tools/lookup/person-social-accounts", kwargs)
 
-    def article_search(self, name: str, company: str, **kwargs: Any) -> Any:
+    def person_articles(self, name: str, company: str, **kwargs: Any) -> Any:
         """Find articles by or about a person. Blocking."""
-        return self.call_tool("/v1/tools/research/articles", {"name": name, "company": company, **kwargs})
+        return self.call_tool("/v1/tools/lookup/person-articles", {"name": name, "company": company, **kwargs})
 
-    async def aarticle_search(self, name: str, company: str, **kwargs: Any) -> Any:
+    async def aperson_articles(self, name: str, company: str, **kwargs: Any) -> Any:
         """Find articles by or about a person. Async."""
-        return await self.acall_tool("/v1/tools/research/articles", {"name": name, "company": company, **kwargs})
+        return await self.acall_tool("/v1/tools/lookup/person-articles", {"name": name, "company": company, **kwargs})
 
-    def person_newsfeed(self, social_media_url: str, **kwargs: Any) -> Any:
+    def person_posts(self, social_media_url: str, **kwargs: Any) -> Any:
         """Get recent social posts from a person. Blocking."""
-        return self.call_tool("/v1/tools/research/newsfeed", {"social_media_url": social_media_url, **kwargs})
+        return self.call_tool("/v1/tools/lookup/person-posts", {"social_media_url": social_media_url, **kwargs})
 
-    async def aperson_newsfeed(self, social_media_url: str, **kwargs: Any) -> Any:
+    async def aperson_posts(self, social_media_url: str, **kwargs: Any) -> Any:
         """Get recent social posts from a person. Async."""
-        return await self.acall_tool("/v1/tools/research/newsfeed", {"social_media_url": social_media_url, **kwargs})
+        return await self.acall_tool("/v1/tools/lookup/person-posts", {"social_media_url": social_media_url, **kwargs})
 
     def person_interests(self, **kwargs: Any) -> Any:
         """Analyze a person's interests from their digital footprint. Blocking."""
-        return self.call_tool("/v1/tools/research/interests", kwargs)
+        return self.call_tool("/v1/tools/lookup/person-interests", kwargs)
 
     async def aperson_interests(self, **kwargs: Any) -> Any:
         """Analyze a person's interests from their digital footprint. Async."""
-        return await self.acall_tool("/v1/tools/research/interests", kwargs)
+        return await self.acall_tool("/v1/tools/lookup/person-interests", kwargs)
 
-    def person_interactions(self, social_media_url: str, **kwargs: Any) -> Any:
+    def person_followers(self, social_media_url: str, **kwargs: Any) -> Any:
         """Get a person's social interactions. Blocking."""
-        return self.call_tool("/v1/tools/research/interactions", {"social_media_url": social_media_url, **kwargs})
+        return self.call_tool("/v1/tools/lookup/person-followers", {"social_media_url": social_media_url, **kwargs})
 
-    async def aperson_interactions(self, social_media_url: str, **kwargs: Any) -> Any:
+    async def aperson_followers(self, social_media_url: str, **kwargs: Any) -> Any:
         """Get a person's social interactions. Async."""
-        return await self.acall_tool("/v1/tools/research/interactions", {"social_media_url": social_media_url, **kwargs})
+        return await self.acall_tool("/v1/tools/lookup/person-followers", {"social_media_url": social_media_url, **kwargs})
 
     def commerce_search(self, query: str, *, limit: int = 10, **kwargs: Any) -> Any:
         """Search for products. Blocking."""
@@ -2515,8 +2515,8 @@ class OneShotClient:
     @staticmethod
     def _is_phones_pending(result: Any) -> bool:
         """Detects whether a result is awaiting Apollo's async phone-reveal
-        webhook. Tolerates two shapes: the unwrapped result ``{phones_pending}``
-        and the deep_research_person wrapper ``{result: {phones_pending}}``.
+        webhook. Accepts legacy flat results and person_dossier's
+        ``result.profile.data.phones_pending``.
 
         Mirrors the TS SDK's _isPhonesPending — kept in lockstep so the worker
         contract works for both SDKs.
@@ -2528,6 +2528,10 @@ class OneShotClient:
         inner = result.get("result")
         if isinstance(inner, dict) and inner.get("phones_pending") is True:
             return True
+        profile = inner.get("profile") if isinstance(inner, dict) else None
+        data = profile.get("data") if isinstance(profile, dict) else None
+        if isinstance(data, dict) and data.get("phones_pending") is True:
+            return True
         return False
 
     async def _poll_for_phones(