minimal-agent 0.13.0 → 0.14.0

package/README.md

@@ -25,7 +25,7 @@
 - **内置工具系统**：文件与终端、网页检索、媒体生成、结果交付、长期记忆、结构化提问、顾问、Computer Use 和并行 Agent。
 - **OpenAI 兼容**：Message 形状对齐 Chat Completions，一套代码接 MiniMax / 火山 ARK / DeepSeek / OpenAI / Moonshot…
 - **Skills 系统**：放一个 `SKILL.md` 就能扩展能力，运行时实时扫描注入 prompt，改文件即生效
-- **插件系统**：`plugins/<id>/` drop-in，自带 `/workflow`（YAML 工作流引擎，支持 while 循环 + 验证门 + fresh_context）
+- **插件系统**：`plugins/<id>/` drop-in，自带 `/workflow`（代码编排工作流引擎——工作流是一个目录，入口 `workflow.mjs` 用 JS 原生控制流编排 agent）
 - **自动上下文压缩**：接近上限时把旧对话压成摘要，保留系统提示 + 摘要 + 最近几条
 - **多 session + 归档**：同一工作目录多个并行会话，`/new` 归档、`/restore` 恢复
 - **Markdown 长期记忆**：全局人格与偏好、按工作目录隔离的项目记忆，可通过自然语言新增、更新、召回和删除
@@ -116,7 +116,7 @@ minimal-agent -p --output-format json "做点事"           # 一行结构化结
 | `-v` / `--verbose` | stderr 显示工具调用、压缩等过程 |
 | `-d <dir>` / `--cwd <dir>` | 指定工作目录（不存在自动创建），隔离文件视图与会话 |
 | `--output-format <text\|json>` | `text`（默认，纯文本答案）/ `json`（一行结局契约） |
-| `--max-turns <n>` | 最大工具循环轮数（防失控，默认 50） |
+| `--max-turns <n>` | 最大工具循环轮数（防失控，默认 200） |
 | `-V` / `--version` · `-h` / `--help` | 版本 / 帮助 |
 
 **`--output-format json` 结局契约**（供宿主程序可靠 spawn）：
@@ -160,7 +160,7 @@ minimal-agent -p --output-format json "做点事"           # 一行结构化结
 - **Skills**：每个 `skills/<name>/SKILL.md`（带 frontmatter）。运行时实时扫描注入 prompt，prompt 体按需懒加载。
   cwd 优先、包内 fallback，用户可在自己项目里覆盖或新增。内置 20+ 个（`/init`、`/config`、文档生成、设计等）。
 - **插件**（`plugins/<id>/`，drop-in，`src/` 一行不改）：
-  - **`/workflow` · `/workflows`**（workflow-runner）—— YAML 工作流引擎，13 种 step（tool/llm/skill/agent + assert/verify/set/branch/loop/break/continue/echo/pause），支持 while 循环 + fresh_context + 验证门。内置 `ralph-loop` 等工作流定义
+  - **`/workflow` · `/workflows`**（workflow-runner）—— 代码编排工作流引擎。一个工作流 = 一个目录（`workflows/<名字>/`），入口 `workflow.mjs` 是真实 ESM 模块（`export default async function run(wf)`），控制流直接用 JS 原生的 `if`/`for`/`while`/带标签 `break`/`try`，引擎提供一个分组能力对象 `wf`（`wf.model` `wf.tools` `wf.exec` `wf.fs` `wf.flow` `wf.check` `wf.state` `wf.output`）并负责断点续跑。内置 `plan` / `research` / `ralph-loop` 等工作流
 - **可视化编辑器**：`../minimal-workflow/` 子项目（与本仓库平级，Bun + Vite + React Flow）拖拽编排 workflow YAML（不属于 npm 发布物）。
 
 ---
@@ -193,12 +193,13 @@ bun run start          # 运行（= bun run src/main.tsx）
 bun run dev            # watch 热重载
 bun test               # 跑所有测试
 bun run typecheck      # tsc --noEmit
-bun run build          # tsc --build → src/*.js + plugins/*.js（npm 发布用）
+bun run build          # 隔离验证 npm 编译，结束后自动清理原地产物
 bun run clean          # 删除原地编译产物
 ```
 
 格式/检查用 **Biome**（2 空格缩进、单引号、80 列）。模块解析 NodeNext：源码 import 统一写 `.js` 后缀，
-dev 下 Bun 透明回退到 `.ts` 兄弟，发布前 `tsc --build` 原地产出 `.js`。
+dev 下 Bun 透明回退到 `.ts` 兄弟；`prepack` 临时原地产出 `.js`，
+`postpack` 随即清理，避免生成文件遮蔽后续源码修改。
 
 ## 架构速览
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-agent",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Bun-first 的本地 Agent 内核，支持工具、插件、工作流、上下文压缩、长期记忆与 OpenAI 兼容接口；Tauri 桌面宿主和 Node.js npm 发布可复用同一内核",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Bill Wang <leiwang0359@gmail.com>",
@@ -30,6 +30,14 @@
     "minimal-agent": "src/main.js"
   },
   "exports": {
+    "./lan-discovery": {
+      "types": "./src/net/lanDiscovery.ts",
+      "default": "./src/net/lanDiscovery.ts"
+    },
+    "./task-flow": {
+      "types": "./src/collaboration/taskFlow.ts",
+      "default": "./src/collaboration/taskFlow.ts"
+    },
     "./protocol": {
       "types": "./src/web/protocol.ts",
       "bun": "./src/web/protocol.ts",
@@ -55,6 +63,21 @@
       "bun": "./src/config/configDiagnostics.ts",
       "default": "./src/config/configDiagnostics.js"
     },
+    "./config-defaults": {
+      "types": "./src/config/configDefaults.ts",
+      "bun": "./src/config/configDefaults.ts",
+      "default": "./src/config/configDefaults.js"
+    },
+    "./model-ref": {
+      "types": "./src/modelRef.ts",
+      "bun": "./src/modelRef.ts",
+      "default": "./src/modelRef.js"
+    },
+    "./online-tool-contract": {
+      "types": "./src/team/onlineToolContract.ts",
+      "bun": "./src/team/onlineToolContract.ts",
+      "default": "./src/team/onlineToolContract.js"
+    },
     "./memory-service": {
       "types": "./src/memory/memoryService.ts",
       "bun": "./src/memory/memoryService.ts",
@@ -75,6 +98,26 @@
       "bun": "./src/runtime/agentRuntimeContext.ts",
       "default": "./src/runtime/agentRuntimeContext.js"
     },
+    "./image-resolver": {
+      "types": "./src/images/imageResolver.ts",
+      "bun": "./src/images/imageResolver.ts",
+      "default": "./src/images/imageResolver.js"
+    },
+    "./computer-intent": {
+      "types": "./src/tools/computeruse/computerIntent.ts",
+      "bun": "./src/tools/computeruse/computerIntent.ts",
+      "default": "./src/tools/computeruse/computerIntent.js"
+    },
+    "./goal-runtime": {
+      "types": "./src/goal/index.ts",
+      "bun": "./src/goal/index.ts",
+      "default": "./src/goal/index.js"
+    },
+    "./goal-status": {
+      "types": "./src/goal/statusMapping.ts",
+      "bun": "./src/goal/statusMapping.ts",
+      "default": "./src/goal/statusMapping.js"
+    },
     "./provider-presets": {
       "types": "./src/cli/wizards/providerPresets.ts",
       "bun": "./src/cli/wizards/providerPresets.ts",
@@ -99,7 +142,9 @@
     "src/**/*.d.ts",
     "plugins/**/*.ts",
     "plugins/**/*.js",
+    "plugins/**/*.mjs",
     "plugins/**/*.d.ts",
+    "plugins/**/*.d.mts",
     "plugins/**/.claude-plugin/**",
     "plugins/**/commands/**",
     "plugins/**/hooks/**",
@@ -118,26 +163,36 @@
   "scripts": {
     "start": "bun run clean && bun run src/main.tsx",
     "dev": "bun run clean && bun --watch src/main.tsx",
-    "build": "tsc --build",
+    "build": "bun scripts/build-npm.ts",
+    "build:emit": "tsc --build",
     "clean": "bun scripts/clean-build.ts",
     "check:build-artifacts": "bun scripts/check-build-artifacts.ts",
-    "test": "bun run clean && bun test",
+    "test": "bun run clean && bun run test:unit && bun run test:bench",
+    "test:unit": "bun test '--path-ignore-patterns=**/browserBench*'",
+    "test:bench": "bun test test/browserBench.test.ts",
     "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
     "verify-all": "bun scripts/verify-all.ts",
     "eval:harness": "bun scripts/eval-harness.ts",
     "compile:green": "bun scripts/build-green.ts",
     "compile:green:host": "bun scripts/build-green.ts --host",
     "doc:gen": "node doc/scripts/gen-pptx.mjs",
-    "prepublishOnly": "bun run clean && bun run build"
+    "prepack": "bun scripts/build-npm.ts --for-pack",
+    "postpack": "bun run clean",
+    "prepublishOnly": "bun run typecheck"
   },
   "dependencies": {
+    "@xmldom/xmldom": "^0.9.12",
     "ccxt": "^4.5.58",
     "diff": "^8.0.2",
+    "docx": "^9.7.1",
     "fast-glob": "^3.3.2",
+    "fflate": "^0.8.3",
+    "heic-convert": "^2.1.0",
     "ink": "^5.0.1",
     "marked": "^18.0.6",
     "pdfjs-dist": "^6.2.108",
     "react": "^18.3.1",
+    "sharp": "^0.34.5",
     "turndown": "^7.2.4",
     "vscode-jsonrpc": "^8.2.1",
     "yaml": "^2.9.0",
@@ -145,6 +200,7 @@
     "zod-to-json-schema": "^3.25.2"
   },
   "devDependencies": {
+    "@types/heic-convert": "^2.1.1",
     "@types/node": "^20.14.0",
     "@types/react": "^18.3.0",
     "bun-types": "^1.3.13",

package/plugins/computer_use/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "computer-use",
   "version": "0.1.0",
-  "description": "桌面操作的应用说明书与诊断命令面。说明书住在 app/，由内核 ComputerUse 工具强制注入；本插件提供 /computeruse 与 /cu 的确定性命令（状态、体检、说明书、采集、遥测、审计、观测）。",
+  "description": "桌面操作的应用说明书与诊断命令面。说明书位于 app/，配合宿主按需提供的桌面操作能力；本插件提供 /computeruse 与 /cu 的确定性命令（状态、体检、说明书、采集、遥测、审计、观测）。",
   "appManuals": "app"
 }

package/plugins/cron-runner/src/commands.js

@@ -273,16 +273,16 @@ function helpText() {
     return [
         '用法：',
         '/cron 120m 整理最近 AI 新闻',
-        '/cron 1d 整理每日国际新闻 /workflow daily-news.yaml 生成中文新闻稿',
-        '/cron 1m 检查学生作业 workflow inspect-homework.yaml 摄像头画面在 camera.jpg',
+        '/cron 1d 整理每日国际新闻 /workflow research 今天的国际 AI 大事',
+        '/cron 1m 检查学生作业 workflow plan 摄像头画面在 camera.jpg',
         '/cron 每天 6:07 写国际 AI 晨间简报',
         '/cron 工作日 6:07 写过去 48 小时国际 AI 大事',
         '/cron 每周一 6:07 整理国际 AI 超级个体创业案例',
         '/cron create --name "晨间简报" --cron "7 6 * * 2-6,0" --prompt "写国际 AI 简报"',
         '/cron create --name "提醒" --cron "5 13 * * *" --prompt "执行提醒" --once',
         '/cron create --name "周报" --cron "7 6 * * 1" --workflow "plan \\"整理周报\\"" --permanent',
-        '/cron create --name "定时PPT" --cron "0 */2 * * *" --workflow "ppt.yaml 做个X方案" --max-runs 5',
-        '/cron create --name "独立日报" --cron "7 6 * * *" --workflow "daily-news.yaml" --fresh-session',
+        '/cron create --name "定时调研" --cron "0 */2 * * *" --workflow "research 竞品动态" --max-runs 5',
+        '/cron create --name "独立日报" --cron "7 6 * * *" --workflow "research 今日要闻" --fresh-session',
         '/cron list',
         '/cron pause <id>',
         '/cron resume <id>',

package/plugins/cron-runner/src/commands.ts

@@ -299,16 +299,16 @@ function helpText(): string {
   return [
     '用法：',
     '/cron 120m 整理最近 AI 新闻',
-    '/cron 1d 整理每日国际新闻 /workflow daily-news.yaml 生成中文新闻稿',
-    '/cron 1m 检查学生作业 workflow inspect-homework.yaml 摄像头画面在 camera.jpg',
+    '/cron 1d 整理每日国际新闻 /workflow research 今天的国际 AI 大事',
+    '/cron 1m 检查学生作业 workflow plan 摄像头画面在 camera.jpg',
     '/cron 每天 6:07 写国际 AI 晨间简报',
     '/cron 工作日 6:07 写过去 48 小时国际 AI 大事',
     '/cron 每周一 6:07 整理国际 AI 超级个体创业案例',
     '/cron create --name "晨间简报" --cron "7 6 * * 2-6,0" --prompt "写国际 AI 简报"',
     '/cron create --name "提醒" --cron "5 13 * * *" --prompt "执行提醒" --once',
     '/cron create --name "周报" --cron "7 6 * * 1" --workflow "plan \\"整理周报\\"" --permanent',
-    '/cron create --name "定时PPT" --cron "0 */2 * * *" --workflow "ppt.yaml 做个X方案" --max-runs 5',
-    '/cron create --name "独立日报" --cron "7 6 * * *" --workflow "daily-news.yaml" --fresh-session',
+    '/cron create --name "定时调研" --cron "0 */2 * * *" --workflow "research 竞品动态" --max-runs 5',
+    '/cron create --name "独立日报" --cron "7 6 * * *" --workflow "research 今日要闻" --fresh-session',
     '/cron list',
     '/cron pause <id>',
     '/cron resume <id>',

package/plugins/workflow-runner/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "workflow-runner",
-  "version": "0.1.0",
-  "description": "YAML workflow DAG executor for minimal-agent. Provides /workflow and /workflows commands."
+  "version": "1.0.0",
+  "description": "Code-orchestration workflow engine for minimal-agent. Each workflow is a directory with a workflow.mjs script. Provides /workflow and /workflows."
 }

package/plugins/workflow-runner/commands/workflow.md

@@ -1,105 +1,72 @@
 ---
-description: 运行 YAML 工作流（DAG 执行器）。位置参数按 inputs 声明顺序映射，或用 --input k=v 显式传参
-argument-hint: <name> [val ...] [--input key=value ...]
+description: 运行一个受信任 ESM 工作流。位置参数按 meta.inputs 声明顺序映射，或用 --input k=v 显式传参
+argument-hint: <name> [值 ...] [--input key=value ...]
 ---
 
 # /workflow
 
-本命令由 workflow-runner 插件接管（plugin.ts.runCommand），不会把 prompt 喂给 LLM。
-直接调用插件内置的 YAML DAG 执行器，按 steps 顺序运行 tool / llm / skill / agent / assert / branch / loop 等节点。
+由 workflow-runner 插件直接执行 `workflows/<name>/workflow.mjs`，不会把命令本身交给
+LLM。设计原则是“轻引擎、重工作流”：Runner 只提供通用执行、流控、恢复、资源、组合
+和观测能力；阶段划分、领域判断、重试策略与产物组织全部留在工作流目录。
 
-用法示例：
+工作流是受信任的本地 ESM 代码，不是安全沙箱。
 
-  /workflow hello-workflow alice                            位置参数：直接传 inputs 声明里第一个 input
-  /workflow hello-workflow alice zh                         多个位置参数：按 inputs 顺序填
-  /workflow hello-workflow.yaml alice                       .yaml 后缀可省（带也认）
-  /workflow hello-workflow --input name=alice --input lang=zh   显式 KV
-  /workflow hello-workflow alice --input lang=zh            混用：位置填 name，--input 填 lang
-
-规则：
-- 位置参数按 yaml 文件 `inputs:` 数组的**声明顺序**映射（不是字段名顺序）。多 input workflow 推荐 `--input key=value` 显式 KV，不易出错
-- `--input k=v` 显式 KV 优先级高于位置参数；位置参数对应的 input 已被 KV 占位时，位置参数被丢弃并 stderr 打 warning
-- 多余的位置参数（超过 inputs 声明数量）被丢弃并 stderr 打 warning，不影响 workflow 执行
-- 值含空格时用引号：`/workflow xxx "AI 教程 进阶"`
-
-## agent 节点：把一步交给会随机应变的子 agent
-
-大多数 step 是确定性的（`tool` 调一个原子工具、`llm` 单轮生成）。但有些步骤本质是开放式的——
-「把 ./data 下最新的 csv 整理成 summary.md」这种，怎么做得看现场。这时用 `agent:` 节点：inline 写一句
-任务描述，工作流就地起一个**有界 TAOR 子 agent**（思考 → 用工具 → 观察 → 反思 → 再来），让它随机应变
-把这一步要的结果做出来，产出经验证后 `capture` 给下游。这就是「受工作流指导的 TAOR」——happy path 仍是
-确定性骨架，只在你显式声明的节点上注入完整 agency。
-
-```yaml
-steps:
-  - id: summarize
-    agent: "把 ./data 下最新的 csv 读出来，整理成一份 markdown 摘要写到 summary.md"
-    capture: { content: summary }     # agent 的最终产出存进变量 summary
-  - id: gate
-    type: assert
-    condition: "fileExists('summary.md')"
+```text
+/workflow my-flow "一句话需求"
+/workflow my-flow --input topic=AI --input pages=12
+/workflows
 ```
 
-`agent:` 的配套字段（全部复用现有字段，都可选）：
-
-- `allowed_tools: [Read, Write]` —— 收窄它能用的工具；**缺省给全量工具**（要真 agency）。
-- `output_schema: {...}` —— 要求结构化产出（provider-native JSON Schema），按字段 `capture`。
-- `context_files: [{ path, hint }]` —— 列出可读文件让它按需 Read（不 inline 内容）。
-- `maxTurns: <n>` —— 子循环最大轮数，默认 25。
-- `capture` / `when` / `onError` —— 与其它动作 step 一致（agent 节点也能 `onError: recover` 被再救一次）。
-
-`agent` vs `skill`：`agent` 是 **inline、一次性**的有界 TAOR 子循环（委托 runQuery，轻、收敛快、产出受验证闸门把关）；
-`skill` 是跑一个**外部 SKILL.md 定义、可复用**的完整 agent（runQuery）。需要复用同一套能力用 `skill`，
-临时让某步「自己想办法」用 `agent`。
-
-**信任边界 / 不伪造**：agent 节点与 `onError: recover` 共用同一套系统提示词纪律——内置安全护栏（最小动作、
-优先可逆、不碰工作目录外、不删无关数据）、收尾前自我验证、**严禁伪造产出**；做不成就诚实放弃（抛错走 `onError`）。
-默认握全量工具，信任边界同 `skill:`——「运行一条 workflow 即信任它」。
+## 目录与入口
 
-## 节点失败怎么办：onError（指导 ↔ 自主 旋钮）
-
-传统工作流的痛点：某个节点一失败、或撞上预料之外的情况，整条流程就崩、停摆。
-每个**动作 step**（tool / llm / skill / agent / assert）可声明 `onError`，决定失败时的行为，
-让一条工作流在「刚性确定」和「随机应变」之间按节点滑动：
-
-- `halt`（**默认**）：节点失败 → 整条工作流停、报错。最刚性、最可审计。
-- `continue`：跳过该节点、继续往下。⚠️ 下游若用 `capture` 依赖它会拿到空值，慎用。
-- `recover`（**自适应恢复**）：失败时**不立刻停**，而是临时起一个**有界 agent**，带着
-  「工作流目标 + 这个节点本来要做什么 + 错在哪 + 当前已知变量 + 下游 capture 契约」去**随机应变**——
-  它会先诊断根因，再换路径 / 换命令 / 先读后写 / 补齐前置条件，**并在收尾前自我验证**产出确实满足意图，
-  想办法把这一步要的**结果**做出来。
-  **救回** → 用同一个 `capture` 绑定结果、继续走正常流程；**救不回** → 它会**诚实放弃**（绝不伪造假结果），
-  工作流带原因报错停止（错误信息形如「自适应恢复未成功：<原因>」）。这是「确定性工作流 × 会随机应变的 agent」的结合点。
-
-`recover` 的配套字段（都可选）：
-
-- `recover_hint: "<提示>"` —— 给恢复 agent 的提示（支持 `${var}` 插值），如 `"端口被占就换 3001 重试"`。
-- `allowed_tools: [Read, Bash]` —— 收窄恢复 agent 能用的工具；**缺省给全量工具**。
-- `maxTurns: <n>` —— 恢复子循环最大轮数，默认 25（够「诊断 + 探查 + 动手 + 验证」一圈）。
-
-示例：
+```text
+workflows/<名字>/
+├── workflow.mjs
+├── scripts/*.mjs
+├── prompts/
+├── assets/
+└── README.md
+```
 
-```yaml
-steps:
-  - id: start_server
-    tool: Bash
-    args: { command: "node server.js" }
-    onError: recover
-    recover_hint: "端口被占就换一个端口重试"
-    capture: { content: server_log }
+```js
+export const meta = {
+  apiVersion: 2,
+  description: '审计路由的鉴权缺失',
+  inputs: [{ name: 'dir', required: true }],
+  dependencies: [],
+  artifacts: ['out/audit.json'],
+};
+
+export default async function run(wf) {
+  const files = JSON.parse(await wf.tools.call('Glob', {
+    pattern: `${wf.input.values.dir}/**/*.ts`,
+  }));
+  const batch = await wf.flow.pipeline(files, {
+    label: '逐文件审计',
+    concurrency: 4,
+    errorMode: 'collect',
+    stages: [async (_value, file) => wf.model.agent(`审计 ${file} 的鉴权检查`)],
+  });
+  await wf.fs.writeJson('out/audit.json', batch);
+  wf.output.artifact('out/audit.json');
+  wf.output.message('审计完成');
+  return batch;
+}
 ```
 
-注意事项：
+工作流可原生导入相对模块和 `node:` 内置模块。确定性纯计算直接 `import`；需要独立
+进程或第三方运行时的脚本使用 `wf.exec.file()`。并行扇出使用
+`wf.flow.pipeline()`，不要用无界 `Promise.all()` 绕过运行时调度。
+
+公开能力按 `wf.input/runtime/model/tools/exec/fs/flow/check/state/output` 分组；完整签名
+以 `skills/workflow-creator/references/api.md` 为准。
 
-- `onError` **只作用于动作 step**。控制流节点（branch / loop 的条件或结构错误、
-  以及 `when` 表达式错误）**始终 halt** —— 那类是「作者写错了」，不是「运行期意外」，不走恢复。
-- `continue` vs `recover`：前者「放弃这步、盲目往下」，后者「想办法把这步做成、保住下游」。
-  要扛住「预料之外」的情况，用 `recover`。
-- **信任边界**：恢复 agent 默认握有全量工具，与 `skill:` 节点一致——「运行一条 workflow 即信任它」。
-  不信任来源的 yaml 本就不该跑。
-- **不伪造 / 诚实失败**：恢复 agent 的系统提示词内置安全护栏（只做最小必要动作、优先可逆、不碰工作目录外、
-  不删无关数据）并**严禁编造假结果**——它要么交付经自我验证的真产出，要么显式放弃让工作流诚实 halt。
-  框架侧另有验证闸门：空产出 / 显式放弃一律**不绑 `capture`、不放行下游**，杜绝把脏值喂给后续步骤。
-- `recover` 是 opt-in 的：确定性 / 可审计正是工作流的价值，不默认抹掉；由作者按节点决定授予多少「自主权」。
+## 约束与恢复
 
-输入 /workflows 查看可用工作流列表。
+- `meta` 必须是纯字面量，且包含 `apiVersion: 2`；入口必须默认导出 `run(wf)`。
+- 模块级不得保存可变的每次运行状态；并发实例的状态全部放在 `run()` 内或 `wf` 中。
+- 模型、工具、进程、询问和子工作流进入 journal；文件系统读写每次观察真实磁盘并
+  采用原子、幂等操作。
+- 运行时产物用 `wf.output.artifact(path)` 动态登记。
+- 子工作流必须静态列在 `meta.dependencies`，通过 `wf.flow.child()` 调用。
+- 工作流 bundle 或 API 版本变化会归档旧断点，不重放旧执行结果。

package/plugins/workflow-runner/commands/workflows.md

@@ -1,10 +1,10 @@
 ---
-description: 列出当前 cwd 与插件包内可用的 YAML 工作流
+description: 列出可用工作流（代码形态），并报出写错未能载入的那些
 ---
 
 # /workflows
 
-由 workflow-runner 插件接管（plugin.ts.runCommand），扫描 cwd/workflows/ 与
-packageRoot/workflows/（getResourceSearchPaths 双源，cwd 优先）下的 *.yaml，把名称 + 一行描述列出来。
+由 workflow-runner 插件接管，直接扫描 `workflows/*/workflow.mjs` 并列出，不喂给 LLM。
 
-提示：用 `agent:` 节点可把开放式的一步交给有界 TAOR 子 agent 随机应变完成；用 `onError: recover` 可让失败节点交给恢复 agent 自适应救回（而非整条崩停）。二者共用同一套「自我验证 / 不伪造」纪律——详见 `/workflow` 命令说明。
+写错的工作流会被**如实报出**而不是从列表里消失——「我的工作流不见了」和
+「我的工作流写错了」排查成本差一个数量级。

package/plugins/workflow-runner/plugin.js

@@ -1,34 +1,44 @@
 /**
  * ============================================================
- *  plugins/workflow-runner/plugin.ts
+ *  plugins/workflow-runner/plugin.ts —— 代码编排引擎的插件入口
  * ------------------------------------------------------------
- *  workflow-runner 插件入口。接管 /workflow 与 /workflows 两个命令的执行：
- *  不走声明式 markdown→LLM 通道，而是直接调插件内置的 YAML DAG 执行器。
+ *  接管 /workflow 与 /workflows：不走声明式 markdown→LLM 通道，直接执行
+ *  `workflows/<name>/workflow.mjs`。
  *
- *  执行器与全部依赖都住在本插件目录 ./src/，外部 src/ 一行不改。
- *  插件只通过 src/plugin-sdk.ts 取框架运行时（runQuery / chat / executeTool 等）。
- *
- *  契约：default export 一个 PluginApi 对象。框架 pluginLoader 会按 pluginRoot
- *  缓存这次 import，所以 cold start 后 dynamic import 只跑一次。
+ *  契约：default export 一个 PluginApi。框架按 pluginRoot 缓存这次 import。
  * ============================================================
  */
 import { ALL_TOOLS, buildTransientPromptBundle, createAgentRuntimeContext, derivePromptCacheContext, filterToolsForRuntime, getWorkingDir, } from '../../src/plugin-sdk.js';
+import { discoverWorkflows } from './src/discovery.js';
 import { runWorkflowFromCommand, runWorkflowsList } from './src/index.js';
 const api = {
+    async resolveSlashFallback(commandName, args, { cwd }) {
+        const { workflows } = await discoverWorkflows(cwd);
+        const exact = workflows.find((workflow) => workflow.name === commandName);
+        const matched = exact ??
+            workflows.find((workflow) => workflow.name.toLowerCase() === commandName.toLowerCase());
+        if (!matched)
+            return null;
+        return {
+            commandName: 'workflow',
+            args: `${matched.name}${args ? ` ${args}` : ''}`,
+            message: `▸ /${commandName} → 工作流「${matched.name}」`,
+        };
+    },
     async *runCommand(commandName, args, ctx) {
+        const cwd = getWorkingDir();
         if (commandName === 'workflows') {
-            yield* runWorkflowsList();
+            yield* runWorkflowsList(cwd);
             return;
         }
         if (commandName === 'workflow') {
-            const cwd = getWorkingDir();
             const workflowRuntime = createAgentRuntimeContext({
                 ...(ctx.runtimeContext ?? {
                     profile: 'main',
                     interactiveAsk: false,
                 }),
-                // The command runs inside the workflow's async-scoped workspace. A
-                // parent Desktop/CLI runtime may have been created before that scope.
+                // 命令跑在工作流自己的 async 作用域里；父级 Desktop/CLI runtime 可能是
+                // 在那个作用域建立之前创建的，cwd 要以这里为准。
                 cwd,
                 surface: 'workflow',
                 owner: ctx.runtimeContext?.owner ?? 'untrusted',
@@ -78,8 +88,9 @@ const api = {
                     sessionId: workflowRuntime.sessionId,
                     memoryAccess: workflowRuntime.memoryAccess,
                 },
-                // 宿主授权上下文原样带上；引擎按各步 `uses:` 切片后才转给工具，不整份下发。
+                // 宿主授权上下文原样带上；由调用点按显式声明切片后才转给工具。
                 host: ctx.host,
+                inputResources: ctx.inputResources,
                 transientContext: ctx.transientContext,
                 transientBundle,
                 promptCache: derivePromptCacheContext(ctx.promptCache, `workflow:${args.trim() || 'interactive'}`),

package/plugins/workflow-runner/plugin.ts

@@ -1,15 +1,11 @@
 /**
  * ============================================================
- *  plugins/workflow-runner/plugin.ts
+ *  plugins/workflow-runner/plugin.ts —— 代码编排引擎的插件入口
  * ------------------------------------------------------------
- *  workflow-runner 插件入口。接管 /workflow 与 /workflows 两个命令的执行：
- *  不走声明式 markdown→LLM 通道，而是直接调插件内置的 YAML DAG 执行器。
+ *  接管 /workflow 与 /workflows：不走声明式 markdown→LLM 通道，直接执行
+ *  `workflows/<name>/workflow.mjs`。
  *
- *  执行器与全部依赖都住在本插件目录 ./src/，外部 src/ 一行不改。
- *  插件只通过 src/plugin-sdk.ts 取框架运行时（runQuery / chat / executeTool 等）。
- *
- *  契约：default export 一个 PluginApi 对象。框架 pluginLoader 会按 pluginRoot
- *  缓存这次 import，所以 cold start 后 dynamic import 只跑一次。
+ *  契约：default export 一个 PluginApi。框架按 pluginRoot 缓存这次 import。
  * ============================================================
  */
 
@@ -22,24 +18,41 @@ import {
   filterToolsForRuntime,
   getWorkingDir,
 } from '../../src/plugin-sdk.js';
+import { discoverWorkflows } from './src/discovery.js';
 import { runWorkflowFromCommand, runWorkflowsList } from './src/index.js';
 
 const api: PluginApi = {
+  async resolveSlashFallback(commandName, args, { cwd }) {
+    const { workflows } = await discoverWorkflows(cwd);
+    const exact = workflows.find((workflow) => workflow.name === commandName);
+    const matched =
+      exact ??
+      workflows.find(
+        (workflow) => workflow.name.toLowerCase() === commandName.toLowerCase(),
+      );
+    if (!matched) return null;
+    return {
+      commandName: 'workflow',
+      args: `${matched.name}${args ? ` ${args}` : ''}`,
+      message: `▸ /${commandName} → 工作流「${matched.name}」`,
+    };
+  },
   async *runCommand(commandName, args, ctx) {
+    const cwd = getWorkingDir();
+
     if (commandName === 'workflows') {
-      yield* runWorkflowsList();
+      yield* runWorkflowsList(cwd);
       return;
     }
 
     if (commandName === 'workflow') {
-      const cwd = getWorkingDir();
       const workflowRuntime = createAgentRuntimeContext({
         ...(ctx.runtimeContext ?? {
           profile: 'main' as const,
           interactiveAsk: false,
         }),
-        // The command runs inside the workflow's async-scoped workspace. A
-        // parent Desktop/CLI runtime may have been created before that scope.
+        // 命令跑在工作流自己的 async 作用域里；父级 Desktop/CLI runtime 可能是
+        // 在那个作用域建立之前创建的，cwd 要以这里为准。
         cwd,
         surface: 'workflow',
         owner: ctx.runtimeContext?.owner ?? 'untrusted',
@@ -72,6 +85,7 @@ const api: PluginApi = {
             currentUserInput: args,
           },
         }).catch(() => undefined));
+
       yield* runWorkflowFromCommand(args, {
         provider: ctx.provider,
         history: ctx.history,
@@ -91,8 +105,9 @@ const api: PluginApi = {
           sessionId: workflowRuntime.sessionId,
           memoryAccess: workflowRuntime.memoryAccess,
         },
-        // 宿主授权上下文原样带上；引擎按各步 `uses:` 切片后才转给工具，不整份下发。
+        // 宿主授权上下文原样带上；由调用点按显式声明切片后才转给工具。
         host: ctx.host,
+        inputResources: ctx.inputResources,
         transientContext: ctx.transientContext,
         transientBundle,
         promptCache: derivePromptCacheContext(