Aether

2,689 Commits 6 Branches 182 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
ZheFox	c8118edf36	fix(ws): harden Responses connection lifecycle Revalidate control policy per turn, isolate downstream credentials, and make planner/turn ownership cancellation-safe. Preserve opaque protocol events, align configurable timeout semantics, and extend end-to-end security and settlement coverage.	2026-08-17 18:50:29 +08:00
AAEE86	4a0775c4ea	style: apply cargo fmt across gateway and aether-ai crates	2026-08-17 14:53:53 +08:00
AAEE86	1d3051cb89	refactor(ws): structured terminal observation without SSE text round-trips 评审第 5 条：Responses WebSocket 收到的本来就是结构化协议事件，但为了复用面向 SSE 的 push_line，观测路径要先把每个事件序列化成 data: {json}\n\n，解析器再 decode 回 Value——一次纯粹的往返。这个「伪 SSE」形状是随手拼的，一旦拼装函数以后被加上换行或分块逻辑，观测结果就会和真实事件悄悄分叉。 aether-ai-formats： - OpenAIResponsesProviderState::push_line 机械拆成 decode + push_event， push_line 现在只做解码。协议状态机一行未动，diff 里除函数签名外只有 &value → value（value 从拥有改成借用，持有结构化事件的传输不必为了调用它先克隆一份）。 - StreamingStandardTerminalObserver::push_event 走 TerminalStreamParser::Standard， service tier 的记录方式与 push_line 完全相同。openai:image 的终态状态机按 SSE 行做增量解析、没有结构化入口，返回 AiSurfaceFinalizeError 让调用方 disable_with_error 标记 parser_error，而不是静默丢事件、把摘要留成「未观察到终态」。ProviderStreamParser 的其余三个格式同样返回 Err：机械拆分随时可做，但不建无调用方的接口。 WS 侧： - 新增 responses/observation.rs 的 ResponsesStructuredTerminalObserver，直接消费 frame.protocol_events() 借出的事件。包一层的意义是让「不再拼 SSE」成为类型层面的事实——这个类型没有任何接受字节的方法，改回 push_line 不可能悄悄发生。 finish() 里的 Ok(None) / Err → disable_with_error 兜底也一并收进来。 - body capture 不动，仍然是 SSE 形状（data: 开头、\n\n 结尾）： aether_usage_runtime::report 用 line.strip_prefix("data:") 解析被捕获的 body 判定 StreamCapturedTerminalState，而它是 stream_report_represents_failure 的一个 OR 项，换成结构化 JSON 会让终态判定恒为 Missing。capture_sse_event / capture_client_frame / websocket_event_as_sse_line 全部保留，原因写在模块文档注释里。这一层只换观测，不换捕获。差分测试（8 个，aether-ai-formats）：同一组事件序列分别走 push_line 与 push_event，断言 ExecutionStreamTerminalSummary 完全相等——批量 delta 序列、 completed 带 usage、合法 incomplete、error、response.failed、未知事件、 service tier、缺终态；外加 openai:image 拒绝结构化入口。两条入口不可能有过滤差异：任何 Value 序列化出来都不会命中 decode_json_data_line 的 empty / ":" / "event:" / [DONE] 四个过滤条件。 turn.rs 里三个既有的 WS 观测测试改走结构化入口；SSE 形状的断言留在 capture 一侧。验收：crates/aether-usage 零 diff。	2026-08-17 14:53:33 +08:00

Author

SHA1

Message

Date

ZheFox

c8118edf36

fix(ws): harden Responses connection lifecycle

Revalidate control policy per turn, isolate downstream credentials, and make planner/turn ownership cancellation-safe.

Preserve opaque protocol events, align configurable timeout semantics, and extend end-to-end security and settlement coverage.

2026-08-17 18:50:29 +08:00

AAEE86

4a0775c4ea

style: apply cargo fmt across gateway and aether-ai crates

2026-08-17 14:53:53 +08:00

AAEE86

1d3051cb89

refactor(ws): structured terminal observation without SSE text round-trips

评审第 5 条：Responses WebSocket 收到的本来就是结构化协议事件，但为了复用面向
SSE 的 push_line，观测路径要先把每个事件序列化成 data: {json}\n\n，解析器再
decode 回 Value——一次纯粹的往返。这个「伪 SSE」形状是随手拼的，一旦拼装函数
以后被加上换行或分块逻辑，观测结果就会和真实事件悄悄分叉。

aether-ai-formats：
- OpenAIResponsesProviderState::push_line 机械拆成 decode + push_event，
  push_line 现在只做解码。协议状态机一行未动，diff 里除函数签名外只有
  &value → value（value 从拥有改成借用，持有结构化事件的传输不必为了调用它
  先克隆一份）。
- StreamingStandardTerminalObserver::push_event 走 TerminalStreamParser::Standard，
  service tier 的记录方式与 push_line 完全相同。openai:image 的终态状态机按 SSE
  行做增量解析、没有结构化入口，返回 AiSurfaceFinalizeError 让调用方
  disable_with_error 标记 parser_error，而不是静默丢事件、把摘要留成「未观察到
  终态」。ProviderStreamParser 的其余三个格式同样返回 Err：机械拆分随时可做，
  但不建无调用方的接口。

WS 侧：
- 新增 responses/observation.rs 的 ResponsesStructuredTerminalObserver，直接消费
  frame.protocol_events() 借出的事件。包一层的意义是让「不再拼 SSE」成为类型层面
  的事实——这个类型没有任何接受字节的方法，改回 push_line 不可能悄悄发生。
  finish() 里的 Ok(None) / Err → disable_with_error 兜底也一并收进来。
- body capture 不动，仍然是 SSE 形状（data: 开头、\n\n 结尾）：
  aether_usage_runtime::report 用 line.strip_prefix("data:") 解析被捕获的 body
  判定 StreamCapturedTerminalState，而它是 stream_report_represents_failure 的一个
  OR 项，换成结构化 JSON 会让终态判定恒为 Missing。capture_sse_event /
  capture_client_frame / websocket_event_as_sse_line 全部保留，原因写在模块文档
  注释里。这一层只换观测，不换捕获。

差分测试（8 个，aether-ai-formats）：同一组事件序列分别走 push_line 与
push_event，断言 ExecutionStreamTerminalSummary 完全相等——批量 delta 序列、
completed 带 usage、合法 incomplete、error、response.failed、未知事件、
service tier、缺终态；外加 openai:image 拒绝结构化入口。两条入口不可能有
过滤差异：任何 Value 序列化出来都不会命中 decode_json_data_line 的 empty /
":" / "event:" / [DONE] 四个过滤条件。

turn.rs 里三个既有的 WS 观测测试改走结构化入口；SSE 形状的断言留在 capture 一侧。
验收：crates/aether-usage 零 diff。

2026-08-17 14:53:33 +08:00