list_projects — the workspace's canvas projects (id, title, thumbnail).
create_project — make a new canvas. Args: title and/or prompt (at least one). Returns {project_id, title}.
create_node — start a generation as a visible node on a canvas. Args: project_id, type (image | video | audio | 3d | storyboard | flam), prompt, plus optional input_media, aspect_ratio, resolution, duration_seconds, mode (sfx/music, audio only), and for storyboards scenes (default 5) and style (cinematic default, documentary, anime, noir, …). Returns {nodeId}.
list_nodes — the nodes on a canvas (id, type, label, prompt, status), read live from the collaboration document.
get_node — poll one node's live state: status (generating | processing | completed | failed), prompt, progress, and the output URL when completed (a storyboard's output is its scenes array).
update_node — regenerate an existing node in place with a new prompt or tweaked settings. By default the node's current image and stored references condition the result (an edit); pass fresh: true for a clean regeneration. The previous output stays in the node's version history.
connect_nodes — draw an edge so a source node's output feeds a target node as a reference; regenerate the target with update_node to apply it.

Workflows

Generate onto a canvas

Pick a project from list_projects (ask if several titles could match), or create_project for new work.
create_node with the project id, node type, and a specific prompt. The node appears on the canvas immediately in a generating state.
Poll get_node({ project_id, node_id }) until "completed", then tell the user the node is live on their canvas and share the output URL.

Iterate on a node

To tweak a result ("make it warmer", "same scene at night"), call update_node with the new prompt — the current image conditions the result, so it behaves like an edit. Use fresh: true when the user wants a do-over rather than an edit.
To chain generations (e.g. a character image feeding a video shot), connect_nodes(source, target), then update_node on the target so the connection takes effect.

Guidance

create_node and update_node spend workspace credits, same as the standalone generate tools.
Prefer canvas tools over standalone generate_* when the user names a project or is clearly working inside one; prefer standalone generate_* for one-off media.
update_node and connect_nodes only accept node ids that are on the canvas — list_nodes first rather than guessing ids.
Knob ranges differ by type: image aspect_ratio 1:1 (default)/16:9/9:16/4:3/3:4 and resolution 1K/2K/4K; video & flam 16:9/9:16/1:1 at 720p/1080p; video duration_seconds 4–15, audio 1–240 (default 10), flam 5 or 10, storyboard target ~30.
For prompt-writing and credit-error handling, the flowy-generate skill applies here too.