aps-agent/server
zh 89b9535138 feat(agent): 引擎接口、假引擎与一致性测试套件(A3.1 / A3.2)
runtime.ts 按架构设计 5.2 定义 AgentRuntime / RuntimeSession / RuntimeEvent(text、tool_call、tool_result、approval_required、turn_end、error),补两处实现必需项:createSession 带 sessionId、resolveToolResult 让工具回执回流。fake-runtime 为确定性假引擎,支持脚本与计划器,事件顺序与真引擎一致,用于一致性测试与 A2.7 评测。conformance.ts 是一套跑任何运行时的验收用例:单轮事件顺序、多轮、工具调用与回执、取消、错误分类、带历史恢复。测试 44 → 46 全绿;坏运行时负例证明套件不是摆设。过程中修掉两个自身缺陷:假引擎在 yield 之后才登记回执回调导致回执丢失;一致性套件超时定时器 unref 导致事件循环空转退出。
2026-09-28 15:14:11 +08:00
..
agent feat(agent): 引擎接口、假引擎与一致性测试套件(A3.1 / A3.2) 2026-09-28 15:14:11 +08:00
app feat(core): 引擎工具回调端点与会话归属者(A2.5) 2026-09-24 15:50:07 +08:00
bin feat(server): 应用服务最小闭环与 HTTP/SSE 入口(A1.3) 2026-09-24 15:09:37 +08:00
core feat(core): Provider SDK、能力目录与 Core.invoke(A2.1-A2.4) 2026-09-24 15:48:45 +08:00
entry feat(core): 引擎工具回调端点与会话归属者(A2.5) 2026-09-24 15:50:07 +08:00
provider-sdk feat(core): Provider SDK、能力目录与 Core.invoke(A2.1-A2.4) 2026-09-24 15:48:45 +08:00
workflows feat(workspace): pnpm monorepo 骨架与包边界(A1.1) 2026-09-23 19:29:57 +08:00
README.md feat(workspace): pnpm monorepo 骨架与包边界(A1.1) 2026-09-23 19:29:57 +08:00
index.ts feat(core): 引擎工具回调端点与会话归属者(A2.5) 2026-09-24 15:50:07 +08:00
package.json feat(agent): 引擎接口、假引擎与一致性测试套件(A3.1 / A3.2) 2026-09-28 15:14:11 +08:00
tsconfig.json feat(server): 应用服务最小闭环与 HTTP/SSE 入口(A1.3) 2026-09-24 15:09:37 +08:00

README.md

@aps/server

平台服务。目录按架构设计第 2 节建立,各模块的边界与「不该出现什么」以该节为准。

目录 职责 不该出现什么
entry/ HTTP / SSE 入口、会话、鉴权 业务规则、直接调业务系统
app/ 请求编排、能力查询、审批流转、事件推送 引擎内部概念、直接 import Pi
agent/ 引擎适配:AgentRuntime 接口 + Pi / Codex 实现 业务规则、碰凭据
core/ 能力目录、身份映射、策略、凭据、执行、审计 业务数据、直接拼业务系统 URL
workflows/ 跨系统顺序流程 配置化 DAG 引擎

依赖方向(A1.2 会接入 CI 检查):

contracts  ←  provider-sdk  ←  server  ←  client
                    ↑
              providers/*
  • providers/* 只依赖 @aps/provider-sdk(与 @aps/contracts),不依赖 @aps/server
  • 只有 agent/ 允许 import 引擎包;其它模块必须经这一层