docs(billing): define agent hours for platform credits and refresh stale language

src/content/docs/enterprise/support-and-resources/billing.mdx

@@ -3,11 +3,11 @@ title: Enterprise billing
 sidebar:
   label: "Billing"
 description: >-
-  Learn about billing for Warp Enterprise, including credits, cloud agent
-  costs, and billing management.
+  Billing for Warp Enterprise: credits, cloud agent costs, spending controls,
+  and BYOLLM billing under your contract.
 ---
 
-This page covers general information about credits, cloud agent costs, and BYOLLM billing for enterprise teams. If you have specific questions about custom pricing, credit allocation, or contract terms, contact your Warp account manager.
+Warp Enterprise uses the same credit-based billing as other plans, with pool sizes, rates, and terms set by your contract. For questions about custom pricing, credit allocation, or contract terms, contact your Warp account manager.
 
 ## Credits
 
@@ -31,7 +31,7 @@ Credit allocations vary by contract. Contact your account manager for details on
 
 ## Cloud agent billing
 
-Cloud agents consume AI credits for inference, compute credits for the sandbox they run in, and platform credits for the orchestration layer. See [Credits](/support-and-community/plans-and-billing/credits/) for the full breakdown of how each credit type is metered.
+Cloud agents consume AI credits for inference, compute credits for the sandbox they run in, and [platform credits](/support-and-community/plans-and-billing/platform-credits/) for the platform layer. Platform credits are billed by the agent hour, the time an agent spends working on a task, at the rate set by your contract. Cloud agent runs on self-hosted workers don't consume compute credits but still consume platform credits. See [Credits](/support-and-community/plans-and-billing/credits/) for the full breakdown of how each credit type is metered.
 
 ### How credits are consumed
 
@@ -43,7 +43,7 @@ For more details, see [Access, Billing, and Identity](/platform/team-access-bill
 
 ## BYOLLM billing
 
-When using [Bring Your Own LLM (BYOLLM)](/enterprise/enterprise-features/bring-your-own-llm/), Warp routes requests through your cloud infrastructure ([AWS Bedrock](/enterprise/enterprise-features/byollm-aws-bedrock/) and [Gemini Enterprise Agent Platform (Vertex AI)](/enterprise/enterprise-features/byollm-gemini-enterprise/) today, with Azure Foundry coming soon). Customer-routed BYOLLM inference **consumes no credits** — Warp does not charge credits for requests that execute in your cloud. Inference costs are billed directly to your cloud account. Local agent runs that use BYOLLM still consume [platform credits](/support-and-community/plans-and-billing/platform-credits/) for Warp's platform infrastructure.
+When using [Bring Your Own LLM (BYOLLM)](/enterprise/enterprise-features/bring-your-own-llm/), Warp routes requests through your cloud infrastructure ([AWS Bedrock](/enterprise/enterprise-features/byollm-aws-bedrock/) and [Gemini Enterprise Agent Platform (Vertex AI)](/enterprise/enterprise-features/byollm-gemini-enterprise/) today, with Azure Foundry coming soon). Customer-routed BYOLLM inference **consumes no credits** — Warp does not charge credits for requests that execute in your cloud. Inference costs are billed directly to your cloud account. Local agent runs that use BYOLLM still consume [platform credits](/support-and-community/plans-and-billing/platform-credits/).
 
 If a BYOLLM request fails and Warp falls back to a direct API model, that fallback request consumes Warp credits at the standard rate.
 
@@ -88,7 +88,7 @@ For enterprises with credit pools, administrators receive alerts as the team cre
 
 * [Credits](/support-and-community/plans-and-billing/credits/) - How credits are calculated and consumed
 * [Add-on credits](/support-and-community/plans-and-billing/add-on-credits/) - Purchase additional credits and configure auto-reload
-* [Platform credits](/support-and-community/plans-and-billing/platform-credits/) - The third credit bucket alongside AI credits and compute credits, covering Warp's platform infrastructure
+* [Platform credits](/support-and-community/plans-and-billing/platform-credits/) - Billed by the agent hour; cover Warp's platform layer on cloud agent runs and local runs with customer-supplied inference
 * [Pricing FAQs](/support-and-community/plans-and-billing/pricing-faqs/) - Common billing questions
 * [Bring Your Own LLM](/enterprise/enterprise-features/bring-your-own-llm/) - BYOLLM billing and configuration
 * [Team-managed API keys and endpoints](/enterprise/enterprise-features/team-managed-keys-and-endpoints/) - Share provider keys and custom endpoints across the team; inference routes through your accounts

src/content/docs/support-and-community/plans-and-billing/add-on-credits.mdx

@@ -9,7 +9,10 @@ Add-on credits let you continue using premium AI models even after you've reache
 
 In the Warp app, you can manage and purchase add-on credits directly in **Settings** > **Billing and usage**.
 
-![Add-on credits management surface under **Settings** > **Billing and usage**.](../../../../assets/support-and-community/reload-credits.png)
+<figure style={{ maxWidth: "563px" }}>
+![The Add-on credits card in Billing and usage settings, showing the monthly spend limit, the auto reload toggle, and one-time purchase denominations.](../../../../assets/support-and-community/reload-credits.png)
+<figcaption>Add-on credit settings under Billing and usage.</figcaption>
+</figure>
 
 ### How do add-on credits work?
 
@@ -19,7 +22,7 @@ If you’ve enabled **auto-reload**, new credits will be added automatically and
 
 Add-on credits are available on every self-serve plan — Free, Build, Max, and Business — plus Enterprise. The Free plan buys the same packs at a higher rate than paid plans; see [Warp pricing](https://www.warp.dev/pricing) for current rates. On both self-serve and Enterprise plans, add-on credits are shared across your team: every purchase goes into a single team-wide pool that all members draw from. These credits **roll over across billing cycles** and remain valid for **12 months from the purchase date**.
 
-Add-on credits draw from the same pool as [platform credits](/support-and-community/plans-and-billing/platform-credits/) and compute credits, so a single balance covers all three credit types.
+Add-on credits can be spent on any credit type, so a single balance covers AI credits, compute credits, and [platform credits](/support-and-community/plans-and-billing/platform-credits/).
 
 ### Who can purchase add-on credits
 
@@ -55,9 +58,9 @@ Auto-reload uses the same denominations and discounts as manual purchases. The d
 You can opt in and choose your reload amount when subscribing to a paid plan on the [Warp upgrade page](https://app.warp.dev/upgrade), or change your configuration anytime in **Settings** > **Billing and usage**.
 :::
 
-#### **Configuring a monthly spend limit**
+#### Configuring a monthly spend limit
 
-Your monthly spend limit sets the maximum amount you can spend on add-on credits in a single calendar month. This ensures you have full control over your AI usage costs while still allowing flexibility for automatic top-ups when needed, keeping your workflow uninterrupted.
+Your monthly spend limit sets the maximum amount you can spend on add-on credits in a single calendar month.
 
 * The default limit is $200, but you can increase or decrease it anytime in **Settings** > **Billing and usage**.
 * **If a credit purchase would exceed your limit, it won’t process** — you’ll need to either raise your limit or choose a smaller add-on credit amount.
@@ -66,9 +69,7 @@ Your monthly spend limit sets the maximum amount you can spend on add-on credits
   * You update your limit in settings.
 
 :::caution
-Your monthly spend limit is separate from your billing cycle (which determines when your subscription renews).\
-\
-The limit resets automatically at the start of each calendar month, so you can manage recurring AI usage with predictable spending and clear visibility into your costs.
+Your monthly spend limit is separate from your billing cycle (which determines when your subscription renews). The limit resets at the start of each calendar month.
 :::
 
 ### Billing and credit usage