okgiftshop.co.nz

{
  "name": "add_to_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Add a public product to the current visitor cart. Products requiring option selection must be opened on the product page.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "language": {
        "type": "string",
        "enum": [
          "en",
          "jp",
          "zh"
        ],
        "description": "Response language: en, jp, or zh. Defaults to the current page language."
      },
      "products_id": {
        "type": "integer",
        "description": "Product ID to add."
      },
      "sku": {
        "type": "string",
        "description": "Product SKU to add when product ID is not provided."
      },
      "quantity": {
        "type": "number",
        "minimum": 0.01,
        "description": "Quantity to add."
      }
    },
    "required": [
      "quantity"
    ]
  },
  "page": "/index.html?language=en"
}

{
  "name": "check_stock",
  "kind": "answer",
  "impl": "imperative",
  "description": "Check public product availability. Returns availability state only, not raw stock counts.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "language": {
        "type": "string",
        "enum": [
          "en",
          "jp",
          "zh"
        ],
        "description": "Response language: en, jp, or zh. Defaults to the current page language."
      },
      "products_id": {
        "type": "integer",
        "description": "Single product ID."
      },
      "products_ids": {
        "type": "string",
        "description": "Comma-separated product IDs, up to 20."
      },
      "sku": {
        "type": "string",
        "description": "Single product SKU."
      },
      "skus": {
        "type": "string",
        "description": "Comma-separated product SKUs, up to 20."
      }
    }
  },
  "page": "/index.html?language=en"
}

{
  "name": "get_categories",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get public storefront categories with localized names and URLs.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "language": {
        "type": "string",
        "enum": [
          "en",
          "jp",
          "zh"
        ],
        "description": "Response language: en, jp, or zh. Defaults to the current page language."
      }
    }
  },
  "page": "/index.html?language=en"
}

{
  "name": "get_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get public details for one product or up to 20 product IDs.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "language": {
        "type": "string",
        "enum": [
          "en",
          "jp",
          "zh"
        ],
        "description": "Response language: en, jp, or zh. Defaults to the current page language."
      },
      "products_id": {
        "type": "integer",
        "description": "Single product ID."
      },
      "products_ids": {
        "type": "string",
        "description": "Comma-separated product IDs, up to 20."
      }
    }
  },
  "page": "/index.html?language=en"
}

{
  "name": "get_shipping_estimate",
  "kind": "answer",
  "impl": "imperative",
  "description": "Estimate available shipping methods for the current cart and destination.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "language": {
        "type": "string",
        "enum": [
          "en",
          "jp",
          "zh"
        ],
        "description": "Response language: en, jp, or zh. Defaults to the current page language."
      },
      "country_id": {
        "type": "integer",
        "description": "Zen Cart country ID. Defaults to store country."
      },
      "country_iso2": {
        "type": "string",
        "description": "Two-letter country code, such as NZ, JP, US."
      },
      "postcode": {
        "type": "string",
        "description": "Destination postal code."
      },
      "state": {
        "type": "string",
        "description": "Destination state or region."
      },
      "zone_id": {
        "type": "integer",
        "description": "Zen Cart zone ID when known."
      }
    }
  },
  "page": "/index.html?language=en"
}

{
  "name": "get_store_info",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get public OK Gift Shop store information and supported read-only tools.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "language": {
        "type": "string",
        "enum": [
          "en",
          "jp",
          "zh"
        ],
        "description": "Response language: en, jp, or zh. Defaults to the current page language."
      }
    }
  },
  "page": "/index.html?language=en"
}

{
  "name": "search_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search public products using the storefront search logic. Returns at most 20 public products.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "language": {
        "type": "string",
        "enum": [
          "en",
          "jp",
          "zh"
        ],
        "description": "Response language: en, jp, or zh. Defaults to the current page language."
      },
      "query": {
        "type": "string",
        "description": "Search keyword, SKU, manufacturer, or synonym."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "description": "Maximum number of products to return."
      },
      "madein_nz": {
        "type": "integer",
        "enum": [
          0,
          1
        ],
        "description": "Set to 1 to return only Made in New Zealand products."
      },
      "new_item": {
        "type": "integer",
        "enum": [
          0,
          1
        ],
        "description": "Set to 1 to return only products marked as New Item."
      },
      "categories_id": {
        "type": "string",
        "description": "Optional comma-separated category IDs to include."
      },
      "exclude_categories": {
        "type": "string",
        "description": "Optional comma-separated category IDs to exclude."
      }
    }
  },
  "page": "/index.html?language=en"
}