@tokentop/ttop 0.2.2 → 0.4.0

package/src/plugins/themes/tokyo-night.ts

@@ -1,45 +1,45 @@
-import type { ThemePlugin } from '../types/theme.ts';
+import type { ThemePlugin } from "../types/theme.ts";
 
 export const tokyoNightTheme: ThemePlugin = {
   apiVersion: 2,
-  id: 'tokyo-night',
-  type: 'theme',
-  name: 'Tokyo Night',
-  family: 'tokyo-night',
-  version: '1.0.0',
+  id: "tokyo-night",
+  type: "theme",
+  name: "Tokyo Night",
+  family: "tokyo-night",
+  version: "1.0.0",
   permissions: {},
 
-  colorScheme: 'dark',
+  colorScheme: "dark",
 
   colors: {
-    background: '#1a1b26',
-    foreground: '#24283b',
-    text: '#c0caf5',
-    textMuted: '#737aa2',
-    textSubtle: '#565f89',
-    primary: '#7aa2f7',
-    secondary: '#bb9af7',
-    accent: '#7dcfff',
-    success: '#9ece6a',
-    warning: '#e0af68',
-    error: '#f7768e',
-    info: '#7aa2f7',
-    border: '#414868',
-    borderMuted: '#292e42',
-    selection: '#33467c',
-    highlight: '#2f3549',
-    gaugeBackground: '#24283b',
-    gaugeFill: '#7aa2f7',
-    gaugeWarning: '#e0af68',
-    gaugeDanger: '#f7768e',
+    background: "#1a1b26",
+    foreground: "#24283b",
+    text: "#c0caf5",
+    textMuted: "#737aa2",
+    textSubtle: "#565f89",
+    primary: "#7aa2f7",
+    secondary: "#bb9af7",
+    accent: "#7dcfff",
+    success: "#9ece6a",
+    warning: "#e0af68",
+    error: "#f7768e",
+    info: "#7aa2f7",
+    border: "#414868",
+    borderMuted: "#292e42",
+    selection: "#33467c",
+    highlight: "#2f3549",
+    gaugeBackground: "#24283b",
+    gaugeFill: "#7aa2f7",
+    gaugeWarning: "#e0af68",
+    gaugeDanger: "#f7768e",
   },
 
   components: {
     header: {
-      background: '#16161e',
+      background: "#16161e",
     },
     statusBar: {
-      background: '#1f2335',
+      background: "#1f2335",
     },
     gauge: {
       height: 1,

package/src/plugins/types/agent.ts

@@ -1,6 +1,6 @@
-import { z } from 'zod';
-import type { BasePlugin, PluginHttpClient, PluginLogger } from './base.ts';
-import type { Credentials, OAuthCredentials, PluginContext } from './provider.ts';
+import { z } from "zod";
+import type { BasePlugin, PluginHttpClient, PluginLogger } from "./base.ts";
+import type { Credentials, OAuthCredentials, PluginContext } from "./provider.ts";
 
 export const AgentCapabilitiesSchema = z.object({
   sessionParsing: z.boolean(),
@@ -38,7 +38,7 @@ export interface AgentProviderConfig {
 
 export interface SessionParseOptions {
   sessionId?: string;
-  timePeriod?: 'session' | 'daily' | 'weekly' | 'monthly';
+  timePeriod?: "session" | "daily" | "weekly" | "monthly";
   limit?: number;
   /** Epoch ms — only return sessions updated after this timestamp. */
   since?: number;
@@ -84,7 +84,7 @@ export interface ActivityUpdate {
 export type ActivityCallback = (update: ActivityUpdate) => void;
 
 export interface AgentPlugin extends BasePlugin {
-  readonly type: 'agent';
+  readonly type: "agent";
   readonly agent: AgentConfig;
   readonly capabilities: AgentCapabilities;
 

package/src/plugins/types/base.ts

@@ -5,7 +5,7 @@
  * authoritative contract for community developers; core adapts to match.
  */
 
-import { z } from 'zod';
+import { z } from "zod";
 
 // ---------------------------------------------------------------------------
 // Identity
@@ -14,7 +14,7 @@ import { z } from 'zod';
 /**
  * Plugin type discriminator
  */
-export type PluginType = 'provider' | 'agent' | 'theme' | 'notification';
+export type PluginType = "provider" | "agent" | "theme" | "notification";
 
 /**
  * Current API contract version.
@@ -30,23 +30,31 @@ export const CURRENT_API_VERSION = 2;
  * Plugin permissions schema - defines what a plugin can access
  */
 export const PluginPermissionsSchema = z.object({
-  network: z.object({
-    enabled: z.boolean(),
-    allowedDomains: z.array(z.string()).optional(),
-  }).optional(),
-  filesystem: z.object({
-    read: z.boolean().optional(),
-    write: z.boolean().optional(),
-    paths: z.array(z.string()).optional(),
-  }).optional(),
-  env: z.object({
-    read: z.boolean().optional(),
-    vars: z.array(z.string()).optional(),
-  }).optional(),
-  system: z.object({
-    notifications: z.boolean().optional(),
-    clipboard: z.boolean().optional(),
-  }).optional(),
+  network: z
+    .object({
+      enabled: z.boolean(),
+      allowedDomains: z.array(z.string()).optional(),
+    })
+    .optional(),
+  filesystem: z
+    .object({
+      read: z.boolean().optional(),
+      write: z.boolean().optional(),
+      paths: z.array(z.string()).optional(),
+    })
+    .optional(),
+  env: z
+    .object({
+      read: z.boolean().optional(),
+      vars: z.array(z.string()).optional(),
+    })
+    .optional(),
+  system: z
+    .object({
+      notifications: z.boolean().optional(),
+      clipboard: z.boolean().optional(),
+    })
+    .optional(),
 });
 
 export type PluginPermissions = z.infer<typeof PluginPermissionsSchema>;
@@ -95,7 +103,7 @@ export type PluginMeta = z.infer<typeof PluginMetaSchema>;
  */
 export interface ConfigField {
   /** Data type of the setting value. */
-  type: 'string' | 'number' | 'boolean' | 'select';
+  type: "string" | "number" | "boolean" | "select";
   /** Label shown in the settings UI. */
   label?: string;
   /** Help text shown below the field. */
@@ -197,7 +205,10 @@ export interface BasePlugin {
    * Called when the user changes this plugin's configuration.
    * Receive the new validated config values.
    */
-  onConfigChange?(config: Record<string, unknown>, ctx: PluginLifecycleContext): Promise<void> | void;
+  onConfigChange?(
+    config: Record<string, unknown>,
+    ctx: PluginLifecycleContext,
+  ): Promise<void> | void;
 }
 
 // ---------------------------------------------------------------------------
@@ -245,7 +256,7 @@ export interface PluginLoadResult<T extends BasePlugin = BasePlugin> {
   success: boolean;
   plugin?: T;
   error?: string;
-  source: 'builtin' | 'local' | 'npm';
+  source: "builtin" | "local" | "npm";
 }
 
 // ---------------------------------------------------------------------------
@@ -259,9 +270,9 @@ export class PluginPermissionError extends Error {
   constructor(
     public readonly pluginId: string,
     public readonly permission: keyof PluginPermissions,
-    message: string
+    message: string,
   ) {
     super(`Plugin "${pluginId}" permission denied: ${message}`);
-    this.name = 'PluginPermissionError';
+    this.name = "PluginPermissionError";
   }
 }

package/src/plugins/types/index.ts

@@ -1,13 +1,13 @@
-export * from './base.ts';
-export * from './provider.ts';
-export * from './agent.ts';
-export * from './theme.ts';
-export * from './notification.ts';
+export * from "./agent.ts";
+export * from "./base.ts";
+export * from "./notification.ts";
+export * from "./provider.ts";
+export * from "./theme.ts";
 
-import type { ProviderPlugin } from './provider.ts';
-import type { AgentPlugin } from './agent.ts';
-import type { ThemePlugin } from './theme.ts';
-import type { NotificationPlugin } from './notification.ts';
+import type { AgentPlugin } from "./agent.ts";
+import type { NotificationPlugin } from "./notification.ts";
+import type { ProviderPlugin } from "./provider.ts";
+import type { ThemePlugin } from "./theme.ts";
 
 export type AnyPlugin = ProviderPlugin | AgentPlugin | ThemePlugin | NotificationPlugin;
 

package/src/plugins/types/notification.ts

@@ -1,21 +1,21 @@
-import type { BasePlugin, PluginLogger } from './base.ts';
+import type { BasePlugin, PluginLogger } from "./base.ts";
 
 // ---------------------------------------------------------------------------
 // Notification Events
 // ---------------------------------------------------------------------------
 
-export type NotificationSeverity = 'info' | 'warning' | 'critical';
+export type NotificationSeverity = "info" | "warning" | "critical";
 
 export type NotificationEventType =
-  | 'budget.thresholdCrossed'
-  | 'budget.limitReached'
-  | 'provider.fetchFailed'
-  | 'provider.limitReached'
-  | 'provider.recovered'
-  | 'plugin.crashed'
-  | 'plugin.disabled'
-  | 'app.started'
-  | 'app.updated';
+  | "budget.thresholdCrossed"
+  | "budget.limitReached"
+  | "provider.fetchFailed"
+  | "provider.limitReached"
+  | "provider.recovered"
+  | "plugin.crashed"
+  | "plugin.disabled"
+  | "app.started"
+  | "app.updated";
 
 export interface NotificationEvent {
   type: NotificationEventType;
@@ -41,7 +41,7 @@ export interface NotificationContext {
 // ---------------------------------------------------------------------------
 
 export interface NotificationPlugin extends BasePlugin {
-  readonly type: 'notification';
+  readonly type: "notification";
 
   initialize(ctx: NotificationContext): Promise<void>;
   notify(ctx: NotificationContext, event: NotificationEvent): Promise<void>;

package/src/plugins/types/provider.ts

@@ -1,4 +1,4 @@
-import type { BasePlugin, PluginHttpClient, PluginLogger } from './base.ts';
+import type { BasePlugin, PluginHttpClient, PluginLogger } from "./base.ts";
 
 export interface ProviderCapabilities {
   usageLimits: boolean;
@@ -15,7 +15,7 @@ export interface Credentials {
   apiKey?: string;
   oauth?: OAuthCredentials;
   groupId?: string;
-  source: 'env' | 'opencode' | 'external' | 'config';
+  source: "env" | "opencode" | "external" | "config";
 }
 
 export interface OAuthCredentials {
@@ -40,7 +40,7 @@ export interface RefreshedCredentials {
 export interface CredentialResult {
   ok: boolean;
   credentials?: Credentials;
-  reason?: 'missing' | 'expired' | 'invalid' | 'error';
+  reason?: "missing" | "expired" | "invalid" | "error";
   message?: string;
 }
 
@@ -49,7 +49,7 @@ export interface CredentialResult {
  * Used by AuthSources.opencode.getProviderEntry().
  */
 export interface OpenCodeAuthEntry {
-  type: 'api' | 'oauth' | 'codex' | 'github' | 'wellknown';
+  type: "api" | "oauth" | "codex" | "github" | "wellknown";
   key?: string;
   access?: string;
   refresh?: string;
@@ -89,7 +89,7 @@ export interface AuthSources {
 
   /** Platform information for cross-platform credential path resolution. */
   platform: {
-    os: 'darwin' | 'linux' | 'win32';
+    os: "darwin" | "linux" | "win32";
     homedir: string;
     arch: string;
   };
@@ -197,7 +197,11 @@ export interface ProviderUsageData {
   cost?: {
     actual?: CostBreakdown;
     estimated?: CostBreakdown;
-    source: 'api' | 'estimated';
+    /** Session-derived daily cost (today only). Set by enrichment hook. */
+    estimatedDaily?: CostBreakdown;
+    /** Session-derived monthly cost (MTD). Set by enrichment hook. */
+    estimatedMonthly?: CostBreakdown;
+    source: "api" | "estimated";
   };
   fetchedAt: number;
   error?: string;
@@ -214,7 +218,7 @@ export interface ProviderFetchContext {
   readonly config: Record<string, unknown>;
   readonly signal: AbortSignal;
   readonly options?: {
-    timePeriod?: 'session' | 'daily' | 'weekly' | 'monthly';
+    timePeriod?: "session" | "daily" | "weekly" | "monthly";
     sessionId?: string;
   };
 }
@@ -224,7 +228,7 @@ export interface ProviderFetchContext {
 // ---------------------------------------------------------------------------
 
 export interface ProviderPlugin extends BasePlugin {
-  readonly type: 'provider';
+  readonly type: "provider";
   readonly capabilities: ProviderCapabilities;
   readonly auth: ProviderAuth;
   readonly pricing?: ProviderPricing;

package/src/plugins/types/theme.ts

@@ -1,5 +1,5 @@
-import { z } from 'zod';
-import type { BasePlugin } from './base.ts';
+import { z } from "zod";
+import type { BasePlugin } from "./base.ts";
 
 export const ThemeColorsSchema = z.object({
   background: z.string(),
@@ -27,34 +27,42 @@ export const ThemeColorsSchema = z.object({
 export type ThemeColors = z.infer<typeof ThemeColorsSchema>;
 
 export const ThemeComponentsSchema = z.object({
-  header: z.object({
-    background: z.string().optional(),
-    foreground: z.string().optional(),
-    titleColor: z.string().optional(),
-    titleAccentColor: z.string().optional(),
-  }).optional(),
-  statusBar: z.object({
-    background: z.string().optional(),
-    foreground: z.string().optional(),
-  }).optional(),
-  commandPalette: z.object({
-    background: z.string().optional(),
-    border: z.string().optional(),
-  }).optional(),
-  gauge: z.object({
-    height: z.number().optional(),
-    borderRadius: z.number().optional(),
-  }).optional(),
+  header: z
+    .object({
+      background: z.string().optional(),
+      foreground: z.string().optional(),
+      titleColor: z.string().optional(),
+      titleAccentColor: z.string().optional(),
+    })
+    .optional(),
+  statusBar: z
+    .object({
+      background: z.string().optional(),
+      foreground: z.string().optional(),
+    })
+    .optional(),
+  commandPalette: z
+    .object({
+      background: z.string().optional(),
+      border: z.string().optional(),
+    })
+    .optional(),
+  gauge: z
+    .object({
+      height: z.number().optional(),
+      borderRadius: z.number().optional(),
+    })
+    .optional(),
 });
 
 export type ThemeComponents = z.infer<typeof ThemeComponentsSchema>;
 
-export type ColorScheme = 'light' | 'dark';
+export type ColorScheme = "light" | "dark";
 
-export type ColorSchemePreference = 'auto' | 'light' | 'dark';
+export type ColorSchemePreference = "auto" | "light" | "dark";
 
 export interface ThemePlugin extends BasePlugin {
-  readonly type: 'theme';
+  readonly type: "theme";
   readonly family: string;
   readonly colorScheme: ColorScheme;
   readonly colors: ThemeColors;

package/src/plugins/update-checker.ts

@@ -9,7 +9,7 @@
  * skipped because they have no registry entry to compare against.
  */
 
-import type { PluginType } from './types/base.ts';
+import type { PluginType } from "./types/base.ts";
 
 // ---------------------------------------------------------------------------
 // Types
@@ -33,7 +33,7 @@ export interface PluginUpdateInfo {
 // ---------------------------------------------------------------------------
 
 function parseVersion(v: string): [number, number, number] | null {
-  const clean = v.replace(/^v/, '');
+  const clean = v.replace(/^v/, "");
   const match = clean.match(/^(\d+)\.(\d+)\.(\d+)/);
   if (!match) return null;
   return [Number(match[1]), Number(match[2]), Number(match[3])];
@@ -60,9 +60,9 @@ function isNewer(current: string, latest: string): boolean {
  * Uses the abbreviated metadata endpoint for minimal payload.
  */
 async function fetchLatestVersion(packageName: string): Promise<string> {
-  const url = `https://registry.npmjs.org/${encodeURIComponent(packageName).replace('%40', '@')}`;
+  const url = `https://registry.npmjs.org/${encodeURIComponent(packageName).replace("%40", "@")}`;
   const res = await fetch(url, {
-    headers: { Accept: 'application/vnd.npm.install-v1+json' },
+    headers: { Accept: "application/vnd.npm.install-v1+json" },
     signal: AbortSignal.timeout(8_000),
   });
 
@@ -70,8 +70,8 @@ async function fetchLatestVersion(packageName: string): Promise<string> {
     throw new Error(`npm registry returned ${res.status} for ${packageName}`);
   }
 
-  const data = (await res.json()) as { 'dist-tags'?: { latest?: string } };
-  const latest = data?.['dist-tags']?.latest;
+  const data = (await res.json()) as { "dist-tags"?: { latest?: string } };
+  const latest = data?.["dist-tags"]?.latest;
   if (!latest) {
     throw new Error(`No dist-tags.latest found for ${packageName}`);
   }

package/src/pricing/estimator.test.ts

@@ -1,14 +1,9 @@
-import { describe, expect, test } from 'bun:test';
-import type { ModelPricing } from '@/plugins/types/provider.ts';
-import {
-  estimateCost,
-  estimateSessionCost,
-  formatCost,
-  formatTokenCount,
-} from './estimator.ts';
-
-describe('estimateCost()', () => {
-  test('calculates input and output costs for a typical coding session', () => {
+import { describe, expect, test } from "bun:test";
+import type { ModelPricing } from "@/plugins/types/provider.ts";
+import { estimateCost, estimateSessionCost, formatCost, formatTokenCount } from "./estimator.ts";
+
+describe("estimateCost()", () => {
+  test("calculates input and output costs for a typical coding session", () => {
     const usage = { input: 150_000, output: 50_000 };
     const pricing: ModelPricing = { input: 3, output: 15 };
 
@@ -16,11 +11,11 @@ describe('estimateCost()', () => {
       total: 1.2,
       input: 0.45,
       output: 0.75,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 
-  test('includes cache read and write costs when both usage and pricing are present', () => {
+  test("includes cache read and write costs when both usage and pricing are present", () => {
     const usage = { input: 100_000, output: 25_000, cacheRead: 80_000, cacheWrite: 40_000 };
     const pricing: ModelPricing = {
       input: 3,
@@ -35,11 +30,11 @@ describe('estimateCost()', () => {
       output: 0.375,
       cacheRead: 0.024,
       cacheWrite: 0.15,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 
-  test('does not include cache fields when cache pricing is unavailable', () => {
+  test("does not include cache fields when cache pricing is unavailable", () => {
     const usage = { input: 10_000, output: 20_000, cacheRead: 5_000, cacheWrite: 7_000 };
     const pricing: ModelPricing = { input: 2, output: 8 };
 
@@ -47,11 +42,11 @@ describe('estimateCost()', () => {
       total: 0.18,
       input: 0.02,
       output: 0.16,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 
-  test('returns zero cost for zero token usage', () => {
+  test("returns zero cost for zero token usage", () => {
     const usage = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
     const pricing: ModelPricing = { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 };
 
@@ -59,11 +54,11 @@ describe('estimateCost()', () => {
       total: 0,
       input: 0,
       output: 0,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 
-  test('handles very large token counts correctly', () => {
+  test("handles very large token counts correctly", () => {
     const usage = {
       input: 123_456_789,
       output: 987_654_321,
@@ -83,11 +78,11 @@ describe('estimateCost()', () => {
       output: 9876.54321,
       cacheRead: 5.555556,
       cacheWrite: 44.444444,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 
-  test('rounds costs to six decimal places', () => {
+  test("rounds costs to six decimal places", () => {
     const usage = { input: 1, output: 1 };
     const pricing: ModelPricing = { input: 1.234567, output: 2.345678 };
 
@@ -95,13 +90,13 @@ describe('estimateCost()', () => {
       total: 0.000004,
       input: 0.000001,
       output: 0.000002,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 });
 
-describe('estimateSessionCost()', () => {
-  test('aggregates multiple sessions before estimating cost', () => {
+describe("estimateSessionCost()", () => {
+  test("aggregates multiple sessions before estimating cost", () => {
     const sessions = [
       { input: 100_000, output: 20_000, cacheRead: 10_000, cacheWrite: 5_000 },
       { input: 50_000, output: 10_000, cacheRead: 5_000, cacheWrite: 10_000 },
@@ -120,22 +115,22 @@ describe('estimateSessionCost()', () => {
       output: 0.525,
       cacheRead: 0.0045,
       cacheWrite: 0.05625,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 
-  test('returns zero cost for an empty session list', () => {
+  test("returns zero cost for an empty session list", () => {
     const pricing: ModelPricing = { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 };
 
     expect(estimateSessionCost([], pricing)).toEqual({
       total: 0,
       input: 0,
       output: 0,
-      currency: 'USD',
+      currency: "USD",
     });
   });
 
-  test('matches estimateCost for a single session', () => {
+  test("matches estimateCost for a single session", () => {
     const session = { input: 150_000, output: 50_000, cacheRead: 80_000, cacheWrite: 40_000 };
     const pricing: ModelPricing = {
       input: 3,
@@ -148,34 +143,34 @@ describe('estimateSessionCost()', () => {
   });
 });
 
-describe('formatCost()', () => {
-  test('formats USD costs below $0.01 with 4 decimal places', () => {
-    expect(formatCost(0.009876)).toBe('$0.0099');
+describe("formatCost()", () => {
+  test("formats USD costs below $0.01 with 4 decimal places", () => {
+    expect(formatCost(0.009876)).toBe("$0.0099");
   });
 
-  test('formats USD costs below $1 with 3 decimal places', () => {
-    expect(formatCost(0.45678)).toBe('$0.457');
+  test("formats USD costs below $1 with 3 decimal places", () => {
+    expect(formatCost(0.45678)).toBe("$0.457");
   });
 
-  test('formats USD costs at or above $1 with 2 decimal places', () => {
-    expect(formatCost(12.3456)).toBe('$12.35');
+  test("formats USD costs at or above $1 with 2 decimal places", () => {
+    expect(formatCost(12.3456)).toBe("$12.35");
   });
 
-  test('formats non-USD currency with 4 decimals and currency suffix', () => {
-    expect(formatCost(12.3456, 'EUR')).toBe('12.3456 EUR');
+  test("formats non-USD currency with 4 decimals and currency suffix", () => {
+    expect(formatCost(12.3456, "EUR")).toBe("12.3456 EUR");
   });
 });
 
-describe('formatTokenCount()', () => {
-  test('returns raw token count for values below 1K', () => {
-    expect(formatTokenCount(999)).toBe('999');
+describe("formatTokenCount()", () => {
+  test("returns raw token count for values below 1K", () => {
+    expect(formatTokenCount(999)).toBe("999");
   });
 
-  test('formats token count in K for values below 1M', () => {
-    expect(formatTokenCount(12_500)).toBe('12.5K');
+  test("formats token count in K for values below 1M", () => {
+    expect(formatTokenCount(12_500)).toBe("12.5K");
   });
 
-  test('formats token count in M for values at or above 1M', () => {
-    expect(formatTokenCount(2_345_678)).toBe('2.35M');
+  test("formats token count in M for values at or above 1M", () => {
+    expect(formatTokenCount(2_345_678)).toBe("2.35M");
   });
 });