@fieldwangai/agentflow 0.1.159 → 0.1.162

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

@@ -0,0 +1,34 @@
+---
+# 内置节点：子 Agent
+runtime: native
+description: 利用子 Agent 执行任务；可接收 knowledgeContext 读取知识库，可接收 workspaceContext 切换执行工作区，并接收 skillsContext / mcpContext 注入已加载 skills 与 MCP 工具清单。
+displayName: 子 Agent
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+  - type: text
+    name: skillsContext
+    default: ""
+    showOnNode: true
+  - type: text
+    name: mcpContext
+    default: ""
+  - type: text
+    name: knowledgeContext
+    default: ""
+    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/control_agent_toBool.md

@@ -0,0 +1,26 @@
+---
+# 内置节点：AI 转布尔（agent 执行）
+runtime: degraded
+palette: hidden
+description: "AI-powered boolean judgment: an agent evaluates the input value and writes true/false to prediction. Use for non-deterministic scenarios requiring semantic understanding."
+displayName: Agent ToBool
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: bool
+    name: prediction
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,19 @@
+---
+# 内置节点：任一满足
+runtime: none
+palette: hidden
+description: Continues to next when any upstream input is ready
+displayName: AnyOne
+input:
+  - type: node
+    name: prev1
+    default: ""
+  - type: node
+    name: prev2
+    default: ""
+output:
+  - type: node
+    name: next
+    default: ""
+---
+${USER_PROMPT}

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

@@ -0,0 +1,26 @@
+---
+# 内置节点：取消判断
+runtime: none
+palette: hidden
+description: Check whether the current wait/run has been cancelled. Use cancelled output with control_if.
+displayName: Cancel Check
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: waitId
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: bool
+    name: cancelled
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,50 @@
+---
+# 内置节点：加载知识库
+runtime: native
+type: control
+description: |
+  Load one or more read-only knowledge sources for downstream Agent nodes.
+
+  This node does not change the runtime cwd. It publishes `knowledgeContext`
+  for reading/searching referenced repos or folders. `workspaceContext` and
+  `cwd` are retained as legacy compatibility outputs for the first source.
+displayName: 加载知识库
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: path
+    default: ""
+    showOnNode: false
+  - type: text
+    name: label
+    default: ""
+    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: knowledgeContext
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: workspaceContext
+    default: ""
+    showOnNode: false
+  - type: file
+    name: cwd
+    default: ""
+    showOnNode: false
+---
+Load selected knowledge sources for downstream agents.

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

@@ -0,0 +1,31 @@
+---
+# 内置节点：延迟等待
+runtime: none
+palette: hidden
+description: Persistently wait for a relative duration, then continue when scheduler resumes this run.
+displayName: Delay
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: duration
+    default: "10m"
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: waitId
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: wakeAt
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,13 @@
+---
+# 内置节点：结束
+runtime: none
+palette: hidden
+description: End point of AgentFlow, flow terminates after this node
+displayName: End
+input:
+  - type: node
+    name: prev
+    default: ""
+output: []
+---
+${USER_PROMPT}

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

@@ -0,0 +1,21 @@
+---
+# 内置节点：If 分支
+runtime: native
+description: Has exactly one bool type input. Continues to next1 if true, next2 if false
+displayName: If
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: bool
+    name: prediction
+    default: ""
+output:
+  - type: node
+    name: next1
+    default: ""
+  - type: node
+    name: next2
+    default: ""
+---
+${USER_PROMPT}

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

@@ -0,0 +1,55 @@
+---
+# 内置节点：间隔循环
+runtime: none
+palette: hidden
+description: Wait by interval and branch to continue, done, timeout, or cancelled for watch-style flows.
+displayName: IntervalLoop
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: bool
+    name: done
+    default: ""
+  - type: bool
+    name: cancelled
+    default: ""
+  - type: text
+    name: interval
+    default: "10m"
+  - type: text
+    name: startAt
+    default: ""
+  - type: text
+    name: duration
+    default: ""
+  - type: text
+    name: deadlineAt
+    default: ""
+  - type: text
+    name: timezone
+    default: "Asia/Shanghai"
+output:
+  - type: node
+    name: continue
+    default: ""
+  - type: node
+    name: done
+    default: ""
+  - type: node
+    name: timeout
+    default: ""
+  - type: node
+    name: cancelled
+    default: ""
+  - type: text
+    name: wakeAt
+    default: ""
+  - type: bool
+    name: expired
+    default: ""
+  - type: text
+    name: deadlineAt
+    default: ""
+---
+${USER_PROMPT}

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

@@ -0,0 +1,24 @@
+---
+# 内置节点：Load MCP
+runtime: native
+type: control
+description: 加载所选 Cursor MCP Server 的工具清单，通过 mcpContext 传给下游 agent 节点。
+displayName: Load MCP
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: serverNames
+    default: ""
+    showOnNode: false
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: mcpContext
+    default: ""
+    showOnNode: true
+---
+Load selected Cursor MCP server tool manifests for downstream agent nodes.

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

@@ -0,0 +1,35 @@
+---
+# 内置节点：Load Skills
+runtime: native
+type: control
+description: |
+  Load the currently selected Workspace skill collection for downstream agent nodes.
+
+  Set `skillKeys` to skill names or registry keys, then connect `skillsContext` to
+  downstream agent/tool nodes. Loaded skills are injected into the node prompt under
+  "已加载 Skills"。
+
+  Skill key examples:
+  - `agentflow-flow-add-instances`
+  - `workspace-agents:agentflow-flow-edit-node-fields`
+  - `global-codex:some-skill`
+displayName: Load Skills
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: skillKeys
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: skillsContext
+    default: ""
+    showOnNode: true
+---
+Load public skills `${skillKeys}` and pass them to downstream nodes.

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

@@ -0,0 +1,25 @@
+---
+# 内置节点：解析 JSON
+runtime: native
+type: control
+description: 显式解析并校验文本 JSON，成功后输出 json 类型；解析失败会终止本次运行。
+displayName: Parse JSON
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: json
+    name: result
+    default: "null"
+    showOnNode: true
+---
+Parse a text value as JSON and expose the validated result through a typed output.

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

@@ -0,0 +1,13 @@
+---
+# 内置节点：开始
+runtime: none
+palette: hidden
+description: Entry point of AgentFlow, all flows should start from this node
+displayName: Start
+input: []
+output:
+  - type: node
+    name: next
+    default: ""
+---
+${USER_PROMPT}

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

@@ -0,0 +1,27 @@
+---
+# 内置节点：调用子流程
+runtime: native
+type: control
+palette: hidden
+description: |
+  调用 workspace.flow.js 中由 flow.subflow 声明的同 Workspace 子流程。
+  输入和输出槽来自子流程契约；每次调用使用独立调用帧，内部节点仍按标准 AgentFlow DSL 和运行时执行。
+displayName: Call Subflow
+ui:
+  card:
+    template: details
+    icon: account_tree
+    tone: purple
+    sections:
+      - type: subflow
+        label: Called subflow
+input:
+  - type: node
+    name: prev
+    default: ""
+output:
+  - type: node
+    name: next
+    default: ""
+---
+Execute the referenced inline subflow using its declared input and output contract.

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

@@ -0,0 +1,27 @@
+---
+# 内置节点：代码转布尔（本地脚本执行，★ 可扩展输入）
+runtime: none
+palette: hidden
+description: "Script-based boolean conversion: executes script to produce true/false prediction. Like tool_nodejs but enforces bool output. Must have script field."
+displayName: Code ToBool
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: value
+    default: ""
+    required: true
+    showOnNode: true
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: bool
+    name: prediction
+    default: ""
+    required: true
+    showOnNode: true
+extensible: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,24 @@
+---
+# Built-in node: User Workspace
+runtime: native
+palette: hidden
+description: Output a workspace context pointing to the current user's home directory.
+displayName: User Workspace
+input:
+  - type: node
+    name: prev
+    default: ""
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: workspaceContext
+    default: ""
+    required: true
+    showOnNode: true
+  - type: file
+    name: cwd
+    default: ""
+---
+Use the current user's home directory as downstream workspace context.

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

@@ -0,0 +1,34 @@
+---
+# 内置节点：等待到指定时间
+runtime: none
+palette: hidden
+description: Persistently wait until an absolute time, then continue when scheduler resumes this run.
+displayName: WaitUntil
+input:
+  - type: node
+    name: prev
+    default: ""
+  - type: text
+    name: until
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: timezone
+    default: "Asia/Shanghai"
+output:
+  - type: node
+    name: next
+    default: ""
+  - type: text
+    name: waitId
+    default: ""
+    required: true
+    showOnNode: true
+  - type: text
+    name: wakeAt
+    default: ""
+    required: true
+    showOnNode: true
+---
+${USER_PROMPT}

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

@@ -0,0 +1,124 @@
+---
+# 内置节点：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)`.
+  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: 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}