{
  "apiVersion": 1,
  "transport": "in-page",
  "global": "window.aquarellAgent",
  "orbitAlias": "window.orbitAgent (Orbit page only)",
  "documentation": "/ai-usage.txt",
  "directCall": "await window.aquarellAgent.execute(command, args, options)",
  "webmcp": {
    "interface": "document.modelContext",
    "experimental": true,
    "metadataArgument": "_request",
    "discovery": "Use the browser/agent WebMCP tool discovery; use its returned handles."
  },
  "pages": [
    {
      "id": "home",
      "label": "Visualizer collection",
      "path": "/",
      "commands": [
        {
          "name": "agent.cancelJob",
          "description": "Cancel a running background job while retaining its final cancellation status.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.describe",
          "description": "Discover the commands, schemas, transport support and resource limits available on this page.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getJob",
          "description": "Read a background job result, progress or failure after starting an export or another long operation.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getState",
          "description": "Read current application state and retained file/job metadata without starting playback or changing music.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.listFiles",
          "description": "List staged local file handles and metadata without reading or exposing their contents or disk paths.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.releaseArtifact",
          "description": "Release a generated download handle and its retained data when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.releaseFile",
          "description": "Release a staged file reference after importing or when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.stageFile",
          "description": "Stage a small file from canonical padded base64 so a later import command can consume its fileId. Larger local files use api.attachFile or the browser file picker.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "mediaType": {
                "type": "string",
                "maxLength": 200
              },
              "dataBase64": {
                "type": "string",
                "maxLength": 11184812
              }
            },
            "required": [
              "filename",
              "dataBase64"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.copyPrompt",
          "description": "Copy the homepage’s visible AI music prompt through its existing Copy prompt action. Read site.getInfo.agentPrompt for the same selectable text and links. Clipboard permission/activation may be required; failures are reported without claiming a copy.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.downloadArtifact",
          "description": "Request a browser download of an existing artifact. Browser policy may block the request; this never claims the file reached disk.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.getInfo",
          "description": "Discover this active page, appearance and the seven public creative routes. Does not start audio or a renderer.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "site.navigate",
          "description": "Navigate this browser tab to another public creative page. The next page has a new command context; rediscover its tools. This may discard an unsaved uploaded file.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "enum": [
                  "home",
                  "orbit",
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "section": {
                "type": "string",
                "enum": [
                  "main",
                  "visualizers",
                  "make-music",
                  "make-music-with-ai",
                  "how-it-works",
                  "studio",
                  "studio-root",
                  "about-studio"
                ]
              }
            },
            "required": [
              "page"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.previewVisualizer",
          "description": "Select an existing visualizer preview on the collection homepage without starting a renderer or audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              }
            },
            "required": [
              "visualizer"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setCardPreview",
          "description": "Start or stop the collection card’s existing silent animated preview. Respects reduced motion, Save Data, visibility and viewport constraints; does not create a visualizer renderer.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "playing": {
                "type": "boolean"
              }
            },
            "required": [
              "visualizer",
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setDisclosure",
          "description": "Open or close an existing FAQ disclosure. Read site.getInfo for IDs and current open state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setTheme",
          "description": "Set Light, Dark or System appearance through the existing shared preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "enum": [
                  "light",
                  "dark",
                  "system"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showGuide",
          "description": "Reveal the existing page guide or frequently asked questions. This does not change music.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showSection",
          "description": "Scroll to an existing content section on this document. Read site.getInfo for section IDs; does not navigate or start audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "section"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        }
      ]
    },
    {
      "id": "orbit",
      "label": "Orbit music maker",
      "path": "/orbit/",
      "commands": [
        {
          "name": "agent.cancelJob",
          "description": "Cancel a running background job while retaining its final cancellation status.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.describe",
          "description": "Discover the commands, schemas, transport support and resource limits available on this page.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getJob",
          "description": "Read a background job result, progress or failure after starting an export or another long operation.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getState",
          "description": "Read current application state and retained file/job metadata without starting playback or changing music.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.listFiles",
          "description": "List staged local file handles and metadata without reading or exposing their contents or disk paths.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.releaseArtifact",
          "description": "Release a generated download handle and its retained data when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.releaseFile",
          "description": "Release a staged file reference after importing or when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.stageFile",
          "description": "Stage a small file from canonical padded base64 so a later import command can consume its fileId. Larger local files use api.attachFile or the browser file picker.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "mediaType": {
                "type": "string",
                "maxLength": 200
              },
              "dataBase64": {
                "type": "string",
                "maxLength": 11184812
              }
            },
            "required": [
              "filename",
              "dataBase64"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.addInstrument",
          "description": "Add an editable Melody, Drums or Bass instrument. Returns its stable ID; String Pluck is a Melody voice. Does not impose an instrument-count cap.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Instrument category.",
                "enum": [
                  "melody",
                  "drums",
                  "bass"
                ]
              },
              "voice": {
                "type": "string",
                "description": "Melody voice ID. String Pluck is pluck, within the melody category.",
                "enum": [
                  "bells",
                  "keys",
                  "glass",
                  "felt",
                  "marimba",
                  "pad",
                  "organ",
                  "musicbox",
                  "pluck"
                ]
              },
              "kit": {
                "type": "string",
                "description": "Drums kit ID.",
                "enum": [
                  "pocket",
                  "deep",
                  "machine",
                  "brush",
                  "hand",
                  "found",
                  "glitch",
                  "electronic"
                ]
              },
              "notes": {
                "type": "array",
                "description": "Four ring arrays in high-to-low order. Each contains unique zero-based steps; an empty array is a silent ring.",
                "minItems": 4,
                "maxItems": 4,
                "items": {
                  "type": "array",
                  "minItems": 0,
                  "maxItems": 16,
                  "uniqueItems": true,
                  "items": {
                    "type": "integer",
                    "description": "Zero-based step in the repeating loop.",
                    "minimum": 0,
                    "maximum": 15
                  }
                }
              },
              "volume": {
                "type": "number",
                "description": "Initial instrument level.",
                "minimum": 0,
                "maximum": 100
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.cancelQueued",
          "description": "Cancel a pending loop/comparison handoff while retaining the music already playing.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.captureSection",
          "description": "Capture the current loop, a preset or a saved loop as a new independent song section. Up to four sections are allowed, and each captures a steady musical moment.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string",
                "description": "Music source; omitted means current.",
                "enum": [
                  "current",
                  "preset",
                  "saved"
                ]
              },
              "index": {
                "type": "integer",
                "description": "Preset index or saved slot when using that source.",
                "minimum": 0
              },
              "loops": {
                "type": "number",
                "description": "Number of loops in the new section.",
                "enum": [
                  1,
                  2,
                  4
                ]
              },
              "name": {
                "type": "string",
                "description": "Optional section name.",
                "maxLength": 28
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.charge",
          "description": "Explicitly hold or release an instrument’s nucleus swell without changing its saved notes or instrument type.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "active": {
                "type": "boolean",
                "description": "True holds the nucleus; false releases it."
              }
            },
            "required": [
              "id",
              "active"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.clearArrangement",
          "description": "Clear the captured song sections with ordinary Undo recovery; the current editable loop remains.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.clearComparison",
          "description": "Remove the kept comparison and its draft with ordinary Undo recovery.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.closeTool",
          "description": "Close the active contextual tool through its ordinary close lifecycle; Play & record releases held/repeating notes and recording.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.confirmProjectRestore",
          "description": "Confirm the already validated pending project in the editor’s restore-review dialog, using one whole-project Undo checkpoint.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.copyShareLink",
          "description": "Copy the current editable-loop listen link through the browser clipboard API. Browser permission or user activation can be required; getShare returns the same URL as data.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.dismissNotice",
          "description": "Dismiss a welcome/reward/toast notice or instrument volume popup without undoing music or changing earned progress.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "type": "string",
                "description": "Allowlisted notice identifier from orbit.getInterface.",
                "enum": [
                  "welcome",
                  "achievementReward",
                  "toast",
                  "levelPopup"
                ]
              }
            },
            "required": [
              "notice"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.export",
          "description": "Start a local WAV, MIDI, instrument PNG or editable-project export job and return its job ID. Poll agent.getJob for the finished artifact; rendering is not a completed download. Loop/evolution options apply to WAV.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "format": {
                "type": "string",
                "description": "Export file format.",
                "enum": [
                  "wav",
                  "midi",
                  "png",
                  "project"
                ]
              },
              "loops": {
                "type": "number",
                "description": "WAV loop count; the current tempo and finished-duration limit determine availability.",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              },
              "evolve": {
                "type": "boolean",
                "description": "For WAV, include currently enabled musical evolution."
              }
            },
            "required": [
              "format"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.exportArrangement",
          "description": "Start a local WAV export job containing one full pass of every arranged section. Poll agent.getJob for the final downloadable artifact.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.getAchievements",
          "description": "Read achievement descriptions, groups, the active learning goal and earned progress. Reading does not award achievements.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getArrangement",
          "description": "Read the song name, repeat setting, section IDs, loop lengths and captured music without starting the song.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getCapabilities",
          "description": "Read voices, drum kits, musical keys, note dimensions, available feature groups and limits for this Orbit session.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getCollection",
          "description": "Read the local saved-loop collection and its stable zero-based slots without loading or replacing music.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getComparison",
          "description": "Read the kept comparison version and latest draft without switching what is playing.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getExportOptions",
          "description": "Read the loop counts and actual finished durations available for WAV export at the current tempo and evolution settings.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "evolve": {
                "type": "boolean",
                "description": "Include the currently enabled note, key and Timbre evolution when calculating the performance."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getInterface",
          "description": "Read editor dialogs, native disclosure sections, notices and transient control state, including advertised IDs for allowlisted interface actions.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getProject",
          "description": "Read the editable whole-project backup as JSON, including the current loop, collection, song, comparison and performance preferences.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getRhythmPreview",
          "description": "Read one follower’s exact written and heard ring patterns and the existing sixteen-step Before/After preview, without advancing music or random choices.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "target": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              }
            },
            "required": [
              "target"
            ],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getShare",
          "description": "Create the current editable-loop listen URL as data without copying to the clipboard, uploading music or publishing the whole project.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.getState",
          "description": "Read the current editable music, instrument IDs, relationships, performance, queued changes and editor state without starting audio.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.importLoop",
          "description": "Import an editable loop from a listen URL or a loop snapshot as a recoverable trial. Parses listen URLs locally without fetching; provide exactly one source.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "shareURL": {
                "type": "string",
                "description": "Listen URL or supported Orbit hash containing the encoded editable loop.",
                "minLength": 1,
                "maxLength": 1048576
              },
              "snapshot": {
                "type": "object",
                "description": "Editable Orbit loop snapshot; validated and migrated by the existing importer.",
                "additionalProperties": true
              },
              "play": {
                "type": "boolean",
                "description": "If true, request playback after loading. If omitted, retain the existing transport state. Audio startup follows browser activation rules."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.importProject",
          "description": "Restore an editable whole-project backup from its JSON object or an attached .orbit.json file. Provide exactly one source; the existing importer validates before replacing the project and Undo keeps the previous project.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "project": {
                "type": "object",
                "description": "Whole-project backup JSON.",
                "additionalProperties": true
              },
              "fileId": {
                "type": "string",
                "description": "File ID returned by agent.stageFile or api.attachFile.",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.keepComparison",
          "description": "Keep the current musical moment as the comparison version before experimenting. Replacing a prior comparison uses ordinary Undo.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.keepFollowNotes",
          "description": "Keep any enabled Follow effect’s heard result as editable written notes and stop that connection. Works for gaps, matching beats and copied rhythms; Undo restores the prior notes and relationship.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.listPresets",
          "description": "Read the ready-made loop catalogue with stable zero-based indices, names, tempo, instruments and musical features. Loading is a separate action.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "orbit.loadExampleArrangement",
          "description": "Replace the arrangement with the authored ready-made example song, using the normal Undo lifecycle.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.loadLoop",
          "description": "Load a local saved-loop slot through the normal musical handoff. Existing playback can queue the load; no saved copy is removed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "slot": {
                "type": "integer",
                "description": "Zero-based saved-loop slot from orbit.getCollection.",
                "minimum": 0
              },
              "play": {
                "type": "boolean",
                "description": "If true, request playback after loading. If omitted, retain the existing transport state. Audio startup follows browser activation rules."
              }
            },
            "required": [
              "slot"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.loadPreset",
          "description": "Try an authored ready-made loop as a recoverable trial. While playing, the change can queue for the next complete loop; use returnToLoop to recover the original.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "index": {
                "type": "integer",
                "description": "Stable zero-based preset index from orbit.listPresets.",
                "minimum": 0,
                "maximum": 9
              },
              "play": {
                "type": "boolean",
                "description": "If true, request playback after loading. If omitted, retain the existing transport state. Audio startup follows browser activation rules."
              }
            },
            "required": [
              "index"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.matchTurns",
          "description": "Give the included Turns instruments the first included instrument’s written rhythm, using the editor’s ordinary Undo lifecycle.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.nextAchievement",
          "description": "Advance to the next unearned achievement using the editor’s normal ordering, dismiss the earned-reward card and reveal the selected goal. Does not award progress.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "keepGuideOpen": {
                "type": "boolean",
                "description": "Keep the floating guide open after advancing, like its Next goal button."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.openHelp",
          "description": "Open the existing accessible Help dialog without changing notes or starting audio.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.openProjectPicker",
          "description": "Request the editor’s native project-backup file picker. Returns a queued selection or an explicit browser activation requirement; selecting a file previews it before confirmation.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.openTool",
          "description": "Reveal a shared or instrument-local editor tool without performing its musical action. Instrument-local tools use the supplied ID or the selected instrument.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "tool": {
                "type": "string",
                "description": "Editor tool or instrument volume popup to reveal.",
                "enum": [
                  "timbre",
                  "tryLoops",
                  "arrange",
                  "saved",
                  "compare",
                  "share",
                  "achievements",
                  "play",
                  "follow",
                  "turns",
                  "options",
                  "volume"
                ]
              },
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "slot": {
                "type": "integer",
                "description": "For the saved tool only: zero-based saved-loop slot whose card editor should open.",
                "minimum": 0
              }
            },
            "required": [
              "tool"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.performanceGesture",
          "description": "Press or release a live Fill or Break. Releasing Break schedules the full-mix return at the shared loop boundary.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Live gesture.",
                "enum": [
                  "fill",
                  "break"
                ]
              },
              "active": {
                "type": "boolean",
                "description": "True presses/holds the gesture; false releases it."
              }
            },
            "required": [
              "kind",
              "active"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.playPad",
          "description": "Press or release one live sound pad on the named or selected instrument. Recording writes the performance into that instrument; durationMs can release a transient press automatically when repeating-note latch is disabled.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "ring": {
                "type": "integer",
                "description": "Zero-based ring: 0 is the highest register; 3 is the lowest. Drum labels depend on the selected kit.",
                "minimum": 0,
                "maximum": 3
              },
              "pressed": {
                "type": "boolean",
                "description": "True presses this agent’s pad source; false releases it."
              },
              "durationMs": {
                "type": "integer",
                "description": "Optional automatic release delay for a press in milliseconds.",
                "minimum": 20,
                "maximum": 10000
              }
            },
            "required": [
              "ring",
              "pressed"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.previewShare",
          "description": "Open or close the shared-loop listening preview and explicitly play or pause it. Closing follows the existing editor playback-resume behavior.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "open": {
                "type": "boolean",
                "description": "True opens the current loop’s listening preview; false closes it."
              },
              "playing": {
                "type": "boolean",
                "description": "Explicit preview listening state."
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.randomSong",
          "description": "Compose and try a fresh editable loop while preserving the earlier loop for returnToLoop. An optional seed makes the composition repeatable.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "seed": {
                "type": "integer",
                "description": "Optional unsigned 32-bit composition seed.",
                "minimum": 0,
                "maximum": 4294967295
              },
              "play": {
                "type": "boolean",
                "description": "If true, request playback after loading. If omitted, retain the existing transport state. Audio startup follows browser activation rules."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.releasePerformance",
          "description": "Stop the shared held/repeating performance and recording, including manually held notes through the editor’s release lifecycle, without erasing written notes.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.remixShared",
          "description": "Make an editable version of the currently previewed shared loop, first preserving the recipient’s previous loop in the collection.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.removeInstrument",
          "description": "Remove an instrument and update its relationships through the editor lifecycle. The final remaining instrument cannot be removed; ordinary Undo restores a removal.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.removeLoop",
          "description": "Remove one local saved copy with ordinary Undo recovery. Does not remove the current live instruments.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "slot": {
                "type": "integer",
                "description": "Zero-based saved-loop slot from orbit.getCollection.",
                "minimum": 0
              }
            },
            "required": [
              "slot"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.removeSection",
          "description": "Remove one captured song section with ordinary Undo recovery. Stop song playback before editing.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable section ID from orbit.getArrangement.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.renameLoop",
          "description": "Rename an existing saved-loop slot without changing its captured notes or the current live music.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "slot": {
                "type": "integer",
                "description": "Zero-based saved-loop slot from orbit.getCollection.",
                "minimum": 0
              },
              "name": {
                "type": "string",
                "description": "Saved-loop name; an empty name uses the editor fallback.",
                "maxLength": 28
              }
            },
            "required": [
              "slot",
              "name"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.resetTimbre",
          "description": "Reset Tone & space to the editor’s Original setting and stop automatic movement. Retains the configured movement interval and curvature.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.returnToLoop",
          "description": "Restore the editable music kept before trying a ready-made or random loop. A playing session can queue the return at the next loop boundary.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.saveLoop",
          "description": "Save a separate editable local copy of the current loop or explicitly replace a given saved slot. Optional name applies to that saved copy.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "slot": {
                "type": "integer",
                "description": "Zero-based saved-loop slot from orbit.getCollection.",
                "minimum": 0
              },
              "name": {
                "type": "string",
                "description": "Saved-loop name; an empty name uses the editor fallback.",
                "maxLength": 28
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.selectInstrument",
          "description": "Select an instrument for keyboard/performance actions and optionally reveal its Play & record panel without soloing it.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "openPlay": {
                "type": "boolean",
                "description": "Reveal Play & record for this instrument."
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setArrangement",
          "description": "Set the song name or repeat setting while preserving its captured sections. Stop song playback before editing the arrangement.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Song name; an empty name uses the editor fallback.",
                "maxLength": 28
              },
              "repeat": {
                "type": "boolean",
                "description": "Whether the arranged song repeats after its final section."
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.setArrangementPlayback",
          "description": "Start the arranged song or stop its arrangement sequence. Stopping keeps its current section looping; setTransport false pauses all loop playback.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean",
                "description": "True starts the arranged song; false leaves the arrangement sequence."
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setCreation",
          "description": "Set the current loop’s name and visual cover for sharing without copying a URL or publishing music.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Current loop title; an empty name becomes Untitled loop.",
                "maxLength": 60
              },
              "cover": {
                "type": "string",
                "description": "Cover drawing style.",
                "enum": [
                  "orbits",
                  "bloom",
                  "waves"
                ]
              },
              "color": {
                "type": "string",
                "description": "Cover palette.",
                "enum": [
                  "moss",
                  "sunset",
                  "ocean",
                  "lilac"
                ]
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.setDetails",
          "description": "Expand or collapse one advertised native disclosure without applying its musical controls. Read orbit.getInterface for supported section IDs.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "sectionId": {
                "type": "string",
                "description": "Allowlisted disclosure ID advertised by the active editor interface.",
                "minLength": 1,
                "maxLength": 80
              },
              "open": {
                "type": "boolean",
                "description": "Explicit disclosure open state."
              }
            },
            "required": [
              "sectionId",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setDialog",
          "description": "Open or close one allowlisted editor dialog through its native lifecycle. Opening a project-restore review requires a validated pending project; closing a dialog is distinct from cancelling an export job.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "dialog": {
                "type": "string",
                "description": "Editor dialog identifier from orbit.getInterface.",
                "enum": [
                  "help",
                  "addInstrument",
                  "audioExport",
                  "projectRestore",
                  "sharedListening"
                ]
              },
              "open": {
                "type": "boolean",
                "description": "Explicit dialog open state."
              }
            },
            "required": [
              "dialog",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setFollow",
          "description": "Set or disable one follower’s rhythm connection without replacing other followers. Leads can have multiple followers; circular chains and incompatible same-pair Turns are rejected.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "target": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "source": {
                "type": "string",
                "description": "Lead instrument ID. Required when enabling a new connection.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "mode": {
                "type": "string",
                "description": "room plays in the lead’s gaps; meet plays matching beats; mirror copies its resulting rhythm.",
                "enum": [
                  "room",
                  "meet",
                  "mirror"
                ]
              },
              "enabled": {
                "type": "boolean",
                "description": "Explicit Follow enable state."
              }
            },
            "required": [
              "target",
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setGuide",
          "description": "Set selected-goal visibility, the achievement category or the independent floating-guide open state. Omitted fields and earned progress are preserved.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "visible": {
                "type": "boolean",
                "description": "Whether the selected goal is shown; inverse of free play."
              },
              "group": {
                "type": "string",
                "description": "Achievement category, including the All achievements filter.",
                "enum": [
                  "all",
                  "basics",
                  "shape",
                  "live",
                  "together",
                  "explore",
                  "songs",
                  "creative"
                ]
              },
              "open": {
                "type": "boolean",
                "description": "Whether the floating active-achievement guide is open; independent from selected-goal visibility."
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.setHarmony",
          "description": "Set the shared musical key and optional automatic key movement. Omitted fields are preserved.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "mood": {
                "type": "string",
                "description": "Shared harmony ID: daydream is C major, sunroom A minor, afterhours D minor.",
                "enum": [
                  "daydream",
                  "sunroom",
                  "afterhours"
                ]
              },
              "autoKey": {
                "type": "boolean",
                "description": "Enable or disable automatic shared-key changes."
              },
              "keyEvery": {
                "type": "number",
                "description": "Base interval in loops between key changes.",
                "enum": [
                  0.25,
                  0.5,
                  1
                ]
              },
              "keyDrift": {
                "type": "number",
                "description": "Timing drift for shorter key-change intervals.",
                "minimum": 0,
                "maximum": 100
              },
              "keyPool": {
                "type": "array",
                "description": "Allowed harmony IDs for automatic movement; retain at least one.",
                "minItems": 1,
                "maxItems": 3,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "description": "Harmony ID.",
                  "enum": [
                    "daydream",
                    "sunroom",
                    "afterhours"
                  ]
                }
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.setInstrument",
          "description": "Update one instrument voice, drum kit, level, mute or per-loop note evolution. Musical category and written notes stay unchanged.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "voice": {
                "type": "string",
                "description": "Melody voice ID. String Pluck is pluck, within the melody category.",
                "enum": [
                  "bells",
                  "keys",
                  "glass",
                  "felt",
                  "marimba",
                  "pad",
                  "organ",
                  "musicbox",
                  "pluck"
                ]
              },
              "kit": {
                "type": "string",
                "description": "Drums kit ID.",
                "enum": [
                  "pocket",
                  "deep",
                  "machine",
                  "brush",
                  "hand",
                  "found",
                  "glitch",
                  "electronic"
                ]
              },
              "volume": {
                "type": "number",
                "description": "Instrument level.",
                "minimum": 0,
                "maximum": 100
              },
              "muted": {
                "type": "boolean",
                "description": "Explicit instrument mute state."
              },
              "autoRandomize": {
                "type": "boolean",
                "description": "Enable Change each loop for this instrument."
              },
              "mutation": {
                "type": "number",
                "description": "Amount of note evolution; 90–100 chooses a fresh pattern.",
                "minimum": 10,
                "maximum": 100
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false,
            "minProperties": 2
          },
          "readOnly": false
        },
        {
          "name": "orbit.setMix",
          "description": "Set master volume, master mute or Swing for the whole loop. Omitted fields are preserved.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "volume": {
                "type": "number",
                "description": "Master level as a percentage.",
                "minimum": 0,
                "maximum": 100
              },
              "muted": {
                "type": "boolean",
                "description": "Explicit master mute state."
              },
              "swing": {
                "type": "number",
                "description": "Swing amount; 0 is straight. Alternate steps move while the loop length stays fixed.",
                "minimum": 0,
                "maximum": 100
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.setNote",
          "description": "Explicitly plant or erase a single note using zero-based ring and step coordinates. Repeating the same request does not toggle the note.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "ring": {
                "type": "integer",
                "description": "Zero-based ring: 0 is the highest register; 3 is the lowest. Drum labels depend on the selected kit.",
                "minimum": 0,
                "maximum": 3
              },
              "step": {
                "type": "integer",
                "description": "Zero-based step.",
                "minimum": 0,
                "maximum": 15
              },
              "enabled": {
                "type": "boolean",
                "description": "True plants the note; false erases it."
              }
            },
            "required": [
              "id",
              "ring",
              "step",
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setNotes",
          "description": "Replace one instrument’s four written note rings. A copied Follow rhythm must first become editable or be disconnected.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "notes": {
                "type": "array",
                "description": "Four ring arrays in high-to-low order. Each contains unique zero-based steps; an empty array is a silent ring.",
                "minItems": 4,
                "maxItems": 4,
                "items": {
                  "type": "array",
                  "minItems": 0,
                  "maxItems": 16,
                  "uniqueItems": true,
                  "items": {
                    "type": "integer",
                    "description": "Zero-based step in the repeating loop.",
                    "minimum": 0,
                    "maximum": 15
                  }
                }
              }
            },
            "required": [
              "id",
              "notes"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setPerformance",
          "description": "Set the selected performance instrument, recording, held-note latch and repeat pattern. Recording can start playback and obeys copied-rhythm and browser-audio constraints.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "recording": {
                "type": "boolean",
                "description": "Explicit recording state."
              },
              "latch": {
                "type": "boolean",
                "description": "Keep played pads repeating; requires an audible instrument and active loop."
              },
              "pattern": {
                "type": "string",
                "description": "How held rings are played.",
                "enum": [
                  "together",
                  "climb",
                  "fall",
                  "bounce"
                ]
              },
              "every": {
                "type": "number",
                "description": "Held-note repeat spacing in steps.",
                "enum": [
                  1,
                  2,
                  4
                ]
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.setTempo",
          "description": "Set the shared loop tempo explicitly while preserving the current instruments and musical settings.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "bpm": {
                "type": "integer",
                "description": "Shared tempo in beats per minute.",
                "minimum": 48,
                "maximum": 112
              }
            },
            "required": [
              "bpm"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setTheme",
          "description": "Set System, Light or Dark appearance. AquarellEQ’s hosted editor delegates to the shared site preference; standalone Orbit retains its own preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "description": "Appearance preference.",
                "enum": [
                  "system",
                  "light",
                  "dark"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setTimbre",
          "description": "Set the whole-loop Tone & space graph or its automatic movement using the same controls as Timbre. Omitted settings are preserved.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "tone": {
                "type": "number",
                "description": "Tone position: 0 is warm and 100 is clear.",
                "minimum": 0,
                "maximum": 100
              },
              "haze": {
                "type": "number",
                "description": "Space/reverb position: 0 is dry and 100 is roomy.",
                "minimum": 0,
                "maximum": 100
              },
              "motion": {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Enable or disable automatic Tone & space movement. Enabling a stopped movement without a seed starts a fresh path, like the editor."
                  },
                  "every": {
                    "type": "number",
                    "description": "Loops between movement destinations.",
                    "enum": [
                      0.25,
                      0.5,
                      1
                    ]
                  },
                  "curve": {
                    "type": "number",
                    "description": "Path curvature: 0 is straight.",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "seed": {
                    "type": "integer",
                    "description": "Optional unsigned 32-bit seed for an exact repeatable movement path.",
                    "minimum": 0,
                    "maximum": 4294967295
                  }
                },
                "required": [],
                "additionalProperties": false,
                "minProperties": 1
              }
            },
            "required": [],
            "additionalProperties": false,
            "minProperties": 1
          },
          "readOnly": false
        },
        {
          "name": "orbit.setTransport",
          "description": "Explicitly start or pause Orbit playback. Starting can require browser user activation; inspect the returned outcome.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean",
                "description": "True to play; false to pause."
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.setTurns",
          "description": "Set the group that alternates playing and its turn interval. Instruments outside the group continue underneath; explicit disable keeps the group settings.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean",
                "description": "Explicit Turns enable state."
              },
              "members": {
                "type": "array",
                "description": "Instrument IDs to include; the editor determines their turn order. Disabled drafts may contain zero or one member, but enabling requires at least two.",
                "minItems": 0,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                  "minLength": 1,
                  "maxLength": 48,
                  "pattern": "^[a-zA-Z0-9_-]+$"
                }
              },
              "every": {
                "type": "number",
                "description": "Length of each instrument’s turn in loops.",
                "enum": [
                  0.25,
                  0.5,
                  1
                ]
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.showAchievement",
          "description": "Select an existing achievement and optionally reveal its real control. Does not fabricate earned progress or perform the musical task.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Achievement ID from orbit.getAchievements.",
                "minLength": 1,
                "maxLength": 64
              },
              "reveal": {
                "type": "boolean",
                "description": "Reveal the related editor control after selecting the achievement."
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.solo",
          "description": "Explicitly hold or release an instrument’s Solo preview. Releasing restores the prior mix and playing/paused state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "active": {
                "type": "boolean",
                "description": "True holds Solo; false releases the preview."
              }
            },
            "required": [
              "id",
              "active"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.stopHeldNotes",
          "description": "Clear held and latched live pad notes using Stop held notes, while preserving recording, latch preference, Solo, nucleus gestures and the ordinary loop.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.swapFollow",
          "description": "Swap a configured connection’s lead and follower atomically, preserving unrelated connections and one Undo checkpoint. Rejects an occupied new follower, a circular chain or conflicting Turns.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "target": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              }
            },
            "required": [
              "target"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.transformNotes",
          "description": "Change an instrument’s written pattern once: new random notes, clear, ring twist, evenly spaced ring notes, whole-phrase shift, answering echo or alternate-note spacing. Undo keeps the prior phrase.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable instrument ID from orbit.getState; not its visible ordinal.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "operation": {
                "type": "string",
                "description": "Pattern transformation. rotate requires ring and offset; spread requires ring and count with optional offset; left/right shift all rings one step; echo adds notes four steps later; space keeps alternate notes.",
                "enum": [
                  "random",
                  "clear",
                  "rotate",
                  "spread",
                  "left",
                  "right",
                  "echo",
                  "space"
                ]
              },
              "ring": {
                "type": "integer",
                "description": "Zero-based ring: 0 is the highest register; 3 is the lowest. Drum labels depend on the selected kit.",
                "minimum": 0,
                "maximum": 3
              },
              "offset": {
                "type": "integer",
                "description": "Signed step offset for rotate, or optional starting offset for spread; wrapping stays within the sixteen-step loop.",
                "minimum": -1000000,
                "maximum": 1000000
              },
              "count": {
                "type": "integer",
                "description": "For spread only: how many evenly spaced notes to put on the selected ring. Zero clears that ring.",
                "minimum": 0,
                "maximum": 16
              }
            },
            "required": [
              "id",
              "operation"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.undo",
          "description": "Undo the latest editor change, pending musical recall or queued song through the same history used by the visible Undo controls.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "orbit.updateSection",
          "description": "Rename, resize, reorder or explicitly replace a captured section with the current live loop. Omitted settings and other sections remain unchanged.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Stable section ID from orbit.getArrangement.",
                "minLength": 1,
                "maxLength": 48,
                "pattern": "^[a-zA-Z0-9_-]+$"
              },
              "name": {
                "type": "string",
                "description": "Section name; an empty name uses the editor fallback.",
                "maxLength": 28
              },
              "loops": {
                "type": "number",
                "description": "Number of loops in this section.",
                "enum": [
                  1,
                  2,
                  4
                ]
              },
              "useCurrentLoop": {
                "type": "boolean",
                "description": "If true, replace this section’s captured music with the current loop."
              },
              "position": {
                "type": "integer",
                "description": "Zero-based target position in the existing section order.",
                "minimum": 0,
                "maximum": 3
              }
            },
            "required": [
              "id"
            ],
            "additionalProperties": false,
            "minProperties": 2
          },
          "readOnly": false
        },
        {
          "name": "orbit.useComparison",
          "description": "Choose the kept comparison version or latest draft explicitly. A playing session can queue the musical handoff at a loop boundary.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "version": {
                "type": "string",
                "description": "Comparison side to hear.",
                "enum": [
                  "kept",
                  "draft"
                ]
              }
            },
            "required": [
              "version"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.downloadArtifact",
          "description": "Request a browser download of an existing artifact. Browser policy may block the request; this never claims the file reached disk.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.getInfo",
          "description": "Discover this active page, appearance and the seven public creative routes. Does not start audio or a renderer.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "site.navigate",
          "description": "Navigate this browser tab to another public creative page. The next page has a new command context; rediscover its tools. This may discard an unsaved uploaded file.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "enum": [
                  "home",
                  "orbit",
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "section": {
                "type": "string",
                "enum": [
                  "main",
                  "visualizers",
                  "make-music",
                  "make-music-with-ai",
                  "how-it-works",
                  "studio",
                  "studio-root",
                  "about-studio"
                ]
              }
            },
            "required": [
              "page"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setTheme",
          "description": "Set Light, Dark or System appearance through the existing shared preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "enum": [
                  "light",
                  "dark",
                  "system"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.cancelOperation",
          "description": "Request cancellation of the active visual import/export or pending microphone capture, including operations started in the UI.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.clearBackground",
          "description": "Remove the current background image and release its local preview URL.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.downloadExport",
          "description": "Request the completed visible export panel’s browser download, including renders started by a person. This reports a request, not disk completion; use site.downloadArtifact for agent-job artifacts.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.export",
          "description": "Render through the existing media exporter. Read getCapabilities for supported media/options. Returns a cancellable job and a completed artifact, not a claim of disk download.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [
              "media"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.getCapabilities",
          "description": "Read the active world, exact setting names/ranges, palettes, sources, export formats and supported visual actions.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getExport",
          "description": "Read the visible export panel options, running status and its completed UI-render download metadata. Agent-render artifacts remain in their jobs.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getPlayback",
          "description": "Read current playhead, duration and transport. This transient read does not change the state revision.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getState",
          "description": "Read this visualizer state without advancing playback or starting a renderer. Playhead is available separately.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.importBackground",
          "description": "Decode a staged PNG/JPEG/WebP image under 20 MiB through the existing background loader. Keeps the old image on failure.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openBackgroundPicker",
          "description": "Request the native background file input. Requires a trusted user gesture and user selection; does not itself import a file.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openSave",
          "description": "Use Save editable music: return to editing and reveal the pocket collection’s save controls with canonical settled scrolling/focus. This opens the save controls; it does not create a saved copy.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.renderFrame",
          "description": "Render a composed PNG from the current artwork without claiming a browser download completed. Returns an artifact handle in a job.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.resetSettings",
          "description": "Restore this world’s visual defaults using the existing reset action.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setExportOptions",
          "description": "Select media, video composition, Watercolor paper or eligible Orbit loops without rendering. Uses the same controls as the export panel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setFullscreen",
          "description": "Request/exit native browser fullscreen. Entering requires activation and browser permission/support; reports actual fullscreen state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setImmersive",
          "description": "Enter or leave the page’s immersive artwork layout; native fullscreen is requested only by setFullscreen.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMuted",
          "description": "Explicitly mute/unmute the existing listening transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "muted": {
                "type": "boolean"
              }
            },
            "required": [
              "muted"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPanel",
          "description": "Explicitly open/close an existing visual settings, source, examples, export or menu panel. Available panel names come from getCapabilities.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "panel": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "panel",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPlaying",
          "description": "Explicitly play or pause the existing source/session. Browser audio startup may require user activation.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean"
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setRenderer",
          "description": "Choose another visual world within this same Orbit session, retaining its music and each world’s visual settings.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              }
            },
            "required": [
              "visualizer"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setSettings",
          "description": "Atomically set visual settings. Read getCapabilities for supported keys, numeric limits and palette indices for the current world.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "settings": {
                "type": "object",
                "minProperties": 1,
                "maxProperties": 40,
                "additionalProperties": {
                  "type": "number"
                }
              }
            },
            "required": [
              "settings"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setText",
          "description": "Set the existing song title and artist overlay, included in frame/video exports.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 100
              },
              "artist": {
                "type": "string",
                "maxLength": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setView",
          "description": "Switch between Orbit editing and visualization using the existing guarded view change; retains one live session.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "view": {
                "type": "string",
                "enum": [
                  "edit",
                  "visual"
                ]
              }
            },
            "required": [
              "view"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setVolume",
          "description": "Set listening volume from 0 to 1 through the existing transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "volume": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "volume"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        }
      ]
    },
    {
      "id": "watercolor",
      "label": "Watercolor",
      "path": "/watercolor/",
      "commands": [
        {
          "name": "agent.cancelJob",
          "description": "Cancel a running background job while retaining its final cancellation status.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.describe",
          "description": "Discover the commands, schemas, transport support and resource limits available on this page.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getJob",
          "description": "Read a background job result, progress or failure after starting an export or another long operation.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getState",
          "description": "Read current application state and retained file/job metadata without starting playback or changing music.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.listFiles",
          "description": "List staged local file handles and metadata without reading or exposing their contents or disk paths.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.releaseArtifact",
          "description": "Release a generated download handle and its retained data when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.releaseFile",
          "description": "Release a staged file reference after importing or when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.stageFile",
          "description": "Stage a small file from canonical padded base64 so a later import command can consume its fileId. Larger local files use api.attachFile or the browser file picker.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "mediaType": {
                "type": "string",
                "maxLength": 200
              },
              "dataBase64": {
                "type": "string",
                "maxLength": 11184812
              }
            },
            "required": [
              "filename",
              "dataBase64"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.downloadArtifact",
          "description": "Request a browser download of an existing artifact. Browser policy may block the request; this never claims the file reached disk.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.getInfo",
          "description": "Discover this active page, appearance and the seven public creative routes. Does not start audio or a renderer.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "site.navigate",
          "description": "Navigate this browser tab to another public creative page. The next page has a new command context; rediscover its tools. This may discard an unsaved uploaded file.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "enum": [
                  "home",
                  "orbit",
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "section": {
                "type": "string",
                "enum": [
                  "main",
                  "visualizers",
                  "make-music",
                  "make-music-with-ai",
                  "how-it-works",
                  "studio",
                  "studio-root",
                  "about-studio"
                ]
              }
            },
            "required": [
              "page"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setDisclosure",
          "description": "Open or close an existing FAQ disclosure. Read site.getInfo for IDs and current open state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setTheme",
          "description": "Set Light, Dark or System appearance through the existing shared preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "enum": [
                  "light",
                  "dark",
                  "system"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showGuide",
          "description": "Reveal the existing page guide or frequently asked questions. This does not change music.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showSection",
          "description": "Scroll to an existing content section on this document. Read site.getInfo for section IDs; does not navigate or start audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "section"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.cancelOperation",
          "description": "Request cancellation of the active visual import/export or pending microphone capture, including operations started in the UI.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.clearBackground",
          "description": "Remove the current background image and release its local preview URL.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.downloadExport",
          "description": "Request the completed visible export panel’s browser download, including renders started by a person. This reports a request, not disk completion; use site.downloadArtifact for agent-job artifacts.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.export",
          "description": "Render through the existing media exporter. Read getCapabilities for supported media/options. Returns a cancellable job and a completed artifact, not a claim of disk download.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [
              "media"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.getCapabilities",
          "description": "Read the active world, exact setting names/ranges, palettes, sources, export formats and supported visual actions.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getExport",
          "description": "Read the visible export panel options, running status and its completed UI-render download metadata. Agent-render artifacts remain in their jobs.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getPlayback",
          "description": "Read current playhead, duration and transport. This transient read does not change the state revision.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getState",
          "description": "Read this visualizer state without advancing playback or starting a renderer. Playhead is available separately.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.importBackground",
          "description": "Decode a staged PNG/JPEG/WebP image under 20 MiB through the existing background loader. Keeps the old image on failure.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.importSource",
          "description": "Decode a staged local audio/video file through the existing source loader. No raw disk paths or remote fetch URL is accepted.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.loadExample",
          "description": "Load a bundled example song through the same import pipeline; getCapabilities lists exact example IDs.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "exampleId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "required": [
              "exampleId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openBackgroundPicker",
          "description": "Request the native background file input. Requires a trusted user gesture and user selection; does not itself import a file.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openSourcePicker",
          "description": "Request the native audio/video file input. Requires a trusted gesture and user file selection; does not itself load a source.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.renderFrame",
          "description": "Render a composed PNG from the current artwork without claiming a browser download completed. Returns an artifact handle in a job.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.resetSettings",
          "description": "Restore this world’s visual defaults using the existing reset action.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.seek",
          "description": "Seek within the loaded finite audio/video source.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "seconds": {
                "type": "number",
                "minimum": 0
              }
            },
            "required": [
              "seconds"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setExportOptions",
          "description": "Select media, video composition, Watercolor paper or eligible Orbit loops without rendering. Uses the same controls as the export panel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setFullscreen",
          "description": "Request/exit native browser fullscreen. Entering requires activation and browser permission/support; reports actual fullscreen state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setImmersive",
          "description": "Enter or leave the page’s immersive artwork layout; native fullscreen is requested only by setFullscreen.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setLoop",
          "description": "Set repeat playback for the loaded file; live microphone has no seek/loop timeline.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMicrophone",
          "description": "Start or stop actual microphone capture. Requires a secure context, a device and browser permission; cannot bypass the prompt.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMuted",
          "description": "Explicitly mute/unmute the existing listening transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "muted": {
                "type": "boolean"
              }
            },
            "required": [
              "muted"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPanel",
          "description": "Explicitly open/close an existing visual settings, source, examples, export or menu panel. Available panel names come from getCapabilities.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "panel": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "panel",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPlaying",
          "description": "Explicitly play or pause the existing source/session. Browser audio startup may require user activation.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean"
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setSettings",
          "description": "Atomically set visual settings. Read getCapabilities for supported keys, numeric limits and palette indices for the current world.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "settings": {
                "type": "object",
                "minProperties": 1,
                "maxProperties": 40,
                "additionalProperties": {
                  "type": "number"
                }
              }
            },
            "required": [
              "settings"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setText",
          "description": "Set the existing song title and artist overlay, included in frame/video exports.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 100
              },
              "artist": {
                "type": "string",
                "maxLength": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setVolume",
          "description": "Set listening volume from 0 to 1 through the existing transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "volume": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "volume"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        }
      ]
    },
    {
      "id": "fire",
      "label": "Fire",
      "path": "/fire/",
      "commands": [
        {
          "name": "agent.cancelJob",
          "description": "Cancel a running background job while retaining its final cancellation status.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.describe",
          "description": "Discover the commands, schemas, transport support and resource limits available on this page.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getJob",
          "description": "Read a background job result, progress or failure after starting an export or another long operation.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getState",
          "description": "Read current application state and retained file/job metadata without starting playback or changing music.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.listFiles",
          "description": "List staged local file handles and metadata without reading or exposing their contents or disk paths.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.releaseArtifact",
          "description": "Release a generated download handle and its retained data when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.releaseFile",
          "description": "Release a staged file reference after importing or when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.stageFile",
          "description": "Stage a small file from canonical padded base64 so a later import command can consume its fileId. Larger local files use api.attachFile or the browser file picker.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "mediaType": {
                "type": "string",
                "maxLength": 200
              },
              "dataBase64": {
                "type": "string",
                "maxLength": 11184812
              }
            },
            "required": [
              "filename",
              "dataBase64"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.downloadArtifact",
          "description": "Request a browser download of an existing artifact. Browser policy may block the request; this never claims the file reached disk.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.getInfo",
          "description": "Discover this active page, appearance and the seven public creative routes. Does not start audio or a renderer.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "site.navigate",
          "description": "Navigate this browser tab to another public creative page. The next page has a new command context; rediscover its tools. This may discard an unsaved uploaded file.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "enum": [
                  "home",
                  "orbit",
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "section": {
                "type": "string",
                "enum": [
                  "main",
                  "visualizers",
                  "make-music",
                  "make-music-with-ai",
                  "how-it-works",
                  "studio",
                  "studio-root",
                  "about-studio"
                ]
              }
            },
            "required": [
              "page"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setDisclosure",
          "description": "Open or close an existing FAQ disclosure. Read site.getInfo for IDs and current open state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setTheme",
          "description": "Set Light, Dark or System appearance through the existing shared preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "enum": [
                  "light",
                  "dark",
                  "system"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showGuide",
          "description": "Reveal the existing page guide or frequently asked questions. This does not change music.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showSection",
          "description": "Scroll to an existing content section on this document. Read site.getInfo for section IDs; does not navigate or start audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "section"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.cancelOperation",
          "description": "Request cancellation of the active visual import/export or pending microphone capture, including operations started in the UI.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.clearBackground",
          "description": "Remove the current background image and release its local preview URL.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.downloadExport",
          "description": "Request the completed visible export panel’s browser download, including renders started by a person. This reports a request, not disk completion; use site.downloadArtifact for agent-job artifacts.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.export",
          "description": "Render through the existing media exporter. Read getCapabilities for supported media/options. Returns a cancellable job and a completed artifact, not a claim of disk download.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [
              "media"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.getCapabilities",
          "description": "Read the active world, exact setting names/ranges, palettes, sources, export formats and supported visual actions.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getExport",
          "description": "Read the visible export panel options, running status and its completed UI-render download metadata. Agent-render artifacts remain in their jobs.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getPlayback",
          "description": "Read current playhead, duration and transport. This transient read does not change the state revision.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getState",
          "description": "Read this visualizer state without advancing playback or starting a renderer. Playhead is available separately.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.importBackground",
          "description": "Decode a staged PNG/JPEG/WebP image under 20 MiB through the existing background loader. Keeps the old image on failure.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.importSource",
          "description": "Decode a staged local audio/video file through the existing source loader. No raw disk paths or remote fetch URL is accepted.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.loadExample",
          "description": "Load a bundled example song through the same import pipeline; getCapabilities lists exact example IDs.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "exampleId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "required": [
              "exampleId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openBackgroundPicker",
          "description": "Request the native background file input. Requires a trusted user gesture and user selection; does not itself import a file.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openSourcePicker",
          "description": "Request the native audio/video file input. Requires a trusted gesture and user file selection; does not itself load a source.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.renderFrame",
          "description": "Render a composed PNG from the current artwork without claiming a browser download completed. Returns an artifact handle in a job.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.resetSettings",
          "description": "Restore this world’s visual defaults using the existing reset action.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.seek",
          "description": "Seek within the loaded finite audio/video source.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "seconds": {
                "type": "number",
                "minimum": 0
              }
            },
            "required": [
              "seconds"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setExportOptions",
          "description": "Select media, video composition, Watercolor paper or eligible Orbit loops without rendering. Uses the same controls as the export panel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setFullscreen",
          "description": "Request/exit native browser fullscreen. Entering requires activation and browser permission/support; reports actual fullscreen state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setImmersive",
          "description": "Enter or leave the page’s immersive artwork layout; native fullscreen is requested only by setFullscreen.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setLoop",
          "description": "Set repeat playback for the loaded file; live microphone has no seek/loop timeline.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMicrophone",
          "description": "Start or stop actual microphone capture. Requires a secure context, a device and browser permission; cannot bypass the prompt.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMuted",
          "description": "Explicitly mute/unmute the existing listening transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "muted": {
                "type": "boolean"
              }
            },
            "required": [
              "muted"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPanel",
          "description": "Explicitly open/close an existing visual settings, source, examples, export or menu panel. Available panel names come from getCapabilities.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "panel": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "panel",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPlaying",
          "description": "Explicitly play or pause the existing source/session. Browser audio startup may require user activation.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean"
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setSettings",
          "description": "Atomically set visual settings. Read getCapabilities for supported keys, numeric limits and palette indices for the current world.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "settings": {
                "type": "object",
                "minProperties": 1,
                "maxProperties": 40,
                "additionalProperties": {
                  "type": "number"
                }
              }
            },
            "required": [
              "settings"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setText",
          "description": "Set the existing song title and artist overlay, included in frame/video exports.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 100
              },
              "artist": {
                "type": "string",
                "maxLength": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setVolume",
          "description": "Set listening volume from 0 to 1 through the existing transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "volume": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "volume"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        }
      ]
    },
    {
      "id": "nebula",
      "label": "Nebula",
      "path": "/nebula/",
      "commands": [
        {
          "name": "agent.cancelJob",
          "description": "Cancel a running background job while retaining its final cancellation status.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.describe",
          "description": "Discover the commands, schemas, transport support and resource limits available on this page.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getJob",
          "description": "Read a background job result, progress or failure after starting an export or another long operation.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getState",
          "description": "Read current application state and retained file/job metadata without starting playback or changing music.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.listFiles",
          "description": "List staged local file handles and metadata without reading or exposing their contents or disk paths.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.releaseArtifact",
          "description": "Release a generated download handle and its retained data when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.releaseFile",
          "description": "Release a staged file reference after importing or when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.stageFile",
          "description": "Stage a small file from canonical padded base64 so a later import command can consume its fileId. Larger local files use api.attachFile or the browser file picker.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "mediaType": {
                "type": "string",
                "maxLength": 200
              },
              "dataBase64": {
                "type": "string",
                "maxLength": 11184812
              }
            },
            "required": [
              "filename",
              "dataBase64"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.downloadArtifact",
          "description": "Request a browser download of an existing artifact. Browser policy may block the request; this never claims the file reached disk.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.getInfo",
          "description": "Discover this active page, appearance and the seven public creative routes. Does not start audio or a renderer.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "site.navigate",
          "description": "Navigate this browser tab to another public creative page. The next page has a new command context; rediscover its tools. This may discard an unsaved uploaded file.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "enum": [
                  "home",
                  "orbit",
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "section": {
                "type": "string",
                "enum": [
                  "main",
                  "visualizers",
                  "make-music",
                  "make-music-with-ai",
                  "how-it-works",
                  "studio",
                  "studio-root",
                  "about-studio"
                ]
              }
            },
            "required": [
              "page"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setDisclosure",
          "description": "Open or close an existing FAQ disclosure. Read site.getInfo for IDs and current open state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setTheme",
          "description": "Set Light, Dark or System appearance through the existing shared preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "enum": [
                  "light",
                  "dark",
                  "system"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showGuide",
          "description": "Reveal the existing page guide or frequently asked questions. This does not change music.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showSection",
          "description": "Scroll to an existing content section on this document. Read site.getInfo for section IDs; does not navigate or start audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "section"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.cancelOperation",
          "description": "Request cancellation of the active visual import/export or pending microphone capture, including operations started in the UI.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.clearBackground",
          "description": "Remove the current background image and release its local preview URL.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.downloadExport",
          "description": "Request the completed visible export panel’s browser download, including renders started by a person. This reports a request, not disk completion; use site.downloadArtifact for agent-job artifacts.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.export",
          "description": "Render through the existing media exporter. Read getCapabilities for supported media/options. Returns a cancellable job and a completed artifact, not a claim of disk download.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [
              "media"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.getCapabilities",
          "description": "Read the active world, exact setting names/ranges, palettes, sources, export formats and supported visual actions.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getExport",
          "description": "Read the visible export panel options, running status and its completed UI-render download metadata. Agent-render artifacts remain in their jobs.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getPlayback",
          "description": "Read current playhead, duration and transport. This transient read does not change the state revision.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getState",
          "description": "Read this visualizer state without advancing playback or starting a renderer. Playhead is available separately.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.importBackground",
          "description": "Decode a staged PNG/JPEG/WebP image under 20 MiB through the existing background loader. Keeps the old image on failure.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.importSource",
          "description": "Decode a staged local audio/video file through the existing source loader. No raw disk paths or remote fetch URL is accepted.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.loadExample",
          "description": "Load a bundled example song through the same import pipeline; getCapabilities lists exact example IDs.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "exampleId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "required": [
              "exampleId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openBackgroundPicker",
          "description": "Request the native background file input. Requires a trusted user gesture and user selection; does not itself import a file.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openSourcePicker",
          "description": "Request the native audio/video file input. Requires a trusted gesture and user file selection; does not itself load a source.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.renderFrame",
          "description": "Render a composed PNG from the current artwork without claiming a browser download completed. Returns an artifact handle in a job.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.resetSettings",
          "description": "Restore this world’s visual defaults using the existing reset action.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.seek",
          "description": "Seek within the loaded finite audio/video source.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "seconds": {
                "type": "number",
                "minimum": 0
              }
            },
            "required": [
              "seconds"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setExportOptions",
          "description": "Select media, video composition, Watercolor paper or eligible Orbit loops without rendering. Uses the same controls as the export panel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setFullscreen",
          "description": "Request/exit native browser fullscreen. Entering requires activation and browser permission/support; reports actual fullscreen state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setImmersive",
          "description": "Enter or leave the page’s immersive artwork layout; native fullscreen is requested only by setFullscreen.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setLoop",
          "description": "Set repeat playback for the loaded file; live microphone has no seek/loop timeline.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMicrophone",
          "description": "Start or stop actual microphone capture. Requires a secure context, a device and browser permission; cannot bypass the prompt.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMuted",
          "description": "Explicitly mute/unmute the existing listening transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "muted": {
                "type": "boolean"
              }
            },
            "required": [
              "muted"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPanel",
          "description": "Explicitly open/close an existing visual settings, source, examples, export or menu panel. Available panel names come from getCapabilities.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "panel": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "panel",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPlaying",
          "description": "Explicitly play or pause the existing source/session. Browser audio startup may require user activation.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean"
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setSettings",
          "description": "Atomically set visual settings. Read getCapabilities for supported keys, numeric limits and palette indices for the current world.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "settings": {
                "type": "object",
                "minProperties": 1,
                "maxProperties": 40,
                "additionalProperties": {
                  "type": "number"
                }
              }
            },
            "required": [
              "settings"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setText",
          "description": "Set the existing song title and artist overlay, included in frame/video exports.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 100
              },
              "artist": {
                "type": "string",
                "maxLength": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setVolume",
          "description": "Set listening volume from 0 to 1 through the existing transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "volume": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "volume"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        }
      ]
    },
    {
      "id": "crystals",
      "label": "Crystal Garden",
      "path": "/crystals/",
      "commands": [
        {
          "name": "agent.cancelJob",
          "description": "Cancel a running background job while retaining its final cancellation status.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.describe",
          "description": "Discover the commands, schemas, transport support and resource limits available on this page.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getJob",
          "description": "Read a background job result, progress or failure after starting an export or another long operation.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getState",
          "description": "Read current application state and retained file/job metadata without starting playback or changing music.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.listFiles",
          "description": "List staged local file handles and metadata without reading or exposing their contents or disk paths.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.releaseArtifact",
          "description": "Release a generated download handle and its retained data when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.releaseFile",
          "description": "Release a staged file reference after importing or when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.stageFile",
          "description": "Stage a small file from canonical padded base64 so a later import command can consume its fileId. Larger local files use api.attachFile or the browser file picker.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "mediaType": {
                "type": "string",
                "maxLength": 200
              },
              "dataBase64": {
                "type": "string",
                "maxLength": 11184812
              }
            },
            "required": [
              "filename",
              "dataBase64"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.downloadArtifact",
          "description": "Request a browser download of an existing artifact. Browser policy may block the request; this never claims the file reached disk.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.getInfo",
          "description": "Discover this active page, appearance and the seven public creative routes. Does not start audio or a renderer.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "site.navigate",
          "description": "Navigate this browser tab to another public creative page. The next page has a new command context; rediscover its tools. This may discard an unsaved uploaded file.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "enum": [
                  "home",
                  "orbit",
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "section": {
                "type": "string",
                "enum": [
                  "main",
                  "visualizers",
                  "make-music",
                  "make-music-with-ai",
                  "how-it-works",
                  "studio",
                  "studio-root",
                  "about-studio"
                ]
              }
            },
            "required": [
              "page"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setDisclosure",
          "description": "Open or close an existing FAQ disclosure. Read site.getInfo for IDs and current open state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setTheme",
          "description": "Set Light, Dark or System appearance through the existing shared preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "enum": [
                  "light",
                  "dark",
                  "system"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showGuide",
          "description": "Reveal the existing page guide or frequently asked questions. This does not change music.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showSection",
          "description": "Scroll to an existing content section on this document. Read site.getInfo for section IDs; does not navigate or start audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "section"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.cancelOperation",
          "description": "Request cancellation of the active visual import/export or pending microphone capture, including operations started in the UI.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.clearBackground",
          "description": "Remove the current background image and release its local preview URL.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.downloadExport",
          "description": "Request the completed visible export panel’s browser download, including renders started by a person. This reports a request, not disk completion; use site.downloadArtifact for agent-job artifacts.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.export",
          "description": "Render through the existing media exporter. Read getCapabilities for supported media/options. Returns a cancellable job and a completed artifact, not a claim of disk download.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [
              "media"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.getCapabilities",
          "description": "Read the active world, exact setting names/ranges, palettes, sources, export formats and supported visual actions.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getExport",
          "description": "Read the visible export panel options, running status and its completed UI-render download metadata. Agent-render artifacts remain in their jobs.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getPlayback",
          "description": "Read current playhead, duration and transport. This transient read does not change the state revision.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getState",
          "description": "Read this visualizer state without advancing playback or starting a renderer. Playhead is available separately.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.importBackground",
          "description": "Decode a staged PNG/JPEG/WebP image under 20 MiB through the existing background loader. Keeps the old image on failure.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.importSource",
          "description": "Decode a staged local audio/video file through the existing source loader. No raw disk paths or remote fetch URL is accepted.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.loadExample",
          "description": "Load a bundled example song through the same import pipeline; getCapabilities lists exact example IDs.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "exampleId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "required": [
              "exampleId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openBackgroundPicker",
          "description": "Request the native background file input. Requires a trusted user gesture and user selection; does not itself import a file.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openSourcePicker",
          "description": "Request the native audio/video file input. Requires a trusted gesture and user file selection; does not itself load a source.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.renderFrame",
          "description": "Render a composed PNG from the current artwork without claiming a browser download completed. Returns an artifact handle in a job.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.resetSettings",
          "description": "Restore this world’s visual defaults using the existing reset action.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.seek",
          "description": "Seek within the loaded finite audio/video source.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "seconds": {
                "type": "number",
                "minimum": 0
              }
            },
            "required": [
              "seconds"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setExportOptions",
          "description": "Select media, video composition, Watercolor paper or eligible Orbit loops without rendering. Uses the same controls as the export panel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setFullscreen",
          "description": "Request/exit native browser fullscreen. Entering requires activation and browser permission/support; reports actual fullscreen state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setImmersive",
          "description": "Enter or leave the page’s immersive artwork layout; native fullscreen is requested only by setFullscreen.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setLoop",
          "description": "Set repeat playback for the loaded file; live microphone has no seek/loop timeline.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMicrophone",
          "description": "Start or stop actual microphone capture. Requires a secure context, a device and browser permission; cannot bypass the prompt.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMuted",
          "description": "Explicitly mute/unmute the existing listening transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "muted": {
                "type": "boolean"
              }
            },
            "required": [
              "muted"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPanel",
          "description": "Explicitly open/close an existing visual settings, source, examples, export or menu panel. Available panel names come from getCapabilities.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "panel": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "panel",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPlaying",
          "description": "Explicitly play or pause the existing source/session. Browser audio startup may require user activation.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean"
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setSettings",
          "description": "Atomically set visual settings. Read getCapabilities for supported keys, numeric limits and palette indices for the current world.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "settings": {
                "type": "object",
                "minProperties": 1,
                "maxProperties": 40,
                "additionalProperties": {
                  "type": "number"
                }
              }
            },
            "required": [
              "settings"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setText",
          "description": "Set the existing song title and artist overlay, included in frame/video exports.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 100
              },
              "artist": {
                "type": "string",
                "maxLength": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setVolume",
          "description": "Set listening volume from 0 to 1 through the existing transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "volume": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "volume"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        }
      ]
    },
    {
      "id": "mushrooms",
      "label": "Mushroom Nocturne",
      "path": "/mushrooms/",
      "commands": [
        {
          "name": "agent.cancelJob",
          "description": "Cancel a running background job while retaining its final cancellation status.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.describe",
          "description": "Discover the commands, schemas, transport support and resource limits available on this page.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getJob",
          "description": "Read a background job result, progress or failure after starting an export or another long operation.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {
              "jobId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "jobId"
            ],
            "additionalProperties": false
          }
        },
        {
          "name": "agent.getState",
          "description": "Read current application state and retained file/job metadata without starting playback or changing music.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.listFiles",
          "description": "List staged local file handles and metadata without reading or exposing their contents or disk paths.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "additionalProperties": false
          }
        },
        {
          "name": "agent.releaseArtifact",
          "description": "Release a generated download handle and its retained data when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.releaseFile",
          "description": "Release a staged file reference after importing or when it is no longer needed.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "agent.stageFile",
          "description": "Stage a small file from canonical padded base64 so a later import command can consume its fileId. Larger local files use api.attachFile or the browser file picker.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "filename": {
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              },
              "mediaType": {
                "type": "string",
                "maxLength": 200
              },
              "dataBase64": {
                "type": "string",
                "maxLength": 11184812
              }
            },
            "required": [
              "filename",
              "dataBase64"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.downloadArtifact",
          "description": "Request a browser download of an existing artifact. Browser policy may block the request; this never claims the file reached disk.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "artifactId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "artifactId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.getInfo",
          "description": "Discover this active page, appearance and the seven public creative routes. Does not start audio or a renderer.",
          "readOnly": true,
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        {
          "name": "site.navigate",
          "description": "Navigate this browser tab to another public creative page. The next page has a new command context; rediscover its tools. This may discard an unsaved uploaded file.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "page": {
                "type": "string",
                "enum": [
                  "home",
                  "orbit",
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "visualizer": {
                "type": "string",
                "enum": [
                  "watercolor",
                  "fire",
                  "nebula",
                  "crystals",
                  "mushrooms"
                ]
              },
              "section": {
                "type": "string",
                "enum": [
                  "main",
                  "visualizers",
                  "make-music",
                  "make-music-with-ai",
                  "how-it-works",
                  "studio",
                  "studio-root",
                  "about-studio"
                ]
              }
            },
            "required": [
              "page"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setDisclosure",
          "description": "Open or close an existing FAQ disclosure. Read site.getInfo for IDs and current open state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.setTheme",
          "description": "Set Light, Dark or System appearance through the existing shared preference.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "preference": {
                "type": "string",
                "enum": [
                  "light",
                  "dark",
                  "system"
                ]
              }
            },
            "required": [
              "preference"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showGuide",
          "description": "Reveal the existing page guide or frequently asked questions. This does not change music.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "site.showSection",
          "description": "Scroll to an existing content section on this document. Read site.getInfo for section IDs; does not navigate or start audio.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "section": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "section"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.cancelOperation",
          "description": "Request cancellation of the active visual import/export or pending microphone capture, including operations started in the UI.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.clearBackground",
          "description": "Remove the current background image and release its local preview URL.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.downloadExport",
          "description": "Request the completed visible export panel’s browser download, including renders started by a person. This reports a request, not disk completion; use site.downloadArtifact for agent-job artifacts.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.export",
          "description": "Render through the existing media exporter. Read getCapabilities for supported media/options. Returns a cancellable job and a completed artifact, not a claim of disk download.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [
              "media"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.getCapabilities",
          "description": "Read the active world, exact setting names/ranges, palettes, sources, export formats and supported visual actions.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getExport",
          "description": "Read the visible export panel options, running status and its completed UI-render download metadata. Agent-render artifacts remain in their jobs.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getPlayback",
          "description": "Read current playhead, duration and transport. This transient read does not change the state revision.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.getState",
          "description": "Read this visualizer state without advancing playback or starting a renderer. Playhead is available separately.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": true
        },
        {
          "name": "visualizer.importBackground",
          "description": "Decode a staged PNG/JPEG/WebP image under 20 MiB through the existing background loader. Keeps the old image on failure.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.importSource",
          "description": "Decode a staged local audio/video file through the existing source loader. No raw disk paths or remote fetch URL is accepted.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "fileId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "fileId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.loadExample",
          "description": "Load a bundled example song through the same import pipeline; getCapabilities lists exact example IDs.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "exampleId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              }
            },
            "required": [
              "exampleId"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openBackgroundPicker",
          "description": "Request the native background file input. Requires a trusted user gesture and user selection; does not itself import a file.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.openSourcePicker",
          "description": "Request the native audio/video file input. Requires a trusted gesture and user file selection; does not itself load a source.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.renderFrame",
          "description": "Render a composed PNG from the current artwork without claiming a browser download completed. Returns an artifact handle in a job.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.resetSettings",
          "description": "Restore this world’s visual defaults using the existing reset action.",
          "inputSchema": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.seek",
          "description": "Seek within the loaded finite audio/video source.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "seconds": {
                "type": "number",
                "minimum": 0
              }
            },
            "required": [
              "seconds"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setExportOptions",
          "description": "Select media, video composition, Watercolor paper or eligible Orbit loops without rendering. Uses the same controls as the export panel.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "media": {
                "type": "string",
                "enum": [
                  "mp4",
                  "wav"
                ]
              },
              "format": {
                "type": "string",
                "enum": [
                  "desktop",
                  "phone"
                ]
              },
              "paper": {
                "type": "string",
                "enum": [
                  "light",
                  "dusk"
                ]
              },
              "loops": {
                "type": "integer",
                "enum": [
                  1,
                  2,
                  4,
                  8,
                  16,
                  32
                ]
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setFullscreen",
          "description": "Request/exit native browser fullscreen. Entering requires activation and browser permission/support; reports actual fullscreen state.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setImmersive",
          "description": "Enter or leave the page’s immersive artwork layout; native fullscreen is requested only by setFullscreen.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setLoop",
          "description": "Set repeat playback for the loaded file; live microphone has no seek/loop timeline.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMicrophone",
          "description": "Start or stop actual microphone capture. Requires a secure context, a device and browser permission; cannot bypass the prompt.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "enabled": {
                "type": "boolean"
              }
            },
            "required": [
              "enabled"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setMuted",
          "description": "Explicitly mute/unmute the existing listening transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "muted": {
                "type": "boolean"
              }
            },
            "required": [
              "muted"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPanel",
          "description": "Explicitly open/close an existing visual settings, source, examples, export or menu panel. Available panel names come from getCapabilities.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "panel": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "open": {
                "type": "boolean"
              }
            },
            "required": [
              "panel",
              "open"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setPlaying",
          "description": "Explicitly play or pause the existing source/session. Browser audio startup may require user activation.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "playing": {
                "type": "boolean"
              }
            },
            "required": [
              "playing"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setSettings",
          "description": "Atomically set visual settings. Read getCapabilities for supported keys, numeric limits and palette indices for the current world.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "settings": {
                "type": "object",
                "minProperties": 1,
                "maxProperties": 40,
                "additionalProperties": {
                  "type": "number"
                }
              }
            },
            "required": [
              "settings"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setText",
          "description": "Set the existing song title and artist overlay, included in frame/video exports.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 100
              },
              "artist": {
                "type": "string",
                "maxLength": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "readOnly": false
        },
        {
          "name": "visualizer.setVolume",
          "description": "Set listening volume from 0 to 1 through the existing transport.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "volume": {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              }
            },
            "required": [
              "volume"
            ],
            "additionalProperties": false
          },
          "readOnly": false
        }
      ]
    }
  ],
  "note": "Static schemas describe implemented commands. Discover the active page with api.describe(); inspect visualizer.getCapabilities for current world, settings, panels and eligible export durations. This file is documentation, not an HTTP command endpoint."
}
