Add AgentSpec, three guardrail ports, subagent events, and ask passthrough (N1 WP1/WP4) #18

2026-10-07T05:05:27Z

weichen commented

2026-10-07 05:05:27 +00:00

N1 增量三（库侧）：AgentSpec、三类 guardrail、委派事件与 ask 透传（WP1/WP4）

按 Documents 提案 2026-10-07-agent-stack-n1q1i1-plans.md §2.2 落地 WP1/WP4 的库侧部分。全部新增能力为 opt-in：端口为 nil / 未注册时行为与现状逐字节一致。

改动

新包 runtime/agentspec（WP1）：AgentSpec 类型（Name/Description/Prompt/Tools/DisallowedTools/Model/PermissionMode/Skills/MaxTurns/MemoryScope/Effort/Background/WorktreeIsolation/OutputSchema）；agent-*.md 解析 Parse（宿主/内置全字段）与 ParsePlugin（插件来源禁带 hooks/mcp/permissionMode 键，错误定位到字段）；LoadDir 整批原子（坏文件/重名全批拒绝）。
新包 runtime/guardrails（WP4）：Input/Output/Tool 三端口，Verdict 复用 hooks.Decision，经 Register(bus, set, scope{Entry,Final}) 以总线注册。语义：Input deny→不进入循环直接收尾（原文留痕）、modify→改写内容追加为新用户消息；Output（仅 Final）挂 Stop，deny→视同续跑附理由（计入内核 3 次上限）、modify→替换最终文本；Tool 挂 PreToolUse 按既有优先级合并，modify 改写参数。子代理 run（Scope 全 false）不受 Input/Output 影响。
runtime/loop.go：消费 UserPromptSubmit 判定（上述 deny/modify 两分支）。
runtime/subagent：RegisterWithHooks——委派执行前后发 SubagentStart（带目标摘要）/SubagentStop（带成败标记）；Register 旧签名不变（静默）。
adapters/native：GateOptions.PermissionAsk 字段，透传进内核 Config（小队链路的 ask 裁决管道；squad 侧映射在 squad PR）。

验证

go vet ./... 通过；go test -count=1 ./... 26 包全 ok。
新增测试：agentspec 12（全字段/缺省/九类拒绝/插件禁键定位/LoadDir 原子与重名）、guardrails 5（Tool deny/modify、Output deny→Block、Scope 门控、nil 总线）、loop_guardrails 5（输入 deny 不调模型、modify 追加留痕、输出 deny 续跑至上限、工具 deny 配对、子 run 免伤）、subagent 3（Start/Stop 序列、失败标记、静默兼容）。

范围裁定

prompts.SubagentSpec 不迁移（与 agent-*.md 是两套格式；新字段暂无消费者，迁移等消费者）。插件 agents 装载校验在 Backend PR（Provides.Agents dormant 字段激活）。
产品 runmgr 派生路径的 SubagentStart/Stop（非工具调用、无总线上下文）不覆盖，留装配增量评估。

主任务：Dev 仓 feature/agent-stack-n1。

# N1 增量三（库侧）：AgentSpec、三类 guardrail、委派事件与 ask 透传（WP1/WP4）按 Documents 提案 `2026-10-07-agent-stack-n1q1i1-plans.md` §2.2 落地 WP1/WP4 的库侧部分。全部新增能力为 opt-in：端口为 nil / 未注册时行为与现状逐字节一致。 ## 改动 - **新包 `runtime/agentspec`（WP1）**：`AgentSpec` 类型（Name/Description/Prompt/Tools/DisallowedTools/Model/PermissionMode/Skills/MaxTurns/MemoryScope/Effort/Background/WorktreeIsolation/OutputSchema）；`agent-*.md` 解析 `Parse`（宿主/内置全字段）与 `ParsePlugin`（**插件来源禁带 hooks/mcp/permissionMode 键**，错误定位到字段）；`LoadDir` 整批原子（坏文件/重名全批拒绝）。 - **新包 `runtime/guardrails`（WP4）**：Input/Output/Tool 三端口，Verdict 复用 hooks.Decision，经 `Register(bus, set, scope{Entry,Final})` 以总线注册。语义：Input deny→不进入循环直接收尾（原文留痕）、modify→改写内容追加为新用户消息；Output（仅 Final）挂 Stop，deny→视同续跑附理由（计入内核 3 次上限）、modify→替换最终文本；Tool 挂 PreToolUse 按既有优先级合并，modify 改写参数。子代理 run（Scope 全 false）不受 Input/Output 影响。 - **`runtime/loop.go`**：消费 UserPromptSubmit 判定（上述 deny/modify 两分支）。 - **`runtime/subagent`**：`RegisterWithHooks`——委派执行前后发 `SubagentStart`（带目标摘要）/`SubagentStop`（带成败标记）；`Register` 旧签名不变（静默）。 - **`adapters/native`**：`GateOptions.PermissionAsk` 字段，透传进内核 Config（小队链路的 ask 裁决管道；squad 侧映射在 squad PR）。 ## 验证 - `go vet ./...` 通过；`go test -count=1 ./...` 26 包全 ok。 - 新增测试：agentspec 12（全字段/缺省/九类拒绝/插件禁键定位/LoadDir 原子与重名）、guardrails 5（Tool deny/modify、Output deny→Block、Scope 门控、nil 总线）、loop_guardrails 5（输入 deny 不调模型、modify 追加留痕、输出 deny 续跑至上限、工具 deny 配对、子 run 免伤）、subagent 3（Start/Stop 序列、失败标记、静默兼容）。 ## 范围裁定 - prompts.SubagentSpec 不迁移（与 agent-*.md 是两套格式；新字段暂无消费者，迁移等消费者）。插件 agents 装载校验在 Backend PR（Provides.Agents dormant 字段激活）。 - 产品 runmgr 派生路径的 SubagentStart/Stop（非工具调用、无总线上下文）不覆盖，留装配增量评估。主任务：Dev 仓 `feature/agent-stack-n1`。

weichen added 1 commit 2026-10-07 05:06:00 +00:00

Add AgentSpec, three guardrail ports, subagent events, and ask passthrough

ci / vet-and-test (pull_request) Successful in 47s

Details

ci / docker-checkout-hostgateway (pull_request) Successful in 0s

Details

948ca36ca2

Why: N1 increment three (WP1/WP4) - agents need a canonical spec
format with plugin restrictions, hosts need typed input/output/tool
guardrails, delegation needs lifecycle events, and squad adapters
need to pass the permission ask port through.

Evidence: go vet clean; go test ./... 26 packages ok, including new
agentspec (12 tests), guardrails (5), loop_guardrails (5), and
subagent hook tests (3).

Impact: new runtime/agentspec and runtime/guardrails packages; loop
consumes UserPromptSubmit outcomes (deny skips the loop, modify
appends the rewrite); subagent gains RegisterWithHooks emitting
SubagentStart/Stop around delegation; GateOptions gains PermissionAsk
forwarded into the kernel config. All additions are opt-in: nil
ports preserve prior behavior exactly.

Refs: Documents proposal 2026-10-07-agent-stack-n1q1i1-plans.md WP1/WP4

weichen merged commit c5b9dca446 into main

2026-10-07 05:07:25 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: weichen/Agent-Native#18