Usage limits

import {
  definePlugin,
  defineUsageLimitProvider,
  runProviderCommand,
  CLI_MISSING_STATUS,
} from "@pragma-sh/plugin";

usageLimits: [
  defineUsageLimitProvider({
    id: "my-agent",
    title: "My Agent",
    iconPath: "./assets/agent.svg",
    dashboardUrl: "https://my-agent.dev/dashboard",
    primaryLimitId: "messages",
    refreshIntervalMs: 30_000, // minimum 15s; backoff on failure up to 15min
    load: async (ctx) => {
      const outcome = await runProviderCommand(ctx, ["my-agent", "usage", "--json"]);
      if (outcome.kind === "missing") {
        return {
          status: "unavailable",
          reason: "not-configured",
          message: "Install the my-agent CLI to see usage.",
        };
      }
      if (outcome.kind === "failed") {
        return { status: "unavailable", reason: "error", message: outcome.stderr };
      }
      const data = JSON.parse(outcome.stdout);
      return {
        status: "ready",
        observedAt: Date.now(),
        summary: data.messages,           // the collapsed-row limit
        limits: [data.messages, data.tokens],
      };
    },
  }),
],

interface UsageLimit {
  id: string;
  title: string;
  used: number; // percent 0–100
  limit: number | null; // null = unlimited → "Unlimited"
  resetsInMs?: number; // drives the "Resets in" countdown
}

type UsageLimitsResult =
  | { status: "ready"; observedAt: number; summary?: UsageLimit; limits: UsageLimit[] }
  | {
      status: "unavailable";
      reason: "not-configured" | "authentication-required" | "unsupported" | "error";
      message: string;
    };