Agentee

Search the allover.art catalog (one card per design). Args: query? (free text, e.g. 'cat', 'neon koi'), theme? (canonical theme like Cats/Anime/Skulls, comma-separated for several), section? (mens|womens|kids), limit? (<=48), max_price? (USD). Returns product cards with good_id, price and url.

Full details of one product by its code: available sizes, fabrics, per-variant price, and the design 'about' text. Args: code (from search_products).

List active curated collections (themed landing pages) with their slugs and urls. Args: limit?.

Show the current contents of the user's cart (the same cart they see in the browser when signed in).

Add a product to the user's cart. Args: good_id (from search/get_product), size (must be one of the product's sizes), fabric? (if the product offers a choice), qty? (default 1). Returns the updated cart.

Change the quantity of a cart line by its index (from view_cart); qty=0 removes it. Args: index, qty.

Get the URL where the human opens their cart to review and pay. The agent never pays — checkout is always done by the person in the browser.

Look up the user's recent orders (or one by number) and their fulfilment status. Args: number?, limit? (default 5).

Change a cart line by its index (from view_cart): set qty (0 removes), or switch size/fabric. Args: index, qty?, size?, fabric?.

Remove a cart line by its index (from view_cart). Args: index.

Validate and apply a promo code to the cart (server-checked). Returns the new discount/shipping/total, or applied=false with a reason. Args: code.

Remove the applied promo code from the cart.

Return the shopper's saved default size and fit. Call this BEFORE asking the user for a size — if a default is set, apply it automatically (add_to_cart uses it when size is omitted), and prefer products matching their fit (basic vs oversized).

Save the shopper's default size and/or fit so they don't re-enter it each time. Args: size (XS…5XL), fit (basic | oversized). Pass only what the user stated.

Return shipping addresses the user used in past orders — offer these to a returning buyer instead of asking again.

Set the shipping address for this order (validated). Args: name, country, city, address, zip?, phone.

Available shipping methods for the current cart/address, with price and ETA (free over the threshold).

Choose a shipping method by its option_id (from get_shipping_options). Args: option_id.

Full order summary to show the human before ordering: line items, promo/discount, shipping, address, grand total. Prices are server-computed.

Create a draft order from the cart + address + promo and return {checkout_url, draft_id, expires_at}. The human opens checkout_url — everything is pre-filled — reviews and pays. The agent never pays. Call get_order_preview and confirm with the human first.

START HERE for any custom-print request: the menu of generation choices (print placements with plain-language descriptions, products, backgrounds, engines+costs). Present these to the human — at minimum ask which PLACEMENT and which PRODUCT they want — before calling studio_generate.

Generate a CUSTOM t-shirt print from a text prompt (AI, takes 2-10 min). SPENDS THE ACCOUNT OWNER'S STUDIO CREDITS: tell them the cost and their balance and get a yes BEFORE calling this — never spend silently, and never spend to 'try something' on your own initiative. Credits are earned (20 free on signup, 20 with every tee bought), so a wasted one is a real loss to them. Free exception: preserve

Check a custom print generation. Args: print_id (from studio_generate). When done returns preview_url — show it to the human.

The user's Studio credit balance. Check before studio_generate (1 credit per generation, either engine; welcome bonus 20; every bought tee adds 20).

Put a FINISHED custom print into the cart as a product. Args: print_id (must be done), product? (same set as studio_generate), size, qty?. Then the normal checkout flow applies (get_order_preview -> prepare_order).

The user's designer-program stats (if they are a designer-partner): units sold, revenue, accrued royalties, available for payout, royalty percent, their designer page URL.

The user's own published designs with live status (products on sale / hidden / pending). Args: limit? (default 50).

Get a short-lived URL to upload an image file to us (use when the designer has no public link — otherwise pass the URL straight to submit_design). Args: filename?. PUT the raw bytes to upload_url, then pass the returned upload_id to submit_design.

Send one of the designer's own artworks for moderation. TWO inputs, same path: either artwork files — front/back accept a public image URL OR an upload_id from designer_upload_slot — or session_id of a FINISHED Studio session of theirs (generated with studio_generate; no need to download the print, we fetch it server-side). Args: name (required), front OR session_id (one of them), back?, layout? (

What the designer has already sent in and where it stands: in review / accepted / needs changes (with the reason). Args: limit?.

The user's Studio publications in moderation: in review / in catalog / needs changes. Args: limit?.

My colorway sets: one catalog card per set instead of one per colour. No args.

Group my recolours of ONE artwork into a set (2+ of my designs). The catalog then shows one card for the set; every variant keeps its own page and link. Args: design_ids (list of my design ids), primary? (which one represents the set).

Add one more of my recolours to a set of mine. Args: colorway_id, design_id.

Take one of my designs out of its set — it gets its own catalog card again. A set left with a single variant is dissolved. Args: design_id.

Choose which variant of my set represents it in the catalog. Args: colorway_id, design_id.