{"openapi":"3.1.0","info":{"title":"Hyperwave public agent API","version":"1.1.0","description":"Hyperwave documentation, format utilities, and temporary collaborative preset workspaces. Stable /api/v1/agent routes; API-Version: 1 is optional and returned in responses. Unversioned /api/agent aliases remain supported. Breaking changes use a new major URL; any future v1 retirement will be announced at least 90 days ahead with Deprecation and Sunset headers. No retirement is scheduled. Public utilities need no credentials. create_session returns a private session token and editor link; subsequent session operations require that token in their JSON body. Sessions expire after 24 hours and store preset state and checkpoints, with no prompt analytics. Session mutations are not idempotent; read current state after an uncertain response before retrying. Conflict responses are HTTP 409. render_session uses the shipped WASM engine and returns download links valid for five minutes. Utility batch calls remain read-only and accept at most 20 operations. REST quotas are best-effort, per client and server process: 120 requests per 60 seconds. Counters are not a distributed quota guarantee. No account-library access or payments."},"servers":[{"url":"https://www.hyperwave.app"}],"externalDocs":{"url":"https://www.hyperwave.app/docs/developers","description":"Hyperwave developer documentation"},"security":[],"components":{"schemas":{"Error":{"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","hint"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}}}}}}},"paths":{"/api/v1/agent/search_docs":{"post":{"operationId":"search_docs","summary":"search docs","description":"Search Hyperwave's published wavetable documentation and return source URLs and excerpts. Retrieval only; no generated advice.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":2000,"description":"Wavetable topic or synthesizer to look up"},"limit":{"default":5,"type":"integer","minimum":1,"maximum":20},"cursor":{"type":"string","minLength":1,"maxLength":500,"pattern":"^[A-Za-z0-9_-]+$"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"excerpt":{"type":"string"}},"required":["path","title","url","markdownUrl","excerpt"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["results","next_cursor","has_more","total"],"additionalProperties":false}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/get_document":{"post":{"operationId":"get_document","summary":"get document","description":"Read the Markdown representation of one canonical public Hyperwave page. Paths come from search_docs or the sitemap.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"type":"string","maxLength":250,"pattern":"^\\/(?!\\/)[^?#]*$","description":"Canonical site path, such as /guides/vital; no domain or query string"}},"required":["path"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"path":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"markdown":{"type":"string"}},"required":["path","title","url","markdownUrl","markdown"],"additionalProperties":false}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/list_export_targets":{"post":{"operationId":"list_export_targets","summary":"list export targets","description":"Read supported synthesizer import formats, steps, caveats, and primary sources. Filter by exact slug or category.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":100},"category":{"type":"string","enum":["software","hardware","modular"]},"limit":{"default":50,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","minLength":1,"maxLength":500,"pattern":"^[A-Za-z0-9_-]+$"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targets":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"vendor":{"type":"string"},"category":{"type":"string","enum":["software","hardware","modular"]},"importFormat":{"type":"string"},"importSteps":{"type":"array","items":{"type":"string"}},"verified":{"type":"boolean"},"notes":{"type":"string"},"commonIssues":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"verifiedDate":{"type":"string"}},"required":["slug","name","vendor","category","importFormat","importSteps","verified"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["targets","next_cursor","has_more","total"],"additionalProperties":false}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/calculate_frame_size":{"post":{"operationId":"calculate_frame_size","summary":"calculate frame size","description":"Calculate packed float32 mono WAV sample count, payload bytes, total bytes, and durations. Pure calculation; no audio rendering or saved data.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"samplesPerFrame":{"type":"integer","minimum":2,"maximum":65536,"description":"Samples in each single-cycle frame"},"frameCount":{"type":"integer","minimum":1,"maximum":65536,"description":"Number of frames packed into the WAV"},"sampleRate":{"type":"integer","minimum":1,"maximum":384000,"description":"WAV sample-rate header, in Hz"}},"required":["samplesPerFrame","frameCount","sampleRate"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fileByteCountWithHeader":{"type":"number"},"frameDurationSeconds":{"type":"number"},"frameDurationSecondsAtRate":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"frameCount":{"type":"number"},"payloadByteCount":{"type":"number"},"sampleRate":{"type":"number"},"samplesPerFrame":{"type":"number"},"totalDurationSeconds":{"type":"number"},"totalSampleCount":{"type":"number"}},"required":["fileByteCountWithHeader","frameDurationSeconds","frameDurationSecondsAtRate","frameCount","payloadByteCount","sampleRate","samplesPerFrame","totalDurationSeconds","totalSampleCount"],"additionalProperties":false}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/describe_wav_encoding":{"post":{"operationId":"describe_wav_encoding","summary":"describe wav encoding","description":"Read Hyperwave's actual WAV encoder layout for float32 or pcm16 exports, including format tag, bytes per sample, channel count, and header size.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"format":{"type":"string","enum":["float32","pcm16"]}},"required":["format"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"format":{"type":"string","enum":["float32","pcm16"]},"formatTag":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bitsPerSample":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bytesPerSample":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"channels":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"headerByteLength":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["format","formatTag","bitsPerSample","bytesPerSample","channels","headerByteLength"],"additionalProperties":false}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/appfeatures":{"post":{"operationId":"appfeatures","summary":"appfeatures","description":"Read Hyperwave's current app features, practical generation workflows, pricing and availability, limitations, and canonical documentation links. Use this for product capability questions and comparisons; returns the same inventory as /features. No account or project access.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"category":{"description":"Omit to retrieve every feature","type":"string","enum":["generation","processing","inspection","export","workflow"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"featuresUrl":{"type":"string","format":"uri"},"updatedOn":{"type":"string"},"platform":{"type":"string"},"editions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"price":{"type":"string"},"priceDetail":{"type":"string"},"availability":{"type":"string","enum":["available","planned","future"]}},"required":["id","name","price","priceDetail","availability"],"additionalProperties":false}},"features":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"category":{"type":"string","enum":["generation","processing","inspection","export","workflow"]},"name":{"type":"string"},"summary":{"type":"string"},"workflow":{"type":"string"},"details":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"}},"required":["id","category","name","summary","workflow","details","url","documentationUrl"],"additionalProperties":false}},"questions":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"}},"required":["question","answer"],"additionalProperties":false}}},"required":["name","description","url","featuresUrl","updatedOn","platform","editions","features","questions"],"additionalProperties":false}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/describe_nodes":{"post":{"operationId":"describe_nodes","summary":"describe nodes","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","enum":["error","comment","value","inspector","add","subtract","multiply","divide","mix","amRm","min","max","pow","mod","oneMinus","sign","sqrt","exp","log","floor","ceil","round","trunc","greaterThan","lessThan","greaterOrEqual","lessOrEqual","equal","not","and","or","xor","sin","cos","sinCycle","cosCycle","tan","atan","asin","acos","atan2","tanh","distortion","filter","combFilter","normalize","bipolar","unipolar","removeBias","equalPower","sampleRate","bitcrush","syncWarp","formantWarp","quantizeWarp","bendWarp","squeezeWarp","pwm","abs","fract","clamp","wrap","fold","phaseShift","phaser","slew","waves","noise","wavetable","additive","waveletMultiresolutionSmear","curveSqueeze","curveIndexRemap","toSpectral","spectralTilt","spectralFilter","spectralEq","spectralDistortion","spectralPhaser","spectralNotch","spectralLimiter","spectralContrast","spectralMask","spectralCurveMix","spectralAdd","spectralSubtract","spectralMultiply","spectralDivide","spectralMin","spectralMax","spectralPow","spectralAbs","spectralNormalize","spectralFract","spectralClamp","spectralMod","spectralSign","spectralSqrt","spectralExp","spectralLog","spectralFloor","spectralCeil","spectralRound","spectralTrunc","spectralBlurDiffusion","spectralResonatorBank","spectralPhaseLock","spectralParity","spectralHarmonicScatter","spectralHarmonicRandomizer","spectralVocode","spectralFormantScale","spectralHarmonicStretch","spectralInharmonicStretch","spectralSmear","spectralRandomAmplitudes","spectralLowPass","spectralHighPass","spectralPhaseDisperse","spectralShepardTone","spectralTimeSkew","spectralDataCompress","spectralFlanger","spectralFrequencyShift","toSignal","impulseResponse","remap","waveshaper","spectralGraph","feedback","componentGraph"]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/create_session":{"post":{"operationId":"create_session","summary":"create session","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"default":"Agent preset","type":"string","minLength":1,"maxLength":100}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/read_session":{"post":{"operationId":"read_session","summary":"read session","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"checkpoints":{"default":false,"type":"boolean"}},"required":["sessionId","token"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/edit_session":{"post":{"operationId":"edit_session","summary":"edit session","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"baseRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"changes":{"minItems":1,"maxItems":256,"type":"array","items":{"type":"object","properties":{"path":{"minItems":1,"maxItems":24,"type":"array","items":{"type":"string","minLength":1,"maxLength":160}},"value":{"$ref":"#/$defs/__schema0"},"remove":{"type":"boolean"}},"required":["path"],"additionalProperties":false}},"actor":{"default":"agent","type":"string","enum":["agent","user"]},"label":{"default":"Agent edit","type":"string","minLength":1,"maxLength":120},"checkpoint":{"default":false,"type":"boolean"}},"required":["sessionId","token","baseRevision","changes"],"additionalProperties":false,"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/checkpoint_session":{"post":{"operationId":"checkpoint_session","summary":"checkpoint session","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"baseRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"label":{"default":"Checkpoint","type":"string","minLength":1,"maxLength":120},"action":{"default":"create","type":"string","enum":["create","rename","delete"]},"checkpointId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["sessionId","token","baseRevision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/restore_session":{"post":{"operationId":"restore_session","summary":"restore session","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"baseRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"checkpointId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["sessionId","token","baseRevision","checkpointId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/wait_for_changes":{"post":{"operationId":"wait_for_changes","summary":"wait for changes","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"afterRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"timeoutMs":{"default":15000,"type":"integer","minimum":0,"maximum":20000}},"required":["sessionId","token","afterRevision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/render_session":{"post":{"operationId":"render_session","summary":"render session","description":"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.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"revision":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sessionId","token","revision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/close_session":{"post":{"operationId":"close_session","summary":"close session","description":"Permanently delete the temporary collaborative workspace. Save or export a preset first; downloaded and normally saved presets remain available.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"token":{"type":"string","pattern":"^[a-f0-9]{64}$"},"baseRevision":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sessionId","token","baseRevision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"},"$defs":{"__schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/$defs/__schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/$defs/__schema0"}}]}}}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/agent/batch":{"post":{"operationId":"batch","summary":"batch","description":"Execute 1–20 independent read-only operations. Every result carries the submitted unique id, operation, status, and data or error. The envelope is validated before execution; individual failures do not discard successful results.","parameters":[{"name":"API-Version","in":"header","required":false,"description":"Major API version; defaults to 1. Unsupported versions return 400.","schema":{"type":"string","enum":["1"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"operations":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"operation":{"type":"string","enum":["search_docs","get_document","list_export_targets","calculate_frame_size","describe_wav_encoding","appfeatures"]},"arguments":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","operation","arguments"],"additionalProperties":false}}},"required":["operations"],"additionalProperties":false}}}},"responses":{"200":{"description":"Operation completed","headers":{"API-Version":{"schema":{"type":"string"}},"RateLimit":{"description":"Current quota: \"public-agent\";r=<remaining>;t=<seconds>","schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"operation":{"type":"string"},"status":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message","hint"],"additionalProperties":false}},"required":["id","operation","status"],"additionalProperties":false}}},"required":["results"],"additionalProperties":false}}}},"400":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"405":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"415":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Quota exhausted; respect Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Invalid or unsupported request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}