Draw40

Apply and save bounded, validated element operations to an existing board. Creating a new diagram requires one open_canvas first; reuse its returned board.id. Use get_board_context to find existing target element ids when needed. If a card for this board is already open, do not call open_canvas again just to refresh it after a successful patch. Visible, connected viewing cards without drafts automatically load saved changes within about 5–30 seconds. Hidden or editing cards resume checks when eligible; preserve unsaved drafts. If no card is open and the user wants to see the result, call open_canvas(mode="view") once after saving. Saves use last-write-wins; concurrent edits can be overwritten. Returns no scene document. Default drawing style: Calm working whiteboard (calm-whiteboard-v1). Palette (fill/stroke): neutral: #e8dfd1/#6b5f50; input: #f0dfc8/#8f4a1a; processing: #d9e6ef/#2f566f; coreState: #e5dded/#6b4e86; waiting: #efe3c4/#8a5a1f; success: #dbeade/#2f6f59; blocked: #edccc7/#8a2d2a; warning: #f1d6cf/#9b3f38; tertiary: #ede6d8/#8a755b; inactive: #e6e0d6/#8a8174. Arrow stroke: #2f2a23; text: #2f2a23; fontFamily: 5; roughness: 0. open_canvas and get_board_context return the complete styleGuide in structuredContent and text. Consult it before generating elements. Use these defaults for new diagrams unless the user requests another style. Preserve the existing board style during small edits; do not restyle unrelated elements. Use a small repeated palette of muted fills paired with darker strokes. Map external/user/provider inputs to input, APIs/services/adapters to processing, orchestration/context to coreState, queues/pending work to waiting, completed results to success, login/failures to blocked, warnings/resets to warning, and disabled components to inactive with dashed strokes. Use ellipse starts/ends, rounded rectangle steps, diamonds only for branching decisions, dashed rectangles for responsibility boundaries, and free text for notes. Use ink-black arrows regardless of node color. Apply palette fill as backgroundColor and stroke as strokeColor; apply typography color as text strokeColor. These role names describe drawing intent, not additional patch fields. Use Excalifont (fontFamily 5), clean lines (roughness 0), full opacity, readable short labels, and consistent text hierarchy. Layout values are suggestions: align related nodes, leave room around labels, and avoid overlaps and crossing arrows. Bind labels with bindText and connectors with bindArrow. Do not draw color/shape legends unless the user asks. Explicit supported element style fields override server defaults. Defaults fill omitted fields on new elements only; existing elements are not recolored automatically. Canvas background is a new-board default, not an apply_scene_patch field.

apply_scene_patch

Delete exactly one existing board by id from the current workspace. Use only when the user requests deleting that board. Other boards and folders are preserved.

delete_board

Read a bounded summary of an indexed board so the model can reference existing element ids before applying a scene patch. Returns compact element fields and the default drawing styleGuide, never the full scene document or files. Preserve existing styles during small edits unless the user asks for a restyle.

get_board_context

Find indexed Draw40 boards by id, title, summary, or tag before opening or patching one. Returns compact catalog descriptors, never scene documents.

list_boards

Find existing destination folders by id or title before moving a board. Includes the root folder. Returns compact metadata without storage paths or scene documents.

list_folders

Move one existing board into an existing folder. Use list_boards and list_folders to discover ids. Preserves the board id and scene content.

move_board

Use this tool to display a board that has no open card in the conversation, create a new blank board, or fulfill an explicit reopen request. Omit boardId only for creation; use the returned board.id for subsequent patches. If a card for this board is already open, do not call open_canvas again just to refresh it after a successful patch. Visible, connected viewing cards without drafts automatically load saved changes within about 5–30 seconds. Hidden or editing cards resume checks when eligible; preserve unsaved drafts. Use mode="view" by default and mode="edit" only for explicit direct-edit intent. Inline stays read-only; the user enters fullscreen to edit. get_board_context reads saved content and returns the style guide without opening another card.

open_canvas

Read the saved Excalidraw document for the App UI. Pass knownVersion from the last result metadata to receive a compact unchanged response when the snapshot is current.

read_board

Rename one existing board by id. Preserves its id, folder and scene content. Use list_boards to find the board first.

rename_board

Save the complete App UI draft. The last successful save wins and may overwrite concurrent edits.

save_board