@tokentop/ttop 0.4.0 → 0.5.0

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,

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

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

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 "@tokentop/plugin-sdk";
 
 // ---------------------------------------------------------------------------
 // Types
@@ -60,7 +60,7 @@ 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).replaceAll("%40", "@")}`;
   const res = await fetch(url, {
     headers: { Accept: "application/vnd.npm.install-v1+json" },
     signal: AbortSignal.timeout(8_000),

package/src/pricing/estimator.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import type { ModelPricing } from "@/plugins/types/provider.ts";
+import type { ModelPricing } from "@tokentop/plugin-sdk";
 import { estimateCost, estimateSessionCost, formatCost, formatTokenCount } from "./estimator.ts";
 
 describe("estimateCost()", () => {

package/src/pricing/estimator.ts

@@ -1,4 +1,4 @@
-import type { CostBreakdown, ModelPricing } from "@/plugins/types/provider.ts";
+import type { CostBreakdown, ModelPricing } from "@tokentop/plugin-sdk";
 
 export interface TokenUsage {
   input: number;

package/src/pricing/fallback.ts

@@ -1,4 +1,4 @@
-import type { ModelPricing } from "@/plugins/types/provider.ts";
+import type { ModelPricing } from "@tokentop/plugin-sdk";
 
 //TODO: get more up to date fallback pricing
 export const FALLBACK_PRICING: Record<string, Record<string, ModelPricing>> = {

package/src/pricing/index.ts

@@ -1,4 +1,4 @@
-import type { ModelPricing, ProviderPlugin, ProviderPricing } from "@/plugins/types/provider.ts";
+import type { ModelPricing, ProviderPlugin, ProviderPricing } from "@tokentop/plugin-sdk";
 import { getFallbackPricing, getFallbackProviderPricing } from "./fallback.ts";
 import {
   clearCache as clearModelsDevCache,

package/src/pricing/models-dev.ts

@@ -1,4 +1,4 @@
-import type { ModelPricing } from "@/plugins/types/provider.ts";
+import type { ModelPricing } from "@tokentop/plugin-sdk";
 
 const MODELS_DEV_API = "https://models.dev/api.json";
 const CACHE_TTL_MS = 3600000;

package/src/storage/index.ts

@@ -15,6 +15,12 @@ export {
   insertAgentSessionSnapshot,
   upsertAgentSession,
 } from "./repos/agentSessions.ts";
+export {
+  pluginStorageDelete,
+  pluginStorageGet,
+  pluginStorageHas,
+  pluginStorageSet,
+} from "./repos/pluginStorage.ts";
 export {
   getLatestProviderSnapshot,
   insertProviderSnapshot,

package/src/storage/migrations/index.ts

@@ -164,6 +164,23 @@ export const migrations: Migration[] = [
       `);
     },
   },
+  {
+    version: 2,
+    up: (db: Database) => {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS plugin_storage (
+          plugin_id TEXT NOT NULL,
+          key TEXT NOT NULL,
+          value TEXT NOT NULL,
+          updated_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+          PRIMARY KEY (plugin_id, key)
+        );
+
+        CREATE INDEX IF NOT EXISTS idx_plugin_storage_plugin
+          ON plugin_storage(plugin_id);
+      `);
+    },
+  },
 ];
 
 export function getCurrentVersion(db: Database): number {

package/src/storage/repos/pluginStorage.ts

@@ -0,0 +1,35 @@
+import { getDatabase } from "../db.ts";
+
+// ---------------------------------------------------------------------------
+// Plugin KV storage
+// ---------------------------------------------------------------------------
+
+export function pluginStorageGet(pluginId: string, key: string): string | null {
+  const db = getDatabase();
+  const row = db
+    .prepare("SELECT value FROM plugin_storage WHERE plugin_id = ? AND key = ?")
+    .get(pluginId, key) as { value: string } | null;
+  return row?.value ?? null;
+}
+
+export function pluginStorageSet(pluginId: string, key: string, value: string): void {
+  const db = getDatabase();
+  db.prepare(
+    `INSERT INTO plugin_storage (plugin_id, key, value, updated_at)
+     VALUES (?, ?, ?, ?)
+     ON CONFLICT(plugin_id, key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at`,
+  ).run(pluginId, key, value, Math.floor(Date.now() / 1000));
+}
+
+export function pluginStorageDelete(pluginId: string, key: string): void {
+  const db = getDatabase();
+  db.prepare("DELETE FROM plugin_storage WHERE plugin_id = ? AND key = ?").run(pluginId, key);
+}
+
+export function pluginStorageHas(pluginId: string, key: string): boolean {
+  const db = getDatabase();
+  const row = db
+    .prepare("SELECT 1 FROM plugin_storage WHERE plugin_id = ? AND key = ?")
+    .get(pluginId, key);
+  return row !== null && row !== undefined;
+}

package/src/tui/App.tsx

@@ -1,7 +1,7 @@
 import { useKeyboard } from "@opentui/react";
+import type { ThemePlugin } from "@tokentop/plugin-sdk";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import * as builtinThemeExports from "@/plugins/themes/index.ts";
-import type { ThemePlugin } from "@/plugins/types/theme.ts";
 import { resolveTheme, ThemeProvider, useColors, useTheme } from "./contexts/ThemeContext.tsx";
 import {
   type BurstRecorder,

package/src/tui/components/ProviderCard.tsx

@@ -1,7 +1,7 @@
 import type { BoxRenderable } from "@opentui/core";
 import { useTerminalDimensions } from "@opentui/react";
+import type { ProviderUsageData } from "@tokentop/plugin-sdk";
 import { forwardRef, useCallback, useEffect, useState } from "react";
-import type { ProviderUsageData } from "@/plugins/types/provider.ts";
 import { useColors } from "../contexts/ThemeContext.tsx";
 import { SkeletonProviderContent } from "./Skeleton.tsx";
 import { useSpinner } from "./Spinner.tsx";

package/src/tui/components/ProviderDetailPanel.tsx

@@ -1,4 +1,4 @@
-import type { UsageLimit } from "@/plugins/types/provider.ts";
+import type { UsageLimit } from "@tokentop/plugin-sdk";
 import type { ProviderState } from "../contexts/PluginContext.tsx";
 import { useColors } from "../contexts/ThemeContext.tsx";
 import { Sparkline } from "./Sparkline.tsx";

package/src/tui/components/SessionDetailsDrawer.tsx

@@ -314,6 +314,16 @@ export function SessionDetailsDrawer({ session, onClose: _onClose }: SessionDeta
             </text>
           </box>
 
+          {session.metadata?.isEstimated === true && (
+            <box flexDirection="row" height={1} marginBottom={0}>
+              <text height={1} overflow="hidden">
+                <span fg={colors.warning}>
+                  ≈ Token data is estimated — server enrichment pending
+                </span>
+              </text>
+            </box>
+          )}
+
           {hasCacheData && (
             <box flexDirection="row" height={1} marginBottom={0}>
               <text height={1} overflow="hidden">

package/src/tui/components/SessionsTable.tsx

@@ -154,6 +154,7 @@ const SessionRow = memo(function SessionRow({
   const effectiveTokens = session.totals.input + session.totals.output;
   const cacheRead = session.totals.cacheRead ?? 0;
   const hasCacheData = cacheRead > 0;
+  const isEstimated = session.metadata?.isEstimated === true;
   const costUsd = session.totalCostUsd ?? 0;
 
   const animatedTokens = useAnimatedValue(effectiveTokens, { durationMs: 300, precision: 0 });
@@ -260,7 +261,10 @@ const SessionRow = memo(function SessionRow({
           {String(session.requestCount).padStart(4)}
         </text>
         <text width={14} height={1} {...bgProp}>
-          <span fg={tokenColor}>{formatTokensVal(animatedTokens).padStart(7)}</span>
+          <span fg={tokenColor}>
+            {isEstimated ? "≈" : " "}
+            {formatTokensVal(animatedTokens).padStart(7)}
+          </span>
           <span fg={colors.textMuted}>
             {hasCacheData ? ` ↯${formatCacheBadge(cacheRead)}` : ""}
           </span>
@@ -315,7 +319,10 @@ const SessionRow = memo(function SessionRow({
           : modelWithCount.padEnd(narrowModelMaxChars)}
       </text>
       <text width={narrowTokenW} height={1} {...bgProp}>
-        <span fg={tokenColor}>{formatTokensVal(animatedTokens).padStart(7)}</span>
+        <span fg={tokenColor}>
+          {isEstimated ? "≈" : " "}
+          {formatTokensVal(animatedTokens).padStart(7)}
+        </span>
         <span fg={colors.textMuted}>
           {hasCacheData && showCacheBadge ? ` ↯${formatCacheBadge(cacheRead)}` : ""}
         </span>

package/src/tui/components/SettingsModal.tsx

@@ -1,7 +1,7 @@
 import { useKeyboard, useTerminalDimensions } from "@opentui/react";
+import type { ConfigField, PluginType } from "@tokentop/plugin-sdk";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import type { AppConfig, SparklineOrientation, SparklineStyle } from "@/config/schema.ts";
-import type { ConfigField, PluginType } from "@/plugins/types/base.ts";
 import { formatBudgetDisplay, parseCurrencyInput } from "@/utils/currency.ts";
 import { useConfig } from "../contexts/ConfigContext.tsx";
 import { useDemoMode } from "../contexts/DemoModeContext.tsx";

package/src/tui/components/ThemePicker.tsx

@@ -1,6 +1,6 @@
 import { useKeyboard } from "@opentui/react";
+import type { ColorSchemePreference, ThemePlugin } from "@tokentop/plugin-sdk";
 import { useEffect, useMemo, useState } from "react";
-import type { ColorSchemePreference, ThemePlugin } from "@/plugins/types/theme.ts";
 import { useColors } from "../contexts/ThemeContext.tsx";
 
 interface ThemePickerProps {

package/src/tui/contexts/AgentSessionContext.tsx

@@ -1,3 +1,4 @@
+import type { AgentPlugin, SessionParseOptions } from "@tokentop/plugin-sdk";
 import {
   createContext,
   type ReactNode,
@@ -13,7 +14,6 @@ import type { AgentId, AgentInfo, AgentSessionAggregate } from "@/agents/types.t
 import { createPluginContext } from "@/plugins/plugin-context-factory.ts";
 import { pluginRegistry } from "@/plugins/registry.ts";
 import { createPluginLogger, createSandboxedHttpClient } from "@/plugins/sandbox.ts";
-import type { AgentPlugin, SessionParseOptions } from "@/plugins/types/agent.ts";
 import { persistSessions } from "@/storage/persistence-service.ts";
 import type { PricingSource } from "@/storage/types.ts";
 import { useDemoMode } from "./DemoModeContext.tsx";

package/src/tui/contexts/PluginContext.tsx

@@ -1,3 +1,11 @@
+import type {
+  AgentPlugin,
+  Credentials,
+  NotificationPlugin,
+  ProviderPlugin,
+  ProviderUsageData,
+  ThemePlugin,
+} from "@tokentop/plugin-sdk";
 import {
   createContext,
   type ReactNode,
@@ -14,10 +22,6 @@ import { safeInvoke, safeInvokeSync } from "@/plugins/plugin-host.ts";
 import { pluginRegistry } from "@/plugins/registry.ts";
 import { createPluginLogger, createSandboxedHttpClient } from "@/plugins/sandbox.ts";
 import { installGlobalFetchGuard, runInPluginGuard } from "@/plugins/sandbox-guard.ts";
-import type { AgentPlugin } from "@/plugins/types/agent.ts";
-import type { NotificationPlugin } from "@/plugins/types/notification.ts";
-import type { Credentials, ProviderPlugin, ProviderUsageData } from "@/plugins/types/provider.ts";
-import type { ThemePlugin } from "@/plugins/types/theme.ts";
 import { initPricingFromPlugins } from "@/pricing/index.ts";
 import type { ProviderSnapshotInsert } from "@/storage/types.ts";
 import { useConfig } from "./ConfigContext.tsx";

package/src/tui/contexts/RealTimeActivityContext.tsx

@@ -1,3 +1,4 @@
+import type { ActivityUpdate } from "@tokentop/plugin-sdk";
 import {
   createContext,
   type ReactNode,
@@ -9,7 +10,6 @@ import {
 } from "react";
 import { createPluginContext } from "@/plugins/plugin-context-factory.ts";
 import { pluginRegistry } from "@/plugins/registry.ts";
-import type { ActivityUpdate } from "@/plugins/types/agent.ts";
 import { useDemoMode } from "./DemoModeContext.tsx";
 import { useLogs } from "./LogContext.tsx";
 import { usePlugins } from "./PluginContext.tsx";
@@ -50,25 +50,38 @@ export function RealTimeActivityProvider({ children }: { children: ReactNode })
     };
   }, []);
 
-  const handleActivityUpdate = useCallback(
-    (update: ActivityUpdate) => {
-      const key = `${update.sessionId}:${update.messageId}`;
-      const prev = lastSeenRef.current.get(key);
-      const prevTokens = prev?.tokens ?? 0;
-      const newTokens = update.tokens.input + update.tokens.output + (update.tokens.reasoning ?? 0);
-      const delta = Math.max(0, newTokens - prevTokens);
-
-      if (delta > 0) {
-        lastSeenRef.current.set(key, { tokens: newTokens, updatedAt: Date.now() });
-        setLastActivityAt(update.timestamp);
-        debug(`Real-time activity: +${delta} tokens`, { sessionId: update.sessionId }, "realtime");
-
-        for (const listener of listenersRef.current) {
-          listener(delta, update.timestamp);
-        }
+  // Store the actual handler logic in a ref so it always has access to the
+  // latest `debug` without changing callback identity. This prevents the
+  // useEffect below from re-running on every render (which would trigger
+  // stopActivityWatch/startActivityWatch churn on every plugin).
+  const handleActivityUpdateRef = useRef<(update: ActivityUpdate) => void>(() => {});
+  handleActivityUpdateRef.current = (update: ActivityUpdate) => {
+    const key = `${update.sessionId}:${update.messageId}`;
+    const prev = lastSeenRef.current.get(key);
+    const prevTokens = prev?.tokens ?? 0;
+    const input = update.tokens.input ?? 0;
+    const output = update.tokens.output ?? 0;
+    const reasoning = update.tokens.reasoning ?? 0;
+    const newTokens = input + output + reasoning;
+    if (!Number.isFinite(newTokens)) return;
+    const delta = Math.max(0, newTokens - prevTokens);
+
+    if (delta > 0) {
+      lastSeenRef.current.set(key, { tokens: newTokens, updatedAt: Date.now() });
+      setLastActivityAt(update.timestamp);
+      debug(`Real-time activity: +${delta} tokens`, { sessionId: update.sessionId }, "realtime");
+
+      for (const listener of listenersRef.current) {
+        listener(delta, update.timestamp);
       }
-    },
-    [debug],
+    }
+  };
+
+  // Stable wrapper — identity never changes, so the useEffect below only
+  // runs once per plugin initialization (not on every debug/info change).
+  const handleActivityUpdate = useCallback(
+    (update: ActivityUpdate) => handleActivityUpdateRef.current(update),
+    [],
   );
 
   useEffect(() => {
@@ -106,7 +119,7 @@ export function RealTimeActivityProvider({ children }: { children: ReactNode })
         cleanupRef.current = null;
       }
     };
-  }, [pluginsInitialized, demoMode, handleActivityUpdate, info]);
+  }, [pluginsInitialized, demoMode, handleActivityUpdate]);
 
   useEffect(() => {
     const interval = setInterval(() => {

package/src/tui/contexts/ThemeContext.tsx

@@ -1,12 +1,12 @@
-import { createContext, type ReactNode, useContext, useState } from "react";
-import { tokyoNightTheme } from "@/plugins/themes/tokyo-night.ts";
 import type {
   ColorScheme,
   ColorSchemePreference,
   ThemeColors,
   ThemeComponents,
   ThemePlugin,
-} from "@/plugins/types/theme.ts";
+} from "@tokentop/plugin-sdk";
+import { createContext, type ReactNode, useContext, useState } from "react";
+import { tokyoNightTheme } from "@/plugins/themes/tokyo-night.ts";
 
 interface ThemeContextValue {
   theme: ThemePlugin;

package/src/tui/hooks/useSessionEnrichedProviders.ts

@@ -1,6 +1,6 @@
+import type { ProviderUsageData } from "@tokentop/plugin-sdk";
 import { useMemo } from "react";
 import type { AgentSessionAggregate } from "@/agents/types.ts";
-import type { ProviderUsageData } from "@/plugins/types/provider.ts";
 import type { ProviderState } from "../contexts/PluginContext.tsx";
 
 interface ProviderSessionTotals {

package/src/tui/views/SettingsView.tsx

@@ -1,7 +1,7 @@
 import { useKeyboard, useTerminalDimensions } from "@opentui/react";
+import type { ConfigField } from "@tokentop/plugin-sdk";
 import { useCallback, useMemo, useState } from "react";
 import type { AppConfig } from "@/config/schema.ts";
-import type { ConfigField } from "@/plugins/types/base.ts";
 import { useConfig } from "../contexts/ConfigContext.tsx";
 import { useDemoMode } from "../contexts/DemoModeContext.tsx";
 import { usePlugins } from "../contexts/PluginContext.tsx";

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.4.0"; // x-release-please-version
+export const VERSION = "0.5.0"; // x-release-please-version

package/src/plugins/types/agent.ts

@@ -1,108 +0,0 @@
-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(),
-  authReading: z.boolean(),
-  realTimeTracking: z.boolean(),
-  multiProvider: z.boolean(),
-});
-
-export type AgentCapabilities = z.infer<typeof AgentCapabilitiesSchema>;
-
-export interface AgentConfig {
-  /** Display name for this coding agent (e.g. "OpenCode", "Cursor"). */
-  name: string;
-  /** CLI command that launches the agent (for display/detection). */
-  command?: string;
-  /** Path to the agent's config directory (for display/debugging). */
-  configPath?: string;
-  /** Path to the agent's session storage. */
-  sessionPath?: string;
-  /** Path to the agent's auth file (for credential reading). */
-  authPath?: string;
-}
-
-export interface AgentCredentials {
-  providers: Record<string, Credentials | undefined>;
-  oauth?: Record<string, OAuthCredentials>;
-}
-
-export interface AgentProviderConfig {
-  id: string;
-  name: string;
-  configured: boolean;
-  enabled?: boolean;
-}
-
-export interface SessionParseOptions {
-  sessionId?: string;
-  timePeriod?: "session" | "daily" | "weekly" | "monthly";
-  limit?: number;
-  /** Epoch ms — only return sessions updated after this timestamp. */
-  since?: number;
-}
-
-export interface SessionUsageData {
-  sessionId: string;
-  sessionName?: string;
-  providerId: string;
-  modelId: string;
-  tokens: {
-    input: number;
-    output: number;
-    cacheRead?: number;
-    cacheWrite?: number;
-  };
-  timestamp: number;
-  sessionUpdatedAt?: number;
-  projectPath?: string;
-  cost?: number;
-}
-
-export interface AgentFetchContext {
-  readonly http: PluginHttpClient;
-  readonly logger: PluginLogger;
-  readonly config: Record<string, unknown>;
-  readonly signal: AbortSignal;
-}
-
-export interface ActivityUpdate {
-  sessionId: string;
-  messageId: string;
-  tokens: {
-    input: number;
-    output: number;
-    reasoning?: number;
-    cacheRead?: number;
-    cacheWrite?: number;
-  };
-  timestamp: number;
-}
-
-export type ActivityCallback = (update: ActivityUpdate) => void;
-
-export interface AgentPlugin extends BasePlugin {
-  readonly type: "agent";
-  readonly agent: AgentConfig;
-  readonly capabilities: AgentCapabilities;
-
-  /** Check if this coding agent is installed on the user's machine. */
-  isInstalled(ctx: PluginContext): Promise<boolean>;
-
-  /** Read credentials that the coding agent has stored. */
-  readCredentials?(ctx: AgentFetchContext): Promise<AgentCredentials>;
-
-  /** Parse session usage data from the agent's local storage. */
-  parseSessions(options: SessionParseOptions, ctx: AgentFetchContext): Promise<SessionUsageData[]>;
-
-  /** List which model providers this agent is configured to use. */
-  getProviders?(ctx: AgentFetchContext): Promise<AgentProviderConfig[]>;
-
-  /** Start watching for real-time activity updates. */
-  startActivityWatch?(ctx: PluginContext, callback: ActivityCallback): void;
-
-  /** Stop watching for real-time activity updates. */
-  stopActivityWatch?(ctx: PluginContext): void;
-}