{"schemaVersion":"2","ok":true,"data":{"schemaVersion":"2","edition":"public","distribution":"global","locale":"en-US","command":"dreamina-canvas","globalFlags":[{"name":"format","type":"string","required":false,"default":"auto","description":"Output format: json or table","constraints":"json|table"},{"name":"non-interactive","type":"boolean","required":false,"default":"false","description":"Disable interactive prompts"},{"name":"yes","type":"boolean","required":false,"default":"false","description":"Approve permitted operations without an interactive prompt"},{"name":"profile","type":"string","required":false,"default":"default","description":"Local sign-in state profile"}],"subcommands":[{"name":"model","summary":"Query generation models and their callable specifications","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"arguments":[{"name":"name","required":false,"repeatable":true,"constraints":"model id/name; required for full spec lookup"}],"flags":[{"name":"type","type":"string","required":false,"description":"Resource type: image, video, or audio; omit to search all generation types","constraints":"image|video|audio"}],"successData":{"type":"object","fields":[{"name":"query","type":"string"},{"name":"matchKind","type":"string"},{"name":"matches","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"resourceType","type":"string"},{"name":"generation","type":"object","optional":true,"fields":[{"name":"generationKind","type":"string","optional":true},{"name":"draftPromotion","type":"object","optional":true,"fields":[{"name":"params","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"dataType","type":"string","optional":true},{"name":"presence","type":"string"},{"name":"rule","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"stringValues","type":"array<string>","optional":true},{"name":"integerValues","type":"array<integer>","optional":true},{"name":"numberValues","type":"array<number>","optional":true},{"name":"booleanValues","type":"array<boolean>","optional":true},{"name":"min","type":"number","optional":true},{"name":"max","type":"number","optional":true},{"name":"step","type":"number","optional":true},{"name":"minLength","type":"integer","optional":true},{"name":"maxLength","type":"integer","optional":true},{"name":"format","type":"string","optional":true},{"name":"minItems","type":"integer","optional":true},{"name":"maxItems","type":"integer","optional":true},{"name":"unique","type":"boolean","optional":true},{"name":"items","type":"object","optional":true,"fields":[{"name":"dataType","type":"string"},{"name":"rule","type":"object","optional":true}]},{"name":"properties","type":"array<object>","optional":true,"fields":[{"name":"name","type":"string"},{"name":"dataType","type":"string","optional":true},{"name":"presence","type":"string"},{"name":"rule","type":"object","optional":true}]},{"name":"additionalProperties","type":"boolean","optional":true}]}]}]},{"name":"model","type":"string"},{"name":"scenario","type":"string","optional":true},{"name":"mode","type":"string"},{"name":"aliases","type":"array<string>","optional":true},{"name":"params","type":"array<object>","optional":true,"fields":[{"name":"name","type":"string"},{"name":"dataType","type":"string","optional":true},{"name":"presence","type":"string"},{"name":"rule","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"stringValues","type":"array<string>","optional":true},{"name":"integerValues","type":"array<integer>","optional":true},{"name":"numberValues","type":"array<number>","optional":true},{"name":"booleanValues","type":"array<boolean>","optional":true},{"name":"min","type":"number","optional":true},{"name":"max","type":"number","optional":true},{"name":"step","type":"number","optional":true},{"name":"minLength","type":"integer","optional":true},{"name":"maxLength","type":"integer","optional":true},{"name":"format","type":"string","optional":true},{"name":"minItems","type":"integer","optional":true},{"name":"maxItems","type":"integer","optional":true},{"name":"unique","type":"boolean","optional":true},{"name":"items","type":"object","optional":true,"fields":[{"name":"dataType","type":"string"},{"name":"rule","type":"object","optional":true}]},{"name":"properties","type":"array<object>","optional":true,"fields":[{"name":"name","type":"string"},{"name":"dataType","type":"string","optional":true},{"name":"presence","type":"string"},{"name":"rule","type":"object","optional":true}]},{"name":"additionalProperties","type":"boolean","optional":true}]}]},{"name":"materials","type":"object","optional":true,"fields":[{"name":"totalCount","type":"object","fields":[{"name":"min","type":"integer"},{"name":"max","type":"integer"}]},{"name":"types","type":"array<object>","fields":[{"name":"mediaType","type":"string"},{"name":"count","type":"object","fields":[{"name":"min","type":"integer"},{"name":"max","type":"integer"}]},{"name":"limits","type":"object","optional":true,"fields":[{"name":"minDurationMs","type":"integer","optional":true},{"name":"maxDurationMs","type":"integer","optional":true},{"name":"maxFileSizeBytes","type":"integer","optional":true},{"name":"minWidthPx","type":"integer","optional":true},{"name":"maxWidthPx","type":"integer","optional":true},{"name":"minHeightPx","type":"integer","optional":true},{"name":"maxHeightPx","type":"integer","optional":true}]}]},{"name":"referenceRules","type":"object","optional":true,"fields":[{"name":"requireAnyOfTypes","type":"array<string>","optional":true},{"name":"mutuallyExclusiveTypes","type":"array<string>","optional":true}]},{"name":"maxTotalVideoDurationMs","type":"integer","optional":true},{"name":"maxTotalAudioDurationMs","type":"integer","optional":true}]},{"name":"maxBatchGenCount","type":"integer","optional":true},{"name":"outputsPerTask","type":"integer","optional":true},{"name":"voiceNames","type":"array<string>","optional":true},{"name":"displayName","type":"string","optional":true},{"name":"isVip","type":"boolean","optional":true},{"name":"vipConfigs","type":"array<object>","optional":true,"fields":[{"name":"resolution","type":"string"},{"name":"isVip","type":"boolean"}]}]},{"name":"postEdit","type":"object","optional":true,"fields":[{"name":"feature","type":"string"},{"name":"title","type":"string"},{"name":"description","type":"string","optional":true},{"name":"params","type":"array<object>","optional":true,"fields":[{"name":"name","type":"string"},{"name":"dataType","type":"string","optional":true},{"name":"presence","type":"string"},{"name":"rule","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"stringValues","type":"array<string>","optional":true},{"name":"integerValues","type":"array<integer>","optional":true},{"name":"numberValues","type":"array<number>","optional":true},{"name":"booleanValues","type":"array<boolean>","optional":true},{"name":"min","type":"number","optional":true},{"name":"max","type":"number","optional":true},{"name":"step","type":"number","optional":true},{"name":"minLength","type":"integer","optional":true},{"name":"maxLength","type":"integer","optional":true},{"name":"format","type":"string","optional":true},{"name":"minItems","type":"integer","optional":true},{"name":"maxItems","type":"integer","optional":true},{"name":"unique","type":"boolean","optional":true},{"name":"items","type":"object","optional":true,"fields":[{"name":"dataType","type":"string"},{"name":"rule","type":"object","optional":true}]},{"name":"properties","type":"array<object>","optional":true,"fields":[{"name":"name","type":"string"},{"name":"dataType","type":"string","optional":true},{"name":"presence","type":"string"},{"name":"rule","type":"object","optional":true}]},{"name":"additionalProperties","type":"boolean","optional":true}]}]}]}]}]},"subcommands":[{"name":"list","summary":"List generation models and accepted flags","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"type","type":"string","required":true,"description":"Resource type: image, video, or audio","constraints":"image|video|audio"}],"successData":{"type":"object","fields":[{"name":"items","type":"array<object>","fields":[{"name":"type","type":"string"},{"name":"model","type":"string"},{"name":"displayName","type":"string","optional":true},{"name":"aliases","type":"array<string>","optional":true},{"name":"modes","type":"array<object>","fields":[{"name":"scenario","type":"string","optional":true},{"name":"name","type":"string"},{"name":"flags","type":"array<object>","optional":true,"fields":[{"name":"flag","type":"string"},{"name":"required","type":"boolean"},{"name":"values","type":"array<string>","optional":true},{"name":"min","type":"number","optional":true},{"name":"max","type":"number","optional":true},{"name":"step","type":"number","optional":true},{"name":"minLength","type":"integer","optional":true},{"name":"maxLength","type":"integer","optional":true}]},{"name":"references","type":"object","optional":true,"fields":[{"name":"min","type":"integer"},{"name":"max","type":"integer"},{"name":"types","type":"array<object>","fields":[{"name":"mediaType","type":"string"},{"name":"min","type":"integer"},{"name":"max","type":"integer"}]},{"name":"requireAnyOfTypes","type":"array<string>","optional":true},{"name":"mutuallyExclusiveTypes","type":"array<string>","optional":true}]},{"name":"vipRequired","type":"boolean","optional":true},{"name":"vipResolutions","type":"array<string>","optional":true}]}]}]}},{"name":"find","summary":"Find a callable canonical model by display name or alias","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"arguments":[{"name":"name","required":true,"repeatable":true,"constraints":"model id/name or alias keyword; resolved to canonical model"}],"flags":[{"name":"type","type":"string","required":false,"description":"Resource type: image, video, or audio; omit to search all generation types","constraints":"image|video|audio"}],"successData":{"type":"object","fields":[{"name":"items","type":"array<object>","fields":[{"name":"type","type":"string"},{"name":"model","type":"string"},{"name":"displayName","type":"string","optional":true},{"name":"aliases","type":"array<string>","optional":true},{"name":"modes","type":"array<object>","fields":[{"name":"scenario","type":"string","optional":true},{"name":"name","type":"string"},{"name":"flags","type":"array<object>","optional":true,"fields":[{"name":"flag","type":"string"},{"name":"required","type":"boolean"},{"name":"values","type":"array<string>","optional":true},{"name":"min","type":"number","optional":true},{"name":"max","type":"number","optional":true},{"name":"step","type":"number","optional":true},{"name":"minLength","type":"integer","optional":true},{"name":"maxLength","type":"integer","optional":true}]},{"name":"references","type":"object","optional":true,"fields":[{"name":"min","type":"integer"},{"name":"max","type":"integer"},{"name":"types","type":"array<object>","fields":[{"name":"mediaType","type":"string"},{"name":"min","type":"integer"},{"name":"max","type":"integer"}]},{"name":"requireAnyOfTypes","type":"array<string>","optional":true},{"name":"mutuallyExclusiveTypes","type":"array<string>","optional":true}]},{"name":"vipRequired","type":"boolean","optional":true},{"name":"vipResolutions","type":"array<string>","optional":true}]}]}]}}]},{"name":"voice","summary":"Query voices available for audio generation","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"subcommands":[{"name":"list","summary":"List voices and IDs available for text-to-speech (TTS)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"offset","type":"integer","required":false,"default":"0","description":"Pagination offset","constraints":">=0; use the previous page's nextOffset"},{"name":"count","type":"integer","required":false,"default":"50","description":"Items per page, from 1 through 100","constraints":"1..100"},{"name":"model","type":"string","required":false,"description":"Optional canonical model; omit for all available TTS voices grouped by model and keep the same model when paging","constraints":"optional canonical model; omit for all supported regional catalogs grouped by model; explicit selection returns one map entry; same model and region across pages; unsupported routes fail"}],"successData":{"type":"object","fields":[{"name":"models","type":"map<string,object>","fields":[{"name":"items","type":"array<object>","fields":[{"name":"voiceName","type":"string"},{"name":"voiceId","type":"string","optional":true},{"name":"platform","type":"string","optional":true},{"name":"tags","type":"map<string,string>","optional":true},{"name":"previewAvailable","type":"boolean","optional":true}]},{"name":"hasMore","type":"boolean"},{"name":"nextOffset","type":"integer"},{"name":"totalCount","type":"integer"}]}]}}]},{"name":"node","summary":"Create, edit, delete, read, or run typed canvas nodes","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"subcommands":[{"name":"create","summary":"Create typed canvas nodes without starting generation","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"subcommands":[{"name":"image","summary":"Create an image node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,11,1,13,10,20],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":false,"description":"Stable node_id; generated when omitted","constraints":"canonical Node ID; generated when omitted"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Image node title; required when saving without --run; with --run, omission uses a non-empty prompt excerpt, otherwise specify a title; non-empty when provided, at most 512 UTF-16 code units","constraints":"required when saving without --run; with --run, omitted title uses a non-empty prompt excerpt, otherwise an explicit title is required; non-empty when provided; at most 512 UTF-16 code units"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID; repeatable; use default-tag-1 through default-tag-5 and do not add a tag unless explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear the complete node tag set"},{"name":"mode","type":"string","required":false,"description":"Image generation mode: t2i (text-to-image) or i2i (image-to-image); required with generation parameters and omitted for metadata-only updates or clearing generation parameters","constraints":"t2i|i2i (t2i=text-to-image, i2i=image-to-image); explicitly required when any generation parameter is supplied; metadata-only saves and clear-generation do not require mode"},{"name":"prompt","type":"string","required":false,"description":"Complete image-generation prompt; use {{node:node_xxx}}, {{res:resourceId}}, {{uri:value}}, or {{vid:value}} for references and \\{{ for a literal {{. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"may be empty at save time if the model spec permits; Core validates effective text before run; create --run needs explicit title when prompt is empty"},{"name":"model","type":"string","required":false,"description":"Image model ID registered by the service"},{"name":"ratio","type":"string","required":false,"description":"Image aspect ratio, such as 1:1"},{"name":"resolution","type":"string","required":false,"description":"Image resolution, such as 1K"},{"name":"count","type":"integer","required":false,"default":"1","description":"Generation count; follow --count min/max from model list; explicitly set that count for fixed-output models","constraints":">0 and int32; follow --count min/max from model list; fixed-output models require the exact count explicitly"},{"name":"ref","type":"string[]","required":false,"description":"Complete typed reference set: node:value, res:value, uri:value, or vid:value; repeatable. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"ordered type:value references; type is node|res|uri|vid; node value requires node_ prefix; res value requires canonical lowercase UUID or resource_<digits>[-<index>]"},{"name":"resource-id","type":"string[]","required":false,"description":"Resource IDs for existing image output on this node; repeatable; requires --import-kind local_upload or external_generated. Multiple values are ordered candidates in one batch, with the first as primary. Every resource must be registered and successful.","constraints":"Resource IDs; create only; requires import-kind=local_upload|external_generated; first is primary"},{"name":"import-kind","type":"string","required":false,"description":"Node import kind: local_upload for a locally uploaded registered resource, or external_generated for an output imported from another platform; uses the same registration intent as resource upload","constraints":"local_upload | external_generated; may stand alone; required by resource-id"},{"name":"run","type":"boolean","required":false,"default":"false","description":"After saving, estimate credits, obtain approval, and run this node","constraints":"when false, only save the draft; when true, save → estimate → approve → run"},{"name":"submit-id","type":"string","required":false,"description":"Stable submission UUID; generated when omitted with --run or --resource-id and reused to resume or retry an import","constraints":"UUID; with run, or with resource-id as the imported resource batch identity; generated when omitted; non-empty when supplied"},{"name":"credit-token","type":"string","required":false,"description":"Approved creditConfirmationToken; used with --run","constraints":"only with run; creditConfirmationToken issued by node confirm; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"description":"Approved credit ceiling; with --run, stop before execution if the estimate exceeds it","constraints":">=0; only with run; mutually exclusive with credit-token; stops before run when the estimate exceeds it"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After --run, wait for this node's generation to reach a terminal state","constraints":"only with run; wait for the submitted node to become terminal"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum --wait duration; defaults to 10m and 0 queries once","constraints":"only with wait; 0 means query once"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait; defaults to 5s","constraints":"only with wait; >0"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]},{"name":"quote","type":"object","optional":true,"fields":[{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"maxCredits","type":"integer","optional":true},{"name":"draftVersion","type":"integer"},{"name":"confirmable","type":"boolean","optional":true},{"name":"confirmationRequired","type":"boolean","optional":true}]},{"name":"approval","type":"object","optional":true,"fields":[{"name":"creditCeiling","type":"integer"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"submitId","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string","optional":true},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]}]},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"video","summary":"Create a video node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,11,1,13,10,20],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":false,"description":"Stable node_id; generated when omitted","constraints":"canonical Node ID; generated when omitted"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Node title; update only when the flag is present","constraints":"at most 512 UTF-16 code units"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID; repeatable; use default-tag-1 through default-tag-5 and do not add a tag unless explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear the complete node tag set"},{"name":"mode","type":"string","required":false,"description":"Video generation mode: t2v (text-to-video), first_last_frame, or m2v (multimodal-to-video); required with generation parameters and omitted for metadata-only updates or clearing generation parameters","constraints":"t2v|first_last_frame|m2v (t2v=text-to-video, first_last_frame=first and last frames, m2v=multimodal-to-video); first_last_frame accepts one first-frame image or two ordered first- and last-frame images; explicitly required when any generation parameter is supplied; metadata-only saves and clear-generation do not require mode"},{"name":"prompt","type":"string","required":false,"description":"Complete video-generation prompt; use {{node:node_xxx}}, {{res:resourceId}}, {{uri:value}}, or {{vid:value}} for references and \\{{ for a literal {{. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"may be empty at save time if the model spec permits; Core validates effective text before run; create --run needs explicit title when prompt is empty"},{"name":"model","type":"string","required":false,"description":"Video model ID registered by the service"},{"name":"ratio","type":"string","required":false,"description":"Video aspect ratio, such as 16:9"},{"name":"resolution","type":"string","required":false,"description":"Video resolution, such as 720P"},{"name":"duration","type":"number","required":false,"description":"Video duration in seconds; when omitted, 5 if the model allows it, otherwise the model's only allowed duration; models with several other durations require it","constraints":">0; when omitted, 5 if the model allows it, otherwise the model's only allowed duration from model list; models with several other durations require it"},{"name":"count","type":"integer","required":false,"default":"1","description":"Generation count; the maximum is the --count max returned by model list","constraints":">0 and int32; dynamic maximum is the --count max from model list"},{"name":"ref","type":"string[]","required":false,"description":"Complete typed reference set (node/res/uri/vid); first_last_frame accepts one first-frame reference or ordered first- and last-frame references. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"ordered type:value references; type is node|res|uri|vid; node value requires node_ prefix; res value requires canonical lowercase UUID or resource_<digits>[-<index>]"},{"name":"resource-id","type":"string[]","required":false,"description":"Resource IDs for existing video output on this node; repeatable; requires --import-kind local_upload or external_generated. Multiple values are ordered candidates in one batch, with the first as primary. Every resource must be registered and successful.","constraints":"Resource IDs; create only; requires import-kind=local_upload|external_generated; first is primary"},{"name":"import-kind","type":"string","required":false,"description":"Node import kind: local_upload for a locally uploaded registered resource, or external_generated for an output imported from another platform; uses the same registration intent as resource upload","constraints":"local_upload | external_generated; may stand alone; required by resource-id"},{"name":"run","type":"boolean","required":false,"default":"false","description":"After saving, estimate credits, obtain approval, and run this node","constraints":"when false, only save the draft; when true, save → estimate → approve → run"},{"name":"submit-id","type":"string","required":false,"description":"Stable submission UUID; generated when omitted with --run or --resource-id and reused to resume or retry an import","constraints":"UUID; with run, or with resource-id as the imported resource batch identity; generated when omitted; non-empty when supplied"},{"name":"credit-token","type":"string","required":false,"description":"Approved creditConfirmationToken; used with --run","constraints":"only with run; creditConfirmationToken issued by node confirm; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"description":"Approved credit ceiling; with --run, stop before execution if the estimate exceeds it","constraints":">=0; only with run; mutually exclusive with credit-token; stops before run when the estimate exceeds it"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After --run, wait for this node's generation to reach a terminal state","constraints":"only with run; wait for the submitted node to become terminal"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum --wait duration; defaults to 10m and 0 queries once","constraints":"only with wait; 0 means query once"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait; defaults to 5s","constraints":"only with wait; >0"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]},{"name":"quote","type":"object","optional":true,"fields":[{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"maxCredits","type":"integer","optional":true},{"name":"draftVersion","type":"integer"},{"name":"confirmable","type":"boolean","optional":true},{"name":"confirmationRequired","type":"boolean","optional":true}]},{"name":"approval","type":"object","optional":true,"fields":[{"name":"creditCeiling","type":"integer"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"submitId","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string","optional":true},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]}]},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"audio","summary":"Create an audio node; with --run, save it, estimate credits, obtain approval when required, and run it","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,11,1,13,10,20],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":false,"description":"Stable node_id; generated when omitted","constraints":"canonical Node ID; generated when omitted"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Node title; update only when the flag is present","constraints":"at most 512 UTF-16 code units"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID; repeatable; use default-tag-1 through default-tag-5 and do not add a tag unless explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear the complete node tag set"},{"name":"mode","type":"string","required":false,"default":"tts","description":"Audio generation mode: tts (text-to-speech) or music","constraints":"tts|music (tts=text-to-speech, music=music generation)"},{"name":"prompt","type":"string","required":false,"description":"TTS text or music prompt"},{"name":"model","type":"string","required":false,"description":"Required for music; tts scenario requirements come from model discovery; select from model list --type audio","constraints":"required for music; select a mode=music result from current-environment `model list --type audio`; tts scenario requirements come from model discovery; availability validated by Core"},{"name":"duration","type":"number","required":false,"default":"30","description":"Duration in seconds for music mode","constraints":">0 for music"},{"name":"voice-id","type":"string","required":false,"description":"Public catalog voice ID from voice list for the same model; mutually exclusive with --voice-name","constraints":"positive canonical decimal int64 from voice list for the same model; mutually exclusive with voice-name; tts only; authoritative public catalog validation at save time"},{"name":"voice-name","type":"string","required":false,"description":"Voice name from voice list; omni dubbing optionally converts one voice into an audio reference","constraints":"voice-id or voice-name required for legacy tts and text-reading; mutually exclusive; names resolved server-side; optional single catalog voice for omni-dubbing, converted server-side to an audio reference; choose from voice list --model; shares discovered reference limits"},{"name":"scenario","type":"string","required":false,"description":"Model scenario: text-reading or omni-dubbing","constraints":"text-reading|omni-dubbing; requires tts and explicit model"},{"name":"ref","type":"string[]","required":false,"description":"Omni-dubbing reference: node:<id> or res:<id>; repeatable","constraints":"omni-dubbing only; typed node:<id>|res:<id>|uri:<value>|vid:<value>"},{"name":"resource-id","type":"string[]","required":false,"description":"Resource IDs for existing audio output on this node; repeatable; requires --import-kind local_upload or external_generated. Multiple values are ordered candidates in one batch, with the first as primary. Every resource must be registered and successful.","constraints":"Resource IDs; create only; requires import-kind=local_upload|external_generated; first is primary"},{"name":"import-kind","type":"string","required":false,"description":"Node import kind: local_upload for a locally uploaded registered resource, or external_generated for an output imported from another platform; uses the same registration intent as resource upload","constraints":"local_upload | external_generated; may stand alone; required by resource-id"},{"name":"run","type":"boolean","required":false,"default":"false","description":"After saving, estimate credits, obtain approval, and run this node","constraints":"when false, only save the draft; when true, save → estimate → approve → run"},{"name":"submit-id","type":"string","required":false,"description":"Stable submission UUID; generated when omitted with --run or --resource-id and reused to resume or retry an import","constraints":"UUID; with run, or with resource-id as the imported resource batch identity; generated when omitted; non-empty when supplied"},{"name":"credit-token","type":"string","required":false,"description":"Approved creditConfirmationToken; used with --run","constraints":"only with run; creditConfirmationToken issued by node confirm; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"description":"Approved credit ceiling; with --run, stop before execution if the estimate exceeds it","constraints":">=0; only with run; mutually exclusive with credit-token; stops before run when the estimate exceeds it"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After --run, wait for this node's generation to reach a terminal state","constraints":"only with run; wait for the submitted node to become terminal"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum --wait duration; defaults to 10m and 0 queries once","constraints":"only with wait; 0 means query once"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait; defaults to 5s","constraints":"only with wait; >0"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]},{"name":"quote","type":"object","optional":true,"fields":[{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"maxCredits","type":"integer","optional":true},{"name":"draftVersion","type":"integer"},{"name":"confirmable","type":"boolean","optional":true},{"name":"confirmationRequired","type":"boolean","optional":true}]},{"name":"approval","type":"object","optional":true,"fields":[{"name":"creditCeiling","type":"integer"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"submitId","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string","optional":true},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]}]},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"element","summary":"Create an element node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":false,"description":"Stable node_id; generated when omitted","constraints":"canonical Node ID; generated when omitted"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Element title; preserve it when omitted","constraints":"at most 512 UTF-16 code units"},{"name":"description","type":"string","required":false,"description":"Element description"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID: default-tag-1 through default-tag-5; pass only when explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear all color tags","constraints":"clear all tags; mutually exclusive with tag"},{"name":"main","type":"string","required":true,"description":"Primary media: a canvas Node ID with usable output (node_ prefix, follows the node), or a usable Resource ID (frozen). Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"required on create; canvas Node ID (node_ prefix; must resolve to a usable generated resource and follows that node) or Resource ID (frozen; must be usable and type-matched)"},{"name":"voice","type":"string","required":false,"description":"Voice media: a Node ID with usable audio output, or a usable audio Resource ID. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"canvas Node ID (must resolve to a usable generated audio resource) or Resource ID (must be usable audio)"},{"name":"auxiliary","type":"string[]","required":false,"description":"Auxiliary media; repeatable: a Node ID with usable image output, or a usable image Resource ID. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"replace entire list; omitted preserves existing bindings on edit; usable image Node IDs or Resource IDs; node sources precede resource sources"},{"name":"import-kind","type":"string","required":false,"description":"Node import kind: local_upload for a locally uploaded registered resource, or external_generated for an output imported from another platform; uses the same registration intent as resource upload","constraints":"local_upload | external_generated; may stand alone; required by resource-id"}],"successData":{"type":"object","fields":[{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"text","summary":"Create a text node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":false,"description":"Stable node_id; generated when omitted","constraints":"canonical Node ID; generated when omitted"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"title","type":"string","required":false,"description":"Text node title; required","constraints":"at most 512 UTF-16 code units"},{"name":"text","type":"string","required":false,"description":"Markdown body; required"},{"name":"import-kind","type":"string","required":false,"description":"Node import kind: local_upload for a locally uploaded registered resource, or external_generated for an output imported from another platform; uses the same registration intent as resource upload","constraints":"local_upload | external_generated; may stand alone; required by resource-id"}],"successData":{"type":"object","fields":[{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"timeline","summary":"Create a timeline that arranges multiple media clips without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":false,"description":"Stable node_id; generated when omitted","constraints":"canonical Node ID; generated when omitted"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Timeline title; required","constraints":"at most 512 UTF-16 code units"},{"name":"clip","type":"string[]","required":false,"description":"A visual clip, arranged in flag order; sourceId accepts only a canvas Node ID or Resource ID; see --help for the full syntax. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"visual track item: <sourceId>[,options]; image allows duration=<positive-integer-milliseconds>; video allows trim=<start-milliseconds>-<positive-duration-milliseconds>, speed=<positive finite number>, volume=<0-1>, muted; start is forbidden; both allow kind=canvas_node|resource; sourceId must be a canvas Node ID (node_ prefix) or Resource ID (canonical lowercase UUID or resource_<digits>[-<index>]); order defines visual sequence"},{"name":"audio-clip","type":"string[]","required":false,"description":"An audio-track clip, arranged in flag order; source identities match --clip, but the available options differ; see --help. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"audio track item: <sourceId>[,options]; allows start=<non-negative-milliseconds>, trim=<start-milliseconds>-<positive-duration-milliseconds>, speed=<positive finite number>, volume=<0-1>, muted, kind=canvas_node|resource; duration is forbidden; source identity rules match clip; order defines audio sequence"},{"name":"import-kind","type":"string","required":false,"description":"Node import kind: local_upload for a locally uploaded registered resource, or external_generated for an output imported from another platform; uses the same registration intent as resource upload","constraints":"local_upload | external_generated; may stand alone; required by resource-id"}],"constraints":[{"atLeastOneOf":["clip","audio-clip"]}],"successData":{"type":"object","fields":[{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}}]},{"name":"edit","summary":"Edit saved typed canvas nodes without starting generation","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"subcommands":[{"name":"image","summary":"Edit an image node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,11,1,13,10,20],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":true,"description":"node_id of the node to edit; required","constraints":"canonical Node ID of the node to edit; required"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Node title; update only when the flag is present","constraints":"at most 512 UTF-16 code units"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID; repeatable; use default-tag-1 through default-tag-5 and do not add a tag unless explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear the complete node tag set"},{"name":"clear-generation","type":"boolean","required":false,"default":"false","description":"Clear generationDraft"},{"name":"mode","type":"string","required":false,"description":"Image generation mode: t2i (text-to-image) or i2i (image-to-image); required with generation parameters and omitted for metadata-only updates or clearing generation parameters","constraints":"t2i|i2i (t2i=text-to-image, i2i=image-to-image); explicitly required when any generation parameter is supplied; metadata-only saves and clear-generation do not require mode"},{"name":"prompt","type":"string","required":false,"description":"Complete image-generation prompt; use {{node:node_xxx}}, {{res:resourceId}}, {{uri:value}}, or {{vid:value}} for references and \\{{ for a literal {{. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"may be empty at save time if the model spec permits; Core validates effective text before run; create --run needs explicit title when prompt is empty"},{"name":"model","type":"string","required":false,"description":"Image model ID registered by the service"},{"name":"ratio","type":"string","required":false,"description":"Image aspect ratio, such as 1:1"},{"name":"resolution","type":"string","required":false,"description":"Image resolution, such as 1K"},{"name":"count","type":"integer","required":false,"default":"1","description":"Generation count; follow --count min/max from model list; explicitly set that count for fixed-output models","constraints":">0 and int32; follow --count min/max from model list; fixed-output models require the exact count explicitly"},{"name":"ref","type":"string[]","required":false,"description":"Complete typed reference set: node:value, res:value, uri:value, or vid:value; repeatable. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"ordered type:value references; type is node|res|uri|vid; node value requires node_ prefix; res value requires canonical lowercase UUID or resource_<digits>[-<index>]"},{"name":"run","type":"boolean","required":false,"default":"false","description":"After saving, estimate credits, obtain approval, and run this node","constraints":"when false, only save the draft; when true, save → estimate → approve → run"},{"name":"submit-id","type":"string","required":false,"description":"Stable submission UUID; generated when omitted with --run or --resource-id and reused to resume or retry an import","constraints":"UUID; with run, or with resource-id as the imported resource batch identity; generated when omitted; non-empty when supplied"},{"name":"credit-token","type":"string","required":false,"description":"Approved creditConfirmationToken; used with --run","constraints":"only with run; creditConfirmationToken issued by node confirm; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"description":"Approved credit ceiling; with --run, stop before execution if the estimate exceeds it","constraints":">=0; only with run; mutually exclusive with credit-token; stops before run when the estimate exceeds it"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After --run, wait for this node's generation to reach a terminal state","constraints":"only with run; wait for the submitted node to become terminal"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum --wait duration; defaults to 10m and 0 queries once","constraints":"only with wait; 0 means query once"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait; defaults to 5s","constraints":"only with wait; >0"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]},{"name":"quote","type":"object","optional":true,"fields":[{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"maxCredits","type":"integer","optional":true},{"name":"draftVersion","type":"integer"},{"name":"confirmable","type":"boolean","optional":true},{"name":"confirmationRequired","type":"boolean","optional":true}]},{"name":"approval","type":"object","optional":true,"fields":[{"name":"creditCeiling","type":"integer"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"submitId","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string","optional":true},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]}]},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"video","summary":"Edit a video node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,11,1,13,10,20],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":true,"description":"node_id of the node to edit; required","constraints":"canonical Node ID of the node to edit; required"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Node title; update only when the flag is present","constraints":"at most 512 UTF-16 code units"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID; repeatable; use default-tag-1 through default-tag-5 and do not add a tag unless explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear the complete node tag set"},{"name":"clear-generation","type":"boolean","required":false,"default":"false","description":"Clear generationDraft"},{"name":"mode","type":"string","required":false,"description":"Video generation mode: t2v (text-to-video), first_last_frame, or m2v (multimodal-to-video); required with generation parameters and omitted for metadata-only updates or clearing generation parameters","constraints":"t2v|first_last_frame|m2v (t2v=text-to-video, first_last_frame=first and last frames, m2v=multimodal-to-video); first_last_frame accepts one first-frame image or two ordered first- and last-frame images; explicitly required when any generation parameter is supplied; metadata-only saves and clear-generation do not require mode"},{"name":"prompt","type":"string","required":false,"description":"Complete video-generation prompt; use {{node:node_xxx}}, {{res:resourceId}}, {{uri:value}}, or {{vid:value}} for references and \\{{ for a literal {{. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"may be empty at save time if the model spec permits; Core validates effective text before run; create --run needs explicit title when prompt is empty"},{"name":"model","type":"string","required":false,"description":"Video model ID registered by the service"},{"name":"ratio","type":"string","required":false,"description":"Video aspect ratio, such as 16:9"},{"name":"resolution","type":"string","required":false,"description":"Video resolution, such as 720P"},{"name":"duration","type":"number","required":false,"description":"Video duration in seconds; when omitted, 5 if the model allows it, otherwise the model's only allowed duration; models with several other durations require it","constraints":">0; when omitted, 5 if the model allows it, otherwise the model's only allowed duration from model list; models with several other durations require it"},{"name":"count","type":"integer","required":false,"default":"1","description":"Generation count; the maximum is the --count max returned by model list","constraints":">0 and int32; dynamic maximum is the --count max from model list"},{"name":"ref","type":"string[]","required":false,"description":"Complete typed reference set (node/res/uri/vid); first_last_frame accepts one first-frame reference or ordered first- and last-frame references. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"ordered type:value references; type is node|res|uri|vid; node value requires node_ prefix; res value requires canonical lowercase UUID or resource_<digits>[-<index>]"},{"name":"run","type":"boolean","required":false,"default":"false","description":"After saving, estimate credits, obtain approval, and run this node","constraints":"when false, only save the draft; when true, save → estimate → approve → run"},{"name":"submit-id","type":"string","required":false,"description":"Stable submission UUID; generated when omitted with --run or --resource-id and reused to resume or retry an import","constraints":"UUID; with run, or with resource-id as the imported resource batch identity; generated when omitted; non-empty when supplied"},{"name":"credit-token","type":"string","required":false,"description":"Approved creditConfirmationToken; used with --run","constraints":"only with run; creditConfirmationToken issued by node confirm; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"description":"Approved credit ceiling; with --run, stop before execution if the estimate exceeds it","constraints":">=0; only with run; mutually exclusive with credit-token; stops before run when the estimate exceeds it"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After --run, wait for this node's generation to reach a terminal state","constraints":"only with run; wait for the submitted node to become terminal"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum --wait duration; defaults to 10m and 0 queries once","constraints":"only with wait; 0 means query once"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait; defaults to 5s","constraints":"only with wait; >0"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]},{"name":"quote","type":"object","optional":true,"fields":[{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"maxCredits","type":"integer","optional":true},{"name":"draftVersion","type":"integer"},{"name":"confirmable","type":"boolean","optional":true},{"name":"confirmationRequired","type":"boolean","optional":true}]},{"name":"approval","type":"object","optional":true,"fields":[{"name":"creditCeiling","type":"integer"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"submitId","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string","optional":true},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]}]},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"audio","summary":"Edit an audio node; with --run, save it, estimate credits, obtain approval when required, and run it","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,11,1,13,10,20],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":true,"description":"node_id of the node to edit; required","constraints":"canonical Node ID of the node to edit; required"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Node title; update only when the flag is present","constraints":"at most 512 UTF-16 code units"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID; repeatable; use default-tag-1 through default-tag-5 and do not add a tag unless explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear the complete node tag set"},{"name":"clear-generation","type":"boolean","required":false,"default":"false","description":"Clear generationDraft"},{"name":"mode","type":"string","required":false,"default":"tts","description":"Audio generation mode: tts (text-to-speech) or music","constraints":"tts|music (tts=text-to-speech, music=music generation)"},{"name":"prompt","type":"string","required":false,"description":"TTS text or music prompt"},{"name":"model","type":"string","required":false,"description":"Required for music; tts scenario requirements come from model discovery; select from model list --type audio","constraints":"required for music; select a mode=music result from current-environment `model list --type audio`; tts scenario requirements come from model discovery; availability validated by Core"},{"name":"duration","type":"number","required":false,"default":"30","description":"Duration in seconds for music mode","constraints":">0 for music"},{"name":"voice-id","type":"string","required":false,"description":"Public catalog voice ID from voice list for the same model; mutually exclusive with --voice-name","constraints":"positive canonical decimal int64 from voice list for the same model; mutually exclusive with voice-name; tts only; authoritative public catalog validation at save time"},{"name":"voice-name","type":"string","required":false,"description":"Voice name from voice list; omni dubbing optionally converts one voice into an audio reference","constraints":"voice-id or voice-name required for legacy tts and text-reading; mutually exclusive; names resolved server-side; optional single catalog voice for omni-dubbing, converted server-side to an audio reference; choose from voice list --model; shares discovered reference limits"},{"name":"scenario","type":"string","required":false,"description":"Model scenario: text-reading or omni-dubbing","constraints":"text-reading|omni-dubbing; requires tts and explicit model"},{"name":"ref","type":"string[]","required":false,"description":"Omni-dubbing reference: node:<id> or res:<id>; repeatable","constraints":"omni-dubbing only; typed node:<id>|res:<id>|uri:<value>|vid:<value>"},{"name":"run","type":"boolean","required":false,"default":"false","description":"After saving, estimate credits, obtain approval, and run this node","constraints":"when false, only save the draft; when true, save → estimate → approve → run"},{"name":"submit-id","type":"string","required":false,"description":"Stable submission UUID; generated when omitted with --run or --resource-id and reused to resume or retry an import","constraints":"UUID; with run, or with resource-id as the imported resource batch identity; generated when omitted; non-empty when supplied"},{"name":"credit-token","type":"string","required":false,"description":"Approved creditConfirmationToken; used with --run","constraints":"only with run; creditConfirmationToken issued by node confirm; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"description":"Approved credit ceiling; with --run, stop before execution if the estimate exceeds it","constraints":">=0; only with run; mutually exclusive with credit-token; stops before run when the estimate exceeds it"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After --run, wait for this node's generation to reach a terminal state","constraints":"only with run; wait for the submitted node to become terminal"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum --wait duration; defaults to 10m and 0 queries once","constraints":"only with wait; 0 means query once"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait; defaults to 5s","constraints":"only with wait; >0"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]},{"name":"quote","type":"object","optional":true,"fields":[{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"maxCredits","type":"integer","optional":true},{"name":"draftVersion","type":"integer"},{"name":"confirmable","type":"boolean","optional":true},{"name":"confirmationRequired","type":"boolean","optional":true}]},{"name":"approval","type":"object","optional":true,"fields":[{"name":"creditCeiling","type":"integer"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"submitId","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string","optional":true},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]}]},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"element","summary":"Edit an element node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":true,"description":"node_id of the node to edit; required","constraints":"canonical Node ID of the node to edit; required"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Element title; preserve it when omitted","constraints":"at most 512 UTF-16 code units"},{"name":"description","type":"string","required":false,"description":"Element description"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID: default-tag-1 through default-tag-5; pass only when explicitly requested","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels"},{"name":"clear-tags","type":"boolean","required":false,"default":"false","description":"Clear all color tags","constraints":"clear all tags; mutually exclusive with tag"},{"name":"main","type":"string","required":false,"description":"Primary media: a canvas Node ID with usable output (node_ prefix, follows the node), or a usable Resource ID (frozen). Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"required on create; canvas Node ID (node_ prefix; must resolve to a usable generated resource and follows that node) or Resource ID (frozen; must be usable and type-matched)"},{"name":"voice","type":"string","required":false,"description":"Voice media: a Node ID with usable audio output, or a usable audio Resource ID. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"canvas Node ID (must resolve to a usable generated audio resource) or Resource ID (must be usable audio)"},{"name":"auxiliary","type":"string[]","required":false,"description":"Auxiliary media; repeatable: a Node ID with usable image output, or a usable image Resource ID. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"replace entire list; omitted preserves existing bindings on edit; usable image Node IDs or Resource IDs; node sources precede resource sources"},{"name":"clear-description","type":"boolean","required":false,"default":"false","description":"Clear the Element description","constraints":"mutually exclusive with description"},{"name":"clear-main","type":"boolean","required":false,"default":"false","description":"Clear the primary media and cascade to the voice and auxiliary media; cannot be combined with binding assignments","constraints":"also clears voice and all auxiliaries; cannot combine with binding assignments"},{"name":"clear-voice","type":"boolean","required":false,"default":"false","description":"Clear the voice binding","constraints":"mutually exclusive with voice"},{"name":"clear-auxiliary","type":"boolean","required":false,"default":"false","description":"Clear the complete auxiliary media list","constraints":"clear entire auxiliary list; mutually exclusive with auxiliary"}],"successData":{"type":"object","fields":[{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"text","summary":"Edit a text node without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":true,"description":"node_id of the node to edit; required","constraints":"canonical Node ID of the node to edit; required"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"title","type":"string","required":false,"description":"Text node title; update only when the flag is present","constraints":"at most 512 UTF-16 code units"},{"name":"text","type":"string","required":false,"description":"Markdown body; update only when the flag is present"}],"successData":{"type":"object","fields":[{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}},{"name":"timeline","summary":"Edit a timeline that arranges multiple media clips without starting generation","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"x","type":"number","required":false,"description":"Node left X; relative to the parent group when grouped; requires --y","constraints":"finite; requires y; node left; parent-local when grouped"},{"name":"y","type":"number","required":false,"description":"Node top Y; relative to the parent group when grouped; requires --x","constraints":"finite; requires x; node top; parent-local when grouped"},{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string","required":true,"description":"node_id of the node to edit; required","constraints":"canonical Node ID of the node to edit; required"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted","constraints":"UUID"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate locally and print the plan; do not contact the service, write a draft, estimate credits, or charge credits","constraints":"local validation only; no runtime, network, draft write, credit estimate, approval, journal, dispatch, or credit side effects"},{"name":"resource-source","type":"string[]","required":false,"description":"Cross-project resource source: <Resource ID>@<source project UUID>; repeatable, only for resources assigned by this save","constraints":"repeatable ResourceID@SourceProjectUUID; resource must be assigned by this save; conflicting sources rejected"},{"name":"title","type":"string","required":false,"description":"Timeline title; update only when the flag is present","constraints":"at most 512 UTF-16 code units"},{"name":"clip","type":"string[]","required":false,"description":"A visual clip, arranged in flag order; sourceId accepts only a canvas Node ID or Resource ID; see --help for the full syntax. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"visual track item: <sourceId>[,options]; image allows duration=<positive-integer-milliseconds>; video allows trim=<start-milliseconds>-<positive-duration-milliseconds>, speed=<positive finite number>, volume=<0-1>, muted; start is forbidden; both allow kind=canvas_node|resource; sourceId must be a canvas Node ID (node_ prefix) or Resource ID (canonical lowercase UUID or resource_<digits>[-<index>]); order defines visual sequence"},{"name":"audio-clip","type":"string[]","required":false,"description":"An audio-track clip, arranged in flag order; source identities match --clip, but the available options differ; see --help. Prefer Node ID for an existing canvas source to retain upstream edges. Use Resource ID for media without a source node (such as uploads), or an explicit user request to freeze; do not automatically extract it from node output","constraints":"audio track item: <sourceId>[,options]; allows start=<non-negative-milliseconds>, trim=<start-milliseconds>-<positive-duration-milliseconds>, speed=<positive finite number>, volume=<0-1>, muted, kind=canvas_node|resource; duration is forbidden; source identity rules match clip; order defines audio sequence"},{"name":"clear-tracks","type":"boolean","required":false,"default":"false","description":"Clear all clips while retaining the protocol-required empty visual track","constraints":"clears every clip by writing the canonical empty visual track; mutually exclusive with clip and audio-clip"}],"successData":{"type":"object","fields":[{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"mutation","type":"object","fields":[{"name":"action","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"effectiveGeneration","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"sideEffects","type":"array<string>"},{"name":"plan","type":"object","fields":[{"name":"resourceSourceProjects","type":"map<string,string>","optional":true},{"name":"action","type":"string"},{"name":"nodeType","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"node","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"update","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"steps","type":"array<string>"},{"name":"fields","type":"object","fields":[{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>","optional":true},{"name":"text","type":"string","optional":true},{"name":"clearGeneration","type":"boolean","optional":true},{"name":"clearDescription","type":"boolean","optional":true},{"name":"clearMain","type":"boolean","optional":true},{"name":"clearVoice","type":"boolean","optional":true},{"name":"clearAuxiliary","type":"boolean","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string"},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"outputCount","type":"integer","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true}]},{"name":"references","type":"array<object>","optional":true,"fields":[{"name":"index","type":"integer"},{"name":"type","type":"string"},{"name":"id","type":"string"},{"name":"resolvedFrom","type":"string"},{"name":"role","type":"string","optional":true}]},{"name":"bindings","type":"array<object>","optional":true,"fields":[{"name":"slot","type":"string"},{"name":"objectId","type":"string"},{"name":"bindingMode","type":"string"}]},{"name":"timeline","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"sourceId","type":"string"},{"name":"sourceKind","type":"string","optional":true},{"name":"durationTick","type":"integer","optional":true},{"name":"sourceRange","type":"object","optional":true,"fields":[{"name":"startTick","type":"integer"},{"name":"durationTick","type":"integer"}]},{"name":"startTick","type":"integer","optional":true},{"name":"volume","type":"number","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"speed","type":"number","optional":true}]}]}]},{"name":"importKind","type":"string","optional":true},{"name":"position","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"}]},{"name":"submission","type":"object","optional":true,"fields":[{"name":"identity","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"usesCreditToken","type":"boolean"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"waitForTerminal","type":"boolean"},{"name":"timeout","type":"string","optional":true},{"name":"interval","type":"string","optional":true}]}]},{"name":"unverified","type":"array<string>"}]}}]},{"name":"upscale","summary":"Upscale generated images or videos into new nodes","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[],"subcommands":[{"name":"image","summary":"Upscale images immediately on submission; use --wait for a terminal state (no --run)","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to read the current project","constraints":"UUID; current project when omitted"},{"name":"node-id","type":"string[]","required":true,"description":"1..20 unique source image nodes; repeatable","constraints":"1..20 unique canonical source Node IDs; each must resolve to one eligible successful image"},{"name":"submit-id","type":"string[]","required":false,"description":"Per-node submission UUIDs with matching count and order; independently generated when omitted","constraints":"unique UUIDs; optional, otherwise same count and order as node-id; never empty"},{"name":"mode","type":"string","required":false,"default":"pro","description":"normal=upscale; pro=smart upscale","constraints":"normal|pro"},{"name":"resolution","type":"string","required":false,"description":"Required for pro: target resolution 2K, 4K, or 8K; rejected for normal","constraints":"2K|4K|8K; required for pro and rejected for normal; target-vs-source eligibility remains server-authoritative"},{"name":"detail","type":"integer","required":false,"default":"50","description":"pro only: detail strength from 1 through 100; default 50","constraints":"1..100; pro only; omit for normal"},{"name":"title","type":"string","required":false,"description":"Override the output title; omit by default to retain the source title and operation marker","constraints":"non-empty when provided; new output node title, source is unchanged"},{"name":"credit-token","type":"string","required":false,"description":"Short-lived token scoped to this operation; node confirm tokens are not accepted","constraints":"image-upscale scoped token only; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"default":"0","description":"Approved credit ceiling for the whole batch; cannot be combined with --credit-token","constraints":">=0; approval only when explicitly provided; entire batch ceiling"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After submission, wait read-only for a terminal generation state; by default return only the accepted result","constraints":"wait for output resources, not source node state"},{"name":"timeout","type":"duration","required":false,"default":"10m0s","description":"Maximum --wait duration; 0 queries once","constraints":">=0; requires wait"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait","constraints":">0; requires wait"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate local parameters only; do not use the network, estimate credits, generate output, or write the journal","constraints":"local validation only; no runtime, network, credit estimate, approval, journal, or generation"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"sourceNodeId","type":"string"},{"name":"submitId","type":"string"},{"name":"nodeId","type":"string","optional":true},{"name":"resourceIds","type":"array<string>"},{"name":"state","type":"string"},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"authorizedCredits","type":"integer","optional":true},{"name":"generationState","type":"string","optional":true},{"name":"resources","type":"array<object>","optional":true,"fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string"},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]}]},{"name":"totalMaxCredits","type":"integer","optional":true},{"name":"creditsApproved","type":"integer","optional":true}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"params","type":"object","fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"sourceNodeId","type":"string"},{"name":"submission","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"outputTitle","type":"string","optional":true}]},{"name":"creditCeiling","type":"integer","optional":true},{"name":"usesCreditToken","type":"boolean"},{"name":"waitForTerminal","type":"boolean"},{"name":"sideEffects","type":"array<string>"},{"name":"unverified","type":"array<string>"}]}},{"name":"video","summary":"Submit post-editing immediately on submission; use --wait for a terminal state (no --run)","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to read the current project","constraints":"UUID; current project when omitted"},{"name":"node-id","type":"string[]","required":true,"description":"1..20 unique source nodes; repeatable","constraints":"1..20 unique canonical source Node IDs; successful consumable media required"},{"name":"submit-id","type":"string[]","required":false,"description":"Per-node submission UUIDs with matching count and order; independently generated when omitted","constraints":"unique UUIDs; same count/order as node-id when provided"},{"name":"title","type":"string","required":false,"description":"Override the output title; omit by default to preserve the source title and operation marker","constraints":"optional complete override; omit by default to retain source title and operation marker"},{"name":"credit-token","type":"string","required":false,"description":"Short-lived token scoped to this operation; node confirm tokens are not accepted","constraints":"operation-scoped token; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"default":"0","description":"Approved credit ceiling for the whole batch; cannot be combined with --credit-token","constraints":">=0; approval only when explicitly supplied; entire batch ceiling"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After submission, wait read-only for a terminal generation state; by default return only the accepted result","constraints":"read-only terminal wait after submission"},{"name":"timeout","type":"duration","required":false,"default":"10m0s","description":"Maximum --wait duration; 0 queries once","constraints":">=0; requires wait"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait","constraints":">0; requires wait"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate local parameters only; do not use the network, estimate credits, generate output, or write the journal","constraints":"local-only; source media, eligibility, entitlement and credits remain unverified"},{"name":"resolution","type":"string","required":true,"description":"Required target resolution: 2K or 4K","constraints":"2K|4K; server validates actual original dimensions and duration"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"sourceNodeId","type":"string"},{"name":"submitId","type":"string"},{"name":"nodeId","type":"string","optional":true},{"name":"resourceIds","type":"array<string>"},{"name":"state","type":"string"},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"authorizedCredits","type":"integer","optional":true},{"name":"generationState","type":"string","optional":true},{"name":"resources","type":"array<object>","optional":true,"fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string"},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]}]},{"name":"totalMaxCredits","type":"integer","optional":true},{"name":"creditsApproved","type":"integer","optional":true}]},"dryRunData":{"type":"object","fields":[{"name":"operation","type":"string"},{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"params","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"sourceNodeId","type":"string"},{"name":"submission","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"outputTitle","type":"string","optional":true}]},{"name":"creditCeiling","type":"integer","optional":true},{"name":"usesCreditToken","type":"boolean"},{"name":"waitForTerminal","type":"boolean"},{"name":"sideEffects","type":"array<string>"},{"name":"unverified","type":"array<string>"}]}}]},{"name":"cutout","summary":"Cut out images","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[],"subcommands":[{"name":"image","summary":"Submit post-editing immediately on submission; use --wait for a terminal state (no --run)","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to read the current project","constraints":"UUID; current project when omitted"},{"name":"node-id","type":"string[]","required":true,"description":"1..20 unique source nodes; repeatable","constraints":"1..20 unique canonical source Node IDs; successful consumable media required"},{"name":"submit-id","type":"string[]","required":false,"description":"Per-node submission UUIDs with matching count and order; independently generated when omitted","constraints":"unique UUIDs; same count/order as node-id when provided"},{"name":"title","type":"string","required":false,"description":"Override the output title; omit by default to preserve the source title and operation marker","constraints":"optional complete override; omit by default to retain source title and operation marker"},{"name":"credit-token","type":"string","required":false,"description":"Short-lived token scoped to this operation; node confirm tokens are not accepted","constraints":"operation-scoped token; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"default":"0","description":"Approved credit ceiling for the whole batch; cannot be combined with --credit-token","constraints":">=0; approval only when explicitly supplied; entire batch ceiling"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After submission, wait read-only for a terminal generation state; by default return only the accepted result","constraints":"read-only terminal wait after submission"},{"name":"timeout","type":"duration","required":false,"default":"10m0s","description":"Maximum --wait duration; 0 queries once","constraints":">=0; requires wait"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait","constraints":">0; requires wait"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate local parameters only; do not use the network, estimate credits, generate output, or write the journal","constraints":"local-only; source media, eligibility, entitlement and credits remain unverified"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"sourceNodeId","type":"string"},{"name":"submitId","type":"string"},{"name":"nodeId","type":"string","optional":true},{"name":"resourceIds","type":"array<string>"},{"name":"state","type":"string"},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"authorizedCredits","type":"integer","optional":true},{"name":"generationState","type":"string","optional":true},{"name":"resources","type":"array<object>","optional":true,"fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string"},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]}]},{"name":"totalMaxCredits","type":"integer","optional":true},{"name":"creditsApproved","type":"integer","optional":true}]},"dryRunData":{"type":"object","fields":[{"name":"operation","type":"string"},{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"params","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"sourceNodeId","type":"string"},{"name":"submission","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"outputTitle","type":"string","optional":true}]},{"name":"creditCeiling","type":"integer","optional":true},{"name":"usesCreditToken","type":"boolean"},{"name":"waitForTerminal","type":"boolean"},{"name":"sideEffects","type":"array<string>"},{"name":"unverified","type":"array<string>"}]}}]},{"name":"interpolate","summary":"Interpolate videos","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[],"subcommands":[{"name":"video","summary":"Submit post-editing immediately on submission; use --wait for a terminal state (no --run)","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to read the current project","constraints":"UUID; current project when omitted"},{"name":"node-id","type":"string[]","required":true,"description":"1..20 unique source nodes; repeatable","constraints":"1..20 unique canonical source Node IDs; successful consumable media required"},{"name":"submit-id","type":"string[]","required":false,"description":"Per-node submission UUIDs with matching count and order; independently generated when omitted","constraints":"unique UUIDs; same count/order as node-id when provided"},{"name":"title","type":"string","required":false,"description":"Override the output title; omit by default to preserve the source title and operation marker","constraints":"optional complete override; omit by default to retain source title and operation marker"},{"name":"credit-token","type":"string","required":false,"description":"Short-lived token scoped to this operation; node confirm tokens are not accepted","constraints":"operation-scoped token; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"default":"0","description":"Approved credit ceiling for the whole batch; cannot be combined with --credit-token","constraints":">=0; approval only when explicitly supplied; entire batch ceiling"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"After submission, wait read-only for a terminal generation state; by default return only the accepted result","constraints":"read-only terminal wait after submission"},{"name":"timeout","type":"duration","required":false,"default":"10m0s","description":"Maximum --wait duration; 0 queries once","constraints":">=0; requires wait"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval for --wait","constraints":">0; requires wait"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate local parameters only; do not use the network, estimate credits, generate output, or write the journal","constraints":"local-only; source media, eligibility, entitlement and credits remain unverified"},{"name":"fps","type":"integer","required":true,"description":"Required target FPS: 30 or 60; the server validates the current effective frame rate","constraints":"30|60; server validates effective source FPS and entitlement"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"sourceNodeId","type":"string"},{"name":"submitId","type":"string"},{"name":"nodeId","type":"string","optional":true},{"name":"resourceIds","type":"array<string>"},{"name":"state","type":"string"},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"authorizedCredits","type":"integer","optional":true},{"name":"generationState","type":"string","optional":true},{"name":"resources","type":"array<object>","optional":true,"fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string"},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]}]},{"name":"totalMaxCredits","type":"integer","optional":true},{"name":"creditsApproved","type":"integer","optional":true}]},"dryRunData":{"type":"object","fields":[{"name":"operation","type":"string"},{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"params","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"items","type":"array<object>","fields":[{"name":"sourceNodeId","type":"string"},{"name":"submission","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"outputTitle","type":"string","optional":true}]},{"name":"creditCeiling","type":"integer","optional":true},{"name":"usesCreditToken","type":"boolean"},{"name":"waitForTerminal","type":"boolean"},{"name":"sideEffects","type":"array<string>"},{"name":"unverified","type":"array<string>"}]}}]},{"name":"promote","summary":"Promote a sample into a final video","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":null,"subcommands":[{"name":"video-sample","summary":"Quote and approve a video sample promotion into a new node","reads":true,"writes":true,"formats":["json","table"],"dryRun":true,"confirmation":true,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; defaults to the current project","constraints":"UUID; current project when omitted"},{"name":"node-id","type":"string","required":true,"description":"Source sample Node ID","constraints":"canonical source sample Node ID"},{"name":"resolution","type":"string","required":true,"description":"Target resolution from search --detail full draftPromotion","constraints":"source model draftPromotion resolution enum"},{"name":"submit-id","type":"string","required":false,"description":"Submission UUID; generated when omitted; use it to inspect after a timeout","constraints":"UUID; generated when omitted; use operation status/wait after timeout"},{"name":"title","type":"string","required":false,"description":"New final video node title","constraints":"non-empty output title"},{"name":"credit-token","type":"string","required":false,"description":"Short-lived token scoped to video sample promotion","constraints":"sample promotion scoped; mutually exclusive with credit-ceiling"},{"name":"credit-ceiling","type":"integer","required":false,"default":"0","description":"Approved credit ceiling; cannot be combined with credit-token","constraints":">=0; explicit approval ceiling"},{"name":"wait","type":"boolean","required":false,"default":"false","description":"Wait read-only for the final video after submission"},{"name":"timeout","type":"duration","required":false,"default":"10m0s","description":"Maximum wait duration","constraints":">=0; requires wait"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Wait polling interval","constraints":">0; requires wait"},{"name":"dry-run","type":"boolean","required":false,"default":"false","description":"Validate local parameters without network or credit consumption","constraints":"local validation only; no network, quote, journal or generation"}],"successData":{"type":"object","fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"sourceNodeId","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"submitId","type":"string"},{"name":"nodeId","type":"string","optional":true},{"name":"resourceIds","type":"array<string>"},{"name":"state","type":"string"},{"name":"errorCode","type":"integer"},{"name":"authorizedCredits","type":"integer","optional":true},{"name":"totalMaxCredits","type":"integer","optional":true},{"name":"creditsApproved","type":"integer","optional":true},{"name":"generationState","type":"string","optional":true},{"name":"resources","type":"array<object>","optional":true,"fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string"},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]}]},"dryRunData":{"type":"object","fields":[{"name":"dryRun","type":"boolean"},{"name":"validationScope","type":"string"},{"name":"project","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"sourceNodeId","type":"string"},{"name":"submission","type":"object","fields":[{"name":"value","type":"string","optional":true},{"name":"source","type":"string"}]},{"name":"resolution","type":"string"},{"name":"creditCeiling","type":"integer","optional":true},{"name":"usesCreditToken","type":"boolean"},{"name":"sideEffects","type":"array<string>"},{"name":"unverified","type":"array<string>"}]}}]},{"name":"delete","summary":"Delete a batch of nodes after approval; groups are not supported","reads":true,"writes":true,"formats":["json","table"],"confirmation":true,"declaredExitCodes":[0,2,11,1,13,10,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; defaults to the current canvas","constraints":"UUID; defaults to current canvas"},{"name":"node-id","type":"string[]","required":true,"description":"Specified Node IDs; repeat or separate with commas; deduplicated in order; groups are unsupported","constraints":"1..100 distinct non-empty IDs; deduplicated in order; groups are unsupported"},{"name":"update-id","type":"string","required":false,"description":"Stable update UUID; generated when omitted; reuse it for confirmation and retries","constraints":"UUID; generated when omitted; required with delete-token; reuse for approval and retries"},{"name":"delete-token","type":"string","required":false,"description":"Short-lived token issued by node delete confirm; reuse the same --update-id","constraints":"short-lived token from node delete confirm; --yes cannot replace it"}],"successData":{"type":"object","fields":[{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"nodeIds","type":"array<string>"},{"name":"updateId","type":"string"},{"name":"savedDraftVersion","type":"integer"},{"name":"idempotentReplay","type":"boolean"}]},"subcommands":[{"name":"confirm","summary":"Approve the specified batch and issue a deletion token without deleting nodes","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; defaults to the current canvas","constraints":"UUID; defaults to current canvas"},{"name":"node-id","type":"string[]","required":true,"description":"Specified Node IDs; repeat or separate with commas; deduplicated in order; groups are unsupported","constraints":"1..100 distinct non-empty IDs; deduplicated in order; groups are unsupported"},{"name":"update-id","type":"string","required":true,"description":"Stable update UUID from the summary; required and shared by approval, execution and recovery","constraints":"UUID; must match approval, execution and recovery"}],"successData":{"type":"object","fields":[{"name":"deleteConfirmationToken","type":"string"},{"name":"expiresAtMs","type":"integer"}]}},{"name":"status","summary":"Read the first deletion result without issuing a token or deleting nodes","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; defaults to the current canvas","constraints":"UUID; defaults to current canvas"},{"name":"node-id","type":"string[]","required":true,"description":"Specified Node IDs; repeat or separate with commas; deduplicated in order; groups are unsupported","constraints":"1..100 distinct non-empty IDs; deduplicated in order; groups are unsupported"},{"name":"update-id","type":"string","required":true,"description":"Stable update UUID from the summary; required and shared by approval, execution and recovery","constraints":"UUID; must match approval, execution and recovery"}],"successData":{"type":"object","fields":[{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"found","type":"boolean"},{"name":"nodeIds","type":"array<string>"},{"name":"updateId","type":"string"},{"name":"result","type":"string","optional":true},{"name":"savedDraftVersion","type":"integer","optional":true},{"name":"idempotentReplay","type":"boolean","optional":true},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]}]}}]},{"name":"show","summary":"Read views of the specified nodes","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID, also used as draft-id; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string[]","required":true,"description":"node_id values to read; repeatable","constraints":"1..20 IDs per request"}],"successData":{"type":"object","fields":[{"name":"nodes","type":"array<object>","fields":[{"name":"nodeId","type":"string","optional":true},{"name":"result","type":"string"},{"name":"node","type":"object","optional":true,"fields":[{"name":"parentNodeId","type":"string","optional":true},{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"title","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"tags","type":"array<string>"},{"name":"text","type":"string","optional":true},{"name":"status","type":"string","optional":true},{"name":"upstreamNodeIds","type":"array<string>"},{"name":"downstreamNodeIds","type":"array<string>"},{"name":"executionDependencyNodeIds","type":"array<string>"},{"name":"resources","type":"array<object>","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]},{"name":"generation","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"prompt","type":"string","optional":true},{"name":"model","type":"string","optional":true},{"name":"ratio","type":"string","optional":true},{"name":"resolution","type":"string","optional":true},{"name":"outputCount","type":"integer"},{"name":"durationSeconds","type":"number","optional":true},{"name":"scenario","type":"string","optional":true},{"name":"voiceName","type":"string","optional":true},{"name":"voiceId","type":"string","optional":true},{"name":"references","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"promptParts","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"text","type":"string","optional":true},{"name":"referenceIndex","type":"integer","optional":true}]},{"name":"writebackSupported","type":"boolean"},{"name":"writebackBlockers","type":"array<object>","fields":[{"name":"referenceIndex","type":"integer"},{"name":"code","type":"string"}]}]},{"name":"subjectBindings","type":"object","optional":true,"fields":[{"name":"main","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"voice","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]},{"name":"auxiliaries","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]},{"name":"timelineTracks","type":"object","optional":true,"fields":[{"name":"tracks","type":"array<object>","fields":[{"name":"kind","type":"string"},{"name":"trackId","type":"string","optional":true},{"name":"muted","type":"boolean","optional":true},{"name":"clips","type":"array<object>","fields":[{"name":"clipId","type":"string"},{"name":"kind","type":"string"},{"name":"source","type":"object","fields":[{"name":"kind","type":"string"},{"name":"id","type":"string","optional":true},{"name":"type","type":"string","optional":true},{"name":"title","type":"string","optional":true},{"name":"writebackSupported","type":"boolean"},{"name":"unavailableCode","type":"string","optional":true},{"name":"resource","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"submitId","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"canRegenerate","type":"boolean","optional":true},{"name":"source","type":"string","optional":true},{"name":"creditsAmount","type":"integer","optional":true}]}]}]}]},{"name":"clipsTruncated","type":"boolean","optional":true}]},{"name":"layout","type":"object","optional":true,"fields":[{"name":"x","type":"number"},{"name":"y","type":"number"},{"name":"width","type":"number"},{"name":"height","type":"number"},{"name":"zIndex","type":"number","optional":true}]},{"name":"resourceObservedAtMs","type":"integer"}]},{"name":"errorCode","type":"integer","optional":true},{"name":"errmsg","type":"string","optional":true}]},{"name":"draftVersion","type":"integer"}]}},{"name":"find","summary":"Find nodes by filter and return locator fields only (nodeId/type/title/status/tags)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID, also used as draft-id; omit to use the current project","constraints":"UUID"},{"name":"name","type":"string","required":false,"description":"Text match across title, description, text body, and generation prompt","constraints":"matches title, description, text body and generation prompt"},{"name":"type","type":"string[]","required":false,"description":"Node type; repeatable, with same-dimension values combined by OR. Values: image, video, audio, element, timeline, text","constraints":"image|video|audio|element|timeline|text; repeatable, same-dimension values are OR"},{"name":"status","type":"string[]","required":false,"description":"Job state; repeatable, with same-dimension values combined by OR. Values: empty, running, success, partial_success, failed, canceled, unknown","constraints":"empty|running|success|partial_success|failed|canceled|unknown; repeatable, same-dimension values are OR"},{"name":"tag","type":"string[]","required":false,"description":"Color tag ID; repeatable, with same-dimension values combined by AND. Values: default-tag-1, default-tag-2, default-tag-3, default-tag-4, default-tag-5","constraints":"default-tag-1|default-tag-2|default-tag-3|default-tag-4|default-tag-5; max 5; omit unless the user explicitly asks for color labels; repeatable; same-dimension values are AND"},{"name":"limit","type":"integer","required":false,"default":"50","description":"Items per page, from 1 through 50","constraints":"1..50"},{"name":"offset","type":"integer","required":false,"default":"0","description":"Filtered offset from 0 through 1000; pages do not share a draft snapshot","constraints":"0..1000; pages do not share a draft snapshot"}],"successData":{"type":"object","fields":[{"name":"projectId","type":"string"},{"name":"items","type":"array<object>","fields":[{"name":"nodeId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"title","type":"string","optional":true},{"name":"tags","type":"array<string>"}]},{"name":"draftVersion","type":"integer"},{"name":"total","type":"integer"},{"name":"hasMore","type":"boolean"},{"name":"offset","type":"integer"}]}},{"name":"quote","summary":"Estimate credits for the specified nodes before running them","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID, also used as draft-id; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string[]","required":true,"description":"node_id values to estimate; repeatable"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"items","type":"array<object>","fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"nodeId","type":"string"},{"name":"maxCredits","type":"integer","optional":true},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]},{"name":"totalMaxCredits","type":"integer"},{"name":"draftVersion","type":"integer"},{"name":"confirmable","type":"boolean","optional":true},{"name":"confirmationRequired","type":"boolean","optional":true}]}},{"name":"confirm","summary":"Approve a credit ceiling for the specified nodes and return a short-lived token","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID, also used as draft-id; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string[]","required":true,"description":"node_id values to approve; repeatable"},{"name":"credit-ceiling","type":"integer","required":true,"description":"Approved credit ceiling; no token is issued when it is below the latest service estimate","constraints":">=0; must cover the latest service estimate"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"creditConfirmationToken","type":"string"},{"name":"creditCeiling","type":"integer"},{"name":"expiresAt","type":"string"}]}},{"name":"run","summary":"Run the specified nodes","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13,20],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID, also used as draft-id; omit to use the current project","constraints":"UUID"},{"name":"node-id","type":"string[]","required":true,"description":"node_id values to run; repeatable"},{"name":"submit-id","type":"string[]","required":false,"description":"Stable per-node submission UUIDs; repeatable and ordered with --node-id; generated when all are omitted","constraints":"UUID; optional; count must equal node-id count; each value is also the operation status/wait reference"},{"name":"credit-token","type":"string","required":false,"description":"creditConfirmationToken returned after credit approval","constraints":"creditConfirmationToken issued by node confirm"}],"successData":{"type":"object","fields":[{"name":"consumptionSubject","type":"object","optional":true,"fields":[{"name":"kind","type":"string"},{"name":"userId","type":"string"}]},{"name":"items","type":"array<object>","fields":[{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"nodeId","type":"string"},{"name":"submitId","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string","optional":true},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]}]},{"name":"error","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"generationDiff","type":"array<object>","optional":true,"fields":[{"name":"fieldPath","type":"string"},{"name":"from","type":"string","optional":true},{"name":"to","type":"string"}]}]}]}}]},{"name":"workflow","summary":"Canvas workflow quotes, runs, and templates","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"subcommands":[{"name":"capabilities","summary":"Show workflow capabilities and limits (read-only)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"project-id","type":"string","required":true,"description":"Project UUID","constraints":"UUID"}],"successData":{"type":"object","fields":[{"name":"enabled","type":"boolean"},{"name":"planSchemaVersions","type":"array<integer>"},{"name":"generationCapabilities","type":"array<string>"},{"name":"postEditOperations","type":"array<string>"},{"name":"limits","type":"object","fields":[{"name":"userActiveRuns","type":"integer"},{"name":"comboConcurrency","type":"integer"},{"name":"stepConcurrency","type":"integer"},{"name":"rootMaxInFlightSteps","type":"integer"},{"name":"maxCombos","type":"integer"},{"name":"maxStepsPerCombo","type":"integer"},{"name":"stepTimeoutSeconds","type":"integer"},{"name":"runTimeoutSeconds","type":"integer"}]},{"name":"templateVisibilityOptions","type":"array<string>"}]}},{"name":"quote","summary":"Save a quote plan without running the workflow or charging credits","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"request-id","type":"string","required":false,"description":"Idempotent request UUID; generated when omitted","constraints":"UUID; optional; idempotency key generated when omitted"},{"name":"project-id","type":"string","required":true,"description":"Target project UUID","constraints":"UUID"},{"name":"source","type":"string","required":true,"description":"Workflow source: group|template|retry; exactly one","constraints":"group|template|retry; exactly one source"},{"name":"run-kind","type":"string","required":false,"default":"normal","description":"normal|trial|batch|retry","constraints":"normal|trial|batch|retry"},{"name":"group-node-id","type":"string","required":false,"description":"Required with source=group: --group-node-id value","constraints":"required with source=group"},{"name":"expected-draft-version","type":"integer","required":false,"description":"Required with source=group: expected draft version","constraints":"positive integer; required with source=group"},{"name":"definition-revision","type":"integer","required":false,"description":"Group definition revision; optional positive integer","constraints":"positive integer; optional with source=group"},{"name":"template-id","type":"string","required":false,"description":"Required with source=template: template ID","constraints":"required with source=template"},{"name":"template-version","type":"integer","required":false,"description":"Required with source=template: template version","constraints":"positive integer; required with source=template"},{"name":"run-id","type":"string","required":false,"description":"Required with source=retry: retried run ID","constraints":"required with source=retry; the retried run"},{"name":"selected-combo-ids","type":"string[]","required":false,"description":"With source=retry: combo IDs to retry; repeatable","constraints":"optional with source=retry; repeatable; one ID per occurrence"},{"name":"selected-step-ids","type":"string[]","required":false,"description":"With source=retry: step IDs to retry; repeatable","constraints":"optional with source=retry; repeatable; one ID per occurrence"},{"name":"completed-trial-run-id","type":"string","required":false,"description":"Trial run ID when continuing remaining combos after a trial","constraints":"trial run id when continuing remaining combos after a trial"},{"name":"combos-file","type":"string","required":false,"description":"JSON file of combo variables; - reads stdin","constraints":"JSON file path or - for stdin; at most 1 MiB","fileContent":{"type":"object","fields":[{"name":"combos","type":"array<object>","fields":[{"name":"comboId","type":"string"},{"name":"variableValues","type":"array<object>","fields":[{"name":"variableId","type":"string","constraints":"use an ID declared by the selected workflow/template variable definition"},{"name":"valueType","type":"string","enum":["text","number","enum","material"]},{"name":"textValue","type":"string","optional":true,"constraints":"required when valueType=text|enum; enum must use a declared option"},{"name":"numberValue","type":"number","optional":true,"constraints":"required when valueType=number; finite JSON number"},{"name":"materialValue","type":"object","optional":true,"fields":[{"name":"nodeId","type":"string"},{"name":"slotId","type":"string"},{"name":"resourceId","type":"string"},{"name":"sourceProjectId","type":"string","optional":true,"constraints":"source project containing the resource; omit to use the target project"}],"constraints":"required when valueType=material; use accessible resource and template node/slot bindings"}]}]}]},"fileExample":{"combos":[{"comboId":"combo-1","variableValues":[{"variableId":"var-text","valueType":"text","textValue":"A ceramic fox"},{"variableId":"var-number","valueType":"number","numberValue":2},{"variableId":"var-enum","valueType":"enum","textValue":"watercolor"},{"variableId":"var-material","valueType":"material","materialValue":{"nodeId":"node-image","slotId":"reference","resourceId":"resource_123","sourceProjectId":"00000000-0000-4000-8000-000000000001"}}]}]}},{"name":"from-node-ids","type":"string[]","required":false,"description":"Restrict execution to these nodes and their dependents; repeatable","constraints":"repeatable; one Node ID per occurrence; restricts execution to these and their dependents"},{"name":"reuse-unchanged","type":"boolean","required":false,"default":"false","description":"Reuse existing outputs of unchanged nodes"}],"successData":{"type":"object","fields":[{"name":"planId","type":"string"},{"name":"quoteId","type":"string"},{"name":"planDigest","type":"string"},{"name":"expiresAtMs","type":"integer"},{"name":"comboQuotes","type":"array<object>","fields":[{"name":"comboId","type":"string"},{"name":"executionDigest","type":"string"},{"name":"nodeQuotes","type":"array<object>","fields":[{"name":"nodeId","type":"string"},{"name":"executable","type":"boolean"},{"name":"blockedReason","type":"string","optional":true},{"name":"blockedDetail","type":"string","optional":true},{"name":"maxCredits","type":"integer","optional":true},{"name":"reused","type":"boolean"},{"name":"reusedResourceId","type":"string","optional":true},{"name":"isFinal","type":"boolean"},{"name":"skipped","type":"boolean","optional":true}]},{"name":"comboMaxCredits","type":"integer"},{"name":"finalOutputCount","type":"integer"},{"name":"reusedResultGroupId","type":"string","optional":true},{"name":"reusedFinalResourceIds","type":"array<string>","optional":true}]},{"name":"totalMaxCredits","type":"integer"},{"name":"finalOutputCount","type":"integer"},{"name":"confirmationRequired","type":"boolean"},{"name":"canStart","type":"boolean"},{"name":"snapshotDraftVersion","type":"integer"},{"name":"definitionRevision","type":"integer"}]}},{"name":"confirm","summary":"Approve a quote ceiling and get a short-lived confirmation token (write)","reads":false,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13],"flags":[{"name":"request-id","type":"string","required":false,"description":"Idempotent request UUID; generated when omitted","constraints":"UUID; generated when omitted"},{"name":"quote-id","type":"string","required":true,"description":"quoteId returned by workflow quote"},{"name":"max-credits","type":"integer","required":true,"description":"Approved credit ceiling; at least the quote totalMaxCredits","constraints":">0; must cover the quote totalMaxCredits"}],"successData":{"type":"object","fields":[{"name":"creditConfirmationToken","type":"string"},{"name":"expiresAtMs","type":"integer"}]}},{"name":"run","summary":"Start a workflow run (write; replay with the same submitId to resume)","reads":false,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,10,11,1,13],"flags":[{"name":"submit-id","type":"string","required":false,"description":"Stable operation UUID; generated when omitted; reuse the same value to resume","constraints":"UUID; generated when omitted; reuse the same value to resume"},{"name":"quote-id","type":"string","required":true,"description":"quoteId returned by workflow quote"},{"name":"credit-confirmation-token","type":"string","required":false,"description":"Token from workflow confirm; required when the quote demands confirmation","constraints":"token from workflow confirm; required when the quote demands confirmation"}],"successData":{"type":"object","fields":[{"name":"rootRunId","type":"string"},{"name":"status","type":"string"},{"name":"comboRunIds","type":"array<string>"},{"name":"planDigest","type":"string"},{"name":"submitId","type":"string"}]}},{"name":"get","summary":"Show the full view of a workflow run (read-only)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"arguments":[{"name":"run-id","required":true}],"flags":null,"successData":{"type":"object","fields":[{"name":"runId","type":"string"},{"name":"rootRunId","type":"string"},{"name":"parentRunId","type":"string","optional":true},{"name":"comboId","type":"string","optional":true},{"name":"targetProjectId","type":"string"},{"name":"sourceGroupId","type":"string","optional":true},{"name":"targetGroupId","type":"string","optional":true},{"name":"kind","type":"string"},{"name":"status","type":"string"},{"name":"executionCleanup","type":"string"},{"name":"settlementStatus","type":"string"},{"name":"runVersion","type":"integer"},{"name":"inFlight","type":"integer"},{"name":"steps","type":"array<object>","fields":[{"name":"stepId","type":"string"},{"name":"nodeId","type":"string"},{"name":"dependencyStepIds","type":"array<string>"},{"name":"isFinal","type":"boolean"},{"name":"state","type":"string"},{"name":"resourceId","type":"string","optional":true},{"name":"reusedResourceId","type":"string","optional":true},{"name":"inFlight","type":"boolean"},{"name":"errorCode","type":"integer","optional":true},{"name":"errorDetail","type":"string","optional":true},{"name":"writebackStatus","type":"string","optional":true},{"name":"actualCredits","type":"integer","optional":true}]},{"name":"finalOutputs","type":"array<object>","fields":[{"name":"comboId","type":"string"},{"name":"stepId","type":"string"},{"name":"nodeId","type":"string"},{"name":"resourceId","type":"string"}]},{"name":"createdAtMs","type":"integer"},{"name":"finishedAtMs","type":"integer","optional":true},{"name":"settledCredits","type":"integer"},{"name":"refundedCredits","type":"integer"},{"name":"pendingCredits","type":"integer"},{"name":"childRuns","type":"array<object>","optional":true},{"name":"controlState","type":"string","optional":true},{"name":"pauseReason","type":"string","optional":true}]}},{"name":"wait","summary":"Wait for a terminal workflow run; exit 20 on timeout, rerun to resume waiting","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,20],"arguments":[{"name":"run-id","required":true}],"flags":[{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum wait; 0 queries once and exits 20 if not terminal","constraints":"0 queries once; on timeout exit 20 with operationRef=runId"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval"}],"successData":{"type":"object","fields":[{"name":"runId","type":"string"},{"name":"rootRunId","type":"string"},{"name":"parentRunId","type":"string","optional":true},{"name":"comboId","type":"string","optional":true},{"name":"targetProjectId","type":"string"},{"name":"sourceGroupId","type":"string","optional":true},{"name":"targetGroupId","type":"string","optional":true},{"name":"kind","type":"string"},{"name":"status","type":"string"},{"name":"executionCleanup","type":"string"},{"name":"settlementStatus","type":"string"},{"name":"runVersion","type":"integer"},{"name":"inFlight","type":"integer"},{"name":"steps","type":"array<object>","fields":[{"name":"stepId","type":"string"},{"name":"nodeId","type":"string"},{"name":"dependencyStepIds","type":"array<string>"},{"name":"isFinal","type":"boolean"},{"name":"state","type":"string"},{"name":"resourceId","type":"string","optional":true},{"name":"reusedResourceId","type":"string","optional":true},{"name":"inFlight","type":"boolean"},{"name":"errorCode","type":"integer","optional":true},{"name":"errorDetail","type":"string","optional":true},{"name":"writebackStatus","type":"string","optional":true},{"name":"actualCredits","type":"integer","optional":true}]},{"name":"finalOutputs","type":"array<object>","fields":[{"name":"comboId","type":"string"},{"name":"stepId","type":"string"},{"name":"nodeId","type":"string"},{"name":"resourceId","type":"string"}]},{"name":"createdAtMs","type":"integer"},{"name":"finishedAtMs","type":"integer","optional":true},{"name":"settledCredits","type":"integer"},{"name":"refundedCredits","type":"integer"},{"name":"pendingCredits","type":"integer"},{"name":"childRuns","type":"array<object>","optional":true},{"name":"controlState","type":"string","optional":true},{"name":"pauseReason","type":"string","optional":true}]}},{"name":"list","summary":"List workflow runs in a project (read-only)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"project-id","type":"string","required":true,"description":"Project UUID","constraints":"UUID"},{"name":"group-node-id","type":"string","required":false,"description":"Restrict to one group node"},{"name":"cursor","type":"string","required":false,"description":"nextCursor from the previous page","constraints":"opaque nextCursor from the previous page"},{"name":"limit","type":"integer","required":false,"description":"Page size, 1..100","constraints":"1..100"}],"successData":{"type":"object","fields":[{"name":"runs","type":"array<object>","fields":[{"name":"runId","type":"string"},{"name":"rootRunId","type":"string"},{"name":"kind","type":"string"},{"name":"status","type":"string"},{"name":"executionCleanup","type":"string"},{"name":"settlementStatus","type":"string"},{"name":"groupNodeId","type":"string","optional":true},{"name":"targetGroupId","type":"string","optional":true},{"name":"createdAtMs","type":"integer"},{"name":"finalOutputCount","type":"integer"}]},{"name":"nextCursor","type":"string","optional":true}]}},{"name":"cancel","summary":"Request cancellation of a workflow run (write)","reads":false,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"arguments":[{"name":"run-id","required":true}],"flags":[{"name":"request-id","type":"string","required":false,"description":"Idempotent request UUID; generated when omitted","constraints":"UUID; generated when omitted"}],"successData":{"type":"object","fields":[{"name":"status","type":"string"},{"name":"inFlight","type":"integer"}]}},{"name":"template","summary":"Workflow template discovery and instantiation","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"subcommands":[{"name":"list","summary":"List visible workflow templates (read-only)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"scope","type":"string","required":false,"default":"mine","description":"mine|recent","constraints":"mine|recent"},{"name":"cursor","type":"string","required":false,"description":"nextCursor from the previous page","constraints":"opaque nextCursor from the previous page"},{"name":"limit","type":"integer","required":false,"description":"Page size, 1..100","constraints":"1..100"}],"successData":{"type":"object","fields":[{"name":"templates","type":"array<object>","fields":[{"name":"templateId","type":"string"},{"name":"latestVersion","type":"integer"},{"name":"name","type":"string"},{"name":"description","type":"string","optional":true},{"name":"updatedAtMs","type":"integer"},{"name":"inputSlots","type":"array<object>","fields":[{"name":"nodeId","type":"string"},{"name":"slotId","type":"string"},{"name":"mediaConstraint","type":"string"},{"name":"label","type":"string"},{"name":"required","type":"boolean"}]}]},{"name":"nextCursor","type":"string","optional":true}]}},{"name":"get","summary":"Get a template detail with variable and operation definitions (read-only)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"arguments":[{"name":"template-id","required":true}],"flags":[{"name":"version","type":"integer","required":false,"description":"Template version; defaults to latest","constraints":"positive integer; defaults to latest"}],"successData":{"type":"object","fields":[{"name":"templateId","type":"string"},{"name":"version","type":"integer"},{"name":"name","type":"string"},{"name":"description","type":"string","optional":true},{"name":"variablesJson","type":"string"},{"name":"operationDefinitionsJson","type":"string"},{"name":"inputSlots","type":"array<object>","fields":[{"name":"nodeId","type":"string"},{"name":"slotId","type":"string"},{"name":"mediaConstraint","type":"string"},{"name":"label","type":"string"},{"name":"required","type":"boolean"}]},{"name":"snapshotDigest","type":"string"}]}},{"name":"instantiate","summary":"Instantiate a template into a target project (write)","reads":false,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"request-id","type":"string","required":false,"description":"Idempotent request UUID; generated when omitted","constraints":"UUID; generated when omitted"},{"name":"template-id","type":"string","required":true,"description":"Template ID"},{"name":"version","type":"integer","required":true,"description":"Template version","constraints":"positive integer"},{"name":"target-project-id","type":"string","required":true,"description":"Target project UUID","constraints":"UUID"},{"name":"anchor-x","type":"number","required":false,"default":"0","description":"Placement anchor X","constraints":"finite"},{"name":"anchor-y","type":"number","required":false,"default":"0","description":"Placement anchor Y","constraints":"finite"},{"name":"variables-file","type":"string","required":false,"description":"JSON file of variable values; - reads stdin","constraints":"JSON file path or - for stdin; at most 1 MiB","fileContent":{"type":"object","fields":[{"name":"variableValues","type":"array<object>","fields":[{"name":"variableId","type":"string","constraints":"use an ID declared by the selected workflow/template variable definition"},{"name":"valueType","type":"string","enum":["text","number","enum","material"]},{"name":"textValue","type":"string","optional":true,"constraints":"required when valueType=text|enum; enum must use a declared option"},{"name":"numberValue","type":"number","optional":true,"constraints":"required when valueType=number; finite JSON number"},{"name":"materialValue","type":"object","optional":true,"fields":[{"name":"nodeId","type":"string"},{"name":"slotId","type":"string"},{"name":"resourceId","type":"string"},{"name":"sourceProjectId","type":"string","optional":true,"constraints":"source project containing the resource; omit to use the target project"}],"constraints":"required when valueType=material; use accessible resource and template node/slot bindings"}]}]},"fileExample":{"variableValues":[{"variableId":"var-text","valueType":"text","textValue":"A ceramic fox"},{"variableId":"var-number","valueType":"number","numberValue":2},{"variableId":"var-enum","valueType":"enum","textValue":"watercolor"},{"variableId":"var-material","valueType":"material","materialValue":{"nodeId":"node-image","slotId":"reference","resourceId":"resource_123","sourceProjectId":"00000000-0000-4000-8000-000000000001"}}]}}],"successData":{"type":"object","fields":[{"name":"instantiateId","type":"string"},{"name":"state","type":"string"}]}},{"name":"instantiation","summary":"Get template instantiation progress and node mapping (read-only)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"arguments":[{"name":"instantiate-id","required":true}],"flags":null,"successData":{"type":"object","fields":[{"name":"state","type":"string"},{"name":"reconcileReason","type":"string","optional":true},{"name":"groupMappings","type":"array<object>","fields":[{"name":"relativeGroupId","type":"string"},{"name":"groupId","type":"string"},{"name":"nodeIdMapping","type":"map<string,string>"}]},{"name":"definitionRevision","type":"integer","optional":true}]}}]}]},{"name":"operation","summary":"Inspect or wait for recoverable operations","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,20],"flags":[],"subcommands":[{"name":"status","summary":"Query a generation operation once","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,20],"arguments":[{"name":"operation-ref","required":true,"constraints":"UUID; same value as a node run submitId"}],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; needed only when the local recovery record is missing and the service must be queried directly","constraints":"UUID; only needed when the local recovery record is gone"}],"successData":{"type":"object","fields":[{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string"},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"submissionOutcome","type":"string","optional":true},{"name":"submission","type":"object","optional":true,"fields":[{"name":"state","type":"string"},{"name":"resubmittable","type":"boolean"}]},{"name":"submissionError","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"awaitingConfirmation","type":"object","optional":true,"fields":[{"name":"nodeId","type":"string"},{"name":"totalMaxCredits","type":"integer"},{"name":"quotedAtMs","type":"integer"}]}]}},{"name":"wait","summary":"Wait for a generation operation to reach a terminal state","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,20],"arguments":[{"name":"operation-ref","required":true,"constraints":"UUID; same value as a node run submitId"}],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; needed only when the local recovery record is missing and the service must be queried directly","constraints":"UUID; only needed when the local recovery record is gone"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum wait duration; 0 queries once"},{"name":"interval","type":"duration","required":false,"default":"5s","description":"Polling interval"}],"successData":{"type":"object","fields":[{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string"},{"name":"state","type":"string"},{"name":"resources","type":"array<object>","fields":[{"name":"resourceId","type":"string"},{"name":"state","type":"string"},{"name":"serviceCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"submissionOutcome","type":"string","optional":true},{"name":"submission","type":"object","optional":true,"fields":[{"name":"state","type":"string"},{"name":"resubmittable","type":"boolean"}]},{"name":"submissionError","type":"object","optional":true,"fields":[{"name":"code","type":"integer"},{"name":"message","type":"string"},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"preflight","type":"object","optional":true,"fields":[{"name":"status","type":"string"},{"name":"sourceResourceId","type":"string","optional":true},{"name":"observedAtMs","type":"integer"},{"name":"actual","type":"object","optional":true,"fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]}]},{"name":"requested","type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"mode","type":"string"},{"name":"resolution","type":"string","optional":true},{"name":"detail","type":"integer","optional":true}]},{"name":"resolution","type":"string","optional":true},{"name":"fps","type":"integer","optional":true}]},{"name":"constraints","type":"object","optional":true,"fields":[{"name":"maxWidth","type":"integer","optional":true},{"name":"maxHeight","type":"integer","optional":true},{"name":"maxDurationSeconds","type":"number","optional":true},{"name":"maxFrameCount","type":"number","optional":true},{"name":"targetFpsMustExceed","type":"number","optional":true},{"name":"targetLongEdgeMustExceed","type":"integer","optional":true}]},{"name":"eligibleResolutions","type":"array<string>","optional":true},{"name":"eligibleFps","type":"array<integer>","optional":true},{"name":"missingFields","type":"array<string>","optional":true}]},{"name":"reason","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"resourceId","type":"string","optional":true},{"name":"localStorage","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"operationRef","type":"string","optional":true}]},{"name":"awaitingConfirmation","type":"object","optional":true,"fields":[{"name":"nodeId","type":"string"},{"name":"totalMaxCredits","type":"integer"},{"name":"quotedAtMs","type":"integer"}]}]}}]},{"name":"resource","summary":"Query, upload, and download canvas resources","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"subcommands":[{"name":"download","summary":"Safely download a successful image resource","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"arguments":[{"name":"resource-id","required":true}],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"},{"name":"output","type":"string","required":false,"default":".","description":"Output file (used verbatim; no transcoding) or existing directory (uses the service-provided file name)"}],"successData":{"type":"object","fields":[{"name":"resourceId","type":"string"},{"name":"path","type":"string"},{"name":"size","type":"integer"},{"name":"sha256","type":"string"}]}},{"name":"get","summary":"Read stable resource facts in any state (running/success/failed/canceled)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"arguments":[{"name":"resource-id","required":true}],"flags":[{"name":"project-id","type":"string","required":false,"description":"Project UUID; omit to use the current project","constraints":"UUID"}],"successData":{"type":"object","fields":[{"name":"image","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"format","type":"string","optional":true}]},{"name":"video","type":"object","optional":true,"fields":[{"name":"width","type":"integer","optional":true},{"name":"height","type":"integer","optional":true},{"name":"durationSeconds","type":"number","optional":true},{"name":"fps","type":"number","optional":true},{"name":"effectiveFps","type":"number","optional":true},{"name":"resolution","type":"string","optional":true}]},{"name":"generationKind","type":"string","optional":true},{"name":"resourceId","type":"string"},{"name":"type","type":"string"},{"name":"status","type":"string"},{"name":"name","type":"string","optional":true},{"name":"createdAt","type":"integer","optional":true},{"name":"errorCode","type":"integer","optional":true},{"name":"message","type":"string","optional":true},{"name":"diagnostics","type":"array<object>","optional":true,"fields":[{"name":"detail","type":"string"},{"name":"suggestion","type":"string","optional":true}]},{"name":"creditsAmount","type":"integer","optional":true},{"name":"source","type":"string","optional":true}]}},{"name":"upload","summary":"Upload local image, video, or audio media and register it as a project resource","reads":false,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[{"name":"file","type":"string","required":false,"description":"Local image, video, or audio file path; mutually exclusive with --source-url","constraints":"mutually exclusive with source-url"},{"name":"type","type":"string","required":false,"description":"Media type override: image, video, or audio; omit to infer it from the extension","constraints":"image|video|audio; overrides file extension"},{"name":"source-url","type":"string","required":false,"description":"Image URL accessible to the service; mutually exclusive with --file (images only)","constraints":"image only; mutually exclusive with file"},{"name":"project-id","type":"string","required":true,"description":"Target project UUID; required, including when resource-id is supplied","constraints":"UUID; explicit target project required"},{"name":"resource-id","type":"string","required":false,"description":"Resource ID idempotency key; generated when omitted and reused for retries across processes","constraints":"UUID idempotency key; generated when omitted; always echoed as resourceId"},{"name":"name","type":"string","required":false,"description":"Resource display name; omit to use the file name"},{"name":"import-kind","type":"string","required":false,"description":"Registration intent: local_upload (default) or external_generated (output imported from another platform)","constraints":"local_upload | external_generated"}],"constraints":[{"atLeastOneOf":["file","source-url"]}],"successData":{"type":"object","fields":[{"name":"resourceId","type":"string"},{"name":"mediaType","type":"string"}]}}]},{"name":"director","summary":"Author, synchronize and export Director Stage projects","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13,20],"flags":[],"detailCommand":"dreamina-canvas schema director"},{"name":"canvas","summary":"Manage canvases","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13,20],"flags":[],"subcommands":[{"name":"create","summary":"Create a canvas","reads":false,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13,20],"arguments":[{"name":"name","required":true}],"flags":[{"name":"project-id","type":"string","required":false,"description":"Client-generated canvas UUID; reuse the same value when retrying","constraints":"UUID"},{"name":"use","type":"boolean","required":false,"default":"false","description":"Set the new canvas as current"}],"successData":{"type":"object","fields":[{"name":"localStorageWarning","type":"object","optional":true,"fields":[{"name":"store","type":"string"},{"name":"stage","type":"string"},{"name":"reason","type":"string"},{"name":"directory","type":"string","optional":true},{"name":"systemCode","type":"string","optional":true},{"name":"projectId","type":"string","optional":true},{"name":"submissionPhase","type":"string","optional":true}]},{"name":"project","type":"object","fields":[{"name":"projectId","type":"string"},{"name":"name","type":"string"},{"name":"createdAt","type":"integer"},{"name":"updatedAt","type":"integer"},{"name":"webUrl","type":"string"}]},{"name":"draftVersion","type":"integer"},{"name":"current","type":"boolean"}]}},{"name":"ls","summary":"List accessible canvases with locator fields only (projectId/name/createdAt/updatedAt/webUrl)","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[{"name":"limit","type":"integer","required":false,"default":"50","description":"Items per page, from 1 through 100","constraints":"1..100"},{"name":"cursor","type":"string","required":false,"description":"Opaque nextCursor from the previous page; omit for the first page and do not construct or parse it","constraints":"opaque nextCursor from the previous page; do not construct or parse"}],"successData":{"type":"object","fields":[{"name":"items","type":"array<object>","fields":[{"name":"projectId","type":"string"},{"name":"name","type":"string"},{"name":"createdAt","type":"integer"},{"name":"updatedAt","type":"integer"},{"name":"webUrl","type":"string"}]},{"name":"nextCursor","type":"string","optional":true},{"name":"hasMore","type":"boolean"}]}},{"name":"use","summary":"Verify access and select the current canvas","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"arguments":[{"name":"project-id","required":true,"constraints":"canvas ID; must belong to the selected space"}],"flags":[],"successData":{"type":"object","fields":[{"name":"userId","type":"string"},{"name":"currentCanvas","type":"object","optional":true,"fields":[{"name":"canvas","type":"object","fields":[{"name":"projectId","type":"string"},{"name":"name","type":"string"},{"name":"createdAt","type":"integer"},{"name":"updatedAt","type":"integer"},{"name":"webUrl","type":"string"}]},{"name":"permissions","type":"object","fields":[{"name":"canRead","type":"boolean"},{"name":"canEdit","type":"boolean"},{"name":"canManage","type":"boolean"},{"name":"canCopy","type":"boolean"}]}]},{"name":"checkedAt","type":"integer"}]}},{"name":"current","summary":"Read the current canvas and its permissions","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1,13],"flags":[],"successData":{"type":"object","fields":[{"name":"userId","type":"string"},{"name":"currentCanvas","type":"object","optional":true,"fields":[{"name":"canvas","type":"object","fields":[{"name":"projectId","type":"string"},{"name":"name","type":"string"},{"name":"createdAt","type":"integer"},{"name":"updatedAt","type":"integer"},{"name":"webUrl","type":"string"}]},{"name":"permissions","type":"object","fields":[{"name":"canRead","type":"boolean"},{"name":"canEdit","type":"boolean"},{"name":"canManage","type":"boolean"},{"name":"canCopy","type":"boolean"}]}]},{"name":"checkedAt","type":"integer"}]}}]},{"name":"auth","summary":"Manage sign-in and authentication state","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,1,11,20],"flags":[],"subcommands":[{"name":"account","summary":"Read the current service-authenticated account","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[],"successData":{"type":"object","fields":[{"name":"displayName","type":"string","optional":true},{"name":"availableCredits","type":"string","optional":true},{"name":"credits","type":"object","optional":true,"fields":[{"name":"available","type":"string"},{"name":"details","type":"array<object>","optional":true,"fields":[{"name":"available","type":"string"},{"name":"expiresAt","type":"string"}]}]},{"name":"userId","type":"integer"},{"name":"isVip","type":"boolean","optional":true},{"name":"vipLevelStartsAt","type":"string","optional":true},{"name":"vipLevelExpiresAt","type":"string","optional":true},{"name":"vipLevel","type":"string","optional":true}]}},{"name":"login","summary":"Start device authorization sign-in","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,1,11,20],"flags":[{"name":"force","type":"boolean","required":false,"default":"false","description":"Clear the current profile's sign-in state and authorize again"}],"successData":{"type":"object","fields":[{"name":"status","type":"string"},{"name":"state","type":"object","optional":true,"fields":[{"name":"loggedIn","type":"boolean"},{"name":"expiresAt","type":"string","optional":true},{"name":"credentialStorage","type":"string","optional":true}]},{"name":"challenge","type":"object","optional":true,"fields":[{"name":"deviceCode","type":"string"},{"name":"userCode","type":"string"},{"name":"verificationUri","type":"string"},{"name":"verificationUriComplete","type":"string","optional":true},{"name":"pollSeconds","type":"integer"},{"name":"expiresAt","type":"string","optional":true}]},{"name":"profile","type":"string"},{"name":"region","type":"string"},{"name":"environment","type":"string"},{"name":"authMode","type":"string"},{"name":"distribution","type":"string"},{"name":"version","type":"string"},{"name":"edition","type":"string"}]}},{"name":"logout","summary":"Clear local sign-in state for the current profile","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,1],"flags":[],"successData":{"type":"object","fields":[{"name":"loggedOut","type":"boolean"}]}},{"name":"status","summary":"Read local sign-in state","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,1],"flags":[],"successData":{"type":"object","fields":[{"name":"loggedIn","type":"boolean"},{"name":"expiresAt","type":"string","optional":true},{"name":"credentialStorage","type":"string","optional":true},{"name":"profile","type":"string"},{"name":"region","type":"string"},{"name":"environment","type":"string"},{"name":"authMode","type":"string"},{"name":"distribution","type":"string"},{"name":"version","type":"string"},{"name":"edition","type":"string"}]}},{"name":"wait","summary":"Wait for an existing device authorization","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,1,11,20],"flags":[{"name":"device-code","type":"string","required":true,"description":"Device authorization reference returned by auth login"},{"name":"timeout","type":"duration","required":false,"default":"10m","description":"Maximum time to wait for sign-in"}],"successData":{"type":"object","fields":[{"name":"status","type":"string"},{"name":"state","type":"object","optional":true,"fields":[{"name":"loggedIn","type":"boolean"},{"name":"expiresAt","type":"string","optional":true},{"name":"credentialStorage","type":"string","optional":true}]},{"name":"challenge","type":"object","optional":true,"fields":[{"name":"deviceCode","type":"string"},{"name":"userCode","type":"string"},{"name":"verificationUri","type":"string"},{"name":"verificationUriComplete","type":"string","optional":true},{"name":"pollSeconds","type":"integer"},{"name":"expiresAt","type":"string","optional":true}]},{"name":"profile","type":"string"},{"name":"region","type":"string"},{"name":"environment","type":"string"},{"name":"authMode","type":"string"},{"name":"distribution","type":"string"},{"name":"version","type":"string"},{"name":"edition","type":"string"}]}},{"name":"refresh","summary":"Refresh the current sign-in credentials","reads":true,"writes":true,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,11,1],"flags":[],"successData":{"type":"object","fields":[{"name":"loggedIn","type":"boolean"},{"name":"expiresAt","type":"string","optional":true},{"name":"credentialStorage","type":"string","optional":true},{"name":"profile","type":"string"},{"name":"region","type":"string"},{"name":"environment","type":"string"},{"name":"authMode","type":"string"},{"name":"distribution","type":"string"},{"name":"version","type":"string"},{"name":"edition","type":"string"}]}}]},{"name":"schema","summary":"Return the command contract for this artifact","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,1],"flags":[],"successData":{"type":"object","fields":[{"name":"schemaVersion","type":"string"},{"name":"edition","type":"string"},{"name":"distribution","type":"string"},{"name":"locale","type":"string"},{"name":"command","type":"string"},{"name":"globalFlags","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"type","type":"string"},{"name":"required","type":"boolean"},{"name":"default","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"constraints","type":"string","optional":true},{"name":"fileContent","type":"object","optional":true,"fields":[{"name":"type","type":"string"},{"name":"fields","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"type","type":"string"},{"name":"optional","type":"boolean","optional":true},{"name":"fields","type":"array<object>","optional":true},{"name":"enum","type":"array<string>","optional":true},{"name":"constraints","type":"string","optional":true}]}]},{"name":"fileExample","type":"raw","optional":true}]},{"name":"subcommands","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"summary","type":"string"},{"name":"reads","type":"boolean"},{"name":"writes","type":"boolean"},{"name":"formats","type":"array<string>"},{"name":"dryRun","type":"boolean","optional":true},{"name":"confirmation","type":"boolean"},{"name":"declaredExitCodes","type":"array<integer>"},{"name":"arguments","type":"array<object>","optional":true,"fields":[{"name":"name","type":"string"},{"name":"required","type":"boolean"},{"name":"repeatable","type":"boolean","optional":true},{"name":"constraints","type":"string","optional":true}]},{"name":"flags","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"type","type":"string"},{"name":"required","type":"boolean"},{"name":"default","type":"string","optional":true},{"name":"description","type":"string","optional":true},{"name":"constraints","type":"string","optional":true},{"name":"fileContent","type":"object","optional":true,"fields":[{"name":"type","type":"string"},{"name":"fields","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"type","type":"string"},{"name":"optional","type":"boolean","optional":true},{"name":"fields","type":"array<object>","optional":true},{"name":"enum","type":"array<string>","optional":true},{"name":"constraints","type":"string","optional":true}]}]},{"name":"fileExample","type":"raw","optional":true}]},{"name":"constraints","type":"array<object>","optional":true,"fields":[{"name":"atLeastOneOf","type":"array<string>","optional":true}]},{"name":"successData","type":"object","optional":true,"fields":[{"name":"type","type":"string"},{"name":"fields","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"type","type":"string"},{"name":"optional","type":"boolean","optional":true},{"name":"fields","type":"array<object>","optional":true},{"name":"enum","type":"array<string>","optional":true},{"name":"constraints","type":"string","optional":true}]}]},{"name":"dryRunData","type":"object","optional":true,"fields":[{"name":"type","type":"string"},{"name":"fields","type":"array<object>","fields":[{"name":"name","type":"string"},{"name":"type","type":"string"},{"name":"optional","type":"boolean","optional":true},{"name":"fields","type":"array<object>","optional":true},{"name":"enum","type":"array<string>","optional":true},{"name":"constraints","type":"string","optional":true}]}]},{"name":"subcommands","type":"array<object>","optional":true},{"name":"detailCommand","type":"string","optional":true}]}]}},{"name":"version","summary":"Return version and build information","reads":true,"writes":false,"formats":["json","table"],"confirmation":false,"declaredExitCodes":[0,2,1],"flags":[],"successData":{"type":"object","fields":[{"name":"version","type":"string"},{"name":"commit","type":"string"},{"name":"buildTime","type":"string"},{"name":"edition","type":"string"},{"name":"distribution","type":"string"},{"name":"releaseDate","type":"string","optional":true},{"name":"releaseNotes","type":"string","optional":true}]}}]}}
