aozu.mantle.tools

inspect_character_contract

Use scope:model-sheet for reference art, scope:appearance (default) for composited layers. Inspect character.appearances and activeAppearanceId for named combinations. Use set_character_variant_selection with appearance to create/save-as/select/rename/delete a combination; then re-inspect its model sheet. For model sheets, use referenceId (a default view or a supplemental ID), optional label/kind/viewpoint/pose, and images (up to 5 IDs: appearance, canonical, or stored reference IDs) to obtain actual source PNGs. Image bytes are opt-in for model sheets. Save-as captures the current front; create starts with no selected variants or references, keeping the shared base body and assets. fromAppearance can explicitly capture or replace the front. Supplement it with head/structure/expression/detail/style references. Follow generationGuidance for identity, source precedence and the requested study, plus the returned task-specific policy and required browser visual-review workflow. Appearance only: The first Appearance body establishes a front A-pose: upright torso, neutral face, arms angled down and away from the torso, relaxed visible hands, stable feet, and the complete head-to-feet silhouette inside the canvas. This is the AOZU authoring convention, not a claim of skeleton compatibility. Preserve this pose and registration in derived outfits and expressions. Existing artwork is not automatically verified A-pose; review it visually before proposing a baseline change, which can make derived layers stale. Required before replacing, repairing, or aligning character art; use inspect_workspace first to identify the user's current view. Optionally name one target to receive its allowed operations, exact current asset hash, visual alignment reference, layer ownership, alpha policy, generation size (1024×1536) and final size (512×768), normalization, revision, z-order, diagnostics, and required browser visual-review workflow. Follow generationRecipe.backgroundPreparation before…

Input schema

{
  "additionalProperties": false,
  "properties": {
    "characterId": {
      "minLength": 1,
      "type": "string"
    },
    "group": {
      "enum": [
        "body",
        "expression",
        "outfit",
        "prop"
      ]
    },
    "images": {
      "items": {
        "pattern": "^[a-z0-9][a-z0-9_-]{0,39}$",
        "type": "string"
      },
      "maxItems": 5,
      "type": "array",
      "uniqueItems": true
    },
    "kind": {
      "enum": [
        "full-body",
        "head",
        "structure",
        "expression",
        "detail",
        "style"
      ]
    },
    "label": {
      "maxLength": 80,
      "minLength": 1,
      "type": "string"
    },
    "layer": {
      "enum": [
        "body",
        "head",
        "back",
        "front"
      ]
    },
    "needsReview": {
      "type": "boolean"
    },
    "pose": {
      "maxLength": 80,
      "minLength": 1,
      "type": "string"
    },
    "referenceId": {
      "pattern": "^[a-z0-9][a-z0-9_-]{0,39}$",
      "type": "string"
    },
    "scope": {
      "enum": [
        "appearance",
        "model-sheet"
      ]
    },
    "sourceSha256": {
      "pattern": "^[0-9a-f]{64}$",
      "type": "string"
    },
    "variantId": {
      "pattern": "^[a-z0-9][a-z0-9_-]{0,39}$",
      "type": "string"
    },
    "viewpoint": {
      "maxLength": 80,
      "minLength": 1,
      "type": "string"
    }
  },
  "readOnly": true,
  "required": [
    "characterId"
  ],
  "type": "object"
}