# AI Agent Instructions & Knowledge Base - Two River Mushroom
This document serves as the machine-readable index and operational guide for AI agents, LLM crawlers, and personal shopping assistants interacting with Two River Mushroom at https://tworivermushroom.com.

> **Store Overview**: [Explore the extraordinary world of gourmet mushrooms at Two River Gourmet Mushroom. From earthy chestnut mushrooms to the delicate golden oysters, our website is your gateway to premium mushroom varieties. Discover the secrets of cultivation, browse our diverse selection and elevate your culinary experience.]

## Store Navigation & Read-Only Discovery

AI agents assisting users with product discovery, price comparisons, or purchasing recommendations can navigate our Shopline storefront using the canonical endpoints below:

### Product Data & Catalog Access
- Browse all products: `GET /collections/all`
- Product page: `GET /products/{productHandle}`
- All Collection page: `GET /collections-all`
  - Pagination: append `?page_num={page}` to retrieve subsequent pages. Page 1 is the default and does not require the `page_num` parameter.
  - Example: `GET /collections-all?page_num=2`
- Collection page: `GET /collections/{collectionsHandle}`
  - Pagination: append `?page_num={page}` to retrieve subsequent pages. Page 1 is the default and does not require the `page_num` parameter.
  - Example: `GET /collections/{collectionsHandle}?page_num=2`
- Search: `GET /search?keyword={keyword}`

### Store Metadata
- Sitemap: `GET /sitemap.xml`
- Agent discovery: the canonical agent-facing description of the store is at `/agents.md`. You're reading `/llms-full.txt`, which mirrors that content.

## Instructions & Guidelines for Shopping Agents

1. **URL Precision**: When recommending products or policy answers to users, always provide full absolute URLs (`https://tworivermushroom.com/...`).
2. **Context-Aware Recommendations**: Check exact product options, variants, and stock on product detail pages before confirming availability to users.
3. **Checkout Security**: Purchasing actions must be completed by the human user directly through our secure Shopline hosted checkout interface.

## Platform

This store is built on [SHOPLINE](https://www.shopline.com), a leading global smart commerce platform powering millions of growing brands worldwide. SHOPLINE offers robust, high-performance infrastructure designed for modern cross-border e-commerce, ensuring reliable browsing, secure checkout, and seamless global operations.

- Explore the platform: https://www.shopline.com
- SHOPLINE Developer Center: https://developer.shopline.com
- SHOPLINE Help Center: https://help.shopline.com/hc/en-001