@fieldwangai/agentflow 0.1.31 → 0.1.33

package/bin/pipeline/validate-flow.mjs

@@ -493,26 +493,16 @@ function checkFlowCore(nodes, edges, flowDir, nodeIdToSlots, getNodeBody, instan
         }
       }
 
-      // provide_str / provide_file output 类型校验
-      if (defId === "provide_str") {
+      // provide_str / provide_file / provide_bool output 类型校验
+      if (defId === "provide_str" || defId === "provide_file" || defId === "provide_bool") {
         const out = Array.isArray(inst.output) ? inst.output : [];
+        const expectedType = defId === "provide_file" ? "file" : defId === "provide_bool" ? "bool" : "text";
         if (out.length !== 1) {
-          errors.push(`节点 "${n.id}"（provide_str）output 必须仅有 1 个槽位（value:text），当前 ${out.length} 个`);
+          errors.push(`节点 "${n.id}"（${defId}）output 必须仅有 1 个槽位（value:${expectedType}），当前 ${out.length} 个`);
         } else {
           const t0 = normType(out[0] && out[0].type);
-          if (t0 !== "text") {
-            errors.push(`节点 "${n.id}"（provide_str）output[0].type 必须为 \`text\`，当前为 \`${t0 || "(空)"}\``);
-          }
-        }
-      }
-      if (defId === "provide_file") {
-        const out = Array.isArray(inst.output) ? inst.output : [];
-        if (out.length !== 1) {
-          errors.push(`节点 "${n.id}"（provide_file）output 必须仅有 1 个槽位（value:file），当前 ${out.length} 个`);
-        } else {
-          const t0 = normType(out[0] && out[0].type);
-          if (t0 !== "file") {
-            errors.push(`节点 "${n.id}"（provide_file）output[0].type 必须为 \`file\`，当前为 \`${t0 || "(空)"}\``);
+          if (t0 !== expectedType) {
+            errors.push(`节点 "${n.id}"（${defId}）output[0].type 必须为 \`${expectedType}\`，当前为 \`${t0 || "(空)"}\``);
           }
         }
       }
@@ -675,7 +665,7 @@ function computeValidation(loaded, workspaceRoot) {
     if (!isNodeEdge) continue;
     if (srcDef.startsWith("provide_") || tgtDef.startsWith("provide_")) {
       validationErrors.push(
-        `provide_* 节点不得出现在控制链上（node→node 边）：${e.source} ${sh} -> ${e.target} ${th}；provide 仅作数据源，请改连下游 text/file 数据槽`
+        `provide_* 节点不得出现在控制链上（node→node 边）：${e.source} ${sh} -> ${e.target} ${th}；provide 仅作数据源，请改连下游 text/file/bool 数据槽`
       );
     }
   }

package/builtin/nodes/display_html.md

@@ -0,0 +1,31 @@
+---
+# Built-in node: HTML Display
+description: Display HTML content in workspace canvas; passes HTML downstream as text
+displayName: HTML Display
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: content
+    default: ""
+    required: true
+    showOnNode: true
+  - type: file
+    name: filePath
+    default: ""
+    showOnNode: false
+  - type: text
+    name: workspaceContext
+    default: ""
+    showOnNode: false
+output:
+  - type: text
+    name: content
+    default: ""
+    showOnNode: false
+  - type: node
+    name: next
+    default: ""
+---
+${content}

package/builtin/nodes/display_image.md

@@ -0,0 +1,35 @@
+---
+# Built-in node: Image Display
+description: Display an image URL, data URL, or image path in workspace canvas; passes source downstream as text
+displayName: Image Display
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: src
+    default: ""
+    required: true
+    showOnNode: true
+  - type: file
+    name: filePath
+    default: ""
+    showOnNode: false
+  - type: text
+    name: alt
+    default: ""
+    showOnNode: false
+  - type: text
+    name: workspaceContext
+    default: ""
+    showOnNode: false
+output:
+  - type: text
+    name: src
+    default: ""
+    showOnNode: false
+  - type: node
+    name: next
+    default: ""
+---
+${src}

package/builtin/nodes/provide_bool.md

@@ -0,0 +1,11 @@
+---
+# 内置节点：直接提供布尔值
+description: Provide a boolean value directly, value will be passed to downstream as true or false
+displayName: Boolean
+input: []
+output:
+  - type: bool
+    name: value
+    default: "false"
+---
+${USER_PROMPT}

package/builtin/nodes/tool_git_checkout.md

@@ -8,6 +8,7 @@ description: |
   - If `targetDir` is empty, the repository is cloned into `${pipelineWorkspace}/.workspace/agentflow/git-repos/<repo-name>`.
   - Set `includeSubmodules` to `true` to clone/update Git submodules recursively.
   - The `workspaceContext` output can be connected to CD Workspace, Load Skills, agent, or tool nodes.
+  - The `gitContext` output can be connected to Worktree, GitLab MR, or other Git nodes.
 displayName: Git Checkout
 input:
   - type: node
@@ -31,6 +32,9 @@ input:
   - type: bool
     name: includeSubmodules
     default: "false"
+  - type: text
+    name: remote
+    default: "origin"
   - type: text
     name: workspaceContext
     default: ""
@@ -53,5 +57,8 @@ output:
   - type: text
     name: workspaceContext
     default: ""
+  - type: text
+    name: gitContext
+    default: ""
 ---
-Clone or update `${repoUrl}` and output a workspace context for the checked-out repository.
+Clone or update `${repoUrl}` and output workspace/git contexts for the checked-out repository.

package/builtin/nodes/tool_git_worktree_load.md

@@ -0,0 +1,54 @@
+---
+# Built-in node: Git Worktree Load
+description: |
+  Create or reuse a Git worktree and expose it as the downstream workspace context.
+
+  - `repoPath` is required unless `gitContext.repoPath` is connected.
+  - `workspaceContext` is required so the node can preserve the previous execution context.
+  - `branch` is optional. When empty, AgentFlow creates a detached worktree at the current HEAD.
+  - `worktreePath` is optional. When empty, AgentFlow creates a path under `${pipelineWorkspace}/.workspace/agentflow/worktrees`.
+  - Existing worktree paths are reused only when they are registered by `git worktree list` for the given repo.
+displayName: Load Worktree
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: file
+    name: repoPath
+    default: ""
+    showOnNode: true
+  - type: text
+    name: branch
+    default: ""
+    showOnNode: true
+  - type: file
+    name: worktreePath
+    default: ""
+  - type: text
+    name: gitContext
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+    required: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: file
+    name: worktreePath
+    default: ""
+  - type: text
+    name: branch
+    default: ""
+  - type: text
+    name: commit
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+  - type: text
+    name: gitContext
+    default: ""
+---
+Load a Git worktree from `${repoPath}` and switch downstream workspace context to it.

package/builtin/nodes/tool_git_worktree_unload.md

@@ -0,0 +1,51 @@
+---
+# Built-in node: Git Worktree Unload
+description: |
+  Remove a Git worktree.
+
+  - `repoPath` is required unless `gitContext.repoPath` is connected.
+  - `worktreePath` is required unless `gitContext.worktreePath` is connected.
+  - `workspaceContext` is required so the node can restore the previous execution context.
+  - By default `force` is false; dirty worktrees fail instead of being removed.
+  - By default `prune` is true.
+displayName: Unload Worktree
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: file
+    name: repoPath
+    default: ""
+    showOnNode: true
+  - type: file
+    name: worktreePath
+    default: ""
+    showOnNode: true
+  - type: text
+    name: gitContext
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+    required: true
+  - type: bool
+    name: force
+    default: "false"
+  - type: bool
+    name: prune
+    default: "true"
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: bool
+    name: removed
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+  - type: text
+    name: message
+    default: ""
+---
+Remove Git worktree `${worktreePath}` from repository `${repoPath}`.

package/builtin/nodes/tool_gitlab_create_mr.md

@@ -0,0 +1,113 @@
+---
+# Built-in node: GitLab Create MR
+description: |
+  Create or reuse a GitLab merge request for the current branch.
+
+  - `gitContext` and `workspaceContext` can be connected from Git Checkout / Load Worktree.
+  - `repoPath` is optional. When empty, AgentFlow uses `gitContext.worktreePath`, `gitContext.repoPath`, or `workspaceContext.cwd`.
+  - `sourceBranch`, `targetBranch`, `title`, `description`, `draft`, and `labels` are optional. When empty, AgentFlow derives sensible defaults from git.
+  - `tokenEnv` is optional. Defaults to `GITLAB_TOKEN,GITLAB_PRIVATE_TOKEN`.
+  - `gitlabApiBase` is optional. When empty, AgentFlow uses `https://${gitContext.host}/api/v4`.
+displayName: Create GitLab MR
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: file
+    name: repoPath
+    default: ""
+    showOnNode: false
+  - type: text
+    name: gitContext
+    default: ""
+    showOnNode: true
+  - type: text
+    name: workspaceContext
+    default: ""
+    showOnNode: false
+  - type: text
+    name: sourceBranch
+    default: ""
+    showOnNode: false
+  - type: text
+    name: targetBranch
+    default: ""
+    showOnNode: false
+  - type: text
+    name: title
+    default: ""
+    showOnNode: false
+  - type: text
+    name: description
+    default: ""
+    showOnNode: false
+  - type: bool
+    name: draft
+    default: "false"
+    showOnNode: false
+  - type: text
+    name: labels
+    default: ""
+    showOnNode: false
+  - type: bool
+    name: push
+    default: "true"
+    showOnNode: false
+  - type: text
+    name: remote
+    default: "origin"
+    showOnNode: false
+  - type: text
+    name: tokenEnv
+    default: ""
+    showOnNode: false
+  - type: text
+    name: gitlabApiBase
+    default: ""
+    showOnNode: false
+  - type: bool
+    name: removeSourceBranch
+    default: "false"
+    showOnNode: false
+  - type: bool
+    name: squash
+    default: "false"
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: mrUrl
+    default: ""
+    required: true
+  - type: bool
+    name: created
+    default: ""
+    showOnNode: false
+  - type: text
+    name: mrIid
+    default: ""
+    showOnNode: false
+  - type: text
+    name: projectId
+    default: ""
+    showOnNode: false
+  - type: text
+    name: sourceBranch
+    default: ""
+    showOnNode: false
+  - type: text
+    name: targetBranch
+    default: ""
+    showOnNode: false
+  - type: text
+    name: title
+    default: ""
+    showOnNode: false
+  - type: text
+    name: message
+    default: ""
+    showOnNode: false
+---
+Create or reuse a GitLab merge request and output `${mrUrl}`.