opencode-hud 0.1.0

package/README.md

@@ -0,0 +1,108 @@
+# OpenCode HUD Plugin
+
+A plugin for [OpenCode](https://opencode.ai) that displays token streaming metrics at the end of each conversation.
+
+## Metrics Displayed
+
+| Metric | Description |
+|--------|-------------|
+| ⚡ Avg TPS | Average tokens per second (includes reasoning tokens) |
+| TTFT | Time To First Token — latency from request to first response token |
+| Total tokens | Cumulative token count from API (output + reasoning) |
+| Elapsed time | Wall-clock time since the first token |
+
+**Example toast:**
+```
+⚡ 42.5 t/s  TTFT 312ms  [639 tok / 15.0s]
+```
+
+## Installation
+
+### From npm
+
+Add the plugin to your `.opencode/opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-hud@latest"]
+}
+```
+
+### Local Development
+
+This plugin auto-loads when you run `opencode` from this directory, because it lives in `.opencode/plugins/`.
+
+## Configuration
+
+Create a config file at `~/.config/opencode/opencode-hud.json`:
+
+```json
+{
+  "enableLogging": true,
+  "logFilePath": ".opencode/hud-debug.log"
+}
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enableLogging` | boolean | `false` | Enable debug logging |
+| `logFilePath` | string | `.opencode/hud-debug.log` | Path to log file |
+
+## Development
+
+```bash
+# Install dependencies (Bun required)
+bun install
+
+# Run tests
+bun test
+
+# Type-check
+bun run typecheck
+
+# Build
+bun run build
+```
+
+## Project Structure
+
+```
+opencode-hud/
+├── .opencode/
+│   ├── opencode.json          # OpenCode project config
+│   └── plugins/
+│       └── hud.ts             # Plugin entry (auto-loaded by OpenCode)
+├── src/
+│   ├── index.ts               # Plugin main entry — event handlers
+│   ├── config.ts              # Configuration management
+│   ├── logger.ts              # Configurable logging
+│   ├── types.ts               # TypeScript interfaces
+│   ├── metrics.ts             # Token estimation, duration formatting
+│   └── display.ts             # Toast formatting and emission
+├── tests/
+│   ├── metrics.test.ts        # Unit tests
+│   └── integration.test.ts    # Event flow tests
+├── dist/                      # Build output
+├── package.json
+└── tsconfig.json
+```
+
+## Architecture
+
+The plugin listens to OpenCode events and displays metrics when a conversation ends (`session.idle`).
+
+**Event Flow:**
+1. `message.updated` (user) → Record request start time
+2. `message.updated` (assistant) → Store message with tokens info
+3. `message.part.updated` → Track first token time, count tokens
+4. `session.idle` → Calculate metrics and show toast
+
+**Token Counting:**
+- Primary: Uses API-provided `tokens.output + tokens.reasoning`
+- Fallback: Estimates from text length (`length / 3`)
+
+**Key Design Decisions:**
+- `requestStartTime` set on user message to capture full TTFT
+- `streamingStartTime` set on first assistant token (lazy init)
+- Token count includes reasoning tokens for accurate TPS
+- Uses `performance.now()` for high-precision timing

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface HudConfig {
+    enableLogging: boolean;
+    logFilePath?: string;
+}
+export declare function loadConfigFromFile(): void;
+export declare function getConfig(): HudConfig;
+export declare function setConfig(config: Partial<HudConfig>): void;
+export declare function resetConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAkBD,wBAAgB,kBAAkB,IAAI,IAAI,CAWzC;AAED,wBAAgB,SAAS,IAAI,SAAS,CAErC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAE1D;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config.js

@@ -0,0 +1,38 @@
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const CONFIG_FILE_NAME = "opencode-hud.json";
+const DEFAULT_CONFIG = {
+    enableLogging: false,
+    logFilePath: ".opencode/hud-debug.log",
+};
+let currentConfig = { ...DEFAULT_CONFIG };
+function getConfigPaths() {
+    return [
+        join(homedir(), ".config", "opencode", CONFIG_FILE_NAME),
+        join(process.cwd(), ".opencode", CONFIG_FILE_NAME),
+    ];
+}
+export function loadConfigFromFile() {
+    for (const configPath of getConfigPaths()) {
+        if (existsSync(configPath)) {
+            try {
+                const content = readFileSync(configPath, "utf-8");
+                const parsed = JSON.parse(content);
+                currentConfig = { ...DEFAULT_CONFIG, ...parsed };
+                return;
+            }
+            catch { }
+        }
+    }
+}
+export function getConfig() {
+    return currentConfig;
+}
+export function setConfig(config) {
+    currentConfig = { ...currentConfig, ...config };
+}
+export function resetConfig() {
+    currentConfig = { ...DEFAULT_CONFIG };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAO3B,MAAM,gBAAgB,GAAG,mBAAmB,CAAA;AAE5C,MAAM,cAAc,GAAc;IAChC,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,yBAAyB;CACvC,CAAA;AAED,IAAI,aAAa,GAAc,EAAE,GAAG,cAAc,EAAE,CAAA;AAEpD,SAAS,cAAc;IACrB,OAAO;QACL,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC;KACnD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;gBACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAA;gBACxD,aAAa,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAA;gBAChD,OAAM;YACR,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAA0B;IAClD,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,EAAE,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,aAAa,GAAG,EAAE,GAAG,cAAc,EAAE,CAAA;AACvC,CAAC"}

package/dist/display.d.ts

@@ -0,0 +1,5 @@
+import type { OpencodeClient } from "@opencode-ai/sdk";
+export declare function showHud(client: OpencodeClient, options: {
+    message: string;
+}): Promise<void>;
+//# sourceMappingURL=display.d.ts.map

package/dist/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAItD,wBAAsB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjG"}

package/dist/display.js

@@ -0,0 +1,11 @@
+const TOAST_DURATION_MS = 5000;
+export async function showHud(client, options) {
+    await client.tui.showToast({
+        body: {
+            message: options.message,
+            variant: "info",
+            duration: TOAST_DURATION_MS,
+        },
+    });
+}
+//# sourceMappingURL=display.js.map

package/dist/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../src/display.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAE9B,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAsB,EAAE,OAA4B;IAChF,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;QACzB,IAAI,EAAE;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,iBAAiB;SAC5B;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export { setConfig, getConfig, resetConfig } from "./config.js";
+export type { HudConfig } from "./config.js";
+export declare const HudPlugin: Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAQjD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC/D,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,eAAO,MAAM,SAAS,EAAE,MAiJvB,CAAA"}

package/dist/index.js

@@ -0,0 +1,131 @@
+import { showHud } from "./display.js";
+import { createFreshMetrics, formatDuration, now, estimateTokens } from "./metrics.js";
+import { log } from "./logger.js";
+import { loadConfigFromFile } from "./config.js";
+export { setConfig, getConfig, resetConfig } from "./config.js";
+export const HudPlugin = async ({ client }) => {
+    loadConfigFromFile();
+    const sessions = new Map();
+    const messageRoles = new Map();
+    const assistantMessages = new Map();
+    function isTextPart(part) {
+        return part.type === "text" && "text" in part;
+    }
+    function getOrCreate(sessionId) {
+        let m = sessions.get(sessionId);
+        if (!m) {
+            m = createFreshMetrics();
+            sessions.set(sessionId, m);
+        }
+        return m;
+    }
+    return {
+        event: async ({ event }) => {
+            switch (event.type) {
+                case "session.created": {
+                    const session = event.properties.info;
+                    log(`session.created: id=${session.id}`);
+                    sessions.set(session.id, createFreshMetrics());
+                    break;
+                }
+                case "message.updated": {
+                    const msg = event.properties.info;
+                    log(`message.updated: id=${msg.id} role=${msg.role} sessionID=${msg.sessionID}`);
+                    messageRoles.set(msg.id, msg.role);
+                    if (msg.role === "user") {
+                        const metrics = getOrCreate(msg.sessionID);
+                        metrics.requestStartTime = now();
+                    }
+                    else if (msg.role === "assistant") {
+                        const assistantMsg = msg;
+                        assistantMessages.set(msg.id, assistantMsg);
+                        log(`  assistant tokens: output=${assistantMsg.tokens?.output} reasoning=${assistantMsg.tokens?.reasoning}`);
+                    }
+                    break;
+                }
+                case "message.part.updated": {
+                    const part = event.properties.part;
+                    if (!isTextPart(part))
+                        break;
+                    const sessionId = part.sessionID;
+                    const messageId = part.messageID;
+                    log(`message.part.updated: sessionId=${sessionId} messageId=${messageId} msgRole=${messageRoles.get(messageId)}`);
+                    if (messageRoles.get(messageId) !== "assistant") {
+                        log(`  SKIP: not assistant`);
+                        break;
+                    }
+                    const metrics = getOrCreate(sessionId);
+                    log(`  metrics: totalTokens=${metrics.totalTokens} streamingStartTime=${metrics.streamingStartTime}`);
+                    if (messageId !== metrics.currentMessageId) {
+                        metrics.streamingStartTime = null;
+                        metrics.totalTokens = 0;
+                        metrics.currentMessageId = messageId;
+                    }
+                    const assistantMsg = assistantMessages.get(messageId);
+                    if (assistantMsg?.tokens?.output !== undefined && assistantMsg.tokens.output > 0) {
+                        const output = assistantMsg.tokens.output;
+                        const reasoning = assistantMsg.tokens.reasoning ?? 0;
+                        metrics.totalTokens = output + reasoning;
+                        log(`  using API tokens: output=${output} reasoning=${reasoning} total=${metrics.totalTokens}`);
+                    }
+                    else {
+                        metrics.totalTokens = estimateTokens(part.text);
+                        log(`  using estimated tokens: ${metrics.totalTokens}`);
+                    }
+                    if (metrics.streamingStartTime === null) {
+                        metrics.streamingStartTime = now();
+                    }
+                    break;
+                }
+                case "session.idle": {
+                    const sessionId = event.properties.sessionID;
+                    log(`session.idle: sessionId=${sessionId}`);
+                    const metrics = sessions.get(sessionId);
+                    log(`  metrics: ${JSON.stringify(metrics)}`);
+                    if (!metrics) {
+                        log(`  SKIP: no metrics`);
+                        break;
+                    }
+                    if (metrics.streamingStartTime === null) {
+                        log(`  SKIP: streamingStartTime is null`);
+                        break;
+                    }
+                    const assistantMsg = metrics.currentMessageId
+                        ? assistantMessages.get(metrics.currentMessageId)
+                        : undefined;
+                    if (assistantMsg?.tokens?.output !== undefined) {
+                        const output = assistantMsg.tokens.output;
+                        const reasoning = assistantMsg.tokens.reasoning ?? 0;
+                        metrics.totalTokens = output + reasoning;
+                        log(`  final tokens from API: output=${output} reasoning=${reasoning} total=${metrics.totalTokens}`);
+                    }
+                    if (metrics.totalTokens === 0) {
+                        log(`  SKIP: totalTokens is 0`);
+                        break;
+                    }
+                    metrics.completionTime = now();
+                    const ttft = metrics.requestStartTime !== null && metrics.streamingStartTime !== null
+                        ? metrics.streamingStartTime - metrics.requestStartTime
+                        : null;
+                    const elapsedMs = metrics.completionTime - metrics.streamingStartTime;
+                    const elapsedSec = elapsedMs / 1000;
+                    const avgTps = elapsedSec > 0 ? (metrics.totalTokens / elapsedSec) : 0;
+                    const message = `⚡ ${avgTps.toFixed(1)} t/s  TTFT ${ttft !== null ? formatDuration(ttft) : "--"}  [${metrics.totalTokens} tok / ${elapsedSec.toFixed(1)}s]`;
+                    log(`  SHOWING: ${message}`);
+                    await showHud(client, { message });
+                    break;
+                }
+                case "message.removed": {
+                    messageRoles.delete(event.properties.messageID);
+                    assistantMessages.delete(event.properties.messageID);
+                    break;
+                }
+                case "session.deleted": {
+                    sessions.delete(event.properties.info.id);
+                    break;
+                }
+            }
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,2 @@
+export declare function log(msg: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAcrC"}

package/dist/logger.js

@@ -0,0 +1,20 @@
+import { appendFileSync, mkdirSync, existsSync } from "fs";
+import { dirname } from "path";
+import { getConfig } from "./config.js";
+export function log(msg) {
+    const config = getConfig();
+    if (!config.enableLogging)
+        return;
+    const logFile = config.logFilePath;
+    if (!logFile)
+        return;
+    const timestamp = new Date().toISOString().slice(11, 23);
+    try {
+        if (!existsSync(logFile)) {
+            mkdirSync(dirname(logFile), { recursive: true });
+        }
+        appendFileSync(logFile, `[${timestamp}] ${msg}\n`);
+    }
+    catch { }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,UAAU,GAAG,CAAC,GAAW;IAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAA;IAC1B,IAAI,CAAC,MAAM,CAAC,aAAa;QAAE,OAAM;IAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAA;IAClC,IAAI,CAAC,OAAO;QAAE,OAAM;IAEpB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IACxD,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAClD,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,IAAI,SAAS,KAAK,GAAG,IAAI,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,11 @@
+export declare function now(): number;
+export declare function formatDuration(ms: number): string;
+export declare function estimateTokens(text: string): number;
+export declare function createFreshMetrics(): {
+    requestStartTime: number | null;
+    streamingStartTime: number | null;
+    completionTime: number | null;
+    totalTokens: number;
+    currentMessageId: string | null;
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,kBAAkB;sBAEJ,MAAM,GAAG,IAAI;wBACX,MAAM,GAAG,IAAI;oBACjB,MAAM,GAAG,IAAI;;sBAEX,MAAM,GAAG,IAAI;EAE1C"}

package/dist/metrics.js

@@ -0,0 +1,23 @@
+export function now() {
+    return performance.now();
+}
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    return `${(ms / 1000).toFixed(2)}s`;
+}
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.round(text.length / 3);
+}
+export function createFreshMetrics() {
+    return {
+        requestStartTime: null,
+        streamingStartTime: null,
+        completionTime: null,
+        totalTokens: 0,
+        currentMessageId: null,
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG;IACjB,OAAO,WAAW,CAAC,GAAG,EAAE,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAA;IAC3C,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAA;IACnB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,gBAAgB,EAAE,IAAqB;QACvC,kBAAkB,EAAE,IAAqB;QACzC,cAAc,EAAE,IAAqB;QACrC,WAAW,EAAE,CAAC;QACd,gBAAgB,EAAE,IAAqB;KACxC,CAAA;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,8 @@
+export interface SessionMetrics {
+    requestStartTime: number | null;
+    streamingStartTime: number | null;
+    completionTime: number | null;
+    totalTokens: number;
+    currentMessageId: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "opencode-hud",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "OpenCode plugin that displays TPS, TTFT, and token metrics at conversation end.",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc",
+    "prepublishOnly": "bun run typecheck && bun test && bun run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "tps",
+    "ttft",
+    "metrics",
+    "ai",
+    "llm"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=0.1.0",
+    "@opencode-ai/sdk": ">=0.1.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "latest",
+    "@opencode-ai/sdk": "latest",
+    "typescript": "^5.0.0",
+    "bun-types": "latest",
+    "@types/bun": "latest"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alaye-Dong/opencode-hud.git"
+  }
+}