docs: add Licensing & Usage page and reorder agents manifest (#28263)

Adds a new Licensing & Usage page under `docs/ai-coder/agents/` covering
the difference between Community and AI Premium licenses, how Agent Time
is measured, and what happens when concurrency or usage limits are
reached.

Reorders the Coder Agents section in `docs/manifest.json` to the
following sequence: Getting Started, Architecture, Platform Controls,
Extending Agents, Models, Tools, Chat Sharing, Search Syntax, Licensing
& Usage, Tasks to Chats API Migration.

---

PR generated with Coder Agents

---------

Co-authored-by: Nick Vigilante <nickvigilante@users.noreply.github.com>

docs/ai-coder/agents/licensing-usage.md

@@ -0,0 +1,51 @@
+---
+title: Licensing & Usage
+---
+
+Coder Agents is licensed differently depending on whether your deployment holds a Community license or an AI Premium license with a purchased Agent Time allocation.
+
+## Community licenses
+
+Community licenses support up to five concurrently active agents deployment-wide.
+Coder doesn't limit how long those agents can run or how many tasks they complete over time.
+Agents will queue when more than five agents are active at a time.
+With this agent pool, individuals and small teams can experiment with Coder Agents at no cost.
+
+## AI Premium licenses and Agent Time
+
+AI Premium licenses include a customizable amount of Agent Time.
+Agent Time is shared across the deployment, allowing unlimited agents to run concurrently while consuming from a shared pool of purchased working hours.
+This usage-based model is designed for enterprise workloads, where large development teams, background automation, and API-triggered tasks can create highly variable bursts of agent activity without being constrained by a concurrency limit.
+
+## How Agent Time is measured
+
+Agent Time is the cumulative duration during which an AI agent is actively processing a task for the user.
+It is measured per interaction step and summed across the duration of a conversation.
+
+**Includes:**
+
+- Large language model inference time
+- Tool execution (such as file operations, terminal commands, and workspace provisioning)
+- Automated error recovery attempts
+
+**Excludes:**
+
+- Time the customer spends composing or reviewing messages
+- Time between conversation turns when the agent is not processing
+- Tool execution delegated to external systems outside the agent's direct control
+
+Agent Time does not accrue when a conversation is inactive or awaiting user input.
+Agent Time is measured with millisecond precision and is rounded down to the nearest minute for billing purposes.
+
+## Concurrency and usage limits
+
+Coder handles concurrency and usage limits differently, depending on the license you use for Coder.
+
+### Community concurrency limit
+
+When a Community license deployment reaches its limit of five concurrently active agents, any additional agents are placed in a queue.
+As soon as an active agent completes its task, the next queued agent begins its work, so no work is lost and no action is required from the user.
+
+### AI Premium Agent Time exhaustion
+
+Coder sends deployment administrators an in-app soft warning message as the deployment approaches its maximum allotted Agent Time, so they can purchase additional Agent Time before the concurrency fallback takes effect.

docs/manifest.json

@@ -1033,31 +1033,11 @@
 							"description": "Enable Coder Agents, prepare your deployment, and run your first Coder Agent",
 							"path": "./ai-coder/agents/getting-started.md"
 						},
-						{
-							"title": "Search Syntax",
-							"description": "Filter Coder Agents conversations by title, status, and linked pull requests with search syntax.",
-							"path": "./ai-coder/agents/chat-search-syntax.md"
-						},
 						{
 							"title": "Architecture",
 							"description": "Learn how the Coder Agents control-plane agent communicates with your workspaces.",
 							"path": "./ai-coder/agents/architecture.md"
 						},
-						{
-							"title": "Chat Sharing",
-							"description": "Give other users and groups read-only access to a Coder Agents conversation with chat sharing.",
-							"path": "./ai-coder/agents/chat-sharing.md"
-						},
-						{
-							"title": "Models",
-							"description": "Configure the LLM providers and models that power Coder Agents from Admin settings.",
-							"path": "./ai-coder/agents/models.md"
-						},
-						{
-							"title": "Tools",
-							"description": "How Coder Agents uses tool calls to select templates and create workspaces",
-							"path": "./ai-coder/agents/tools/index.md"
-						},
 						{
 							"title": "Platform Controls",
 							"description": "Learn how platform teams control Coder Agents behavior, models, spend, and policies.",
@@ -1124,6 +1104,31 @@
 							"description": "Extend Coder Agents with custom skills and MCP tools defined in your workspace templates.",
 							"path": "./ai-coder/agents/extending-agents.md"
 						},
+						{
+							"title": "Models",
+							"description": "Configure the LLM providers and models that power Coder Agents from Admin settings.",
+							"path": "./ai-coder/agents/models.md"
+						},
+						{
+							"title": "Tools",
+							"description": "How Coder Agents uses tool calls to select templates and create workspaces",
+							"path": "./ai-coder/agents/tools/index.md"
+						},
+						{
+							"title": "Chat Sharing",
+							"description": "Give other users and groups read-only access to a Coder Agents conversation with chat sharing.",
+							"path": "./ai-coder/agents/chat-sharing.md"
+						},
+						{
+							"title": "Search Syntax",
+							"description": "Filter Coder Agents conversations by title, status, and linked pull requests with search syntax.",
+							"path": "./ai-coder/agents/chat-search-syntax.md"
+						},
+						{
+							"title": "Licensing \u0026 Usage",
+							"description": "Licensing and usage details for Coder Agents.",
+							"path": "./ai-coder/agents/licensing-usage.md"
+						},
 						{
 							"title": "Tasks to Chats API Migration",
 							"description": "Migrate your integrations from the Coder Tasks API to the newer Coder Agents Chats API.",