@tokentop/ttop 0.4.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokentop/ttop",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Real-time AI token usage monitor - htop for your API costs",
   "author": "Nigel Bazzeghin <nbazzeghin@gmail.com>",
   "license": "MIT",
@@ -33,11 +33,13 @@
     "snapshot": "bun src/tui/debug/snapshot.tsx"
   },
   "dependencies": {
-    "@opentui/core": "0.1.81",
-    "@opentui/react": "0.1.81",
+    "@opentui/core": "0.1.84",
+    "@opentui/react": "0.1.84",
     "@tokentop/agent-claude-code": "^1.1.0",
+    "@tokentop/agent-cursor": "^1.2.0",
     "@tokentop/agent-opencode": "^1.0.0",
-    "@tokentop/plugin-sdk": "^1.1.0",
+    "@tokentop/agent-copilot-cli": "^1.0.0",
+    "@tokentop/plugin-sdk": "^1.3.0",
     "react": "^19.0.0",
     "react-devtools-core": "^7.0.1",
     "zod": "^4.0.0"
@@ -67,5 +69,8 @@
   },
   "engines": {
     "bun": ">=1.0.0"
+  },
+  "overrides": {
+    "@types/node": "^25.0.0"
   }
 }

package/src/agents/aggregator.ts

@@ -1,4 +1,4 @@
-import type { SessionUsageData } from "@/plugins/types/agent.ts";
+import type { SessionUsageData } from "@tokentop/plugin-sdk";
 import {
   type AgentId,
   type AgentName,
@@ -189,6 +189,13 @@ export function aggregateSessionUsage(options: AggregateOptions): AgentSessionAg
     };
     if (session.sessionName) aggregate.sessionName = session.sessionName;
     if (session.projectPath) aggregate.projectPath = session.projectPath;
+
+    // Propagate metadata — session is estimated if any row is estimated
+    const sessionRows = rows.filter((r) => r.sessionId === sessionId);
+    const anyEstimated = sessionRows.some((r) => (r.metadata?.isEstimated as boolean) === true);
+    if (anyEstimated) {
+      aggregate.metadata = { isEstimated: true };
+    }
     results.push(aggregate);
   }
 

package/src/agents/types.ts

@@ -60,6 +60,9 @@ export interface AgentSessionAggregate {
 
   /** @internal Keyed by `providerId::modelId`. Set by aggregator, consumed by costing. */
   _streamWindowedTokens?: Map<string, StreamWindowedTokens>;
+
+  /** Plugin-provided metadata merged from underlying SessionUsageData rows. */
+  metadata?: Record<string, unknown>;
 }
 
 export interface AgentInfo {

package/src/cli.ts

@@ -114,7 +114,7 @@ async function main() {
       }
       const seedStr = commandArgs[++i];
       const seed = seedStr ? parseInt(seedStr, 10) : NaN;
-      if (isNaN(seed)) {
+      if (Number.isNaN(seed)) {
         console.error("Error: --seed requires a number");
         process.exit(1);
       }
@@ -137,7 +137,7 @@ async function main() {
     if (arg === "-r" || arg === "--refresh") {
       const intervalStr = commandArgs[++i];
       const interval = intervalStr ? parseInt(intervalStr, 10) : NaN;
-      if (isNaN(interval) || interval < 1000) {
+      if (Number.isNaN(interval) || interval < 1000) {
         console.error("Error: --refresh must be a number >= 1000");
         process.exit(1);
       }

package/src/demo/simulator.ts

@@ -1,5 +1,5 @@
+import type { ProviderUsageData } from "@tokentop/plugin-sdk";
 import type { AgentSessionAggregate, AgentSessionStream } from "@/agents/types.ts";
-import type { ProviderUsageData } from "@/plugins/types/provider.ts";
 import type { UsageEventInsert } from "@/storage/types.ts";
 
 /**

package/src/plugins/agents/index.ts

@@ -1,2 +1,4 @@
 export { default as claudeCodeAgentPlugin } from "@tokentop/agent-claude-code";
+export { default as copilotCliAgentPlugin } from "@tokentop/agent-copilot-cli";
+export { default as cursorAgentPlugin } from "@tokentop/agent-cursor";
 export { default as opencodeAgentPlugin } from "@tokentop/agent-opencode";

package/src/plugins/auth-sources.ts

@@ -1,9 +1,8 @@
+import type { AuthSources, OpenCodeAuthEntry, PluginPermissions } from "@tokentop/plugin-sdk";
+import { PluginPermissionError } from "@tokentop/plugin-sdk";
 import * as fs from "fs/promises";
 import * as os from "os";
 import * as path from "path";
-import type { PluginPermissions } from "./types/base.ts";
-import { PluginPermissionError } from "./types/base.ts";
-import type { AuthSources, OpenCodeAuthEntry } from "./types/provider.ts";
 
 const OPENCODE_AUTH_PATH = path.join(os.homedir(), ".local/share/opencode/auth.json");
 const OPENCODE_CONFIG_PATH = path.join(os.homedir(), ".config/opencode/opencode.json");

package/src/plugins/lifecycle.ts

@@ -5,11 +5,11 @@
  * with safeInvoke for error isolation and circuit breaker protection.
  */
 
+import type { BasePlugin, PluginLifecycleContext, PluginLogger } from "@tokentop/plugin-sdk";
 import { safeInvoke } from "./plugin-host.ts";
 import { pluginRegistry } from "./registry.ts";
 import { createPluginLogger } from "./sandbox.ts";
 import { runInPluginGuard } from "./sandbox-guard.ts";
-import type { BasePlugin, PluginLifecycleContext, PluginLogger } from "./types/base.ts";
 
 // ---------------------------------------------------------------------------
 // State machine

package/src/plugins/loader.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
+import { CURRENT_API_VERSION } from "@tokentop/plugin-sdk";
 import { validatePlugin } from "./loader.ts";
-import { CURRENT_API_VERSION } from "./types/base.ts";
 
 const validPlugin = {
   id: "test-plugin",

package/src/plugins/loader.ts

@@ -1,14 +1,22 @@
+import type { AnyPlugin, BasePlugin, PluginType } from "@tokentop/plugin-sdk";
+import { CURRENT_API_VERSION } from "@tokentop/plugin-sdk";
 import * as fs from "fs/promises";
 import * as os from "os";
 import * as path from "path";
 import { PATHS } from "@/storage/paths.ts";
-import { CURRENT_API_VERSION } from "./types/base.ts";
-import type {
-  AnyPlugin,
-  PluginLoadResult,
-  PluginType,
-  PluginValidationResult,
-} from "./types/index.ts";
+
+interface PluginValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+}
+
+interface PluginLoadResult<T extends BasePlugin = BasePlugin> {
+  success: boolean;
+  plugin?: T;
+  error?: string;
+  source: "builtin" | "local" | "npm";
+}
 
 const CUSTOM_PLUGINS_DIR = PATHS.config.plugins;
 

package/src/plugins/notification-bus.ts

@@ -1,8 +1,11 @@
+import type {
+  NotificationEvent,
+  NotificationPlugin,
+  ProviderUsageData,
+} from "@tokentop/plugin-sdk";
 import type { AppConfig } from "@/config/schema.ts";
 import { safeInvoke } from "./plugin-host.ts";
 import { createPluginLogger } from "./sandbox.ts";
-import type { NotificationEvent, NotificationPlugin } from "./types/notification.ts";
-import type { ProviderUsageData } from "./types/provider.ts";
 
 interface DedupEntry {
   key: string;

package/src/plugins/notifications/terminal-bell.ts

@@ -2,7 +2,7 @@ import type {
   NotificationContext,
   NotificationEvent,
   NotificationPlugin,
-} from "../types/notification.ts";
+} from "@tokentop/plugin-sdk";
 
 export const terminalBellPlugin: NotificationPlugin = {
   apiVersion: 2,

package/src/plugins/notifications/visual-flash.ts

@@ -2,7 +2,7 @@ import type {
   NotificationContext,
   NotificationEvent,
   NotificationPlugin,
-} from "../types/notification.ts";
+} from "@tokentop/plugin-sdk";
 
 export const visualFlashPlugin: NotificationPlugin = {
   apiVersion: 2,

package/src/plugins/plugin-context-factory.ts

@@ -1,27 +1,17 @@
+import type { PluginContext, PluginPermissions, PluginStorage } from "@tokentop/plugin-sdk";
+import { isDatabaseInitialized } from "@/storage/db.ts";
 import {
-  getDatabase,
   pluginStorageDelete,
   pluginStorageGet,
   pluginStorageHas,
   pluginStorageSet,
-} from "@/storage/database.ts";
+} from "@/storage/repos/pluginStorage.ts";
 import { createAuthSources } from "./auth-sources.ts";
 import { createPluginLogger, createSandboxedHttpClient } from "./sandbox.ts";
 import { deepFreeze } from "./sandbox-guard.ts";
-import type { PluginPermissions } from "./types/base.ts";
-import type { PluginContext, PluginStorage } from "./types/provider.ts";
-
-let dbAvailable: boolean | null = null;
 
 function isDbAvailable(): boolean {
-  if (dbAvailable !== null) return dbAvailable;
-  try {
-    getDatabase();
-    dbAvailable = true;
-  } catch {
-    dbAvailable = false;
-  }
-  return dbAvailable;
+  return isDatabaseInitialized();
 }
 
 function createPluginStorage(pluginId: string): PluginStorage {
@@ -44,11 +34,6 @@ function createPluginStorage(pluginId: string): PluginStorage {
     },
   };
 }
-
-export function resetDbAvailableCache(): void {
-  dbAvailable = null;
-}
-
 export function createPluginContext(
   pluginId: string,
   permissions: PluginPermissions,

package/src/plugins/providers/anthropic.ts

@@ -1,4 +1,3 @@
-import { execFileSync } from "child_process";
 import type {
   CredentialResult,
   Credentials,
@@ -8,7 +7,8 @@ import type {
   ProviderFetchContext,
   ProviderPlugin,
   ProviderUsageData,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
+import { execFileSync } from "child_process";
 
 const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000;
 

package/src/plugins/providers/antigravity.ts

@@ -9,7 +9,7 @@ import type {
   ProviderUsageData,
   RefreshedCredentials,
   UsageLimit,
-} from "../types/provider.ts";
+} from "@tokentop/plugin-sdk";
 
 const ANTIGRAVITY_ENDPOINTS = [
   "https://daily-cloudcode-pa.sandbox.googleapis.com",

package/src/plugins/providers/chutes.ts

@@ -0,0 +1,189 @@
+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 === 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;

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";
 

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;

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";
 

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;

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):

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";
 

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,