Skip to content

Search docs

Find pages, headings, and concepts. Press ⌘K or Ctrl+K to toggle.

Canvas

A React Flow visual workspace where agents run, communicate, and emit blocks.

The canvas is the centerpiece of Alumia. It's built on React Flow and renders agents, sessions, and outputs as connected nodes you can drag, group, and inspect.

What lives on the canvas

  • Agent nodes — running conversations. Each peer agent session has its own node with live activity emitters.
  • Block nodes — outputs rendered as documents, code, images, tables, charts, maps, browsers, terminals, audio, and more. 134 block types are registered; 131 of them are showable.
  • Connection edges — explicit links between agents and blocks for context handoff.

How it feels

The canvas streams agent activity in real time. When an agent starts, you see the node light up. When it calls a tool, the call appears as a chip. When it emits a block, the block appears connected to the agent node.

You don't have to wire agents up rigidly. You can spawn agents on the fly with the spawn_agent tool from any other agent, and the new agent appears on the canvas with its own session and activity stream.

Sharing

Any canvas can be shared via a tokenized link (/share/[token]) — useful for read-only walkthroughs of an agent's run.