Skip to content

feat(aep): extend event protocol for runtime observability #849

Description

@hrygo

设计状态

权威文档

  • docs/v2/ROADMAP.md
  • docs/v2/IMPLEMENTATION-ROADMAP.md
  • docs/v2/ARCHITECTURE.md
  • docs/superpowers/specs/2026-08-04-runtime-operations-contract.md

范围

  • 增量扩展 AEP v1 的 runtime、security、context、policy 事件 Kind 与 typed Data。
  • 统一 trace_idspan_idagent_idexecution_idworkspace_idworker_type correlation metadata。
  • 覆盖 AgentSpec resolution、identity binding、execution queue/retry/timeout、policy decision、context load/save、effect/reconcile/operator action。
  • eventstore、audit、trace 和 SDK 使用同一事件语义;旧客户端可忽略新增 Kind。

完成标准

  • AEP encode/decode/clone 与 metadata deep-copy 测试覆盖新增契约。
  • Go SDK、TypeScript/Python/Java 示例 SDK、协议文档和双向兼容测试同步。
  • eventstore 按既有 replay/turn 语义持久化适用事件。
  • execution_id 能关联 input、worker run、runtime event 与 terminal outcome。
  • 新事件默认脱敏,不持久化 prompt、secret、metadata value、完整 tool args 或 raw worker error。
  • chore(aep): add a canonical schema and cross-SDK conformance suite #869 canonical schema/conformance suite 对新增事件执行机械一致性校验。

依赖

#847 AgentSpec;#848 AgentIdentity;#878 durable ingress baseline;#869 AEP conformance。

非目标

不创建独立 event bus,不引入 AEP v2,不移除或重命名现有 AEP v1 Kind。

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions