ee8ccc029fb9cbc0f9b0fd0e408fba05301ff989
Agent-Native
可复用的 Agent 执行基础:自研执行内核(runtime)、模型/工具能力接入、外部 Agent 适配器(现有 PI Runner 等)与共用契约验收(conformance)。
仓库分层(U7a 首切片:仅 contract + conformance)
| 层 | 职责 | 依赖边界 |
|---|---|---|
| contract | 执行契约:Request/Result/Outcome/Error/Capability/Backend/Resolver | 不依赖内核、产品类型、数据库、配置 |
| runtime | agentx 演进的多轮循环、工具调度、模型调用、执行会话(U7b 迁入) | 实现 contract;不导入 Core/Squad |
| adapters | PI Runner transport / typed-result-v1(U7b 迁入) | 显式映射外部差异,不伪造缺失能力 |
| conformance | 所有 Backend 共用的行为验收 | fake 验证契约,真实 adapter 验证能力 |
规范后端名:agent-native(pi-native 为兼容别名,由 Core 侧注册表解析)。
关键语义(详见 contract 包 doc.go)
- ExecutionID 一次逻辑执行唯一;重试与受控 fallback 复用。
- Outcome 四态:Succeeded/Failed/Canceled/Unknown;Unknown 不静默降级。
- 失败副作用显式分类(none/possible);possible 禁止无条件重放。
- 重试单一责任层:步骤级归调用方,传输级有界归 adapter,turn 上限归 runtime。
- Workspace 路径授权 ≠ OS 沙箱。
消费方式(首期)
外层组合(Agent-System 主仓 gitlink)固定精确 SHA,Go 相邻 replace 引用:
replace agent-native => ../agent-native
构建须 GOWORK=off;不通过 go get 路由依赖(实例 URL 带端口,见主仓方案 KTD3)。
CI
.gitea/workflows/ci.yml:go vet + go test(host runner)。
Languages
Go
99.2%
Shell
0.6%
Python
0.2%