@fieldwangai/agentflow 0.1.32 → 0.1.33

package/bin/pipeline/pre-process-node.mjs

@@ -41,12 +41,15 @@ import { getRunDir, sanitizeAgentflowUserId } from "../lib/paths.mjs";
 import {
   buildSkillsContext,
   buildSkillsContextFromRegistry,
+  buildDefaultWorkspaceContext,
   expandRuntimePlaceholders,
   normalizeSkillsContext,
   normalizeWorkspaceContext,
   parseSkillKeyList,
   resolveWorkspaceTarget,
 } from "../lib/runtime-context.mjs";
+import { buildGitContext, loadGitWorktree, normalizeGitContext, unloadGitWorktree } from "../lib/git-worktree.mjs";
+import { createGitLabMergeRequest } from "../lib/gitlab-mr.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -264,6 +267,12 @@ function isTruthyInput(value) {
   return text === "true" || text === "1" || text === "yes" || text === "y" || text === "on";
 }
 
+function resolveMaybeWorkspacePath(raw, workspaceContext, extra = {}) {
+  const text = String(raw || "").trim();
+  if (!text) return "";
+  return resolveWorkspaceTarget(text, workspaceContext, extra);
+}
+
 function emitGitCheckoutNode(workspaceRoot, flowName, uuid, instanceId, execId, resultPathRel) {
   const runDir = getRunDir(workspaceRoot, flowName, uuid);
   const { inputs, workspaceContext } = resolveNodeRuntimeContexts(workspaceRoot, flowName, uuid, instanceId);
@@ -312,6 +321,12 @@ function emitGitCheckoutNode(workspaceRoot, flowName, uuid, instanceId, execId,
 
   const currentBranch = runGit(["rev-parse", "--abbrev-ref", "HEAD"], targetDir).stdout.trim();
   const commit = runGit(["rev-parse", "HEAD"], targetDir).stdout.trim();
+  const gitContext = buildGitContext({
+    repoPath: targetDir,
+    branch: currentBranch === "HEAD" ? "DETACHED" : currentBranch,
+    commit,
+    remote: String(inputs.remote || "origin").trim() || "origin",
+  });
   const outWorkspaceContext = {
     version: 1,
     label: inputs.label || sanitizeRepoDirName(repoUrl),
@@ -326,10 +341,127 @@ function emitGitCheckoutNode(workspaceRoot, flowName, uuid, instanceId, execId,
   writeOutputSlot(runDir, instanceId, execId, "commit", commit);
   writeOutputSlot(runDir, instanceId, execId, "changed", changed ? "true" : "false");
   writeOutputSlot(runDir, instanceId, execId, "workspaceContext", JSON.stringify(outWorkspaceContext));
+  writeOutputSlot(runDir, instanceId, execId, "gitContext", JSON.stringify(gitContext));
   writeResult(workspaceRoot, flowName, uuid, instanceId, { status: "success", message: `git ${action}: ${currentBranch}@${commit.slice(0, 8)}` }, { execId });
   return emitLocalNoopPrompt(workspaceRoot, runDir, instanceId, "git-checkout", `Git checkout completed: ${targetDir}\n`);
 }
 
+function requireWorkspaceContextInput(inputs, definitionId) {
+  if (!String(inputs?.workspaceContext || "").trim()) {
+    throw new Error(`${definitionId}: workspaceContext is required`);
+  }
+}
+
+function emitGitWorktreeLoadNode(workspaceRoot, flowName, uuid, instanceId, execId) {
+  const runDir = getRunDir(workspaceRoot, flowName, uuid);
+  const { inputs, workspaceContext } = resolveNodeRuntimeContexts(workspaceRoot, flowName, uuid, instanceId);
+  requireWorkspaceContextInput(inputs, "tool_git_worktree_load");
+  const gitContext = normalizeGitContext(inputs.gitContext);
+  const repoPath = resolveMaybeWorkspacePath(inputs.repoPath, workspaceContext) ||
+    (gitContext?.repoPath ? path.resolve(gitContext.repoPath) : "");
+  if (!repoPath) throw new Error("tool_git_worktree_load: repoPath or gitContext.repoPath is required");
+  const branch = String(inputs.branch || "").trim();
+  const worktreePath = resolveMaybeWorkspacePath(inputs.worktreePath, workspaceContext, { branch }) ||
+    (gitContext?.worktreePath ? path.resolve(gitContext.worktreePath) : "");
+  const result = loadGitWorktree({
+    repoPath,
+    branch,
+    worktreePath,
+    pipelineWorkspace: workspaceContext.pipelineWorkspace || path.resolve(workspaceRoot),
+  });
+  const outWorkspaceContext = {
+    version: 1,
+    label: result.branch === "DETACHED" ? `worktree:${result.commit.slice(0, 8)}` : `worktree:${result.branch}`,
+    cwd: result.worktreePath,
+    workspaceRoot: result.worktreePath,
+    pipelineWorkspace: workspaceContext.pipelineWorkspace || path.resolve(workspaceRoot),
+    flowDir: workspaceContext.flowDir,
+    previous: workspaceContext,
+  };
+  const outGitContext = buildGitContext({
+    repoPath: result.repoRoot,
+    worktreePath: result.worktreePath,
+    branch: result.branch,
+    commit: result.commit,
+    remote: gitContext?.remote || "origin",
+    remoteUrl: gitContext?.remoteUrl || "",
+  });
+  writeOutputSlot(runDir, instanceId, execId, "worktreePath", result.worktreePath);
+  writeOutputSlot(runDir, instanceId, execId, "branch", result.branch);
+  writeOutputSlot(runDir, instanceId, execId, "commit", result.commit);
+  writeOutputSlot(runDir, instanceId, execId, "workspaceContext", JSON.stringify(outWorkspaceContext));
+  writeOutputSlot(runDir, instanceId, execId, "gitContext", JSON.stringify(outGitContext));
+  writeResult(workspaceRoot, flowName, uuid, instanceId, {
+    status: "success",
+    message: `worktree loaded: ${result.worktreePath} (${result.branch}@${result.commit.slice(0, 8)})`,
+  }, { execId });
+  return emitLocalNoopPrompt(workspaceRoot, runDir, instanceId, "git-worktree-load", `Git worktree loaded: ${result.worktreePath}\n`);
+}
+
+function emitGitWorktreeUnloadNode(workspaceRoot, flowName, uuid, instanceId, execId) {
+  const runDir = getRunDir(workspaceRoot, flowName, uuid);
+  const { inputs, workspaceContext, flowJson } = resolveNodeRuntimeContexts(workspaceRoot, flowName, uuid, instanceId);
+  requireWorkspaceContextInput(inputs, "tool_git_worktree_unload");
+  const gitContext = normalizeGitContext(inputs.gitContext);
+  const repoPath = resolveMaybeWorkspacePath(inputs.repoPath, workspaceContext) ||
+    (gitContext?.repoPath ? path.resolve(gitContext.repoPath) : "");
+  const worktreePath = resolveMaybeWorkspacePath(inputs.worktreePath, workspaceContext) ||
+    (gitContext?.worktreePath ? path.resolve(gitContext.worktreePath) : "");
+  if (!repoPath) throw new Error("tool_git_worktree_unload: repoPath or gitContext.repoPath is required");
+  if (!worktreePath) throw new Error("tool_git_worktree_unload: worktreePath or gitContext.worktreePath is required");
+  const force = isTruthyInput(inputs.force);
+  const prune = String(inputs.prune ?? "true").trim().toLowerCase() !== "false";
+  const result = unloadGitWorktree({ repoPath, worktreePath, force, prune });
+  const nextWorkspaceContext = workspaceContext.previous
+    ? normalizeWorkspaceContext(workspaceContext.previous, workspaceRoot, flowName, flowJson)
+    : buildDefaultWorkspaceContext(workspaceRoot, flowName, flowJson);
+  writeOutputSlot(runDir, instanceId, execId, "removed", "true");
+  writeOutputSlot(runDir, instanceId, execId, "message", result.message);
+  writeOutputSlot(runDir, instanceId, execId, "workspaceContext", JSON.stringify(nextWorkspaceContext));
+  writeResult(workspaceRoot, flowName, uuid, instanceId, {
+    status: "success",
+    message: result.message,
+  }, { execId });
+  return emitLocalNoopPrompt(workspaceRoot, runDir, instanceId, "git-worktree-unload", `${result.message}\n`);
+}
+
+async function emitGitLabCreateMrNode(workspaceRoot, flowName, uuid, instanceId, execId) {
+  const runDir = getRunDir(workspaceRoot, flowName, uuid);
+  const { inputs, workspaceContext } = resolveNodeRuntimeContexts(workspaceRoot, flowName, uuid, instanceId);
+  const repoPath = resolveMaybeWorkspacePath(inputs.repoPath, workspaceContext);
+  const result = await createGitLabMergeRequest({
+    gitContext: inputs.gitContext,
+    workspaceCwd: workspaceContext.cwd,
+    repoPath,
+    sourceBranch: inputs.sourceBranch,
+    targetBranch: inputs.targetBranch,
+    title: inputs.title,
+    description: inputs.description,
+    draft: inputs.draft,
+    labels: inputs.labels,
+    push: inputs.push,
+    remote: inputs.remote,
+    tokenEnv: inputs.tokenEnv,
+    gitlabApiBase: inputs.gitlabApiBase,
+    removeSourceBranch: inputs.removeSourceBranch,
+    squash: inputs.squash,
+  }, process.env);
+  writeOutputSlot(runDir, instanceId, execId, "mrUrl", result.mrUrl);
+  writeOutputSlot(runDir, instanceId, execId, "created", result.created ? "true" : "false");
+  writeOutputSlot(runDir, instanceId, execId, "mrIid", result.mrIid ?? "");
+  writeOutputSlot(runDir, instanceId, execId, "projectId", result.projectId ?? "");
+  writeOutputSlot(runDir, instanceId, execId, "sourceBranch", result.sourceBranch ?? "");
+  writeOutputSlot(runDir, instanceId, execId, "targetBranch", result.targetBranch ?? "");
+  writeOutputSlot(runDir, instanceId, execId, "title", result.title ?? "");
+  writeOutputSlot(runDir, instanceId, execId, "message", result.message ?? "");
+  writeResult(workspaceRoot, flowName, uuid, instanceId, {
+    status: "success",
+    message: result.message || result.mrUrl,
+    body: result.mrUrl,
+  }, { execId });
+  return emitLocalNoopPrompt(workspaceRoot, runDir, instanceId, "gitlab-create-mr", `${result.message || "GitLab MR ready"}\n${result.mrUrl}\n`);
+}
+
 function emitCdWorkspaceNode(workspaceRoot, flowName, uuid, instanceId, execId) {
   const runDir = getRunDir(workspaceRoot, flowName, uuid);
   const { inputs, workspaceContext } = resolveNodeRuntimeContexts(workspaceRoot, flowName, uuid, instanceId);
@@ -461,7 +593,7 @@ function emitToolPrintNode(workspaceRoot, flowName, uuid, instanceId, execId) {
   const flowJson = readFlowJsonObject(workspaceRoot, flowName, uuid);
   const data = getResolvedValues(workspaceRoot, flowName, uuid, instanceId);
   const inputs = data.ok ? (data.resolvedInputs || {}) : {};
-  const skipNames = new Set(["prev", "next", "workspaceContext", "skillsContext", "workspaceRoot", "pipelineWorkspace", "flowName", "runDir", "flowDir", "cwd"]);
+  const skipNames = new Set(["prev", "next", "workspaceContext", "gitContext", "skillsContext", "workspaceRoot", "pipelineWorkspace", "flowName", "runDir", "flowDir", "cwd"]);
 
   let content = readPrintableValue(inputs.content, runDir);
   if (!content) {
@@ -681,7 +813,7 @@ ${directCommand}
   return { optionalPromptPath: relativePath.replace(/\\/g, "/"), directCommand };
 }
 
-function main() {
+async function main() {
   const args = process.argv.slice(2);
   if (args.length < 4) {
     console.error(
@@ -1001,18 +1133,24 @@ function main() {
     return;
   }
 
-  if (definitionId === "tool_git_checkout" || definitionId === "control_cd_workspace" || definitionId === "control_user_workspace" || definitionId === "control_load_skills" || definitionId === "tool_print") {
+  if (definitionId === "tool_git_checkout" || definitionId === "tool_git_worktree_load" || definitionId === "tool_git_worktree_unload" || definitionId === "tool_gitlab_create_mr" || definitionId === "control_cd_workspace" || definitionId === "control_user_workspace" || definitionId === "control_load_skills" || definitionId === "tool_print") {
     try {
       const promptPath =
         definitionId === "tool_git_checkout"
           ? emitGitCheckoutNode(workspaceRoot, flowName, uuid, instanceId, execId, resultPathRel)
-          : definitionId === "control_cd_workspace"
-            ? emitCdWorkspaceNode(workspaceRoot, flowName, uuid, instanceId, execId)
-            : definitionId === "control_user_workspace"
-              ? emitUserWorkspaceNode(workspaceRoot, flowName, uuid, instanceId, execId)
-              : definitionId === "control_load_skills"
-                ? emitLoadSkillsNode(workspaceRoot, flowName, uuid, instanceId, execId)
-                : emitToolPrintNode(workspaceRoot, flowName, uuid, instanceId, execId);
+          : definitionId === "tool_git_worktree_load"
+            ? emitGitWorktreeLoadNode(workspaceRoot, flowName, uuid, instanceId, execId)
+            : definitionId === "tool_git_worktree_unload"
+              ? emitGitWorktreeUnloadNode(workspaceRoot, flowName, uuid, instanceId, execId)
+              : definitionId === "tool_gitlab_create_mr"
+                ? await emitGitLabCreateMrNode(workspaceRoot, flowName, uuid, instanceId, execId)
+                : definitionId === "control_cd_workspace"
+                  ? emitCdWorkspaceNode(workspaceRoot, flowName, uuid, instanceId, execId)
+                  : definitionId === "control_user_workspace"
+                    ? emitUserWorkspaceNode(workspaceRoot, flowName, uuid, instanceId, execId)
+                    : definitionId === "control_load_skills"
+                      ? emitLoadSkillsNode(workspaceRoot, flowName, uuid, instanceId, execId)
+                      : emitToolPrintNode(workspaceRoot, flowName, uuid, instanceId, execId);
       writeCacheJsonForNode(workspaceRoot, flowName, uuid, instanceId, execId);
       logToRunTag(workspaceRoot, flowName, uuid, "pre-process", { event: "runtime-context-node", instanceId, definitionId });
       console.log(JSON.stringify({
@@ -1103,4 +1241,7 @@ function main() {
   console.log(JSON.stringify(output));
 }
 
-main();
+main().catch((e) => {
+  console.error(JSON.stringify({ ok: false, error: e.message || String(e) }));
+  process.exit(1);
+});

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}`.