Atsign AI Architect

Request access to the blueprint currently loaded in the user's browser. This will prompt the user for permission. If granted, returns the blueprint JSON with metadata (node count, edge count, last updated time). Use this when the user asks you to work with their existing blueprint (e.g., 'improve my blueprint', 'add nodes to my current design', 'analyze my blueprint'). Requires an active stream session — ask the user for their streamSessionId if you don't have it.

Return schema-valid empty blueprint with one page. Always use this instead of hand-writing top-level JSON.

Build complete edge JSON with canonical style and handles, generates unique id. Always use this instead of hand-writing. Canvas caption comes from data.notes (3-8 words) or falls back to connectionType label if notes is omitted.

Build complete node JSON with all required dimension/style fields and generates a unique id. Always use this instead of hand-writing. Notes support markdown. IMPORTANT: Use suggest_grid_position, suggest_horizontal_position, or suggest_vertical_position to calculate positions for clean layouts with proper spacing.

Calculate well-spaced grid position for a node. Returns {x, y}. Use this for clean layouts - nodes will have proper spacing (450px horizontal, 350px vertical). Much better than manually calculating positions.

Calculate position for horizontal flow layout (left to right). Returns {x, y}. Nodes will be spaced 450px apart horizontally.

Calculate position for vertical flow layout (top to bottom). Returns {x, y}. Nodes will be spaced 350px apart vertically.

Update the caption/notes on an existing edge. Use this to improve edge labeling or fix missing notes. Streams update event to UI if sessionId provided.

Update the label of an existing node. Use this to fix typos or improve clarity. Streams update event to UI if sessionId provided.

Update the notes/description of an existing node. Use this to add missing notes or improve documentation. Streams update event to UI if sessionId provided.

Update the position of an existing node. Use this to adjust layout or fix cramped spacing. Streams update event to UI if sessionId provided.

Validate blueprint JSON against schema. Returns { valid, errors, warnings }.