@mzzsfy/dsh-rs-workflow 1.0.0 → 1.0.1

package/engine/flow-exec.js

@@ -0,0 +1,23 @@
+// 单批次执行器脚本:宿主 workflowEngine 裸 vm body,globals 仅 agent/parallel/pipeline/phase/log/args,无模块语法
+const BATCH_PHASE = '若水批次'
+const NULL_OUTPUT_ERROR = '子代理未提交结构化产出'
+
+const errorText = (error) => String((error && error.message) || error)
+const settle = (callId, outputs) => outputs === null
+  ? { callId, ok: false, error: NULL_OUTPUT_ERROR }
+  : { callId, ok: true, outputs }
+
+const { calls } = args
+// v5 引擎 parallel 契约:零参 thunk 数组(每个 thunk 失败→null),不再是 promise 数组;
+// agent() options 键存在则值必须是 JSON(undefined 不行),缺省键须整键省略
+const dispatches = calls.map((call) => () => agent(call.prompt, {
+  label: call.label,
+  phase: BATCH_PHASE,
+  ...call.schema !== undefined ? { schema: call.schema } : {},
+  ...call.provider !== undefined ? { provider: call.provider } : {},
+  ...call.model !== undefined ? { model: call.model } : {},
+}).then((outputs) => settle(call.callId, outputs))
+  .catch((error) => ({ callId: call.callId, ok: false, error: errorText(error) })))
+
+const results = await parallel(dispatches)
+return { results }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-rs-workflow",
   "description": "若水工作流设置面:流程模板管理与工作位/预算配置(模板编辑/校验/配置读写)。编排运行时按 v5 设计(docs/rsww-v5/)另行实现。",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -28,6 +28,8 @@
   "files": [
     "lib",
     "src",
+    "engine",
+    "preset",
     "cordis.patch.yml",
     "README.md"
   ],

package/preset/rs-workflow/agent.cordis.yml

@@ -0,0 +1,177 @@
+# The `rs-workflow` agent preset: 若水工作流(v5,主循环协作编排)。
+#
+# 本文件是释放骨架源:release 生成器把它作为唯一源生成 rs-<id> 模式组合
+# (运行时仅改写 orchestrator 行的 templateId 锚定),不在包内被宿主装载。
+#
+# 基底是 `standard` 全功能编码代理行集,差异:
+#   1. persona 换成流程模式纪律 v5(人机接口+受约束规划者,任务交付由编排子代理承担);
+#   2. delegation 组内 rs-workflow-orchestrator 工具行与 template-tool 行;
+#   3. 无 report 行(trace 事件 + run-store 取代);plan-mode 组移除(规划在编排内)。
+
+# ── identity ────────────────────────────────────────────────────────────────
+
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    prefix: |-
+      你是"若水工作流"会话代理,由 {{model}} 模型驱动。你负责人机协作与编排调度;
+      任务交付由流程引擎接管下的子代理完成,你不直接产出交付物。
+      职责判据:
+      1. 纯会话内请求(问答、解释、讨论,不产生文件)→ 直接答复,不起编排;
+      2. 凡需新建或修改交付物文件(代码、页面、脚本、文档、配置,无论大小与步骤数,例如"写个贪吃蛇html")
+         → 必须调用 rs_workflow_start,提交结构化规划(steps 各步要点与验收口径);禁止以"一句话能答、
+         改动小"为由绕开编排自行产出文件;此通道无豁免:规划被拒按 errors 修正重交,不许改道自行完成;
+      3. 编排运行中你只被段结束通知或用户消息唤醒:任一唤醒轮先 rs_workflow_status 检查现役 run——
+         status=running 且无活跃段 job(待拉起)或 status=paused 且 awaitingResume=true(页签已发恢复)
+         时,即 rs_workflow_resume 补拉;waiting_approval 一律不补拉,轮到裁决:按模板 autoApprove 决定
+         代审或 ask_user 转呈真人,裁决经 rs_workflow_verdict 回写(autoApprove 代审 by 缺省,转呈真人
+         by=user,意见必填),裁决受理后 rs_workflow_resume 拉起下一段;
+         终态则汇报(完成经 deliverables 交付,汇报必须引用 runId 供页签核验;失败/阻塞说明卡点与建议);
+         任何交付说明若无对应 run 记录即为违规——禁止把自行产出的文件当交付物汇报;
+         用户中途纠偏经 rs_workflow_message 注入,下一步骤边界进入编排;
+      4. 你不代替子代理执行编排内步骤,不伪造产出,不跳过引擎直接交付;
+      5. 引擎不可用或编排启动失败时,不得自行完成文件类请求——向用户说明故障与已尝试的调用,
+         等待用户处置;文件交付只有 rs_workflow_ 通道,没有自行兜底。
+    suffix: Your working directory is {{cwd}}.
+
+- id: agent-instructions
+  name: '@deepseek-ai/dsh-agent-instructions'
+  config:
+    maxBytes: 65536
+
+# ── shell ───────────────────────────────────────────────────────────────────
+
+# 注:不可禁本组合 shell/fs 工具行——宿主 workflow worker 的段子代理继承组合行集,
+# 禁行使段子代理无法落盘交付物(实测证实)。主循环不写文件由 persona 判据约束,
+# 物理隔离需宿主提供 worker 行集覆写能力(外部依赖)。
+
+- id: tool-bash
+  name: '@deepseek-ai/dsh-tool-bash'
+  disabled: !!js process.platform === 'win32'
+
+- id: tool-pwsh
+  name: '@deepseek-ai/dsh-tool-pwsh'
+  disabled: !!js process.platform !== 'win32'
+
+# ── filesystem ──────────────────────────────────────────────────────────────
+
+- id: tool-fs
+  name: '@deepseek-ai/dsh-tool-fs'
+
+- id: tool-fs-search
+  name: '@deepseek-ai/dsh-tool-fs-search'
+  config:
+    sampleOverCapGlobResults: false
+
+# ── background jobs ────────────────────────────────────────────────────────
+
+- id: tool-jobs
+  name: '@deepseek-ai/dsh-tool-jobs'
+
+# ── skills ──────────────────────────────────────────────────────────────────
+
+- id: skill-filesystem
+  name: '@deepseek-ai/dsh-skill-filesystem'
+
+- id: tool-skill
+  name: '@deepseek-ai/dsh-tool-skill'
+
+# ── web ─────────────────────────────────────────────────────────────────────
+
+- id: tool-web
+  name: '@deepseek-ai/dsh-tool-web'
+  config:
+    fetch: false
+    searchTimeoutMs: 60000
+
+# ── compaction ──────────────────────────────────────────────────────────────
+
+# 编排子代理上下文较长,保留 standard 的压缩组。
+- id: compaction
+  name: cordis:group
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: compaction-basic
+      name: '@deepseek-ai/dsh-compaction-basic'
+
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+      config:
+        thresholdChars: 8192
+        headChars: 4096
+        tailChars: 1024
+
+# ── delegation and workflows ────────────────────────────────────────────────
+
+# workflowEngine 是预设私有服务(preset 组合发布全局服务会被宿主拒绝 mount),
+# 所有触达它的行共享一个 entry-local isolate realm。
+# orchestrator 行注册 rs_workflow_* 六工具(含裁决回写 rs_workflow_verdict)并经 jobs 服务拉起分段 continuable job;
+# 控制队列与 store 为普通模块单例,host/agent 行经同一 realpath 解析共享实例。
+- id: delegation
+  name: cordis:group
+  group: true
+  isolate:
+    workflowEngine: true
+  config:
+    - id: tool-subagent-control
+      name: '@deepseek-ai/dsh-tool-subagent-control'
+
+    - id: tool-subagent-list-agents
+      name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+
+    - id: tool-subagent
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: spawn
+        toolName: subagent
+        backgroundMode: continuable
+
+    - id: tool-subagent-fork
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: fork
+        toolName: subagent_fork
+        backgroundMode: continuable
+
+    - id: workflow-worker-thread
+      name: '@deepseek-ai/dsh-workflow-worker-thread'
+      config:
+        provider: spawn
+
+    - id: tool-workflow
+      name: '@deepseek-ai/dsh-tool-workflow'
+
+    - id: tool-ralph
+      name: '@deepseek-ai/dsh-tool-ralph'
+      config:
+        subagentProvider: spawn
+        maxRounds: 64
+
+    # orchestrator 工具行:模板 id 由组合名承载(rs-<id> → <id>),释放生成器按组合名写入
+    - id: rs-workflow-orchestrator
+      name: '@mzzsfy/dsh-rs-workflow'
+      config:
+        role: orchestrator
+        templateId: TPL_ANCHOR
+
+    # 模板编辑工具行:rs_workflow_template(AI 按口述逻辑生成/修改流程模板)
+    - id: rs-workflow-template-tool
+      name: '@mzzsfy/dsh-rs-workflow'
+      config:
+        role: template-tool
+
+# ── remaining model-facing rows ─────────────────────────────────────────────
+
+- id: tool-ask-user
+  name: '@deepseek-ai/dsh-tool-ask-user'
+
+- id: tool-todo
+  name: '@deepseek-ai/dsh-tool-todo'
+  config:
+    allowParallelInProgress: true

package/preset/rs-workflow/preset.yml

@@ -0,0 +1,5 @@
+name: 若水·流程编排 v5
+description: >-
+  若水工作流 v5:简单请求直接答复,复杂请求经结构化规划进入流程编排;
+  主模型作为人机接口与受约束规划者,任务交付由引擎子代理分段完成;
+  审批可代审可转呈,运行中消息注入纠偏,取消即时生效,产出与重跑/续跑在会话页签全量可查。