Artifacts & Visualization

When the agent calls a tool, the result is rendered as a visual artifact rather than plain text. Artifacts give you interactive, scannable views of your ideas — and in graph mode, they animate directly onto the mind map.

Artifact Types

Six tools emit an artifact the canvas knows how to draw:

Type	Produced by	Description
idea_grid	search_ideas (browse or search)	Grid of idea cards with title, status, and tags
idea_card	get_idea, create_idea, update_idea	Single idea, in detail / created / updated mode
mini_graph	discover_connections	Small force graph showing newly discovered connections
brainstorm_cluster	brainstorm	Clustered display of generated idea variations
tag_cloud	suggest_tags	Tag suggestions with applied/unapplied state
summary	summarize	Summary text with extracted themes
connection_line	link_ideas	Animated edge drawn on the mind map (no canvas card)

Note

The canvas can also render mermaid diagrams, side-by-side comparison cards, and insights panels, but no tool emits those types today — they are renderers waiting for a producer. Likewise, score_idea and draft_document draw on the mind map (score cards over the graph, a new node for the document) and produce no canvas artifact in the Agent view; their results arrive as tool output there.

How Artifacts Render

The Agent View

In the Agent view’s split pane, artifacts appear in the canvas panel on the right. Each artifact is wrapped in a collapsible artifact card with:

• A header showing the artifact type icon, a title, and collapse/pin/dismiss controls
• A pin button (📌) to keep the artifact visible even as the conversation continues
• A dismiss button (×) to remove the artifact from the canvas

Multiple artifacts accumulate in the canvas as the conversation progresses. Pinned artifacts stay at the top; unpinned artifacts can be scrolled through.

Mind Map Chat Panel

In the mind map chat panel, artifacts render differently depending on their type:

Graph mutations — tool calls that change the graph animate onto the canvas:

Artifact	Graph effect
connection_line	New edge draws with animation between source and target nodes
idea_card (created)	New node appears with a pulse animation
idea_card (updated)	Existing node highlights briefly to show the change
mini_graph	New nodes and edges for all discovered connections

Non-graph artifacts render as collapsible ToolResultCards in the chat message:

• A single header line shows the tool icon and a summary (e.g., “Found 5 ideas for ‘auth’”)
• Clicking the chevron expands to show idea reference chips, detail content, or a grid

Idea Reference Chips

When an artifact references specific ideas, they appear as color-coded chips with the idea title. Clicking a chip in the mind map chat panel highlights that node on the graph and scrolls it into view.

Graph Mutations in Detail

In the mind map, every tool result is translated into one or more graph mutations — the vocabulary the map understands:

Mutation	What happens
add_nodes / remove_nodes	Adds or removes ideas on the graph (removal is how undo reverses a creation)
add_edges / remove_edges	Draws or erases relations
highlight_nodes	Pulses the named ideas in a colour, for a set duration
focus_node / focus_bbox	Pans and zooms to one idea, or frames a whole set
focus_cluster / clear_focus_cluster	Dims everything outside a set of ideas, then releases it
arrange_nodes / clear_arrangement	Applies an agent-defined layout, or drops back to force layout
semantic_layout_weights	Feeds pairwise similarities into the simulation so like clusters with like
show_score_cards	Overlays score_idea results on the graph
show_tension_edges	Draws red contradiction edges between opposing ideas
show_proposed_edges	Draws suggested-but-not-yet-created connections
move_agent_cursor / hide_agent_cursor	Walks a visible cursor across the graph while the agent works

Each tool has its own choreography — search_ideas highlights its hits and dims the rest, discover_connections adds edges then frames them, create_idea adds a node and pulses it green.

Undo Stack

Every agent action that writes data is recorded in an undo stack in the chat panel. The undo button in the chat header reverses the most recent one:

• create_idea, synthesize_ideas, draft_document — deletes the idea it created
• link_ideas, discover_connections — removes the relations it created

Layout changes are not undoable — clear an arrangement instead. The undo stack is per-session and cleared when the page reloads.

Tip

Use undo liberally when exploring — the agent can create many connections quickly via discover_connections. If the results are not what you wanted, undo rolls back the graph to its previous state.

ToolResultCard

Non-graph artifacts in the mind map panel render using the ToolResultCard component. The card has:

• Icon — a monospace emoji or symbol indicating the tool type
• Summary — a single-line description of the result (e.g., “Merged 3 tags → machine-learning”)
• Expand chevron — click to reveal the full detail view
• Idea reference chips — clickable chips for each idea referenced in the result

The card uses the NeuralRepo brand green (#39ff14) for icons and a dark translucent background to sit cleanly over both the canvas and the mind map.

Next Steps

Agent Tools Reference Every tool, its parameters, and the artifact or mutation it produces.

AI Agent Overview Models, code mode, graph mode, and the prompt palette.

Mind Map The canvas these mutations animate on — edges, filters, and force controls.

Idea Relations What an agent-created edge means, and how it differs from one you drew.