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)。

S
Description
可复用的 Agent 执行基础:自研运行内核、模型与工具接入、外部 Agent 适配,为助手与智能体小队提供统一执行能力。
Readme
909 KiB
Languages
Go 99.2%
Shell 0.6%
Python 0.2%