{"serverId":"mcp-registry/one.cutclip/cutclip","tools":[{"name":"asset.capture_frame","fixed":{"name":"asset_capture_frame","description":"Grab one frame of a video asset (e.g. a take) as a new PNG image asset. timeMs is the position in the video itself, not on the timeline. Save the result with shot.add_still, location.add_reference or character.add_reference.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","assetId","timeMs"],"properties":{"timeMs":{"type":"number","minimum":0},"assetId":{"type":"string"},"projectId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"asset.capture_frame\" → \"asset_capture_frame\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":150,"tokensAfter":150},{"name":"asset.get","fixed":{"name":"asset_get","description":"Fetch one asset's metadata (type, source, mime type, duration/dimensions if known) plus a downloadUrl for its file: a plain HTTP GET, no auth header needed, valid 24h (call again for a fresh one)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["assetId"],"properties":{"assetId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"asset.get\" → \"asset_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":115,"tokensAfter":115},{"name":"asset.list","fixed":{"name":"asset_list","description":"List every asset uploaded/generated for a project (§11.7)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"asset.list\" → \"asset_list\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":78,"tokensAfter":78},{"name":"asset.replace_placeholder","fixed":{"name":"asset_replace_placeholder","description":"Point a placeholder at a real uploaded/generated asset (§11.7, §18.2). Preserves the placeholder and its prompt for provenance; sets its status to 'generated'.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","placeholderId","assetId"],"properties":{"assetId":{"type":"string"},"projectId":{"type":"string"},"placeholderId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"asset.replace_placeholder\" → \"asset_replace_placeholder\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":150,"tokensAfter":150},{"name":"asset.upload","fixed":{"name":"asset_upload","description":"Upload a video, audio or image file into a project's media library. Send the file bytes as base64 (max 50 MB; larger files must be uploaded in the browser). Returns the new assetId.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","filename","mimeType","contentBase64"],"properties":{"filename":{"type":"string","maxLength":255,"minLength":1},"mimeType":{"type":"string","pattern":"^(video|audio|image)\\/"},"projectId":{"type":"string"},"contentBase64":{"type":"string","minLength":1}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"asset.upload\" → \"asset_upload\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":171,"tokensAfter":171},{"name":"character.add_reference","fixed":{"name":"character_add_reference","description":"Attach an image asset (e.g. an uploaded photo via asset.upload) to a character as one view of its character map. The first reference becomes the identity anchor.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","characterId","assetId","view"],"properties":{"view":{"enum":["front","three_quarter_left","three_quarter_right","profile_left","profile_right","back","full_body","closeup","expression","custom"],"type":"string"},"label":{"type":"string"},"assetId":{"type":"string"},"projectId":{"type":"string"},"characterId":{"type":"string"},"makePrimary":{"type":"boolean"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"character.add_reference\" → \"character_add_reference\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":214,"tokensAfter":214},{"name":"character.create","fixed":{"name":"character_create","description":"Add a recurring character to the cast. Describe appearance precisely — it drives the generated reference sheet.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","name"],"properties":{"name":{"type":"string","minLength":1},"role":{"type":"string"},"notes":{"type":"string"},"voiceId":{"type":["string","null"],"description":"ElevenLabs voice this character speaks with (voice.list); null clears it"},"wardrobe":{"type":"string"},"projectId":{"type":"string"},"voiceName":{"type":["string","null"],"description":"The voice's display name, as voice.list gives it"},"appearance":{"type":"string","description":"Face, hair, build, age — identity details that must not drift"},"description":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"character.create\" → \"character_create\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":248,"tokensAfter":248},{"name":"character.delete","fixed":{"name":"character_delete","description":"Remove a character (and its reference sheet) from the cast","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","characterId"],"properties":{"projectId":{"type":"string"},"characterId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"character.delete\" → \"character_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":108,"tokensAfter":108},{"name":"character.generate_sheet","fixed":{"name":"character_generate_sheet","description":"Generate the character map (front, ¾ left/right, profile, back, full body, close-up) with an image model, keeping one identity. With no reference yet, a front portrait is generated first from the description. Costs credits per image (see generation.list_models), charged to the project owner. Runs in the background — poll generation.list. Views the character already has are skipped unless listed in views.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","characterId"],"properties":{"label":{"type":"string","description":"Free-text pose/expression for a custom or expression view"},"views":{"type":"array","items":{"enum":["front","three_quarter_left","three_quarter_right","profile_left","profile_right","back","full_body","closeup","expression","custom"],"type":"string"}},"projectId":{"type":"string"},"imageModel":{"type":"string"},"characterId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"character.generate_sheet\" → \"character_generate_sheet\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":282,"tokensAfter":282},{"name":"character.generate_view","fixed":{"name":"character_generate_view","description":"Generate (or regenerate) one view of a character's map, e.g. an expression. Costs credits, charged to the project owner.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","characterId","view"],"properties":{"view":{"enum":["front","three_quarter_left","three_quarter_right","profile_left","profile_right","back","full_body","closeup","expression","custom"],"type":"string"},"label":{"type":"string"},"projectId":{"type":"string"},"imageModel":{"type":"string"},"characterId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"character.generate_view\" → \"character_generate_view\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":176,"tokensAfter":176},{"name":"character.get","fixed":{"name":"character_get","description":"Get one character and its reference images","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["characterId"],"properties":{"characterId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"character.get\" → \"character_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":75,"tokensAfter":75},{"name":"character.list","fixed":{"name":"character_list","description":"List the project's cast with each character's reference images (the character map)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"character.list\" → \"character_list\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":86,"tokensAfter":86},{"name":"character.remove_reference","fixed":{"name":"character_remove_reference","description":"Remove one reference image from a character's map","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","referenceId"],"properties":{"projectId":{"type":"string"},"referenceId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"character.remove_reference\" → \"character_remove_reference\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":108,"tokensAfter":108},{"name":"character.set_primary","fixed":{"name":"character_set_primary","description":"Choose which reference image anchors the character's identity in generated views and shots","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","characterId","referenceId"],"properties":{"projectId":{"type":"string"},"characterId":{"type":"string"},"referenceId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"character.set_primary\" → \"character_set_primary\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":131,"tokensAfter":131},{"name":"character.update","fixed":{"name":"character_update","description":"Update a character's name, description or voice","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","characterId"],"properties":{"name":{"type":"string","minLength":1},"role":{"type":"string"},"notes":{"type":"string"},"voiceId":{"type":["string","null"],"description":"ElevenLabs voice this character speaks with (voice.list); null clears it"},"wardrobe":{"type":"string"},"projectId":{"type":"string"},"voiceName":{"type":["string","null"],"description":"The voice's display name, as voice.list gives it"},"appearance":{"type":"string","description":"Face, hair, build, age — identity details that must not drift"},"characterId":{"type":"string"},"description":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"character.update\" → \"character_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":241,"tokensAfter":241},{"name":"credits.get_balance","fixed":{"name":"credits_get_balance","description":"Get the credit balance of the project's owner, and what a render costs, in milli-credits (1000 = 1 credit). Check this before starting a render if the balance may be low.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"credits.get_balance\" → \"credits_get_balance\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":112,"tokensAfter":112},{"name":"credits.list_history","fixed":{"name":"credits_list_history","description":"List the project owner's credit history, newest first: purchases, assistant usage, renders and AI generations, each with its signed amount in milli-credits (1000 = 1 credit; negative = spent), balance after, detail (model, resolution, tokens…) and the project it was for. Also returns net spend per category over the last 30 days. Pass nextCursor back as cursor for older entries.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"limit":{"type":"integer","maximum":100,"minimum":1},"cursor":{"type":"string"},"category":{"enum":["purchases","assistant","renders","generations"],"type":"string"},"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"credits.list_history\" → \"credits_list_history\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":216,"tokensAfter":216},{"name":"film.get_look","fixed":{"name":"film_get_look","description":"Get the project's film look (style, grade, film stock, camera body, default models)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"film.get_look\" → \"film_get_look\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":86,"tokensAfter":86},{"name":"film.update_look","fixed":{"name":"film_update_look","description":"Set the project's film look (§36). Fields merge into the current look unless replace is true. Set this first: every shot prompt inherits it.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","look"],"properties":{"look":{"type":"object","properties":{"filmStock":{"type":"string"},"cameraBody":{"type":"string"},"colorGrade":{"type":"string"},"aspectRatio":{"enum":["16:9","2.39:1","4:3","1:1","4:5","3:4","9:16"],"type":"string","description":"Frame shape for every generated still/plate (unset = the project's frame); 9:16 or 4:5 for vertical social video"},"visualStyle":{"type":"string"},"lightingStyle":{"type":"string"},"cameraLanguage":{"type":"string"},"negativePrompt":{"type":"string"},"defaultImageModel":{"type":"string"},"defaultVideoModel":{"type":"string"}},"description":"Project-wide look applied to every shot prompt. An empty string clears a field.","additionalProperties":false},"replace":{"type":"boolean"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"film.update_look\" → \"film_update_look\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":318,"tokensAfter":318},{"name":"generation.cancel","fixed":{"name":"generation_cancel","description":"Cancel a queued or running generation. A job that hasn't reached the provider is refunded.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["generationJobId"],"properties":{"generationJobId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"generation.cancel\" → \"generation_cancel\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":92,"tokensAfter":92},{"name":"generation.list","fixed":{"name":"generation_list","description":"List generation jobs (character views, location plates, keyframes, takes, lip-synced/re-voiced takes, music, voice lines) for a project, newest first, optionally for one shot, character, location or music/voice placeholder. outputAssetIds are the results.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"shotId":{"type":"string"},"projectId":{"type":"string"},"locationId":{"type":"string"},"characterId":{"type":"string"},"placeholderId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"generation.list\" → \"generation_list\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":169,"tokensAfter":169},{"name":"generation.list_models","fixed":{"name":"generation_list_models","description":"List the generation models (image and video) with their capabilities and prices in milli-credits (1000 = 1 credit).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"generation.list_models\" → \"generation_list_models\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":74,"tokensAfter":74},{"name":"generation.status","fixed":{"name":"generation_status","description":"Get one generation job's status, progress and outputs","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["generationJobId"],"properties":{"generationJobId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"generation.status\" → \"generation_status\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":82,"tokensAfter":82},{"name":"location.add_reference","fixed":{"name":"location_add_reference","description":"Attach an image asset (e.g. an uploaded photo via asset.upload) to a location as one of its reference plates (wide, reverse, detail or custom)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","locationId","assetId","view"],"properties":{"view":{"enum":["wide","reverse","detail","custom"],"type":"string"},"label":{"type":"string"},"assetId":{"type":"string"},"projectId":{"type":"string"},"locationId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"location.add_reference\" → \"location_add_reference\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":171,"tokensAfter":171},{"name":"location.create","fixed":{"name":"location_create","description":"Add a recurring location (setting) to the library. Describe it precisely — it drives the generated plates. Assign it to scenes with scene.update locationId; shots inherit it.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","name"],"properties":{"name":{"type":"string","minLength":1},"notes":{"type":"string"},"projectId":{"type":"string"},"description":{"type":"string","description":"Architecture, layout, materials, props, weather — what must look the same in every shot set here"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"location.create\" → \"location_create\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":187,"tokensAfter":187},{"name":"location.delete","fixed":{"name":"location_delete","description":"Remove a location (and its plates) from the library. Scenes and shots set there fall back to text only.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","locationId"],"properties":{"projectId":{"type":"string"},"locationId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"location.delete\" → \"location_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":119,"tokensAfter":119},{"name":"location.generate_plates","fixed":{"name":"location_generate_plates","description":"Generate a location's reference plates (wide, reverse angle, detail) with an image model, keeping one place. With no plate yet, the first is drawn from the description. Costs credits per image (see generation.list_models), charged to the project owner. Runs in the background — poll generation.list. Views the location already has are skipped unless listed in views.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","locationId"],"properties":{"label":{"type":"string","description":"Free-text angle for a custom view"},"views":{"type":"array","items":{"enum":["wide","reverse","detail","custom"],"type":"string"}},"projectId":{"type":"string"},"imageModel":{"type":"string"},"locationId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"location.generate_plates\" → \"location_generate_plates\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":236,"tokensAfter":236},{"name":"location.get","fixed":{"name":"location_get","description":"Get one location and its reference plates","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["locationId"],"properties":{"locationId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"location.get\" → \"location_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":74,"tokensAfter":74},{"name":"location.list","fixed":{"name":"location_list","description":"List the project's location library with each location's reference plates","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"location.list\" → \"location_list\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":83,"tokensAfter":83},{"name":"location.remove_reference","fixed":{"name":"location_remove_reference","description":"Remove one reference plate from a location","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","locationReferenceId"],"properties":{"projectId":{"type":"string"},"expectedVersion":{"type":"integer"},"locationReferenceId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"location.remove_reference\" → \"location_remove_reference\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":110,"tokensAfter":110},{"name":"location.update","fixed":{"name":"location_update","description":"Update a location's name or description","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","locationId"],"properties":{"name":{"type":"string","minLength":1},"notes":{"type":"string"},"projectId":{"type":"string"},"locationId":{"type":"string"},"description":{"type":"string","description":"Architecture, layout, materials, props, weather — what must look the same in every shot set here"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"location.update\" → \"location_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":160,"tokensAfter":160},{"name":"music.compile_prompt","fixed":{"name":"music_compile_prompt","description":"Preview what music.generate would send to Lyria for a placeholder — prompt, length, model and cost. Free.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","placeholderId"],"properties":{"model":{"type":"string","description":"lyria-3-clip (30 s) or lyria-3.5 (full song); defaults by the clip's length"},"lyrics":{"type":"string","description":"Words to sing, with optional [Verse]/[Chorus] tags. Ignored when instrumental"},"prompt":{"type":"string","description":"Genre, mood, instruments, tempo. Defaults to the clip's prompt, then the scene's music prompt"},"projectId":{"type":"string"},"instrumental":{"type":"boolean"},"placeholderId":{"type":"string","description":"A music or ambience placeholder on an audio track (timeline.add_placeholder; scenario.apply_to_timeline makes a \"Score\" one)"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"music.compile_prompt\" → \"music_compile_prompt\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":261,"tokensAfter":261},{"name":"music.generate","fixed":{"name":"music_generate","description":"Generate a music track with Google Lyria (the model behind Flow Music) for a music/ambience placeholder, sized to the clip. Costs credits per track, charged to the project owner. Runs in the background — poll generation.list with placeholderId. The finished track fills the clip (undoable).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","placeholderId"],"properties":{"model":{"type":"string","description":"lyria-3-clip (30 s) or lyria-3.5 (full song); defaults by the clip's length"},"lyrics":{"type":"string","description":"Words to sing, with optional [Verse]/[Chorus] tags. Ignored when instrumental"},"prompt":{"type":"string","description":"Genre, mood, instruments, tempo. Defaults to the clip's prompt, then the scene's music prompt"},"projectId":{"type":"string"},"instrumental":{"type":"boolean"},"placeholderId":{"type":"string","description":"A music or ambience placeholder on an audio track (timeline.add_placeholder; scenario.apply_to_timeline makes a \"Score\" one)"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"music.generate\" → \"music_generate\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":311,"tokensAfter":311},{"name":"project.create","fixed":{"name":"project_create","description":"Create a new film project (§11.1)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["name"],"properties":{"fps":{"type":"integer","exclusiveMinimum":0},"name":{"type":"string","minLength":1},"width":{"type":"integer","exclusiveMinimum":0},"height":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"project.create\" → \"project_create\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":113,"tokensAfter":113},{"name":"project.delete","fixed":{"name":"project_delete","description":"Permanently delete a project and everything in it (tracks, scenes, assets, render history). Cannot be undone.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"project.delete\" → \"project_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":93,"tokensAfter":93},{"name":"project.export","fixed":{"name":"project_export","description":"Export a project's full structure (settings, tracks, scenes, timeline, placeholders, transitions, current prompts) as a portable JSON document, suitable for project.import","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"project.export\" → \"project_export\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":110,"tokensAfter":110},{"name":"project.get_state","fixed":{"name":"project_get_state","description":"Fetch a project's full current state: project, tracks, scenes, timeline items, placeholders, scenarios","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"project.get_state\" → \"project_get_state\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":92,"tokensAfter":92},{"name":"project.get_summary","fixed":{"name":"project_get_summary","description":"Fetch a compact project summary (project settings, tracks, scene list) — prefer this over project.get_state for normal conversation context (§16)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"project.get_summary\" → \"project_get_summary\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":105,"tokensAfter":105},{"name":"project.import","fixed":{"name":"project_import","description":"Create a brand-new project from a project.export JSON document. Only relinks media whose asset id still exists and is owned by ownerId; anything else comes in unresolved.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["data"],"properties":{"data":{"type":"object","required":["schemaVersion","project","tracks","scenes","placeholders","timelineItems"],"properties":{"scenes":{"type":"array","items":{"type":"object","required":["id","order","title","summary","plannedDurationMs"],"properties":{"id":{"type":"string"},"order":{"type":"integer"},"title":{"type":"string"},"prompts":{"type":"object","default":{},"properties":{"music":{"$ref":"#/properties/data/properties/scenes/items/properties/prompts/properties/visual"},"sound":{"$ref":"#/properties/data/properties/scenes/items/properties/prompts/properties/visual"},"voice":{"$ref":"#/properties/data/properties/scenes/items/properties/prompts/properties/visual"},"visual":{"type":"object","required":["type","text","createdBy"],"properties":{"text":{"type":"string"},"type":{"enum":["video","image","music","sound_effect","voice"],"type":"string"},"style":{"type":"array","items":{"type":"string"},"default":[]},"camera":{"type":"array","items":{"type":"string"},"default":[]},"intent":{"type":["string","null"]},"motion":{"type":"array","items":{"type":"string"},"default":[]},"lighting":{"type":"array","items":{"type":"string"},"default":[]},"createdBy":{"enum":["human","ai"],"type":"string"},"aspectRatio":{"type":["string","null"]},"durationSec":{"type":["number","null"]},"environment":{"type":"array","items":{"type":"string"},"default":[]},"soundDesign":{"type":"array","items":{"type":"string"},"default":[]},"providerHints":{"type":"object","default":{},"additionalProperties":{}},"negativePrompt":{"type":["string","null"]}},"additionalProperties":false}},"additionalProperties":false},"summary":{"type":"string"},"metadata":{},"narrativePurpose":{"type":["string","null"]},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false}},"tracks":{"type":"array","items":{"type":"object","required":["id","type","name","order","muted","locked","volume"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"enum":["video","audio"],"type":"string"},"muted":{"type":"boolean"},"order":{"type":"integer"},"locked":{"type":"boolean"},"volume":{"type":"number"}},"additionalProperties":false}},"project":{"type":"object","required":["name","width","height","fps"],"properties":{"fps":{"type":"integer","exclusiveMinimum":0},"name":{"type":"string"},"width":{"type":"integer","exclusiveMinimum":0},"height":{"type":"integer","exclusiveMinimum":0},"description":{"type":["string","null"]}},"additionalProperties":false},"placeholders":{"type":"array","items":{"type":"object","required":["id","kind","title","durationMs","status"],"properties":{"id":{"type":"string"},"kind":{"enum":["video","image","music","sound_effect","ambience","voice"],"type":"string"},"title":{"type":"string"},"prompt":{"anyOf":[{"$ref":"#/properties/data/properties/scenes/items/properties/prompts/properties/visual"},{"type":"null"}]},"status":{"enum":["empty","prompt_ready","generation_queued","generating","generated","failed"],"type":"string"},"sceneId":{"type":["string","null"]},"durationMs":{"type":"integer","exclusiveMinimum":0},"generatedAssetId":{"type":["string","null"]}},"additionalProperties":false}},"schemaVersion":{"type":"number","const":1},"timelineItems":{"type":"array","items":{"type":"object","required":["id","trackId","type","startMs","durationMs"],"properties":{"id":{"type":"string"},"type":{"enum":["media","placeholder","transition"],"type":"string"},"speed":{"type":["number","null"]},"volume":{"type":["number","null"]},"assetId":{"type":["string","null"]},"opacity":{"type":["number","null"]},"sceneId":{"type":["string","null"]},"startMs":{"type":"integer","minimum":0},"trackId":{"type":"string"},"toItemId":{"type":["string","null"]},"durationMs":{"type":"integer","exclusiveMinimum":0},"fromItemId":{"type":["string","null"]},"sourceInMs":{"anyOf":[{"type":"integer"},{"type":"null"}]},"transformX":{"type":["number","null"]},"transformY":{"type":["number","null"]},"sourceOutMs":{"anyOf":[{"type":"integer"},{"type":"null"}]},"placeholderId":{"type":["string","null"]},"transformScale":{"type":["number","null"]},"transitionKind":{"anyOf":[{"enum":["crossfade","smooth_blend","fade_from_black","fade_to_black"],"type":"string"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},"name":{"type":"string","minLength":1}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"project.import\" → \"project_import\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":1303,"tokensAfter":1303},{"name":"project.list_for_owner","fixed":{"name":"project_list_for_owner","description":"List every project a user owns, most recently updated first","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"project.list_for_owner\" → \"project_list_for_owner\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":59,"tokensAfter":59},{"name":"project.undo","fixed":{"name":"project_undo","description":"Undo the most recent operation applied to a project (§14)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"project.undo\" → \"project_undo\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":78,"tokensAfter":78},{"name":"project.update","fixed":{"name":"project_update","description":"Rename a project or change its description","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion"],"properties":{"name":{"type":"string","minLength":1},"projectId":{"type":"string"},"description":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"project.update\" → \"project_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":110,"tokensAfter":110},{"name":"prompt.attach","fixed":{"name":"prompt_attach","description":"Attach a structured prompt document to a scene slot (visual/sound/music/voice) or a placeholder directly (§8, §11.6)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","target","type","text","createdBy"],"properties":{"text":{"type":"string","minLength":1},"type":{"enum":["video","image","music","sound_effect","voice"],"type":"string"},"style":{"type":"array","items":{"type":"string"}},"camera":{"type":"array","items":{"type":"string"}},"intent":{"type":"string"},"motion":{"type":"array","items":{"type":"string"}},"target":{"anyOf":[{"type":"object","required":["sceneId","slot"],"properties":{"slot":{"enum":["visual","sound","music","voice"],"type":"string"},"sceneId":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["placeholderId"],"properties":{"placeholderId":{"type":"string"}},"additionalProperties":false}]},"lighting":{"type":"array","items":{"type":"string"}},"createdBy":{"enum":["human","ai"],"type":"string"},"projectId":{"type":"string"},"aspectRatio":{"type":"string"},"durationSec":{"type":"number","exclusiveMinimum":0},"environment":{"type":"array","items":{"type":"string"}},"soundDesign":{"type":"array","items":{"type":"string"}},"providerHints":{"type":"object","additionalProperties":{}},"negativePrompt":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"prompt.attach\" → \"prompt_attach\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":407,"tokensAfter":407},{"name":"prompt.draft","fixed":{"name":"prompt_draft","description":"Draft three alternative generation prompts for a scene's asset (metered in credits unless the owner uses their own Anthropic key). Returns the variants; attach one to a scene with prompt.attach.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","assetType","guidance"],"properties":{"guidance":{"type":"string","minLength":1},"assetType":{"enum":["video","image","music","sound_effect","voice"],"type":"string"},"projectId":{"type":"string"},"sceneTitle":{"type":"string"},"currentText":{"type":"string"},"sceneSummary":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"prompt.draft\" → \"prompt_draft\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":185,"tokensAfter":185},{"name":"prompt.get","fixed":{"name":"prompt_get","description":"Fetch one prompt document by id","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["promptId"],"properties":{"promptId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"prompt.get\" → \"prompt_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":70,"tokensAfter":70},{"name":"prompt.list_for_scene","fixed":{"name":"prompt_list_for_scene","description":"List every prompt ever attached to a scene, across all slots and revisions","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["sceneId"],"properties":{"sceneId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"prompt.list_for_scene\" → \"prompt_list_for_scene\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":84,"tokensAfter":84},{"name":"prompt.list_revisions","fixed":{"name":"prompt_list_revisions","description":"Get the full revision history (oldest first) for a prompt's slot, given any promptId in that lineage (§17)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["promptId"],"properties":{"promptId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"prompt.list_revisions\" → \"prompt_list_revisions\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":94,"tokensAfter":94},{"name":"prompt.update","fixed":{"name":"prompt_update","description":"Revise a prompt — creates a new revision rather than overwriting the old one (§17)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","promptId","patch"],"properties":{"patch":{"type":"object","properties":{"text":{"type":"string"},"style":{"type":"array","items":{"type":"string"}},"camera":{"type":"array","items":{"type":"string"}},"intent":{"type":"string"},"motion":{"type":"array","items":{"type":"string"}},"lighting":{"type":"array","items":{"type":"string"}},"createdBy":{"enum":["human","ai"],"type":"string"},"aspectRatio":{"type":"string"},"durationSec":{"type":"number","exclusiveMinimum":0},"environment":{"type":"array","items":{"type":"string"}},"soundDesign":{"type":"array","items":{"type":"string"}},"providerHints":{"type":"object","additionalProperties":{}},"negativePrompt":{"type":"string"}},"additionalProperties":false},"promptId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"prompt.update\" → \"prompt_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":302,"tokensAfter":302},{"name":"render.delete","fixed":{"name":"render_delete","description":"Remove a render job from the project's export list. If it finished, its output file is deleted too. Cannot be undone.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["jobId"],"properties":{"jobId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"render.delete\" → \"render_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":93,"tokensAfter":93},{"name":"render.final","fixed":{"name":"render_final","description":"Start a full-resolution final export of the project's current timeline to MP4 (§11.8). Costs 5 credits at 1080p (the default), 10 at 2k (2560x1440) or 15 at 4k, charged to the project owner; fails with INSUFFICIENT_CREDITS if they can't cover it. The resolution is the short side for portrait/square shapes (9:16 at 1080p is 1080x1920). Aspect, fit, codec and quality don't change the price.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"fit":{"enum":["fill","fit"],"type":"string","description":"When the aspect differs from the project's: fill (default) center-crops the picture, fit shows all of it with black bars"},"codec":{"enum":["h264","h265"],"type":"string","description":"h264 (default; plays everywhere) or h265 (HEVC: ~40% smaller files, slower to render)"},"aspect":{"enum":["project","16:9","2.39:1","4:3","1:1","4:5","3:4","9:16"],"type":"string","description":"Shape of the exported video; project (default) keeps the project's own frame. 9:16 / 4:5 for Reels, Shorts and TikTok"},"quality":{"enum":["standard","high"],"type":"string","description":"standard (default) or high (less compression, bigger file)"},"projectId":{"type":"string"},"resolution":{"enum":["1080p","2k","4k"],"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"render.final\" → \"render_final\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":379,"tokensAfter":379},{"name":"render.get_result","fixed":{"name":"render_get_result","description":"Get a completed render job's result: the output assetId and a downloadUrl for the rendered file — a plain HTTP GET, no auth header needed, valid 24h (call again for a fresh one)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["jobId"],"properties":{"jobId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"render.get_result\" → \"render_get_result\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":111,"tokensAfter":111},{"name":"render.list_for_project","fixed":{"name":"render_list_for_project","description":"List every render job ever started for a project, most recent first","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"render.list_for_project\" → \"render_list_for_project\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":84,"tokensAfter":84},{"name":"render.preview","fixed":{"name":"render_preview","description":"Start a fast, half-resolution preview export of the project's current timeline to MP4 (§11.8). Takes the same aspect/fit as render.final so the framing can be checked cheaply. Costs 1 credit, charged to the project owner; fails with INSUFFICIENT_CREDITS if they can't cover it.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"fit":{"enum":["fill","fit"],"type":"string","description":"When the aspect differs from the project's: fill (default) center-crops the picture, fit shows all of it with black bars"},"aspect":{"enum":["project","16:9","2.39:1","4:3","1:1","4:5","3:4","9:16"],"type":"string","description":"Shape of the exported video; project (default) keeps the project's own frame. 9:16 / 4:5 for Reels, Shorts and TikTok"},"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"render.preview\" → \"render_preview\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":254,"tokensAfter":254},{"name":"render.status","fixed":{"name":"render_status","description":"Check the status/progress of a render job","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["jobId"],"properties":{"jobId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"render.status\" → \"render_status\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":72,"tokensAfter":72},{"name":"scenario.apply_to_timeline","fixed":{"name":"scenario_apply_to_timeline","description":"The high-level film-building tool (§34): materializes a staged scenario into real tracks, scenes, placeholders, and timeline items in one atomic, undoable step. Creates a video track with one placeholder per scene; optionally a Music track with one placeholder spanning the whole scenario, an SFX track with a per-scene placeholder wherever a scene has a soundPrompt, and a Voice track wherever a scene has a voicePrompt. When createPromptPlaceholders is true (default), each scene's videoPrompt/soun","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","scenarioId"],"properties":{"options":{"type":"object","properties":{"musicTrack":{"type":"boolean"},"videoTrack":{"type":"boolean"},"voiceTrack":{"type":"boolean"},"soundEffectsTrack":{"type":"boolean"},"createPromptPlaceholders":{"type":"boolean"}},"additionalProperties":false},"projectId":{"type":"string"},"scenarioId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"scenario.apply_to_timeline\" → \"scenario_apply_to_timeline\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":303,"tokensAfter":303},{"name":"scenario.create","fixed":{"name":"scenario_create","description":"Stage a concept + treatment + scene list before materializing it onto the timeline (§9, §11.2). Does not touch tracks/scenes/timeline — call scenario.apply_to_timeline next.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","concept","scenes"],"properties":{"scenes":{"type":"array","items":{"type":"object","required":["title","plannedDurationMs"],"properties":{"shots":{"type":"array","items":{"type":"object","required":["plannedDurationMs","description"],"properties":{"action":{"type":"string"},"camera":{"type":"object","properties":{"fps":{"type":"integer","maximum":240,"exclusiveMinimum":0},"lensMm":{"type":"number","maximum":1200,"description":"Focal length in mm, e.g. 24, 35, 50, 85","exclusiveMinimum":0},"aperture":{"type":"number","maximum":64,"description":"f-stop number, e.g. 1.8 for f/1.8","exclusiveMinimum":0},"filmStock":{"type":"string"},"rackFocus":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string"},"from":{"type":"string"}},"additionalProperties":false},"cameraBody":{"type":"string"},"depthOfField":{"enum":["shallow","medium","deep"],"type":"string"},"focusSubject":{"type":"string","description":"What is in focus, e.g. \"Mara's eyes\""},"shutterAngle":{"type":"number","maximum":360,"exclusiveMinimum":0},"movementSpeed":{"enum":["slow","medium","fast"],"type":"string"},"focusDistanceM":{"type":"number","exclusiveMinimum":0}},"description":"Physical camera settings. Unset fields are left to the model.","additionalProperties":false},"dialogue":{"type":"string"},"lighting":{"type":"object","properties":{"key":{"type":"string"},"mood":{"type":"string"},"timeOfDay":{"type":"string"},"colorTempK":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"shotSize":{"enum":["extreme_wide","wide","full","medium_wide","medium","medium_close_up","close_up","extreme_close_up","insert"],"type":"string"},"cameraAngle":{"enum":["eye_level","high","low","dutch","birds_eye","worms_eye","overhead","pov","over_the_shoulder"],"type":"string"},"composition":{"type":"string"},"description":{"type":"string"},"cameraMovement":{"enum":["static","pan_left","pan_right","tilt_up","tilt_down","dolly_in","dolly_out","truck_left","truck_right","pedestal_up","pedestal_down","crane_up","crane_down","orbit","handheld","steadicam","zoom_in","zoom_out","whip_pan","aerial","push_in","pull_out"],"type":"string"},"characterNames":{"type":"array","items":{"type":"string"}},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"description":"Optional shot list with camera direction; the scene's length becomes the sum of its shots. characterNames must match character.create names."},"title":{"type":"string","minLength":1},"summary":{"type":"string"},"soundPrompt":{"type":"string"},"videoPrompt":{"type":"string"},"voicePrompt":{"type":"string"},"narrativePurpose":{"type":"string"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"minItems":1},"concept":{"type":"object","required":["genre","tone","durationSec","logline"],"properties":{"tone":{"type":"array","items":{"type":"string"}},"genre":{"type":"string"},"logline":{"type":"string"},"durationSec":{"type":"number","exclusiveMinimum":0},"musicPrompt":{"type":"string"},"visualDirection":{"type":"string"}},"additionalProperties":false},"projectId":{"type":"string"},"treatment":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"scenario.create\" → \"scenario_create\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":995,"tokensAfter":995},{"name":"scenario.delete","fixed":{"name":"scenario_delete","description":"Delete a staged scenario draft (does not affect anything already applied to the timeline)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","scenarioId"],"properties":{"projectId":{"type":"string"},"scenarioId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"scenario.delete\" → \"scenario_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":115,"tokensAfter":115},{"name":"scenario.get","fixed":{"name":"scenario_get","description":"Fetch a staged scenario's concept, treatment, and scene list","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["scenarioId"],"properties":{"scenarioId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"scenario.get\" → \"scenario_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":80,"tokensAfter":80},{"name":"scenario.update","fixed":{"name":"scenario_update","description":"Revise a staged scenario's concept, treatment, and/or scene list before applying it — e.g. after the user asks for a pacing or tone change. Only the fields provided are changed.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","scenarioId"],"properties":{"scenes":{"type":"array","items":{"type":"object","required":["title","plannedDurationMs"],"properties":{"shots":{"type":"array","items":{"type":"object","required":["plannedDurationMs","description"],"properties":{"action":{"type":"string"},"camera":{"type":"object","properties":{"fps":{"type":"integer","maximum":240,"exclusiveMinimum":0},"lensMm":{"type":"number","maximum":1200,"description":"Focal length in mm, e.g. 24, 35, 50, 85","exclusiveMinimum":0},"aperture":{"type":"number","maximum":64,"description":"f-stop number, e.g. 1.8 for f/1.8","exclusiveMinimum":0},"filmStock":{"type":"string"},"rackFocus":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string"},"from":{"type":"string"}},"additionalProperties":false},"cameraBody":{"type":"string"},"depthOfField":{"enum":["shallow","medium","deep"],"type":"string"},"focusSubject":{"type":"string","description":"What is in focus, e.g. \"Mara's eyes\""},"shutterAngle":{"type":"number","maximum":360,"exclusiveMinimum":0},"movementSpeed":{"enum":["slow","medium","fast"],"type":"string"},"focusDistanceM":{"type":"number","exclusiveMinimum":0}},"description":"Physical camera settings. Unset fields are left to the model.","additionalProperties":false},"dialogue":{"type":"string"},"lighting":{"type":"object","properties":{"key":{"type":"string"},"mood":{"type":"string"},"timeOfDay":{"type":"string"},"colorTempK":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"shotSize":{"enum":["extreme_wide","wide","full","medium_wide","medium","medium_close_up","close_up","extreme_close_up","insert"],"type":"string"},"cameraAngle":{"enum":["eye_level","high","low","dutch","birds_eye","worms_eye","overhead","pov","over_the_shoulder"],"type":"string"},"composition":{"type":"string"},"description":{"type":"string"},"cameraMovement":{"enum":["static","pan_left","pan_right","tilt_up","tilt_down","dolly_in","dolly_out","truck_left","truck_right","pedestal_up","pedestal_down","crane_up","crane_down","orbit","handheld","steadicam","zoom_in","zoom_out","whip_pan","aerial","push_in","pull_out"],"type":"string"},"characterNames":{"type":"array","items":{"type":"string"}},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"description":"Optional shot list with camera direction; the scene's length becomes the sum of its shots. characterNames must match character.create names."},"title":{"type":"string","minLength":1},"summary":{"type":"string"},"soundPrompt":{"type":"string"},"videoPrompt":{"type":"string"},"voicePrompt":{"type":"string"},"narrativePurpose":{"type":"string"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"minItems":1},"concept":{"type":"object","required":["genre","tone","durationSec","logline"],"properties":{"tone":{"type":"array","items":{"type":"string"}},"genre":{"type":"string"},"logline":{"type":"string"},"durationSec":{"type":"number","exclusiveMinimum":0},"musicPrompt":{"type":"string"},"visualDirection":{"type":"string"}},"additionalProperties":false},"projectId":{"type":"string"},"treatment":{"type":"string"},"scenarioId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"scenario.update\" → \"scenario_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":1003,"tokensAfter":1003},{"name":"scene.create","fixed":{"name":"scene_create","description":"Create a storytelling scene on a project — distinct from a timeline clip (§7.2, §11.3)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","title","plannedDurationMs"],"properties":{"title":{"type":"string","minLength":1},"summary":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"},"narrativePurpose":{"type":"string"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"scene.create\" → \"scene_create\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":155,"tokensAfter":155},{"name":"scene.delete","fixed":{"name":"scene_delete","description":"Delete a scene","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","sceneId"],"properties":{"sceneId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"scene.delete\" → \"scene_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":92,"tokensAfter":92},{"name":"scene.reorder","fixed":{"name":"scene_reorder","description":"Move a scene to a new position among the project's scenes","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","sceneId","newOrder"],"properties":{"sceneId":{"type":"string"},"newOrder":{"type":"integer","minimum":0},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"scene.reorder\" → \"scene_reorder\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":119,"tokensAfter":119},{"name":"scene.update","fixed":{"name":"scene_update","description":"Update a scene's title, summary, narrative purpose, planned duration, or location (its shots inherit the location unless they override it)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","sceneId"],"properties":{"title":{"type":"string","minLength":1},"sceneId":{"type":"string"},"summary":{"type":"string"},"projectId":{"type":"string"},"locationId":{"type":["string","null"],"description":"A location from location.list; null clears it"},"expectedVersion":{"type":"integer"},"narrativePurpose":{"type":"string"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"scene.update\" → \"scene_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":201,"tokensAfter":201},{"name":"shot.add_still","fixed":{"name":"shot_add_still","description":"Add an existing image asset (e.g. a frame from asset.capture_frame, or an upload) to a shot's stills, free of charge. asStartFrame makes it the frame the video animates from; a shot without a start frame always gets it.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","shotId","assetId"],"properties":{"shotId":{"type":"string"},"assetId":{"type":"string"},"projectId":{"type":"string"},"asStartFrame":{"type":"boolean"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.add_still\" → \"shot_add_still\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":169,"tokensAfter":169},{"name":"shot.compile_prompt","fixed":{"name":"shot_compile_prompt","description":"Preview exactly what would be sent to the generation model for a shot — compiled prompt, reference images and videos, duration and cost. ignoredReferenceVideos counts the shot's reference videos the model won't receive; referenceVideoMode is follow or edit; problem says why shot.generate_video would refuse. Free.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["shotId","target"],"properties":{"model":{"type":"string"},"shotId":{"type":"string"},"target":{"enum":["keyframe","video"],"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.compile_prompt\" → \"shot_compile_prompt\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":175,"tokensAfter":175},{"name":"shot.create","fixed":{"name":"shot_create","description":"Add a shot to a scene with camera direction (§38). Each shot gets its own video clip on the timeline; the scene's length becomes the sum of its shots and later clips ripple. The first shot of a scene takes over the scene's existing video placeholder.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","sceneId"],"properties":{"seed":{"anyOf":[{"type":"integer"},{"type":"null"}]},"order":{"type":"integer","minimum":0,"description":"Position within the scene (default: last)"},"action":{"type":"string","description":"What happens during the shot (used for video)"},"camera":{"type":"object","properties":{"fps":{"type":"integer","maximum":240,"exclusiveMinimum":0},"lensMm":{"type":"number","maximum":1200,"description":"Focal length in mm, e.g. 24, 35, 50, 85","exclusiveMinimum":0},"aperture":{"type":"number","maximum":64,"description":"f-stop number, e.g. 1.8 for f/1.8","exclusiveMinimum":0},"filmStock":{"type":"string"},"rackFocus":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string"},"from":{"type":"string"}},"additionalProperties":false},"cameraBody":{"type":"string"},"depthOfField":{"enum":["shallow","medium","deep"],"type":"string"},"focusSubject":{"type":"string","description":"What is in focus, e.g. \"Mara's eyes\""},"shutterAngle":{"type":"number","maximum":360,"exclusiveMinimum":0},"movementSpeed":{"enum":["slow","medium","fast"],"type":"string"},"focusDistanceM":{"type":"number","exclusiveMinimum":0}},"description":"Physical camera settings. Unset fields are left to the model.","additionalProperties":false},"sceneId":{"type":"string"},"dialogue":{"type":"string","description":"Spoken line(s); prefix with the speaker's name (\"ANNA: …\") so shot.lipsync knows who says it"},"lighting":{"type":"object","properties":{"key":{"type":"string"},"mood":{"type":"string"},"timeOfDay":{"type":"string"},"colorTempK":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"shotSize":{"anyOf":[{"enum":["extreme_wide","wide","full","medium_wide","medium","medium_close_up","close_up","extreme_close_up","insert"],"type":"string"},{"type":"null"}]},"projectId":{"type":"string"},"locationId":{"type":["string","null"],"description":"Override the scene's location for this shot (null = where the scene is)"},"videoModel":{"type":["string","null"]},"aspectRatio":{"anyOf":[{"enum":["16:9","2.39:1","4:3","1:1","4:5","3:4","9:16"],"type":"string"},{"type":"null"}],"description":"This shot's frame shape (null = the film look's, else the project's). Stills use it; the video take follows its start frame"},"cameraAngle":{"anyOf":[{"enum":["eye_level","high","low","dutch","birds_eye","worms_eye","overhead","pov","over_the_shoulder"],"type":"string"},{"type":"null"}]},"composition":{"type":"string","description":"e.g. \"rule of thirds, subject frame left, negative space right\""},"description":{"type":"string","description":"What the frame shows"},"characterIds":{"type":"array","items":{"type":"string"},"description":"Cast members in frame — their reference images keep them consistent"},"generateAudio":{"type":"boolean","description":"Ask the video model for native audio (costs more)"},"cameraMovement":{"anyOf":[{"enum":["static","pan_left","pan_right","tilt_up","tilt_down","dolly_in","dolly_out","truck_left","truck_right","pedestal_up","pedestal_down","crane_up","crane_down","orbit","handheld","steadicam","zoom_in","zoom_out","whip_pan","aerial","push_in","pull_out"],"type":"string"},{"type":"null"}]},"expectedVersion":{"type":"integer"},"videoResolution":{"anyOf":[{"enum":["360p","480p","720p","768p","1080p","4k"],"type":"string"},{"type":"null"}],"description":"Video output resolution (null = the model's default; only some models offer a choice, and higher costs more)"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0},"speakerCharacterId":{"type":["string","null"],"description":"Who speaks the dialogue (null = the character it names, else the first cast member with a voice)"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.create\" → \"shot_create\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":1144,"tokensAfter":1144},{"name":"shot.delete","fixed":{"name":"shot_delete","description":"Delete a shot; later clips close up. Deleting a scene's last shot keeps its clip as the scene's picture slot.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","shotId"],"properties":{"shotId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"shot.delete\" → \"shot_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":118,"tokensAfter":118},{"name":"shot.draft","fixed":{"name":"shot_draft","description":"Draft a shot list for one scene — shot sizes, angles, movement, lens, f-stop, focus — from the scene, the film look and the cast (metered in credits unless the owner uses their own Anthropic key). Returns drafts only; create the ones you want with shot.create.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","sceneId"],"properties":{"count":{"type":"integer","maximum":8,"minimum":1},"sceneId":{"type":"string"},"guidance":{"type":"string","maxLength":1000},"projectId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.draft\" → \"shot_draft\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":172,"tokensAfter":172},{"name":"shot.generate_keyframe","fixed":{"name":"shot_generate_keyframe","description":"Generate keyframe image variants for a shot from its camera direction, cast references and location plates. The first variant becomes the start frame if the shot has none. Costs credits per image, charged to the project owner. Runs in the background — poll generation.list.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","shotId"],"properties":{"model":{"type":"string"},"shotId":{"type":"string"},"numImages":{"type":"integer","maximum":4,"minimum":1},"projectId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.generate_keyframe\" → \"shot_generate_keyframe\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":174,"tokensAfter":174},{"name":"shot.generate_video","fixed":{"name":"shot_generate_video","description":"Generate a video take for a shot using its camera movement, action and cast. An image_to_video model animates the start frame (shot.generate_keyframe first); a reference_to_video model needs no start frame and follows the shot's reference videos (shot.update referenceVideoAssetIds), using the keyframe as its opening image when there is one. With referenceVideoMode edit it changes the first clip itself instead (e.g. replaces a person with a cast character). Costs credits per second, charged to th","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","shotId"],"properties":{"model":{"type":"string"},"shotId":{"type":"string"},"projectId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.generate_video\" → \"shot_generate_video\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":220,"tokensAfter":220},{"name":"shot.get","fixed":{"name":"shot_get","description":"Get one shot","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["shotId"],"properties":{"shotId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"shot.get\" → \"shot_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":63,"tokensAfter":63},{"name":"shot.lipsync","fixed":{"name":"shot_lipsync","description":"Give a shot's take spoken dialogue with matching lips: ElevenLabs speaks the line in the speaker's voice (character.update voiceId), then a lip-sync model reworks the take's mouth to it. Works with any video model; best on close and medium shots with one visible face. The result is a new take with the line as its sound; it replaces the source take in the clip if that's still there (undoable). Costs credits (speech per character + lip-sync per second). Poll generation.list with shotId.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","shotId"],"properties":{"text":{"type":"string","description":"The words to speak. Defaults to the shot's dialogue without its speaker label"},"model":{"type":"string","description":"sync-lipsync-2 (default), sync-lipsync-2-pro (sharper, costlier) or kling-lipsync (2-10 s takes only, cheapest)"},"dryRun":{"type":"boolean","description":"Only preview the speaker, voice, line and cost; nothing is charged"},"shotId":{"type":"string"},"voiceId":{"type":"string","description":"Override the speaker's voice (voice.list)"},"projectId":{"type":"string"},"speechModel":{"type":"string","description":"eleven-multilingual-v2 (default), eleven-v3 or eleven-flash-v2.5"},"takeAssetId":{"type":"string","description":"The take to rework (a video from generation.list). Defaults to the take in the shot's clip"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.lipsync\" → \"shot_lipsync\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":409,"tokensAfter":409},{"name":"shot.list","fixed":{"name":"shot_list","description":"List shots (with camera settings) for one scene, or for the whole project","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"sceneId":{"type":"string"},"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"shot.list\" → \"shot_list\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":90,"tokensAfter":90},{"name":"shot.remove_keyframe","fixed":{"name":"shot_remove_keyframe","description":"Remove a generated still (keyframe asset) from a shot. If it was the shot's start or end frame, that frame is cleared. Undoable; credits are not refunded.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","shotId","assetId"],"properties":{"shotId":{"type":"string"},"assetId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"shot.remove_keyframe\" → \"shot_remove_keyframe\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":143,"tokensAfter":143},{"name":"shot.reorder","fixed":{"name":"shot_reorder","description":"Move a shot to a new position within its scene (its clips are re-laid out in the new order)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","shotId","newOrder"],"properties":{"shotId":{"type":"string"},"newOrder":{"type":"integer","minimum":0},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.reorder\" → \"shot_reorder\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":128,"tokensAfter":128},{"name":"shot.revoice","fixed":{"name":"shot_revoice","description":"Re-voice a take that has native speech (made with generateAudio on a model like Seedance 2.5, Kling O3 or Wan 3): ElevenLabs' voice changer converts the speech to the speaker's voice and keeps its timing, so the lips still match. One voice for the whole track — for single-speaker shots; ambience in the take may change. The result is a new take (replaces the source in the clip if it's there; undoable). Costs credits per minute of audio. Poll generation.list with shotId.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","shotId"],"properties":{"model":{"type":"string","description":"eleven-sts-v2 (default)"},"dryRun":{"type":"boolean","description":"Only preview the speaker, voice, line and cost; nothing is charged"},"shotId":{"type":"string"},"voiceId":{"type":"string","description":"Override the speaker's voice (voice.list)"},"projectId":{"type":"string"},"takeAssetId":{"type":"string","description":"The take to rework (a video from generation.list). Defaults to the take in the shot's clip"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.revoice\" → \"shot_revoice\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":315,"tokensAfter":315},{"name":"shot.select_keyframe","fixed":{"name":"shot_select_keyframe","description":"Use an image asset (usually a keyframe variant) as the shot's start or end frame","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","shotId","assetId"],"properties":{"which":{"enum":["start","end"],"type":"string","default":"start"},"shotId":{"type":"string"},"assetId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.select_keyframe\" → \"shot_select_keyframe\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":141,"tokensAfter":141},{"name":"shot.select_take","fixed":{"name":"shot_select_take","description":"Put a generated take (video asset) on the shot's timeline clip","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","shotId","assetId"],"properties":{"shotId":{"type":"string"},"assetId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"shot.select_take\" → \"shot_select_take\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":117,"tokensAfter":117},{"name":"shot.update","fixed":{"name":"shot_update","description":"Change a shot's story, cast, framing, camera rig, lighting, reference videos or duration (a duration change ripples later clips)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","shotId"],"properties":{"seed":{"anyOf":[{"type":"integer"},{"type":"null"}]},"action":{"type":"string","description":"What happens during the shot (used for video)"},"camera":{"type":"object","properties":{"fps":{"type":"integer","maximum":240,"exclusiveMinimum":0},"lensMm":{"type":"number","maximum":1200,"description":"Focal length in mm, e.g. 24, 35, 50, 85","exclusiveMinimum":0},"aperture":{"type":"number","maximum":64,"description":"f-stop number, e.g. 1.8 for f/1.8","exclusiveMinimum":0},"filmStock":{"type":"string"},"rackFocus":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string"},"from":{"type":"string"}},"additionalProperties":false},"cameraBody":{"type":"string"},"depthOfField":{"enum":["shallow","medium","deep"],"type":"string"},"focusSubject":{"type":"string","description":"What is in focus, e.g. \"Mara's eyes\""},"shutterAngle":{"type":"number","maximum":360,"exclusiveMinimum":0},"movementSpeed":{"enum":["slow","medium","fast"],"type":"string"},"focusDistanceM":{"type":"number","exclusiveMinimum":0}},"description":"Physical camera settings. Unset fields are left to the model.","additionalProperties":false},"shotId":{"type":"string"},"dialogue":{"type":"string","description":"Spoken line(s); prefix with the speaker's name (\"ANNA: …\") so shot.lipsync knows who says it"},"lighting":{"type":"object","properties":{"key":{"type":"string"},"mood":{"type":"string"},"timeOfDay":{"type":"string"},"colorTempK":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"shotSize":{"anyOf":[{"enum":["extreme_wide","wide","full","medium_wide","medium","medium_close_up","close_up","extreme_close_up","insert"],"type":"string"},{"type":"null"}]},"projectId":{"type":"string"},"locationId":{"type":["string","null"],"description":"Override the scene's location for this shot (null = where the scene is)"},"videoModel":{"type":["string","null"]},"aspectRatio":{"anyOf":[{"enum":["16:9","2.39:1","4:3","1:1","4:5","3:4","9:16"],"type":"string"},{"type":"null"}],"description":"This shot's frame shape (null = the film look's, else the project's). Stills use it; the video take follows its start frame"},"cameraAngle":{"anyOf":[{"enum":["eye_level","high","low","dutch","birds_eye","worms_eye","overhead","pov","over_the_shoulder"],"type":"string"},{"type":"null"}]},"composition":{"type":"string","description":"e.g. \"rule of thirds, subject frame left, negative space right\""},"description":{"type":"string","description":"What the frame shows"},"characterIds":{"type":"array","items":{"type":"string"},"description":"Cast members in frame — their reference images keep them consistent"},"generateAudio":{"type":"boolean","description":"Ask the video model for native audio (costs more)"},"cameraMovement":{"anyOf":[{"enum":["static","pan_left","pan_right","tilt_up","tilt_down","dolly_in","dolly_out","truck_left","truck_right","pedestal_up","pedestal_down","crane_up","crane_down","orbit","handheld","steadicam","zoom_in","zoom_out","whip_pan","aerial","push_in","pull_out"],"type":"string"},{"type":"null"}]},"endFrameAssetId":{"type":["string","null"]},"expectedVersion":{"type":"integer"},"videoResolution":{"anyOf":[{"enum":["360p","480p","720p","768p","1080p","4k"],"type":"string"},{"type":"null"}],"description":"Video output resolution (null = the model's default; only some models offer a choice, and higher costs more)"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0},"startFrameAssetId":{"type":["string","null"]},"referenceVideoMode":{"enum":["follow","edit"],"type":"string","description":"follow (default): make a new clip copying the reference's motion and camera. edit: change the first reference clip itself and keep the rest — write the change in the description (e.g. \"Replace the man with Whiskers\") and add the new subject to the cast. Needs a model whose videoReferences.modes includes edit (kling-o3-pro-edit, kling-o3-standard-edit, seedance-2.5-ref); the take is as long as the clip."},"speakerCharacterId":{"type":["string","null"],"description":"Who speaks the dialogue (null = the character it names, else the first cast member with a voice)"},"referenceVideoAssetIds":{"type":"array","items":{"type":"string"},"maxItems":3,"description":"Video assets (uploads or earlier takes) whose motion and camera the shot follows; replaces the list ([] clears it). Only reference_to_video models use them — generation.list_models shows each model's videoReferences limits and modes."}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"shot.update\" → \"shot_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":1335,"tokensAfter":1335},{"name":"storyline.apply","fixed":{"name":"storyline_apply","description":"Turn the accepted storyline path into real scenes, placeholders, prompts and timeline items in one undoable step (stages it as a scenario and applies it), then clears the draft path. With draftShots (default true) each scene is first broken into a shot list like shot.draft (metered in credits unless the owner uses their own Anthropic key), so the scenes arrive with shots and one placeholder per shot.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion"],"properties":{"projectId":{"type":"string"},"draftShots":{"type":"boolean"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"storyline.apply\" → \"storyline_apply\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":199,"tokensAfter":199},{"name":"storyline.get","fixed":{"name":"storyline_get","description":"Fetch the Scenario Maker draft storyline for a project: the premise (and how many reference images it has), the scenes the user has accepted so far (path), and the current batch of suggested next scenes (candidates).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"storyline.get\" → \"storyline_get\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":123,"tokensAfter":123},{"name":"storyline.pick","fixed":{"name":"storyline_pick","description":"Accept one of the current candidates as the next scene in the storyline, optionally with edits. Clears the candidates — suggest new ones afterwards.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","candidateId"],"properties":{"edits":{"type":"object","properties":{"title":{"type":"string","minLength":1},"summary":{"type":"string"},"soundPrompt":{"type":"string"},"videoPrompt":{"type":"string"},"voicePrompt":{"type":"string"},"narrativePurpose":{"type":"string"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"projectId":{"type":"string"},"candidateId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"storyline.pick\" → \"storyline_pick\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":209,"tokensAfter":209},{"name":"storyline.rewind","fixed":{"name":"storyline_rewind","description":"Rewind the storyline: keep only the first `keep` accepted scenes (0 clears the path) and discard the rest and the current candidates, so a different choice can be made at that point.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","keep"],"properties":{"keep":{"type":"integer","minimum":0},"projectId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"storyline.rewind\" → \"storyline_rewind\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":127,"tokensAfter":127},{"name":"storyline.set_candidates","fixed":{"name":"storyline_set_candidates","description":"Replace the current batch of suggested next scenes with distinct options you propose, so the user can pick one. Each option should follow from the premise and every scene already in the path.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","candidates"],"properties":{"projectId":{"type":"string"},"candidates":{"type":"array","items":{"type":"object","required":["title","plannedDurationMs"],"properties":{"title":{"type":"string","minLength":1},"summary":{"type":"string"},"soundPrompt":{"type":"string"},"videoPrompt":{"type":"string"},"voicePrompt":{"type":"string"},"narrativePurpose":{"type":"string"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"minItems":1}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"storyline.set_candidates\" → \"storyline_set_candidates\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":238,"tokensAfter":238},{"name":"storyline.set_premise","fixed":{"name":"storyline_set_premise","description":"Set the Scenario Maker premise (initial scene or short scenario), optionally with up to 3 reference images (base64) that define the look and setting. Resets the accepted path and candidates. Needs a premise or at least one image.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"images":{"type":"array","items":{"type":"object","required":["mediaType","data"],"properties":{"data":{"type":"string","minLength":1},"mediaType":{"enum":["image/jpeg","image/png","image/webp","image/gif"],"type":"string"}},"additionalProperties":false},"maxItems":3},"premise":{"type":"string"},"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"storyline.set_premise\" → \"storyline_set_premise\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":211,"tokensAfter":211},{"name":"storyline.suggest","fixed":{"name":"storyline_suggest","description":"Suggest next scenes for the project's storyline from its premise (metered in credits unless the owner uses their own Anthropic key). Requires storyline.set_premise first. The suggestions become candidates; choose one with storyline.pick.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId"],"properties":{"count":{"type":"integer","maximum":6,"minimum":2},"guidance":{"type":"string","maxLength":1000,"minLength":1},"projectId":{"type":"string"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"storyline.suggest\" → \"storyline_suggest\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":160,"tokensAfter":160},{"name":"storyline.update_scene","fixed":{"name":"storyline_update_scene","description":"Edit a scene already accepted into the storyline path","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","sceneId","edits"],"properties":{"edits":{"type":"object","properties":{"title":{"type":"string","minLength":1},"summary":{"type":"string"},"soundPrompt":{"type":"string"},"videoPrompt":{"type":"string"},"voicePrompt":{"type":"string"},"narrativePurpose":{"type":"string"},"plannedDurationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},"sceneId":{"type":"string"},"projectId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"storyline.update_scene\" → \"storyline_update_scene\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":185,"tokensAfter":185},{"name":"timeline.add_placeholder","fixed":{"name":"timeline_add_placeholder","description":"Add a video/audio placeholder clip to a track, ready for a generation prompt (§7.5, §11.5)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","trackId","kind","title","startMs","durationMs"],"properties":{"kind":{"enum":["video","image","music","sound_effect","ambience","voice"],"type":"string"},"title":{"type":"string","minLength":1},"sceneId":{"type":"string"},"startMs":{"type":"integer","minimum":0},"trackId":{"type":"string"},"projectId":{"type":"string"},"durationMs":{"type":"integer","exclusiveMinimum":0},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.add_placeholder\" → \"timeline_add_placeholder\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":198,"tokensAfter":198},{"name":"timeline.add_transition","fixed":{"name":"timeline_add_transition","description":"Add a transition (§4.1: crossfade, smooth_blend, fade_from_black, or fade_to_black — a hard cut needs no call at all, it's just the default). crossfade and smooth_blend require fromItemId and toItemId to be two contiguous, back-to-back clips on the same track, and shift toItemId durationMs earlier so the overlap uses only content the clips already have (no source 'handle' footage needed) — this shortens the sequence by durationMs, exactly like a real NLE. smooth_blend is the least noticeable joi","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","trackId","kind","durationMs","fromItemId"],"properties":{"kind":{"enum":["crossfade","smooth_blend","fade_from_black","fade_to_black"],"type":"string"},"trackId":{"type":"string"},"toItemId":{"type":"string"},"projectId":{"type":"string"},"durationMs":{"type":"integer","exclusiveMinimum":0},"fromItemId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.add_transition\" → \"timeline_add_transition\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":297,"tokensAfter":297},{"name":"timeline.add_transitions","fixed":{"name":"timeline_add_transitions","description":"Add the SAME transition to several clips in ONE call (and one undo step) — prefer this over repeated timeline.add_transition when joining a run of clips. Select the clips with exactly one of itemIds, trackId (every clip on a track) or all:true (every clip on every track; trackType limits to video/audio) — to crossfade the whole film use all:true with trackType 'video', do NOT list ids or make one call per join. kind crossfade/smooth_blend: adds one between every pair of the selected clips that a","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","kind","durationMs"],"properties":{"all":{"type":"boolean","description":"Every clip on every track — narrow with trackType"},"kind":{"enum":["crossfade","smooth_blend","fade_from_black","fade_to_black"],"type":"string"},"itemIds":{"type":"array","items":{"type":"string"},"minItems":1,"description":"These specific clips"},"trackId":{"type":"string","description":"Every clip on this track"},"projectId":{"type":"string"},"trackType":{"enum":["video","audio"],"type":"string","description":"With all: only tracks of this type"},"durationMs":{"type":"integer","exclusiveMinimum":0},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.add_transitions\" → \"timeline_add_transitions\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":369,"tokensAfter":369},{"name":"timeline.batch","fixed":{"name":"timeline_batch","description":"Apply SEVERAL timeline edits in ONE call — one version check, one result, one undo step, all-or-nothing (if any op fails nothing is applied and the error names the failing op). ALWAYS prefer this over repeated single-edit calls whenever you have two or more timeline edits to make (e.g. trimming five clips, setting speed on several, crossfading a run then closing gaps): it costs one round-trip instead of one per edit. Ops run in order against the live state, so a later op sees the result of an ea","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","ops"],"properties":{"ops":{"type":"array","items":{"anyOf":[{"type":"object","required":["op","itemId","startMs"],"properties":{"op":{"type":"string","const":"move_item"},"itemId":{"type":"string"},"startMs":{"type":"integer","minimum":0},"trackId":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["op","itemId"],"properties":{"op":{"type":"string","const":"trim_item"},"itemId":{"type":"string"},"startMs":{"type":"integer","minimum":0},"durationMs":{"type":"integer","exclusiveMinimum":0},"sourceInMs":{"type":"integer","minimum":0},"sourceOutMs":{"type":"integer","minimum":0}},"additionalProperties":false},{"type":"object","required":["op","itemId","speed"],"properties":{"op":{"type":"string","const":"set_speed"},"speed":{"type":"number","maximum":1.8,"minimum":0.2},"itemId":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["op","itemId","volume"],"properties":{"op":{"type":"string","const":"set_volume"},"itemId":{"type":"string"},"volume":{"type":"number","maximum":1,"minimum":0}},"additionalProperties":false},{"type":"object","required":["op","itemId"],"properties":{"x":{"type":"number","maximum":1.5,"minimum":-0.5,"description":"Clip center, fraction of frame width: 0 left edge, 0.5 centered, 1 right edge"},"y":{"type":"number","maximum":1.5,"minimum":-0.5,"description":"Clip center, fraction of frame height: 0 top, 0.5 centered, 1 bottom"},"op":{"type":"string","const":"set_transform"},"scale":{"type":"number","maximum":2,"minimum":0.05,"description":"Size relative to filling the frame: 1 full frame, 0.2 a small logo"},"itemId":{"type":"string"},"opacity":{"type":"number","maximum":1,"minimum":0,"description":"0 invisible, 1 opaque"}},"additionalProperties":false},{"type":"object","required":["op","itemId"],"properties":{"op":{"type":"string","const":"close_gap"},"itemId":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["op"],"properties":{"op":{"type":"string","const":"close_gaps"},"all":{"type":"boolean","description":"Every clip on every track — narrow with trackType"},"itemIds":{"type":"array","items":{"type":"string"},"minItems":1,"description":"These specific clips"},"trackId":{"type":"string","description":"Every clip on this track"},"trackType":{"enum":["video","audio"],"type":"string","description":"With all: only tracks of this type"}},"additionalProperties":false},{"type":"object","required":["op","trackId","kind","durationMs","fromItemId"],"properties":{"op":{"type":"string","const":"add_transition"},"kind":{"enum":["crossfade","smooth_blend","fade_from_black","fade_to_black"],"type":"string"},"trackId":{"type":"string"},"toItemId":{"type":"string"},"durationMs":{"type":"integer","exclusiveMinimum":0},"fromItemId":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["op","kind","durationMs"],"properties":{"op":{"type":"string","const":"add_transitions"},"all":{"$ref":"#/properties/ops/items/anyOf/6/properties/all"},"kind":{"enum":["crossfade","smooth_blend","fade_from_black","fade_to_black"],"type":"string"},"itemIds":{"$ref":"#/properties/ops/items/anyOf/6/properties/itemIds"},"trackId":{"$ref":"#/properties/ops/items/anyOf/6/properties/trackId"},"trackType":{"$ref":"#/properties/ops/items/anyOf/6/properties/trackType"},"durationMs":{"type":"integer","exclusiveMinimum":0}},"additionalProperties":false},{"type":"object","required":["op","transitionItemId"],"properties":{"op":{"type":"string","const":"remove_transition"},"transitionItemId":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["op"],"properties":{"op":{"type":"string","const":"remove_transitions"},"all":{"$ref":"#/properties/ops/items/anyOf/6/properties/all"},"itemIds":{"$ref":"#/properties/ops/items/anyOf/6/properties/itemIds"},"trackId":{"$ref":"#/properties/ops/items/anyOf/6/properties/trackId"},"trackType":{"$ref":"#/properties/ops/items/anyOf/6/properties/trackType"}},"additionalProperties":false},{"type":"object","required":["op","transitionItemId","durationMs"],"properties":{"op":{"type":"string","const":"update_transition_duration"},"durationMs":{"type":"integer","exclusiveMinimum":0},"transitionItemId":{"type":"string"}},"additionalProperties":false}]},"maxItems":50,"minItems":1},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.batch\" → \"timeline_batch\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":1402,"tokensAfter":1402},{"name":"timeline.close_gap","fixed":{"name":"timeline_close_gap","description":"Ripple a timeline item (and everything after it on the same track) earlier to eat the empty space immediately before it. Fails if there is no gap before the item.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId"],"properties":{"itemId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.close_gap\" → \"timeline_close_gap\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":134,"tokensAfter":134},{"name":"timeline.close_gaps","fixed":{"name":"timeline_close_gaps","description":"Close the empty gaps between SEVERAL clips at once (a ripple: each clip after the first is pulled left against its predecessor, and everything later on the track moves with it, so clips after the span keep their spacing). Select the clips with exactly one of itemIds (every gap inside the span from the earliest to the latest of them is closed), trackId (every clip on one track) or all:true (every clip on every track; add trackType to limit to video or audio) — for 'the whole timeline' use all:tru","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion"],"properties":{"all":{"type":"boolean","description":"Every clip on every track — narrow with trackType"},"itemIds":{"type":"array","items":{"type":"string"},"minItems":1,"description":"These specific clips"},"trackId":{"type":"string","description":"Every clip on this track"},"projectId":{"type":"string"},"trackType":{"enum":["video","audio"],"type":"string","description":"With all: only tracks of this type"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.close_gaps\" → \"timeline_close_gaps\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":321,"tokensAfter":321},{"name":"timeline.delete_item","fixed":{"name":"timeline_delete_item","description":"Delete a timeline item (and its placeholder, if any)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId"],"properties":{"itemId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.delete_item\" → \"timeline_delete_item\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":104,"tokensAfter":104},{"name":"timeline.duplicate_item","fixed":{"name":"timeline_duplicate_item","description":"Duplicate a timeline clip (media or placeholder, not a transition), by default onto the same track immediately after itself, pushing whatever else is later on that track to the right to make room (only fails if the target spot would land inside another clip that starts before it). Pass trackId to duplicate onto a different track of the same type, and/or startMs to place it elsewhere. A duplicated placeholder gets its own independent copy of its prompt (if any).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId"],"properties":{"itemId":{"type":"string"},"startMs":{"type":"integer","minimum":0},"trackId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.duplicate_item\" → \"timeline_duplicate_item\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":239,"tokensAfter":239},{"name":"timeline.move_item","fixed":{"name":"timeline_move_item","description":"Move a timeline item to a new start time, and optionally to a different track (must be the same track type — video to video, audio to audio — and the item must not be a transition or have one attached)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId","startMs"],"properties":{"itemId":{"type":"string"},"startMs":{"type":"integer","minimum":0},"trackId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.move_item\" → \"timeline_move_item\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":167,"tokensAfter":167},{"name":"timeline.remove_transition","fixed":{"name":"timeline_remove_transition","description":"Remove a transition. For a crossfade or smooth_blend this also shifts the incoming clip back to its pre-transition position.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","transitionItemId"],"properties":{"projectId":{"type":"string"},"expectedVersion":{"type":"integer"},"transitionItemId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.remove_transition\" → \"timeline_remove_transition\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":132,"tokensAfter":132},{"name":"timeline.remove_transitions","fixed":{"name":"timeline_remove_transitions","description":"Remove transitions from several clips in ONE call (and one undo step): every transition whose clip(s) are all selected (itemIds, trackId or all:true, like timeline.add_transitions) — a crossfade/smooth_blend needs both its clips selected, a fade just its own clip. Crossfaded clips are shifted back to their pre-transition positions. Fails if there is nothing to remove.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion"],"properties":{"all":{"type":"boolean","description":"Every clip on every track — narrow with trackType"},"itemIds":{"type":"array","items":{"type":"string"},"minItems":1,"description":"These specific clips"},"trackId":{"type":"string","description":"Every clip on this track"},"projectId":{"type":"string"},"trackType":{"enum":["video","audio"],"type":"string","description":"With all: only tracks of this type"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.remove_transitions\" → \"timeline_remove_transitions\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":287,"tokensAfter":287},{"name":"timeline.set_speed","fixed":{"name":"timeline_set_speed","description":"Change a clip's playback speed (0.2 = 5x slower, 1 = normal, 1.8 = 1.8x faster). Recomputes the clip's timeline duration for the new speed and ripples everything later on the same track to stay contiguous — the source range consumed is unchanged, only how long it takes to play.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId","speed"],"properties":{"speed":{"type":"number","maximum":1.8,"minimum":0.2},"itemId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.set_speed\" → \"timeline_set_speed\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":184,"tokensAfter":184},{"name":"timeline.set_transform","fixed":{"name":"timeline_set_transform","description":"Place a clip on a video track as a layer: its position, size and opacity in the frame. Video tracks stack by order (higher order is drawn on top), and anything outside a scaled-down or transparent clip shows the tracks beneath — so a logo, watermark or picture-in-picture is an image/GIF/video placeholder on a track ABOVE the footage, with e.g. scale 0.15 and x 0.9, y 0.1 for the top-right corner. Images and GIFs loop to fill their clip's whole duration; GIF/PNG transparency is kept. Only the fie","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId"],"properties":{"x":{"type":"number","maximum":1.5,"minimum":-0.5,"description":"Clip center, fraction of frame width: 0 left edge, 0.5 centered, 1 right edge"},"y":{"type":"number","maximum":1.5,"minimum":-0.5,"description":"Clip center, fraction of frame height: 0 top, 0.5 centered, 1 bottom"},"scale":{"type":"number","maximum":2,"minimum":0.05,"description":"Size relative to filling the frame: 1 full frame, 0.2 a small logo"},"itemId":{"type":"string"},"opacity":{"type":"number","maximum":1,"minimum":0,"description":"0 invisible, 1 opaque"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.set_transform\" → \"timeline_set_transform\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":370,"tokensAfter":370},{"name":"timeline.set_volume","fixed":{"name":"timeline_set_volume","description":"Set a clip's own audio gain (0 = silent, 1 = full). Multiplies with its track's volume — both apply together — so a clip can be ducked or muted independent of the rest of its track.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId","volume"],"properties":{"itemId":{"type":"string"},"volume":{"type":"number","maximum":1,"minimum":0},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.set_volume\" → \"timeline_set_volume\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":157,"tokensAfter":157},{"name":"timeline.split_item","fixed":{"name":"timeline_split_item","description":"Split a timeline item into two at an absolute timeline position","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId","atMs"],"properties":{"atMs":{"type":"integer","minimum":0},"itemId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.split_item\" → \"timeline_split_item\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":120,"tokensAfter":120},{"name":"timeline.trim_item","fixed":{"name":"timeline_trim_item","description":"Trim a timeline item's start, duration, or source in/out points","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","itemId"],"properties":{"itemId":{"type":"string"},"startMs":{"type":"integer","minimum":0},"projectId":{"type":"string"},"durationMs":{"type":"integer","exclusiveMinimum":0},"sourceInMs":{"type":"integer","minimum":0},"sourceOutMs":{"type":"integer","minimum":0},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"timeline.trim_item\" → \"timeline_trim_item\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":158,"tokensAfter":158},{"name":"timeline.update_transition_duration","fixed":{"name":"timeline_update_transition_duration","description":"Change how long an existing fade, crossfade or smooth_blend lasts, in ms. For a crossfade or smooth_blend this re-shifts the incoming clip to keep it anchored to the outgoing clip's end.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","transitionItemId","durationMs"],"properties":{"projectId":{"type":"string"},"durationMs":{"type":"integer","exclusiveMinimum":0},"expectedVersion":{"type":"integer"},"transitionItemId":{"type":"string"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"timeline.update_transition_duration\" → \"timeline_update_transition_duration\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":170,"tokensAfter":170},{"name":"track.create","fixed":{"name":"track_create","description":"Create a video or audio track on a project (§11.4)","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","type","name"],"properties":{"name":{"type":"string","minLength":1},"type":{"enum":["video","audio"],"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"name","detail":"Renamed \"track.create\" → \"track_create\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":120,"tokensAfter":120},{"name":"track.delete","fixed":{"name":"track_delete","description":"Delete a track","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","trackId"],"properties":{"trackId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"track.delete\" → \"track_delete\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":92,"tokensAfter":92},{"name":"track.reorder","fixed":{"name":"track_reorder","description":"Move a track to a new position among the project's tracks — video and audio tracks share one ordering, so a track can move in between tracks of either type","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","trackId","newOrder"],"properties":{"trackId":{"type":"string"},"newOrder":{"type":"integer","minimum":0},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"track.reorder\" → \"track_reorder\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":146,"tokensAfter":146},{"name":"track.update","fixed":{"name":"track_update","description":"Rename, mute, lock, or set the volume (0-1) of a track","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","expectedVersion","trackId"],"properties":{"name":{"type":"string","minLength":1},"muted":{"type":"boolean"},"locked":{"type":"boolean"},"volume":{"type":"number","maximum":1,"minimum":0},"trackId":{"type":"string"},"projectId":{"type":"string"},"expectedVersion":{"type":"integer"}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"name","detail":"Renamed \"track.update\" → \"track_update\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":144,"tokensAfter":144},{"name":"voice.compile","fixed":{"name":"voice_compile","description":"Preview what voice.generate would speak for a voice placeholder — text, voice, model and cost. Free.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","placeholderId"],"properties":{"text":{"type":"string","description":"The words to speak. Defaults to the clip's prompt, then the scene's voice prompt"},"model":{"type":"string","description":"eleven-multilingual-v2 (default), eleven-v3 (most expressive) or eleven-flash-v2.5 (cheapest)"},"voiceId":{"type":"string","description":"ElevenLabs voice (voice.list). Defaults to characterId's voice, then a narrator voice"},"projectId":{"type":"string"},"characterId":{"type":"string","description":"Speak in this character's voice"},"placeholderId":{"type":"string","description":"A voice placeholder on an audio track (timeline.add_placeholder with kind voice)"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"voice.compile\" → \"voice_compile\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":261,"tokensAfter":261},{"name":"voice.generate","fixed":{"name":"voice_generate","description":"Speak a line with ElevenLabs for a voice placeholder (narration, off-screen dialogue — no lip-sync). Costs credits per character, charged to the project owner. Runs in the background — poll generation.list with placeholderId. The finished audio fills the clip (undoable).","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["projectId","placeholderId"],"properties":{"text":{"type":"string","description":"The words to speak. Defaults to the clip's prompt, then the scene's voice prompt"},"model":{"type":"string","description":"eleven-multilingual-v2 (default), eleven-v3 (most expressive) or eleven-flash-v2.5 (cheapest)"},"voiceId":{"type":"string","description":"ElevenLabs voice (voice.list). Defaults to characterId's voice, then a narrator voice"},"projectId":{"type":"string"},"characterId":{"type":"string","description":"Speak in this character's voice"},"placeholderId":{"type":"string","description":"A voice placeholder on an audio track (timeline.add_placeholder with kind voice)"}},"additionalProperties":false}},"changes":[{"kind":"name","detail":"Renamed \"voice.generate\" → \"voice_generate\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true}],"tokensBefore":309,"tokensAfter":309},{"name":"voice.list","fixed":{"name":"voice_list","description":"List the ElevenLabs voices characters and voice clips can speak with (id, name, labels like gender/accent, a preview URL). Free.","inputSchema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"name","detail":"Renamed \"voice.list\" → \"voice_list\" (letters, digits, _ and - only; max 64). Keep the old name as an alias for a release if clients already call it.","verify":true},{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":74,"tokensAfter":74}],"toolsChanged":111,"tokensSaved":0,"todo":[{"tool":"asset_capture_frame","params":["timeMs","assetId","projectId"]},{"tool":"asset_get","params":["assetId"]},{"tool":"asset_list","params":["projectId"]},{"tool":"asset_replace_placeholder","params":["assetId","projectId","placeholderId","expectedVersion"]},{"tool":"asset_upload","params":["filename","mimeType","projectId","contentBase64"]},{"tool":"character_add_reference","params":["view","label","assetId","projectId","characterId","makePrimary","expectedVersion"]},{"tool":"character_create","params":["name","role","notes","wardrobe","projectId","description","expectedVersion"]},{"tool":"character_delete","params":["projectId","characterId","expectedVersion"]},{"tool":"character_generate_sheet","params":["views","projectId","imageModel","characterId"]},{"tool":"character_generate_view","params":["view","label","projectId","imageModel","characterId"]},{"tool":"character_get","params":["characterId"]},{"tool":"character_list","params":["projectId"]},{"tool":"character_remove_reference","params":["projectId","referenceId","expectedVersion"]},{"tool":"character_set_primary","params":["projectId","characterId","referenceId","expectedVersion"]},{"tool":"character_update","params":["name","role","notes","wardrobe","projectId","characterId","description","expectedVersion"]},{"tool":"credits_get_balance","params":["projectId"]},{"tool":"credits_list_history","params":["limit","cursor","category","projectId"]},{"tool":"film_get_look","params":["projectId"]},{"tool":"film_update_look","params":["replace","projectId","expectedVersion"]},{"tool":"generation_cancel","params":["generationJobId"]},{"tool":"generation_list","params":["shotId","projectId","locationId","characterId","placeholderId"]},{"tool":"generation_status","params":["generationJobId"]},{"tool":"location_add_reference","params":["view","label","assetId","projectId","locationId","expectedVersion"]},{"tool":"location_create","params":["name","notes","projectId","expectedVersion"]},{"tool":"location_delete","params":["projectId","locationId","expectedVersion"]},{"tool":"location_generate_plates","params":["views","projectId","imageModel","locationId"]},{"tool":"location_get","params":["locationId"]},{"tool":"location_list","params":["projectId"]},{"tool":"location_remove_reference","params":["projectId","expectedVersion","locationReferenceId"]},{"tool":"location_update","params":["name","notes","projectId","locationId","expectedVersion"]},{"tool":"music_compile_prompt","params":["projectId","instrumental"]},{"tool":"music_generate","params":["projectId","instrumental"]},{"tool":"project_create","params":["fps","name","width","height"]},{"tool":"project_delete","params":["projectId"]},{"tool":"project_export","params":["projectId"]},{"tool":"project_get_state","params":["projectId"]},{"tool":"project_get_summary","params":["projectId"]},{"tool":"project_import","params":["data","name"]},{"tool":"project_undo","params":["projectId"]},{"tool":"project_update","params":["name","projectId","description","expectedVersion"]},{"tool":"prompt_attach","params":["text","type","style","camera","intent","motion","target","lighting","createdBy","projectId","aspectRatio","durationSec","environment","soundDesign","providerHints","negativePrompt","expectedVersion"]},{"tool":"prompt_draft","params":["guidance","assetType","projectId","sceneTitle","currentText","sceneSummary"]},{"tool":"prompt_get","params":["promptId"]},{"tool":"prompt_list_for_scene","params":["sceneId"]},{"tool":"prompt_list_revisions","params":["promptId"]},{"tool":"prompt_update","params":["patch","promptId","projectId","expectedVersion"]},{"tool":"render_delete","params":["jobId"]},{"tool":"render_final","params":["projectId","resolution"]},{"tool":"render_get_result","params":["jobId"]},{"tool":"render_list_for_project","params":["projectId"]},{"tool":"render_preview","params":["projectId"]},{"tool":"render_status","params":["jobId"]},{"tool":"scenario_apply_to_timeline","params":["options","projectId","scenarioId","expectedVersion"]},{"tool":"scenario_create","params":["scenes","concept","projectId","treatment","expectedVersion"]},{"tool":"scenario_delete","params":["projectId","scenarioId","expectedVersion"]},{"tool":"scenario_get","params":["scenarioId"]},{"tool":"scenario_update","params":["scenes","concept","projectId","treatment","scenarioId","expectedVersion"]},{"tool":"scene_create","params":["title","summary","projectId","expectedVersion","narrativePurpose","plannedDurationMs"]},{"tool":"scene_delete","params":["sceneId","projectId","expectedVersion"]},{"tool":"scene_reorder","params":["sceneId","newOrder","projectId","expectedVersion"]},{"tool":"scene_update","params":["title","sceneId","summary","projectId","expectedVersion","narrativePurpose","plannedDurationMs"]},{"tool":"shot_add_still","params":["shotId","assetId","projectId","asStartFrame","expectedVersion"]},{"tool":"shot_compile_prompt","params":["model","shotId","target"]},{"tool":"shot_create","params":["seed","sceneId","lighting","shotSize","projectId","videoModel","cameraAngle","cameraMovement","expectedVersion","plannedDurationMs"]},{"tool":"shot_delete","params":["shotId","projectId","expectedVersion"]},{"tool":"shot_draft","params":["count","sceneId","guidance","projectId"]},{"tool":"shot_generate_keyframe","params":["model","shotId","numImages","projectId"]},{"tool":"shot_generate_video","params":["model","shotId","projectId"]},{"tool":"shot_get","params":["shotId"]},{"tool":"shot_lipsync","params":["shotId","projectId"]},{"tool":"shot_list","params":["sceneId","projectId"]},{"tool":"shot_remove_keyframe","params":["shotId","assetId","projectId","expectedVersion"]},{"tool":"shot_reorder","params":["shotId","newOrder","projectId","expectedVersion"]},{"tool":"shot_revoice","params":["shotId","projectId"]},{"tool":"shot_select_keyframe","params":["which","shotId","assetId","projectId","expectedVersion"]},{"tool":"shot_select_take","params":["shotId","assetId","projectId","expectedVersion"]},{"tool":"shot_update","params":["seed","shotId","lighting","shotSize","projectId","videoModel","cameraAngle","cameraMovement","endFrameAssetId","expectedVersion","plannedDurationMs","startFrameAssetId"]},{"tool":"storyline_apply","params":["projectId","draftShots","expectedVersion"]},{"tool":"storyline_get","params":["projectId"]},{"tool":"storyline_pick","params":["edits","projectId","candidateId"]},{"tool":"storyline_rewind","params":["keep","projectId"]},{"tool":"storyline_set_candidates","params":["projectId","candidates"]},{"tool":"storyline_set_premise","params":["images","premise","projectId"]},{"tool":"storyline_suggest","params":["count","guidance","projectId"]},{"tool":"storyline_update_scene","params":["edits","sceneId","projectId"]},{"tool":"timeline_add_placeholder","params":["kind","title","sceneId","startMs","trackId","projectId","durationMs","expectedVersion"]},{"tool":"timeline_add_transition","params":["kind","trackId","toItemId","projectId","durationMs","fromItemId","expectedVersion"]},{"tool":"timeline_add_transitions","params":["kind","projectId","durationMs","expectedVersion"]},{"tool":"timeline_batch","params":["ops","projectId","expectedVersion"]},{"tool":"timeline_close_gap","params":["itemId","projectId","expectedVersion"]},{"tool":"timeline_close_gaps","params":["projectId","expectedVersion"]},{"tool":"timeline_delete_item","params":["itemId","projectId","expectedVersion"]},{"tool":"timeline_duplicate_item","params":["itemId","startMs","trackId","projectId","expectedVersion"]},{"tool":"timeline_move_item","params":["itemId","startMs","trackId","projectId","expectedVersion"]},{"tool":"timeline_remove_transition","params":["projectId","expectedVersion","transitionItemId"]},{"tool":"timeline_remove_transitions","params":["projectId","expectedVersion"]},{"tool":"timeline_set_speed","params":["speed","itemId","projectId","expectedVersion"]},{"tool":"timeline_set_transform","params":["itemId","projectId","expectedVersion"]},{"tool":"timeline_set_volume","params":["itemId","volume","projectId","expectedVersion"]},{"tool":"timeline_split_item","params":["atMs","itemId","projectId","expectedVersion"]},{"tool":"timeline_trim_item","params":["itemId","startMs","projectId","durationMs","sourceInMs","sourceOutMs","expectedVersion"]},{"tool":"timeline_update_transition_duration","params":["projectId","durationMs","expectedVersion","transitionItemId"]},{"tool":"track_create","params":["name","type","projectId","expectedVersion"]},{"tool":"track_delete","params":["trackId","projectId","expectedVersion"]},{"tool":"track_reorder","params":["trackId","newOrder","projectId","expectedVersion"]},{"tool":"track_update","params":["name","muted","locked","volume","trackId","projectId","expectedVersion"]},{"tool":"voice_compile","params":["projectId"]},{"tool":"voice_generate","params":["projectId"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}