Metadata-Version: 2.4
Name: handoffrail-sdk
Version: 0.1.0
Summary: Python SDK for HandoffRail — session-continuity middleware for multi-agent AI workflows
Author: Mela AI
License: MIT
Keywords: ai,handoff,handoffrail,multi-agent,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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.11
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: crewai
Requires-Dist: crewai>=0.1.0; extra == 'crewai'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1.0; extra == 'langchain'
Requires-Dist: langchain>=0.1.0; extra == 'langchain'
Provides-Extra: ws
Requires-Dist: websockets>=12.0; extra == 'ws'
Description-Content-Type: text/markdown

# HandoffRail SDK

Python SDK for [HandoffRail](https://github.com/MelaBuilt-AI/HandoffRail) — session-continuity middleware for multi-agent AI workflows.

## Install

```bash
pip install handoffrail-sdk
```

## Quick Start

```python
from handoffrail import Client

client = Client(base_url="http://localhost:8000", api_key="your-key")

# Create a handoff packet
packet = client.create_packet(
    source_agent="research-agent",
    target_agent="writing-agent",
    summary="Research complete on topic X",
)

# Claim and resolve
client.claim_packet(packet.id, agent_id="writing-agent")
client.resolve_packet(packet.id, outcome="Article drafted successfully")
```

## Features

- Sync and async clients
- Pydantic v2 models
- LangChain / CrewAI integrations (optional extras)
- WebSocket support for real-time updates

## License

MIT