@tokentop/ttop 0.4.0 → 0.6.0

package/src/plugins/providers/chutes.ts

@@ -0,0 +1,205 @@
+import type {
+  CredentialResult,
+  Credentials,
+  PluginContext,
+  ProviderAuth,
+  ProviderFetchContext,
+  ProviderPlugin,
+  ProviderUsageData,
+} from "@tokentop/plugin-sdk";
+
+const CHUTES_QUOTA_URL = "https://api.chutes.ai/users/me/quota_usage/me";
+
+interface ChutesQuotaResponse {
+  quota?: number;
+  used?: number;
+}
+
+export const chutesPlugin: ProviderPlugin = {
+  apiVersion: 2,
+  id: "chutes",
+  type: "provider",
+  name: "Chutes",
+  version: "1.0.0",
+
+  meta: {
+    description: "Chutes AI API quota and usage tracking",
+    homepage: "https://chutes.ai",
+    brandColor: "#6366f1",
+  },
+
+  permissions: {
+    network: {
+      enabled: true,
+      allowedDomains: ["api.chutes.ai"],
+    },
+    filesystem: {
+      read: true,
+      paths: ["~/.local/share/opencode"],
+    },
+    env: {
+      read: true,
+      vars: ["CHUTES_API_KEY"],
+    },
+  },
+
+  capabilities: {
+    usageLimits: true,
+    apiRateLimits: false,
+    tokenUsage: false,
+    actualCosts: false,
+  },
+
+  auth: {
+    async discover(ctx: PluginContext): Promise<CredentialResult> {
+      const entry = await ctx.authSources.opencode.getProviderEntry("chutes");
+      if (entry) {
+        if (entry.type === "api" && entry.key) {
+          return { ok: true, credentials: { apiKey: entry.key, source: "opencode" } };
+        }
+        if (entry.type === "wellknown" && (entry.token || entry.key)) {
+          return {
+            ok: true,
+            credentials: { apiKey: (entry.token || entry.key)!, source: "opencode" },
+          };
+        }
+        if (entry.type === "oauth" && entry.access) {
+          return { ok: true, credentials: { apiKey: entry.access, source: "opencode" } };
+        }
+      }
+
+      const apiKey = ctx.authSources.env.get("CHUTES_API_KEY");
+      if (apiKey) {
+        return { ok: true, credentials: { apiKey, source: "env" } };
+      }
+
+      return {
+        ok: false,
+        reason: "missing",
+        message: "No Chutes API key found. Configure Chutes in OpenCode.",
+      };
+    },
+
+    isConfigured(credentials: Credentials): boolean {
+      return !!(credentials.apiKey || credentials.oauth?.accessToken);
+    },
+  } satisfies ProviderAuth,
+
+  async fetchUsage(ctx: ProviderFetchContext): Promise<ProviderUsageData> {
+    const { credentials, http, logger: log } = ctx;
+
+    const token = credentials.apiKey || credentials.oauth?.accessToken;
+
+    if (!token) {
+      return {
+        fetchedAt: Date.now(),
+        error: "API key required. Configure Chutes in OpenCode.",
+      };
+    }
+
+    try {
+      const response = await http.fetch(CHUTES_QUOTA_URL, {
+        method: "GET",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          Accept: "application/json",
+        },
+      });
+
+      if (!response.ok) {
+        log.warn("Failed to fetch Chutes usage", { status: response.status });
+
+        if (response.status === 429) {
+          const retryAfterHeader = response.headers.get("retry-after");
+          const parsedRetryAfter = retryAfterHeader
+            ? Number.parseInt(retryAfterHeader, 10)
+            : Number.NaN;
+          const retrySec =
+            Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+          log.warn("Rate limited by Chutes API", { retryAfterHeader, retryAfterSec: retrySec });
+          return {
+            fetchedAt: Date.now(),
+            error: `Rate limited. Retry after ${retrySec}s.`,
+            rateLimited: true,
+            retryAfterMs: retrySec * 1000,
+          };
+        }
+
+        if (response.status === 401 || response.status === 403) {
+          return {
+            fetchedAt: Date.now(),
+            error: "Authorization failed. Check your Chutes API key.",
+          };
+        }
+
+        return {
+          fetchedAt: Date.now(),
+          error: `API error: ${response.status} ${response.statusText}`,
+        };
+      }
+
+      const data = (await response.json()) as ChutesQuotaResponse;
+
+      if (!data || typeof data.quota !== "number" || typeof data.used !== "number") {
+        return {
+          fetchedAt: Date.now(),
+          planType: "Chutes",
+          allowed: true,
+        };
+      }
+
+      const quota = data.quota;
+      const used = data.used;
+      const usedPercent = quota > 0 ? Math.round((used / quota) * 100) : 0;
+
+      const planType = getTierFromQuota(quota);
+      const resetAt = calculateNextReset();
+      const limitReached = usedPercent >= 100;
+
+      const result: ProviderUsageData = {
+        planType,
+        allowed: !limitReached,
+        limitReached,
+        fetchedAt: Date.now(),
+      };
+
+      if (usedPercent !== null) {
+        result.limits = {
+          primary: {
+            usedPercent,
+            label: "Daily quota",
+            resetsAt: resetAt,
+            windowMinutes: 1440,
+          },
+        };
+      }
+
+      return result;
+    } catch (err) {
+      log.error("Failed to fetch Chutes usage", { error: err });
+      return {
+        fetchedAt: Date.now(),
+        error: err instanceof Error ? err.message : "Unknown error",
+      };
+    }
+  },
+};
+
+function getTierFromQuota(quota: number): string {
+  const tierMap: Record<number, string> = {
+    200: "Legacy",
+    300: "Base",
+    2000: "Plus",
+    5000: "Pro",
+  };
+
+  return tierMap[quota] ?? `Custom (${quota})`;
+}
+
+function calculateNextReset(): number {
+  const now = new Date();
+  const tomorrow = new Date(now);
+  tomorrow.setUTCDate(tomorrow.getUTCDate() + 1);
+  tomorrow.setUTCHours(0, 0, 0, 0);
+  return tomorrow.getTime();
+}

package/src/plugins/providers/codex.ts

@@ -7,7 +7,7 @@ import type {
   ProviderFetchContext,
   ProviderPlugin,
   ProviderUsageData,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 interface CodexCliCredentials {
   access_token?: string;
@@ -178,6 +178,22 @@ export const codexPlugin: ProviderPlugin = {
         const bodyText = await response.text().catch(() => "");
         log.warn("Failed to fetch ChatGPT usage", { status: response.status, body: bodyText });
 
+        if (response.status === 429) {
+          const retryAfterHeader = response.headers.get("retry-after");
+          const parsedRetryAfter = retryAfterHeader
+            ? Number.parseInt(retryAfterHeader, 10)
+            : Number.NaN;
+          const retrySec =
+            Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+          log.warn("Rate limited by ChatGPT API", { retryAfterHeader, retryAfterSec: retrySec });
+          return {
+            fetchedAt: Date.now(),
+            error: `Rate limited. Retry after ${retrySec}s.`,
+            rateLimited: true,
+            retryAfterMs: retrySec * 1000,
+          };
+        }
+
         if (response.status === 401) {
           return {
             fetchedAt: Date.now(),

package/src/plugins/providers/gemini.ts

@@ -9,7 +9,7 @@ import type {
   ProviderUsageData,
   RefreshedCredentials,
   UsageLimit,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 const GOOGLE_ENDPOINT = "https://cloudcode-pa.googleapis.com";
 
@@ -212,6 +212,22 @@ export const geminiPlugin: ProviderPlugin = {
       });
 
       if (!response.ok) {
+        if (response.status === 429) {
+          const retryAfterHeader = response.headers.get("retry-after");
+          const parsedRetryAfter = retryAfterHeader
+            ? Number.parseInt(retryAfterHeader, 10)
+            : Number.NaN;
+          const retrySec =
+            Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+          log.warn("Rate limited by Google API", { retryAfterHeader, retryAfterSec: retrySec });
+          return {
+            fetchedAt: Date.now(),
+            error: `Rate limited. Retry after ${retrySec}s.`,
+            rateLimited: true,
+            retryAfterMs: retrySec * 1000,
+          };
+        }
+
         const errorText = await response.text().catch(() => "");
         if (response.status === 401) {
           return {

package/src/plugins/providers/github-copilot.ts

@@ -7,7 +7,7 @@ import type {
   ProviderPlugin,
   ProviderUsageData,
   UsageLimit,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 interface CopilotUserResponse {
   access_type_sku?: string;
@@ -134,6 +134,22 @@ export const githubCopilotPlugin: ProviderPlugin = {
       });
 
       if (!response.ok) {
+        if (response.status === 429) {
+          const retryAfterHeader = response.headers.get("retry-after");
+          const parsedRetryAfter = retryAfterHeader
+            ? Number.parseInt(retryAfterHeader, 10)
+            : Number.NaN;
+          const retrySec =
+            Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+          log.warn("Rate limited by GitHub API", { retryAfterHeader, retryAfterSec: retrySec });
+          return {
+            fetchedAt: Date.now(),
+            error: `Rate limited. Retry after ${retrySec}s.`,
+            rateLimited: true,
+            retryAfterMs: retrySec * 1000,
+          };
+        }
+
         if (response.status === 404) {
           return {
             planType: "None",

package/src/plugins/providers/index.ts

@@ -1,5 +1,6 @@
 export { anthropicPlugin } from "./anthropic.ts";
 export { antigravityPlugin } from "./antigravity.ts";
+export { chutesPlugin } from "./chutes.ts";
 export { codexPlugin } from "./codex.ts";
 export { geminiPlugin } from "./gemini.ts";
 export { githubCopilotPlugin } from "./github-copilot.ts";

package/src/plugins/providers/minimax.ts

@@ -6,7 +6,7 @@ import type {
   ProviderFetchContext,
   ProviderPlugin,
   ProviderUsageData,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 const MINIMAX_USAGE_URL = "https://platform.minimax.io/v1/api/openplatform/coding_plan/remains";
 
@@ -151,6 +151,22 @@ function createMinimaxPlugin(id: string, name: string): ProviderPlugin {
         if (!response.ok) {
           log.warn("Failed to fetch MiniMax usage", { status: response.status });
 
+          if (response.status === 429) {
+            const retryAfterHeader = response.headers.get("retry-after");
+            const parsedRetryAfter = retryAfterHeader
+              ? Number.parseInt(retryAfterHeader, 10)
+              : Number.NaN;
+            const retrySec =
+              Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+            log.warn("Rate limited by MiniMax API", { retryAfterHeader, retryAfterSec: retrySec });
+            return {
+              fetchedAt: Date.now(),
+              error: `Rate limited. Retry after ${retrySec}s.`,
+              rateLimited: true,
+              retryAfterMs: retrySec * 1000,
+            };
+          }
+
           if (response.status === 401 || response.status === 403) {
             return {
               fetchedAt: Date.now(),

package/src/plugins/providers/openai-api.ts

@@ -6,7 +6,7 @@ import type {
   ProviderFetchContext,
   ProviderPlugin,
   ProviderUsageData,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 interface UsageBucket {
   object: string;
@@ -49,6 +49,15 @@ interface CostsResponse {
   has_more: boolean;
 }
 
+class RateLimitError extends Error {
+  readonly retryAfterMs: number;
+  constructor(retryAfterMs: number) {
+    super(`Rate limited. Retry after ${retryAfterMs / 1000}s.`);
+    this.name = "RateLimitError";
+    this.retryAfterMs = retryAfterMs;
+  }
+}
+
 export const openaiApiPlugin: ProviderPlugin = {
   apiVersion: 2,
   id: "openai-api",
@@ -145,6 +154,21 @@ export const openaiApiPlugin: ProviderPlugin = {
         fetchCosts(http, adminKey, oneDayAgo),
       ]);
 
+      // If either helper hit a 429, surface rate-limit info immediately
+      for (const settled of [usageResult, costsResult]) {
+        if (settled.status === "rejected" && settled.reason instanceof RateLimitError) {
+          log.warn("Rate limited by OpenAI API", { retryAfterMs: settled.reason.retryAfterMs });
+          return {
+            planType: "API",
+            allowed: true,
+            fetchedAt: Date.now(),
+            error: settled.reason.message,
+            rateLimited: true,
+            retryAfterMs: settled.reason.retryAfterMs,
+          };
+        }
+      }
+
       const result: ProviderUsageData = {
         planType: "API",
         allowed: true,
@@ -208,6 +232,16 @@ export const openaiApiPlugin: ProviderPlugin = {
 
       return result;
     } catch (err) {
+      if (err instanceof RateLimitError) {
+        return {
+          planType: "API",
+          allowed: true,
+          fetchedAt: Date.now(),
+          error: err.message,
+          rateLimited: true,
+          retryAfterMs: err.retryAfterMs,
+        };
+      }
       const msg = err instanceof Error ? err.message : String(err);
       log.error("OpenAI fetch error", { error: msg });
 
@@ -236,6 +270,15 @@ async function fetchCompletionsUsage(
   });
 
   if (!response.ok) {
+    if (response.status === 429) {
+      const retryAfterHeader = response.headers.get("retry-after");
+      const parsedRetryAfter = retryAfterHeader
+        ? Number.parseInt(retryAfterHeader, 10)
+        : Number.NaN;
+      const retrySec =
+        Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+      throw new RateLimitError(retrySec * 1000);
+    }
     if (response.status === 403) {
       return null;
     }
@@ -260,6 +303,15 @@ async function fetchCosts(
   });
 
   if (!response.ok) {
+    if (response.status === 429) {
+      const retryAfterHeader = response.headers.get("retry-after");
+      const parsedRetryAfter = retryAfterHeader
+        ? Number.parseInt(retryAfterHeader, 10)
+        : Number.NaN;
+      const retrySec =
+        Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+      throw new RateLimitError(retrySec * 1000);
+    }
     if (response.status === 403) {
       return null;
     }

package/src/plugins/providers/opencode-zen.ts

@@ -6,7 +6,7 @@ import type {
   ProviderFetchContext,
   ProviderPlugin,
   ProviderUsageData,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 export const opencodeZenPlugin: ProviderPlugin = {
   apiVersion: 2,

package/src/plugins/providers/perplexity.ts

@@ -6,7 +6,7 @@ import type {
   ProviderFetchContext,
   ProviderPlugin,
   ProviderUsageData,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 /**
  * Perplexity Shadow API Discovery (January 2026):
@@ -135,11 +135,20 @@ export const perplexityPlugin: ProviderPlugin = {
       }
 
       if (response.status === 429) {
+        const retryAfterHeader = response.headers.get("retry-after");
+        const parsedRetryAfter = retryAfterHeader
+          ? Number.parseInt(retryAfterHeader, 10)
+          : Number.NaN;
+        const retrySec =
+          Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+        log.warn("Rate limited by Perplexity API", { retryAfterHeader, retryAfterSec: retrySec });
         return {
           planType: "API",
           allowed: true,
           fetchedAt: Date.now(),
-          error: "Rate limited",
+          error: `Rate limited. Retry after ${retrySec}s.`,
+          rateLimited: true,
+          retryAfterMs: retrySec * 1000,
         };
       }
 

package/src/plugins/providers/zai.ts

@@ -7,7 +7,7 @@ import type {
   ProviderPlugin,
   ProviderUsageData,
   UsageLimit,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 const ZAI_USAGE_URL = "https://api.z.ai/api/monitor/usage/quota/limit";
 
@@ -124,6 +124,22 @@ export const zaiCodingPlanPlugin: ProviderPlugin = {
       if (!response.ok) {
         log.warn("Failed to fetch Z.ai usage", { status: response.status });
 
+        if (response.status === 429) {
+          const retryAfterHeader = response.headers.get("retry-after");
+          const parsedRetryAfter = retryAfterHeader
+            ? Number.parseInt(retryAfterHeader, 10)
+            : Number.NaN;
+          const retrySec =
+            Number.isFinite(parsedRetryAfter) && parsedRetryAfter > 0 ? parsedRetryAfter : 300;
+          log.warn("Rate limited by Z.ai API", { retryAfterHeader, retryAfterSec: retrySec });
+          return {
+            fetchedAt: Date.now(),
+            error: `Rate limited. Retry after ${retrySec}s.`,
+            rateLimited: true,
+            retryAfterMs: retrySec * 1000,
+          };
+        }
+
         if (response.status === 401 || response.status === 403) {
           return {
             fetchedAt: Date.now(),

package/src/plugins/registry.ts

@@ -1,11 +1,3 @@
-import type { PluginsConfig } from "@/config/schema.ts";
-import {
-  discoverLocalPlugins,
-  loadLocalPlugin,
-  loadNpmPlugin,
-  resolvePluginPath,
-} from "./loader.ts";
-import { installAllNpmPlugins, resolveNpmPluginPath } from "./npm-installer.ts";
 import type {
   AgentPlugin,
   AnyPlugin,
@@ -14,7 +6,15 @@ import type {
   PluginType,
   ProviderPlugin,
   ThemePlugin,
-} from "./types/index.ts";
+} from "@tokentop/plugin-sdk";
+import type { PluginsConfig } from "@/config/schema.ts";
+import {
+  discoverLocalPlugins,
+  loadLocalPlugin,
+  loadNpmPlugin,
+  resolvePluginPath,
+} from "./loader.ts";
+import { installAllNpmPlugins, resolveNpmPluginPath } from "./npm-installer.ts";
 
 export type PluginSource = "builtin" | "local" | "npm";
 

package/src/plugins/sandbox-guard.test.ts

@@ -1,11 +1,11 @@
 import { afterAll, beforeAll, describe, expect, test } from "bun:test";
+import { PluginPermissionError } from "@tokentop/plugin-sdk";
 import {
   deepFreeze,
   getActivePluginGuard,
   installGlobalFetchGuard,
   runInPluginGuard,
 } from "./sandbox-guard.ts";
-import { PluginPermissionError } from "./types/base.ts";
 
 const originalFetch = globalThis.fetch;
 const fetchCalls: string[] = [];

package/src/plugins/sandbox-guard.ts

@@ -11,9 +11,9 @@
  * 2. **Deep-freeze** — prevents plugins from mutating the PluginContext.
  */
 
+import { PluginPermissionError, type PluginPermissions } from "@tokentop/plugin-sdk";
 import { AsyncLocalStorage } from "async_hooks";
 import { createPluginLogger } from "./sandbox.ts";
-import { PluginPermissionError, type PluginPermissions } from "./types/base.ts";
 
 // ---------------------------------------------------------------------------
 // Plugin execution context (AsyncLocalStorage)

package/src/plugins/sandbox.ts

@@ -3,7 +3,7 @@ import {
   type PluginLogger,
   PluginPermissionError,
   type PluginPermissions,
-} from "./types/index.ts";
+} from "@tokentop/plugin-sdk";
 
 export function createSandboxedHttpClient(
   pluginId: string,

package/src/plugins/themes/catppuccin-latte.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const catppuccinLatteTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/catppuccin-mocha.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const catppuccinMochaTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/claude-code.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const claudeCodeTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/dracula.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const draculaTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/github-light.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const githubLightTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/gruvbox-dark.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const gruvboxDarkTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/gruvbox-light.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const gruvboxLightTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/kanagawa.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const kanagawaTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/nord.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const nordTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/one-dark.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const oneDarkTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/opencode.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const opencodeTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/rose-pine-dawn.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const rosePineDawnTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/rose-pine.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const rosePineTheme: ThemePlugin = {
   apiVersion: 2,

package/src/plugins/themes/solarized-light.ts

@@ -1,4 +1,4 @@
-import type { ThemePlugin } from "../types/theme.ts";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 
 export const solarizedLightTheme: ThemePlugin = {
   apiVersion: 2,