Uwear

{
  "type": "object",
  "$defs": {
    "BriefRun": {
      "type": "object",
      "required": [
        "automation",
        "looks",
        "steps"
      ],
      "properties": {
        "looks": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 50
        },
        "steps": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 100
        },
        "automation": {
          "type": "string",
          "maxLength": 300
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "brief_id",
    "expected_brief_revision",
    "idempotency_key",
    "expected_total_credits",
    "runs",
    "board_id"
  ],
  "properties": {
    "runs": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/BriefRun"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "What this Generate runs: each Automation, its looks and its steps, as get_brief returns them."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "brief_id": {
      "type": "integer",
      "minimum": 1
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Retry key for one Generate: never runs or charges twice."
    },
    "expected_total_credits": {
      "type": "integer",
      "minimum": 0,
      "description": "The credits this Generate charges, as get_brief returns them."
    },
    "expected_brief_revision": {
      "type": "integer",
      "minimum": 0,
      "description": "The board's brief_revision shown with this brief."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "default": null,
      "description": "Filter by type: 'Image', 'Edit', 'Upscale', 'Video'"
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number for pagination"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of items per page"
    },
    "query": {
      "type": "string",
      "default": null,
      "minLength": 2,
      "description": "Hybrid search across generated image content, originating item names, and SKUs."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter by tag IDs (results must have at least one)"
    },
    "decision": {
      "enum": [
        "approved",
        "rejected",
        "undecided"
      ],
      "type": "string",
      "default": null,
      "description": "Filter by the unified result verdict."
    },
    "end_date": {
      "type": "string",
      "default": null,
      "description": "Filter results created on or before this ISO date/datetime, e.g. 2026-04-27."
    },
    "model_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter results to images generated with these AI models"
    },
    "avatar_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter results to images generated with these avatars"
    },
    "outfit_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter results to images generated with these outfits"
    },
    "start_date": {
      "type": "string",
      "default": null,
      "description": "Filter results created on or after this ISO date/datetime, e.g. 2026-04-20."
    },
    "qa_statuses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": null,
      "description": "Filter by QA statuses, e.g. pending, processing, completed, error."
    },
    "location_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter results to images generated with these locations"
    },
    "generation_id": {
      "type": "integer",
      "default": null,
      "description": "Filter by parent generation ID (lists all result images from one generation job)"
    },
    "decision_source": {
      "enum": [
        "auto",
        "human"
      ],
      "type": "string",
      "default": null,
      "description": "Filter by the verdict source."
    },
    "include_snapshot": {
      "type": "boolean",
      "default": false,
      "description": "Include full generation settings, resource snapshots and raw prompt payloads. Large; use only for prompt recovery."
    },
    "art_direction_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter results to images generated with these art directions"
    },
    "clothing_item_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter results to images generated with these clothing items"
    },
    "generation_result_id": {
      "type": "integer",
      "default": null,
      "description": "Look up a single result image by its generation_result_id (the exact integer ID required by QA/edit/upscale/video tools). Returns that one result directly."
    }
  },
  "description": "Input schema for listing generation results.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number for pagination"
    },
    "sort": {
      "type": "string",
      "default": null,
      "description": "Sort order: 'field:direction', e.g. 'created_at:desc'. Default: created_at:desc"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of items per page"
    },
    "query": {
      "type": "string",
      "default": null,
      "minLength": 2,
      "description": "Hybrid search across avatar/model names, metadata, and visual attributes."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to avatars with any of these tags"
    },
    "end_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or before this date (ISO format)"
    },
    "avatar_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to specific avatar IDs"
    },
    "start_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or after this date (ISO format)"
    },
    "include_image_url": {
      "type": "boolean",
      "default": false,
      "description": "Set true when you need to inspect or reuse the avatar/model image URL."
    }
  },
  "description": "Input schema for listing avatars.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number for pagination"
    },
    "sort": {
      "type": "string",
      "default": null,
      "description": "Sort order: 'field:direction', e.g. 'created_at:desc', 'clothing_item_name:asc'. Default: created_at:desc"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of items per page"
    },
    "query": {
      "type": "string",
      "default": null,
      "minLength": 2,
      "description": "Hybrid search across garment names, SKUs, metadata, and visual attributes."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to garments with any of these tags"
    },
    "category": {
      "type": "array",
      "items": {
        "enum": [
          "activewear",
          "baby_and_childrens_clothing",
          "blouses",
          "bodysuits",
          "cardigans",
          "corset_tops",
          "hoodies",
          "overshirts",
          "polos",
          "shirts",
          "sweaters",
          "sweatshirts",
          "t_shirts",
          "tank_tops",
          "tunics",
          "dresses",
          "lingerie",
          "maternity_clothing",
          "mens_undergarments",
          "one_pieces",
          "outerwear",
          "outfit_sets",
          "pants",
          "shorts",
          "skirts",
          "skorts",
          "sleepwear_and_loungewear",
          "socks",
          "suits",
          "swimwear",
          "traditional_and_ceremonial_clothing",
          "uniforms_and_workwear",
          "wedding_and_bridal_party_dresses",
          "clothing_accessories",
          "costumes_and_accessories",
          "handbag_and_wallet_accessories",
          "handbags_wallets_and_cases",
          "jewelry",
          "shoe_accessories",
          "shoes",
          "other"
        ],
        "type": "string"
      },
      "default": null,
      "description": "Filter to garments in any of these canonical categories; OR with body_zone when both are given."
    },
    "end_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or before this date (ISO format)"
    },
    "body_zone": {
      "type": "array",
      "items": {
        "enum": [
          "upper_body",
          "lower_body",
          "full_body",
          "footwear",
          "accessory",
          "other"
        ],
        "type": "string"
      },
      "default": null,
      "description": "Filter to categories in any of these body zones; OR with category when both are given."
    },
    "start_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or after this date (ISO format, e.g. '2025-06-01')"
    },
    "clothing_item_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to specific garment IDs"
    },
    "include_image_url": {
      "type": "boolean",
      "default": false,
      "description": "Set true when the garment image itself is needed for visual display or reuse."
    },
    "include_uncategorized": {
      "type": "boolean",
      "default": false,
      "description": "Also include garments with no category when category and/or body_zone filters are used. If the first result has uncategorized_count > 0 and too few matches, call again with true and inspect those garments."
    },
    "exclude_clothing_item_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "maxItems": 100,
      "description": "Exclude these garment IDs, for example the attached garment."
    }
  },
  "description": "Input schema for listing garments.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number for pagination"
    },
    "sort": {
      "type": "string",
      "default": null,
      "description": "Sort order: 'field:direction', e.g. 'created_at:desc', 'location_name:asc'. Default: created_at:desc"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of items per page"
    },
    "query": {
      "type": "string",
      "default": null,
      "minLength": 2,
      "description": "Hybrid search across location names, metadata, and visual attributes."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to locations with any of these tags"
    },
    "end_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or before this date (ISO format)"
    },
    "start_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or after this date (ISO format)"
    },
    "location_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to specific location IDs"
    },
    "include_image_url": {
      "type": "boolean",
      "default": false,
      "description": "Set true when the location/reference image URL is needed for inspection or reuse."
    }
  },
  "description": "Input schema for listing reusable location/scene references.",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number for pagination"
    },
    "sort": {
      "type": "string",
      "default": null,
      "description": "Sort: 'field:direction'. Use 'latest_generation_at:desc' to surface recently generated outfits. Default: created_at:desc"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of items per page"
    },
    "query": {
      "type": "string",
      "default": null,
      "minLength": 2,
      "description": "Search outfit names and contained garments."
    },
    "source": {
      "enum": [
        "manual",
        "auto",
        "proposed"
      ],
      "type": "string",
      "default": null,
      "description": "Filter by outfit source."
    },
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to outfits with any of these tags"
    },
    "end_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or before this date (ISO format)"
    },
    "is_active": {
      "type": "string",
      "default": null,
      "description": "Filter by status: 'true', 'false', or 'both' (default: both)"
    },
    "outfit_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to specific outfit IDs"
    },
    "start_date": {
      "type": "string",
      "default": null,
      "description": "Filter: created on or after this date (ISO format)"
    },
    "clothing_item_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Filter to outfits containing any of these garments"
    }
  },
  "description": "Input schema for listing outfits.",
  "additionalProperties": false
}

{
  "type": "object",
  "$defs": {
    "CatalogScope": {
      "enum": [
        "library",
        "owner_only"
      ],
      "type": "string"
    },
    "TemplateKind": {
      "enum": [
        "generation_preset",
        "batch_workflow"
      ],
      "type": "string",
      "description": "generation_preset is writable; batch_workflow is retained read-only history."
    }
  },
  "properties": {
    "kind": {
      "enum": [
        "image",
        "edit",
        "video"
      ],
      "type": "string",
      "default": null
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number for pagination"
    },
    "sort": {
      "enum": [
        "newest",
        "most_used",
        "last_used"
      ],
      "type": "string",
      "default": "newest"
    },
    "use_case": {
      "type": "string",
      "default": null,
      "minLength": 1,
      "description": "Filter by a use_case present in any stored command"
    },
    "share_code": {
      "type": "string",
      "default": null,
      "pattern": "^t-[a-z0-9]{4}$",
      "description": "Return the template assigned this public t-xxxx share code"
    },
    "catalog_scope": {
      "$ref": "#/$defs/CatalogScope",
      "default": null,
      "description": "Filter by library or owner_only. Owner-only templates are hidden unless explicitly requested."
    },
    "template_kind": {
      "$ref": "#/$defs/TemplateKind",
      "default": null,
      "description": "Filter generation presets or read-only historical batch_workflow records"
    },
    "items_per_page": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Number of templates per page"
    },
    "created_by_profile_id": {
      "type": "integer",
      "default": null,
      "minimum": 1
    }
  },
  "description": "Input schema for listing company templates.",
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "garment_id",
    "view",
    "expected_revision",
    "board_id"
  ],
  "properties": {
    "view": {
      "enum": [
        "back",
        "side",
        "detail"
      ],
      "type": "string",
      "description": "back, side, or detail (a close-up)"
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "image_url": {
      "type": "string",
      "description": "instead of from_garment_id: the stored photo (host file download URL, or the image_url mcp_upload_intake_photo returned)"
    },
    "garment_id": {
      "type": "integer",
      "minimum": 1,
      "description": "the board garment that gains the photo as a view"
    },
    "from_garment_id": {
      "type": "integer",
      "minimum": 1,
      "description": "the board garment whose photo it is; it leaves the board"
    },
    "expected_revision": {
      "type": "integer",
      "minimum": 0,
      "description": "Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it"
    }
  }
}

{
  "type": "object",
  "required": [
    "model"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "Video model slug or supported model name"
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional motion prompt for the video clip"
    },
    "duration": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "description": "Video duration in seconds; defaults to 5"
    },
    "image_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "HTTPS source image URL; provide exactly one source"
    },
    "resolution": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional output resolution; defaults to 480p"
    },
    "generate_audio": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Include audio in the delivered video. False delivers a silent file; fixed-audio providers are muted after generation at the same credits."
    },
    "last_frame_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional final-frame image URL for supported video models"
    },
    "uploaded_file_id": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "description": "Uploaded file ID to use as the source image; provide exactly one source"
    },
    "generation_result_id": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "description": "Existing generation result ID to use as the source image; provide exactly one source"
    }
  }
}

{
  "type": "object",
  "required": [
    "expected_revision",
    "action",
    "board_id"
  ],
  "properties": {
    "type": {
      "enum": [
        "clothing",
        "models",
        "outfits",
        "generations",
        "files",
        "locations",
        "art_directions",
        "automations"
      ],
      "type": "string",
      "description": "clear: only this type; omit for a new shoot (the whole board and its brief)"
    },
    "view": {
      "enum": [
        "back",
        "side",
        "detail"
      ],
      "type": "string",
      "description": "add_as_view: back, side, or detail (a close-up)"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type",
          "id"
        ],
        "properties": {
          "id": {
            "oneOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "name": {
            "type": "string"
          },
          "type": {
            "enum": [
              "clothing",
              "models",
              "outfits",
              "generations",
              "files",
              "locations",
              "art_directions",
              "automations"
            ],
            "type": "string"
          }
        }
      },
      "maxItems": 100,
      "description": "add / set: the items. An automations item (id: a workflow_id from brief_inputs.automations) pins the Automation every look of the brief runs through; a board pins one, a new one replaces it. A board holds one art direction the same way"
    },
    "action": {
      "enum": [
        "add",
        "set",
        "clear",
        "add_as_view"
      ],
      "type": "string",
      "description": "add: put items on the board; set: replace all items; clear: remove one type, or without type everything and the board's brief (a new shoot on this board); add_as_view: from_garment_id's photo becomes a view of garment_id"
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "garment_id": {
      "type": "integer",
      "minimum": 1,
      "description": "add_as_view: the board garment that gains the photo as a view"
    },
    "from_garment_id": {
      "type": "integer",
      "minimum": 1,
      "description": "add_as_view: the board garment whose photo it is; it leaves the board"
    },
    "expected_revision": {
      "type": "integer",
      "minimum": 0,
      "description": "Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "brief_id",
    "expected_brief_revision",
    "recipe_key",
    "shot_index",
    "camera_edit_id",
    "board_id"
  ],
  "properties": {
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "brief_id": {
      "type": "integer",
      "minimum": 1
    },
    "look_keys": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^look_\\d{2,3}$"
      },
      "default": null,
      "maxItems": 50,
      "minItems": 1,
      "description": "Affected looks using this flow; omit for every look using it. Other looks retain their flow."
    },
    "recipe_key": {
      "type": "string",
      "pattern": "^recipe_\\d{2,3}$",
      "description": "Flow from the current brief."
    },
    "shot_index": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1
    },
    "step_index": {
      "type": "integer",
      "default": null,
      "maximum": 4,
      "minimum": 1,
      "description": "One-based dependent step to replace; omit to append. Each tool accepts only its own operation's settings."
    },
    "camera_edit_id": {
      "enum": [
        "full_body_front",
        "full_body_back",
        "full_body_side",
        "upper_body_front",
        "upper_body_back",
        "upper_body_side",
        "lower_body_front",
        "lower_body_back",
        "lower_body_side",
        "clothing_detail_front",
        "clothing_detail_back",
        "clothing_detail_side"
      ],
      "type": "string",
      "description": "Camera edit preset."
    },
    "expected_brief_revision": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "brief_id",
    "expected_brief_revision",
    "recipe_key",
    "shot_index",
    "prompt",
    "board_id"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "brief_id": {
      "type": "integer",
      "minimum": 1
    },
    "look_keys": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^look_\\d{2,3}$"
      },
      "default": null,
      "maxItems": 50,
      "minItems": 1,
      "description": "Affected looks using this flow; omit for every look using it. Other looks retain their flow."
    },
    "recipe_key": {
      "type": "string",
      "pattern": "^recipe_\\d{2,3}$",
      "description": "Flow from the current brief."
    },
    "shot_index": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1
    },
    "step_index": {
      "type": "integer",
      "default": null,
      "maximum": 4,
      "minimum": 1,
      "description": "One-based dependent step to replace; omit to append. Each tool accepts only its own operation's settings."
    },
    "expected_brief_revision": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "brief_id",
    "expected_brief_revision",
    "recipe_key",
    "camera",
    "board_id"
  ],
  "properties": {
    "camera": {
      "enum": [
        "auto",
        "full_body_front",
        "full_body_back",
        "full_body_side",
        "upper_body_front",
        "upper_body_back",
        "upper_body_side",
        "lower_body_front",
        "lower_body_back",
        "lower_body_side",
        "clothing_detail_front",
        "clothing_detail_back",
        "clothing_detail_side"
      ],
      "type": "string"
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "brief_id": {
      "type": "integer",
      "minimum": 1
    },
    "look_keys": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^look_\\d{2,3}$"
      },
      "default": null,
      "maxItems": 50,
      "minItems": 1,
      "description": "Affected looks using this flow; omit for every look using it. Other looks retain their flow."
    },
    "recipe_key": {
      "type": "string",
      "pattern": "^recipe_\\d{2,3}$",
      "description": "Flow from the current brief."
    },
    "resolution": {
      "type": "string",
      "default": null,
      "pattern": "^\\d{1,2}(\\.\\d)?K$",
      "description": "Shared photo resolution for the whole shoot."
    },
    "shot_index": {
      "type": "integer",
      "default": null,
      "maximum": 8,
      "minimum": 1,
      "description": "One-based shot to revise; omit to append a new shot. Revising its camera retains dependent steps."
    },
    "aspect_ratio": {
      "type": "string",
      "default": null,
      "pattern": "^\\d{1,2}(\\.\\d{1,2})?:\\d{1,2}(\\.\\d{1,2})?$",
      "description": "Shared photo format for the whole shoot."
    },
    "expected_brief_revision": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "brief_id",
    "expected_brief_revision",
    "recipe_key",
    "shot_index",
    "factor",
    "board_id"
  ],
  "properties": {
    "factor": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "brief_id": {
      "type": "integer",
      "minimum": 1
    },
    "look_keys": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^look_\\d{2,3}$"
      },
      "default": null,
      "maxItems": 50,
      "minItems": 1,
      "description": "Affected looks using this flow; omit for every look using it. Other looks retain their flow."
    },
    "recipe_key": {
      "type": "string",
      "pattern": "^recipe_\\d{2,3}$",
      "description": "Flow from the current brief."
    },
    "shot_index": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1
    },
    "step_index": {
      "type": "integer",
      "default": null,
      "maximum": 4,
      "minimum": 1,
      "description": "One-based dependent step to replace; omit to append. Each tool accepts only its own operation's settings."
    },
    "expected_brief_revision": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "brief_id",
    "expected_brief_revision",
    "recipe_key",
    "shot_index",
    "length_seconds",
    "board_id"
  ],
  "properties": {
    "sound": {
      "type": "boolean",
      "default": false
    },
    "prompt": {
      "type": "string",
      "default": "",
      "maxLength": 1000
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "brief_id": {
      "type": "integer",
      "minimum": 1
    },
    "look_keys": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^look_\\d{2,3}$"
      },
      "default": null,
      "maxItems": 50,
      "minItems": 1,
      "description": "Affected looks using this flow; omit for every look using it. Other looks retain their flow."
    },
    "recipe_key": {
      "type": "string",
      "pattern": "^recipe_\\d{2,3}$",
      "description": "Flow from the current brief."
    },
    "shot_index": {
      "type": "integer",
      "maximum": 8,
      "minimum": 1
    },
    "step_index": {
      "type": "integer",
      "default": null,
      "maximum": 4,
      "minimum": 1,
      "description": "One-based dependent step to replace; omit to append. Each tool accepts only its own operation's settings."
    },
    "length_seconds": {
      "type": "integer",
      "minimum": 1
    },
    "expected_brief_revision": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$defs": {
    "LookInput": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "default": null,
          "pattern": "^look_\\d{2,3}$",
          "description": "update_brief: an existing look's key, to keep that look."
        },
        "label": {
          "type": "string",
          "default": "",
          "maxLength": 120,
          "description": "The look's name, e.g. 'Linen summer set'."
        },
        "model_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "The Model who wears the look."
        },
        "outfit_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "A saved outfit."
        },
        "location_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "Where the look is shot."
        },
        "clothing_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1
          },
          "maxItems": 4,
          "description": "Clothing worn together."
        },
        "reference_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1
          },
          "maxItems": 50,
          "description": "Reference photos (uploaded file ids from the board's References)."
        }
      },
      "description": "One look: one outfit worn in the shoot, with who wears it and where.",
      "additionalProperties": false
    },
    "ProposedDirection": {
      "type": "object",
      "anyOf": [
        {
          "required": [
            "prompt"
          ]
        },
        {
          "required": [
            "art_direction_id"
          ]
        }
      ],
      "properties": {
        "prompt": {
          "type": "string",
          "default": null,
          "maxLength": 2000,
          "description": "Your words for this shoot, in English, 1-3 sentences. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look. Not needed with an art_direction_id."
        },
        "art_direction_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "A saved art direction (a library id, or the id save_art_direction returns)."
        }
      },
      "description": "The shoot's Direction as the host writes it: its words, a saved art direction, or both; never neither,\nso every brief says what runs.",
      "additionalProperties": false
    }
  },
  "required": [
    "looks",
    "direction",
    "board_id"
  ],
  "properties": {
    "looks": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/LookInput"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "The looks to shoot, each one outfit worn in the shoot, with ids from read_shoot_board."
    },
    "title": {
      "type": "string",
      "default": "",
      "maxLength": 80,
      "description": "The shoot's name, only in the user's own words; otherwise leave it out."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "direction": {
      "$ref": "#/$defs/ProposedDirection",
      "description": "Required: what every shot of every look follows, exactly what Generate runs: prompt, art_direction_id (a saved art direction), or both. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look."
    },
    "image_model": {
      "type": "string",
      "default": null,
      "description": "The shoot's image model: a slug from brief_inputs.ai_models (omit: kept)."
    },
    "video_model": {
      "type": "string",
      "default": null,
      "description": "The shoot's video model: a slug from brief_inputs.ai_models (omit: kept)."
    },
    "recipe_workflow_id": {
      "type": "string",
      "default": null,
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "The Automation every look runs through, as it is saved: a workflow_id from brief_inputs.automations or save_automation. Omitted while the board pins one (brief_inputs.pinned_automation): every look runs it."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$defs": {
    "MontageItemInput": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "enum": [
            "video",
            "image"
          ],
          "type": "string",
          "description": "'video' for existing video, 'image' for an image that needs video generation first"
        },
        "muted": {
          "type": "boolean",
          "default": false,
          "description": "Mute audio for this item"
        },
        "speed": {
          "type": "number",
          "default": 1,
          "maximum": 4,
          "minimum": 0.25,
          "description": "Playback speed multiplier (0.25-4.0)"
        },
        "prompt": {
          "type": "string",
          "default": null,
          "description": "Per-image motion prompt for video generation. Make it specific to this image and the requested movement, camera motion, vibe, and pacing."
        },
        "duration": {
          "type": "integer",
          "default": null,
          "description": "Exact generated video duration in seconds for image items. If omitted, target_duration can be used instead."
        },
        "end_time": {
          "type": "number",
          "default": null,
          "description": "Optional trim end time in seconds for this clip",
          "exclusiveMinimum": 0
        },
        "image_url": {
          "type": "string",
          "default": null,
          "description": "URL of image to use as first frame (alternative to image_result_id)"
        },
        "start_time": {
          "type": "number",
          "default": null,
          "minimum": 0,
          "description": "Optional trim start time in seconds for this clip"
        },
        "video_model": {
          "type": "string",
          "default": null,
          "description": "Video model slug (required when type='image'). Use list_models(model_type='video') to see options."
        },
        "generate_audio": {
          "type": "boolean",
          "default": false,
          "description": "Generate audio with the video"
        },
        "last_frame_url": {
          "type": "string",
          "default": null,
          "description": "URL of last frame image for first-to-last video generation"
        },
        "image_result_id": {
          "type": "integer",
          "default": null,
          "description": "ID of image GenerationResult to use as first frame (required when type='image')"
        },
        "target_duration": {
          "type": "number",
          "default": null,
          "description": "Desired final clip length in seconds. For existing videos, this trims from the start by default. For image items, this becomes the generated video duration.",
          "exclusiveMinimum": 0
        },
        "video_result_id": {
          "type": "integer",
          "default": null,
          "description": "ID of video GenerationResult (required when type='video')"
        }
      },
      "description": "A single item in a montage proposal. Either an existing video or an image to generate video from."
    }
  },
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/MontageItemInput"
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Ordered list of montage items. Each is either an existing video or an image needing video generation. Min 1, max 10."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "aspect_ratio": {
      "type": "string",
      "default": "9:16",
      "description": "Output aspect ratio (e.g. '9:16', '16:9', '1:1')"
    },
    "base_resolution": {
      "type": "integer",
      "default": 1080,
      "maximum": 4320,
      "minimum": 360,
      "description": "Output resolution height in pixels"
    }
  },
  "description": "Input schema for proposing a montage (mix of existing videos and images to generate)."
}

{
  "type": "object",
  "required": [
    "name",
    "overview",
    "mood",
    "light",
    "setting",
    "palette",
    "camera",
    "styling",
    "board_id"
  ],
  "properties": {
    "mood": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "The feeling and the pose language: energy, expression, how the model moves."
    },
    "name": {
      "type": "string",
      "maxLength": 80,
      "minLength": 2,
      "description": "Its title, 2-6 words, the one you used in chat (never Untitled or Art direction)."
    },
    "avoid": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 3
      },
      "maxItems": 8,
      "description": "What never appears, one per line."
    },
    "light": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "Direction, softness, colour temperature and shadows (e.g. low warm sun from the left, long soft shadows)."
    },
    "camera": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "Framing, angle, lens feel and distance (e.g. eye-level 50mm, full body with headroom)."
    },
    "palette": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "The colours of set, light and styling (e.g. terracotta, sand, washed olive)."
    },
    "setting": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "Where it is shot: studio backdrop or place, surfaces, props."
    },
    "styling": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "How the clothes are worn, hair, makeup, accessories, footwear."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "overview": {
      "type": "string",
      "maxLength": 600,
      "minLength": 3,
      "description": "What the photos should feel like overall, in 1-2 sentences."
    },
    "must_keep": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 3
      },
      "maxItems": 8,
      "description": "Rules every photo keeps, one per line (the user's own must-haves)."
    },
    "variations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "options"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 60,
            "minLength": 2
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 200,
              "minLength": 3
            },
            "maxItems": 6,
            "minItems": 2
          }
        },
        "additionalProperties": false
      },
      "maxItems": 4,
      "description": "Only when the user wants variety across photos: each a name (Pose, Backdrop) and 2-6 complete alternatives Uwear rotates through."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$defs": {
    "ReferenceChatFileUploadItem": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "default": null,
          "description": "Alternate display name for the saved reference file"
        },
        "file_name": {
          "type": "string",
          "default": null,
          "description": "Display name for the saved reference file"
        },
        "image_url": {
          "type": "string",
          "default": null,
          "description": "Resolved download URL. Used by the Uwear app when recovering a chat file ID."
        },
        "mime_type": {
          "type": "string",
          "default": null,
          "description": "MIME/content type, e.g. image/png"
        }
      },
      "description": "One reference file upload item for chat-file batch upload."
    }
  },
  "required": [],
  "properties": {
    "files": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ReferenceChatFileUploadItem"
      },
      "default": null,
      "maxItems": 10,
      "description": "Reference file metadata in the same order as image_file_1, image_file_2, etc. No base64."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "file_name": {
      "type": "string",
      "default": null,
      "description": "Single recovered display name"
    },
    "image_url": {
      "type": "string",
      "default": null,
      "description": "Single resolved download URL used by automatic opaque-file recovery."
    },
    "mime_type": {
      "type": "string",
      "default": null,
      "description": "Single recovered MIME/content type, e.g. image/png"
    },
    "image_file_1": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_2": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_3": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_4": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_5": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_6": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_7": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_8": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_9": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_10": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    }
  },
  "description": "Input schema for saving reference files from chat file references."
}

{
  "type": "object",
  "$defs": {
    "LookInput": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "default": null,
          "pattern": "^look_\\d{2,3}$",
          "description": "update_brief: an existing look's key, to keep that look."
        },
        "label": {
          "type": "string",
          "default": "",
          "maxLength": 120,
          "description": "The look's name, e.g. 'Linen summer set'."
        },
        "model_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "The Model who wears the look."
        },
        "outfit_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "A saved outfit."
        },
        "location_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "Where the look is shot."
        },
        "clothing_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1
          },
          "maxItems": 4,
          "description": "Clothing worn together."
        },
        "reference_ids": {
          "type": "array",
          "items": {
            "type": "integer",
            "minimum": 1
          },
          "maxItems": 50,
          "description": "Reference photos (uploaded file ids from the board's References)."
        }
      },
      "description": "One look: one outfit worn in the shoot, with who wears it and where.",
      "additionalProperties": false
    },
    "ProposedDirection": {
      "type": "object",
      "anyOf": [
        {
          "required": [
            "prompt"
          ]
        },
        {
          "required": [
            "art_direction_id"
          ]
        }
      ],
      "properties": {
        "prompt": {
          "type": "string",
          "default": null,
          "maxLength": 2000,
          "description": "Your words for this shoot, in English, 1-3 sentences. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look. Not needed with an art_direction_id."
        },
        "art_direction_id": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "A saved art direction (a library id, or the id save_art_direction returns)."
        }
      },
      "description": "The shoot's Direction as the host writes it: its words, a saved art direction, or both; never neither,\nso every brief says what runs.",
      "additionalProperties": false
    }
  },
  "required": [
    "brief_id",
    "looks",
    "board_id"
  ],
  "properties": {
    "looks": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/LookInput"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "The complete new look list (not a diff); an unchanged look keeps its key."
    },
    "title": {
      "type": "string",
      "default": null,
      "maxLength": 80,
      "description": "A new name for the shoot, only the user's own words (omit: kept)."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "brief_id": {
      "type": "integer",
      "minimum": 1,
      "description": "The brief being revised: the board's brief_id from read_shoot_board."
    },
    "direction": {
      "$ref": "#/$defs/ProposedDirection",
      "default": null,
      "description": "A new Direction for the whole shoot, replacing the brief's (omit: kept): prompt, art_direction_id (a saved art direction), or both. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look."
    },
    "image_model": {
      "type": "string",
      "default": null,
      "description": "The shoot's image model: a slug from brief_inputs.ai_models (omit: kept)."
    },
    "video_model": {
      "type": "string",
      "default": null,
      "description": "The shoot's video model: a slug from brief_inputs.ai_models (omit: kept)."
    },
    "recipe_look_keys": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^look_\\d{2,3}$"
      },
      "default": null,
      "maxItems": 50,
      "description": "The looks (keys you send) that move to recipe_workflow_id; omit for every look."
    },
    "recipe_workflow_id": {
      "type": "string",
      "default": null,
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "The Automation the looks below move to, run as it is saved: a workflow_id from brief_inputs.automations or save_automation."
    },
    "expected_brief_revision": {
      "type": "integer",
      "default": null,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$defs": {
    "MontagePatchOpInput": {
      "type": "object",
      "required": [
        "op"
      ],
      "properties": {
        "op": {
          "enum": [
            "remove",
            "clear_trim",
            "set_duration",
            "set_trim_range",
            "set_speed",
            "set_muted",
            "set_prompt",
            "set_video_model",
            "set_generate_audio",
            "set_last_frame",
            "set_aspect_ratio",
            "set_base_resolution"
          ],
          "type": "string",
          "description": "Patch operation to apply to the montage proposal."
        },
        "muted": {
          "type": "boolean",
          "default": null,
          "description": "Muted value for set_muted."
        },
        "speed": {
          "type": "number",
          "default": null,
          "maximum": 4,
          "minimum": 0.25,
          "description": "Playback speed multiplier for set_speed."
        },
        "prompt": {
          "type": "string",
          "default": null,
          "description": "Motion prompt for set_prompt."
        },
        "end_time": {
          "type": "number",
          "default": null,
          "description": "Trim end time in seconds for set_trim_range.",
          "exclusiveMinimum": 0
        },
        "start_time": {
          "type": "number",
          "default": null,
          "minimum": 0,
          "description": "Trim start time in seconds for set_trim_range."
        },
        "clip_number": {
          "type": "integer",
          "default": null,
          "minimum": 1,
          "description": "1-based clip number target."
        },
        "video_model": {
          "type": "string",
          "default": null,
          "description": "Video model for set_video_model."
        },
        "apply_to_all": {
          "type": "boolean",
          "default": false,
          "description": "Apply this operation to every clip in the current montage proposal."
        },
        "aspect_ratio": {
          "type": "string",
          "default": null,
          "description": "Aspect ratio value for set_aspect_ratio."
        },
        "clip_numbers": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "default": null,
          "description": "Optional list of 1-based clip numbers to target together."
        },
        "generate_audio": {
          "type": "boolean",
          "default": null,
          "description": "Generate-audio value for set_generate_audio."
        },
        "last_frame_url": {
          "type": "string",
          "default": null,
          "description": "Last-frame URL for set_last_frame."
        },
        "base_resolution": {
          "type": "integer",
          "default": null,
          "maximum": 4320,
          "minimum": 360,
          "description": "Resolution value for set_base_resolution."
        },
        "target_duration": {
          "type": "number",
          "default": null,
          "description": "Desired final clip length in seconds for set_duration.",
          "exclusiveMinimum": 0
        }
      },
      "description": "A typed montage patch operation applied in order."
    }
  },
  "required": [],
  "properties": {
    "muted": {
      "type": "boolean",
      "default": null,
      "description": "Mute or unmute the selected clip(s)."
    },
    "speed": {
      "type": "number",
      "default": null,
      "maximum": 4,
      "minimum": 0.25,
      "description": "Playback speed multiplier."
    },
    "prompt": {
      "type": "string",
      "default": null,
      "description": "Update the motion prompt for image-to-video montage items."
    },
    "remove": {
      "type": "boolean",
      "default": false,
      "description": "Remove the selected clip(s) from the proposal."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "end_time": {
      "type": "number",
      "default": null,
      "description": "Trim end time in seconds for legacy trim-range updates.",
      "exclusiveMinimum": 0
    },
    "clear_trim": {
      "type": "boolean",
      "default": false,
      "description": "For video clips, remove trim bounds and restore the full clip length in the proposal."
    },
    "operations": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/MontagePatchOpInput"
      },
      "default": null,
      "description": "Ordered montage patch operations. Preferred over the legacy flat fields below."
    },
    "start_time": {
      "type": "number",
      "default": null,
      "minimum": 0,
      "description": "Trim start time in seconds for legacy trim-range updates."
    },
    "clip_number": {
      "type": "integer",
      "default": null,
      "minimum": 1,
      "description": "1-based clip number to update. Omit when apply_to_all=true."
    },
    "video_model": {
      "type": "string",
      "default": null,
      "description": "Update the video model for image-to-video montage items."
    },
    "apply_to_all": {
      "type": "boolean",
      "default": false,
      "description": "Apply changes to every clip in the current montage proposal."
    },
    "aspect_ratio": {
      "type": "string",
      "default": null,
      "description": "Update the montage output aspect ratio."
    },
    "clip_numbers": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "default": null,
      "description": "Optional list of 1-based clip numbers to update together."
    },
    "generate_audio": {
      "type": "boolean",
      "default": null,
      "description": "Enable or disable generated audio for image-to-video montage items."
    },
    "last_frame_url": {
      "type": "string",
      "default": null,
      "description": "Optional last-frame URL for image-to-video montage items."
    },
    "base_resolution": {
      "type": "integer",
      "default": null,
      "maximum": 4320,
      "minimum": 360,
      "description": "Update the montage output resolution height."
    },
    "target_duration": {
      "type": "number",
      "default": null,
      "description": "Desired final clip length in seconds.",
      "exclusiveMinimum": 0
    }
  },
  "description": "Patch the latest montage proposal shown in the UI."
}

{
  "type": "object",
  "$defs": {
    "AvatarChatFileUploadItem": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "Name for the avatar/model"
        },
        "build": {
          "type": "string",
          "default": null,
          "maxLength": 100,
          "description": "Optional concrete physical build. Never inferred."
        },
        "age_range": {
          "type": "string",
          "default": null,
          "maxLength": 20,
          "description": "Optional concrete age or age range. Never inferred."
        },
        "file_name": {
          "type": "string",
          "default": null,
          "description": "Original file name"
        },
        "height_cm": {
          "type": "integer",
          "default": null,
          "maximum": 220,
          "minimum": 40,
          "description": "Optional height in centimeters. Never inferred."
        },
        "image_url": {
          "type": "string",
          "default": null,
          "description": "Resolved download URL. Used by the Uwear app when recovering a chat file ID."
        },
        "mime_type": {
          "type": "string",
          "default": null,
          "description": "MIME/content type, e.g. image/png"
        },
        "description": {
          "type": "object",
          "default": null,
          "description": "Avatar metadata: {gender, age, body, ethnicity, hair_color, etc.}",
          "additionalProperties": true
        }
      },
      "description": "One avatar/model upload item for chat-file batch upload.",
      "additionalProperties": false
    }
  },
  "required": [],
  "properties": {
    "name": {
      "type": "string",
      "default": null,
      "description": "Single recovered avatar/model name"
    },
    "build": {
      "type": "string",
      "default": null,
      "maxLength": 100,
      "description": "Optional concrete physical build. Never inferred."
    },
    "avatars": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AvatarChatFileUploadItem"
      },
      "default": null,
      "maxItems": 10,
      "description": "Avatar/model metadata in the same order as image_file_1, image_file_2, etc. No base64."
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "age_range": {
      "type": "string",
      "default": null,
      "maxLength": 20,
      "description": "Optional concrete age or age range. Never inferred."
    },
    "file_name": {
      "type": "string",
      "default": null,
      "description": "Single recovered original file name"
    },
    "height_cm": {
      "type": "integer",
      "default": null,
      "maximum": 220,
      "minimum": 40,
      "description": "Optional height in centimeters. Never inferred."
    },
    "image_url": {
      "type": "string",
      "default": null,
      "description": "Single resolved download URL used by automatic opaque-file recovery."
    },
    "mime_type": {
      "type": "string",
      "default": null,
      "description": "Single recovered MIME/content type, e.g. image/png"
    },
    "description": {
      "type": "object",
      "default": null,
      "description": "Single recovered avatar metadata",
      "additionalProperties": true
    },
    "image_file_1": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_2": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_3": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_4": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_5": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_6": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_7": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_8": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_9": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    },
    "image_file_10": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string"
        }
      },
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.",
      "additionalProperties": false
    }
  },
  "description": "Input schema for uploading avatars/models from chat file references.",
  "additionalProperties": false
}

{
  "type": "object",
  "$defs": {
    "GarmentPublicUrlAssetInput": {
      "type": "object",
      "properties": {
        "asset_url": {
          "type": "string",
          "default": null,
          "description": "Public HTTP(S) image URL for this asset"
        },
        "file_name": {
          "type": "string",
          "default": null,
          "description": "Original file name for this asset"
        },
        "image_url": {
          "type": "string",
          "default": null,
          "description": "Alias for asset_url"
        },
        "mime_type": {
          "type": "string",
          "default": null,
          "description": "MIME/content type for this asset, e.g. image/png"
        },
        "asset_kind": {
          "enum": [
            "full",
            "detail"
          ],
          "type": "string",
          "default": null,
          "description": "Asset kind: full garment view or detail crop."
        },
        "asset_role": {
          "enum": [
            "front",
            "back",
            "side",
            "detail"
          ],
          "type": "string",
          "default": null,
          "deprecated": true,
          "description": "Deprecated role-only adapter. Prefer asset_kind and asset_view."
        },
        "asset_view": {
          "enum": [
            "front",
            "back",
            "side",
            "unspecified"
          ],
          "type": "string",
          "default": null,
          "description": "Visible garment view. New detail uploads require front, back, or side."
        }
      },
      "description": "One classified garment asset for public URL upload."
    },
    "GarmentPublicUrlUploadItem": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "default": null,
          "description": "Name for the garment. If omitted, derived from the image filename."
        },
        "assets": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/GarmentPublicUrlAssetInput"
          },
          "default": null,
          "description": "Full garment asset set using asset_kind/asset_view. Exactly one full front is required; full views are unique and detail views can repeat."
        },
        "gender": {
          "type": "string",
          "default": null,
          "description": "Target gender: male, female, unisex"
        },
        "file_name": {
          "type": "string",
          "default": null,
          "description": "Original file name"
        },
        "image_url": {
          "type": "string",
          "default": null,
          "description": "Legacy shortcut: public HTTP(S) front image URL"
        },
        "mime_type": {
          "type": "string",
          "default": null,
          "description": "MIME/content type, e.g. image/png"
        },
        "description": {
          "type": "string",
          "default": null,
          "description": "Optional item-level garment description hint"
        },
        "back_image_url": {
          "type": "string",
          "default": null,
          "description": "Legacy shortcut: optional public HTTP(S) back image URL"
        },
        "side_image_url": {
          "type": "string",
          "default": null,
          "description": "Legacy shortcut: optional public HTTP(S) side image URL"
        },
        "processing_mode": {
          "type": "string",
          "default": null,
          "description": "Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal."
        },
        "detail_image_urls": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "default": null,
          "description": "Legacy shortcut: optional public HTTP(S) detail image URLs"
        }
      },
      "description": "One garment upload item for public URL batch upload."
    }
  },
  "required": [],
  "properties": {
    "name": {
      "type": "string",
      "default": null,
      "description": "Single garment name"
    },
    "assets": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/GarmentPublicUrlAssetInput"
      },
      "default": null,
      "description": "Single garment full asset set. Use asset_kind/asset_view. Exactly one full front is required; full views are unique and detail views can repeat."
    },
    "gender": {
      "type": "string",
      "default": null,
      "description": "Single garment gender: male, female, unisex"
    },
    "board_id": {
      "type": "string",
      "description": "The open Shoot Board's board_id, from Open Shoot Board or your context."
    },
    "garments": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/GarmentPublicUrlUploadItem"
      },
      "default": null,
      "maxItems": 50,
      "description": "Garments to upload from public HTTP(S) URLs. No chat file objects and no base64."
    },
    "file_name": {
      "type": "string",
      "default": null,
      "description": "Single original file name"
    },
    "image_url": {
      "type": "string",
      "default": null,
      "description": "Single public HTTP(S) front image URL"
    },
    "mime_type": {
      "type": "string",
      "default": null,
      "description": "Single MIME/content type, e.g. image/png"
    },
    "description": {
      "type": "string",
      "default": null,
      "description": "Single item-level garment description hint"
    },
    "back_image_url": {
      "type": "string",
      "default": null,
      "description": "Single optional public HTTP(S) back image URL"
    },
    "side_image_url": {
      "type": "string",
      "default": null,
      "description": "Single optional public HTTP(S) side image URL"
    },
    "processing_mode": {
      "type": "string",
      "default": null,
      "description": "Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal."
    },
    "detail_image_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": null,
      "description": "Single optional public HTTP(S) detail image URLs"
    }
  },
  "description": "Input schema for uploading garments from public URLs."
}