=== Agora Agent Commerce ===
Contributors: agoraos
Tags: ai, agents, commerce, woocommerce, agora
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
WC requires at least: 7.0
WC tested up to: 9.0

Connect your WooCommerce store to Agora OS. Let AI agents find and purchase your products on behalf of customers.

== Description ==

**Agora Agent Commerce** registers your WooCommerce store with [Agora OS](https://agora.sh) — a searchable registry that lets AI agents discover and buy your products on behalf of real customers.

= How it works =

1. Register your store at [agora.sh/merchants/signup](https://agora.sh/merchants/signup) — you'll receive an `agora_merch_*` API key
2. Install and activate the plugin
3. Go to **WooCommerce → Settings → Agora** and paste your API key
4. Your product catalog syncs to Agora automatically
5. AI agents using Agora can find, evaluate, and purchase your products — with human approval required for every transaction

= Features =

* **Real-time catalog sync** — product updates are pushed to Agora immediately
* **Daily full sync** — nightly backup sync via WP-Cron
* **Human-in-the-loop** — every purchase requires explicit approval from the buyer
* **Encrypted credentials** — your WooCommerce API keys are stored encrypted on Agora's servers
* **HPOS compatible** — supports WooCommerce High-Performance Order Storage

== Installation ==

1. Register your store at **agora.sh/merchants/signup** — requires a GitHub account. You'll receive an `agora_merch_*` API key. **Copy it immediately — it's only shown once.**
2. Upload the plugin files to `/wp-content/plugins/agora-agent-commerce/` or install via **Plugins → Add New → Upload Plugin**
3. Activate the plugin through the **Plugins** screen
4. Go to **WooCommerce → Settings → Agora**
5. Paste your `agora_merch_*` key into the **Agora API Key** field and click **Save & Connect**

The plugin will validate your key and run an initial catalog sync automatically.

== Frequently Asked Questions ==

= Does every AI purchase require my approval? =

No — human *buyer* approval is required. When an AI agent wants to buy something, it generates an approval link sent to the human user. The human clicks Approve before any order is placed.

= What data is sent to Agora? =

Product titles, descriptions, prices, images, stock status, and variants. No customer data is ever sent to Agora.

= How are my WooCommerce credentials stored? =

Your WooCommerce consumer key and secret are provided during registration at agora.sh and are encrypted with AES-256-GCM before being stored on Agora's servers. They're only decrypted at the moment an order needs to be placed.

= I lost my API key — what do I do? =

Go to [agora.sh/merchants/dashboard](https://agora.sh/merchants/dashboard), click **Reset Key**, copy the new key, and paste it back into the plugin settings.

== Changelog ==

= 1.0.0 =
* Initial release
* Product catalog sync (real-time and daily)
* WooCommerce → Settings → Agora settings page
* Signed webhook receiver
* /.well-known/agent.json manifest endpoint

== Upgrade Notice ==

= 1.0.0 =
Initial release.
