@fieldwangai/agentflow 0.1.160 → 0.1.163

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

@@ -0,0 +1,131 @@
+---
+# 内置节点：While 单步推进
+runtime: native
+description: |
+  Repeatedly execute either an explicit Condition/Body subflow pair or one legacy deterministic
+  step command (`script` or `scriptRef`) without adding a cycle to the Workspace graph. A Run
+  restarted after `wait` resumes from the saved output state.
+
+  Preferred DSL form:
+  `control.while("Advance", { state, maxIterations, timeout }, conditionFlow, bodyFlow)`.
+  An optional typed `context` input is captured once before iteration and forwarded only to
+  Condition/Body subflows that explicitly declare `flow.input("context", "context")`. Context is
+  never copied into business state, history, or checkpoints.
+  Condition must accept `state` and `iteration`, and return `decision` plus optional `summary`.
+  Only `continue` invokes Body. Body must accept `state`, `iteration`, and `idempotencyKey`, and
+  return the next `state` plus optional `summary`. `wait`, `done`, and `fail` skip Body.
+
+  In legacy script mode, the command runs once per iteration and stdout must be exactly one JSON object:
+  `{"decision":"continue|wait|done|fail","state":{},"summary":"..."}`.
+  `continue` starts another iteration, `wait` pauses this Run before downstream nodes, `done`
+  continues downstream, and `fail` fails the node. A missing `state` keeps the previous state.
+
+  Each step receives `AGENTFLOW_WHILE_STATE` (JSON), the absolute
+  `AGENTFLOW_WHILE_ITERATION`, `AGENTFLOW_WHILE_MAX_ITERATIONS`,
+  `AGENTFLOW_WHILE_TIMEOUT_MS`, and a stable per-iteration
+  `AGENTFLOW_WHILE_IDEMPOTENCY_KEY`. Pass the idempotency key to external write APIs when they
+  support one. Write progress logs to stderr because stdout is reserved for the decision object.
+  The command also supports the same runtime placeholders as `tool.nodejs`, including
+  `${flowDir}` and `${workspaceRoot}`.
+
+  A waiting checkpoint retains state, history, elapsed active time, and the next absolute
+  iteration. `maxIterations` and `timeout` are cumulative across resumes. A changed input resets
+  the checkpoint; a matching but malformed checkpoint fails closed. Step output is schema-strict
+  and bounded: unknown fields are rejected, state/stdout are limited to 1 MiB, stderr to 256 KiB,
+  and summary to 4000 characters.
+displayName: While
+ui:
+  card:
+    template: state-machine
+    icon: repeat
+    tone: purple
+    sections:
+      - type: binding
+        label: State input
+        input: state
+      - type: loop
+        label: Loop execution
+        field: script
+      - type: decision
+        label: Decision status
+        output: decision
+        source: step.stdout.decision
+        options:
+          - value: continue
+            label: continue
+            tone: purple
+            description: 保存 state 并立即进入下一轮
+          - value: wait
+            label: wait
+            tone: amber
+            description: 保存 checkpoint，暂停当前 Run
+          - value: done
+            label: done
+            tone: green
+            description: 结束循环并继续下游
+          - value: fail
+            label: fail
+            tone: red
+            description: 终止并标记节点失败
+      - type: metrics
+        label: Limits and progress
+        items:
+          - label: Iteration
+            output: iterations
+            maxInput: maxIterations
+          - label: Timeout
+            input: timeout
+      - type: summary
+        label: Latest outcome
+        output: summary
+      - type: history
+        label: Iteration history
+        output: history
+        limit: 3
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: context
+    name: context
+    default: ""
+    showOnNode: true
+  - type: json
+    name: state
+    default: "null"
+  - type: text
+    name: maxIterations
+    default: "20"
+  - type: text
+    name: timeout
+    default: "30m"
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: json
+    name: result
+    default: ""
+  - type: json
+    name: state
+    default: "null"
+  - type: text
+    name: decision
+    default: ""
+    showOnNode: true
+  - type: text
+    name: iterations
+    default: "0"
+    showOnNode: true
+  - type: text
+    name: summary
+    default: ""
+    showOnNode: true
+  - type: json
+    name: history
+    default: "[]"
+  - type: text
+    name: checkpointFingerprint
+    default: ""
+---
+${USER_PROMPT}

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

@@ -0,0 +1,24 @@
+---
+# 内置节点：ASCII 图展示
+runtime: native
+description: Display ASCII diagram content in workspace canvas; passes diagram text downstream as text
+displayName: ASCII Display
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: content
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: text
+    name: content
+    default: ""
+    showOnNode: true
+  - type: node
+    name: next
+    default: ""
+---
+${content}

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

@@ -0,0 +1,32 @@
+---
+# Built-in node: Chart Display
+runtime: native
+description: Display a JSON ChartSpec with ECharts in workspace canvas; passes the JSON downstream as text
+displayName: Chart 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: true
+  - type: node
+    name: next
+    default: ""
+---
+${content}

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

@@ -0,0 +1,39 @@
+---
+# 内置节点：代码展示
+runtime: native
+description: Display source code with language highlighting, line numbers, copy, wrap, and download controls; passes content downstream as text
+displayName: Code Display
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: content
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: language
+    default: ""
+    description: Syntax language such as javascript, typescript, python, kotlin, java, shell, json, yaml, html, css, or sql
+    showOnNode: false
+  - type: text
+    name: fileName
+    default: ""
+    description: Optional file name used when downloading
+    showOnNode: false
+  - type: bool
+    name: wrap
+    default: "false"
+    description: Wrap long source lines by default
+    showOnNode: false
+output:
+  - type: text
+    name: content
+    default: ""
+    showOnNode: true
+  - type: node
+    name: next
+    default: ""
+---
+${content}

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

@@ -0,0 +1,32 @@
+---
+# Built-in node: HTML Display
+runtime: native
+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: true
+  - type: node
+    name: next
+    default: ""
+---
+${content}

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

@@ -0,0 +1,36 @@
+---
+# Built-in node: Image Display
+runtime: native
+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: true
+  - type: node
+    name: next
+    default: ""
+---
+${src}

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

@@ -0,0 +1,24 @@
+---
+# 内置节点：Markdown 展示
+runtime: native
+description: Display Markdown content in workspace canvas; passes content downstream as text
+displayName: Markdown Display
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: content
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: text
+    name: content
+    default: ""
+    showOnNode: true
+  - type: node
+    name: next
+    default: ""
+---
+${content}

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

@@ -0,0 +1,24 @@
+---
+# 内置节点：Mermaid 展示
+runtime: native
+description: Display Mermaid diagram source in workspace canvas; passes diagram source downstream as text
+displayName: Mermaid Display
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: content
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: text
+    name: content
+    default: ""
+    showOnNode: true
+  - type: node
+    name: next
+    default: ""
+---
+${content}

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

@@ -0,0 +1,53 @@
+---
+# Built-in node: React App Display
+runtime: native
+description: Display a small React project in a sandboxed workspace iframe and pass the project JSON downstream
+displayName: React App
+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: true
+  - type: node
+    name: next
+    default: ""
+---
+{
+  "title": "React App",
+  "entry": "src/App.jsx",
+  "packageJson": {
+    "scripts": {
+      "dev": "vite --host 0.0.0.0",
+      "build": "vite build"
+    },
+    "dependencies": {
+      "@vitejs/plugin-react": "latest",
+      "vite": "latest",
+      "react": "latest",
+      "react-dom": "latest"
+    },
+    "devDependencies": {}
+  },
+  "files": {
+    "src/App.jsx": "export default function App() {\\n  return (\\n    <main>\\n      <h1>React App</h1>\\n      <p>Ask an Agent to replace this with a React project.</p>\\n    </main>\\n  );\\n}\\n",
+    "src/styles.css": "body { margin: 0; background: #111112; color: #f4f0ff; font-family: Inter, system-ui, sans-serif; }\\nmain { min-height: 100vh; padding: 24px; }\\nh1 { margin: 0 0 8px; font-size: 28px; }\\np { margin: 0; color: rgba(244, 240, 255, 0.68); }\\n"
+  },
+  "inputs": {}
+}

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

@@ -0,0 +1,32 @@
+---
+# Built-in node: Table Display
+runtime: native
+description: Display table data in workspace canvas; accepts JSON, Markdown table, CSV, or TSV and passes the text downstream
+displayName: Table 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: true
+  - type: node
+    name: next
+    default: ""
+---
+${content}

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

@@ -0,0 +1,14 @@
+---
+# 内置节点：直接提供布尔值
+runtime: native
+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"
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,14 @@
+---
+# 内置节点：直接提供文件
+runtime: native
+description: Provide file path or content directly, value will be passed to downstream as-is
+displayName: File
+input: []
+output:
+  - type: file
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,14 @@
+---
+# 内置节点：直接提供 JSON
+runtime: native
+type: provide
+description: 提供经过校验的 JSON 值，输出可以直接连接 json 类型输入。
+displayName: JSON
+output:
+  - type: json
+    name: value
+    default: "null"
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,14 @@
+---
+# Built-in node: directly provide a hidden password/secret value
+runtime: native
+description: Provide a secret text value without showing it on the node card
+displayName: Password
+input: []
+output:
+  - type: text
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,14 @@
+---
+# 内置节点：直接提供文本
+runtime: native
+description: Provide a text value directly, value will be passed to downstream as-is
+displayName: String
+input: []
+output:
+  - type: text
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,47 @@
+---
+# Built-in node: create share link for Display nodes
+runtime: native
+description: Create a public share link for upstream Display nodes
+displayName: Display Share Link
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: title
+    default: ""
+    description: "可选。分享页标题；只影响打开分享页后的页面标题，不影响输出 URL。为空时使用 AgentFlow Display。"
+    showOnNode: true
+  - type: text
+    name: layout
+    default: "single"
+    description: "可选。分享页布局：single、gallery、slides、document、canvas。通常保持默认 single。"
+    showOnNode: false
+  - type: text
+    name: nodeIds
+    default: ""
+    description: "可选。逗号或空格分隔的 Display 节点 ID；为空时自动分享连接到本节点的上游 Display 节点。"
+    showOnNode: false
+  - type: text
+    name: baseUrl
+    default: ""
+    description: "可选。分享站点地址，例如 https://agentflow.example.com；为空时优先使用环境变量，其次使用当前访问地址。"
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: url
+    default: ""
+    showOnNode: true
+  - type: text
+    name: shareId
+    default: ""
+    showOnNode: false
+  - type: text
+    name: expiresAt
+    default: ""
+    showOnNode: false
+---
+Create a share link for connected Display nodes. Connect a Display node to this node, optionally set title, and use the url output.

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

@@ -0,0 +1,20 @@
+---
+# 内置节点：按 key 读取环境/配置
+runtime: none
+palette: hidden
+description: Get environment variable value
+displayName: GetEnv
+input:
+  - type: text
+    name: key
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: text
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,70 @@
+---
+# 内置节点：Git Checkout
+runtime: native
+description: |
+  Clone or update a Git repository and expose it as a workspace context for downstream nodes.
+
+  - `repoUrl` is required.
+  - `targetDir` may be absolute or relative to the current workspace context.
+  - If `targetDir` is empty, the repository is cloned into `${pipelineWorkspace}/.workspace/agentflow/git-repos/<repo-name>`. For user pipelines, `${pipelineWorkspace}` follows the Admin Settings AgentFlow Data Root.
+  - 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
+    name: prev
+    default: ""
+  - type: text
+    name: repoUrl
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: branch
+    default: ""
+  - type: text
+    name: targetDir
+    default: ""
+  - type: bool
+    name: pullIfExists
+    default: "true"
+  - 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
+    default: ""
+  - type: file
+    name: repoPath
+    default: ""
+  - type: text
+    name: branch
+    default: ""
+  - type: text
+    name: commit
+    default: ""
+  - type: bool
+    name: changed
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: gitContext
+    default: ""
+    required: true
+    showOnNode: true
+---
+Clone or update `${repoUrl}` and output workspace/git contexts for the checked-out repository.