actually-instant.pages.dev

{
  "name": "get_user",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get the current shopper's name, membership, and delivery location so shopping choices and offer eligibility can be tailored to them.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_suggested_requests",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get natural example requests to help a shopper who asks what the assistant can do or is unsure how to get started.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_stores",
  "kind": "answer",
  "impl": "imperative",
  "description": "List stores available to the shopper with delivery and service fees. Compare stores again when the shopper's needs change.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "search_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Find grocery products across stores or within one store. Search again when the shopper changes their request so product and store choices can be reconsidered, not merely patched into an earlier cart.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Words from the desired product name."
      },
      "retailer": {
        "type": "string",
        "enum": [
          "costco",
          "foodsco",
          "grocery-outlet",
          "lucky-supermarkets",
          "raleys",
          "safeway",
          "target-corp",
          "walmart"
        ],
        "description": "Store slug returned by get_stores."
      },
      "aisle": {
        "type": "string",
        "enum": [
          "baked-goods",
          "beverages",
          "breakfast-foods",
          "canned-goods",
          "condiments-sauces",
          "dairy",
          "dry-goods-pasta",
          "frozen",
          "household",
          "meat-and-seafood",
          "oils-vinegars-spices",
          "produce",
          "snacks-and-candy"
        ],
        "description": "Aisle slug returned in product and catalog results."
      },
      "maximumPrice": {
        "type": "number",
        "minimum": 0,
        "description": "Maximum unit price in USD, such as 9.99."
      },
      "minimumRating": {
        "type": "number",
        "minimum": 0,
        "maximum": 5
      },
      "inStockOnly": {
        "type": "boolean",
        "default": true
      },
      "sort": {
        "type": "string",
        "enum": [
          "relevance",
          "price-low",
          "rating"
        ]
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 20
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "get_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get current price, size, rating, availability, aisles, and labels for one store-specific product before selecting it for the shopper.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "retailer": {
        "type": "string",
        "enum": [
          "costco",
          "foodsco",
          "grocery-outlet",
          "lucky-supermarkets",
          "raleys",
          "safeway",
          "target-corp",
          "walmart"
        ],
        "description": "Store slug returned by get_stores."
      },
      "productId": {
        "type": "integer",
        "minimum": 0
      }
    },
    "required": [
      "retailer",
      "productId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "get_carts",
  "kind": "answer",
  "impl": "imperative",
  "description": "Review every current cart with items, payment methods, discounts, fees, and totals. Call this after the shopper edits a cart or changes their request, then reassess all candidate carts before recommending one.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "get_promotions",
  "kind": "answer",
  "impl": "imperative",
  "description": "List current offers and discount codes with eligibility and payment requirements. Recheck these when building or revising the shopper's options.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "retailer": {
        "type": "string",
        "enum": [
          "costco",
          "foodsco",
          "grocery-outlet",
          "lucky-supermarkets",
          "raleys",
          "safeway",
          "target-corp",
          "walmart"
        ],
        "description": "Store slug returned by get_stores."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "get_payment_methods",
  "kind": "answer",
  "impl": "imperative",
  "description": "List the shopper's available cards and wallets so payment-specific savings can be included when comparing final totals.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}

{
  "name": "create_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Create an agent-generated candidate cart for one store while helping the shopper compare possible options.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "retailer": {
        "type": "string",
        "enum": [
          "costco",
          "foodsco",
          "grocery-outlet",
          "lucky-supermarkets",
          "raleys",
          "safeway",
          "target-corp",
          "walmart"
        ],
        "description": "Store slug returned by get_stores."
      }
    },
    "required": [
      "retailer"
    ],
    "additionalProperties": false
  }
}

{
  "name": "remove_cart",
  "kind": "transact",
  "impl": "imperative",
  "description": "Permanently remove an existing cart and all of its items.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cartId": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": [
      "cartId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "add_to_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Add one or more units of a selected product to a candidate cart. After changes, review current totals before deciding which cart best helps the shopper.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cartId": {
        "type": "string",
        "minLength": 1
      },
      "productId": {
        "type": "integer",
        "minimum": 0
      },
      "quantity": {
        "type": "integer",
        "minimum": 1,
        "maximum": 999,
        "default": 1
      }
    },
    "required": [
      "cartId",
      "productId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "change_cart_item_quantity",
  "kind": "act",
  "impl": "imperative",
  "description": "Increase or decrease a cart product by a number of units; decreasing to zero removes it. Reassess carts after meaningful shopper changes.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cartId": {
        "type": "string",
        "minLength": 1
      },
      "productId": {
        "type": "integer",
        "minimum": 0
      },
      "direction": {
        "type": "string",
        "enum": [
          "increase",
          "decrease"
        ]
      },
      "quantity": {
        "type": "integer",
        "minimum": 1,
        "maximum": 999,
        "default": 1
      }
    },
    "required": [
      "cartId",
      "productId",
      "direction"
    ],
    "additionalProperties": false
  }
}

{
  "name": "update_cart_item",
  "kind": "act",
  "impl": "imperative",
  "description": "Set a cart product's exact quantity, using zero to remove it. Review products, offers, and totals again when the shopper's request changes.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cartId": {
        "type": "string",
        "minLength": 1
      },
      "productId": {
        "type": "integer",
        "minimum": 0
      },
      "quantity": {
        "type": "integer",
        "minimum": 0,
        "maximum": 999
      }
    },
    "required": [
      "cartId",
      "productId",
      "quantity"
    ],
    "additionalProperties": false
  }
}

{
  "name": "apply_promotion",
  "kind": "act",
  "impl": "imperative",
  "description": "Apply an eligible saved promotion code to matching carts.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "code": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": [
      "code"
    ],
    "additionalProperties": false
  }
}

{
  "name": "remove_promotion",
  "kind": "act",
  "impl": "imperative",
  "description": "Remove a promotion code currently applied to the shopper's carts.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "code": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": [
      "code"
    ],
    "additionalProperties": false
  }
}

{
  "name": "set_cart_payment_method",
  "kind": "transact",
  "impl": "imperative",
  "description": "Select one available card or wallet for a cart, including promotion qualification.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cartId": {
        "type": "string",
        "minLength": 1
      },
      "paymentMethodId": {
        "type": "string",
        "enum": [
          "card",
          "apple-pay",
          "paypal"
        ]
      }
    },
    "required": [
      "cartId",
      "paymentMethodId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "recommend_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Mark one cart as the assistant's current recommendation. Use only after reassessing relevant products, offers, payment requirements, fees, and totals across all candidate carts; replace the recommendation whenever shopper changes make another option better.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cartId": {
        "type": "string",
        "minLength": 1
      },
      "reason": {
        "type": "string",
        "maxLength": 200,
        "description": "A short shopper-facing explanation of why this cart is preferred."
      }
    },
    "required": [
      "cartId"
    ],
    "additionalProperties": false
  }
}

{
  "name": "show_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Open an existing cart in the visible application for the shopper to inspect or edit.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "cartId": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": [
      "cartId"
    ],
    "additionalProperties": false
  }
}