package sdk // 受限事件总线的判据。 // // 设计前提(用户 2026-10-27):现在有 security 模块兜底,可以给插件开事件总线, // 但只能是**受限的一条缝**——白名单类型、自己的命名空间、载荷过闸。 // 每条判据都在问:插件能不能借事件总线做超出边界的事? import ( "strings" "testing" "github.com/JianFeeeee/HologramAgent/internal/events" "github.com/JianFeeeee/HologramAgent/internal/security" pubsdk "github.com/JianFeeeee/hologramagentsdk/sdk" ) // newTestEvents 构造一个**已装上安全闸门**的受限事件面。 // // ## ★ 为什么必须装 Guard(2026-10-29 收敛后) // // 此前 `sdk/events.go` 自己查策略(checkPublish/checkSubscribe/scrubOut), // 所以测试里的裸 bus 也能"看起来工作"。收敛后授权与脱敏全部归 // `security.eventGuard`,而闸门是挂在总线上的 —— **测试不装 Guard, // 就等于在测一条没有执行者的策略**,于是判据会假绿。 // // 这正好顺便钉住了生产装配要求:**总线必须带闸门**,否则策略不生效。 func newTestEvents(t *testing.T, name string) (pubsdk.EventsAPI, *events.Bus) { t.Helper() bus := events.NewBus() // 用当前全局 Runtime 造闸门(未装配时 NewRuntime(nil) 给 Disabled Runtime, // 策略仍生效 —— 与生产同一条纪律:关闭凭据替换 ≠ 放开授权)。 rt := security.RuntimeGlobal() if rt == nil { rt = security.NewRuntime(nil) } if g := security.AsEventGuard(rt); g != nil { bus.SetGuard(g) } return newEventsAPI(name, bus), bus } // ① 白名单事件可发布,且 Source 被强制设成插件名(不能冒名)。 func TestEventsPublishAllowlisted(t *testing.T) { e, bus := newTestEvents(t, "clawhubadapter") var got *events.Event bus.Subscribe(events.EventSkillDetected, func(evt *events.Event) { got = evt }) if err := e.Publish("skill_detected", map[string]interface{}{"path": "/x/SKILL.md"}); err != nil { t.Fatalf("白名单事件应允许发布: %v", err) } if got == nil { t.Fatal("订阅者没收到事件") } if got.Source != "clawhubadapter" { t.Fatalf("Source 必须是插件名(不能冒名),实际 %q", got.Source) } } // ② 越界类型必须**报错**(静默丢弃会让插件以为发成功)。 func TestEventsPublishRejectsNonAllowlisted(t *testing.T) { e, _ := newTestEvents(t, "evil") for _, bad := range []string{ "raw_input", // 用户输入通道 "agent_output", // 对外输出 "update_request", // 能驱动内核升级流程 "stage", // 阶段管道内部事件 "system", // 系统事件 "plugin.other.x", // 别的插件命名空间 "plugin.evil", // 缺少后缀 "", // 空类型 } { if err := e.Publish(bad, nil); err == nil { t.Errorf("发布 %q 应被拒绝", bad) } } } // ③ 自己的命名空间允许(插件间协作),且带后缀。 func TestEventsPublishOwnNamespace(t *testing.T) { e, bus := newTestEvents(t, "seq") var seen bool bus.Subscribe(events.EventType("plugin.seq.done"), func(*events.Event) { seen = true }) if err := e.Publish("plugin.seq.done", map[string]interface{}{"n": 1}); err != nil { t.Fatalf("自己的命名空间应允许: %v", err) } if !seen { t.Fatal("订阅者没收到自己的命名空间事件") } } // ④ 订阅只开白名单事件;越界订阅报错。 // // ★ 2026-10-28 语义变更:raw_input / agent_output 改为可订阅(与 // security.EventPolicy 同步)。理由是它们是**通道出口的必需品**: // WebUI/CLI 的对话界面靠订阅它们渲染用户消息与 agent 回复; // 不开就等于“装监控把界面打瘫”。订阅是只读观测,真正需要收紧的是**发布**。 func TestEventsSubscribeAllowlistedOnly(t *testing.T) { e, bus := newTestEvents(t, "p1") for _, ok := range []string{ "tools_ready", "security_ready", "device_ready", "raw_input", "agent_output", "tool_call", "stage", "reasoning", "terminal_output", } { if _, err := e.Subscribe(ok, func(map[string]interface{}) {}); err != nil { t.Errorf("%q 应可订阅: %v", ok, err) } } // ★ update_request 可订阅(e2e 实测:内核执行器靠它收请求, // 不开会让升级请求静默丢失)。安全边界在**发布**侧。 if _, err := e.Subscribe("update_request", func(map[string]interface{}) {}); err != nil { t.Errorf("update_request 应可订阅: %v", err) } // 完全不存在的事件名也要拒 if _, err := e.Subscribe("no_such_event", func(map[string]interface{}) {}); err == nil { t.Error("订阅未登记事件应被拒绝") } // 解除订阅后不再收到 cancel, err := e.Subscribe("security_ready", func(map[string]interface{}) {}) if err != nil || cancel == nil { t.Fatalf("应能订阅 security_ready: %v", err) } cancel() if bus == nil { t.Fatal("bus 不应为 nil") } } // ⑤ 载荷出向过安全闸:明文凭据被换成 @{别名},不会原样进事件。 func TestEventsPayloadIsScrubbed(t *testing.T) { dir := t.TempDir() store, err := security.InitGlobal(security.Options{ Path: dir + "/vars.json", KeyFn: func() ([]byte, error) { return []byte("0123456789abcdef0123456789abcdef"), nil }, Enabled: true, }) if err != nil { t.Fatal(err) } t.Cleanup(func() { security.SetGlobal(nil) }) security.SetRuntimeGlobal(security.NewRuntime(store)) t.Cleanup(func() { security.SetRuntimeGlobal(nil) }) e, bus := newTestEvents(t, "leaky") var payload map[string]interface{} bus.Subscribe(events.EventSkillDetected, func(evt *events.Event) { payload = evt.Payload }) const secret = "ghp_abcdefghijklmnopqrstuvwxyz0123456789" if err := e.Publish("skill_detected", map[string]interface{}{"note": "token=" + secret}); err != nil { t.Fatal(err) } s, _ := payload["note"].(string) if strings.Contains(s, secret) { t.Fatalf("载荷里的明文凭据没有被拦下: %q", s) } if !strings.Contains(s, "@{sec_") { t.Fatalf("应换成变量别名,实际 %q", s) } } // ⑥ 键数上限:事件是通知,不是数据通道。 func TestEventsPayloadKeyLimit(t *testing.T) { e, _ := newTestEvents(t, "big") limit := security.DefaultEventPolicy().MaxPayloadKeys p := map[string]interface{}{} for i := 0; i < limit+1; i++ { p[string(rune('a'+i%26))+strings.Repeat("x", i)] = i } if err := e.Publish("skill_detected", p); err == nil { t.Fatal("超过键数上限应报错") } }