fashion-starter.agilo.com

{
  "name": "products.search",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search and retrieve product information (price, variants, options, categories, tags) with optional filters and sorting.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search query. Can be omitted to fetch products by filters only."
      },
      "collection_ids": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "category_ids": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "type_ids": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "sort": {
        "type": "string",
        "enum": [
          "latest_arrivals",
          "lowest_price",
          "highest_price"
        ]
      },
      "limit": {
        "type": "number",
        "minimum": 1,
        "maximum": 36
      }
    },
    "additionalProperties": false
  },
  "page": "/hr"
}

{
  "name": "navigation.toProduct",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate to product detail page, optionally preselect options. For products with Material and Color, Material must be set before Color.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "handle": {
        "type": "string",
        "description": "Product handle/slug"
      },
      "options": {
        "type": "object",
        "description": "Optional option map like { Material: 'Cotton', Size: 'M' }. If providing Color, also provide Material.",
        "additionalProperties": {
          "type": "string"
        }
      }
    },
    "required": [
      "handle"
    ],
    "additionalProperties": false
  },
  "page": "/hr"
}

{
  "name": "navigation.toCart",
  "kind": "act",
  "impl": "imperative",
  "description": "Navigate to shopping cart page",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/hr"
}

{
  "name": "cart.manage",
  "kind": "act",
  "impl": "imperative",
  "description": "Manage shopping cart (add, remove, update, view)",
  "inputSchema": {
    "type": "object",
    "properties": {
      "action": {
        "type": "string",
        "enum": [
          "add",
          "remove",
          "update",
          "view"
        ],
        "description": "Action to perform"
      },
      "variant_id": {
        "type": "string",
        "description": "Variant ID (required for add)"
      },
      "quantity": {
        "type": "number",
        "description": "Quantity for the action. Optional for add (defaults to 1), required for update."
      },
      "line_id": {
        "type": "string",
        "description": "Line item ID (required for remove/update)"
      }
    },
    "required": [
      "action"
    ],
    "oneOf": [
      {
        "properties": {
          "action": {
            "const": "add"
          },
          "variant_id": {
            "type": "string"
          }
        },
        "required": [
          "action",
          "variant_id"
        ]
      },
      {
        "properties": {
          "action": {
            "const": "remove"
          },
          "line_id": {
            "type": "string"
          }
        },
        "required": [
          "action",
          "line_id"
        ]
      },
      {
        "properties": {
          "action": {
            "const": "update"
          },
          "line_id": {
            "type": "string"
          },
          "quantity": {
            "type": "number",
            "minimum": 0
          }
        },
        "required": [
          "action",
          "line_id",
          "quantity"
        ]
      },
      {
        "properties": {
          "action": {
            "const": "view"
          }
        },
        "required": [
          "action"
        ]
      }
    ],
    "additionalProperties": false
  },
  "page": "/hr"
}

{
  "name": "cart.applyPromotion",
  "kind": "act",
  "impl": "imperative",
  "description": "Apply a discount/promotion code to the shopping cart. Returns updated cart with applied discount, including new subtotal, total, and discount amount. Common error codes: MISSING_CODE (promotion code is required), CART_MISSING (no active cart found), APPLY_FAILED (failed to apply promotion code).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "code": {
        "type": "string",
        "description": "Promotion/discount code to apply (e.g., 'SUMMER25', 'FREESHIP')"
      }
    },
    "additionalProperties": false,
    "required": [
      "code"
    ]
  },
  "page": "/hr"
}

{
  "name": "cart.removePromotion",
  "kind": "act",
  "impl": "imperative",
  "description": "Remove a previously applied discount/promotion code from the shopping cart. Returns updated cart with recalculated totals after discount removal. Use this when the user wants to replace a code or remove an applied discount.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "code": {
        "type": "string",
        "description": "Promotion/discount code to remove (must match an applied code)"
      }
    },
    "additionalProperties": false,
    "required": [
      "code"
    ]
  },
  "page": "/hr"
}

{
  "name": "checkout.prepare",
  "kind": "act",
  "impl": "imperative",
  "description": "Validate that the shopping cart has items and navigate to the checkout page. Performs pre-checkout validation (checks cart exists and is not empty) before proceeding. Returns error if cart is missing or empty.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/hr"
}