@fieldwangai/agentflow 0.1.149 → 0.1.154

package/README.md

@@ -65,30 +65,17 @@ npm install -g @fieldwangai/agentflow
 # Launch Web UI (port 8765)
 agentflow ui
 
-# Generate and open a single-file static preview using the platform canvas (no local server)
-agentflow flow preview ./my-flow/flow.yaml
+# Upload a Workspace graph to a server-side temporary preview project
+node skills/agentflow-cli/scripts/agentflow-cli.mjs workspace-preview \
+  --file .workspace/agentflow/pipelines/my-flow/workspace.graph.json \
+  --ttl-seconds 7200
 
-# Or run a flow directly
-agentflow apply <FlowName>
 ```
 
-From source: `git clone` → `npm install` → `npm link`.
-
-## AgentFlow Hub
+Runs are started from the Workspace graph in the Web UI, or on a schedule via a
+`workspace_scheduled_run` node.
 
-Browse, download and share community-built workflows at **[agentflow-hub.com](https://agentflow-hub.com)**.
-
-```bash
-# Browse flows from the command line
-agentflow list-remote
-
-# Download a flow
-agentflow download <slug>
-
-# Publish your flow to the Hub
-agentflow login
-agentflow publish <FlowName> --tags "migration,review"
-```
+From source: `git clone` → `npm install` → `npm link`.
 
 ## Creating Flows
 
@@ -108,25 +95,26 @@ Create a code review flow:
 4. Loop until all pass
 ```
 
-Composer auto-detects loop patterns and generates the correct control-flow nodes. Complex flows are built in three phases: topology → node details → wiring & validation (auto-repairs up to 5 times).
-
-## Running & Recovery
+Complex flows are built in three phases: topology → node details → wiring & validation (auto-repairs up to 5 times). Note the Workspace runtime executes a DAG — cyclic graphs are rejected, so describe check-then-fix work as forward steps rather than a loop.
 
-```bash
-# Execute
-agentflow apply <FlowName>
+## Running
 
-# Check status
-agentflow run-status <FlowName> <uuid>
+Runs start from the Workspace graph: open the flow in the Web UI and hit **Run**, or add a
+`workspace_scheduled_run` node for cron-driven runs. Every node's inputs, outputs and state
+are persisted under the flow's run directory.
 
-# Resume from failure
-agentflow resume <FlowName> <uuid>
+The legacy Start/End Pipeline runtime is retired — `agentflow apply` / `resume` / `replay`
+and the `/api/flow/run*` endpoints no longer execute anything.
 
-# Retry one node
-agentflow replay <FlowName> <uuid> <instanceId>
+```bash
+# Check node status of a run
+agentflow run-status <FlowName> <uuid>
 
 # View agent reasoning
 agentflow extract-thinking <FlowName> <uuid>
+
+# Validate a flow definition
+agentflow validate <FlowName>
 ```
 
 ## Skills
@@ -158,7 +146,6 @@ For example, tell Codex/Cursor: “Use `agentflow-author-flow` to generate a Flo
 |---------|-------------|
 | `list` | List all pipelines |
 | `ui` | Start Web UI |
-| `flow preview <FlowName\|flow.yaml>` | Generate a single-file static Flow preview; use `--output` to choose the HTML path |
 | `apply` | Execute flow |
 | `validate` | Validate flow structure |
 | `resume` | Resume from breakpoint |

package/README.zh-CN.md

@@ -64,30 +64,11 @@ npm install -g @fieldwangai/agentflow
 # 启动 Web UI（端口 8765）
 agentflow ui
 
-# 生成并打开平台同款画布的单文件静态预览（无需本地服务）
-agentflow flow preview ./my-flow/flow.yaml
-
-# 或直接运行流程
-agentflow apply <FlowName>
 ```
 
-从源码开发：`git clone` → `npm install` → `npm link`
-
-## AgentFlow Hub
-
-在 **[agentflow-hub.com](https://agentflow-hub.com)** 浏览、下载和分享社区工作流。
+运行从 Web UI 的 Workspace 图发起；需要定时执行时在图里加 `workspace_scheduled_run` 节点。
 
-```bash
-# 浏览社区工作流
-agentflow list-remote
-
-# 下载工作流
-agentflow download <slug>
-
-# 发布你的工作流
-agentflow login
-agentflow publish <FlowName> --tags "migration,review"
-```
+从源码开发：`git clone` → `npm install` → `npm link`
 
 ## 创建流程
 
@@ -107,25 +88,25 @@ Web UI 中 — 新建流水线 → 从面板拖节点到画布 → 连线 →
 4. 没通过就继续修，直到全过
 ```
 
-Composer 会自动识别循环模式，生成正确的控制流节点。复杂流程分三阶段构建：拓扑 → 节点详情 → 连线校验（自动修复最多 5 次）。
-
-## 运行与恢复
+复杂流程分三阶段构建：拓扑 → 节点详情 → 连线校验（自动修复最多 5 次）。注意 Workspace 运行时执行的是 DAG，有环的图会被拒绝，所以「检查—修复—复检」要描述成向前推进的步骤，而不是回环。
 
-```bash
-# 执行
-agentflow apply <FlowName>
+## 运行
 
-# 查看状态
-agentflow run-status <FlowName> <uuid>
+运行从 Workspace 图发起：在 Web UI 打开流程点 **Run**，或在图里加 `workspace_scheduled_run`
+节点做定时执行。每个节点的输入、输出与状态都会持久化到该流程的 run 目录。
 
-# 断点续跑
-agentflow resume <FlowName> <uuid>
+旧版 Start/End Pipeline 运行时已下线 —— `agentflow apply` / `resume` / `replay` 与
+`/api/flow/run*` 接口不再执行任何流程。
 
-# 重试单个节点
-agentflow replay <FlowName> <uuid> <instanceId>
+```bash
+# 查看某次运行的节点状态
+agentflow run-status <FlowName> <uuid>
 
 # 查看 agent 推理过程
 agentflow extract-thinking <FlowName> <uuid>
+
+# 校验流程定义
+agentflow validate <FlowName>
 ```
 
 ## 技能
@@ -157,7 +138,6 @@ AgentFlow 提供专用技能用于常见操作：
 |------|------|
 | `list` | 列出所有流水线 |
 | `ui` | 启动 Web UI |
-| `flow preview <FlowName\|flow.yaml>` | 生成平台同款画布的单文件静态 Flow 预览；可用 `--output` 指定 HTML |
 | `apply` | 执行流程 |
 | `validate` | 校验流程结构 |
 | `resume` | 断点续跑 |

package/agents/agentflow-node-executor-code.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-以代码实现为核心：理清需求与接口，编写或修改代码，确保可运行、通过类型检查与项目规范，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+以代码实现为核心：理清需求与接口，编写或修改代码，确保可运行、通过类型检查与项目规范，节点中如有写入文件的操作可以执行。
+
+**结果回传**：最终回复的正文就是本节点的结果，AgentFlow 会自行写入 `AGENTFLOW_RESULT_FILE`——不要自己创建该文件，也不要输出文件路径。若节点声明了额外的 output 槽，则最终**只**输出一个 agentflow envelope：
+
 ```
+---agentflow
+result: |
+  <完整结果正文，每行缩进两个空格>
+outParams:
+  <槽位名>: <短值>
+---end
+```
+
+**失败上报**：任务明确失败时，直接以非零退出码结束，或在回复中说明失败原因——不要调用任何 CLI 写状态。

package/agents/agentflow-node-executor-planning.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-先做规划（目标拆解、步骤与依赖、可选方案），再按规划执行并产出结果，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+先做规划（目标拆解、步骤与依赖、可选方案），再按规划执行并产出结果，节点中如有写入文件的操作可以执行。
+
+**结果回传**：最终回复的正文就是本节点的结果，AgentFlow 会自行写入 `AGENTFLOW_RESULT_FILE`——不要自己创建该文件，也不要输出文件路径。若节点声明了额外的 output 槽，则最终**只**输出一个 agentflow envelope：
+
 ```
+---agentflow
+result: |
+  <完整结果正文，每行缩进两个空格>
+outParams:
+  <槽位名>: <短值>
+---end
+```
+
+**失败上报**：任务明确失败时，直接以非零退出码结束，或在回复中说明失败原因——不要调用任何 CLI 写状态。

package/agents/agentflow-node-executor-requirement.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-侧重需求理解与拆解，按上述任务完成执行，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+侧重需求理解与拆解，按上述任务完成执行，节点中如有写入文件的操作可以执行。
+
+**结果回传**：最终回复的正文就是本节点的结果，AgentFlow 会自行写入 `AGENTFLOW_RESULT_FILE`——不要自己创建该文件，也不要输出文件路径。若节点声明了额外的 output 槽，则最终**只**输出一个 agentflow envelope：
+
 ```
+---agentflow
+result: |
+  <完整结果正文，每行缩进两个空格>
+outParams:
+  <槽位名>: <短值>
+---end
+```
+
+**失败上报**：任务明确失败时，直接以非零退出码结束，或在回复中说明失败原因——不要调用任何 CLI 写状态。

package/agents/agentflow-node-executor-test.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-侧重测试与验证，执行并产出结果，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+侧重测试与验证，执行并产出结果，节点中如有写入文件的操作可以执行。
+
+**结果回传**：最终回复的正文就是本节点的结果，AgentFlow 会自行写入 `AGENTFLOW_RESULT_FILE`——不要自己创建该文件，也不要输出文件路径。若节点声明了额外的 output 槽，则最终**只**输出一个 agentflow envelope：
+
 ```
+---agentflow
+result: |
+  <完整结果正文，每行缩进两个空格>
+outParams:
+  <槽位名>: <短值>
+---end
+```
+
+**失败上报**：任务明确失败时，直接以非零退出码结束，或在回复中说明失败原因——不要调用任何 CLI 写状态。

package/agents/agentflow-node-executor-ui.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-理解设计稿或规格（Figma、标注、描述），实现或调整组件与样式，保证布局、间距、层级、断点与 RTL 等与设计一致；必要时做走查与修正，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+理解设计稿或规格（Figma、标注、描述），实现或调整组件与样式，保证布局、间距、层级、断点与 RTL 等与设计一致；必要时做走查与修正，节点中如有写入文件的操作可以执行。
+
+**结果回传**：最终回复的正文就是本节点的结果，AgentFlow 会自行写入 `AGENTFLOW_RESULT_FILE`——不要自己创建该文件，也不要输出文件路径。若节点声明了额外的 output 槽，则最终**只**输出一个 agentflow envelope：
+
 ```
+---agentflow
+result: |
+  <完整结果正文，每行缩进两个空格>
+outParams:
+  <槽位名>: <短值>
+---end
+```
+
+**失败上报**：任务明确失败时，直接以非零退出码结束，或在回复中说明失败原因——不要调用任何 CLI 写状态。

package/agents/agentflow-node-executor.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-按上述任务完成执行，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+按上述任务完成执行，节点中如有写入文件的操作可以执行。
+
+**结果回传**：最终回复的正文就是本节点的结果，AgentFlow 会自行写入 `AGENTFLOW_RESULT_FILE`——不要自己创建该文件，也不要输出文件路径。若节点声明了额外的 output 槽，则最终**只**输出一个 agentflow envelope：
+
 ```
+---agentflow
+result: |
+  <完整结果正文，每行缩进两个空格>
+outParams:
+  <槽位名>: <短值>
+---end
+```
+
+**失败上报**：任务明确失败时，直接以非零退出码结束，或在回复中说明失败原因——不要调用任何 CLI 写状态。

package/agents/en/agentflow-node-executor.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-Complete the task as described above. If the node involves file writing operations, they can be executed. Exit when done — the system automatically marks the result as success. **Only if the task explicitly fails**, run the following command to report failure (`agentflow` is a CLI command available directly in the terminal):
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"reason for failure"}'
+Complete the task as described above. If the node involves file writing operations, they can be executed. 
+
+**Returning the result**: the body of your final reply *is* this node's result. AgentFlow writes it to `AGENTFLOW_RESULT_FILE` for you — do not create that file and do not print a path. If the node declares extra output slots, emit exactly one agentflow envelope and nothing else:
+
 ```
+---agentflow
+result: |
+  <full result body, each line indented two spaces>
+outParams:
+  <slotName>: <short value>
+---end
+```
+
+**Reporting failure**: on a real failure, exit non-zero or state the reason in your reply — do not call any CLI to write status.

package/agents/zh/agentflow-node-executor.md

@@ -27,7 +27,17 @@ ${taskBody}
 
 ---
 
-按上述任务完成执行，节点中如有写入文件的操作可以执行。任务完成后直接退出，结果由系统自动标记成功。**仅当任务明确失败时**，执行以下命令报告失败（`agentflow` 是可直接在终端运行的 CLI 命令）：
-```bash
-agentflow apply -ai write-result ${pipelineWorkspace} ${flowName} ${uuid} ${instanceId} --json '{"status":"failed","message":"失败原因"}'
+按上述任务完成执行，节点中如有写入文件的操作可以执行。
+
+**结果回传**：最终回复的正文就是本节点的结果，AgentFlow 会自行写入 `AGENTFLOW_RESULT_FILE`——不要自己创建该文件，也不要输出文件路径。若节点声明了额外的 output 槽，则最终**只**输出一个 agentflow envelope：
+
 ```
+---agentflow
+result: |
+  <完整结果正文，每行缩进两个空格>
+outParams:
+  <槽位名>: <短值>
+---end
+```
+
+**失败上报**：任务明确失败时，直接以非零退出码结束，或在回复中说明失败原因——不要调用任何 CLI 写状态。

package/bin/agentflow.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 /**
- * AgentFlow CLI: drive apply/replay from command line.
- * Commands: agentflow apply <FlowName> [uuid], agentflow replay [flowName] <uuid> <instanceId>
- * Cursor agent execution uses --print --output-format stream-json.
+ * AgentFlow CLI entry point.
+ * Flow execution lives in the Workspace graph (Web UI Run / workspace_scheduled_run);
+ * this CLI covers catalog, validation, Hub and the local UI server.
  */
 
 import { createRequire } from "module";

package/bin/lib/admin-builtin-pipelines.mjs

@@ -3,6 +3,7 @@ import path from "path";
 import {
   getAgentflowDataRoot,
   getUserPipelinesRoot,
+  isFlowDir,
 } from "./paths.mjs";
 
 const CONFIG_FILENAME = "admin-builtin-pipelines.json";
@@ -57,7 +58,7 @@ export function resolveAdminBuiltinPipelineDir(flowId) {
   const entry = config.promoted.find((item) => item.id === id);
   if (!entry) return "";
   const dir = path.join(getUserPipelinesRoot(entry.ownerUserId), entry.id);
-  return fs.existsSync(path.join(dir, "flow.yaml")) ? dir : "";
+  return isFlowDir(dir) ? dir : "";
 }
 
 export function updateAdminBuiltinPipelineConfig(action, payload = {}, actor = {}) {
@@ -68,7 +69,7 @@ export function updateAdminBuiltinPipelineConfig(action, payload = {}, actor = {
     const ownerUserId = String(payload.ownerUserId || actor.userId || "").trim();
     if (!ownerUserId) return { ok: false, error: "Missing ownerUserId" };
     const dir = path.join(getUserPipelinesRoot(ownerUserId), flowId);
-    if (!fs.existsSync(path.join(dir, "flow.yaml"))) return { ok: false, error: "Pipeline not found" };
+    if (!isFlowDir(dir)) return { ok: false, error: "Pipeline not found" };
     const promoted = config.promoted.filter((item) => item.id !== flowId);
     promoted.unshift({
       id: flowId,