@fieldwangai/agentflow 0.1.32 → 0.1.34

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
@@ -21,7 +22,6 @@ input:
   - type: text
     name: branch
     default: ""
-    showOnNode: true
   - type: text
     name: targetDir
     default: ""
@@ -31,9 +31,14 @@ input:
   - type: bool
     name: includeSubmodules
     default: "false"
+  - type: text
+    name: remote
+    default: "origin"
   - type: text
     name: workspaceContext
     default: ""
+    required: true
+    showOnNode: true
 output:
   - type: node
     name: next
@@ -53,5 +58,12 @@ output:
   - type: text
     name: workspaceContext
     default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: gitContext
+    default: ""
+    required: true
+    showOnNode: true
 ---
-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,59 @@
+---
+# 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: ""
+  - type: text
+    name: branch
+    default: ""
+  - type: file
+    name: worktreePath
+    default: ""
+  - type: text
+    name: gitContext
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: workspaceContext
+    default: ""
+    required: true
+    showOnNode: 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: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: gitContext
+    default: ""
+    required: true
+    showOnNode: true
+---
+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.
+
+  - `workspaceContext` is required. Its `cwd` is used as the worktree to remove.
+  - `repoPath`, `worktreePath` and `gitContext` are optional compatibility overrides.
+  - 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: ""
+  - type: file
+    name: worktreePath
+    default: ""
+  - type: text
+    name: gitContext
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+    required: true
+    showOnNode: 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: ""
+    required: true
+    showOnNode: true
+  - 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}`.

package/builtin/nodes/tool_load_key.md

@@ -9,6 +9,8 @@ input:
   - type: text
     name: key
     default: ""
+    required: true
+    showOnNode: true
 output:
   - type: node
     name: next
@@ -16,5 +18,7 @@ output:
   - type: text
     name: result
     default: ""
+    required: true
+    showOnNode: true
 ---
 ${USER_PROMPT}

package/builtin/nodes/tool_nodejs.md

@@ -33,6 +33,8 @@ input:
   - type: text
     name: workspaceContext
     default: ""
+    required: true
+    showOnNode: true
   - type: text
     name: skillsContext
     default: ""
@@ -43,5 +45,7 @@ output:
   - type: text
     name: result
     default: ""
+    required: true
+    showOnNode: true
 ---
 ${USER_PROMPT}

package/builtin/nodes/tool_print.md

@@ -9,6 +9,8 @@ input:
   - type: text
     name: content
     default: ""
+    required: true
+    showOnNode: true
 output:
   - type: node
     name: next

package/builtin/nodes/tool_save_key.md

@@ -9,9 +9,13 @@ input:
   - type: text
     name: key
     default: ""
+    required: true
+    showOnNode: true
   - type: text
     name: value
     default: ""
+    required: true
+    showOnNode: true
 output:
   - type: node
     name: next

package/builtin/nodes/tool_user_ask.md

@@ -8,8 +8,10 @@ input:
     default: ""
   - type: file
     name: question
-    description: 要展示给用户的问题（Markdown 格式，可选）
+    description: 要展示给用户的问题（Markdown 格式）
     default: ""
+    required: true
+    showOnNode: true
 output:
   - type: node
     name: option_0

package/builtin/nodes/tool_user_check.md

@@ -10,6 +10,8 @@ input:
     name: content
     description: 要展示给用户确认的内容（Markdown 格式）
     default: ""
+    required: true
+    showOnNode: true
 output:
   - type: node
     name: next
@@ -19,4 +21,4 @@ output:
     description: 用户确认后的内容（可能已编辑/AI修改）
     default: ""
 ---
-${USER_PROMPT}
+${USER_PROMPT}