@fieldwangai/agentflow 0.1.160 → 0.1.162

package/skills/agentflow-cli/scripts/agentflow-runtime.mjs

@@ -4,6 +4,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 
 const PACKAGE_NAME = "@fieldwangai/agentflow";
 const RUNTIME_ENTRY = path.join("bin", "lib", "skill-runtime.mjs");
+const BUNDLED_RUNTIME_ENTRY = path.join("bin", "lib", "skill-runtime.mjs");
 let explicitRoot = "";
 let resolvedRoot = "";
 let runtimePromise = null;
@@ -12,7 +13,9 @@ function packageLooksUsable(root) {
   if (!root) return false;
   try {
     const manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf-8"));
-    return manifest?.name === PACKAGE_NAME && fs.statSync(path.join(root, RUNTIME_ENTRY)).isFile();
+    const supportedManifest = manifest?.name === PACKAGE_NAME || manifest?.agentflowSkillRuntime === 1;
+    const entry = manifest?.agentflowSkillRuntime === 1 ? BUNDLED_RUNTIME_ENTRY : RUNTIME_ENTRY;
+    return supportedManifest && fs.statSync(path.join(root, entry)).isFile();
   } catch {
     return false;
   }
@@ -65,9 +68,11 @@ export function configureAgentFlowRuntime(options = {}) {
 export function resolveAgentFlowPackageRoot() {
   if (resolvedRoot) return resolvedRoot;
   const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  const bundledRoot = path.resolve(scriptDir, "..", "runtime");
   const candidates = [
     explicitRoot,
     String(process.env.AGENTFLOW_PACKAGE_ROOT || "").trim(),
+    bundledRoot,
     ...rootsNear(process.cwd()),
     ...rootsNear(scriptDir),
     ...executableCandidates().flatMap(rootsFromExecutable),
@@ -83,14 +88,16 @@ export function resolveAgentFlowPackageRoot() {
     }
   }
   throw new Error(
-    "Cannot locate a compatible @fieldwangai/agentflow runtime. Install/update the agentflow CLI, "
-    + "put its executable on PATH, or set AGENTFLOW_PACKAGE_ROOT/--agentflow-package-root.",
+    "Cannot locate the AgentFlow Skill runtime. Reinstall/update agentflow-cli from SkillHub, "
+    + "or set AGENTFLOW_PACKAGE_ROOT/--agentflow-package-root for an explicit development override.",
   );
 }
 
 export function loadAgentFlowRuntime() {
   if (!runtimePromise) {
-    const entry = path.join(resolveAgentFlowPackageRoot(), RUNTIME_ENTRY);
+    const root = resolveAgentFlowPackageRoot();
+    const manifest = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf-8"));
+    const entry = path.join(root, manifest?.agentflowSkillRuntime === 1 ? BUNDLED_RUNTIME_ENTRY : RUNTIME_ENTRY);
     runtimePromise = import(pathToFileURL(entry).href);
   }
   return runtimePromise;

package/skills/agentflow-flow-add-instances/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: agentflow-flow-add-instances
-description: Legacy Pipeline node authoring is retired. Redirect requests to add nodes to the Workspace Graph skill.
+description: Legacy Pipeline node authoring is retired. Redirect requests to add nodes to agentflow-flow-dsl.
 ---
 
 # Legacy Flow Node Authoring（已下线）
 
 此 skill 原用于向 `flow.yaml` 添加实例，但旧 Pipeline 的 `Start/End` 执行模式已经下线，不再新增或编辑正式 `flow.yaml`。
 
-用户要在画布中加节点时，请改用 `agentflow-workspace-graph`，编辑：
+用户要在画布中加节点时，请改用 `agentflow-flow-dsl`，编辑：
 
 ```text
 .workspace/agentflow/pipelines/<id>/workspace.flow.js

package/skills/agentflow-flow-dsl/SKILL.md

@@ -2,8 +2,8 @@
 name: agentflow-flow-dsl
 description: >-
   用 workspace.flow.js（受限 ESM）编写 AgentFlow Workspace 流程图。适用于新建流程、
-  修改流程结构、添加或删除节点、修改连线、控制顺序、分支、子流程、受控循环和定时入口；
-  自定义代码节点包改用 agentflow-node-dsl。
+  在现有 Workspace 画布中添加或删除节点、修改字段和连线，以及编排控制顺序、分支、
+  子流程、受控循环和定时入口；自定义代码节点包改用 agentflow-node-dsl。
 ---
 
 # AgentFlow Flow DSL
@@ -28,12 +28,14 @@ description: >-
 写完必须依次执行：
 
 ```bash
-agentflow flow dsl lint <flowDir>
-agentflow flow dsl layout <flowDir>
+node <agentflow-cli-skill-dir>/scripts/agentflow-cli.mjs dsl-lint --file <flowDir>
+node <agentflow-cli-skill-dir>/scripts/agentflow-cli.mjs dsl-layout --file <flowDir>
 ```
 
+先安装并读取 `agentflow-cli` Skill，把它的 `SKILL.md` 所在目录记为
+`<agentflow-cli-skill-dir>`。CLI/DSL Runtime 已随该 Skill 分发，不要安装 npm 包。
 lint 不通过先修结构，不要排版。`layout` 默认只给缺坐标的新节点补位置，保留用户手工布局。
-新建流程，或用户明确要求整理整张图时，使用 `agentflow flow dsl layout <flowDir> --all`。
+新建流程，或用户明确要求整理整张图时，在 `dsl-layout` 命令末尾加 `--all`。
 不要直接编辑 `workspace.layout.json` 里的 x/y。
 
 ## 自动排版是交付步骤
@@ -42,11 +44,25 @@ lint 不通过先修结构，不要排版。`layout` 默认只给缺坐标的新
 
 1. `lint` 校验节点、引脚和拓扑
 2. `layout` 生成或补齐坐标
-3. 如果本地 UI 已打开，再刷新或按 UI 同步 skill 通知画布加载磁盘结果
+3. 如果本地 UI 已打开，刷新画布加载磁盘结果；需要远端审图和试运行时交给
+   `agentflow-author-flow` 创建可运行 Draft
 
 自动排版按依赖从左到右放置，控制主链保持同一视觉轴，数据源放在上方，展示节点与同层主链
 错开，分支纵向展开。不要为了“看起来差不多”自行猜坐标。
 
+## 直接修改现有 Workspace
+
+用户明确要求在现有画布中加节点、改字段或连线时，先读当前 `workspace.flow.js`，只修改目标
+节点和相关引用，不要重建整张图。保留未涉及的节点 id、控制顺序、数据边、子流程契约和用户
+已有布局；新增节点再由 `layout` 补坐标。
+
+- 只放展示内容且不需要执行的 `display.*` 节点可以不写进 `flow(...)`。
+- `display.*` 的字面量写在 `content` 输入；连接上游时引用 `source.slot`。它的 `content`
+  输出仍可接给后续 agent 作为上下文。
+- 不直接编辑 `workspace.layout.json`、`workspace.nodes.json` 或 `workspace.state.json`。
+- 本地改完仍必须执行 `lint` 和 `layout`。需要可保存、可试运行的远端画布时，交给
+  `agentflow-author-flow` 创建 Draft；只读分享才使用 `workspace-preview`。
+
 ## 交付状态与用户验收
 
 `lint`、`layout`、自动化测试和 Mock 外部服务都属于 **Agent 测试环境**。完成这些只能说
@@ -60,6 +76,9 @@ GitLab 等外部系统时，必须验证真实请求、账号权限、网络、
 用户明确确认实际流程跑通后，才能将状态更新为“生产同构验收通过，可发布/可上线”。如果流程里有
 自定义代码节点，同时遵守 `agentflow-node-dsl` 里更严格的两级验证闸门。
 
+面向用户的新流程不要直接正式发布。完成 lint/layout 后使用 `agentflow-author-flow` 的
+Draft → 试运行 → 动态修改 → 明确确认 → 发布/定时流程；只读 `workspace-preview` 不能代替试运行。
+
 ## 图结构：workspace.flow.js
 
 ```js

package/skills/agentflow-flow-dsl/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "AgentFlow Flow DSL"
-  short_description: "Author AgentFlow workspace graphs and connections in DSL"
-  default_prompt: "Use $agentflow-flow-dsl to create or modify an AgentFlow workspace.flow.js graph."
+  short_description: "Author AgentFlow graphs, subflows, and controlled loops in DSL"
+  default_prompt: "Use $agentflow-flow-dsl to create or modify an AgentFlow workspace.flow.js graph, including subflows and controlled loops."

package/skills/agentflow-flow-edit-node-fields/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: agentflow-flow-edit-node-fields
-description: Legacy Pipeline field editing is retired. Use the Workspace Graph skill for node field changes.
+description: Legacy Pipeline field editing is retired. Use agentflow-flow-dsl for Workspace node field changes.
 ---
 
 # Legacy Flow Node Field Editing（已下线）
 
-此 skill 原用于修改 `flow.yaml` 的实例字段。当前新建和操作统一发生在 Workspace 图中，节点字段应修改 `workspace.flow.js` 的节点调用（见 **agentflow-workspace-graph**），并通过 Workspace 保存/预览链路同步。
+此 skill 原用于修改 `flow.yaml` 的实例字段。当前新建和操作统一发生在 Workspace 图中，节点字段应修改 `workspace.flow.js` 的节点调用（见 **agentflow-flow-dsl**），并通过 Workspace 保存/Draft 链路同步。
 
-不要修改 `flow.yaml`、`control_start/control_end` 或调用旧 Pipeline 执行接口来完成新需求。请改用 `agentflow-workspace-graph`。
+不要修改 `flow.yaml`、`control_start/control_end` 或调用旧 Pipeline 执行接口来完成新需求。请改用 `agentflow-flow-dsl`。

package/skills/agentflow-flow-recipes/SKILL.md

@@ -7,7 +7,7 @@ description: Workspace Graph recipes for AgentFlow canvas tasks (git analysis, d
 
 组合 Git Checkout、CD Workspace、Load Skills、Agent、Display 等节点时，先读
 [recipes.md](references/recipes.md)，在 `workspace.flow.js` 中以 `flow(...)` 为入口组织节点，
-再用 `agentflow-workspace-graph` 校验槽位和连线。
+再用 `agentflow-flow-dsl` 校验槽位和连线。
 
 旧的 `Start → … → End` 流水线 recipe 已下线；不得生成 `control_start` / `control_end`
 或其它已退役的节点类型（recipes.md 末尾列出了完整清单）。

package/skills/agentflow-flow-recipes/references/recipes.md

@@ -102,8 +102,7 @@ draw an edge from a downstream node back to an upstream one.
 
 ## Edit The Graph
 
-- Structure, nodes, edges: **agentflow-workspace-graph**
-- Full syntax and the node call table: **agentflow-flow-dsl**
+- Structure, nodes, edges, full syntax and node calls: **agentflow-flow-dsl**
 - Node implementations in code: `nodes/<name>/index.mjs`, see **agentflow-flow-dsl**
 
 Saving is handled by the Workspace API; there is no separate canvas-sync step.

package/skills/agentflow-flow-sync-ui/SKILL.md

@@ -5,4 +5,4 @@ description: Legacy flow.yaml canvas sync is retired. Workspace Graph saves are
 
 # Legacy Flow Canvas Sync（已下线）
 
-旧的 `flow.yaml` + `/api/flow-editor-sync` 刷新链路不再用于新功能。Workspace 图请直接编辑 `workspace.flow.js`（见 **agentflow-workspace-graph**），或使用 Workspace Graph 页面/API 的保存机制；需要所见即所得预览时使用 `agentflow-cli workspace-preview --file <flowDir>`。
+旧的 `flow.yaml` + `/api/flow-editor-sync` 刷新链路不再用于新功能。Workspace 图请按 **agentflow-flow-dsl** 编辑 `workspace.flow.js`，或使用 Workspace 页面/API 的保存机制；需要可编辑、可试运行的远端画布时使用 **agentflow-author-flow** 的 Draft，纯只读分享才使用 `agentflow-cli workspace-preview --file <flowDir>`。

package/skills/agentflow-node-dsl/SKILL.md

@@ -27,8 +27,8 @@ description: >-
 node <agentflow-cli-skill-dir>/scripts/agentflow-cli.mjs config
 ```
 
-跨端节点操作要求 `localRuntime.available: true` 和有效 token；缺少 companion skill 或本地
-AgentFlow runtime 时先停止并按 `agentflow-cli` 的安装说明修复。
+跨端节点操作要求 `localRuntime.available: true` 和有效 token。Runtime 已包含在 companion
+Skill 中；缺失时重新安装或更新 `agentflow-cli`，不要另装 npm CLI。
 
 写新包之前，先搜索服务端目录，避免重复造已有节点：
 
@@ -183,7 +183,7 @@ Agent 自行完成且保留可重现证据：
 - 节点包含 `scripts/` / `templates/` / `assets/` 时，用完整 ZIP 安装后再跑一次，不得只测 `index.mjs`
 
 ```bash
-agentflow flow dsl lint <flowDir>
+node <agentflow-cli-skill-dir>/scripts/agentflow-cli.mjs dsl-lint --file <flowDir>
 ```
 
 这一级通过后只能汇报：**开发验证通过，待生产同构验收**。
@@ -203,16 +203,8 @@ agentflow flow dsl lint <flowDir>
 
 ## 发布给别的流程用
 
-流程自带的 `nodes/<name>/` 只有那个流程能用。要复用就发布：
-
-```bash
-agentflow marketplace publish-node <flowDir>/nodes/<name>
-agentflow marketplace list
-```
-
-包会被复制到 `.workspace/agentflow/marketplace/packages/nodes/<id>/<version>`。
-
-要发给另一台机器或另一个 Agent workspace，上传和安装**整个包目录**：
+流程自带的 `nodes/<name>/` 只有那个流程能用。要让其它流程或其它 Agent workspace 复用，
+通过 token-backed CLI 上传和安装**整个包目录**：
 
 ```bash
 node <agentflow-cli-skill-dir>/scripts/agentflow-cli.mjs node-package-publish --file <flowDir>/nodes/<name>

package/skills/agentflow-workspace-markdown/SKILL.md

@@ -22,7 +22,7 @@ const structure = display.markdown("项目结构分析", {
 ```
 
 超过 3000 字符的正文抽成文件，写 `file("docs/structure.md")`。画布语法见
-**agentflow-workspace-graph** / **agentflow-flow-dsl**。
+**agentflow-flow-dsl**。
 
 ## 内容规范
 

package/skills/agentflow-workspace-graph/SKILL.md

@@ -1,85 +0,0 @@
----
-name: agentflow-workspace-graph
-description: >-
-  AgentFlow Workspace 画布编辑技能。用于在 Workspace 视图中创建或修改
-  workspace.flow.js，新增展示节点、上下文节点和连线；不修改正式 flow.yaml。
----
-
-# AgentFlow Workspace Graph
-
-在 Workspace 视图中需要创建临时工作画布、保存分析结果、组织上下文节点或连接展示节点时使用本技能。
-
-## 目标文件
-
-画布就是代码：改当前 Workspace 项目目录下的 **`workspace.flow.js`**。不要修改历史
-`flow.yaml`，也不要写 `workspace.graph.json`——那是已经退役的格式，写了不会被读。
-
-```
-workspace.flow.js      ← 改这个
-workspace.layout.json    坐标，平台维护，别碰
-workspace.nodes.json     图片等机器属性，平台维护，别碰
-workspace.state.json     运行产出，平台维护，别碰
-```
-
-坐标不用管：新节点平台会自动排布，写死坐标反而会覆盖用户调过的位置。
-
-## 写法
-
-```js
-import { agent, control, display, flow } from "agentflow/flow";
-
-const notes = display.markdown("项目结构分析", {
-  content: `# 项目结构分析
-
-- src/ 业务代码
-- bin/ CLI 入口`,
-});
-```
-
-| 位置 | 含义 |
-|------|------|
-| 第 1 个参数（字符串） | 节点显示名 |
-| 第 2 个参数（对象） | 输入引脚，每个键都是引脚名 |
-| 第 3 个参数（字符串） | body：agent 的 prompt、`tool.nodejs` 的命令 |
-| `const 变量名` | 节点 id |
-| `x.slotName` | 引用上游输出引脚 = 连一条数据线 |
-
-连线和控制流：
-
-```js
-const summary = agent.subAgent("总结", { source: notes.content }, `把上面的结构讲清楚`);
-const show    = display.markdown("总结", { content: summary.result });
-export const run = flow("Run", summary, show);
-```
-
-只放一个展示节点、不需要跑的，不用写 `flow(...)`，声明出来就行。
-
-## 铁律
-
-1. 节点全部声明在**模块顶层**
-2. **禁一切控制流**：`if` / `for` / `while` / `?:` / `.map()` / `await` / 箭头函数 /
-   动态属性。这个文件永不执行、只被静态解析，出现这些就还原不出图。要写逻辑就建代码
-   节点 `nodes/<name>/index.mjs`
-3. 一个输出可接多个输入；**一个输入只能接一条边**；不能成环
-4. 改完跑 `agentflow flow dsl lint <flowDir>` 自查
-
-完整语法和全部可用节点见 **agentflow-flow-dsl** skill。
-
-## 展示节点选型
-
-- `display.markdown` — Markdown 正文、分析报告、会议纪要、代码结构说明
-- `display.mermaid` — Mermaid 图源码
-- `display.ascii` — ASCII 图
-- `display.html` — 可交互 HTML 原型或富 UI 片段
-- `display.image` — 图片 URL、data URL 或图片路径
-- `display.chart` — ChartSpec JSON 图表
-- `display.table` — 结构化表格数据
-
-内容写在 `content` 引脚上；平台会同时把它当作节点正文。展示节点的 `content` 输出可以
-接给后续 agent 当上下文。
-
-## 输出要求
-
-用户要求「生成/展示/放到 workspace 画布」时，直接编辑 `workspace.flow.js`。需要所见即所得
-的线上画布，再用 `agentflow-cli workspace-preview --file <flowDir>` 上传到服务器临时
-Workspace；不要把临时项目当作正式源版本。完成后简要说明新增或修改了哪些节点。