Board Chat (Tool-Calling)

What it is

The board-level AI chat panel is a slide-out drawer on the right side of the board. It allows you to have a conversation with the AI about the whole board, and the AI can create, update, and delete notes using validated tool calls.

Opening the panel

Click Ask AI in the bottom toolbar.
The subagent can also pre-populate and auto-send a prompt to the board chat via the action button.

What you can ask

"Brainstorm 5 user stories for a checkout flow"
"Expand the Epic note into three detailed story notes"
"Summarise all notes as a brief project overview"
"Delete the placeholder notes"
"Rename the 'Feedback' note to 'User Research Themes'"

Tools available to the AI

Tool	What it does
`createNote`	Creates a new note with title, content, position, and colour
`createPlaceholderNote`	Creates a ghost note (dashed border) to suggest missing information
`updateNote`	Updates title, content, position, colour, or type of an existing note
`deleteNote`	Deletes a note by ID
`expandNote`	Creates a cluster of child notes from a single parent note
`summarizeBoard`	Produces a prose summary of all current board content

How tool results are applied

The server streams a UIMessage response using toUIMessageStreamResponse().
The client's useChat hook receives the stream.
A useEffect monitors incoming messages for tool result parts.
Each tool result is applied to the Zustand store optimistically.
The store then syncs the change to D1 in the background.

Deduplication is handled via a processedToolCalls ref so each tool call is applied exactly once.

Multi-select context

Selected notes (highlighted with Ctrl / Cmd + Click on the canvas) appear as context chips above the chat input. The AI is aware of these notes and can use them as the target for operations like "expand these selected notes".

Chat persistence

Chat history is persisted to IndexedDB per board (last 100 messages). When you re-open the board, your previous conversation is restored.

Quick actions

The panel provides quick-start buttons:

Button	Prompt sent
Brainstorm	"Brainstorm new notes for this board"
Expand	"Expand the selected notes in more detail"
Summarise	"Summarise this board"