optimuspi.github.io

{
  "name": "get_app_state",
  "kind": "answer",
  "impl": "imperative",
  "description": "Current Blueprint state: loaded seed, deck, stake, ante range, active view, selected ante/blind, purchase count, seed queue position, and saved user notes.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "analyze_seed",
  "kind": "act",
  "impl": "imperative",
  "description": "Load a Balatro seed into Blueprint and analyze it (shop queues, packs, vouchers, tags, bosses per ante). Optionally set deck, stake and how many antes to generate. Returns a compact per-ante overview.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "seed": {
        "type": "string",
        "description": "1-8 characters, A-Z and 1-9 (no zero)."
      },
      "deck": {
        "type": "string",
        "enum": [
          "Red Deck",
          "Blue Deck",
          "Yellow Deck",
          "Green Deck",
          "Black Deck",
          "Magic Deck",
          "Nebula Deck",
          "Ghost Deck",
          "Abandoned Deck",
          "Checkered Deck",
          "Zodiac Deck",
          "Painted Deck",
          "Anaglyph Deck",
          "Plasma Deck",
          "Erratic Deck"
        ]
      },
      "stake": {
        "type": "string",
        "enum": [
          "White Stake",
          "Red Stake",
          "Green Stake",
          "Black Stake",
          "Blue Stake"
        ]
      },
      "maxAnte": {
        "type": "integer",
        "minimum": 1,
        "maximum": 39
      }
    },
    "required": [
      "seed"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "get_seed_overview",
  "kind": "answer",
  "impl": "imperative",
  "description": "Per-ante overview of the loaded seed (or a given seed without loading it): boss, voucher, tags, first shop items and every booster pack with its contents.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "seed": {
        "type": "string",
        "description": "Defaults to the loaded seed."
      },
      "shopLimit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100,
        "description": "Shop items to include per ante (default 12)."
      }
    },
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "get_ante_details",
  "kind": "answer",
  "impl": "imperative",
  "description": "Everything Blueprint knows about one ante: full shop queue with indices, packs per blind with card indices, misc card sources (Riff-raff, Judgement, Wraith, The Soul...), tags, voucher, boss.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ante": {
        "type": "integer",
        "minimum": 0,
        "maximum": 39
      },
      "seed": {
        "type": "string",
        "description": "Defaults to the loaded seed."
      }
    },
    "required": [
      "ante"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "find_items",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the loaded seed (or a given seed) for jokers, consumables, vouchers, tags or bosses by name (case-insensitive substring). Returns where each appears: ante, shop index, pack, or misc source. Legendary jokers (Perkeo, Triboulet, Yorick, Chicot, Canio) only resolve when showCardSpoilers is on (set_options); otherwise search for 'The Soul'.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "names": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "minItems": 1,
        "description": "e.g. [\"Perkeo\", \"Diet Cola\", \"Negative Tag\", \"Ankh\"]"
      },
      "seed": {
        "type": "string",
        "description": "Defaults to the loaded seed."
      }
    },
    "required": [
      "names"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "go_to_ante",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate the Blueprint view to an ante and optionally a blind so the user sees it.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ante": {
        "type": "integer",
        "minimum": 0,
        "maximum": 39
      },
      "blind": {
        "type": "string",
        "enum": [
          "smallBlind",
          "bigBlind",
          "bossBlind"
        ]
      }
    },
    "required": [
      "ante"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "buy_item",
  "kind": "transact",
  "impl": "imperative",
  "description": "Mark a shop item or pack card as purchased in the loaded seed. Purchases change later RNG exactly like the game, so re-read the overview afterwards. Use indices from get_ante_details.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ante": {
        "type": "integer",
        "minimum": 0,
        "maximum": 39
      },
      "source": {
        "type": "string",
        "enum": [
          "shop",
          "pack"
        ]
      },
      "index": {
        "type": "integer",
        "minimum": 0,
        "description": "Shop queue index, or card index inside the pack."
      },
      "blind": {
        "type": "string",
        "enum": [
          "smallBlind",
          "bigBlind",
          "bossBlind"
        ],
        "description": "Required for packs."
      },
      "packIndex": {
        "type": "integer",
        "minimum": 0,
        "description": "Required for packs: pack position within the blind."
      }
    },
    "required": [
      "ante",
      "source",
      "index"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "set_options",
  "kind": "act",
  "impl": "imperative",
  "description": "Change analysis options. showCardSpoilers reveals what The Soul, Judgement and Wraith give (legendary jokers show as 'The Soul' until it is on). cardsPerAnte is how deep each shop queue is generated; maxMiscCardSource how many cards each misc source lists. The seed is re-analyzed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "showCardSpoilers": {
        "type": "boolean"
      },
      "cardsPerAnte": {
        "type": "integer",
        "minimum": 1,
        "maximum": 1000
      },
      "maxMiscCardSource": {
        "type": "integer",
        "minimum": 1,
        "maximum": 100
      }
    },
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "list_purchases",
  "kind": "answer",
  "impl": "imperative",
  "description": "List every purchase the user has marked in the loaded seed.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "clear_purchases",
  "kind": "act",
  "impl": "imperative",
  "description": "Remove every marked purchase from the loaded seed.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "load_seed_list",
  "kind": "act",
  "impl": "imperative",
  "description": "Load many seeds into the seed queue (one per line, whitespace or comma separated; CSV first column). The first seed is analyzed immediately; the user steps through the rest with the arrow keys.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "seeds": {
        "type": "string",
        "description": "Raw text containing the seeds."
      }
    },
    "required": [
      "seeds"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "step_seed_queue",
  "kind": "act",
  "impl": "imperative",
  "description": "Move through the loaded seed queue: delta of +1/-1 steps, or an absolute index. Loads and analyzes that seed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "delta": {
        "type": "integer"
      },
      "index": {
        "type": "integer",
        "minimum": 0
      }
    },
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "set_view",
  "kind": "act",
  "impl": "imperative",
  "description": "Switch the main view: 'blueprint' (seed explorer) or 'jaml' (JAML seed search IDE).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "view": {
        "type": "string",
        "enum": [
          "blueprint",
          "jaml"
        ]
      }
    },
    "required": [
      "view"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "remember",
  "kind": "act",
  "impl": "imperative",
  "description": "Save a short note about this user (favourite decks, strategies they like, seeds they are hunting). Notes persist in their browser and are shown to every future assistant session.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "note": {
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      }
    },
    "required": [
      "note"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "get_jaml_filter",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the JAML filter currently in the JAML search editor.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}

{
  "name": "set_jaml_filter",
  "kind": "act",
  "impl": "imperative",
  "description": "Replace the JAML filter in the JAML search editor and switch to the JAML view. JAML is Jimbo's Ante Markup Language: name/deck/stake plus must/should/mustNot clause lists.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "jaml": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": [
      "jaml"
    ],
    "additionalProperties": false
  },
  "page": "/Blueprint/"
}