@tokentop/plugin-sdk 1.0.0

package/dist/types/agent.d.ts

@@ -0,0 +1,89 @@
+import type { BasePlugin, PluginLogger } from './plugin.ts';
+import type { PluginHttpClient, PluginContext } from './context.ts';
+import type { Credentials, CredentialResult } from './provider.ts';
+export interface AgentConfig {
+    /** Display name for this coding agent (e.g. "Claude Code", "Cursor"). */
+    name: string;
+    /** Path to the agent's config directory (for display/debugging). */
+    configPath?: string;
+    /** Path to the agent's session storage. */
+    sessionPath?: string;
+}
+export interface AgentCapabilities {
+    sessionParsing: boolean;
+    authReading: boolean;
+    realTimeTracking: boolean;
+    multiProvider: boolean;
+}
+export interface AgentCredentials {
+    providers: Record<string, Credentials | undefined>;
+}
+export interface AgentProviderConfig {
+    id: string;
+    name: string;
+    configured: boolean;
+    enabled?: boolean;
+}
+export interface SessionParseOptions {
+    sessionId?: string;
+    timePeriod?: 'session' | 'daily' | 'weekly' | 'monthly';
+    limit?: 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 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 AgentFetchContext {
+    readonly http: PluginHttpClient;
+    readonly logger: PluginLogger;
+    readonly config: Record<string, unknown>;
+    readonly signal: AbortSignal;
+}
+export interface AgentPlugin extends BasePlugin {
+    readonly type: 'agent';
+    readonly agent: AgentConfig;
+    readonly capabilities: AgentCapabilities;
+    /** Optional plugin-owned credential discovery for the agent's auth files. */
+    readonly auth?: {
+        discover(ctx: PluginContext): Promise<CredentialResult>;
+        isConfigured(credentials: Credentials): boolean;
+    };
+    /** 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;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"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"}

package/dist/types/context.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Context interfaces injected into plugins at runtime by core.
+ *
+ * Plugins never construct these — core creates and injects them.
+ * The SDK defines the shapes so plugins can type their method signatures.
+ */
+import type { PluginLogger } from './plugin.ts';
+/**
+ * Sandboxed HTTP client.
+ * Enforces the plugin's declared `permissions.network.allowedDomains`.
+ */
+export interface PluginHttpClient {
+    fetch(url: string, init?: RequestInit): Promise<Response>;
+}
+/**
+ * Helpers for credential discovery, injected by core.
+ *
+ * All methods respect the plugin's declared permissions.
+ * Plugins use these to implement their own `auth.discover()` method
+ * instead of relying on centralized core logic.
+ */
+export interface AuthSources {
+    /** Read an environment variable (sandboxed to `permissions.env.vars`). */
+    env: {
+        get(name: string): string | undefined;
+    };
+    /** Read files from the filesystem (sandboxed to `permissions.filesystem.paths`). */
+    files: {
+        readText(path: string): Promise<string | null>;
+        readJson<T = unknown>(path: string): Promise<T | null>;
+        exists(path: string): Promise<boolean>;
+    };
+    /**
+     * Read from OpenCode's auth storage.
+     * Core handles locating the auth file; plugin provides the provider key.
+     */
+    opencode: {
+        getProviderEntry(key: string): Promise<OpenCodeAuthEntry | null>;
+    };
+    /** Platform information for cross-platform credential path resolution. */
+    platform: {
+        os: 'darwin' | 'linux' | 'win32';
+        homedir: string;
+        arch: string;
+    };
+}
+/** Shape of an entry in OpenCode's auth.json file. */
+export interface OpenCodeAuthEntry {
+    type: 'api' | 'oauth' | 'codex' | 'github' | 'wellknown';
+    key?: string;
+    access?: string;
+    refresh?: string;
+    expires?: number;
+    token?: string;
+    accessToken?: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    accountId?: string;
+    groupId?: string;
+}
+/**
+ * Per-plugin key-value storage.
+ *
+ * Namespaced by plugin ID — plugins can only access their own data.
+ * Backed by core's storage engine (SQLite or filesystem).
+ */
+export interface PluginStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+/**
+ * Full runtime context provided to plugin methods like
+ * `auth.discover()`, `fetchUsage()`, `parseSessions()`, etc.
+ *
+ * Extends lifecycle context with HTTP, auth, and storage capabilities.
+ */
+export interface PluginContext {
+    /** Plugin's validated configuration values. */
+    readonly config: Record<string, unknown>;
+    /** Scoped logger. */
+    readonly logger: PluginLogger;
+    /** Sandboxed HTTP client. */
+    readonly http: PluginHttpClient;
+    /** Credential discovery helpers. */
+    readonly authSources: AuthSources;
+    /** Per-plugin persistent key-value storage. */
+    readonly storage: PluginStorage;
+    /** Abort signal — fired when the plugin is being stopped or the app is shutting down. */
+    readonly signal: AbortSignal;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC3D;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,GAAG,EAAE;QACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC;IAEF,oFAAoF;IACpF,KAAK,EAAE;QACL,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC/C,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACxC,CAAC;IAEF;;;OAGG;IACH,QAAQ,EAAE;QACR,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;KAClE,CAAC;IAEF,0EAA0E;IAC1E,QAAQ,EAAE;QACR,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B"}

package/dist/types/index.d.ts

@@ -0,0 +1,21 @@
+export type { PluginId, PluginType, PluginPermissions, PluginMeta, ConfigField, BasePlugin, PluginLifecycleContext, PluginLogger, } from './plugin.ts';
+export { CURRENT_API_VERSION, PluginPermissionError } from './plugin.ts';
+export type { PluginHttpClient, AuthSources, OpenCodeAuthEntry, PluginStorage, PluginContext, } from './context.ts';
+export type { CredentialSource, Credentials, OAuthCredentials, RefreshedCredentials, CredentialResult, ProviderAuth, ProviderCapabilities, ModelPricing, ProviderPricing, UsageLimit, CostBreakdown, ProviderUsageData, ProviderFetchContext, ProviderPlugin, } from './provider.ts';
+export type { AgentConfig, AgentCapabilities, AgentCredentials, AgentProviderConfig, SessionParseOptions, SessionUsageData, ActivityUpdate, ActivityCallback, AgentFetchContext, AgentPlugin, } from './agent.ts';
+export type { ThemeColors, GaugeColors, ThemeComponents, ThemePlugin, } from './theme.ts';
+export type { NotificationSeverity, NotificationEventType, NotificationEvent, NotificationContext, NotificationPlugin, } from './notification.ts';
+export type AnyPlugin = ProviderPlugin | AgentPlugin | ThemePlugin | NotificationPlugin;
+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 { PluginType } from './plugin.ts';
+export type PluginByType = {
+    provider: ProviderPlugin;
+    agent: AgentPlugin;
+    theme: ThemePlugin;
+    notification: NotificationPlugin;
+};
+export type PluginOfType<T extends PluginType> = PluginByType[T];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,WAAW,EACX,WAAW,EACX,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAExF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+import {
+  CURRENT_API_VERSION,
+  PluginPermissionError
+} from "../index-y0tp0jk5.js";
+export {
+  PluginPermissionError,
+  CURRENT_API_VERSION
+};

package/dist/types/notification.d.ts

@@ -0,0 +1,33 @@
+import type { BasePlugin, PluginLogger } from './plugin.ts';
+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';
+export interface NotificationEvent {
+    type: NotificationEventType;
+    severity: NotificationSeverity;
+    title: string;
+    message: string;
+    timestamp: number;
+    data?: Record<string, unknown>;
+}
+export interface NotificationContext {
+    readonly logger: PluginLogger;
+    readonly config: Record<string, unknown>;
+    readonly signal: AbortSignal;
+}
+export interface NotificationPlugin extends BasePlugin {
+    readonly type: 'notification';
+    /** Set up the notification channel (e.g. verify webhook URL, open connection). */
+    initialize(ctx: NotificationContext): Promise<void>;
+    /** Deliver a notification event. */
+    notify(ctx: NotificationContext, event: NotificationEvent): Promise<void>;
+    /** Optional: test the notification channel (e.g. send a test message). */
+    test?(ctx: NotificationContext): Promise<boolean>;
+    /**
+     * Optional: filter which events this plugin handles.
+     * If not implemented, the plugin receives all events.
+     */
+    supports?(event: NotificationEvent): boolean;
+    /** Clean up resources (e.g. close connections). */
+    destroy?(): Promise<void>;
+}
+//# sourceMappingURL=notification.d.ts.map

package/dist/types/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/types/notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM5D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEnE,MAAM,MAAM,qBAAqB,GAC7B,yBAAyB,GACzB,qBAAqB,GACrB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAMD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAMD,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B,kFAAkF;IAClF,UAAU,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,oCAAoC;IACpC,MAAM,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E,0EAA0E;IAC1E,IAAI,CAAC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD;;;OAGG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAE7C,mDAAmD;IACnD,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/types/plugin.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Core plugin types and interfaces for the tokentop plugin system.
+ *
+ * All plugin types extend {@link BasePlugin} and must declare their
+ * permissions, metadata, and optional lifecycle hooks.
+ */
+/** Opaque plugin identifier — kebab-case string, globally unique. */
+export type PluginId = string;
+/** Discriminator for the four plugin categories. */
+export type PluginType = 'provider' | 'agent' | 'theme' | 'notification';
+/**
+ * Current API contract version.
+ * Core checks this at load time to ensure compatibility.
+ */
+export declare const CURRENT_API_VERSION = 2;
+/** Controls what a plugin is allowed to access at runtime. */
+export interface PluginPermissions {
+    /** Network access — domain allowlisting for outbound HTTP. */
+    network?: {
+        enabled: boolean;
+        allowedDomains?: string[];
+    };
+    /** Filesystem access — path allowlisting for read/write. */
+    filesystem?: {
+        read?: boolean;
+        write?: boolean;
+        paths?: string[];
+    };
+    /** Environment variable access — var name allowlisting. */
+    env?: {
+        read?: boolean;
+        vars?: string[];
+    };
+    /** System integration access. */
+    system?: {
+        notifications?: boolean;
+        clipboard?: boolean;
+    };
+}
+/** Public-facing metadata about a plugin. */
+export interface PluginMeta {
+    /** Plugin author name or handle. */
+    author?: string;
+    /** Brief description of what the plugin does. */
+    description?: string;
+    /** Plugin homepage or documentation URL. */
+    homepage?: string;
+    /** Source repository URL. */
+    repository?: string;
+    /** SPDX license identifier. */
+    license?: string;
+    /**
+     * Brand color as a hex string (e.g. `"#d97757"`).
+     * Used by the TUI for provider cards, charts, and status indicators.
+     */
+    brandColor?: string;
+    /**
+     * Single-character icon or short glyph for compact displays.
+     * Example: `"◆"`, `"▲"`, `"⚡"`
+     */
+    icon?: string;
+}
+/** Describes a user-configurable setting that the plugin exposes. */
+export interface ConfigField {
+    /** Data type of the setting value. */
+    type: 'string' | 'number' | 'boolean' | 'select';
+    /** Label shown in the settings UI. */
+    label?: string;
+    /** Help text shown below the field. */
+    description?: string;
+    /** Whether the field must have a value. */
+    required?: boolean;
+    /** Default value when no user config exists. */
+    default?: unknown;
+    /** Available options (for `select` type only). */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** Minimum value (for `number` type only). */
+    min?: number;
+    /** Maximum value (for `number` type only). */
+    max?: number;
+}
+/**
+ * Base interface that all plugins must implement.
+ *
+ * Provides identity, metadata, permissions, optional configuration schema,
+ * and lifecycle hooks.
+ */
+export interface BasePlugin {
+    /** API version this plugin targets. Must equal {@link CURRENT_API_VERSION}. */
+    readonly apiVersion: 2;
+    /** Unique plugin identifier (kebab-case). */
+    readonly id: PluginId;
+    /** Plugin type discriminator. */
+    readonly type: PluginType;
+    /** Human-readable display name. */
+    readonly name: string;
+    /** Semantic version string of this plugin (e.g. `"1.0.0"`). */
+    readonly version: string;
+    /** Public-facing metadata. */
+    readonly meta?: PluginMeta;
+    /** Required permissions. */
+    readonly permissions: PluginPermissions;
+    /**
+     * Optional configuration schema.
+     * Core renders these fields in the settings UI and persists user values.
+     * Keys are the config field identifiers.
+     */
+    readonly configSchema?: Record<string, ConfigField>;
+    /**
+     * Default config values. Used when no user configuration exists.
+     * Keys must match those in {@link configSchema}.
+     */
+    readonly defaultConfig?: Record<string, unknown>;
+    /**
+     * Called once after the plugin is loaded and validated.
+     * Use for one-time setup (open connections, allocate resources).
+     */
+    initialize?(ctx: PluginLifecycleContext): Promise<void>;
+    /**
+     * Called when the plugin should begin active work (e.g. polling).
+     * Called after `initialize()` during app startup, and after re-enable.
+     */
+    start?(ctx: PluginLifecycleContext): Promise<void>;
+    /**
+     * Called when the plugin should pause active work.
+     * Called before `destroy()` during app shutdown, and on disable.
+     */
+    stop?(ctx: PluginLifecycleContext): Promise<void>;
+    /**
+     * Called once before the plugin is unloaded.
+     * Use for cleanup (close connections, flush buffers).
+     */
+    destroy?(ctx: PluginLifecycleContext): Promise<void>;
+    /**
+     * 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;
+}
+/**
+ * Minimal context provided to lifecycle hooks.
+ * More specific contexts (e.g. {@link ProviderFetchContext}) extend this
+ * for domain-specific methods.
+ */
+export interface PluginLifecycleContext {
+    /** Plugin's validated configuration values. */
+    readonly config: Record<string, unknown>;
+    /** Scoped logger that prefixes all output with the plugin ID. */
+    readonly logger: PluginLogger;
+}
+/** Scoped logging interface provided to plugins. */
+export interface PluginLogger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/** Thrown when a plugin attempts an action not allowed by its permissions. */
+export declare class PluginPermissionError extends Error {
+    readonly pluginId: PluginId;
+    readonly permission: keyof PluginPermissions;
+    constructor(pluginId: PluginId, permission: keyof PluginPermissions, message: string);
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"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"}

package/dist/types/provider.d.ts

@@ -0,0 +1,138 @@
+import type { BasePlugin, PluginLogger } from './plugin.ts';
+import type { PluginHttpClient, PluginContext } from './context.ts';
+export type CredentialSource = 'env' | 'opencode' | 'external' | 'config';
+export interface Credentials {
+    apiKey?: string;
+    oauth?: OAuthCredentials;
+    groupId?: string;
+    source: CredentialSource;
+}
+export interface OAuthCredentials {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    accountId?: string;
+    managedProjectId?: string;
+}
+export interface RefreshedCredentials {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+}
+export interface CredentialResult {
+    ok: boolean;
+    credentials?: Credentials;
+    reason?: 'missing' | 'expired' | 'invalid' | 'error';
+    message?: string;
+}
+/**
+ * Plugin-owned credential discovery and validation.
+ *
+ * Replaces the old declarative `auth: { envVars, externalPaths }` pattern.
+ * The plugin decides *how* to find credentials; core provides sandboxed helpers.
+ */
+export interface ProviderAuth {
+    /** Discover credentials using the provided context helpers. */
+    discover(ctx: PluginContext): Promise<CredentialResult>;
+    /** Check whether discovered credentials are sufficient to operate. */
+    isConfigured(credentials: Credentials): boolean;
+}
+export interface ProviderCapabilities {
+    usageLimits: boolean;
+    apiRateLimits: boolean;
+    tokenUsage: boolean;
+    actualCosts: boolean;
+}
+export interface ModelPricing {
+    input: number;
+    output: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    source?: string;
+}
+export interface ProviderPricing {
+    /**
+     * Map a model ID to the identifier used by the pricing service.
+     * Return `undefined` to use the model ID as-is.
+     */
+    mapModelId?(modelId: string): string | undefined;
+    /**
+     * The provider ID to use when querying models.dev.
+     * Defaults to `plugin.id` if not specified.
+     */
+    modelsDevProviderId?: string;
+    /** Static fallback prices keyed by model ID. */
+    staticPrices?: Record<string, ModelPricing>;
+}
+export interface UsageLimit {
+    usedPercent: number | null;
+    resetsAt?: number;
+    label?: string;
+    windowMinutes?: number;
+}
+export interface CostBreakdown {
+    total: number;
+    input?: number;
+    output?: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+    currency: string;
+}
+export interface ProviderUsageData {
+    planType?: string;
+    allowed?: boolean;
+    limitReached?: boolean;
+    limits?: {
+        primary?: UsageLimit;
+        secondary?: UsageLimit;
+        items?: UsageLimit[];
+    };
+    tokens?: {
+        input: number;
+        output: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+    credits?: {
+        hasCredits: boolean;
+        unlimited: boolean;
+        balance?: string;
+    };
+    cost?: {
+        actual?: CostBreakdown;
+        estimated?: CostBreakdown;
+        source: 'api' | 'estimated';
+    };
+    fetchedAt: number;
+    error?: string;
+}
+/** Context injected into `fetchUsage()`. Includes resolved credentials. */
+export interface ProviderFetchContext {
+    readonly credentials: Credentials;
+    readonly http: PluginHttpClient;
+    readonly logger: PluginLogger;
+    readonly config: Record<string, unknown>;
+    readonly signal: AbortSignal;
+    readonly options?: {
+        timePeriod?: 'session' | 'daily' | 'weekly' | 'monthly';
+        sessionId?: string;
+    };
+}
+export interface ProviderPlugin extends BasePlugin {
+    readonly type: 'provider';
+    readonly capabilities: ProviderCapabilities;
+    /** Plugin-owned credential discovery. */
+    readonly auth: ProviderAuth;
+    /** Optional pricing configuration for the models this provider serves. */
+    readonly pricing?: ProviderPricing;
+    /** Fetch current usage data from the provider's API. */
+    fetchUsage(ctx: ProviderFetchContext): Promise<ProviderUsageData>;
+    /** Optional OAuth token refresh. */
+    refreshToken?(oauth: OAuthCredentials): Promise<RefreshedCredentials>;
+    /** Optional health check (e.g. verify API key validity without fetching usage). */
+    healthCheck?(ctx: PluginContext): Promise<{
+        ok: boolean;
+        message?: string;
+    }>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/types/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/types/provider.ts"],"names":[],"mappings":"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"}

package/dist/types/theme.d.ts

@@ -0,0 +1,53 @@
+import type { BasePlugin } from './plugin.ts';
+export interface ThemeColors {
+    bg: string;
+    fg: string;
+    border: string;
+    borderFocused: string;
+    primary: string;
+    secondary: string;
+    accent: string;
+    muted: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    headerBg: string;
+    headerFg: string;
+    statusBarBg: string;
+    statusBarFg: string;
+    tableBg: string;
+    tableHeaderBg: string;
+    tableHeaderFg: string;
+    tableRowBg: string;
+    tableRowAltBg: string;
+    tableRowFg: string;
+    tableSelectedBg: string;
+    tableSelectedFg: string;
+}
+export interface GaugeColors {
+    low: string;
+    medium: string;
+    high: string;
+    critical: string;
+    bg: string;
+}
+export interface ThemeComponents {
+    gauge?: GaugeColors;
+}
+export interface ThemePlugin extends BasePlugin {
+    readonly type: 'theme';
+    readonly theme: {
+        colorScheme: 'light' | 'dark';
+        colors: ThemeColors;
+        components?: ThemeComponents;
+        /**
+         * If `true`, core uses this theme when no user preference is set.
+         * If multiple themes set this, `priority` breaks the tie (higher wins).
+         */
+        isDefault?: boolean;
+        /** Tie-breaker for default theme selection. Higher wins. Default: `0`. */
+        priority?: number;
+    };
+}
+//# sourceMappingURL=theme.d.ts.map

package/dist/types/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IAEtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IAEd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAMD,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,QAAQ,CAAC,KAAK,EAAE;QACd,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC;QAC9B,MAAM,EAAE,WAAW,CAAC;QACpB,UAAU,CAAC,EAAE,eAAe,CAAC;QAC7B;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,0EAA0E;QAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH"}