# Cyber Agent

通用、可扩展的 Agent 执行框架。`0.4.0` 在保留 `legacy_auto` 行为的同时，新增可选的 Planner → Worker Attempt → 独立 Validator → Planner Decision 闭环。

## 失败和上下文治理

- Tool 用 `FailureDetail` 返回结构化失败，并通过 `retry_call`、`repair_attempt`、`replan_task` 或 `abort_run` 声明处置语义。业务错误的分类由 Host 边界完成，通用框架不解析业务 payload。
- 显式 Planner 连续 3 轮没有持久化语义进展，或任一角色连续 2 次返回同一失败指纹时，Runner 以 `NO_PROGRESS` 收敛；计数保存在 `Trace.runtime_state`。
- `RunConfig.compression` 定义硬 token 预算、75% 触发线和 50% 压缩目标。预算包含工具 schema，并用上一次供应商返回的 `prompt_tokens` 保守校准；任何超硬上限的请求都会在发给模型前失败。

- 框架说明：[`agent/README.md`](agent/README.md)
- V1 显式任务闭环：[`agent/docs/orchestration-v1.md`](agent/docs/orchestration-v1.md)
- Preset 与角色权限：[`agent/docs/presets.md`](agent/docs/presets.md)
- 通用示例：[`examples/orchestration_v1/`](examples/orchestration_v1/)

开发验证：

```bash
uv sync --extra dev --extra server --extra feishu --python 3.11
uv run pytest -q
```