=== OutSurface Agent View ===
Contributors: outsurface
Tags: ai, agents, llm, woocommerce, automation
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Creates an AI-agent-optimized view of your WordPress site at /agent-view/ — plain text, clear actions, minimal tokens, WooCommerce ready.

== Description ==

OutSurface Agent View creates a parallel, lightweight version of your entire website specifically optimized for AI agents and LLM-based automation tools.

**Why?** Modern websites are built for humans — heavy CSS, JavaScript, images, and visual complexity cost AI agents many tokens to parse, slow down navigation, and make it hard to identify actionable elements. OutSurface Agent View solves this.

**Features:**

* **Agent-optimized pages** at `/agent-view/*` — same content, no visual overhead
* **WPBakery, Elementor & Gutenberg** — all editor markup stripped, pure content only
* **Full navigation with submenus** — mirrors your WordPress menus hierarchically
* **Actions prominently displayed** — agents can see exactly what they can do on each page
* **WooCommerce support** — Shop, Product (with variants), Cart, Checkout, My Account all agent-ready
* **Add-to-cart URLs** — agents can add products to cart via direct GET links, no forms needed
* **llm.txt** — full site content as plain text at `/llm.txt` following the llms.txt convention
* **data.json** — complete structured site data at `/agent-view/data.json`
* **Invisible discovery nav** — every human page includes meta tags and HTTP headers so agents can find the agent view
* **OutSurface account** — optional license connection to verify your installation
* **Debug mode** — makes the agent nav visible for your own testing
* **Description box** — tell agents what your site does and what they can accomplish
* **Low token cost** — monospaced, structured, no decorative content

== Installation ==

1. Upload the `agent-view` folder to `/wp-content/plugins/`
2. Activate via the Plugins menu
3. Go to **Agent View** in the main admin menu
4. Set your agent description
5. Visit `/agent-view/` to see the agent home
6. After activation, visit **Settings → Permalinks** and click Save to flush rewrite rules (required for `/llm.txt` to work)

== Frequently Asked Questions ==

= Will this affect my regular website? =
No. Agent View pages are served only at `/agent-view/*`. Human pages are unchanged — a hidden div and meta tags are added, but they are invisible and do not affect appearance or performance.

= Does it work with WooCommerce? =
Yes. Shop, products (including variable products with all variants), categories, cart, checkout, and My Account are all fully supported. Each product page shows direct add-to-cart URLs so agents can purchase without form submission.

= Can agents add items to cart? =
Yes. Each product page shows add-to-cart URLs for every quantity and variation. Agents navigate to the URL and the item is added automatically.

= Does it work with page builders like WPBakery or Elementor? =
Yes. All page builder shortcodes and wrapper HTML are stripped before rendering. Only clean semantic content is shown.

= What is llm.txt? =
A plain-text document at `/llm.txt` that summarises your entire site following the emerging llms.txt convention — useful for loading your site as LLM context in one request.

= What is data.json? =
A structured JSON snapshot of your site at `/agent-view/data.json` — includes all pages, posts, categories, products, navigation, and agent endpoint documentation.

= Is it indexed by search engines? =
No. All agent-view pages include `<meta name="robots" content="noindex,nofollow">` and an `X-Robots-Tag: noindex` HTTP header.

= What is the OutSurface account connection? =
Completely optional. Connect your OutSurface account to verify your installation. The plugin works fully without it.

== Changelog ==

= 1.0.0 =
* Initial release
* Agent-optimized HTML views at /agent-view/*
* WPBakery, Elementor, and Gutenberg content stripping
* WooCommerce full support (shop, products, variants, cart, checkout, account)
* llm.txt plain-text site summary
* data.json structured site data
* Hierarchical menu support with submenus
* OutSurface optional license verification
* Debug mode
