Ensure an authenticated session with the Tuma250 site.

Logs in using the configured credentials if the current session is not already authenticated. Subsequent tool calls auto-login as needed, so calling this tool explicitly is optional.

Returns: dict: {"success": bool, "message": str}

Search for products on the Tuma250 grocery site.

Args: query: Free-text search string, e.g. "butter 500g" or "rice 5kg". max_results: Maximum number of products to return (default 10).

Returns: list of product objects, each containing: - id (str | None): WooCommerce product ID. - name (str | None): Product display name. - brand (str | None): Brand name if available. - package_size (str | None): Package size / unit description. - price (float | None): Unit price. - url (str | None): Product page URL. - category_path (str | None): Category breadcrumb.

Return the available variants for a variable WooCommerce product.

Call this when search_products returns a product and you need to know which size/weight options exist before adding it to the cart.

Args: product_url: Full product page URL (from search_products result["url"]).

Returns: list of variation objects, each containing: - variation_id (str): Pass this to add_to_cart. - attributes (dict): Human-readable attributes, e.g. {"quantity": "500g"}. - raw_attributes (dict): WooCommerce attribute keys, e.g. {"attribute_quantity": "500g"}. - price (float | None): Price for this variant. - in_stock (bool): Whether this variant is currently available. Returns an empty list for simple (non-variable) products.

Add a product to the Tuma250 shopping cart.

Uses the product slug (from search_products URL or get_order_details). For variable products, pass variation_attributes so the page pre-selects the variant, e.g. {"attribute_quantity": "500g"}.

Args: product_slug: Product URL slug, e.g. "fresh-carrots-1kg" (from URL or get_order_details items). quantity: Number of units to add (default 1). variation_attributes: For variable products, attribute key/value pairs e.g. {"attribute_quantity": "500g"} (from get_order_details or get_product_variations raw_attributes).

Returns: dict containing: - success (bool): Whether the item was confirmed in the cart. - cart_total_items (int): Total number of line items in the cart. - cart_total_price (float | None): Cart grand total. - line_item_summary (list): Each item with id, slug, variation_attributes, name, qty.

Retrieve the current contents of the Tuma250 shopping cart.

Returns: dict containing: - items (list): Each item with product_id, slug, variation_attributes, name, qty, price, subtotal. - total_items (int): Number of distinct line items. - subtotal (float | None): Items cost before shipping. - shipping_options (list): Available shipping methods with label and price. - total (float | None): Grand total including selected shipping.

List recent orders from the Tuma250 "My Orders" page.

Args: limit: Maximum number of orders to return (default 10).

Returns: list of order summary objects, each containing: - order_id (str | None) - date (str | None) - status (str | None) - total (float | None) - link (str | None): URL to the order detail page.

Fetch the line items for a specific Tuma250 order.

Args: order_id: The WooCommerce order ID (from list_recent_orders).

Returns: dict containing: - order_id (str) - items (list): Each item with slug, variation_attributes, name, qty, price, brand, unit_size, category_path.