Editor canvas

Open a workflow from the list and the editor appears with three tabs at the top: Edit, Test and Deploy. This page covers the first one — the canvas, the node palette, and everything you do there with the mouse and the keyboard.

An unsaved marker appears next to the workflow name as soon as the graph changes. Until then the Save button stays disabled.

The node palette

The palette lives in the left sidebar and has three levels: section → group → node. Sections stay collapsed until you open one; search matches the node name, its type and its group name, and expands whatever it finds.

Section and group names are English in both locales — they name the node catalogue, not the interface. A node may carry small badges: T for a node usable as an agent tool, ▶ for a node with an execution input, ▦ for a node that holds an inner subgraph, S for a node that keeps state between runs.

Adding a node

The editor refuses to create a second entry node: a graph has exactly one entry point, so the drop simply does nothing.

Connecting ports

An edge is dragged from a port on one node to a port on another. The editor will not connect a node to itself and will not connect incompatible wires: every input carries the list of wire types it accepts. The resulting edge type follows from the pair of ports — that is where its colour and dash pattern come from, spelled out in the legend in the bottom-left corner of the canvas.

You can drag the end of an existing edge onto another port. Connecting the same pair of ports again replaces the old edge instead of adding a second one. Nodes snap to a 16-pixel grid.

Selection, groups, layout

• In select mode dragging on empty canvas draws a selection box; in pan mode it moves the canvas. The middle mouse button pans in both modes.
• Shift plus dragging draws a selection box; Ctrl (Cmd) plus a click adds a node to the selection.
• Group wraps two or more nodes in a frame that moves as one. It is decoration only — execution ignores it. Ungroup puts the nodes back on the canvas.
• Auto-layout rearranges the graph and fits the view. It is an ordinary edit: Ctrl+Z undoes it, and it enables the Save button.
• The edge-shape toggle draws edges either curved or orthogonal; the graph itself is unaffected.

History keeps up to 50 steps. While the cursor is in a text field the shortcuts do nothing.

Composites and stepping inside a subgraph

Select two or more nodes and a strip appears above the canvas with the count and a Merge button. It — like Ctrl+G — folds the selection into a composite node: interface ports appear on it and its body is laid out automatically. entry and exit are never folded in.

Double-click a composite to open its body: the canvas shows the subgraph and breadcrumbs appear in the top-left corner. Clicking a breadcrumb takes you back up a level and writes your edits into the node. The Ungroup button above a selected composite (or Ctrl+Shift+G) unpacks its contents back onto the canvas.

Validating and saving

Validate runs graph validation and reports what it found in the panel above the canvas; nothing is saved. Save writes a new workflow version — validation runs then too, but a draft is saved even when it has errors. Versions opens the history: any version can be loaded into the editor, or rolled back to in production.

Next steps