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

persona_sdk_python-0.2.25/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+# Smoke su PR: il repo non ha suite di test (non ne aveva in Bitbucket).
+# Lo smoke verifica che uv.lock risolva (--frozen) e che il package importi.
+# Il publish avviene solo al push su main (deploy.yml).
+
+on:
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  smoke:
+    name: Smoke
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Installa uv
+        run: pip install uv
+      - name: Smoke import
+        run: |
+          uv sync --frozen
+          uv run python -c "import persona_sdk; print('smoke ok:', persona_sdk.__name__)"

persona_sdk_python-0.2.25/.github/workflows/deploy.yml

@@ -0,0 +1,154 @@
+name: Publish
+
+# Due percorsi di ingresso:
+#  - push su main          → SEMPRE smoke + build + publish (percorso sicuro default)
+#  - workflow_dispatch     → scelta manuale della modalità:
+#      test-and-publish : smoke + build + publish (come il push)
+#      publish-only     : SOLO build + publish — test saltati volontariamente
+#
+# Il job `version` riconcilia la versione sull'ultimo tag git (max semver,
+# patch +1 — es. 0.2.23 → 0.2.24) e applica una guard anti-collisione:
+# interroga PyPI e bumpa finché la versione è libera (PyPI è immutabile:
+# un doppio upload fallirebbe e bloccherebbe la release).
+#
+# Poi smoke ∥ build-package in parallelo → publish (OIDC Trusted
+# Publishing, nessun segreto) → tag git della versione.
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      mode:
+        description: "Modalità di pubblicazione"
+        type: choice
+        required: true
+        default: test-and-publish
+        options:
+          - test-and-publish
+          - publish-only
+
+concurrency:
+  group: publish-persona-sdk-python
+  cancel-in-progress: false
+
+permissions:
+  contents: write # push del tag di versione con GITHUB_TOKEN
+  id-token: write # Trusted Publishing OIDC verso PyPI
+
+jobs:
+  version:
+    name: Calcola versione (riconciliazione sui tag + guard PyPI)
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.v.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # serve la history dei tag
+      - id: v
+        run: |
+          LAST=$(git tag -l --sort=-v:refname | head -1)
+          VERSION="${LAST%.*}.$(( ${LAST##*.} + 1 ))"
+          echo "Ultimo tag git ${LAST} → proposta ${VERSION}"
+          # Guard anti-collisione: bumpa finché la versione esiste già su PyPI
+          for _ in 1 2 3 4 5; do
+            if curl -sf "https://pypi.org/pypi/persona-sdk-python/${VERSION}/json" > /dev/null 2>&1; then
+              echo "⚠️ ${VERSION} già esiste su PyPI → bump"
+              VERSION="${VERSION%.*}.$(( ${VERSION##*.} + 1 ))"
+            else
+              break
+            fi
+          done
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "Versione finale: ${VERSION}"
+
+  test:
+    name: Test (smoke import)
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' || inputs.mode == 'test-and-publish'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Installa uv
+        run: pip install uv
+      - name: Smoke import
+        # il repo non ha suite di test (non ne aveva in Bitbucket): lo smoke
+        # verifica che uv.lock risolva e che il package importi
+        run: |
+          uv sync --frozen
+          uv run python -c "import persona_sdk; print('smoke ok:', persona_sdk.__name__)"
+
+  build-package:
+    name: Build & check sdist/wheel
+    runs-on: ubuntu-latest
+    needs: [version] # in parallelo al job test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Installa uv
+        run: pip install uv
+      - name: Build (versione sed-ata in pyproject, come faceva Bitbucket)
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+        run: |
+          sed -i "s/^version = .*/version = \"${VERSION}\"/" pyproject.toml
+          uv run --with build python -m build
+          uv run --with twine python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish su PyPI
+    runs-on: ubuntu-latest
+    needs: [version, test, build-package]
+    # pubblica se il build è verde E (il test è verde OPPURE volontariamente assente)
+    if: >-
+      always() &&
+      needs.build-package.result == 'success' &&
+      (needs.test.result == 'success' || needs.test.result == 'skipped')
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish (Trusted Publishing OIDC — nessun token)
+        uses: pypa/gh-action-pypi-publish@release/v1
+      - name: Summary
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+          MODE: ${{ inputs.mode || 'test-and-publish (push su main)' }}
+        run: |
+          {
+            echo "### Publish persona-sdk-python ${VERSION}"
+            echo ""
+            echo "Modalità: **${MODE}**"
+            if [ "${{ needs.test.result }}" = "skipped" ]; then
+              echo ""
+              echo "⚠️ **Test saltati volontariamente** (publish-only)"
+            fi
+            echo ""
+            echo "Pacchetto: https://pypi.org/project/persona-sdk-python/${VERSION}/"
+          } >> "$GITHUB_STEP_SUMMARY"
+
+  tag-release:
+    name: Tag di versione
+    runs-on: ubuntu-latest
+    needs: [version, publish]
+    if: always() && needs.publish.result == 'success'
+    steps:
+      - uses: actions/checkout@v4
+      - name: Crea e pusha il tag
+        env:
+          VERSION: ${{ needs.version.outputs.version }}
+        run: |
+          git config user.name "RoBYCoNTe"
+          git config user.email "2301162+RoBYCoNTe@users.noreply.github.com"
+          git tag -a "${VERSION}" -m "version ${VERSION}"
+          git push origin "${VERSION}"

persona_sdk_python-0.2.25/MIGRATION_GITHUB.md

@@ -0,0 +1,44 @@
+# Migrazione Bitbucket → GitHub Actions
+
+Repo migrato da `applicaguru/persona-sdk-python` (Bitbucket) a
+`applica-software-guru/persona-sdk-python` (GitHub, privato) il
+**2026-09-25**.
+
+## Fasi
+
+1. **Validazione locale** — smoke (`uv sync` + import `persona_sdk`)
+   + `uv build` (sdist+wheel): verdi. Il repo non ha suite di test
+   (non ne aveva in Bitbucket) → smoke pattern.
+2. **Repo GitHub** — creato privato; `main` (`c504855`) + 21 tag
+   (serie `0.2.*` fino a `0.2.23`) + ramo WIP `feature/sip-protocol`
+   (3 commit, SIP trunks/call-control — gemello del ramo js) pushato
+   tal quale. I rami mergiati `feature/skills` e
+   `refactor/litellm-model-config` non sono stati ripushati.
+   Invariante verificata: Bitbucket ⊆ GitHub.
+3. **Pipeline** — `deploy.yml` (PyPI OIDC) + `ci.yml`, cutover.
+4. **Verifica** — run verde, `0.2.24` su PyPI, tag git.
+
+## Versioning
+
+Caso **allineato**: PyPI latest = `0.2.23` = tag git max. Il BB
+calcolava la versione dal build counter (`0.2.$BITBUCKET_BUILD_NUMBER`);
+in GitHub la riconciliazione è sui tag git (patch+1) con guard su
+PyPI via API (immutabile). Prima release GitHub: **`0.2.24`**.
+
+## Pipeline decisionale (PyPI, pattern persona-models)
+
+- **push su main** → version (tag+guard PyPI) → smoke ∥
+  build-package → **publish OIDC trusted publishing** (nessun token;
+  configurato su PyPI → progetto `persona-sdk-python` → Trusted
+  Publisher: owner `applica-software-guru`, repo, workflow
+  `deploy.yml`, environment vuoto) → tag di versione.
+- **workflow_dispatch**: `test-and-publish` | `publish-only`
+  (summary segnala i test saltati con ⚠️).
+- **PR** → `ci.yml`: smoke. Nuovo rispetto al BB.
+
+## Decisioni
+
+- **Test**: smoke solo (`uv sync --frozen` + import) — nessuna suite
+  esistente; nota onesta, nessun test inventato.
+- **Segreti**: nessuno — OIDC trusted publishing (come persona-models).
+- **Rimosso dal tree nel cutover**: `bitbucket-pipelines.yml`.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: persona-sdk-python
-Version: 0.2.23
+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
@@ -22,6 +22,12 @@ Requires-Dist: httpx>=0.27.0
 Requires-Dist: persona-models>=0.2.16
 Description-Content-Type: text/markdown
 
+<div align="center">
+
+[![Publish](https://github.com/applica-software-guru/persona-sdk-python/actions/workflows/deploy.yml/badge.svg)](https://github.com/applica-software-guru/persona-sdk-python/actions/workflows/deploy.yml)
+
+</div>
+
 # persona-sdk-python
 
 Async Python SDK for the [Persona AI](https://persona.applica.guru) platform.

{persona_sdk_python-0.2.23 → persona_sdk_python-0.2.25}/README.md

@@ -1,3 +1,9 @@
+<div align="center">
+
+[![Publish](https://github.com/applica-software-guru/persona-sdk-python/actions/workflows/deploy.yml/badge.svg)](https://github.com/applica-software-guru/persona-sdk-python/actions/workflows/deploy.yml)
+
+</div>
+
 # persona-sdk-python
 
 Async Python SDK for the [Persona AI](https://persona.applica.guru) platform.

{persona_sdk_python-0.2.23 → 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.23 → persona_sdk_python-0.2.25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "persona-sdk-python"
-version = "0.2.23"
+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.23 → persona_sdk_python-0.2.25}/uv.lock

@@ -1,5 +1,5 @@
 version = 1
-revision = 3
+revision = 5
 requires-python = ">=3.10"
 
 [[package]]
@@ -39,7 +39,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -106,7 +106,7 @@ wheels = [
 
 [[package]]
 name = "persona-sdk-python"
-version = "0.1.0"
+version = "0.2.25"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

persona_sdk_python-0.2.23/bitbucket-pipelines.yml

@@ -1,18 +0,0 @@
-image: python:3.12
-
-pipelines:
-  branches:
-    main:
-      - step:
-          name: Publish to PyPI
-          caches:
-            - pip
-          script:
-            - apt-get update && apt-get install -y git
-            - pip install build twine
-            - export VERSION=0.2.$BITBUCKET_BUILD_NUMBER
-            - sed -i "s/^version = .*/version = \"$VERSION\"/" pyproject.toml
-            - python -m build
-            - twine upload dist/* -u __token__ -p $PYPI_TOKEN
-            - git tag -a $VERSION -m "$VERSION"
-            - git push origin $VERSION