persona-sdk-python 0.2.24__tar.gz → 0.2.25__tar.gz

{persona_sdk_python-0.2.24 → persona_sdk_python-0.2.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: persona-sdk-python
-Version: 0.2.24
+Version: 0.2.25
 Summary: Async Python SDK for the Persona AI platform
 Project-URL: Homepage, https://persona.applica.guru
 Project-URL: Repository, https://bitbucket.org/applicaguru/persona-sdk-python

{persona_sdk_python-0.2.24 → persona_sdk_python-0.2.25}/persona_sdk/__init__.py

@@ -13,6 +13,7 @@ from persona_sdk.api.sessions import SessionsApi
 from persona_sdk.api.triggers import TriggersApi
 from persona_sdk.api.workflows import WorkflowsApi
 from persona_sdk.api.human_tasks import HumanTasksApi
+from persona_sdk.api.channels import ChannelsApi
 from persona_sdk.auth import (
     ApiKeyAuthenticationProvider,
     AuthenticationProvider,
@@ -61,6 +62,7 @@ __all__ = [
     "TriggersApi",
     "WorkflowsApi",
     "HumanTasksApi",
+    "ChannelsApi",
     # Domain models (re-exported from persona-models)
     "Paginated",
     "AgentConfiguration",
@@ -139,6 +141,7 @@ class PersonaSdk:
         self.agents = AgentsApi(self.client)
         self.workflows = WorkflowsApi(self.workflows_client)
         self.human_tasks = HumanTasksApi(self.workflows_client)
+        self.channels = ChannelsApi(self.workflows_client)
         self.triggers = TriggersApi(self.client)
         self.sessions = SessionsApi(self.client)
         self.credentials = CredentialsApi(self.client)

persona_sdk_python-0.2.25/persona_sdk/api/channels.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+from typing import Any
+
+from persona_sdk.client import PersonaClient
+
+
+class ChannelsApi:
+    """
+    Notification channels: where the project's human tasks are announced
+    and can be answered outside the inbox (a Telegram group, one message
+    per task). Linking happens through deep links: the service
+    returns a one-shot URL (``t.me/<bot>?startgroup=...`` for a group,
+    ``t.me/<bot>?start=...`` for the user's own account).
+
+    Lives on the workflows service (same client as ``HumanTasksApi``).
+    Identity endpoints require a user (IAM bearer) session.
+    """
+
+    def __init__(self, client: PersonaClient):
+        self._client = client
+
+    async def providers(self) -> list[dict[str, Any]]:
+        """The providers enabled on the server (e.g. the Telegram bot)."""
+        return await self._client.get("/channels/providers")
+
+    async def list(self) -> list[dict[str, Any]]:
+        """The project's channels, with their setup status."""
+        return await self._client.get("/channels")
+
+    async def create_link(self, provider: str = "telegram") -> dict[str, Any]:
+        """One-shot deep link that links a group to the project."""
+        return await self._client.post(f"/channels/{provider}/link-token")
+
+    async def update(
+        self,
+        channel_id: str,
+        include_payload: bool | None = None,
+        locale: str | None = None,
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {}
+        if include_payload is not None:
+            body["includePayload"] = include_payload
+        if locale:
+            body["locale"] = locale
+        return await self._client.patch(f"/channels/{channel_id}", json=body)
+
+    async def verify(self, channel_id: str) -> dict[str, Any]:
+        """Re-checks the channel setup (the bot can still post in the group)."""
+        return await self._client.post(f"/channels/{channel_id}/verify")
+
+    async def unlink(self, channel_id: str) -> None:
+        await self._client.delete(f"/channels/{channel_id}")
+
+    async def my_identities(self) -> list[dict[str, Any]]:
+        """The caller's linked accounts."""
+        return await self._client.get("/channels/identities/me")
+
+    async def create_identity_link(self, provider: str = "telegram") -> dict[str, Any]:
+        """One-shot deep link that links the caller's account."""
+        return await self._client.post(f"/channels/identities/{provider}/link-token")
+
+    async def unlink_identity(self, provider: str = "telegram") -> None:
+        await self._client.delete(f"/channels/identities/me/{provider}")

{persona_sdk_python-0.2.24 → persona_sdk_python-0.2.25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "persona-sdk-python"
-version = "0.2.24"
+version = "0.2.25"
 description = "Async Python SDK for the Persona AI platform"
 readme = "README.md"
 requires-python = ">=3.10"

{persona_sdk_python-0.2.24 → persona_sdk_python-0.2.25}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 5
 requires-python = ">=3.10"
 
 [[package]]
@@ -106,7 +106,7 @@ wheels = [
 
 [[package]]
 name = "persona-sdk-python"
-version = "0.2.24"
+version = "0.2.25"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },