BearAgent 内部怎样交换数据
真实模型返回一个 SDK 对象，SQLite 最终保存 JSON，命令行又要显示错误。如果三处直接交换任意
字典，很快就会出现三种 run_id、三套消息字段和互不兼容的错误格式。
F-0001 的解决办法很朴素：进入 Runtime 之前，把外部数据翻译成 BearAgent 自己定义的数据类型； 离开 Runtime 时，再由对应 adapter 翻译出去。
flowchart LR
SDK["模型 SDK 响应"] --> MA["模型 adapter"]
MA --> M["BearAgent Message"]
M --> R["Runtime"]
R --> E["BearAgent Event"]
E --> SA["存储 adapter"]
SA --> DB["SQLite JSON"]
四类数据各解决一个具体问题
Section titled “四类数据各解决一个具体问题”ID 防止把对象认错
Section titled “ID 防止把对象认错”RunId 和 ActivityId 最终都能写成 UUID 字符串，但它们不是同一个概念。使用不同类型后，
代码和静态检查可以发现把 Run ID 传到 Activity 参数中的错误。排序依靠 Event sequence 或时间，
不依赖 UUID 文本。
Message 表示模型真正需要看到的内容
Section titled “Message 表示模型真正需要看到的内容”Message 区分 system、user、assistant 和 tool 四种角色。内容目前只有文本、工具请求和工具结果。 某个 Provider 使用什么响应类、字段名或流式事件，由它自己的 adapter 处理。
Error 只保存可以安全传播的信息
Section titled “Error 只保存可以安全传播的信息”错误包含稳定分类、代码、是否可重试和经过筛选的详情。原始异常、堆栈、认证头和密钥不会直接 进入可序列化错误。这样 CLI、Event 和日志可以共享错误含义，同时减少意外泄露。
Event 说明一条事实属于哪里
Section titled “Event 说明一条事实属于哪里”每条 Event 都有自身 ID、Run ID、sequence、类型、版本、带时区时间和 JSON payload。F-0001 只 建立这个通用外壳；“模型调用完成”或“Run 失败”等具体 payload 由后续 Feature 增加。
这项决定的准确边界
Section titled “这项决定的准确边界”ADR-0007 规定：BearAgent 模块之间只交换 BearAgent 自己的数据类型，模型 SDK 对象必须在 adapter 边界完成翻译。 它没有要求所有外部系统使用相同格式，也没有把这些内部类型承诺为 第三方 Python SDK。