The node palette

The palette is the panel in the visual editor you drag from — or click — to add steps to a draft. It carries 138 node types in 17 categories. This page is the index: one honest line per node, so you can find the right one without placing it first. Exact inputs and outputs are deliberately not here — pin-level signatures belong to the agent reference.

Primitives propose, verbs commit: brain nodes never write by themselves, state-changing service nodes are gate-guarded on every path, and the run's repository delta merges only when you accept the run.

Four conventions cover almost everything, so we state them once:

  • Every node sits on the Exec spine. Execution wires order the steps; data wires carry the values. See Anatomy of a workflow.
  • Almost every node emits one JSON result. 125 of the 138 end in a single result output that downstream nodes consume.
  • A few hand you a typed handle as well — a run id, an incident id, a lease id, or a workspace — which you wire straight into the nodes that need it.
  • Families come in threes for fan-out. Many service families ship a prepare (or load) node, a per-item node built to sit inside a fan-out body, and a reduce node that folds the items back together (analyze, aggregate, finalize, score or submit-report). Rows marked (per-item) below are the middle piece.

One thing you will not find in this catalog: the flow-control constructs. The palette's Structural section carries the tiles — Trigger, Approval Gate, Branch / Switch, For Each, Map / Fan-out, Wait (timer), Wait (event), Workflow Reference and the Comment frame — and Finally, which has no tile and is authored through the graph payload. They all have their own page.

The brain nodes

Six of the 138 are generative — they call a model. Four are wired call-sites with a fixed job:

  • Missions:Decomposition turns a mission objective into a proposed task breakdown.
  • Coder:Default dispatches one coder task and waits for the resulting artifact.
  • Coder:AsyncDefault dispatches coder work and routes what happens next down outcome arms — onSuccess, onFailure or onRefusal. It is one of the palette's two multi-arm nodes — the other is service:mission:integrate, under Git; see Outcome arms.
  • ReviewEngine:Default reviews an artifact and produces findings.

Two are generic:

  • llm runs one bounded model turn over its input. It has no tools, by construction.
  • agent runs a multi-turn agent loop with an explicit toolset and a mandatory budget. Several built-in sys- flows now use it — one dispatches ten agent nodes. For your own graphs, llm or a coder is still the simpler first reach unless you know why you need it.

The discipline is the same for all six: primitives propose, verbs commit. A brain node never writes anywhere by itself. Its output reaches the world only through explicit service nodes downstream — and on every such path, a gate stands before the write.

Reads, actions and service nodes

The other 132 nodes are adapters, in three kinds:

  • Reads — 20 nodes. They fetch state and change nothing: a mission's details, a file from a branch, a project's onboarding progress. Safe to place anywhere.
  • Workspace actions — 2 nodes. workspace:write_file and workspace:create do write — but only inside a sandboxed workspace. They never touch your repository.
  • Service operations — 110 nodes. One platform operation each: create an incident, classify a support case, run a compliance check, push a branch. The ones that change platform state are exactly what the gate-dominance rule guards.

You can usually read the kind off the id: read: fetches, service: operates, and the workspace file verbs live under workspace:.

Category index

palette categories

Sixteen categories here, ordered by how often a tester reaches for them — the seventeenth, Legacy, closes the page. Expand a block to see its nodes.

Missions — plan, decompose and score mission work · 12 node types
NodeWhat it does
Missions:DecompositionTurns a mission objective into a proposed task breakdown (generative).
read:mission_getReads a mission's details and state.
read:mission:staleLists still-open missions with no recent activity.
read:task-deps:resolveResolves the dependency order between a mission's tasks.
read:boundary:validateChecks that a proposed child item stays inside its parent's boundary.
read:task-routing:routePicks the right routing for a task from its description and requirements.
service:satisfaction:scoreScores how well a mission's outcome satisfies its objective.
service:decomposition:proposeProposes a decomposition for a mission from an objective and findings.
service:decomposition:coderProduces a coder-oriented decomposition for a mission.
service:proposal:recordRecords one proposed item against a mission.
service:decomposition:materialize-tasksMaterializes an accepted decomposition into real tasks.
service:mission:createCreates a new mission — the one node that spawns a child mission.
Workspace — read and write inside sandboxed workspaces · 6 node types
NodeWhat it does
workspace:read_fileReads one file from a workspace.
workspace:list_filesLists files under a workspace path.
workspace:write_fileWrites a file into a workspace (sandbox only — never your repository).
workspace:createCreates a fresh workspace and returns its handle.
workspace:mergeMerges several workspaces into one and returns the merged handle.
service:workspace:copy-treeCopies a source tree into a workspace.
Git — read repository files and push work · 4 node types
NodeWhat it does
read:gitlab_get_fileReads one file from a repository branch.
read:gitlab_list_filesLists files under a repository path.
service:mission:integrateIntegrates a coder task's branch into the mission branch, routing the outcome down onSuccess / onRefusal / onFailure arms (multi-arm).
service:git-push:defaultPushes the run's work to a branch.
Research — investigate, synthesize, critique · 6 node types
NodeWhat it does
service:research:investigate-codebaseInvestigates the codebase for a query.
service:research:investigate-docsInvestigates documentation for a query.
service:research:investigate-webInvestigates web sources for a query.
service:research:synthesizeSynthesizes codebase, docs and web findings into one answer.
service:research:critiqueCritiques a synthesis against the original query.
service:research:record-findingsRecords research findings against a mission.
Review — code and UX review pipelines · 7 node types
NodeWhat it does
ReviewEngine:DefaultReviews an artifact and produces findings (generative).
service:review-engine:discover-targetsDiscovers what a project offers to review in a given domain.
service:review-engine:review-targetReviews one discovered target (per-item).
service:review-engine:submit-reportSubmits the assembled review report for a session.
service:ux-review:discover-pagesDiscovers a project's pages for UX review.
service:ux-review:review-pageReviews one page for UX issues (per-item).
service:ux-review:submit-reportSubmits the UX review report for a session.
Validation — physical validation, target driving and batch runs · 20 node types
NodeWhat it does
service:canary:preparePrepares a canary run and its test cases.
service:canary:run-test-caseRuns one canary test case (per-item).
service:canary:analyzeAnalyzes the canary run's results.
service:run-acceptance:preparePrepares the validation cases for accepting a run.
service:run-acceptance:run-built-targetExercises one built target for a run (per-item).
service:run-acceptance:analyzeAnalyzes the run-acceptance results.
service:run-target:leaseLeases a running target to drive; returns a lease id.
service:run-target:drive-caseDrives one case against the leased target (per-item).
service:run-target:releaseReleases a target lease.
service:llm-preset-validation:loadLoads the preset-validation cells to run.
service:llm-preset-validation:run-cellRuns one preset-validation cell (per-item).
service:llm-preset-validation:evaluateEvaluates a preset-validation run.
service:validation-runs:loadLoads a model-validation run from models and prompts.
service:validation-runs:run-model-groupRuns one model group (per-item).
service:validation-runs:record-executionRecords one execution's response or error.
service:validation-runs:finalizeFinalizes a model-validation run.
read:validation-runs:group-executionsReads the recorded executions for one model group.
service:batch-processing:create-batchCreates a batch from a set of chunks.
service:batch-processing:process-chunkProcesses one chunk of a batch (per-item).
service:batch-processing:aggregateAggregates a batch's processed chunks.
Knowledge — query knowledge bases, experts and logs · 3 node types
NodeWhat it does
read:intelligence_knowledge_queryQueries a project's knowledge base.
read:cortex:expert-queryAsks a domain expert a question.
read:loki_query_rangeQueries logs over a time range.
Communication — talk and report · 2 node types
NodeWhat it does
service:dialogue:sendSends a message into a conversation.
service:report-compile:defaultCompiles a titled report and emits it as an artifact.
Scaffolding — generate and execute project scaffolding · 9 node types
NodeWhat it does
service:scaffolding:generateGenerates a scaffolding proposal for a project.
service:scaffolding:save-planSaves a scaffolding plan for a project.
service:scaffolding:approveMarks the scaffolding proposal approved.
service:scaffolding:rejectMarks the scaffolding proposal rejected.
service:scaffolding:executeExecutes the saved scaffolding plan.
service:scaffolding:execute-stepExecutes one plan step (per-item).
service:scaffolding:finalizeFinalizes the scaffolding run.
read:project-profileReads a project's profile.
read:scaffolding:plan-stepsReads the steps of the saved scaffolding plan.
Improvement — the improvement proposal lifecycle · 7 node types
NodeWhat it does
service:improvement:proposeRecords a new improvement proposal.
service:improvement:validateValidates a proposed improvement.
service:improvement:promotePromotes a validated improvement.
service:improvement:rejectRejects an improvement, with a reason.
service:improvement:completeMarks an improvement completed.
service:improvement:failMarks an improvement failed, with a reason.
service:improvement:rollbackRolls an improvement back, with a reason.
Support — the support case lifecycle · 8 node types
NodeWhat it does
read:support:case-contextReads the full context of a support case.
service:support:classifyClassifies a support case.
service:support:investigateRuns an investigation on a support case.
service:support:apply-verdictApplies a verdict to a case, including duplicate links.
service:support:escalateEscalates a case.
service:support:request-verificationRequests verification on a case.
service:support:resolveResolves a case into a terminal state.
service:support:link-investigationLinks a case to the mission investigating it.
Incidents — create, classify and close incidents · 5 node types
NodeWhat it does
service:incident:createCreates an incident and returns its id.
service:incident:classifyClassifies an incident.
service:incident:timeline-entryAppends an entry to an incident's timeline.
service:incident:closeCloses an incident.
read:incident:overdueLists overdue incidents.
Onboarding — project and charter onboarding · 17 node types
NodeWhat it does
service:project-onboarding:startStarts onboarding for a project.
read:project-onboarding:progressReads a project's onboarding progress.
read:project-onboarding:designReads a project's onboarding design.
service:onboarding:decomposeDecomposes an onboarding intent into steps.
service:onboarding:approveMarks an onboarding decomposition approved.
service:onboarding:denyMarks an onboarding decomposition denied.
service:aspect-onboarding:load-charterLoads a charter's aspects for onboarding.
service:aspect-onboarding:collect-analysesGathers a run's per-aspect analysis results into one array.
service:aspect-onboarding:complete-mattersCompletes every matter whose aspect is done, advances the next, and finalizes the charter when all are complete.
service:onboarding:update-design-concernWrites one aspect's phase and notes into the project's design tracker.
service:aspect-onboarding:run-aspectRuns one aspect of a charter (per-item).
service:aspect-onboarding:advanceAdvances a charter's aspect onboarding.
service:aspect-onboarding:determineDispatches the discovery review that produces a project determination (the result arrives later as an event).
service:aspect-onboarding:refresh-summariesRefreshes every aspect summary and re-detects cross-aspect conflicts.
read:project-onboarding:concerns-settledReads whether a project's onboarding concerns are all settled.
service:project-onboarding:apply-determinationFolds a determination's answers into the project's design tracker.
service:aspect-onboarding:reconcileCompletes the matters settled by determinations and finalizes the charter when all are.
Agents — the generative primitives · 4 node types
NodeWhat it does
Coder:DefaultDispatches one coder task and waits for the resulting artifact (generative).
Coder:AsyncDefaultDispatches coder work and routes the outcome down onSuccess / onFailure / onRefusal arms (generative; one of the two multi-arm nodes).
llmOne bounded model turn over its input — no tools (generative).
agentA multi-turn agent loop with an explicit toolset and budget (generative; used by several built-in sys- flows).
ComplianceChecks — deterministic regulatory checks · 24 node types

Deterministic checks — the platform evaluates them mechanically; no model writes a compliance verdict. Grouped by regulation family: cra-* (Cyber Resilience Act), pld-* (product liability), aiact-* (AI Act), nis2-* (NIS2).

NodeWhat it does
service:compliance:sca-checkChecks software-composition-analysis (dependency) results.
service:compliance:clause-mapChecks a contract's clause mapping.
service:compliance:roi-completenessChecks an ROI submission for completeness.
service:compliance:incident-timelinessChecks an incident's timeline against reporting deadlines.
service:compliance:cra-sbomCRA: checks the submitted SBOM.
service:compliance:cra-scaCRA: checks declared components (composition analysis).
service:compliance:cra-secure-updateCRA: checks the secure-update channel.
service:compliance:cra-techdocCRA: checks the technical documentation.
service:compliance:cra-ce-markingCRA: checks CE-marking evidence.
service:compliance:cra-reportingCRA: checks reporting obligations.
service:compliance:pld-disclosure-packPLD: checks the disclosure pack.
service:compliance:pld-provenancePLD: checks component provenance.
service:compliance:pld-update-channelPLD: checks the update channel.
service:compliance:pld-retentionPLD: checks retention rules.
service:compliance:aiact-techdocAI Act: checks the technical documentation.
service:compliance:aiact-registrationAI Act: checks registration.
service:compliance:aiact-gpai-docAI Act: checks GPAI documentation.
service:compliance:aiact-loggingAI Act: checks logging obligations.
service:compliance:aiact-transparencyAI Act: checks transparency obligations.
service:compliance:aiact-conformityAI Act: checks conformity evidence.
service:compliance:aiact-retentionAI Act: checks retention rules.
service:compliance:aiact-serious-incidentAI Act: checks serious-incident handling.
service:compliance:nis2-incident-timelinessNIS2: checks incident-reporting timeliness.
service:compliance:nis2-retentionNIS2: checks retention rules.
ComplianceAssess — compliance assessment runs · 3 node types
NodeWhat it does
service:compliance-assess:preparePrepares a compliance assessment run; returns run and profile ids.
service:compliance-assess:probeProbes one assessment item (per-item).
service:compliance-assess:scoreScores a compliance assessment run.

Legacy

Legacy — 1 node type

One node on the palette is legacy: service:research:llm, an early research step superseded by the generic llm node. The validator blocks it at publish in new drafts. Workflows you already published are frozen graphs, so they keep resolving as they were.