docs: document the context window usage breakdown

[hongyi-chen]

What

Documents the per-segment context window breakdown under Context window management in
agents/local-agents/interacting-with-agents/index.mdx.

Why

Found by the missing_docs drift-watch audit: ContextWindowUsageBreakdown was promoted
dogfood → GA, and the breakdown it adds to the usage summary was undocumented.

Source of truth

• app/src/ai/blocklist/usage/conversation_usage_view.rs — append_context_window_segment_rows
  and context_window_segment_display_rows (percentages are shares of total context window usage;
  rows sort descending with Other last; zero rows are dropped), plus the Other tooltip copy.
• crates/persistence/src/model.rs — the ContextWindowSegmentType variants that produce the
  segment labels.

Deferred findings from this run

Nothing from the audit was silently dropped. The full deferral list lives in the companion
bookkeeping PR (docs/missing-docs-audit-bookkeeping); in summary:

• 15 warp-server public API routes missing from the OpenAPI spec — routed to the
  sync-openapi-spec skill rather than hand-written, per the skill's public/private guardrail.
• 32 terminology/staleness findings — owned by the style_lint skill.
• 1 new server-side agent tool (report_external_reference) — reached only through the hidden
  oz harness-support CLI, so no public surface to document yet.

---

Conversation: https://staging.warp.dev/conversation/c45bb2ea-d33b-4723-8249-478547f81a47
Run: https://oz.staging.warp.dev/runs/019fc891-7c04-779b-b006-328169d8a0d7

This PR was generated with Oz.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Aug 3, 2026 5:21pm

[hongyi-chen]

Heads-up on overlap: #451 also documents the context window usage breakdown, but it edits src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx, a path that no longer exists after the agent-platform/ → agents/ rename in #420. This PR targets the current path, so it should apply cleanly. If #451 is rebased onto the new tree first, close this one instead.