本文档由 g2rain-agent-runtime 的 docs/development/api-conventions.md 自动同步生成。

# API 约定

• 对外 API 模型定义在 api 模块；请求、响应、错误码与枚举保持向后兼容。
• 任务、会话、消息、检查点和工具调用的语义以 CONTRACT_SPEC.md 为准。
• 流式响应的事件名、顺序和终止条件以 SSE_EVENTS.md 为准；不得将内部异常堆栈推送给调用方。
• 变更请求或事件字段前，应评估客户端兼容性，并提供版本化、可选字段或迁移窗口。