Metadata-Version: 2.4
Name: overseer-client
Version: 0.1.0
Summary: Overseer 客户端：其他 AI agent 安装此包连接 overseer 服务器，上报工具、领取任务、参与多AI协同
Author: overseer
License: MIT
Project-URL: Homepage, https://github.com/overseer/overseer
Project-URL: Repository, https://github.com/overseer/overseer
Project-URL: Issues, https://github.com/overseer/overseer/issues
Keywords: mcp,ai,multi-agent,orchestration,overseer,client,worker
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: overseer-shared>=0.1.0
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.6
Provides-Extra: callback
Requires-Dist: fastapi>=0.110; extra == "callback"
Requires-Dist: uvicorn[standard]>=0.27; extra == "callback"

# overseer-client

Overseer 多 AI 协同平台的客户端库。

其他 AI agent 安装此包后可连接 overseer 服务器：
- 注册为 worker（首个连接者自动成为 overseer）
- 上报本地 MCP 工具与资源
- 主动领取任务并执行
- 接收 overseer 审查反馈
- 通过 SSE 订阅事件流

## 安装

```bash
pip install overseer-client

# 如需启用本地工具回调服务（供服务器反向调用本 agent 工具）：
pip install "overseer-client[callback]"
```

## 快速开始

```python
import asyncio
from overseer_client import OverseerClient, ClientConfig

async def main():
    cfg = ClientConfig(
        server_url="http://127.0.0.1:8787",
        agent_name="my-worker",
        # token="your-token",  # 服务器启用鉴权时填写
    )
    async with OverseerClient(cfg) as client:
        print(f"connected: {client.agent_id} as {client.role}")
        # client 会自动心跳、轮询领取任务、订阅事件
        await asyncio.sleep(60)

asyncio.run(main())
```

## 配置

支持配置文件（`~/.overseer/client.json`）和环境变量：

| 环境变量 | 说明 |
|---|---|
| `OVERSEER_SERVER_URL` | 服务器地址，默认 `http://127.0.0.1:8787` |
| `OVERSEER_AGENT_NAME` | agent 名称 |
| `OVERSEER_TOKEN` | 鉴权 token（服务器启用时必填） |
| `OVERSEER_CALLBACK_PORT` | 本地回调端口，0 表示不启用 |

## License

MIT
