feat(core): Add usage tracking for OAuth providers

Introduce a centralised `/usage` endpoint that fetches and caches rate-limit windows, credits and plan information for OpenAI ChatGPT, GitHub Copilot and Anthropic Claude. The server handles stale-while-revalidate caching (5 min TTL), per-provider error reporting and graceful fallback to cached data on network failures.

- Add usage provider registry mapping auth keys to display names
- Support two-call OAuth flow for Copilot usage token acquisition
- Automatic token refresh on 401/expired Claude responses
- TUI: shared usage client, dialog and sidebar components with live event-driven updates
- Return structured `errors[]` alongside `entries[]` for granular UI feedback
- Tests for usage endpoint and new Copilot-specific auth device flow
- Regenerate SDK/OpenAPI with new Usage class and types

Closes anomalyco#9281, anomalyco#728
Supersedes anomalyco#6905, anomalyco#7837
Alternate to anomalyco#9301

Author: CasualDeveloper

packages/opencode/src/auth/index.ts

@@ -10,6 +10,7 @@ export namespace Auth {
       type: z.literal("oauth"),
       refresh: z.string(),
       access: z.string(),
+      usage: z.string().optional(),
       expires: z.number(),
       accountId: z.string().optional(),
       enterpriseUrl: z.string().optional(),

packages/opencode/src/cli/cmd/tui/component/dialog-command.tsx

@@ -25,6 +25,7 @@ export type CommandOption = DialogSelectOption<string> & {
   keybind?: keyof KeybindsConfig
   suggested?: boolean
   slash?: Slash
+  slashDescription?: string
   hidden?: boolean
   enabled?: boolean
 }
@@ -87,7 +88,7 @@ function init() {
         if (!slash) return []
         return {
           display: "/" + slash.name,
-          description: option.description ?? option.title,
+          description: option.slashDescription ?? option.description ?? option.title,
           aliases: slash.aliases?.map((alias) => "/" + alias),
           onSelect: () => result.trigger(option.value),
         }

packages/opencode/src/cli/cmd/tui/component/dialog-usage.tsx

@@ -0,0 +1,143 @@
+import { TextAttributes } from "@opentui/core"
+import { useKeyboard } from "@opentui/solid"
+import { useTheme } from "../context/theme"
+import { useDialog } from "@tui/ui/dialog"
+import { useSync } from "@tui/context/sync"
+import {
+  formatCreditsLabel,
+  formatPlanType,
+  formatUsageResetLong,
+  usageDisplay,
+  type UsageDisplayMode,
+  formatUsageWindowLabel,
+  usageBarColor,
+  usageBarString,
+} from "./usage-format"
+import type { UsageEntry, UsageError, UsageWindow } from "./usage-data"
+import { For, Show, createSignal } from "solid-js"
+
+type Theme = ReturnType<typeof useTheme>["theme"]
+
+export function DialogUsage(props: { entries: UsageEntry[]; errors?: UsageError[]; initialMode?: UsageDisplayMode }) {
+  const { theme } = useTheme()
+  const sync = useSync()
+  const dialog = useDialog()
+  const [hover, setHover] = createSignal(false)
+  const [mode, setMode] = createSignal<UsageDisplayMode>(
+    props.initialMode ?? sync.data.config.tui?.show_usage_value_mode ?? "used",
+  )
+
+  useKeyboard((evt) => {
+    if (evt.name !== "tab") return
+    evt.preventDefault()
+    setMode((value) => (value === "used" ? "remaining" : "used"))
+  })
+
+  return (
+    <box paddingLeft={2} paddingRight={2} gap={1} paddingBottom={1} flexDirection="column">
+      <box flexDirection="row" justifyContent="space-between">
+        <text fg={theme.text} attributes={TextAttributes.BOLD}>
+          Usage
+        </text>
+        <box flexDirection="row" gap={1} alignItems="center">
+          <text fg={theme.textMuted}>
+            <span style={{ fg: theme.text }}>tab</span> toggle view
+          </text>
+          <box
+            paddingLeft={1}
+            paddingRight={1}
+            backgroundColor={hover() ? theme.primary : undefined}
+            onMouseOver={() => setHover(true)}
+            onMouseOut={() => setHover(false)}
+            onMouseUp={() => dialog.clear()}
+          >
+            <text fg={hover() ? theme.selectedListItemText : theme.textMuted}>esc</text>
+          </box>
+        </box>
+      </box>
+      <Show when={props.entries.length > 0} fallback={<text fg={theme.text}>No usage data available.</text>}>
+        <For each={props.entries}>
+          {(entry, index) => {
+            const planType = formatPlanType(entry.snapshot.planType)
+            const entryErrors = (props.errors ?? [])
+              .filter((error) => error.provider === entry.provider)
+              .map((error) => error.message)
+            return (
+              <box flexDirection="column" marginTop={index() === 0 ? 0 : 1} gap={1}>
+                <box flexDirection="column">
+                  <text fg={theme.text} attributes={TextAttributes.BOLD}>
+                    {entry.displayName} Usage
+                    <Show when={planType}>
+                      <span style={{ fg: theme.textMuted }}>{` (${planType})`}</span>
+                    </Show>
+                  </text>
+                  <text fg={theme.textMuted}>{"─".repeat(Math.max(24, entry.displayName.length + 20))}</text>
+                </box>
+                <Show when={entry.snapshot.primary}>
+                  {(window) => (
+                    <box flexDirection="column">{renderWindow(entry.provider, "primary", window(), mode(), theme)}</box>
+                  )}
+                </Show>
+                <Show when={entry.snapshot.secondary}>
+                  {(window) => (
+                    <box flexDirection="column">
+                      {renderWindow(entry.provider, "secondary", window(), mode(), theme)}
+                    </box>
+                  )}
+                </Show>
+                <Show when={entry.snapshot.tertiary}>
+                  {(window) => (
+                    <box flexDirection="column">
+                      {renderWindow(entry.provider, "tertiary", window(), mode(), theme)}
+                    </box>
+                  )}
+                </Show>
+                <Show when={entry.snapshot.credits}>
+                  {(credits) => (
+                    <text fg={theme.text}>
+                      {formatCreditsLabel(entry.provider, credits(), {
+                        mode: mode(),
+                        slot: "secondary",
+                      })}
+                    </text>
+                  )}
+                </Show>
+                <Show when={entryErrors.length > 0}>
+                  <text fg={theme.error} attributes={TextAttributes.DIM}>
+                    {entryErrors.join(" • ")}
+                  </text>
+                </Show>
+              </box>
+            )
+          }}
+        </For>
+      </Show>
+    </box>
+  )
+}
+
+function renderWindow(
+  provider: string,
+  windowType: "primary" | "secondary" | "tertiary",
+  window: UsageWindow,
+  mode: UsageDisplayMode,
+  theme: Theme,
+  showReset = true,
+) {
+  const usedPercent = usageDisplay(window.usedPercent, "used").percent
+  const display = usageDisplay(window.usedPercent, mode)
+  const windowLabel = formatUsageWindowLabel(provider, windowType, window.windowMinutes)
+
+  return (
+    <box flexDirection="column">
+      <text fg={theme.text}>
+        {windowLabel} Limit: [
+        <span style={{ fg: usageBarColor(usedPercent, theme) }}>{usageBarString(display.percent)}</span>]{" "}
+        {display.percent.toFixed(0)}% {display.label}
+      </text>
+      <Show when={showReset && window.resetsAt !== null}>
+        <text fg={theme.textMuted}>Resets {formatUsageResetLong(window.resetsAt!)}</text>
+      </Show>
+    </box>
+  )
+}