## 目标、依据与优先级 argi-agent-api 已有消息、进度、用量及 Finished 事件;Studio 仍依赖 Graph 输出。本单补必要的类型化生命周期与视图投影,不把实时通知等同持久事实。 建议阶段:优先设计事件边界;持久视图随运行服务交付。AgentScope Java 参考基线 `7976a20d7c59f535737f2df1b16a2bc24051575a`,ARGI Core `76d44429fdaa6a69320e21a1cb77119d0889d792` / Extensions `495414b76a37aca4d7c1022d973a8e5b9a7e92e6`。本单是能力落地建议,来源于源码与文档对照,并非已复现的 BUG 或已完成实现。 参考:https://github.com/agentscope-ai/agentscope-java/blob/7976a20d7c59f535737f2df1b16a2bc24051575a/docs/v2/en/docs/harness/session-log.md ## 范围与验收 - [ ] 在已有 AgentEvent 上论证工具开始/结果/失败、交互请求/决议、委派及运行状态所需事件;不机械复制 32 个类型或全量 Graph NodeOutput。 - [ ] 明确 run/task/attempt/message/tool/delegation ID、顺序、版本和 usage 语义,保持已有终态与异常契约;sealed API 扩展需评估消费者兼容。 - [ ] 分别定义实时通知、持久执行事实和 UI 投影,实时事件不得充当提交确认,seq/cursor 不混用,不再建立第二份权威运行日志。 - [ ] 快照与其游标来自一致提交前缀;重连从已应用游标继续,按稳定 ID 更新,避免消息重复或缺失。 - [ ] 页面重载/观察事件不能重新执行 Agent;部分消息、工具进度和 pending interaction 可恢复显示。 - [ ] 不支持持久事件的执行器明确声明能力,不能伪造可恢复游标;订阅背压与终态错误不被吞并。 - [ ] 覆盖重复/乱序投递、快照与新增提交竞态、游标失效、断线、取消及敏感数据可见范围。 ## 归属、依赖与约束 关联:#200、#203、#204;agentic-ai-java/argi-extensions#17。本单作为具体交付任务,相关总单继续负责总体契约,不重复实现其存储、预算、授权或版本注册体系。 独立 ReAct / Workflow 消费中立契约,不以 Graph/Loop 为执行后端。Loop 为可选图编排能力。Core 不依赖 Extensions 或 AgentScope SDK;复用现有组件,不因职责分层机械新增 Maven 模块。定义、数据或公共 API 的破坏性变更需比较兼容方案,并说明收益、消费者影响、目标版本、迁移与回滚;保留合理现有实现。不以直接复制 AgentScope 类或引入整套平台作为验收。
Activity