Metadata-Version: 2.4
Name: umai-agent-sdk
Version: 0.1.0
Summary: Python SDK for UMAI Agent Mesh Governance and guardrails.
Project-URL: Homepage, https://umai.ai
Project-URL: Documentation, https://docs.umai.ai
Project-URL: Repository, https://github.com/UMAI-Solutions/umai-agent-sdk-python
Project-URL: Issues, https://github.com/UMAI-Solutions/umai-agent-sdk-python/issues
Author: UMAI
License: Copyright (c) 2026 UMAI Solutions.
        
        All rights reserved.
        
        This software and associated documentation files are proprietary to UMAI
        Solutions. Unauthorized copying, modification, distribution, sublicensing, or
        sale of this software is prohibited except under a separate written agreement
        with UMAI Solutions.
License-File: LICENSE
Keywords: agent,governance,guardrails,openai-agents,umai
Requires-Python: >=3.10
Requires-Dist: cryptography>=42.0.5
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.6.0
Provides-Extra: dev
Requires-Dist: build>=1.2.1; extra == 'dev'
Requires-Dist: mypy>=1.8.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: openai
Requires-Dist: openai-agents; extra == 'openai'
Description-Content-Type: text/markdown

# UMAI Agent SDK for Python

Production Python SDK for UMAI Agent Mesh Governance, guardrails, signed agent
identity, and agent work-tree observability.

```bash
pip install umai-agent-sdk
pip install umai-agent-sdk[openai]
```

```python
from umai import UmaiClient
from umai.stores import FileIdentityStore

umai = UmaiClient(endpoint="https://api.umai.ai", api_key="...")
agent = umai.agent(
    "support-agent",
    identity_store=FileIdentityStore(allow_plaintext_private_key=True),
)

await agent.register(bootstrap_token="...")
run = await agent.start_run(guardrail_id="gr-prod")
decision = await agent.guard_tool_input(
    guardrail_id="gr-prod",
    run_id=run.run_id,
    tool_name="crm.lookup",
    payload_summary="Lookup customer profile",
    messages=[{"role": "assistant", "content": "Call crm.lookup"}],
)
await agent.complete_run(run.run_id)
```

The SDK is a convenience layer over UMAI HTTP APIs. Every SDK feature maps to
public UMAI endpoints and can be implemented without the SDK.

