persona-sdk-python 0.2.3__tar.gz → 0.2.4__tar.gz

persona_sdk_python-0.2.4/PKG-INFO

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: persona-sdk-python
+Version: 0.2.4
+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
+Author: Applica Software Guru
+License: Proprietary
+Keywords: agents,ai,async,persona,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: persona-models>=0.1.0
+Description-Content-Type: text/markdown
+
+# persona-sdk-python
+
+Async Python SDK for the [Persona AI](https://persona.applica.guru) platform.
+
+## Installation
+
+```bash
+pip install persona-sdk-python
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv add persona-sdk-python
+```
+
+Requirements: Python 3.10+
+
+## Quick start
+
+```python
+import asyncio
+from persona_sdk import PersonaSdk
+
+
+async def main():
+    sdk = PersonaSdk(
+        base_url="https://persona.applica.guru/api",
+        auth="prs_your_project_api_key",
+    )
+
+    # List agents in your project
+    agents = await sdk.agents.list()
+    print(agents)
+
+    await sdk.close()
+
+
+asyncio.run(main())
+```
+
+## Authentication
+
+The SDK supports two authentication methods via the `auth` parameter.
+
+### API key (default)
+
+A plain string is wrapped automatically in `ApiKeyAuthenticationProvider` and
+sent as the `x-persona-apikey` header. Accepts:
+
+- Master key (full admin access)
+- Project API key (`prs_...`)
+- Agent API key (`prs_ag_...`)
+
+```python
+from persona_sdk import PersonaSdk
+
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_your_project_api_key",
+)
+```
+
+### IAM Bearer token
+
+For applications that authenticate users via IAM, pass a
+`BearerTokenAuthenticationProvider` with a valid JWT:
+
+```python
+from persona_sdk import PersonaSdk, BearerTokenAuthenticationProvider
+
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth=BearerTokenAuthenticationProvider(iam_jwt_token),
+)
+```
+
+The token is sent as the `Authorization: Bearer <token>` header. The server
+validates it via the IAM service and resolves the user's project automatically.
+
+### Custom provider
+
+Implement your own provider by subclassing `AuthenticationProvider`:
+
+```python
+from persona_sdk import AuthenticationProvider
+
+class MyProvider(AuthenticationProvider):
+    def headers(self) -> dict[str, str]:
+        return {"x-custom-header": "value"}
+
+    def credentials(self) -> str:
+        return "my-credentials"
+```
+
+## Available APIs
+
+The `PersonaSdk` instance exposes one client per resource:
+
+| Attribute | Description |
+|-----------|-------------|
+| `sdk.agents` | Agent management (CRUD, voices) |
+| `sdk.projects` | Project management and subscriptions |
+| `sdk.sessions` | Sessions, messages, usage |
+| `sdk.knowledge_bases` | Knowledge bases, documents, chunk search |
+| `sdk.workflows` | Workflows, executions, queues |
+| `sdk.triggers` | Triggers and trigger executions |
+| `sdk.missions` | Missions (generate, execute, stop, continue) |
+| `sdk.features` | Feature templates and MCP tools |
+| `sdk.credentials` | OAuth credentials and authorization |
+| `sdk.service_prices` | Service pricing |
+
+Each API method is fully async. Always close the SDK when done:
+
+```python
+sdk = PersonaSdk(...)
+try:
+    agents = await sdk.agents.list()
+finally:
+    await sdk.close()
+```
+
+Or use it as an async context manager pattern:
+
+```python
+sdk = PersonaSdk(...)
+async with sdk.client._client:  # internal httpx client
+    ...
+```
+
+## CRUD example
+
+```python
+# Create an agent
+agent = await sdk.agents.create({
+    "name": "my-agent",
+    "model": {"modelName": "gpt-4o"},
+})
+
+# Read
+fetched = await sdk.agents.get(agent["id"])
+
+# Update
+fetched["name"] = "renamed-agent"
+await sdk.agents.update(agent["id"], fetched)
+
+# Delete
+await sdk.agents.delete(agent["id"])
+```
+
+## Pagination
+
+List endpoints accept `keyword`, `page`, and `size`:
+
+```python
+result = await sdk.agents.list(keyword="bot", page=1, size=20)
+# {
+#   "items": [...],
+#   "total": 42,
+#   "page": 1,
+#   "size": 20
+# }
+```
+
+## Workflows
+
+If your workflows service runs on a different host, pass `workflows_url`:
+
+```python
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_...",
+    workflows_url="https://persona.applica.guru/workflows",
+)
+
+# Execute a workflow
+result = await sdk.workflows.execute(
+    workflow_id="wf-123",
+    data={"input": "value"},
+)
+```
+
+## Runners
+
+For higher-level abstractions, the SDK provides runners:
+
+```python
+from persona_sdk import PersonaClient
+from persona_sdk.runners import AgentRunner, invoke_tool, retrieve_resource
+
+client = PersonaClient(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_...",
+)
+
+# Run an agent in an existing session
+runner = AgentRunner(client=client, agent_id="agent-1", session_code="sess-1")
+response = await runner.run("Hello, agent!")
+
+# Invoke an MCP tool directly
+result = await invoke_tool(
+    client=client,
+    mcp_server_name="my-mcp",
+    transport=...,
+    tool_name="search",
+    args={"query": "hello"},
+)
+```
+
+## Proxy support
+
+```python
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_...",
+    proxy="http://proxy.local:8080",
+)
+```
+
+## License
+
+Proprietary — © Applica Software Guru

persona_sdk_python-0.2.4/README.md

@@ -0,0 +1,222 @@
+# persona-sdk-python
+
+Async Python SDK for the [Persona AI](https://persona.applica.guru) platform.
+
+## Installation
+
+```bash
+pip install persona-sdk-python
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv add persona-sdk-python
+```
+
+Requirements: Python 3.10+
+
+## Quick start
+
+```python
+import asyncio
+from persona_sdk import PersonaSdk
+
+
+async def main():
+    sdk = PersonaSdk(
+        base_url="https://persona.applica.guru/api",
+        auth="prs_your_project_api_key",
+    )
+
+    # List agents in your project
+    agents = await sdk.agents.list()
+    print(agents)
+
+    await sdk.close()
+
+
+asyncio.run(main())
+```
+
+## Authentication
+
+The SDK supports two authentication methods via the `auth` parameter.
+
+### API key (default)
+
+A plain string is wrapped automatically in `ApiKeyAuthenticationProvider` and
+sent as the `x-persona-apikey` header. Accepts:
+
+- Master key (full admin access)
+- Project API key (`prs_...`)
+- Agent API key (`prs_ag_...`)
+
+```python
+from persona_sdk import PersonaSdk
+
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_your_project_api_key",
+)
+```
+
+### IAM Bearer token
+
+For applications that authenticate users via IAM, pass a
+`BearerTokenAuthenticationProvider` with a valid JWT:
+
+```python
+from persona_sdk import PersonaSdk, BearerTokenAuthenticationProvider
+
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth=BearerTokenAuthenticationProvider(iam_jwt_token),
+)
+```
+
+The token is sent as the `Authorization: Bearer <token>` header. The server
+validates it via the IAM service and resolves the user's project automatically.
+
+### Custom provider
+
+Implement your own provider by subclassing `AuthenticationProvider`:
+
+```python
+from persona_sdk import AuthenticationProvider
+
+class MyProvider(AuthenticationProvider):
+    def headers(self) -> dict[str, str]:
+        return {"x-custom-header": "value"}
+
+    def credentials(self) -> str:
+        return "my-credentials"
+```
+
+## Available APIs
+
+The `PersonaSdk` instance exposes one client per resource:
+
+| Attribute | Description |
+|-----------|-------------|
+| `sdk.agents` | Agent management (CRUD, voices) |
+| `sdk.projects` | Project management and subscriptions |
+| `sdk.sessions` | Sessions, messages, usage |
+| `sdk.knowledge_bases` | Knowledge bases, documents, chunk search |
+| `sdk.workflows` | Workflows, executions, queues |
+| `sdk.triggers` | Triggers and trigger executions |
+| `sdk.missions` | Missions (generate, execute, stop, continue) |
+| `sdk.features` | Feature templates and MCP tools |
+| `sdk.credentials` | OAuth credentials and authorization |
+| `sdk.service_prices` | Service pricing |
+
+Each API method is fully async. Always close the SDK when done:
+
+```python
+sdk = PersonaSdk(...)
+try:
+    agents = await sdk.agents.list()
+finally:
+    await sdk.close()
+```
+
+Or use it as an async context manager pattern:
+
+```python
+sdk = PersonaSdk(...)
+async with sdk.client._client:  # internal httpx client
+    ...
+```
+
+## CRUD example
+
+```python
+# Create an agent
+agent = await sdk.agents.create({
+    "name": "my-agent",
+    "model": {"modelName": "gpt-4o"},
+})
+
+# Read
+fetched = await sdk.agents.get(agent["id"])
+
+# Update
+fetched["name"] = "renamed-agent"
+await sdk.agents.update(agent["id"], fetched)
+
+# Delete
+await sdk.agents.delete(agent["id"])
+```
+
+## Pagination
+
+List endpoints accept `keyword`, `page`, and `size`:
+
+```python
+result = await sdk.agents.list(keyword="bot", page=1, size=20)
+# {
+#   "items": [...],
+#   "total": 42,
+#   "page": 1,
+#   "size": 20
+# }
+```
+
+## Workflows
+
+If your workflows service runs on a different host, pass `workflows_url`:
+
+```python
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_...",
+    workflows_url="https://persona.applica.guru/workflows",
+)
+
+# Execute a workflow
+result = await sdk.workflows.execute(
+    workflow_id="wf-123",
+    data={"input": "value"},
+)
+```
+
+## Runners
+
+For higher-level abstractions, the SDK provides runners:
+
+```python
+from persona_sdk import PersonaClient
+from persona_sdk.runners import AgentRunner, invoke_tool, retrieve_resource
+
+client = PersonaClient(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_...",
+)
+
+# Run an agent in an existing session
+runner = AgentRunner(client=client, agent_id="agent-1", session_code="sess-1")
+response = await runner.run("Hello, agent!")
+
+# Invoke an MCP tool directly
+result = await invoke_tool(
+    client=client,
+    mcp_server_name="my-mcp",
+    transport=...,
+    tool_name="search",
+    args={"query": "hello"},
+)
+```
+
+## Proxy support
+
+```python
+sdk = PersonaSdk(
+    base_url="https://persona.applica.guru/api",
+    auth="prs_...",
+    proxy="http://proxy.local:8080",
+)
+```
+
+## License
+
+Proprietary — © Applica Software Guru

persona_sdk_python-0.2.4/pyproject.toml

@@ -0,0 +1,38 @@
+[project]
+name = "persona-sdk-python"
+version = "0.2.4"
+description = "Async Python SDK for the Persona AI platform"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Proprietary" }
+authors = [
+    { name = "Applica Software Guru" },
+]
+keywords = ["persona", "ai", "agents", "sdk", "async"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Framework :: AsyncIO",
+]
+dependencies = [
+    "persona-models>=0.1.0",
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://persona.applica.guru"
+Repository = "https://bitbucket.org/applicaguru/persona-sdk-python"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["persona_sdk"]

{persona_sdk_python-0.2.3 → persona_sdk_python-0.2.4}/uv.lock

@@ -106,7 +106,7 @@ wheels = [
 
 [[package]]
 name = "persona-sdk-python"
-version = "0.1.2"
+version = "0.1.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

persona_sdk_python-0.2.3/PKG-INFO

@@ -1,7 +0,0 @@
-Metadata-Version: 2.4
-Name: persona-sdk-python
-Version: 0.2.3
-Summary: Python SDK client for Persona AI platform
-Requires-Python: >=3.10
-Requires-Dist: httpx>=0.27.0
-Requires-Dist: persona-models>=0.1.0

persona_sdk_python-0.2.3/pyproject.toml

@@ -1,16 +0,0 @@
-[project]
-name = "persona-sdk-python"
-version = "0.2.3"
-description = "Python SDK client for Persona AI platform"
-requires-python = ">=3.10"
-dependencies = [
-    "persona-models>=0.1.0",
-    "httpx>=0.27.0",
-]
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[tool.hatch.build.targets.wheel]
-packages = ["persona_sdk"]