oneshot-python 0.35.0__tar.gz → 0.36.0__tar.gz

{oneshot_python-0.35.0 → oneshot_python-0.36.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: oneshot-python
-Version: 0.35.0
-Summary: Core Python SDK for the OneShot API — HTTP client with x402 payment handling — 45 tools
+Version: 0.36.0
+Summary: Core Python SDK for the OneShot API — HTTP client with x402 payment handling — 48 tools
 License-Expression: MIT
 Requires-Python: >=3.10
 Requires-Dist: eth-account>=0.13.0

{oneshot_python-0.35.0 → oneshot_python-0.36.0}/README.md

@@ -269,6 +269,28 @@ client.linkedin_withdraw_invitation(
 
 Async equivalents are `alinkedin_invite()` and `alinkedin_withdraw_invitation()`. Use the OneShot `invitation_id`, not the provider invitation ID. Withdrawal can cancel a queued invitation and never disconnects an established connection. Invitations default to 25 per account per UTC day; withdrawal does not restore capacity for an invitation already sent. Reuse the same key when retrying an operation.
 
+### LinkedIn: message a connection and read invitation status
+
+Available in `oneshot-python` 0.36.0 and later.
+
+```python
+# Accepted as soon as the person is a connection; no message needs to be exchanged first.
+current = client.linkedin_invitation(account_id, invitation["invitation_id"])
+if current["status"] == "accepted":
+    sent = client.linkedin_message(
+        account_id,
+        "https://www.linkedin.com/in/jane-doe/",
+        "Thanks for connecting.",
+        idempotency_key="event-jane-first-message",
+    )
+    conversation_id = sent["conversation_id"]
+
+# Poll for changes instead of asking one by one:
+changed = client.linkedin_invitations(account_id, status="accepted", changed_since="2026-10-01T00:00:00Z")
+```
+
+`linkedin_message()` posts into the 1:1 conversation the account already has with that connection, or starts one. It needs the `reply` grant and shares the reply daily cap. A failed send carries an error code: `not_connected` (invite them first) and `rate_limited` mean defer, not give up. The two invitation reads are free. Statuses are `pending`, `accepted`, `withdrawn`, `declined_or_unknown` and `not_sent`. Async equivalents are `alinkedin_message()`, `alinkedin_invitation()` and `alinkedin_invitations()`.
+
 ### Soul Hunt
 
 `client.hunts` talks to Soul Hunt (`api.soulhunt.ai` by default — override with `OneShotClient(..., hunt_url=...)`), a separate service from the main OneShot API:
@@ -301,7 +323,7 @@ Async variants prefix the method with `a` (`alist`, `astatus`, `apredict`, `acap
 ## Links
 
 - [Documentation](https://docs.oneshotagent.com/sdk/installation#install-via-pip-python)
-- [LangChain integration](https://pypi.org/project/langchain-oneshot/): 45 tools as LangChain BaseTool
+- [LangChain integration](https://pypi.org/project/langchain-oneshot/): 48 tools as LangChain BaseTool
 - [GAME plugin](https://pypi.org/project/game-plugin-oneshot/): Virtuals Protocol integration
 - [TypeScript SDK](https://www.npmjs.com/package/@oneshot-agent/sdk)
 - [MCP Server](https://www.npmjs.com/package/@oneshot-agent/mcp-server)

{oneshot_python-0.35.0 → oneshot_python-0.36.0}/oneshot/client.py

@@ -59,7 +59,7 @@ try:
 
     SDK_VERSION = _pkg_version("oneshot-python")
 except Exception:  # pragma: no cover - editable/source runs without dist metadata
-    SDK_VERSION = "0.35.0"
+    SDK_VERSION = "0.36.0"
 
 _BASE_URL = "https://win.oneshotagent.com"
 _HUNT_BASE_URL = "https://api.soulhunt.ai"
@@ -1667,6 +1667,20 @@ class OneShotClient:
     async def alinkedin_messages(self, account_id: str, **params: Any) -> dict:
         return await self.acall_free_get(f"/v1/tools/linkedin/accounts/{quote(account_id, safe='')}/messages", _linkedin_query(params))
 
+    def linkedin_invitation(self, account_id: str, invitation_id: str) -> dict:
+        """One invitation sent through linkedin_invite: `accepted` (with `accepted_at`) as soon as the person is a connection. Free."""
+        return self.call_free_get(f"/v1/tools/linkedin/accounts/{quote(account_id, safe='')}/invitations/{quote(invitation_id, safe='')}")
+
+    async def alinkedin_invitation(self, account_id: str, invitation_id: str) -> dict:
+        return await self.acall_free_get(f"/v1/tools/linkedin/accounts/{quote(account_id, safe='')}/invitations/{quote(invitation_id, safe='')}")
+
+    def linkedin_invitations(self, account_id: str, **params: Any) -> dict:
+        """Invitations sent through linkedin_invite, most recently changed first. Params: status, changed_since, limit. Free."""
+        return self.call_free_get(f"/v1/tools/linkedin/accounts/{quote(account_id, safe='')}/invitations", _linkedin_query(params))
+
+    async def alinkedin_invitations(self, account_id: str, **params: Any) -> dict:
+        return await self.acall_free_get(f"/v1/tools/linkedin/accounts/{quote(account_id, safe='')}/invitations", _linkedin_query(params))
+
     def _linkedin_invitation_call(self, endpoint: str, payload: dict, **kwargs: Any) -> Any:
         return asyncio.get_event_loop().run_until_complete(self._alinkedin_invitation_call(endpoint, payload, **kwargs))
 
@@ -1713,6 +1727,17 @@ class OneShotClient:
         return await self.acall_tool("/v1/tools/linkedin/reply", {"account_id": account_id, "conversation_id": conversation_id, "text": text, **kwargs},
                                      max_cost=max_cost, timeout_sec=timeout_sec, wait=wait, idempotency_key=idempotency_key or _new_idempotency_key())
 
+    def linkedin_message(self, account_id: str, profile: str, text: str, *, idempotency_key: Optional[str] = None, max_cost: Optional[float] = None, timeout_sec: int = 180, wait: bool = True, **kwargs: Any) -> Any:
+        """Message a first-degree connection: into the 1:1 conversation the account already has with them, or a new one.
+        Needs the `reply` grant and shares its daily cap. A failed send carries an error code: `not_connected` and
+        `rate_limited` mean defer, not give up. An Idempotency-Key is generated when not supplied. Blocking."""
+        return self.call_tool("/v1/tools/linkedin/message", {"account_id": account_id, "profile": profile, "text": text, **kwargs},
+                              max_cost=max_cost, timeout_sec=timeout_sec, wait=wait, idempotency_key=idempotency_key or _new_idempotency_key())
+
+    async def alinkedin_message(self, account_id: str, profile: str, text: str, *, idempotency_key: Optional[str] = None, max_cost: Optional[float] = None, timeout_sec: int = 180, wait: bool = True, **kwargs: Any) -> Any:
+        return await self.acall_tool("/v1/tools/linkedin/message", {"account_id": account_id, "profile": profile, "text": text, **kwargs},
+                                     max_cost=max_cost, timeout_sec=timeout_sec, wait=wait, idempotency_key=idempotency_key or _new_idempotency_key())
+
     def linkedin_view_profile(self, account_id: str, identifier: str, *, notify: bool = False, idempotency_key: Optional[str] = None, max_cost: Optional[float] = None, timeout_sec: int = 180, wait: bool = True, **kwargs: Any) -> Any:
         """View a profile through the connected account (public-safe summary). notify=True cannot be undone. Blocking."""
         return self.call_tool("/v1/tools/linkedin/profile-view", {"account_id": account_id, "identifier": identifier, "notify": bool(notify), **kwargs},

{oneshot_python-0.35.0 → oneshot_python-0.36.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "oneshot-python"
-version = "0.35.0"
-description = "Core Python SDK for the OneShot API — HTTP client with x402 payment handling — 45 tools"
+version = "0.36.0"
+description = "Core Python SDK for the OneShot API — HTTP client with x402 payment handling — 48 tools"
 readme = {text = "Core Python SDK for the OneShot API", content-type = "text/plain"}
 license = "MIT"
 requires-python = ">=3.10"

{oneshot_python-0.35.0 → oneshot_python-0.36.0}/tests/test_linkedin.py

@@ -187,3 +187,37 @@ def test_reconnect_sends_complete_upgrade_grant(asynchronous):
         client.call_free_post = Mock(return_value=result)
         assert client.reconnect_linkedin_account('account/id', requested_actions=actions) == result
         client.call_free_post.assert_called_once_with('/v1/tools/linkedin/accounts/account%2Fid/reconnect', {'requested_actions': actions}, scope='write')
+
+
+@pytest.mark.asyncio
+async def test_message_is_paid_and_idempotency_keyed():
+    client = OneShotClient(TEST_PRIVATE_KEY)
+    client.acall_tool = AsyncMock(return_value={"status": "sent", "conversation_id": "conv"})
+
+    await client.alinkedin_message("acc", "https://www.linkedin.com/in/jane/", "hi", memo="m")
+    args, kwargs = client.acall_tool.await_args
+    assert args == ("/v1/tools/linkedin/message", {"account_id": "acc", "profile": "https://www.linkedin.com/in/jane/", "text": "hi", "memo": "m"})
+    assert len(kwargs["idempotency_key"]) == 32  # auto-generated
+    assert kwargs["timeout_sec"] == 180 and kwargs["wait"] is True
+
+    await client.alinkedin_message("acc", "jane", "hi", idempotency_key="fixed")
+    assert client.acall_tool.await_args.kwargs["idempotency_key"] == "fixed"
+
+
+@pytest.mark.asyncio
+async def test_invitation_status_reads_are_free():
+    client = OneShotClient(TEST_PRIVATE_KEY)
+    client.acall_free_get = AsyncMock(return_value={"invitations": []})
+    client.acall_tool = AsyncMock()
+
+    await client.alinkedin_invitation("acc", "inv 1")
+    client.acall_free_get.assert_awaited_with("/v1/tools/linkedin/accounts/acc/invitations/inv%201")
+    await client.alinkedin_invitations("acc", status="accepted", changed_since="2026-10-01T00:00:00Z", limit=20)
+    client.acall_free_get.assert_awaited_with(
+        "/v1/tools/linkedin/accounts/acc/invitations",
+        {"status": "accepted", "changed_since": "2026-10-01T00:00:00Z", "limit": "20"},
+    )
+    await client.alinkedin_invitations("acc")
+    client.acall_free_get.assert_awaited_with("/v1/tools/linkedin/accounts/acc/invitations", None)
+    client.acall_tool.assert_not_awaited()
+