opencode-usage 0.4.8 → 0.5.1

package/README.md

@@ -11,6 +11,7 @@ CLI tool for tracking [OpenCode](https://github.com/sst/opencode) AI coding assi
 - JSON output for scripting and automation
 - Model pricing for accurate cost estimation
 - Terminal table output
+- **Commander web dashboard** with quota status, account management, and ping
 
 ## Installation
 
@@ -63,6 +64,25 @@ opencode-usage -w -d 1
 opencode-usage --provider anthropic --since 7d --json
 ```
 
+### Commander Web Dashboard
+
+```bash
+# Launch the web dashboard
+opencode-usage --commander
+
+# Custom port
+opencode-usage --commander --commander-port 5000
+```
+
+The Commander provides a single-page web UI with:
+
+- **Quota Status** - Per-provider account usage with progress bars, thresholds, and stale detection (Anthropic, Codex, Antigravity)
+- **Usage Breakdown** - Daily token usage table with cost estimates and provider drill-down
+- **Account Management** - Add, switch, remove, and re-authenticate accounts
+- **Ping** - Verify account connectivity with live PONG/FAIL indicators
+- **Dark mode** toggle
+- Auto-refresh every 5 minutes
+
 ## Output
 
 ```

package/dist/__tests__/commander-app-init.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/commander-command-runner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/commander-config-service.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.d.ts

@@ -11,5 +11,7 @@ export type CliArgs = {
     watch?: boolean;
     stats?: boolean;
     config?: "show";
+    commander?: boolean;
+    commanderPort?: number;
 };
 export declare function parseArgs(): CliArgs;

package/dist/commander/index.d.ts

@@ -0,0 +1 @@
+export { runCommanderServer } from "./server.js";

package/dist/commander/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Commander HTTP server — local-only web interface bootstrap
+ *
+ * Bun-only: uses Bun.serve() for the HTTP server.
+ */
+import type { CliArgs } from "../cli.js";
+export declare function runCommanderServer(args: CliArgs): Promise<void>;

package/dist/commander/services/action-service.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Action service — ensures all plugin adapter commands are registered.
+ *
+ * Call `ensureActionsRegistered()` once at server startup so that
+ * account and action commands are available in the command registry.
+ */
+/**
+ * Import plugin-adapters as a side-effect to register all commands.
+ * Safe to call multiple times — registration happens only once.
+ */
+export declare function ensureActionsRegistered(): void;

package/dist/commander/services/app-init-service.d.ts

@@ -0,0 +1,17 @@
+/**
+ * App initializer service — detection + init/repair workflows for gaboe-owned apps.
+ *
+ * Manages a catalog of 4 apps with detection logic, one-click init,
+ * and repair workflows exposed via registered commands.
+ */
+export type AppId = "oc-codex-multi-account" | "oc-anthropic-multi-account" | "opencode-gitbutler" | "opencode-usage";
+export type AppState = "ready" | "partial" | "missing-deps" | "not-installed";
+export type AppStatus = {
+    id: AppId;
+    name: string;
+    description: string;
+    state: AppState;
+    details: string[];
+};
+export declare function getAppCatalog(): Promise<AppStatus[]>;
+export declare function ensureAppCommandsRegistered(): void;

package/dist/commander/services/command-runner.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Command registry and background job runner.
+ *
+ * Commands are registered via `registerCommand`, then executed asynchronously
+ * via `runCommand`. Jobs are tracked in-memory with log streaming support.
+ */
+import type { CommandJob, CommandSpec } from "./types.js";
+export declare function registerCommand<I, O>(spec: CommandSpec<I, O>): void;
+export declare function getJob(jobId: string): CommandJob | undefined;
+export declare function listJobs(): CommandJob[];
+export declare function cancelJob(jobId: string): boolean;
+export declare function runCommand(commandId: string, payload: unknown): string;

package/dist/commander/services/config-service.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Config service — read, write, backup and rollback for Commander-managed config files.
+ *
+ * Supports atomic writes (tmp + rename) and auto-backup before every mutation.
+ */
+export type ConfigSource = "codex-multi-account-accounts" | "anthropic-multi-account-state" | "antigravity-accounts" | "opencode";
+export type ConfigFileMeta = {
+    source: ConfigSource;
+    path: string;
+    exists: boolean;
+    parseOk: boolean;
+    sizeBytes: number;
+};
+export declare function isValidSource(s: string): s is ConfigSource;
+/**
+ * List all known config files with metadata.
+ */
+export declare function listConfigFiles(): Promise<ConfigFileMeta[]>;
+/**
+ * Read and parse a config file. Throws if missing or unparseable.
+ */
+export declare function readConfig(source: ConfigSource): unknown;
+/**
+ * Write config with atomic tmp+rename and auto-backup.
+ */
+export declare function writeConfig(source: ConfigSource, data: unknown): Promise<{
+    backupPath: string;
+}>;
+/**
+ * Rollback config to the latest backup.
+ */
+export declare function rollbackConfig(source: ConfigSource): Promise<{
+    restoredFrom: string;
+}>;
+export declare class ConfigError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}

package/dist/commander/services/index.d.ts

@@ -0,0 +1,2 @@
+export { registerCommand, runCommand, getJob, listJobs, cancelJob, } from "./command-runner.js";
+export type { JobStatus, JobLogEntry, CommandJob, CommandContext, CommandSpec, } from "./types.js";

package/dist/commander/services/plugin-adapters.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Plugin adapters — register all account & action commands at import time.
+ *
+ * Each command is registered via `registerCommand` so the command-runner can
+ * execute them as background jobs.
+ */
+export {};

package/dist/commander/services/quota-service.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Quota data service — thin wrapper over quota loaders for the Commander API.
+ */
+import type { QuotaSnapshot } from "../../types.js";
+export type QuotaData = {
+    anthropic: QuotaSnapshot[];
+    antigravity: QuotaSnapshot[];
+    codex: QuotaSnapshot[];
+};
+export declare function getQuotaData(): Promise<QuotaData>;

package/dist/commander/services/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared types for the Commander command system.
+ */
+export type JobStatus = "queued" | "running" | "success" | "failed" | "cancelled";
+export type JobLogEntry = {
+    ts: string;
+    level: "info" | "warn" | "error";
+    message: string;
+};
+export type CommandJob = {
+    id: string;
+    commandId: string;
+    status: JobStatus;
+    startedAt?: string;
+    finishedAt?: string;
+    logs: JobLogEntry[];
+    result?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+export type CommandContext = {
+    log: (level: JobLogEntry["level"], message: string) => void;
+    jobId: string;
+};
+export type CommandSpec<Input, Output> = {
+    id: string;
+    validateInput: (payload: unknown) => Input;
+    run: (ctx: CommandContext, input: Input) => Promise<Output>;
+    timeoutMs: number;
+    allowInUi: boolean;
+};

package/dist/commander/services/usage-service.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Usage data service — thin wrapper over loader + aggregator for the Commander API.
+ */
+export type UsageQueryOpts = {
+    provider?: string;
+    days?: number;
+    since?: string;
+    until?: string;
+    monthly?: boolean;
+};
+export type SerializedProviderStats = {
+    input: number;
+    output: number;
+    cacheWrite: number;
+    cacheRead: number;
+    reasoning: number;
+    cost: number;
+    models: string[];
+};
+export type SerializedDailyStats = {
+    date: string;
+    input: number;
+    output: number;
+    cacheWrite: number;
+    cacheRead: number;
+    reasoning: number;
+    cost: number;
+    models: string[];
+    providers: string[];
+    providerStats: Record<string, SerializedProviderStats>;
+};
+export declare function getUsageData(opts?: UsageQueryOpts): Promise<SerializedDailyStats[]>;

package/dist/commander/services/usage-worker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Worker thread for usage data queries.
+ *
+ * bun:sqlite is fully synchronous and blocks the event loop.
+ * Running queries in a worker keeps the main server responsive.
+ */
+export {};