identity_assets_list

Default model descriptor

{
  "name": "identity_assets_list",
  "title": "List project identity assets",
  "description": "Discover the saved Signature assets available in a project context: account-library opener entries, outro entries, cut-style entries, a compact curated identity-sound palette, and music beds, with quiet default marks for this project. Signature applies saved opener, outro, and cut style choices to new reels; saved project music creates a full-Episode music cue. Do not call this just to use known project defaults; for the Andrew trainer worked example in the server instructions, the right call is episode_create with identity:\"project_default\". Call this when defaults are absent or unclear, when the user names a specific look, sound, song, or asset, or when you need uses_title before passing opener_title. Use opener and outro library_entry_id refs in an explicit identity object. To change the sonic mark on an existing typed opener or outro, pass an identity_sounds id to episode_edit identity_part.customize set.sound_id. Use a music-bed id with music_cue_mutate. Music family, mood, and tags support compact genre matching; prompts describe the finer vibe. A saved default whose library entry is missing does not hide the other assets: default_issues names that role, and project_default refuses for it until identity_apply_to_project replaces or clears it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID."
      },
      "include_archived": {
        "type": "boolean",
        "description": "Include archived music beds. Openers, outros, and cut styles come from the account identity library. Defaults false."
      }
    },
    "required": [
      "project_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  }
}

App descriptor

{
  "name": "identity_assets_list",
  "title": "List project identity assets",
  "description": "Discover the saved Signature assets available in a project context: account-library opener entries, outro entries, cut-style entries, a compact curated identity-sound palette, and music beds, with quiet default marks for this project. Signature applies saved opener, outro, and cut style choices to new reels; saved project music creates a full-Episode music cue. Do not call this just to use known project defaults; for the Andrew trainer worked example in the server instructions, the right call is episode_create with identity:\"project_default\". Call this when defaults are absent or unclear, when the user names a specific look, sound, song, or asset, or when you need uses_title before passing opener_title. Use opener and outro library_entry_id refs in an explicit identity object. To change the sonic mark on an existing typed opener or outro, pass an identity_sounds id to episode_edit identity_part.customize set.sound_id. Use a music-bed id with music_cue_mutate. Music family, mood, and tags support compact genre matching; prompts describe the finer vibe. A saved default whose library entry is missing does not hide the other assets: default_issues names that role, and project_default refuses for it until identity_apply_to_project replaces or clears it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID."
      },
      "include_archived": {
        "type": "boolean",
        "description": "Include archived music beds. Openers, outros, and cut styles come from the account identity library. Defaults false."
      }
    },
    "required": [
      "project_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "project_title": {
        "type": "string"
      },
      "enabled_for_reels": {
        "type": "boolean",
        "description": "Whether this project identity pack is enabled for future reels. This read reports the setting; it does not manage it."
      },
      "default_issues": {
        "type": "array",
        "description": "Saved project defaults that cannot be used, one per role; empty when every saved default resolves. No other asset is substituted or marked default.",
        "items": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "identity_asset_not_found"
              ]
            },
            "role": {
              "type": "string",
              "enum": [
                "opener",
                "outro",
                "cut_style"
              ]
            },
            "library_entry_id": {
              "type": "string",
              "description": "The saved default's library entry, which is not in this account library."
            },
            "project_default": {
              "type": "string",
              "enum": [
                "unavailable"
              ],
              "description": "identity:\"project_default\" and configuration:\"project_default\" refuse for this role."
            },
            "message": {
              "type": "string"
            },
            "recovery": {
              "type": "object",
              "description": "Repair the default with this tool and argument: a library_entry_id from replacement_source, or clear_value.",
              "properties": {
                "tool": {
                  "type": "string",
                  "enum": [
                    "identity_apply_to_project"
                  ]
                },
                "argument": {
                  "type": "string",
                  "enum": [
                    "opener_preset_id",
                    "outro_preset_id",
                    "cut_style_id"
                  ]
                },
                "replacement_source": {
                  "type": "string"
                },
                "clear_value": {
                  "type": "string",
                  "enum": [
                    "none"
                  ]
                }
              }
            }
          }
        }
      },
      "assets": {
        "type": "object",
        "properties": {
          "openers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identity library entry public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "preset_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "duration_ms": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "brand_id": {
                  "type": "string"
                },
                "aspect_ratios": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "scene_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sound_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The preset's default sonic mark; customize the concrete identity part to override it."
                },
                "default": {
                  "type": "boolean"
                },
                "uses_title": {
                  "type": "boolean"
                }
              }
            }
          },
          "outros": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identity library entry public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "preset_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "duration_ms": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "brand_id": {
                  "type": "string"
                },
                "aspect_ratios": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "scene_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sound_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The preset's default sonic mark; customize the concrete identity part to override it."
                },
                "default": {
                  "type": "boolean"
                },
                "uses_title": {
                  "type": "boolean"
                }
              }
            }
          },
          "cut_styles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identity library entry public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "style_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "brand_id": {
                  "type": "string"
                },
                "default": {
                  "type": "boolean"
                },
                "uses_title": {
                  "type": "boolean"
                }
              }
            }
          },
          "identity_sounds": {
            "type": "array",
            "description": "One representative curated take per identity-sound concept. Use an id with episode_edit identity_part.customize set.sound_id.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "family": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "notes": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "aliases": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "account_scenes": {
            "type": "array",
            "description": "Saved account-authored scenes. Use scene_id only through assets.signature_lab.account_scene_id_source for initial replacement or explicit later rebinding of an eligible typed opener/outro.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "scene_id": {
                  "type": "string"
                },
                "revision": {
                  "type": "integer"
                },
                "source_sha256": {
                  "type": "string"
                },
                "settings": {
                  "type": "object"
                }
              }
            }
          },
          "signature_lab": {
            "type": "object",
            "description": "Authoritative compact Signature Lab recipe choices and references to the current dynamic asset rows. initial_apply describes episode_edit identity_part.replace for an occurrence whose fresh read reports identity_replace=true and no identity_customization; rebind describes episode_edit identity_part.customize for an occurrence whose read reports identity_customize=true and identity_customization.params.signature_lab. Neither changes Project defaults.",
            "properties": {
              "schema": {
                "type": "string"
              },
              "layouts": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "curated_scene_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "account_scene_id_source": {
                "type": "string"
              },
              "opener_preset_id_source": {
                "type": "string"
              },
              "outro_preset_id_source": {
                "type": "string"
              },
              "sound_id_source": {
                "type": "string"
              },
              "initial_apply": {
                "type": "object"
              },
              "rebind": {
                "type": "object"
              }
            }
          },
          "music_beds": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Music bed public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "duration_seconds": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "track_kind": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "family": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 80,
                  "description": "Compact musical family or collection label."
                },
                "mood": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 160,
                  "description": "Compact human-readable mood description."
                },
                "tags": {
                  "type": "array",
                  "maxItems": 8,
                  "items": {
                    "type": "string",
                    "maxLength": 48
                  },
                  "description": "Bounded genre/style tags, including account curation."
                },
                "prompt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 240,
                  "description": "Compact taste/vibe excerpt used to distinguish otherwise similar tracks."
                },
                "default": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Live Workspace descriptor

{
  "name": "identity_assets_list",
  "title": "List project identity assets",
  "description": "Discover the saved Signature assets available in a project context: account-library opener entries, outro entries, cut-style entries, a compact curated identity-sound palette, and music beds, with quiet default marks for this project. Signature applies saved opener, outro, and cut style choices to new reels; saved project music creates a full-Episode music cue. Do not call this just to use known project defaults; for the Andrew trainer worked example in the server instructions, the right call is episode_create with identity:\"project_default\". Call this when defaults are absent or unclear, when the user names a specific look, sound, song, or asset, or when you need uses_title before passing opener_title. Use opener and outro library_entry_id refs in an explicit identity object. To change the sonic mark on an existing typed opener or outro, pass an identity_sounds id to episode_edit identity_part.customize set.sound_id. Use a music-bed id with music_cue_mutate. Music family, mood, and tags support compact genre matching; prompts describe the finer vibe. A saved default whose library entry is missing does not hide the other assets: default_issues names that role, and project_default refuses for it until identity_apply_to_project replaces or clears it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID."
      },
      "include_archived": {
        "type": "boolean",
        "description": "Include archived music beds. Openers, outros, and cut styles come from the account identity library. Defaults false."
      }
    },
    "required": [
      "project_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "project_title": {
        "type": "string"
      },
      "enabled_for_reels": {
        "type": "boolean",
        "description": "Whether this project identity pack is enabled for future reels. This read reports the setting; it does not manage it."
      },
      "default_issues": {
        "type": "array",
        "description": "Saved project defaults that cannot be used, one per role; empty when every saved default resolves. No other asset is substituted or marked default.",
        "items": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "enum": [
                "identity_asset_not_found"
              ]
            },
            "role": {
              "type": "string",
              "enum": [
                "opener",
                "outro",
                "cut_style"
              ]
            },
            "library_entry_id": {
              "type": "string",
              "description": "The saved default's library entry, which is not in this account library."
            },
            "project_default": {
              "type": "string",
              "enum": [
                "unavailable"
              ],
              "description": "identity:\"project_default\" and configuration:\"project_default\" refuse for this role."
            },
            "message": {
              "type": "string"
            },
            "recovery": {
              "type": "object",
              "description": "Repair the default with this tool and argument: a library_entry_id from replacement_source, or clear_value.",
              "properties": {
                "tool": {
                  "type": "string",
                  "enum": [
                    "identity_apply_to_project"
                  ]
                },
                "argument": {
                  "type": "string",
                  "enum": [
                    "opener_preset_id",
                    "outro_preset_id",
                    "cut_style_id"
                  ]
                },
                "replacement_source": {
                  "type": "string"
                },
                "clear_value": {
                  "type": "string",
                  "enum": [
                    "none"
                  ]
                }
              }
            }
          }
        }
      },
      "assets": {
        "type": "object",
        "properties": {
          "openers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identity library entry public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "preset_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "duration_ms": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "brand_id": {
                  "type": "string"
                },
                "aspect_ratios": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "scene_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sound_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The preset's default sonic mark; customize the concrete identity part to override it."
                },
                "default": {
                  "type": "boolean"
                },
                "uses_title": {
                  "type": "boolean"
                }
              }
            }
          },
          "outros": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identity library entry public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "preset_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "duration_ms": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "brand_id": {
                  "type": "string"
                },
                "aspect_ratios": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "scene_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sound_id": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The preset's default sonic mark; customize the concrete identity part to override it."
                },
                "default": {
                  "type": "boolean"
                },
                "uses_title": {
                  "type": "boolean"
                }
              }
            }
          },
          "cut_styles": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identity library entry public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "style_id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "brand_id": {
                  "type": "string"
                },
                "default": {
                  "type": "boolean"
                },
                "uses_title": {
                  "type": "boolean"
                }
              }
            }
          },
          "identity_sounds": {
            "type": "array",
            "description": "One representative curated take per identity-sound concept. Use an id with episode_edit identity_part.customize set.sound_id.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "family": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "notes": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "aliases": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "account_scenes": {
            "type": "array",
            "description": "Saved account-authored scenes. Use scene_id only through assets.signature_lab.account_scene_id_source for initial replacement or explicit later rebinding of an eligible typed opener/outro.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "scene_id": {
                  "type": "string"
                },
                "revision": {
                  "type": "integer"
                },
                "source_sha256": {
                  "type": "string"
                },
                "settings": {
                  "type": "object"
                }
              }
            }
          },
          "signature_lab": {
            "type": "object",
            "description": "Authoritative compact Signature Lab recipe choices and references to the current dynamic asset rows. initial_apply describes episode_edit identity_part.replace for an occurrence whose fresh read reports identity_replace=true and no identity_customization; rebind describes episode_edit identity_part.customize for an occurrence whose read reports identity_customize=true and identity_customization.params.signature_lab. Neither changes Project defaults.",
            "properties": {
              "schema": {
                "type": "string"
              },
              "layouts": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "curated_scene_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "account_scene_id_source": {
                "type": "string"
              },
              "opener_preset_id_source": {
                "type": "string"
              },
              "outro_preset_id_source": {
                "type": "string"
              },
              "sound_id_source": {
                "type": "string"
              },
              "initial_apply": {
                "type": "object"
              },
              "rebind": {
                "type": "object"
              }
            }
          },
          "music_beds": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Music bed public ID."
                },
                "library_entry_id": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "duration_seconds": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "track_kind": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "family": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 80,
                  "description": "Compact musical family or collection label."
                },
                "mood": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 160,
                  "description": "Compact human-readable mood description."
                },
                "tags": {
                  "type": "array",
                  "maxItems": 8,
                  "items": {
                    "type": "string",
                    "maxLength": 48
                  },
                  "description": "Bounded genre/style tags, including account curation."
                },
                "prompt": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "maxLength": 240,
                  "description": "Compact taste/vibe excerpt used to distinguish otherwise similar tracks."
                },
                "default": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Errors

[
  "project_not_found",
  "invalid_input"
]

Examples

[
  {
    "label": "List identity assets for a branded reel",
    "input": {
      "project_id": "show_..."
    }
  },
  {
    "label": "Include archived music beds",
    "input": {
      "project_id": "show_...",
      "include_archived": true
    }
  }
]