session/eventDurable truth
可排序、可回放、模型可见的事实;持久化 transcript 和投影都从这里生长。
这不是按目录复述文件,而是把启动时组合、运行时主干、能力替换、控制接缝、事实存储与客户端表面放到同一张因果地图里。
决定哪些插件存在、如何分层以及卸载时如何回收。
bootbundlepresetextensions把实时状态和持久事实混在一起,是读 Harness 最常见也最危险的误区。
session/event可排序、可回放、模型可见的事实;持久化 transcript 和投影都从这里生长。
agent/*状态、流式增量、steer/cancel 等运行控制;观察当前执行但不冒充历史真源。
capability events工具、审批、提示词、压缩等子系统公开的可组合接缝,插件在这里改写或拒绝。
Turn 是需要结清的工作单元;Step 是一次 LLM 请求。工具调用会留下“债务”,只有结果写回并继续推理,Turn 才能结束。
深读 Turn / Step同一时刻只有一个 Turn 拥有消费权。
Profile、Bundle、Patch 和插件作用域共同决定产品形态。
消费者依赖 Service Definition,不直接 import Provider。
客户端从 SessionEvent 投影,而不维护第二套权威状态。
工具的拒绝、取消和失败都必须沿同一管线结算。