Discover Hyperwave node types, inputs, numeric controls, graph sources, and complete default node templates. Pass a kind to retrieve details; omit it for the compact inventory. Use these templates and stable ids in edit_session changes.
Parameterskind
Create a private temporary collaborative Hyperwave workspace, expiring after 24 hours. Returns sessionId, secret token, editorUrl, revision, and state. Share editorUrl with the user to collaborate. Keep token private. Sessions store project state, never chat prompts or analytics. Begin with read_session and edit_session; no account is needed.
Parametersname
Read the shared preset, current revision, expiry, and checkpoint summaries. Include checkpoints=true to retrieve restorable states. Always read after a conflict and before editing an old revision.
ParameterstokenrequiredsessionIdrequiredcheckpoints
Apply one atomic, undoable batch of changes to the shared preset. Paths are field-name arrays; nodes and connections use stable element ids instead of numeric indices, e.g. [document,graphs,root,nodes,node-id,params,gain]. Use describe_nodes templates when adding nodes. Supply baseRevision from read_session. Independent concurrent changes merge; conflicting fields return SESSION_CONFLICT. Significant agent batches automatically checkpoint the previous state. Never blindly replace the whole document after a conflict.
ParametersactorlabeltokenrequiredchangesrequiredsessionIdrequiredcheckpointbaseRevisionrequired
Create a restorable version of the current shared preset with a short description. Also use before a substantial experiment. Checkpoints are retained in the shared version history and exported preset. Use action=rename or delete with checkpointId to manage an existing version.
ParameterslabeltokenrequiredactionsessionIdrequiredbaseRevisionrequiredcheckpointId
Restore a checkpoint as a new shared edit. Requires the exact current revision; preserves the current preset as a checkpoint first. Both participants see the restored state.
ParameterstokenrequiredsessionIdrequiredbaseRevisionrequiredcheckpointIdrequired
Wait up to 20 seconds for a newer shared revision. Returns changed=false on timeout; otherwise the current state. Use while collaborating with the user, then inspect their changes before the next edit.
ParameterstokenrequiredsessionIdrequiredtimeoutMsafterRevisionrequired
Render an exact shared revision using Hyperwave's shipped WASM engine without an open browser. Returns short-lived preview WAV, wavetable WAV, and editable preset archive links. Rendering is bounded; unsupported nodes are reported rather than silently rendered as passthroughs. Open editorUrl for larger interactive renders.
ParameterstokenrequiredrevisionrequiredsessionIdrequired
Permanently delete the temporary collaborative workspace. Save or export a preset first; downloaded and normally saved presets remain available.
ParameterstokenrequiredsessionIdrequiredbaseRevisionrequired
Read supported synthesizer import formats, steps, caveats, and primary sources. Filter by exact slug or category.
Parameterssluglimitcursorcategory
Calculate packed float32 mono WAV sample count, payload bytes, total bytes, and durations. Pure calculation; no audio rendering or saved data.
ParametersframeCountrequiredsampleRaterequiredsamplesPerFramerequired
Read Hyperwave's actual WAV encoder layout for float32 or pcm16 exports, including format tag, bytes per sample, channel count, and header size.
Parametersformatrequired