@zhushanwen/pi-subagent-workflow 0.1.0 → 0.3.0

package/src/execution/__tests__/subagent-service-abort.test.ts

@@ -0,0 +1,60 @@
+// src/__tests__/subagent-service-abort.test.ts
+//
+// S4: subagent-service abort 终态一致性测试。
+//
+// 审查发现：排队中被 abort（pool.acquire reject）走 finalizeFailed（status=failed），
+// 而已运行中被 abort 走 cancelled。同一用户 abort 因时机不同产生两种终态。
+//
+// 修复后：pool reject 的 error 带 name="AbortError"，runAndFinalize catch 判断
+// signal?.aborted 走 cancelled 路径。
+//
+// 本文件覆盖两层：
+//   1. pool 层：acquire reject 的 error.name 是 "AbortError"（S1 前半）
+//   2. pool 层：pre-aborted signal 也带 AbortError name（S1 另一处）
+
+import { describe, expect, it } from "vitest";
+
+import { DefaultConcurrencyPool } from "../concurrency-pool.ts";
+
+describe("S1: ConcurrencyPool abort reject produces AbortError name", () => {
+	it("queued acquire aborted via signal rejects with error.name=AbortError", async () => {
+		const pool = new DefaultConcurrencyPool(1);
+		await pool.acquire(0); // 占满
+
+		const controller = new AbortController();
+		const queued = pool.acquire(0, undefined, controller.signal);
+
+		await new Promise((r) => setTimeout(r, 5));
+		expect(pool.active).toBe(1); // 仍在排队
+
+		controller.abort();
+
+		try {
+			await queued;
+			expect.unreachable("should have rejected");
+		} catch (err) {
+			expect(err).toBeInstanceOf(Error);
+			expect((err as Error).name).toBe("AbortError");
+			expect((err as Error).message).toContain("abort");
+		}
+		pool.release();
+	});
+
+	it("pre-aborted signal rejects immediately with error.name=AbortError", async () => {
+		const pool = new DefaultConcurrencyPool(1);
+		await pool.acquire(0); // 占满
+
+		const controller = new AbortController();
+		controller.abort(); // 先 abort 再 acquire
+
+		try {
+			await pool.acquire(0, undefined, controller.signal);
+			expect.unreachable("should have rejected");
+		} catch (err) {
+			expect(err).toBeInstanceOf(Error);
+			expect((err as Error).name).toBe("AbortError");
+			expect((err as Error).message).toContain("abort");
+		}
+		pool.release();
+	});
+});

package/src/execution/__tests__/subagent-service.test.ts

@@ -18,9 +18,10 @@ import * as path from "node:path";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 import { createRecord } from "../execution-record.ts";
+import { ModelConfigService } from "../model-config-service.ts";
 import type { ModelInfo, ModelRegistryLike } from "../model-resolver.ts";
 import type { RecordStore } from "../record-store.ts";
-import { ModelConfigService } from "../model-config-service.ts";
+import type { UiRequest, UiRequestHandler } from "../dialog-queue.ts";
 import type { PiLike } from "../subagent-service.ts";
 import { getSubagentService, setSubagentService,SubagentService } from "../subagent-service.ts";
 import type { ExecutionRecord } from "../types.ts";
@@ -314,6 +315,75 @@ describe("SubagentService", () => {
     });
   });
 
+  // ============================================================
+  // dispose uiRequestHandler stub（dispose-cleanup Minor 优化1）
+  // ============================================================
+  //
+  // [背景] Pi 单进程 session 串行接管。session A shutdown 发 SIGTERM 后、子进程彻底
+  // close 前（graceful shutdown 窗口几十~几百 ms），子进程的 trailing extension_ui_request
+  // 仍会被父进程 pump 解析，调到 A 的 handler 闭包（仍持有 A 的 ctx）。旧实现 dispose 不清
+  // uiRequestHandler，该闭包触发 ui-request-queue.ts catch 分支打 `[subagents] uiRequestHandler
+  // threw` 误导性 console.error。dispose 现注入 stub（始终返回 {cancelled:true}），让 trailing
+  // ui_request 干净降级，不再走旧 handler 闭包。
+  //
+  // 被测点是 SubagentService.dispose 内的 setUiRequestHandler(stub)。uiRequestHandler 是
+  // private 字段，用 Reflect.get 取（与 R0-D 块访问 store 同模式）。
+
+  describe("dispose uiRequestHandler stub (dispose-cleanup)", () => {
+    /** 从 service 取出 private uiRequestHandler（trailing ui_request 实际调用入口）。 */
+    function getHandler(service: SubagentService): UiRequestHandler | undefined {
+      return Reflect.get(service, "uiRequestHandler") as UiRequestHandler | undefined;
+    }
+
+    /** 最小 UiRequest（method 无关紧要——stub 不论 method 一律返回 cancelled）。 */
+    function makeTrailingRequest(id: string): UiRequest {
+      return { method: "notify", id };
+    }
+
+    it("dispose 后 uiRequestHandler 被 stub 替换，调用返回 {cancelled:true} 不抛错", async () => {
+      const service = new SubagentService({ cwd: agentDir, modelService });
+      service.initSession({ pi: makePi(), sessionId: "s1" });
+
+      service.dispose();
+
+      const handler = getHandler(service);
+      expect(handler).toBeDefined();
+      // 模拟 dispose 后子进程 trailing ui_request 被父进程 pump 调到 handler
+      await expect(handler!(makeTrailingRequest("trailing-1"))).resolves.toEqual({ cancelled: true });
+    });
+
+    it("dispose stub 覆盖旧 handler：trailing ui_request 不产生 [subagents] console.error 噪声", async () => {
+      // 模拟 session A 的真实 handler 闭包——在 ctx 已 disposed 后调用会抛错
+      const staleHandler: UiRequestHandler = async () => {
+        throw new Error("stale ctx");
+      };
+      const errorSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+
+      const service = new SubagentService({ cwd: agentDir, modelService });
+      service.initSession({ pi: makePi(), sessionId: "s1" });
+      service.setUiRequestHandler(staleHandler);
+
+      service.dispose();
+
+      // dispose 后 handler 应被 stub 替换，不再是 staleHandler
+      const handler = getHandler(service);
+      expect(handler).not.toBe(staleHandler);
+
+      // trailing ui_request 调到的是 stub，不抛错、返回 cancelled
+      await expect(handler!(makeTrailingRequest("trailing-2"))).resolves.toEqual({ cancelled: true });
+
+      // 关键价值断言：无 "[subagents] uiRequestHandler threw" 误导性噪声
+      // （旧实现 dispose 不清 handler 时，trailing ui_request 走 staleHandler 抛错 →
+      //   ui-request-queue.ts catch 打该日志。stub 覆盖后该路径不再触发。）
+      const subagentsErrors = errorSpy.mock.calls.filter(
+        (args: unknown[]) => typeof args[0] === "string" && args[0].includes("[subagents]"),
+      );
+      expect(subagentsErrors).toHaveLength(0);
+
+      errorSpy.mockRestore();
+    });
+  });
+
   // ============================================================
   // execute() worktree fail-fast 校验 [MF#7]（commit 8e8e75966）
   // ============================================================
@@ -488,12 +558,12 @@ describe("SubagentService", () => {
       // worktree create 抛错在 kickOffBackground 之前（execute 同步 catch），返回 background 形状
       expect(handle.mode).toBe("background");
 
-      // register emit：background mode → id 前缀 bg-
+      // register emit：background mode → id 是 UUID 格式
       expect(pi.events.emit).toHaveBeenCalledWith(
         "pending:register",
         expect.objectContaining({
           type: "subagent",
-          id: expect.stringMatching(/^bg-/),
+          id: expect.any(String),
           name: "general-purpose",
         }),
       );

package/src/execution/__tests__/subprocess-agent-runner.test.ts

@@ -15,9 +15,9 @@
 
 import { describe, expect, it, vi } from "vitest";
 
-import { SubprocessAgentRunner } from "../subprocess-agent-runner.ts";
-import type { SubprocessAgentRunnerDeps } from "../subprocess-agent-runner.ts";
 import type { AgentCallOpts, AgentResult } from "../../orchestration/models/types.ts";
+import type { SubprocessAgentRunnerDeps } from "../subprocess-agent-runner.ts";
+import { SubprocessAgentRunner } from "../subprocess-agent-runner.ts";
 
 // ── 测试辅助 ──
 
@@ -42,6 +42,7 @@ function createMockService(impl?: typeof vi.fn) {
       opts: Record<string, unknown>,
       signal?: AbortSignal,
       onEvent?: (e: Record<string, unknown>) => void,
+      stream?: unknown,
     ) => Promise<AgentResult>;
   };
 }
@@ -175,7 +176,37 @@ describe("SubprocessAgentRunner (wave-4 delegate)", () => {
       const opts = { ...makeBaseOpts(), model: undefined };
       await sar.run(opts, new AbortController().signal);
 
-      expect(capturedOpts!.model).toBe("ctx-model");
+      // 修复后：opts.model 不再从 ctxModel.id 填底，ctxModel 作为完整对象透传
+      expect(capturedOpts!.model).toBeUndefined();
+      expect(capturedOpts!.ctxModel).toBe(ctxModel);
+    });
+  });
+
+  // ────────────────────────────────────────────────
+  // H1: SAR ctxModel 刷新（model_select 后不再 stale）
+  // ────────────────────────────────────────────────
+  describe("H1 ctxModel refresh via updateCtxModel", () => {
+    it("updateCtxModel 后 run() 传入新的 ctxModel 而非旧值", async () => {
+      let capturedOpts: Record<string, unknown> | undefined;
+      const mockService = createMockService(
+        vi.fn().mockImplementation((opts: Record<string, unknown>) => {
+          capturedOpts = opts;
+          return Promise.resolve(makeMockResult());
+        }),
+      );
+      const oldModel = { id: "old-model", provider: "test", input: [] };
+      const newModel = { id: "new-model", provider: "test", input: [] };
+      const deps: SubprocessAgentRunnerDeps = { subagentService: mockService, ctxModel: oldModel };
+      const sar = new SubprocessAgentRunner(deps);
+
+      // 模拟 model_select：刷新 ctxModel
+      sar.updateCtxModel(newModel);
+
+      const opts = { ...makeBaseOpts(), model: undefined };
+      await sar.run(opts, new AbortController().signal);
+
+      expect(capturedOpts!.ctxModel).toBe(newModel);
+      expect(capturedOpts!.ctxModel).not.toBe(oldModel);
     });
   });
 
@@ -386,4 +417,42 @@ describe("SubprocessAgentRunner (wave-4 delegate)", () => {
       expect(result.error).toBe("raw string error");
     });
   });
+
+  // ────────────────────────────────────────────────
+  // U1: stream 透传给 executeAndAwait
+  // ────────────────────────────────────────────────
+  describe("U1 stream 透传", () => {
+    it("SAR.run 传 stream → executeAndAwait 第 4 参收到同一 stream 对象", async () => {
+      let capturedStream: unknown;
+      const mockService = createMockService(
+        vi.fn().mockImplementation((_opts, _sig, _onEvt, stream) => {
+          capturedStream = stream;
+          return Promise.resolve(makeMockResult());
+        }),
+      );
+      const deps: SubprocessAgentRunnerDeps = { subagentService: mockService };
+      const sar = new SubprocessAgentRunner(deps);
+
+      const fakeStream = { onDelta: vi.fn(), dispose: vi.fn() };
+      await sar.run(makeBaseOpts(), new AbortController().signal, undefined, fakeStream as never);
+
+      expect(capturedStream).toBe(fakeStream);
+    });
+
+    it("SAR.run 不传 stream → executeAndAwait 第 4 参为 undefined", async () => {
+      let capturedStream: unknown = "sentinel";
+      const mockService = createMockService(
+        vi.fn().mockImplementation((_opts, _sig, _onEvt, stream) => {
+          capturedStream = stream;
+          return Promise.resolve(makeMockResult());
+        }),
+      );
+      const deps: SubprocessAgentRunnerDeps = { subagentService: mockService };
+      const sar = new SubprocessAgentRunner(deps);
+
+      await sar.run(makeBaseOpts(), new AbortController().signal);
+
+      expect(capturedStream).toBeUndefined();
+    });
+  });
 });

package/src/execution/__tests__/tool-action.test.ts

@@ -5,8 +5,8 @@
 
 import { describe, expect, it, vi } from "vitest";
 
-import type { SubagentService } from "../subagent-service.ts";
 import { adapter, cancelHandler, listHandler, startHandler } from "../../interface/subagent-actions.ts";
+import type { SubagentService } from "../subagent-service.ts";
 import type {
   ExecutionHandle,
   RecordSnapshot,
@@ -23,6 +23,7 @@ function makeDetails(over: Partial<SubagentToolDetails> = {}): SubagentToolDetai
     agent: "worker",
     model: "test/model",
     thinkingLevel: undefined,
+    slug: "test-slug",
     turns: 1,
     totalTokens: 10,
     elapsedSeconds: 1,
@@ -40,6 +41,7 @@ function makeSnapshot(over: Partial<RecordSnapshot> = {}): RecordSnapshot {
     thinkingLevel: undefined,
     mode: "background",
     task: "t",
+    slug: "test-slug",
     status: "done",
     eventLog: [],
     turns: 1,
@@ -74,7 +76,24 @@ describe("startHandler", () => {
 
   it("task 空白 → throw", async () => {
     const svc = makeService();
-    await expect(startHandler(svc, { task: "   " }, undefined)).rejects.toThrow(/task is required/);
+    await expect(startHandler(svc, { task: "   ", slug: "x" }, undefined)).rejects.toThrow(/task is required/);
+  });
+
+  it("slug 缺失 → throw", async () => {
+    const svc = makeService();
+    await expect(startHandler(svc, { task: "ok" }, undefined)).rejects.toThrow(/slug is required/);
+  });
+
+  it("slug 空白 → throw", async () => {
+    const svc = makeService();
+    await expect(startHandler(svc, { task: "ok", slug: "   " }, undefined)).rejects.toThrow(/slug is required/);
+  });
+
+  it("slug 超 20 字符 → throw", async () => {
+    const svc = makeService();
+    await expect(
+      startHandler(svc, { task: "ok", slug: "a".repeat(21) }, undefined),
+    ).rejects.toThrow(/≤20 chars/);
   });
 
   it("background 启动 → kind=bg + bgResponse.message 含 detached", async () => {
@@ -86,7 +105,7 @@ describe("startHandler", () => {
         details: makeDetails({ status: "running", mode: "background" }),
       })),
     });
-    const r = await startHandler(svc, { task: "long" }, undefined);
+    const r = await startHandler(svc, { task: "long", slug: "long-running" }, undefined);
     expect(r.kind).toBe("bg");
     if (r.kind !== "bg") return;
     expect(r.subagentId).toBe("bg-1-123");
@@ -297,11 +316,11 @@ describe("cancelHandler", () => {
 // adapter
 // ============================================================
 describe("adapter", () => {
-  it("start bg → SubagentToolResult.bgResponse + content 合法 JSON（C3 回归）", () => {
+  it("start bg → SubagentToolResult.bgResponse + slug 透传 + content 合法 JSON（C3 回归）", () => {
     const r = adapter({
       action: "start",
       domain: {
-        kind: "bg", subagentId: "bg-1", sessionFile: undefined,
+        kind: "bg", subagentId: "bg-1", sessionFile: undefined, slug: "extract-urls",
         response: { status: "running", mode: "background", message: "detached, will notify on completion" },
       },
     });
@@ -309,9 +328,12 @@ describe("adapter", () => {
     expect(r.details.subagentId).toBe("bg-1");
     expect(r.details.bgResponse).toBeDefined();
     expect(r.details.sessionFile).toBeNull();
+    // slug 透传到 result（renderResult 的 background 行展示用）
+    expect(r.details.slug).toBe("extract-urls");
     // content JSON round-trip（bg 序列化回归）
     const parsed = JSON.parse(r.content[0]!.text);
     expect(parsed.bgResponse.message).toMatch(/detached/);
+    expect(parsed.slug).toBe("extract-urls");
   });
 
   it("list → 最外层 subagentId/sessionFile 为 null", () => {

package/src/execution/__tests__/ui-channels.test.ts

@@ -0,0 +1,187 @@
+// src/__tests__/ui-channels.test.ts
+//
+// W1 红灯测试：ui-channels.ts — channel 提取（marker 解析）+ channel 注册表。
+//
+// 测试对象：extensions/subagent-workflow/src/execution/ui-channels.ts（新建）
+// 契约来源：.fix-plans/00-master-summary.md §一 冲突 2「维度 2：channel 注册表」
+//
+// parseChannel(req): ExtensionUiRequest → { channel?, channelPayload? }
+//   - select → 从 title 解析 NUL 前缀（parseFromMarkerString）
+//   - setWidget → 从 widgetLines[0] 解析 NUL 前缀（parseFromMarkerArray）
+//   - 其他 method → {}（无 channel）
+//
+// marker 格式：\0<UPPER_CASE_ID>[:]<JSON-payload?>
+//   - ASK_USER_MARKER = "\0XYZ_ASK_USER"，payload 在 options[0]
+//   - GUI_WIDGET_MARKER = "\0XYZ_GUI_WIDGET:" + JSON，payload 在同行
+// channel 名规范化：去 "XYZ_" 前缀，小写化（XYZ_ASK_USER → ask_user）
+//
+// UiChannelRegistry:
+//   - register(channel, handler) / resolve(channel) / list()
+//
+// 边界：无 NUL 前缀 → {}；JSON parse 失败 → {}（不抛）；字段缺失 → {}
+//
+// 红灯原因：ui-channels.ts 尚未创建，import 失败。
+
+import { describe, expect, it, vi } from "vitest";
+
+import {
+  createUiChannelRegistry,
+  type ExtensionUiRequestLike,
+  parseChannel,
+} from "../ui-channels.ts";
+
+// ── 测试 fixture 构造助手 ────────────────────────────────────
+// ExtensionUiRequestLike 是 parseChannel 入参的最小形状（method + 对应字段）。
+
+function selectReq(title: string, options?: string[]): ExtensionUiRequestLike {
+  return { method: "select", title, options };
+}
+
+function setWidgetReq(widgetKey: string, widgetLines: string[] | undefined): ExtensionUiRequestLike {
+  return { method: "setWidget", widgetKey, widgetLines };
+}
+
+// ── ASK_USER_MARKER 样本（真实 Pi 协议格式） ─────────────────
+// title = "\0XYZ_ASK_USER"，options[0] = JSON.stringify({questions, allowCancel})
+const ASK_USER_MARKER = "\0XYZ_ASK_USER";
+const askUserPayload = {
+  questions: [{ question: "Pick one", options: [{ label: "A" }, { label: "B" }] }],
+  allowCancel: true,
+};
+
+// ── GUI_WIDGET_MARKER 样本（真实 Pi 协议格式） ───────────────
+// widgetLines[0] = "\0XYZ_GUI_WIDGET:" + JSON.stringify({component:{...}})
+const GUI_WIDGET_MARKER_PREFIX = "\0XYZ_GUI_WIDGET:";
+const guiWidgetPayload = { component: { name: "StatusCard", props: { ok: true } } };
+
+describe("parseChannel — select method（从 title 解析 NUL 前缀）", () => {
+  it("title 含 ASK_USER_MARKER → channel='ask_user' + payload 从 options[0] 解析", () => {
+    const req = selectReq(ASK_USER_MARKER, [JSON.stringify(askUserPayload)]);
+    const result = parseChannel(req);
+    expect(result.channel).toBe("ask_user");
+    expect(result.channelPayload).toEqual(askUserPayload);
+  });
+
+  it("title 无 NUL 前缀 → {}（普通 select，无 channel）", () => {
+    const req = selectReq("Choose a plan", ["basic", "pro"]);
+    const result = parseChannel(req);
+    expect(result.channel).toBeUndefined();
+    expect(result.channelPayload).toBeUndefined();
+  });
+
+  it("title 含 marker 但 options 缺失 → channel 解析但 payload undefined", () => {
+    // marker 在 title，但 options 为空 → channel 名仍可提取，payload 无来源
+    const req = selectReq(ASK_USER_MARKER);
+    const result = parseChannel(req);
+    expect(result.channel).toBe("ask_user");
+  });
+});
+
+describe("parseChannel — setWidget method（从 widgetLines[0] 解析 NUL 前缀）", () => {
+  it("widgetLines[0] 含 GUI_WIDGET_MARKER → channel='gui_widget' + payload", () => {
+    const req = setWidgetReq("w1", [GUI_WIDGET_MARKER_PREFIX + JSON.stringify(guiWidgetPayload)]);
+    const result = parseChannel(req);
+    expect(result.channel).toBe("gui_widget");
+    expect(result.channelPayload).toEqual(guiWidgetPayload);
+  });
+
+  it("widgetLines 无 NUL 前缀 → {}（普通 setWidget）", () => {
+    const req = setWidgetReq("w1", ["plain content line"]);
+    const result = parseChannel(req);
+    expect(result.channel).toBeUndefined();
+  });
+
+  it("widgetLines 为 undefined → {}", () => {
+    const req = setWidgetReq("w1", undefined);
+    const result = parseChannel(req);
+    expect(result.channel).toBeUndefined();
+  });
+
+  it("widgetLines 为空数组 → {}", () => {
+    const req = setWidgetReq("w1", []);
+    const result = parseChannel(req);
+    expect(result.channel).toBeUndefined();
+  });
+});
+
+describe("parseChannel — 其他 method（无 channel 提取位置）", () => {
+  it("confirm → {}", () => {
+    const result = parseChannel({ method: "confirm", title: "t", message: "m" });
+    expect(result.channel).toBeUndefined();
+  });
+
+  it("input → {}", () => {
+    const result = parseChannel({ method: "input", title: "t" });
+    expect(result.channel).toBeUndefined();
+  });
+
+  it("notify → {}", () => {
+    const result = parseChannel({ method: "notify", message: "hi" });
+    expect(result.channel).toBeUndefined();
+  });
+});
+
+describe("parseChannel — channel 名规范化规则", () => {
+  it("去 XYZ_ 命名空间前缀 + 小写化（XYZ_ASK_USER → ask_user）", () => {
+    const req = selectReq("\0XYZ_ASK_USER", [JSON.stringify({ x: 1 })]);
+    expect(parseChannel(req).channel).toBe("ask_user");
+  });
+
+  it("XYZ_GUI_WIDGET: 带冒号后缀 → gui_widget（去前缀 + 去冒号 + 小写）", () => {
+    const req = setWidgetReq("k", ["\0XYZ_GUI_WIDGET:" + JSON.stringify({ y: 2 })]);
+    expect(parseChannel(req).channel).toBe("gui_widget");
+  });
+});
+
+describe("parseChannel — 边界（不抛错）", () => {
+  it("marker 后 payload 非法 JSON → 不抛错，channel 仍解析（payload undefined）", () => {
+    const req = selectReq(ASK_USER_MARKER, ["not-valid-json{"]);
+    expect(() => parseChannel(req)).not.toThrow();
+    const result = parseChannel(req);
+    expect(result.channel).toBe("ask_user");
+  });
+
+  it("GUI_WIDGET_MARKER 后非法 JSON → 不抛错", () => {
+    const req = setWidgetReq("k", [GUI_WIDGET_MARKER_PREFIX + "broken{json"]);
+    expect(() => parseChannel(req)).not.toThrow();
+  });
+});
+
+// ── UiChannelRegistry ────────────────────────────────────────
+
+describe("UiChannelRegistry — 注册 + 解析 + 列举", () => {
+  it("register 后 resolve 返回注册的 handler", () => {
+    const registry = createUiChannelRegistry();
+    const handler = vi.fn();
+    registry.register("ask_user", handler);
+    expect(registry.resolve("ask_user")).toBe(handler);
+  });
+
+  it("未注册的 channel resolve 返回 undefined", () => {
+    const registry = createUiChannelRegistry();
+    expect(registry.resolve("unknown")).toBeUndefined();
+  });
+
+  it("list 返回所有已注册 channel 名", () => {
+    const registry = createUiChannelRegistry();
+    registry.register("ask_user", vi.fn());
+    registry.register("gui_widget", vi.fn());
+    const names = registry.list().sort();
+    expect(names).toEqual(["ask_user", "gui_widget"]);
+  });
+
+  it("list 空注册表返回 []", () => {
+    const registry = createUiChannelRegistry();
+    expect(registry.list()).toEqual([]);
+  });
+
+  it("重复 register 同名 channel 覆盖旧 handler", () => {
+    const registry = createUiChannelRegistry();
+    const old = vi.fn();
+    const fresh = vi.fn();
+    registry.register("ask_user", old);
+    registry.register("ask_user", fresh);
+    expect(registry.resolve("ask_user")).toBe(fresh);
+    expect(registry.list()).toEqual(["ask_user"]);
+  });
+});

package/src/execution/__tests__/ui-interaction-model.test.ts

@@ -0,0 +1,67 @@
+// src/__tests__/ui-interaction-model.test.ts
+//
+// W1 红灯测试：ui-interaction-model.ts — method 交互模型分类。
+//
+// 测试对象：extensions/subagent-workflow/src/execution/ui-interaction-model.ts（新建）
+// 契约来源：.fix-plans/00-master-summary.md §一 冲突 2「维度 1：透传判定规则」
+//
+// isDialogMethod(method):
+//   - dialog（占输入焦点，等响应，需透传+排队）：select / confirm / input / editor → true
+//   - fire-and-forget（纯展示/写入，不等响应）：notify / setStatus / setWidget /
+//     setTitle / set_editor_text / 未知 method → false
+//
+// 红灯原因：ui-interaction-model.ts 尚未创建，import 失败。
+
+import { describe, expect, it } from "vitest";
+
+import { isDialogMethod } from "../ui-interaction-model.ts";
+
+describe("isDialogMethod — dialog 类 method（占输入焦点）", () => {
+  it("select → true（含 ask_user channel 借道 select）", () => {
+    expect(isDialogMethod("select")).toBe(true);
+  });
+
+  it("confirm → true", () => {
+    expect(isDialogMethod("confirm")).toBe(true);
+  });
+
+  it("input → true", () => {
+    expect(isDialogMethod("input")).toBe(true);
+  });
+
+  it("editor → true", () => {
+    expect(isDialogMethod("editor")).toBe(true);
+  });
+});
+
+describe("isDialogMethod — fire-and-forget 类 method（纯展示/写入）", () => {
+  it("notify → false", () => {
+    expect(isDialogMethod("notify")).toBe(false);
+  });
+
+  it("setStatus → false", () => {
+    expect(isDialogMethod("setStatus")).toBe(false);
+  });
+
+  it("setWidget → false（含 gui_widget channel 借道 setWidget）", () => {
+    expect(isDialogMethod("setWidget")).toBe(false);
+  });
+
+  it("setTitle → false", () => {
+    expect(isDialogMethod("setTitle")).toBe(false);
+  });
+
+  it("set_editor_text → false", () => {
+    expect(isDialogMethod("set_editor_text")).toBe(false);
+  });
+});
+
+describe("isDialogMethod — 未知 method 默认 fire-and-forget", () => {
+  it("未知 method 名 → false（未来 Pi 新增 method 不误判为 dialog）", () => {
+    expect(isDialogMethod("some_future_method")).toBe(false);
+  });
+
+  it("空字符串 → false", () => {
+    expect(isDialogMethod("")).toBe(false);
+  });
+});