docs: document metered AI usage

[superdav42]

Summary

• Add a dedicated AI Usage Metering guide for selling metered AI usage to customer subsites.
• Expand the Metered Plans overview, changelog, and AI metering hook docs.
• Cross-link Gratis AI Agent and AI Connector docs to the new metered AI usage guide.

Files and patterns

• docs/addons/metered-plans/ai-usage-metering.mdx — setup, pricing, customer experience, REST endpoint, helper functions, and launch checklist.
• docs/addons/metered-plans/index.mdx — overview and quick AI usage metering path.
• docs/addons/metered-plans/changelog.md — Metered Plans 1.4.0 through 1.5.3 updates.
• docs/addons/metered-plans/hooks/Filters/*.md — practical hook examples for AI rates and connector enforcement.
• docs/addons/gratis-ai-agent/index.mdx and AI connector pages — cross-links to the metered AI usage guide.

Verification

• git diff --check origin/main...HEAD
• npm run build -- --locale en

---

aidevops.sh v3.31.76 plugin for OpenCode v1.17.13

Summary by CodeRabbit

• New Features

  • Added AI Usage Metering documentation, including setup for pricing, allowances, overage markup, and customer billing flows.
  • Added guidance for tracking and billing AI usage across supported AI connectors and models.
  • Introduced new FAQ and usage notes for selling AI usage to customers.

• Documentation

  • Expanded configuration, testing, and runtime behavior docs.
  • Clarified model pricing, token rate matching, and how unpriced models are handled.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 74e04acc-06eb-4e61-80fb-9b2e6fdfed1b

📥 Commits

Reviewing files that changed from the base of the PR and between 0726a72 and d470ea1.

📒 Files selected for processing (8)

• docs/addons/gratis-ai-agent/index.mdx
• docs/addons/metered-plans/ai-usage-metering.mdx
• docs/addons/metered-plans/changelog.md
• docs/addons/metered-plans/hooks/Filters/wu_ai_token_rates.md
• docs/addons/metered-plans/hooks/Filters/wu_connector_enforcement_option_keys.md
• docs/addons/metered-plans/index.mdx
• docs/addons/ultimate-ai-connector-compatible-endpoints/index.mdx
• docs/addons/ultimate-ai-connector-webllm/index.mdx

---

📝 Walkthrough

Walkthrough

This PR adds a new "AI Usage Metering" documentation page for Metered Plans and updates related documentation across the Metered Plans index, changelog, filter hook references, and connector/addon docs (Gratis AI Agent, WebLLM, OpenAI-compatible endpoints) to describe metered AI billing configuration, runtime model rules, and integration points.

Changes

AI Usage Metering documentation

Layer / File(s)	Summary
Core AI Usage Metering guide and changelog docs/addons/metered-plans/ai-usage-metering.mdx, docs/addons/metered-plans/changelog.md	New documentation page detailing token-to-cost billing, setup steps, runtime model rules, dashboard, REST endpoint, and hooks; changelog updated with related version entries (1.4.0–1.5.3).
Metered Plans index page updates docs/addons/metered-plans/index.mdx	Updated Key Features bullet, reworked per-token rate configuration steps, expanded customer account usage details, and added a new FAQ on selling AI usage.
Filter hook documentation updates docs/addons/metered-plans/hooks/Filters/wu_ai_token_rates.md, docs/addons/metered-plans/hooks/Filters/wu_connector_enforcement_option_keys.md	Expanded filter docs with detailed parameter descriptions, PHP usage examples, and reorganized Since/Source sections.
Cross-addon metered usage notes docs/addons/gratis-ai-agent/index.mdx, docs/addons/ultimate-ai-connector-webllm/index.mdx, docs/addons/ultimate-ai-connector-compatible-endpoints/index.mdx	Added subsections describing metered AI usage integration for Gratis AI Agent, WebLLM, and compatible-endpoints connector docs.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

• Ultimate-Multisite/docs#23: Adds the initial WebLLM connector documentation that this PR extends with new metered usage notes.

Suggested labels: documentation

Suggested reviewers: none

🐰 Docs hop through pages new and old,
Metering AI, tokens counted and told,
Rates and rules in tidy rows,
Where usage climbs and billing flows,
A carrot-sized checklist, neatly scrolled.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title is concise and accurately summarizes the main change: adding documentation for metered AI usage.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/auto-20260706-140712

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[superdav42]

Summary

• Add a dedicated AI Usage Metering guide for selling metered AI usage to customer subsites.
• Expand the Metered Plans overview, changelog, and AI metering hook docs.
• Cross-link Gratis AI Agent and AI Connector docs to the new metered AI usage guide.

Files and patterns

• docs/addons/metered-plans/ai-usage-metering.mdx — setup, pricing, customer experience, REST endpoint, helper functions, and launch checklist.
• docs/addons/metered-plans/index.mdx — overview and quick AI usage metering path.
• docs/addons/metered-plans/changelog.md — Metered Plans 1.4.0 through 1.5.3 updates.
• docs/addons/metered-plans/hooks/Filters/*.md — practical hook examples for AI rates and connector enforcement.
• docs/addons/gratis-ai-agent/index.mdx and AI connector pages — cross-links to the metered AI usage guide.

Verification

• git diff --check origin/main...HEAD
• npm run build -- --locale en

---

aidevops.sh v3.31.76 plugin for OpenCode v1.17.13

---

Merged via PR #154 to main.
Merged by deterministic merge pass (pulse-wrapper.sh).