Checks whether Tuval Studio is open in the browser and connected to the local WebSocket bridge. If not connected, instructs the AI agent to open https://tuval.site/editor in the user's browser.

Captures the current live canvas graphic and layer hierarchy. Returns an image for visual inspection and critique by vision AI models.

Audits the current active canvas for text collisions, layer overlaps, and boundary overflows. Returns actionable recommendations for fixing overlaps and spacing.

Scans and lists all local images, icons, logos, and graphic assets in the workspace-assets directory ready to be placed onto the canvas.

Creates a new blank canvas with specific dimensions and background color.

Changes the dimensions or applies a social media preset (1080x1080 Instagram Post, 1080x1920 Story, 1280x720 YouTube Thumbnail, 1200x630 Facebook/Web Banner).

Sets the solid background color or enables alpha transparency. NOTE FOR AI DESIGNERS: You are NOT restricted to solid colors! You can search & apply rich background photography, architectural textures, gradients, or pattern grids using "image_add" with { isBackground: true }, or choose from "assets_list_patterns" / "assets_list_stock_pngs" / "assets_list_local".

Loads a pre-designed layout template onto the canvas (e.g. "social-launch", "neon-sale-story", "youtube-thumbnail", "minimal-post", "bold-thumbnail").

Clears all layers and objects from the canvas.

Reverts the canvas to the previous undo history state.

Redoes the previously undone change.

Adds a typography text layer to the canvas with styling (fonts: Sora, Inter, Playfair Display, Montserrat, Poppins, Space Grotesk, Roboto, etc.).

Updates typography properties of an existing text layer by its layerId.

Adds a geometric shape to the canvas (rect, rrect, circle, triangle, star, heart). Supports fills, strokes, corner radius, and opacity.

Modifies the fill, stroke, corner radius, or opacity of an existing shape layer.

Reads any local image or graphic file from the user computer (absolute path e.g. "C:/Users/name/Desktop/logo.png" or relative path), encodes it to Base64, and returns the data URL for use in canvas.

Adds an image layer to the canvas. Source can be ANY local file path on the user computer (e.g. "C:/path/to/img.png" or "workspace-assets/photo.jpg"), an external public URL (e.g. Unsplash), or a Base64 data URL. Set isBackground: true to automatically make it a full-bleed background.

Crops an image layer with a given aspect ratio (1:1, 4:5, 16:9, 9:16) or custom pixel coordinates.

Applies AI 1-click automatic background removal to an image layer by analyzing edges.

Performs Magic Wand background removal on an image layer by sampling color at click coordinates with tolerance and feather smoothing.

Applies an aesthetic color grading preset to an image layer ("Warm Film", "Cyberpunk", "Moody Noir", "Vintage 70s", "Pastel Soft", "Vivid HDR", "Film Grain", "Normal").

Manually adjusts color grading sliders on an image layer (brightness, contrast, saturation, hue, blur, noise, sepia, grayscale).

Returns the complete hierarchical list of all objects/layers currently on the canvas with their IDs, positions, and styles.

Reorders a layer in the visual z-index stack ("bring_to_front", "send_to_back", "bring_forward", "send_backward").

Aligns an object to the canvas artboard ("center", "left", "right", "top", "bottom", "center_h", "center_v").

Transforms a layer: move X/Y, rotate angle, flip horizontally/vertically, set opacity, or change blend mode.

Toggles visibility (hide/show), locks/unlocks selection, or renames a layer.

Duplicates an existing layer and adds the copy to the canvas.

Deletes a layer from the canvas.

Executes a sequential batch of multiple canvas actions in one round-trip and returns the final visual screenshot and layer state for rapid design creation.

Exports the current graphic to a local image file on the host machine (PNG, JPG, WebP, SVG) with customizable resolution scaling (1x, 2x Retina, 3x Print 300DPI, 4x Ultra HD).

Renames the active project title displayed in the top navbar and export filename.

Saves the current design project state to the browser local storage / cloud session.

Triggers the browser to download the current design as PNG, JPEG, SVG, or project JSON.

Applies a modern gradient to the canvas background. You can specify a built-in preset ("cyber", "sunset", "emerald", "space", "gold", "candy", "noir") or custom colors array and angle.

Applies a gradient fill to an existing text or shape layer by layerId.

Adds an SVG vector graphic, sticker, or badge to the canvas. Key can be from built-in library ("verified-badge", "sale-badge", "star-burst", "cyber-cross", "arrow-swirl", "sparkle-star", "crown-vip", "fire-flame", "quote-marks", "heart-glow", "abstract-blob") or raw SVG string.

Alias for svg_add. Adds a sticker or badge vector element to the canvas.

Lists all available built-in SVG stickers, badges, and vector elements available for insertion.

Lists all pre-designed templates across all professional design styles (Bento Grid, Corporate, Branding, Luxury, Minimalist, AI & Tech, Retro 80s, Y2K Rave, Bauhaus, Neobrutalism, Art Deco, Memphis Pop).

Lists all built-in geometric pattern and texture background presets (Dot Matrix, Technical Blueprint, Carbon Fiber, Diagonal Stripes, 3D Isometric Wireframe, Topography, Circuit Board).

Applies a patterned or textured geometric background to the canvas artboard.

Lists free transparent 3D cutout assets, holographic spheres, lighting flares, and curated royalty-free photography available for instant placement.

Searches through thousands of copyright-free stock photos, transparent PNG cutouts, SVG vector icons, trust badges, and backgrounds by keywords and category filters.

Adds a free copyright-free stock image or cutout to the canvas directly by search query, image URL, or asset key.

Adds or updates drop shadow on a layer (color, blur radius, horizontal/vertical offsets, or quick preset: "soft", "float", "glow", "none").

Executes freehand brush drawing on the canvas with specific brush style ("pencil", "spray", "circle", "eraser"), color, size, and path coordinates.

Returns the full list of pages in the current multi-page document with titles, indices, dimensions, and active status.

Adds a new page to the document. Ideal for designing multi-page catalogs, product lookbooks, brochures, magazines, and pitch decks.

Switches the active canvas view to a specific page index or page ID so the AI agent can design on that page.

Duplicates an existing page (including all text, shapes, images, and styling) into a new page immediately following it.

Deletes a page from the document by index (the document must always keep at least 1 page).

Compiles all pages (or active page) into a print-ready, high-resolution multi-page PDF document and triggers client-side download.