按架构设计第 6 节实现 Provider 契约(describe/invoke/health)与能力声明(effect/mode/idempotency/errors);错误统一六分类(invalid_argument、forbidden、conflict、rate_limited、unavailable、unknown_result)。Core.invoke 作为唯一执行出口:能力解析、幂等重试返回原回执、超时归一为 unknown_result、执行记录带参数摘要。新增能力目录(registry)与内存执行记录,能力清单改由目录提供;GET /v1/executions/{id} 由 501 改为返回真实回执。假 Provider(testing)与契约测试套件(contract-suite)落地,含坏 Provider 负例。APS Provider 占位改为新契约。测试 31 → 41 条全绿。
|
||
|---|---|---|
| .. | ||
| agent | ||
| app | ||
| bin | ||
| core | ||
| entry | ||
| provider-sdk | ||
| workflows | ||
| README.md | ||
| index.ts | ||
| package.json | ||
| tsconfig.json | ||
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 引擎包;其它模块必须经这一层