@fieldwangai/agentflow 0.1.160 → 0.1.163

package/skills/agentflow-cli/runtime/builtin/nodes/tool_git_worktree_load.md

@@ -0,0 +1,74 @@
+---
+# Built-in node: Git Worktree Load
+runtime: native
+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 managed execution worktree under `.workspace/agentflow/run-workspaces/`, separate from node temp files and durable `outputs/` artifacts.
+  - A `wait` checkpoint retains the execution worktree. The next run reuses the retained output path so loop state and code changes remain available while resuming.
+  - On terminal completion or stop, AgentFlow removes clean managed worktrees. Dirty worktrees are preserved with a warning instead of being force-deleted.
+  - Existing registered worktrees under the current flow workspace are managed by the same lifecycle policy.
+  - Existing registered worktrees outside the current flow workspace are reused and not removed automatically unless this run created them.
+  - Existing worktree paths are reused only when they are registered by `git worktree list` for the given repo.
+  - `pruneMissing` defaults to true. When Git has a registered worktree whose directory is missing, AgentFlow runs `git worktree prune` before adding it again.
+  - `force` defaults to false. When true, AgentFlow passes `--force` to `git worktree add`.
+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: bool
+    name: pruneMissing
+    default: "true"
+    showOnNode: false
+  - type: bool
+    name: force
+    default: "false"
+    showOnNode: false
+  - 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/skills/agentflow-cli/runtime/builtin/nodes/tool_git_worktree_unload.md

@@ -0,0 +1,52 @@
+---
+# Built-in node: Git Worktree Unload
+runtime: native
+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/skills/agentflow-cli/runtime/builtin/nodes/tool_gitlab_create_mr.md

@@ -0,0 +1,114 @@
+---
+# Built-in node: GitLab Create MR
+runtime: native
+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/skills/agentflow-cli/runtime/builtin/nodes/tool_jenkins_build.md

@@ -0,0 +1,67 @@
+---
+# Built-in node: durable Jenkins build
+runtime: native
+description: |
+  Trigger one Jenkins job and durably monitor it until completion.
+
+  The node persists queue/build checkpoints and uses server-side deferred polling at `pollInterval`:
+  the Workspace request returns in a waiting state instead of keeping an HTTP request or worker asleep.
+  The AgentFlow server registry wakes the flow again and continues downstream after completion.
+  An existing queueId/buildNumber is reused after a run or AgentFlow server interruption,
+  so a resumed run does not trigger the job again. Jenkins FAILURE/ABORTED/TIMEOUT are business
+  outcomes and continue to downstream notification nodes. Authentication, configuration, and
+  repeated platform request errors fail the AgentFlow node.
+
+  Credentials are read from environment configuration. `credentialRef: team-ci` selects
+  `JENKINS_TEAM_CI_BASE_URL`, `JENKINS_TEAM_CI_USERNAME`, and `JENKINS_TEAM_CI_TOKEN`, falling
+  back to the standard `JENKINS_BASE_URL`, `JENKINS_USERNAME`, and `JENKINS_TOKEN` variables.
+displayName: Jenkins Build
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: job
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: parameters
+    default: "{}"
+    description: "Jenkins Job 参数 JSON object。"
+    showOnNode: true
+  - type: text
+    name: credentialRef
+    default: ""
+    description: "Project Deployment 中配置的 Jenkins 凭证引用；不在 flow.yaml 中填写 token。"
+    showOnNode: false
+  - type: text
+    name: pollInterval
+    default: "30s"
+    showOnNode: false
+  - type: text
+    name: timeout
+    default: "2h"
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: status
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: url
+    default: ""
+    required: true
+    description: "优先返回安装包 URL；没有安装包时返回 Jenkins Build URL。"
+    showOnNode: true
+  - type: text
+    name: qrUrl
+    default: ""
+    description: "解析到二维码时返回，否则为空。"
+    showOnNode: true
+---
+Trigger Jenkins job `${job}` with `${parameters}`, wait durably, then output `${status}`, `${url}`, and optional `${qrUrl}`.

package/skills/agentflow-cli/runtime/builtin/nodes/tool_load_key.md

@@ -0,0 +1,26 @@
+---
+# 内置节点：按 key 读取
+runtime: none
+palette: hidden
+description: Load key-value from global storage
+displayName: LoadKey
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: key
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: result
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

package/skills/agentflow-cli/runtime/builtin/nodes/tool_nodejs.md

@@ -0,0 +1,52 @@
+---
+# 内置节点：执行 Node.js
+runtime: native
+description: |
+  Execute a Node.js script. The Workspace runtime spawns the command directly — no agent involved.
+
+  **Success/Failure:** Determined by the script process **exit code** — 0 = success, non-0 = failed.
+  **Result Output:** Script stdout becomes the `result` slot content (plain text, e.g. `console.log("hello")`).
+  When stdout is empty and the exit code is non-0, stderr is written to the failure message.
+  Do **not** wrap stdout in a JSON envelope.
+
+  **Script placeholders:** `script` (inline) or `scriptRef` (file) support `${}` placeholders —
+  `workspaceRoot` / `pipelineWorkspace` / `flowDir` (all three resolve to the scoped workspace root),
+  `cwd`, `nodeRunDir`, `nodeTmpDir`, `outputsDir`, `scriptRef`, plus every input and output slot name.
+  Values are auto shell-quoted, so do not add your own quotes.
+  Example: `script: node ${flowDir}/scripts/my-check.mjs --root ${workspaceRoot} --input ${todo}`
+
+  **Pin Path Constraint (Important):** File paths read/written by the script **must be passed via pins**;
+  never construct output paths inside the script.
+  - Input slots of type `file` are resolved from upstream connections; the script receives them as CLI args.
+  - Output slots of type `file` are resolved to absolute paths by the runtime; the script writes to them directly.
+  - Reference them with `${slotName}` in `script`, e.g. `--figma-tree ${figma_tree} --output ${restore_todolist}`.
+  - **Forbidden** to invent output paths inside the script — downstream nodes will not find the files.
+
+  **Scripts under `scripts/` must be referenced as `${flowDir}/scripts/xxx.mjs`.**
+displayName: NodeJs
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: skillsContext
+    default: ""
+  - type: text
+    name: mcpContext
+    default: ""
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: result
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

package/skills/agentflow-cli/runtime/builtin/nodes/tool_print.md

@@ -0,0 +1,21 @@
+---
+# 内置节点：醒目输出
+runtime: none
+palette: hidden
+description: Output content to user with special font style
+displayName: Print
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: content
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+---
+Print `${content}` to the user.

package/skills/agentflow-cli/runtime/builtin/nodes/tool_save_key.md

@@ -0,0 +1,26 @@
+---
+# 内置节点：按 key 写入
+runtime: none
+palette: hidden
+description: Save key-value pair to global storage
+displayName: SaveKey
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: key
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+---
+${USER_PROMPT}

package/skills/agentflow-cli/runtime/builtin/nodes/tool_set_run_env.md

@@ -0,0 +1,38 @@
+---
+# Built-in node: set environment variables for the current run only
+runtime: native
+description: Set environment variables for downstream nodes in the current workspace run
+displayName: Set Run Env
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: key
+    default: ""
+    description: "单个环境变量名，例如 IMAP_USER。"
+    showOnNode: true
+  - type: text
+    name: value
+    default: ""
+    description: "单个环境变量值。"
+    showOnNode: true
+  - type: text
+    name: variables
+    default: ""
+    description: "批量设置，支持多行 KEY=VALUE 或 JSON object。"
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: keys
+    default: ""
+    showOnNode: false
+  - type: text
+    name: count
+    default: ""
+    showOnNode: false
+---
+Set environment variables for downstream nodes in this run only.

package/skills/agentflow-cli/runtime/builtin/nodes/tool_user_ask.md

@@ -0,0 +1,27 @@
+---
+# 内置节点：用户选择（Switch 分支）
+runtime: none
+palette: hidden
+description: 等待用户从多个选项中选择一个，流程暂停；按用户选择沿对应出边分支继续。每个 output 槽位对应一条分支，槽位的 description 作为选项文案。
+displayName: UserAsk
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: file
+    name: question
+    description: 要展示给用户的问题（Markdown 格式）
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: option_0
+    description: 选项 0
+    default: ""
+  - type: node
+    name: option_1
+    description: 选项 1
+    default: ""
+---
+${USER_PROMPT}

package/skills/agentflow-cli/runtime/builtin/nodes/tool_user_check.md

@@ -0,0 +1,26 @@
+---
+# 内置节点：用户确认
+runtime: none
+palette: hidden
+description: 等待用户确认，流程暂停。展示确认内容给用户，用户可编辑/AI修改后保存，回复 "继续" 后重启流程。
+displayName: UserCheck
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: file
+    name: content
+    description: 要展示给用户确认的内容（Markdown 格式）
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: file
+    name: content
+    description: 用户确认后的内容（可能已编辑/AI修改）
+    default: ""
+---
+${USER_PROMPT}

package/skills/agentflow-cli/runtime/builtin/nodes/tool_wecom_send_app_markdown.md

@@ -0,0 +1,57 @@
+---
+# Built-in node: WeCom direct markdown message
+runtime: native
+description: Send Markdown message to WeCom users through an enterprise application
+displayName: WeCom Direct Markdown
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: markdown
+    default: ""
+    required: true
+    description: "企业微信应用消息 markdown.content。请输出企业微信 Markdown 正文，不要包裹 agentflow envelope 或额外解释；适合通知、告警、任务摘要等个人消息。"
+    showOnNode: true
+  - type: text
+    name: toUser
+    default: ""
+    required: true
+    description: "接收人企业微信 userid；多个用户用 | 分隔，@all 表示全部。"
+    showOnNode: true
+  - type: text
+    name: corpId
+    default: ""
+    showOnNode: false
+  - type: text
+    name: corpSecret
+    default: ""
+    showOnNode: false
+  - type: text
+    name: agentId
+    default: ""
+    showOnNode: false
+  - type: text
+    name: accessToken
+    default: ""
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: bool
+    name: sent
+    default: ""
+    showOnNode: true
+  - type: text
+    name: message
+    default: ""
+    showOnNode: false
+  - type: text
+    name: response
+    default: ""
+    showOnNode: false
+---
+Send `${markdown}` to one or more WeCom users (`${toUser}`) using a WeCom enterprise application.
+
+If credential inputs are empty, AgentFlow reads `WECOM_CORP_ID`, `WECOM_APP_SECRET` / `WECOM_CORP_SECRET`, `WECOM_AGENT_ID`, and optionally `WECOM_TO_USER` from environment config.

package/skills/agentflow-cli/runtime/builtin/nodes/tool_wecom_send_group_markdown.md

@@ -0,0 +1,45 @@
+---
+# Built-in node: WeCom group robot markdown message
+runtime: native
+description: Send Markdown message to a WeCom group robot webhook
+displayName: WeCom Group Chat Markdown
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: markdown
+    default: ""
+    required: true
+    description: "企业微信机器人 markdown.content。请输出企业微信 Markdown 正文，不要包裹 agentflow envelope 或额外解释；支持标题、列表、链接、引用、代码等企业微信 Markdown 子集。"
+    showOnNode: true
+  - type: text
+    name: webhookUrl
+    default: ""
+    description: "企业微信群机器人完整 webhook 地址。可以只填 webhookKey。"
+    showOnNode: true
+  - type: text
+    name: webhookKey
+    default: ""
+    description: "企业微信群机器人 key，用于拼出 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=..."
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: bool
+    name: sent
+    default: ""
+    showOnNode: true
+  - type: text
+    name: message
+    default: ""
+    showOnNode: false
+  - type: text
+    name: response
+    default: ""
+    showOnNode: false
+---
+Send `${markdown}` to a WeCom group chat through a group robot webhook.
+
+Use either `webhookUrl` or `webhookKey`. If both are empty, AgentFlow reads `WECOM_GROUP_WEBHOOK` / `WECOM_BOT_WEBHOOK` or `WECOM_GROUP_WEBHOOK_KEY` / `WECOM_BOT_KEY` from environment config.

package/skills/agentflow-cli/runtime/builtin/nodes/workspace_one_click_task.md

@@ -0,0 +1,44 @@
+---
+# 内置节点：一键任务
+runtime: native
+type: agent
+description: 输入任务描述，选择 Skills、workspace 上下文和输出类型后直接运行；等价于「Load Skills + 子 Agent + Display」的合并节点。
+displayName: 一键任务
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: skillKeys
+    default: ""
+    showOnNode: false
+  - type: bool
+    name: includeWorkspaceContext
+    default: "true"
+    showOnNode: false
+  - type: text
+    name: displayType
+    default: "markdown"
+    showOnNode: false
+  - type: text
+    name: knowledgeContext
+    default: ""
+    showOnNode: false
+  - type: text
+    name: workspaceContext
+    default: ""
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: content
+    default: ""
+    showOnNode: true
+  - type: text
+    name: displayType
+    default: "markdown"
+    showOnNode: false
+---
+输入任务，选择 Skills、workspace 上下文和输出类型后直接运行。

package/skills/agentflow-cli/runtime/builtin/nodes/workspace_run.md

@@ -0,0 +1,16 @@
+---
+# 内置节点：Run
+runtime: native
+type: control
+description: Workspace 图的运行入口。点击运行时，从本节点出发沿控制边选出子图并执行；本节点自身不产生输出。
+displayName: Run
+input:
+  - type: node
+    name: prev
+    default: ""
+output:
+  - type: node
+    name: next
+    default: ""
+---
+Run the downstream workspace subgraph connected from this node.