{"name":"library_manage","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["browse","asset_detail","comment_add","set_review_status","import_ad_creative","upload_inline","upload_url","upload_finalize","upload_begin","upload_status","render_status","render_retry"]},"query":{"description":"Optional semantic query; with it browse ranks by meaning (offset is ignored).","type":"string","minLength":1,"maxLength":2000},"reviewStatus":{"description":"Filter by review workflow state, e.g. 'approved' for signed-off creative only.","type":"string","enum":["none","draft","in_review","needs_changes","approved"]},"kind":{"type":"string","enum":["image","video","file","audio"]},"source":{"type":"string","enum":["upload","ai_generated","backfill","canvas","inspiration","hyperframe","chat_upload","clip","reel","meta_ad","figma","goal_artifact","forge"]},"tags":{"description":"An asset matches only if it carries ALL of these tags.","minItems":1,"type":"array","items":{"type":"string","minLength":1}},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"assetId":{"type":"string","minLength":1},"window":{"description":"Metric window for the creative-DNA figures returned with the asset: 'd7' | 'd14' | 'd30' (default d30).","type":"string","enum":["d7","d14","d30"]},"creativeRowId":{"description":"paid_media.ad_creatives.id — the SYNCED creative row id (not Meta’s creative id), as returned by the paid creative-intel reads.","type":"string","minLength":1},"body":{"type":"string","minLength":1,"maxLength":5000},"annotation":{"description":"Pin the comment to the creative: {kind:\"box\",x,y,width,height} (normalized 0..1) on an image, or {kind:\"time\",timeMs,endMs?,box?} on a video. On a video, timeMs alone pins the comment to a single moment; adding endMs (must be > timeMs, both in milliseconds) pins it to the SPAN [timeMs, endMs] — use a span when the note is about a passage (\"the hook drags from 0:02 to 0:06\") rather than one frame. `box` optionally adds a region on the frame at timeMs.","oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"box"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1},"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["kind","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"point"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"shapes":{"minItems":1,"maxItems":32,"type":"array","items":{"oneOf":[{"type":"object","properties":{"tool":{"type":"string","const":"box"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["tool","color","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"tool":{"type":"string","const":"arrow"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"from":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"to":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}},"required":["tool","color","from","to"],"additionalProperties":false},{"type":"object","properties":{"tool":{"type":"string","const":"line"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"from":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"to":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}},"required":["tool","color","from","to"],"additionalProperties":false},{"type":"object","properties":{"tool":{"type":"string","const":"freehand"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"points":{"minItems":2,"maxItems":1024,"type":"array","items":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}}},"required":["tool","color","points"],"additionalProperties":false}]}},"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"orbit":{"type":"object","properties":{"azimuthDeg":{"type":"number"},"polarDeg":{"type":"number","minimum":0,"maximum":180},"distance":{"type":"number","exclusiveMinimum":0}},"required":["azimuthDeg","polarDeg"],"additionalProperties":false}},"required":["kind","x","y"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"freehand"},"points":{"minItems":2,"maxItems":1024,"type":"array","items":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}},"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["kind","points"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"time"},"timeMs":{"type":"integer","minimum":0,"maximum":9007199254740991},"endMs":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"box":{"anyOf":[{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["x","y","width","height"],"additionalProperties":false},{"type":"null"}]},"shapes":{"minItems":1,"maxItems":32,"type":"array","items":{"oneOf":[{"type":"object","properties":{"tool":{"type":"string","const":"box"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1},"width":{"type":"number","minimum":0,"maximum":1},"height":{"type":"number","minimum":0,"maximum":1}},"required":["tool","color","x","y","width","height"],"additionalProperties":false},{"type":"object","properties":{"tool":{"type":"string","const":"arrow"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"from":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"to":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}},"required":["tool","color","from","to"],"additionalProperties":false},{"type":"object","properties":{"tool":{"type":"string","const":"line"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"from":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false},"to":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}},"required":["tool","color","from","to"],"additionalProperties":false},{"type":"object","properties":{"tool":{"type":"string","const":"freehand"},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"points":{"minItems":2,"maxItems":1024,"type":"array","items":{"type":"object","properties":{"x":{"type":"number","minimum":0,"maximum":1},"y":{"type":"number","minimum":0,"maximum":1}},"required":["x","y"],"additionalProperties":false}}},"required":["tool","color","points"],"additionalProperties":false}]}}},"required":["kind","timeMs"],"additionalProperties":false}]},"parentCommentId":{"type":"string","minLength":1},"toStatus":{"type":"string","enum":["none","draft","in_review","needs_changes","approved"]},"expectedCurrentStatus":{"description":"Stale-write precondition: the review status you LAST SAW on this asset (from browse or asset_detail). If someone else has moved the asset since, the transition is rejected with CONFLICT and the current status instead of silently overwriting their decision. Omit only for a deliberately blind transition.","type":"string","enum":["none","draft","in_review","needs_changes","approved"]},"note":{"type":"string","maxLength":2000},"files":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"file_name":{"type":"string","minLength":1,"maxLength":255},"mime_type":{"type":"string","enum":["image/jpeg","image/png","image/webp","image/gif","image/avif"]},"image_base64":{"type":"string","minLength":4,"maxLength":14000000},"title":{"type":"string","minLength":1,"maxLength":500}},"required":["file_name","mime_type","image_base64"],"additionalProperties":false}},"uploads":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"file_name":{"type":"string","minLength":1,"maxLength":255},"mime_type":{"type":"string","pattern":"^[\\w.+-]+\\/[\\w.+-]+$"}},"required":["file_name","mime_type"],"additionalProperties":false}},"uploaded":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"upload_path":{"type":"string","minLength":1,"maxLength":1024},"title":{"type":"string","minLength":1,"maxLength":500}},"required":["upload_path"],"additionalProperties":false}},"max_files":{"type":"integer","minimum":1,"maximum":8},"upload_intent_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"render_job_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"operation_id":{"description":"Stable identity for this mutation. Retrying with the same operation_id replays the FIRST result instead of acting twice. import_ad_creative derives one from `creativeRowId`, so a retry of the same import is already an exact replay; comment_add is NOT deduped unless you supply one.","type":"string","minLength":1,"maxLength":128}},"required":["action"],"additionalProperties":false}}
