agentweaver 0.1.15 → 0.1.17

package/dist/pipeline/flow-specs/review/review.json

@@ -9,39 +9,17 @@
         {
           "id": "run_review",
           "node": "llm-prompt",
+          "routingGroup": "review",
           "prompt": {
             "templateRef": "review",
             "vars": {
-              "jira_task_file": {
-                "artifact": {
-                  "kind": "jira-task-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "design_file": {
-                "artifact": {
-                  "kind": "design-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "design_json_file": {
-                "artifact": {
-                  "kind": "design-json-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "plan_file": {
-                "artifact": {
-                  "kind": "plan-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
-              "plan_json_file": {
-                "artifact": {
-                  "kind": "plan-json-file",
-                  "taskKey": { "ref": "params.taskKey" }
-                }
-              },
+              "task_context_json_file": { "ref": "params.taskContextJsonFile" },
+              "jira_task_file": { "ref": "params.jiraTaskFile" },
+              "task_input_json_file": { "ref": "params.taskInputJsonFile" },
+              "design_file": { "ref": "params.designFile" },
+              "design_json_file": { "ref": "params.designJsonFile" },
+              "plan_file": { "ref": "params.planFile" },
+              "plan_json_file": { "ref": "params.planJsonFile" },
               "review_file": {
                 "artifact": {
                   "kind": "review-file",
@@ -68,7 +46,25 @@
               }
             },
             "model": { "ref": "params.llmModel" },
-            "executor": { "ref": "params.llmExecutor" }
+            "executor": { "ref": "params.llmExecutor" },
+            "requiredArtifacts": {
+              "list": [
+                {
+                  "artifact": {
+                    "kind": "review-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                },
+                {
+                  "artifact": {
+                    "kind": "review-json-file",
+                    "taskKey": { "ref": "params.taskKey" },
+                    "iteration": { "ref": "params.iteration" }
+                  }
+                }
+              ]
+            }
           },
           "expect": [
             {
@@ -106,6 +102,16 @@
             }
           ]
         },
+        {
+          "id": "review_verdict",
+          "node": "review-verdict",
+          "when": { "not": { "ref": "context.dryRun" } },
+          "params": {
+            "taskKey": { "ref": "params.taskKey" },
+            "iteration": { "ref": "params.iteration" },
+            "blockingSeverities": { "ref": "params.reviewBlockingSeverities" }
+          }
+        },
         {
           "id": "check_ready_to_merge",
           "node": "file-check",

package/dist/pipeline/flow-specs/task-describe.json

@@ -153,6 +153,7 @@
         {
           "id": "run_task_describe_from_jira",
           "node": "llm-prompt",
+          "routingGroup": "planning",
           "when": {
             "ref": "steps.task_describe.collect_task_source.value.values.jira_ref"
           },
@@ -285,6 +286,7 @@
         {
           "id": "run_task_describe_from_input",
           "node": "llm-prompt",
+          "routingGroup": "planning",
           "when": {
             "not": {
               "ref": "steps.task_describe.collect_task_source.value.values.jira_ref"

package/dist/pipeline/flow-specs/task-source/jira-fetch.json

@@ -0,0 +1,70 @@
+{
+  "kind": "task-source-jira-flow",
+  "version": 1,
+  "description": "Fetches raw Jira task context and attachments into scope artifacts for subsequent normalization.",
+  "catalogVisibility": "hidden",
+  "phases": [
+    {
+      "id": "source",
+      "steps": [
+        {
+          "id": "fetch_jira",
+          "node": "jira-fetch",
+          "params": {
+            "jiraApiUrl": { "ref": "params.jiraApiUrl" },
+            "outputFile": {
+              "artifact": {
+                "kind": "jira-task-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            },
+            "attachmentsManifestFile": {
+              "artifact": {
+                "kind": "jira-attachments-manifest-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            },
+            "attachmentsContextFile": {
+              "artifact": {
+                "kind": "jira-attachments-context-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-file",
+              "path": {
+                "artifact": {
+                  "kind": "jira-task-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "message": "Jira fetch node did not produce the Jira task file."
+            },
+            {
+              "kind": "require-file",
+              "path": {
+                "artifact": {
+                  "kind": "jira-attachments-manifest-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "message": "Jira fetch node did not produce the Jira attachments manifest file."
+            },
+            {
+              "kind": "require-file",
+              "path": {
+                "artifact": {
+                  "kind": "jira-attachments-context-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              },
+              "message": "Jira fetch node did not produce the Jira attachments context file."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/flow-specs/task-source/manual-input.json

@@ -0,0 +1,216 @@
+{
+  "kind": "task-source-manual-flow",
+  "version": 1,
+  "description": "Collects manual task input in the current project scope for subsequent normalization and planning. Stored input is reused on reruns and can be edited on interactive restart.",
+  "catalogVisibility": "hidden",
+  "phases": [
+    {
+      "id": "source",
+      "steps": [
+        {
+          "id": "edit_task_source",
+          "when": {
+            "all": [
+              {
+                "ref": "params.repromptInstantTaskInput"
+              },
+              {
+                "exists": {
+                  "artifact": {
+                    "kind": "instant-task-input-json-file",
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                }
+              }
+            ]
+          },
+          "node": "user-input",
+          "params": {
+            "formId": { "const": "instant-task-input" },
+            "title": { "const": "Instant Task Input" },
+            "description": {
+              "const": "Review and edit the saved instant-task request for this branch-derived lineage before restarting planning."
+            },
+            "submitLabel": { "const": "Restart planning" },
+            "fields": {
+              "list": [
+                {
+                  "const": {
+                    "id": "task_description",
+                    "type": "text",
+                    "label": "Task description",
+                    "help": "Update the requested work for this restart. Leave the field empty to keep the current value.",
+                    "required": true,
+                    "multiline": true,
+                    "rows": 5,
+                    "placeholder": "e.g. add an instant-task command that runs planning, implementation, and review without Jira"
+                  }
+                },
+                {
+                  "const": {
+                    "id": "additional_instructions",
+                    "type": "text",
+                    "label": "Additional instructions",
+                    "help": "Update optional constraints, references, or implementation notes for this restart.",
+                    "required": false,
+                    "multiline": true,
+                    "rows": 4,
+                    "placeholder": "e.g. keep the existing Jira-backed flows unchanged, add tests for review routing"
+                  }
+                }
+              ]
+            },
+            "initialValues": { "ref": "params.prefilledInstantTaskInputValues" },
+            "outputFile": {
+              "artifact": {
+                "kind": "instant-task-input-json-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "instant-task-input-json-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  },
+                  "schemaId": "user-input/v1"
+                }
+              ],
+              "message": "Instant-task source input is missing or invalid."
+            }
+          ]
+        },
+        {
+          "id": "collect_task_source",
+          "when": {
+            "not": {
+              "exists": {
+                "artifact": {
+                  "kind": "instant-task-input-json-file",
+                  "taskKey": { "ref": "params.taskKey" }
+                }
+              }
+            }
+          },
+          "node": "user-input",
+          "params": {
+            "formId": { "const": "instant-task-input" },
+            "title": { "const": "Instant Task Input" },
+            "description": {
+              "const": "Describe the task for this branch-derived lineage. The saved task input will be reused on reruns unless you choose interactive restart and edit it."
+            },
+            "submitLabel": { "const": "Start planning" },
+            "fields": {
+              "list": [
+                {
+                  "const": {
+                    "id": "task_description",
+                    "type": "text",
+                    "label": "Task description",
+                    "help": "Describe the requested work. This text becomes the source-of-truth input for the instant-task lineage.",
+                    "required": true,
+                    "multiline": true,
+                    "rows": 5,
+                    "placeholder": "e.g. add an instant-task command that runs planning, implementation, and review without Jira"
+                  }
+                },
+                {
+                  "const": {
+                    "id": "additional_instructions",
+                    "type": "text",
+                    "label": "Additional instructions",
+                    "help": "Optional extra constraints, references, or implementation notes for the same task lineage.",
+                    "required": false,
+                    "multiline": true,
+                    "rows": 4,
+                    "placeholder": "e.g. keep the existing Jira-backed flows unchanged, add tests for review routing"
+                  }
+                }
+              ]
+            },
+            "outputFile": {
+              "artifact": {
+                "kind": "instant-task-input-json-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "instant-task-input-json-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  },
+                  "schemaId": "user-input/v1"
+                }
+              ],
+              "message": "Instant-task source input is missing or invalid."
+            }
+          ]
+        },
+        {
+          "id": "validate_task_source_artifact",
+          "when": {
+            "all": [
+              {
+                "not": {
+                  "ref": "params.repromptInstantTaskInput"
+                }
+              },
+              {
+                "exists": {
+                  "artifact": {
+                    "kind": "instant-task-input-json-file",
+                    "taskKey": { "ref": "params.taskKey" }
+                  }
+                }
+              }
+            ]
+          },
+          "node": "file-check",
+          "params": {
+            "path": {
+              "artifact": {
+                "kind": "instant-task-input-json-file",
+                "taskKey": { "ref": "params.taskKey" }
+              }
+            },
+            "panelTitle": { "const": "Instant Task Source Artifact" },
+            "foundMessage": {
+              "const": "Validated the saved instant-task source artifact before continuing planning."
+            },
+            "tone": { "const": "cyan" }
+          },
+          "expect": [
+            {
+              "kind": "require-structured-artifacts",
+              "items": [
+                {
+                  "path": {
+                    "artifact": {
+                      "kind": "instant-task-input-json-file",
+                      "taskKey": { "ref": "params.taskKey" }
+                    }
+                  },
+                  "schemaId": "user-input/v1"
+                }
+              ],
+              "message": "Instant-task source input is missing or invalid."
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/pipeline/launch-profile-config.js

@@ -1,32 +1,44 @@
-export const LLM_EXECUTOR_IDS = ["codex", "opencode"];
-export const ALLOWED_MODELS_BY_EXECUTOR = {
-    codex: ["gpt-5.4", "gpt-5.4-mini", "gpt-5.3-codex"],
-    opencode: ["opencode/minimax-m2.5-free", "minimax-coding-plan/MiniMax-M2.7", "zhipuai-coding-plan/glm-5.1", "zhipuai-coding-plan/glm-4.7"],
-};
+import { createExecutorRegistry } from "./registry.js";
+const BUILT_IN_EXECUTOR_REGISTRY = createExecutorRegistry();
 export const DEFAULT_EXECUTOR = "opencode";
-export const DEFAULT_MODEL_BY_EXECUTOR = {
-    codex: "gpt-5.4",
-    opencode: "minimax-coding-plan/MiniMax-M2.7",
-};
 export const DEFAULT_LAUNCH_PROFILE = {
     executor: DEFAULT_EXECUTOR,
-    model: DEFAULT_MODEL_BY_EXECUTOR[DEFAULT_EXECUTOR],
+    model: "minimax-coding-plan/MiniMax-M2.7",
 };
-export function defaultModelForExecutor(executor) {
-    return DEFAULT_MODEL_BY_EXECUTOR[executor];
+function registryOrBuiltIn(executors) {
+    return executors ?? BUILT_IN_EXECUTOR_REGISTRY;
+}
+export function llmExecutorIds(executors) {
+    return registryOrBuiltIn(executors).llmExecutors().map((entry) => entry.id);
+}
+export function defaultModelForExecutor(executor, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(executor);
+    if (!routing || routing.kind !== "llm") {
+        throw new Error(`Unsupported llm executor '${executor}'.`);
+    }
+    return routing.defaultModel;
+}
+export function isLlmExecutorId(value, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(value);
+    return routing?.kind === "llm";
 }
-export function isLlmExecutorId(value) {
-    return LLM_EXECUTOR_IDS.includes(value);
+export function isAllowedModelForExecutor(executor, model, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(executor);
+    return routing?.kind === "llm" ? routing.models.includes(model) : false;
 }
-export function isAllowedModelForExecutor(executor, model) {
-    return ALLOWED_MODELS_BY_EXECUTOR[executor].includes(model);
+export function allowedModelsForExecutor(executor, executors) {
+    const routing = registryOrBuiltIn(executors).getRouting(executor);
+    if (!routing || routing.kind !== "llm") {
+        throw new Error(`Unsupported llm executor '${executor}'.`);
+    }
+    return [...routing.models];
 }
-export function resolveLaunchProfile(selection, fallback = DEFAULT_LAUNCH_PROFILE) {
+export function resolveLaunchProfile(selection, fallback = DEFAULT_LAUNCH_PROFILE, executors) {
     const executor = selection.executor === "default" ? fallback.executor : selection.executor;
     const model = selection.model === "default"
         ? selection.executor === "default"
             ? fallback.model
-            : defaultModelForExecutor(executor)
+            : defaultModelForExecutor(executor, executors)
         : selection.model;
     return {
         executor,

package/dist/pipeline/node-contract.js

@@ -0,0 +1 @@
+export {};

package/dist/pipeline/node-registry.js

@@ -1,8 +1,10 @@
 import { buildFailureSummaryNode } from "./nodes/build-failure-summary-node.js";
 import { buildReviewFixPromptNode } from "./nodes/build-review-fix-prompt-node.js";
+import { clearReadyToMergeNode } from "./nodes/clear-ready-to-merge-node.js";
 import { codexPromptNode } from "./nodes/codex-prompt-node.js";
 import { commandCheckNode } from "./nodes/command-check-node.js";
 import { commitMessageFormNode } from "./nodes/commit-message-form-node.js";
+import { designReviewVerdictNode } from "./nodes/design-review-verdict-node.js";
 import { ensureSummaryJsonNode } from "./nodes/ensure-summary-json-node.js";
 import { fetchGitLabDiffNode } from "./nodes/fetch-gitlab-diff-node.js";
 import { fetchGitLabReviewNode } from "./nodes/fetch-gitlab-review-node.js";
@@ -19,20 +21,62 @@ import { localScriptCheckNode } from "./nodes/local-script-check-node.js";
 import { llmPromptNode } from "./nodes/llm-prompt-node.js";
 import { opencodePromptNode } from "./nodes/opencode-prompt-node.js";
 import { planCodexNode } from "./nodes/plan-codex-node.js";
+import { planningBundleNode } from "./nodes/planning-bundle-node.js";
 import { planningQuestionsFormNode } from "./nodes/planning-questions-form-node.js";
 import { readFileNode } from "./nodes/read-file-node.js";
 import { reviewFindingsFormNode } from "./nodes/review-findings-form-node.js";
+import { reviewVerdictNode } from "./nodes/review-verdict-node.js";
 import { selectFilesFormNode } from "./nodes/select-files-form-node.js";
+import { structuredSummaryNode } from "./nodes/structured-summary-node.js";
 import { summaryFileLoadNode } from "./nodes/summary-file-load-node.js";
 import { telegramNotifierNode } from "./nodes/telegram-notifier-node.js";
 import { userInputNode } from "./nodes/user-input-node.js";
 import { writeSelectionFileNode } from "./nodes/write-selection-file-node.js";
+import { TaskRunnerError } from "../errors.js";
+export const BUILT_IN_NODE_KINDS = [
+    "build-failure-summary",
+    "build-review-fix-prompt",
+    "clear-ready-to-merge",
+    "codex-prompt",
+    "command-check",
+    "commit-message-form",
+    "design-review-verdict",
+    "ensure-summary-json",
+    "fetch-gitlab-diff",
+    "fetch-gitlab-review",
+    "file-check",
+    "flow-run",
+    "git-commit",
+    "git-commit-form",
+    "git-status",
+    "gitlab-review-artifacts",
+    "jira-context",
+    "jira-fetch",
+    "jira-issue-check",
+    "local-script-check",
+    "llm-prompt",
+    "opencode-prompt",
+    "plan-codex",
+    "planning-bundle",
+    "planning-questions-form",
+    "read-file",
+    "review-findings-form",
+    "review-verdict",
+    "select-files-form",
+    "structured-summary",
+    "summary-file-load",
+    "telegram-notify",
+    "user-input",
+    "write-selection-file",
+];
 const builtInNodes = {
     "build-failure-summary": buildFailureSummaryNode,
     "build-review-fix-prompt": buildReviewFixPromptNode,
+    "clear-ready-to-merge": clearReadyToMergeNode,
     "codex-prompt": codexPromptNode,
     "command-check": commandCheckNode,
     "commit-message-form": commitMessageFormNode,
+    "design-review-verdict": designReviewVerdictNode,
     "ensure-summary-json": ensureSummaryJsonNode,
     "fetch-gitlab-diff": fetchGitLabDiffNode,
     "fetch-gitlab-review": fetchGitLabReviewNode,
@@ -49,10 +93,13 @@ const builtInNodes = {
     "llm-prompt": llmPromptNode,
     "opencode-prompt": opencodePromptNode,
     "plan-codex": planCodexNode,
+    "planning-bundle": planningBundleNode,
     "planning-questions-form": planningQuestionsFormNode,
     "read-file": readFileNode,
     "review-findings-form": reviewFindingsFormNode,
+    "review-verdict": reviewVerdictNode,
     "select-files-form": selectFilesFormNode,
+    "structured-summary": structuredSummaryNode,
     "summary-file-load": summaryFileLoadNode,
     "telegram-notify": telegramNotifierNode,
     "user-input": userInputNode,
@@ -72,6 +119,12 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["selectionFile", "autoMode"],
     },
+    "clear-ready-to-merge": {
+        kind: "clear-ready-to-merge",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
     "codex-prompt": {
         kind: "codex-prompt",
         version: 1,
@@ -92,6 +145,12 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["commitMessageFile", "formId", "title", "outputFile"],
     },
+    "design-review-verdict": {
+        kind: "design-review-verdict",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
     "ensure-summary-json": {
         kind: "ensure-summary-json",
         version: 1,
@@ -158,7 +217,7 @@ const builtInNodeMetadata = {
         kind: "llm-prompt",
         version: 1,
         prompt: "required",
-        requiredParams: ["labelText", "executor"],
+        requiredParams: ["labelText"],
         executors: ["codex", "opencode"],
     },
     "opencode-prompt": { kind: "opencode-prompt", version: 1, prompt: "required", requiredParams: ["labelText"] },
@@ -169,6 +228,12 @@ const builtInNodeMetadata = {
         requiredParams: ["prompt", "requiredArtifacts"],
         executors: ["codex"],
     },
+    "planning-bundle": {
+        kind: "planning-bundle",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
     "planning-questions-form": {
         kind: "planning-questions-form",
         version: 1,
@@ -182,12 +247,24 @@ const builtInNodeMetadata = {
         prompt: "forbidden",
         requiredParams: ["reviewFindingsJsonFile", "formId", "title"],
     },
+    "review-verdict": {
+        kind: "review-verdict",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["taskKey"],
+    },
     "select-files-form": {
         kind: "select-files-form",
         version: 1,
         prompt: "forbidden",
         requiredParams: ["gitStatusJsonFile", "formId", "title", "outputFile"],
     },
+    "structured-summary": {
+        kind: "structured-summary",
+        version: 1,
+        prompt: "forbidden",
+        requiredParams: ["path"],
+    },
     "summary-file-load": { kind: "summary-file-load", version: 1, prompt: "forbidden", requiredParams: ["path"] },
     "telegram-notify": {
         kind: "telegram-notify",
@@ -209,19 +286,51 @@ const builtInNodeMetadata = {
         requiredParams: ["outputFile", "reviewFindingsJsonFile", "selectionMode"],
     },
 };
-export function createNodeRegistry() {
+function coreOwner(id) {
+    return {
+        kind: "core",
+        id: `core:${id}`,
+        manifestPath: "built-in node registry",
+    };
+}
+export function createNodeRegistry(pluginNodes = []) {
+    const definitions = new Map(Object.entries(builtInNodes));
+    const metadata = new Map(Object.entries(builtInNodeMetadata));
+    const owners = new Map(Object.keys(builtInNodes).map((id) => [id, coreOwner(id)]));
+    for (const registration of pluginNodes) {
+        const existingOwner = owners.get(registration.id);
+        if (existingOwner) {
+            throw new TaskRunnerError(`Duplicate node id '${registration.id}' conflicts between ${existingOwner.id} (${existingOwner.manifestPath}) and plugin '${registration.pluginId}' (${registration.manifestPath}).`);
+        }
+        definitions.set(registration.id, registration.definition);
+        metadata.set(registration.id, registration.metadata);
+        owners.set(registration.id, {
+            kind: "plugin",
+            id: registration.pluginId,
+            manifestPath: registration.manifestPath,
+            entrypointPath: registration.entrypointPath,
+        });
+    }
     return {
         get(kind) {
-            return builtInNodes[kind];
+            const definition = definitions.get(kind);
+            if (!definition) {
+                throw new TaskRunnerError(`Unknown node kind '${kind}'.`);
+            }
+            return definition;
         },
         getMeta(kind) {
-            return builtInNodeMetadata[kind];
+            const definition = metadata.get(kind);
+            if (!definition) {
+                throw new TaskRunnerError(`Unknown node metadata '${kind}'.`);
+            }
+            return definition;
         },
         has(kind) {
-            return kind in builtInNodes;
+            return definitions.has(kind);
         },
         kinds() {
-            return Object.keys(builtInNodes);
+            return [...definitions.keys()];
         },
     };
 }