Kuchi

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reference"
  ],
  "properties": {
    "reference": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
    },
    "shot_limit": {
      "type": "integer",
      "default": 40,
      "maximum": 60,
      "minimum": 1,
      "description": "Shots per page (1-60, default 40)"
    },
    "storyboard": {
      "enum": [
        "links",
        "overview",
        "detail"
      ],
      "type": "string",
      "default": "links",
      "description": "'links' (default) returns sheet URLs only; 'overview' or 'detail' also returns one sheet as an image"
    },
    "shot_offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Shots to skip, for videos with many shots"
    },
    "detail_sheet": {
      "type": "integer",
      "default": 1,
      "maximum": 40,
      "minimum": 1,
      "description": "Which detail sheet to return when storyboard=\"detail\" (1 is the start of the video)"
    },
    "response_format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "reference",
    "product_name"
  ],
  "properties": {
    "fps": {
      "type": "number",
      "maximum": 120,
      "minimum": 12,
      "description": "Frame rate you will render at, e.g. 30 or 60; defaults to the reference's. The blueprint's frame numbers use it."
    },
    "tone": {
      "type": "string",
      "maxLength": 100,
      "description": "e.g. 'calm and premium', 'playful'"
    },
    "fonts": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "maxItems": 4,
      "description": "Brand typefaces"
    },
    "assets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "kind",
          "description"
        ],
        "properties": {
          "kind": {
            "enum": [
              "logo",
              "screenshot",
              "screen_recording",
              "product_photo",
              "illustration",
              "music",
              "voiceover",
              "font",
              "other"
            ],
            "type": "string",
            "description": "What the asset is"
          },
          "location": {
            "type": "string",
            "maxLength": 500,
            "description": "URL or file path, if the user gave one. Kuchi never opens it."
          },
          "description": {
            "type": "string",
            "maxLength": 200,
            "description": "What it shows, e.g. 'Dashboard, dark mode'"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 30,
      "description": "Assets the user has provided. Only list assets the user actually gave you."
    },
    "audience": {
      "type": "string",
      "maxLength": 200,
      "description": "Who the video is for"
    },
    "reference": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
    },
    "shot_limit": {
      "type": "integer",
      "default": 40,
      "maximum": 40,
      "minimum": 1,
      "description": "Blueprint shots per page (1-40, default 40)"
    },
    "shot_offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Blueprint shots to skip, for references with many shots"
    },
    "aspect_ratio": {
      "type": "string",
      "maxLength": 20,
      "description": "Output ratio; defaults to the reference's"
    },
    "brand_colors": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 30
      },
      "maxItems": 8,
      "description": "Brand colors, e.g. ['#0B0B0F', '#7C5CFF']"
    },
    "key_features": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "maxItems": 6,
      "description": "1-3 features or moments to show, most important first"
    },
    "product_name": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The user's product name"
    },
    "shot_analysis": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "shot",
          "kind"
        ],
        "properties": {
          "kind": {
            "enum": [
              "title_card",
              "kinetic_type",
              "logo",
              "ui_screen",
              "ui_closeup",
              "device",
              "chart",
              "character",
              "product_render",
              "live_action",
              "collage",
              "abstract",
              "end_card",
              "blank"
            ],
            "type": "string",
            "description": "What the shot is; kuchi_get_breakdown describes each kind"
          },
          "shot": {
            "type": "integer",
            "maximum": 1000,
            "minimum": 1,
            "description": "The reference shot's number, from kuchi_get_breakdown"
          },
          "shows": {
            "type": "string",
            "maxLength": 200,
            "description": "One line on what is on screen and where it sits, e.g. 'Dashboard centered, sidebar left, cursor moves to a button'"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 150,
      "description": "Your reading of the reference's shots from its storyboard sheets. One entry per shot; send as many as you have analysed."
    },
    "call_to_action": {
      "type": "string",
      "maxLength": 120,
      "description": "The closing line or URL, e.g. 'Try it at acme.com'"
    },
    "target_seconds": {
      "type": "integer",
      "maximum": 180,
      "minimum": 5,
      "description": "Target length in seconds; defaults to the reference's length"
    },
    "response_format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data"
    },
    "product_description": {
      "type": "string",
      "maxLength": 500,
      "description": "What the product does and who it is for, in the user's words"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pace": {
      "enum": [
        "slow",
        "medium",
        "fast",
        "rapid"
      ],
      "type": "string",
      "description": "Measured cutting pace: slow is under 1.5 shot changes per 10 s, rapid is 7 or more"
    },
    "sort": {
      "enum": [
        "relevance",
        "newest"
      ],
      "type": "string",
      "default": "relevance",
      "description": "'relevance' (default) or 'newest'"
    },
    "limit": {
      "type": "integer",
      "default": 6,
      "maximum": 20,
      "minimum": 1,
      "description": "Videos per page (1-20, default 6)"
    },
    "query": {
      "type": "string",
      "maxLength": 300,
      "description": "Keywords matched against titles, brands, styles, formats, motion notes and shot descriptions"
    },
    "style": {
      "type": "string",
      "maxLength": 100,
      "description": "Exact motion style, e.g. 'UI motion', 'Kinetic type', 'Device motion'"
    },
    "theme": {
      "enum": [
        "dark",
        "light",
        "mixed"
      ],
      "type": "string",
      "description": "Measured overall brightness"
    },
    "format": {
      "type": "string",
      "maxLength": 100,
      "description": "Format id or name, e.g. 'pastel-ui-cursor-demos'"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Videos to skip, for pagination"
    },
    "category": {
      "type": "string",
      "maxLength": 100,
      "description": "Exact category, e.g. 'AI launch', 'Feature clip', 'Startup launch'"
    },
    "max_seconds": {
      "type": "number",
      "maximum": 600,
      "description": "Only videos at most this long",
      "exclusiveMinimum": 0
    },
    "aspect_ratio": {
      "type": "string",
      "maxLength": 20,
      "description": "Exact ratio, e.g. '16:9', '1:1', '9:16'"
    },
    "response_format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "feedback_type",
    "summary"
  ],
  "properties": {
    "details": {
      "type": "string",
      "description": "Optional longer context: what you tried, exact parameter values, the error text you saw, and any workaround you used. Omit when the summary says it all."
    },
    "summary": {
      "type": "string",
      "description": "One self-contained sentence. For 'missing_capability': the capability you needed, e.g. 'No tool to delete multiple cohorts in one call.' For 'issue': the tool and the problem, e.g. 'query-trends rejects relative date ranges with an unclear error.'"
    },
    "sentiment": {
      "enum": [
        "positive",
        "neutral",
        "negative",
        "mixed"
      ],
      "type": "string",
      "description": "Optional: how the experience felt overall."
    },
    "tool_name": {
      "type": "string",
      "description": "Optional: the existing tool this feedback is about (for 'issue' or 'praise'). Leave empty for 'missing_capability' - the point is that no tool fits."
    },
    "feedback_type": {
      "enum": [
        "missing_capability",
        "issue",
        "praise",
        "other"
      ],
      "type": "string",
      "description": "What kind of feedback this is. Use 'missing_capability' when the tool you needed does not exist in the tool list - nothing failed, the capability is absent. Use 'issue' when an existing tool behaved badly: it failed, returned a confusing error, or its description or schema misled you. Use 'praise' when something worked notably well. Use 'other' for anything else."
    },
    "task_completed": {
      "type": "boolean",
      "description": "Optional: whether you still completed the user's task despite the problem."
    },
    "friction_points": {
      "type": "string",
      "description": "Optional: the specific moments that slowed you down, as short bullet-like sentences, quoting exact tool names, parameters, or error text."
    },
    "suggested_improvement": {
      "type": "string",
      "description": "Optional: the concrete change that would have helped, e.g. the tool to add, the description to reword, or the error message to improve."
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "pace": {
      "enum": [
        "slow",
        "medium",
        "fast",
        "rapid"
      ],
      "type": "string",
      "description": "Preferred cutting pace"
    },
    "count": {
      "type": "integer",
      "default": 3,
      "maximum": 6,
      "minimum": 1,
      "description": "Choices to return (1-6, default 3)"
    },
    "theme": {
      "enum": [
        "dark",
        "light",
        "mixed"
      ],
      "type": "string",
      "description": "Preferred overall brightness"
    },
    "styles": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 100
      },
      "maxItems": 5,
      "description": "Preferred motion styles, e.g. ['UI motion', 'Kinetic type']; kuchi_list_filters has the full list"
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 500,
        "minLength": 1,
        "description": "A Kuchi video id ('34'), slug, Kuchi link (https://kuchi.kalarislabs.com/#video-34) or the original X post URL"
      },
      "maxItems": 20,
      "description": "Videos the user has already turned down"
    },
    "looking_for": {
      "type": "string",
      "maxLength": 300,
      "description": "A few words on the product and the feel wanted, e.g. 'AI note-taking app, calm and premium'"
    },
    "aspect_ratio": {
      "type": "string",
      "maxLength": 20,
      "description": "Output ratio wanted, e.g. '16:9', '1:1', '9:16'"
    },
    "target_seconds": {
      "type": "integer",
      "maximum": 180,
      "minimum": 5,
      "description": "Length wanted, in seconds"
    },
    "response_format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "default": "markdown",
      "description": "'markdown' (default) for readable text, 'json' for structured data"
    },
    "available_assets": {
      "type": "array",
      "items": {
        "enum": [
          "logo",
          "screenshot",
          "screen_recording",
          "product_photo",
          "illustration",
          "music",
          "voiceover",
          "font",
          "other"
        ],
        "type": "string"
      },
      "maxItems": 9,
      "description": "The kinds of asset the user can supply. Templates that need something else rank lower and say so."
    }
  },
  "additionalProperties": false
}