@maplezzk/pi-dynamic-workflows 1.1.2 → 1.2.0

package/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: configure-pi-dynamic-workflows
+description: "配置与排查 pi-dynamic-workflows 的执行后端和异步模式。Use when configuring workflow backend, async mode, or subagent integration."
+---
+
+# 配置 pi-dynamic-workflows
+
+## 诊断
+
+读取实际 Pi agent 目录下的 `extensions/pi-dynamic-workflows/config.json`，并检查 `PI_WORKFLOW_BACKEND`、`PI_WORKFLOW_ASYNC`。优先级是 JSON 配置 > 环境变量 > 默认值。
+
+## 修改
+
+优先在 Pi 中运行 `/config:workflow`：
+
+- `backend: "workflow"` 使用内置进程内 agent；
+- `backend: "subagent"` 要求 `pi-interactive-subagents` 已安装并加载；
+- `async: true` 让 workflow 后台执行并显示实时状态。
+
+`/workflow-config` 和 `/pi-workflow-config` 仅为兼容别名。不要在没有 subagent 扩展时选择 `subagent`，也不要用环境变量覆盖后误以为 JSON 未生效。
+
+## 验证
+
+运行一个最小 workflow，至少包含静态 `meta.phases`、一次 `phase()` 和一次带 JSON Schema 的 `agent()`。若使用 `subagent` 后端，确认 `globalThis.__pi_subagents` 能力已注入；缺失时明确报告配置依赖错误，不静默切回内置后端。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maplezzk/pi-dynamic-workflows",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Claude-Code-style dynamic workflow orchestration for Pi. Fork of michaelliv/pi-dynamic-workflows.",
   "type": "module",
   "main": "./index.ts",
@@ -13,7 +13,8 @@
     "locales",
     "types",
     "README.md",
-    "README.zh-CN.md"
+    "README.zh-CN.md",
+    "SKILL.md"
   ],
   "scripts": {
     "test": "tsx --test tests/*.test.ts",
@@ -25,6 +26,9 @@
     "extensions": [
       "./index.ts",
       "../pi-extensions-i18n/index.ts"
+    ],
+    "skills": [
+      "./SKILL.md"
     ]
   },
   "engines": {
@@ -56,7 +60,7 @@
   ],
   "dependencies": {
     "acorn": "^8.16.0",
-    "pi-extensions-i18n": "^0.3.1"
+    "pi-extensions-i18n": "^0.4.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": ">=0.80.0 <0.81.0",

package/src/workflow.ts

@@ -203,7 +203,7 @@ export async function runWorkflow<T = unknown>(
   };
 
   const context = vm.createContext({
-    agent,
+    __agent: agent,
     parallel,
     pipeline,
     log,
@@ -230,7 +230,21 @@ export async function runWorkflow<T = unknown>(
     Promise,
   });
 
-  const wrapped = `(async () => {\n${body}\n})()`;
+  // A host Promise receives a context-local wrapper when it crosses into vm.
+  // Track that wrapper in the vm realm itself so a fire-and-forget agent() that
+  // later rejects (notably during cancellation) cannot become an unhandled
+  // rejection and terminate Pi. Returning the original promise preserves normal
+  // await/rejection semantics for workflow scripts.
+  const wrapped = `(async (__workflowAgent) => {
+const trackedAgent = (...args) => {
+  const promise = __workflowAgent(...args)
+  void promise.catch(() => {})
+  return promise
+}
+return await (async (agent) => {
+${body}
+})(trackedAgent)
+})(__agent)`;
   const result = await new vm.Script(wrapped, { filename: `${meta.name || "workflow"}.js` }).runInContext(context);
   await Promise.allSettled([...pendingAgentRuns]);
   assertStructuredCloneable(result, "workflow result");