script-build-and-framework-tmp/agent/README.md

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

• V1 显式任务闭环：agent/docs/orchestration-v1.md

• Preset 与角色权限：agent/docs/presets.md

• 通用示例：examples/orchestration_v1/

开发验证：

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