spree.apparel.monster

{
  "name": "search_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search for apparel products by name, category (taxon permalink), price range, or stock status. Returns up to 20 results with name, price, and URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Keyword to match against product names, e.g. 'denim shirt'."
      },
      "taxon": {
        "type": "string",
        "description": "Permalink filter, e.g. 'categories/men/shirts' or 'collections/new-arrivals'."
      },
      "min_price": {
        "type": "number",
        "minimum": 0,
        "description": "Minimum price in USD."
      },
      "max_price": {
        "type": "number",
        "minimum": 0,
        "description": "Maximum price in USD."
      },
      "in_stock": {
        "type": "boolean",
        "description": "If true, only return purchasable items in stock.",
        "default": true
      },
      "sort": {
        "type": "string",
        "enum": [
          "popularity",
          "-popularity",
          "price",
          "-price",
          "name",
          "-name",
          "-available_on"
        ],
        "description": "Sort order.",
        "default": "-popularity"
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "default": 10
      }
    }
  }
}

{
  "name": "get_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch full details for one product by slug, including variants (sizes/colors) and stock status.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Product slug, e.g. 'denim-shirt'."
      }
    },
    "required": [
      "slug"
    ]
  }
}

{
  "name": "list_categories",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns top-level and nested categories (taxons) of the apparel catalog — Men, Women, Sportswear, Brands, Collections, and promotional groupings.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "parent": {
        "type": "string",
        "description": "Optional permalink filter for children of a given parent, e.g. 'categories/men'."
      }
    }
  }
}

{
  "name": "view_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Returns the agent's current cart (line items, quantities, totals). Creates an empty cart if none exists.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "add_to_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Adds a product variant (specific size/color combination) to the cart. Requires user confirmation. Returns the updated cart summary.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "variant_id": {
        "type": "integer",
        "description": "The variant ID (NOT the product ID). Get this from get_product → variants."
      },
      "quantity": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10,
        "default": 1
      }
    },
    "required": [
      "variant_id"
    ]
  }
}

{
  "name": "apply_coupon",
  "kind": "act",
  "impl": "imperative",
  "description": "Apply a promotion or discount code to the current cart. Returns whether the promo was accepted.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "coupon_code": {
        "type": "string"
      }
    },
    "required": [
      "coupon_code"
    ]
  }
}

{
  "name": "go_to_checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Navigates the current tab to the checkout page for the active cart. Requires user confirmation.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}

{
  "name": "get_store_info",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns the store name, currency, API base URL, and pointers to all /.well-known/ discovery endpoints.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  }
}