@zhushanwen/pi-subagent-workflow 8.1.0 → 8.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-subagent-workflow",
-  "version": "8.1.0",
+  "version": "8.1.1",
   "type": "module",
   "main": "index.ts",
   "description": "Unified subagent execution and multi-agent workflow orchestration for Pi — spawned-process agent runtime with sync/background modes, stateful workflow management with persistence, state machine, and execution tracing.",
@@ -30,6 +30,9 @@
     "src/interface/",
     "src/shared/"
   ],
+  "xyz-agent": {
+    "role": "universal"
+  },
   "pi": {
     "extensions": [
       "./index.ts"
@@ -44,17 +47,17 @@
   "dependencies": {
     "ajv": "^8.20.0",
     "yaml": "^2.9.0",
-    "@xyz-agent/extension-protocol": "0.5.0",
-    "@zhushanwen/pi-extension-logger": "0.2.1",
+    "@xyz-agent/extension-protocol": "0.5.1",
+    "@zhushanwen/pi-extension-logger": "0.2.2",
     "@zhushanwen/pi-file-lock": "0.1.1"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
+    "@earendil-works/pi-ai": "^0.84.1",
+    "@earendil-works/pi-coding-agent": "^0.84.1",
+    "@earendil-works/pi-tui": "^0.84.1",
     "typebox": "*",
-    "@zhushanwen/pi-pending-notifications": "0.3.3",
-    "@zhushanwen/pi-structured-output": "5.0.1"
+    "@zhushanwen/pi-pending-notifications": "0.3.4",
+    "@zhushanwen/pi-structured-output": "5.0.2"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {

package/skills/workflow-script-format/SKILL.md

@@ -201,7 +201,7 @@ const results = await parallel(
 );
 ```
 
-> 内置通用编排 workflow（chain / parallel / scatter-gather / map-reduce，可直接 `workflow run`，用 `agent()` 自包含实现）见 `extensions/subagent-workflow/workflows/`。本段教 `workflow()` 嵌套 API，workflows 目录是开箱即用的通用编排工具（用 `agent()` 而非 `workflow()` 嵌套）。
+> 内置通用编排 workflow（chain / parallel / scatter-gather / map-reduce，可直接 `workflow run`，用 `agent()` 自包含实现）见 `extensions/universal/subagent-workflow/workflows/`。本段教 `workflow()` 嵌套 API，workflows 目录是开箱即用的通用编排工具（用 `agent()` 而非 `workflow()` 嵌套）。
 
 ### Other globals
 

package/src/execution/__tests__/channel-registry-handshake.test.ts

@@ -2,7 +2,7 @@
 //
 // 决策 D（修复 M4）：channel handshake 协议升级测试。
 //
-// 测试对象：extensions/subagent-workflow/src/execution/channel-registry-access.ts
+// 测试对象：extensions/universal/subagent-workflow/src/execution/channel-registry-access.ts
 //
 // 协议契约（与 ask-user 侧严格对齐）：
 //   key 字面量：     "@zhushanwen/pi-subagents.channelHandshake"

package/src/execution/__tests__/dialog-queue.test.ts

@@ -2,7 +2,7 @@
 //
 // W2 红灯测试：dialog-queue.ts — L2 跨子进程全局 dialog 串行队列。
 //
-// 测试对象：extensions/subagent-workflow/src/execution/dialog-queue.ts（新建）
+// 测试对象：extensions/universal/subagent-workflow/src/execution/dialog-queue.ts（新建）
 // 契约来源：.fix-plans/00-master-summary.md §一 冲突 3（L2 DialogGlobalQueue 设计）
 //
 // DialogGlobalQueue 设计要点：

package/src/execution/__tests__/host-mode.test.ts

@@ -2,7 +2,7 @@
 //
 // W1 红灯测试：host-mode.ts 主进程运行模式分类工具。
 //
-// 测试对象：extensions/subagent-workflow/src/execution/host-mode.ts（新建）
+// 测试对象：extensions/universal/subagent-workflow/src/execution/host-mode.ts（新建）
 // 契约来源：.fix-plans/00-master-summary.md §一 冲突 4 + §2.5（W4 守卫消费点）
 //
 // 三个导出：

package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts

@@ -2,7 +2,7 @@
 //
 // W1 红灯测试：spawn-event-adapter.ts 协议层重写 — Pi 原生格式 + method 平铺。
 //
-// 测试对象：extensions/subagent-workflow/src/execution/spawn-event-adapter.ts（改造）
+// 测试对象：extensions/universal/subagent-workflow/src/execution/spawn-event-adapter.ts（改造）
 // 契约来源：.fix-plans/00-master-summary.md §二（统一接口契约）+ §一冲突 2/判定顺序
 //
 // 核心改动：

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

@@ -2,7 +2,7 @@
 //
 // W1 红灯测试：ui-channels.ts — channel 提取（marker 解析）+ channel 注册表。
 //
-// 测试对象：extensions/subagent-workflow/src/execution/ui-channels.ts（新建）
+// 测试对象：extensions/universal/subagent-workflow/src/execution/ui-channels.ts（新建）
 // 契约来源：.fix-plans/00-master-summary.md §一 冲突 2「维度 2：channel 注册表」
 //
 // parseChannel(req): ExtensionUiRequest → { channel?, channelPayload? }

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

@@ -2,7 +2,7 @@
 //
 // W1 红灯测试：ui-interaction-model.ts — method 交互模型分类。
 //
-// 测试对象：extensions/subagent-workflow/src/execution/ui-interaction-model.ts（新建）
+// 测试对象：extensions/universal/subagent-workflow/src/execution/ui-interaction-model.ts（新建）
 // 契约来源：.fix-plans/00-master-summary.md §一 冲突 2「维度 1：透传判定规则」
 //
 // isDialogMethod(method):

package/src/execution/__tests__/ui-request-observability.test.ts

@@ -2,7 +2,7 @@
 //
 // M4 测试：ui-request-observability.ts — UiRequestObservability 纯逻辑类。
 //
-// 测试对象：extensions/subagent-workflow/src/execution/ui-request-observability.ts
+// 测试对象：extensions/universal/subagent-workflow/src/execution/ui-request-observability.ts
 // 契约来源：类注释（per-session 去重 + resetMissingHandlerWarnings 清洗 + setMode/getMode 往返）
 //
 // UiRequestObservability 职责：

package/src/execution/session-runner.ts

@@ -181,7 +181,7 @@ const STDERR_MAX_CHARS = 65_536;
  *
  * [跨包契约 SSOT] 此字面量是两个独立 npm 包（@zhushanwen/pi-subagent-workflow 与
  * @zhushanwen/pi-structured-output）之间的隐式 env 契约。structured-output 包内同名常量为
- * `ENV_SCHEMA = "PI_WORKFLOW_SCHEMA"`（见 extensions/structured-output/src/index.ts）。
+ * `ENV_SCHEMA = "PI_WORKFLOW_SCHEMA"`（见 extensions/universal/structured-output/src/index.ts）。
  * 两包是独立 npm 包不能直接 import，故各自保留常量但显式标注此契约关系——
  * 任一端改名必须同步另一端，否则权威 schema 注入会静默断桥（子进程不注册 tool/hook）。
  */

package/src/orchestration/__tests__/workflows-e2e.test.ts

@@ -20,7 +20,7 @@
  *
  * registry 绕过说明（见末尾 notes）：
  *   WorkflowScriptRegistryImpl(config) 的扫描源是固定约定目录（.pi/workflows 等），
- *   无法指向 extensions/subagent-workflow/workflows/。为不改源码，这里直接读 .js 文件
+ *   无法指向 extensions/universal/subagent-workflow/workflows/。为不改源码，这里直接读 .js 文件
  *   内容 + 手动构造 WorkflowScript 对象，包装为一个满足 WorkflowScriptRegistry 接口
  *   的自定义 registry（loadWorkflowsFromDir）。
  */
@@ -48,7 +48,7 @@ import type { WorkflowScriptRegistry } from "../models/workflow-script-registry.
 import { WorkerHostImpl } from "../worker-host.ts";
 
 // ── 路径：定位真实 workflows 目录 ─────────────────────────────────────────
-// 本测试文件在 src/orchestration/__tests__/，workflows 目录在 extensions/subagent-workflow/workflows/
+// 本测试文件在 src/orchestration/__tests__/，workflows 目录在 extensions/universal/subagent-workflow/workflows/
 // 即 __dirname → ..  (orchestration) → ..  (src) → ..  (subagent-workflow) → workflows
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const WORKFLOWS_DIR = join(__dirname, "..", "..", "..", "workflows");

package/workflows/review-fix-loop-utils.cjs

@@ -1,7 +1,7 @@
 // review-fix-loop-utils.cjs — review-fix-loop.js 的可测纯函数模块
 //
 // workflow 编排逻辑的纯函数抽到独立 .cjs，
-// 供 vitest 单测直接 require（extensions/subagent-workflow/src/__tests__/review-fix-loop-utils.test.ts）
+// 供 vitest 单测直接 require（extensions/universal/subagent-workflow/src/__tests__/review-fix-loop-utils.test.ts）
 // 与 worker 运行时共用（review-fix-loop.js 经 workerData.scriptPath 定位本文件）。
 //
 // 本文件不依赖 workflow 全局（$ARGS/agent/parallel/phase/log），所有需要报错的函数