Kanshō/Workflow node

Workflow node

The atomic building block of the workflow canvas. Carries title, type chip, status, and typed input/output ports.

Included in the single kansho full pack. Components are not offered as separate installs.

Type matrix

Each node carries a type chip and IO ports
triggerSuccess

On schedule

Fires every hour on the hour

Tick — trigger port
sourceRunning

Read mission queue

postgres://ops/missions

Tick — trigger port
Rows — data port
Error — error port, not connected
agentPaused

Plan & dispatch

claude-opus-4-7 · plan and route missions

Rows — data port
Dispatch — control port
Skip — control port, not connected

Selected vs default vs error

Default
logic

Branch on priority

Rows — data port
Urgent — control port, not connected
Normal — control port, not connected
Selected
agent

Plan & dispatch

Rows — data port
Dispatch — control port
Failed
effectFailed

Notify oncall

PagerDuty: ops-primary

Reason — error port

Clickable

Click, or focus and press Enter, to select the node
agent

Plan & dispatch

Input — data port, not connected
Output — data port, not connected
source

Read mission queue

Input — data port, not connected
Output — data port, not connected
logic

Branch on priority

Input — data port, not connected
Output — data port, not connected

Keyboard navigation in a canvas

Tab into the nodes, then use arrow keys to move focus between them in document order and Enter to select. The focus ring and accessible name (label + status) come for free.
triggerSuccess

On schedule

sourceRunning

Read mission queue

agentPaused

Plan & dispatch

Component documentation

Workflow Node

components/workflow/workflow-node.tsx

Purpose

Renders a positioned or inline workflow node with ports, status, description, and selection.

Appropriate use

Use inside WorkflowCanvas or in a node palette when the host owns layout and selection.

Example

components/workflow/workflow-node.tsx has a representative live example in the "Keyboard navigation in a canvas" section on /components/workflow-node.

States

Port types are trigger, data, control, and error; nodes support optional position, width, status, ports, selection, and click interaction.

API and props

WorkflowNode accepts title, type, icon, description, status, inputs, outputs, selected, x, y, width, onClick, and className.

Dependencies

Direct imports are React, StatusPill, WorkflowCanvas navigation context, and cn.

Accessibility

Interactive nodes are named buttons with pressed state; Enter or Space selects, and registered canvas nodes support roving arrow-key navigation.

Limitations

It does not connect ports, validate workflow topology, drag, resize, or persist coordinates and selection.

Source

Source: components/workflow/workflow-node.tsx.

Full pack

components/workflow/workflow-node.tsx is documented at /components/workflow-node and installs only through the single Kansho full pack; no individual component install is offered.