@inferhub/opencode-usage 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { type AccountUsage } from "@inferhub/usage-client";
+type Opts = {
+    apiKey?: string;
+    baseUrl?: string;
+    window?: "day" | "24h" | "7d" | "30d";
+    lowBalanceUsd?: number;
+};
+type PluginCtx = {
+    client?: {
+        app?: {
+            log?: (input: {
+                body: Record<string, unknown>;
+            }) => Promise<void> | void;
+        };
+    };
+};
+type PluginHooks = {
+    tool?: Record<string, {
+        description: string;
+        args?: Record<string, unknown>;
+        execute: (...args: unknown[]) => Promise<string> | string;
+    }>;
+    event?: (input: {
+        event: {
+            type: string;
+        };
+    }) => Promise<void> | void;
+};
+export declare function getLastUsage(): AccountUsage | null;
+export declare function InferHubUsagePlugin(ctx: PluginCtx, options?: Opts): Promise<PluginHooks>;
+export default InferHubUsagePlugin;

package/dist/index.js

@@ -0,0 +1,57 @@
+import { fetchAccountUsage, formatReport, money, normalizeBaseUrl, resolveAuth, } from "@inferhub/usage-client";
+let lastUsage = null;
+async function loadUsage(opts = {}) {
+    const auth = opts.apiKey
+        ? { apiKey: opts.apiKey, baseUrl: normalizeBaseUrl(opts.baseUrl), source: "options" }
+        : resolveAuth({ apiKey: opts.apiKey, baseUrl: opts.baseUrl });
+    if (!auth) {
+        throw new Error("No InferHub API key. Configure provider.inferhub in opencode.json or set INFERHUB_API_KEY.");
+    }
+    const usage = await fetchAccountUsage({
+        apiKey: auth.apiKey,
+        baseUrl: auth.baseUrl,
+        window: opts.window ?? "day",
+    });
+    lastUsage = usage;
+    return usage;
+}
+export function getLastUsage() {
+    return lastUsage;
+}
+export async function InferHubUsagePlugin(ctx, options) {
+    const opts = options ?? {};
+    const low = opts.lowBalanceUsd ?? 0.5;
+    void loadUsage(opts).catch(() => { });
+    return {
+        tool: {
+            inferhub_usage: {
+                description: "Fetch InferHub account balance, day/all-time spend, and top used model for the current user",
+                args: {},
+                async execute() {
+                    const usage = await loadUsage(opts);
+                    return formatReport(usage) + "\n\n" + JSON.stringify(usage, null, 2);
+                },
+            },
+        },
+        event: async ({ event }) => {
+            if (event.type === "session.idle" || event.type === "session.created") {
+                try {
+                    const usage = await loadUsage(opts);
+                    if (Number(usage.balance.amount_usdc) < low) {
+                        await ctx.client?.app?.log?.({
+                            body: {
+                                service: "inferhub-usage",
+                                level: "warn",
+                                message: `Low InferHub balance: ${money(usage.balance.amount_usdc)}`,
+                            },
+                        });
+                    }
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        },
+    };
+}
+export default InferHubUsagePlugin;

package/dist/tui.d.ts

@@ -0,0 +1,29 @@
+type TuiApi = {
+    ui: {
+        toast: (input: {
+            variant?: string;
+            title?: string;
+            message: string;
+            duration?: number;
+        }) => void;
+    };
+    slots: {
+        register: (plugin: {
+            name?: string;
+            slots?: Record<string, (props: any) => any>;
+        }) => string;
+    };
+    event: {
+        on: (type: string, handler: (event: any) => void) => () => void;
+    };
+    lifecycle: {
+        onDispose: (fn: () => void) => () => void;
+    };
+    state: {
+        session: {
+            get: (id: string) => any;
+        };
+    };
+};
+export declare function tui(api: TuiApi): Promise<void>;
+export default tui;

package/dist/tui.js

@@ -0,0 +1,96 @@
+/**
+ * OpenCode TUI plugin — registers sidebar/home footer slots with InferHub usage.
+ *
+ * Install:
+ *   opencode plugin opencode-inferhub-usage --global
+ *   # or in opencode.json:
+ *   { "plugin": ["opencode-inferhub-usage", "opencode-inferhub-usage/tui"] }
+ *
+ * Note: TUI plugins require OpenCode's TUI module export (`./tui`). If the
+ * runtime version only supports server plugins, the server tool still works.
+ */
+import { fetchAccountUsageAuto, formatStatusLine, money, shortModel, } from "@inferhub/usage-client";
+let cached = null;
+let sessionCost = null;
+let sessionModel = null;
+async function refresh() {
+    try {
+        const { usage } = await fetchAccountUsageAuto({ window: "day" });
+        cached = usage;
+        if (Number(usage.balance.amount_usdc) < 0.5) {
+            // toast if available
+        }
+        return usage;
+    }
+    catch {
+        return null;
+    }
+}
+function line() {
+    if (!cached)
+        return "IH · loading…";
+    return formatStatusLine(cached, {
+        sessionCostUsd: sessionCost,
+        model: sessionModel,
+    });
+}
+export async function tui(api) {
+    void refresh();
+    const timer = setInterval(() => void refresh(), 60_000);
+    const offIdle = api.event.on("session.idle", () => void refresh());
+    const offUpd = api.event.on("session.updated", (ev) => {
+        const info = ev?.properties?.info ?? ev?.info ?? {};
+        if (typeof info.cost === "number")
+            sessionCost = info.cost;
+        if (typeof info.model === "string")
+            sessionModel = info.model;
+        if (info.model?.id)
+            sessionModel = info.model.id;
+    });
+    api.lifecycle.onDispose(() => {
+        clearInterval(timer);
+        offIdle();
+        offUpd();
+    });
+    // Prefer slots when the host supports Solid slot plugins.
+    try {
+        api.slots.register({
+            name: "inferhub-usage",
+            // Hosts that accept render functions will display these; others ignore.
+            slots: {
+                home_footer: () => line(),
+                sidebar_footer: () => {
+                    if (!cached)
+                        return "IH …";
+                    return `bal ${money(cached.balance.amount_usdc)} · all ${money(cached.all_time.spend_usdc)} · top ${shortModel(cached.top_model?.model)}`;
+                },
+                sidebar_content: () => {
+                    if (!cached)
+                        return "InferHub usage loading…";
+                    const sess = sessionCost != null ? money(sessionCost) : "—";
+                    return `IH session ${sess} · day ${money(cached.window.spend_usdc)} · ${cached.window.requests} req`;
+                },
+            },
+        });
+    }
+    catch {
+        // Slot API unavailable — server tool still works.
+    }
+    // Toast on first successful load when balance is low.
+    void refresh().then((u) => {
+        if (u && Number(u.balance.amount_usdc) < 0.5) {
+            try {
+                api.ui.toast({
+                    variant: "warning",
+                    title: "InferHub",
+                    message: `Low balance: ${money(u.balance.amount_usdc)}`,
+                    duration: 5000,
+                });
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    });
+}
+export default tui;

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@inferhub/opencode-usage",
+  "version": "0.1.0",
+  "description": "OpenCode plugin: InferHub balance, session/day/all-time usage, top model",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tui": {
+      "types": "./dist/tui.d.ts",
+      "import": "./dist/tui.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@inferhub/usage-client": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "^5.8.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "inferhub",
+    "usage"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inferhub/plugins.git",
+    "directory": "packages/opencode"
+  },
+  "homepage": "https://inferhub.dev"
+}