Canvas

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 through a small canonical surface: data blocks for structured displays, mcp-app blocks for connector UIs, artifact blocks for custom apps, and 13 show system primitives such as documents, code, spreadsheets, browsers, terminals, timers, and chat transcripts.
• 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.