@toninho09/opencode-usage 1.0.0

package/lib/shared/formatting.ts

@@ -0,0 +1,71 @@
+import { formatFriendlyDate } from "./utils";
+
+/**
+ * Formats a countdown line for quota reset
+ * Accepts both ISO string and timestamp in milliseconds
+ */
+export function formatResetCountdown(resetDate: string | number | undefined): string {
+  if (!resetDate) {
+    return "N/A";
+  }
+
+  const reset = new Date(resetDate);
+  const now = new Date();
+  const diffMs = reset.getTime() - now.getTime();
+
+  if (diffMs <= 0) {
+    return "Resets soon";
+  }
+
+  const days = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+  const hours = Math.floor((diffMs % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+
+  if (days > 0) {
+    return `${days}d ${hours}h`;
+  }
+  return `${hours}h`;
+}
+
+/**
+ * Formats a complete reset line with friendly date
+ */
+export function formatResetLine(
+  label: string,
+  resetDate: string | number | undefined,
+  labelWidth: number = 15,
+): string {
+  if (!resetDate) {
+    return `${label.padEnd(labelWidth)} N/A`;
+  }
+
+  const countdown = formatResetCountdown(resetDate);
+  const friendlyDate = formatFriendlyDate(resetDate);
+
+  return `${label.padEnd(labelWidth)} ${countdown} (${friendlyDate})`;
+}
+
+/**
+ * Formats large numbers as tokens (1000 -> 1K, 1000000 -> 1M)
+ */
+export function formatTokens(value: number): string {
+  if (value >= 1000000000) {
+    return `${(value / 1000000000).toFixed(1)}B`;
+  }
+  if (value >= 1000000) {
+    return `${(value / 1000000).toFixed(1)}M`;
+  }
+  if (value >= 1000) {
+    return `${(value / 1000).toFixed(0)}K`;
+  }
+  return value.toString();
+}
+
+/**
+ * Masks an API key showing only the first 8 characters
+ */
+export function maskApiKey(apiKey: string): string {
+  if (apiKey.length <= 8) {
+    return apiKey;
+  }
+  return apiKey.substring(0, 8) + "............";
+}

package/lib/shared/notification.ts

@@ -0,0 +1,28 @@
+export async function sendIgnoredMessage(
+    client: any,
+    sessionID: string,
+    text: string,
+    params: any,
+): Promise<void> {
+    const agent = params.agent || undefined
+    const variant = params.variant || undefined
+    const model = params.providerId && params.modelId ? {
+        providerID: params.providerId,
+        modelID: params.modelId,
+    } : undefined
+
+    try {
+        await client.session.prompt({
+            path: { id: sessionID },
+            body: {
+                noReply: true,
+                agent,
+                model,
+                variant,
+                parts: [{ type: "text", text, ignored: true }],
+            },
+        })
+    } catch (error: any) {
+        console.error("Failed to send notification:", error.message)
+    }
+}

package/lib/shared/utils.ts

@@ -0,0 +1,43 @@
+export async function fetchWithTimeout(
+  url: string | URL | Request,
+  options: RequestInit & { timeout?: number } = {},
+): Promise<Response> {
+  const timeout = options.timeout ?? 10000;
+
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeout);
+
+  try {
+    const response = await fetch(url, {
+      ...options,
+      signal: controller.signal,
+    });
+    return response;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+export function createUsedProgressBar(percentUsed: number, width: number = 20): string {
+  const filled = Math.round((percentUsed / 100) * width);
+  const empty = width - filled;
+  return "[" + "#".repeat(filled) + " ".repeat(empty) + "]";
+}
+
+export function formatFriendlyDate(dateInput: string | number | Date): string {
+  const date = new Date(dateInput);
+  
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  
+  const offsetMinutes = -date.getTimezoneOffset();
+  const offsetHours = Math.floor(Math.abs(offsetMinutes) / 60);
+  const offsetMins = Math.abs(offsetMinutes) % 60;
+  const offsetSign = offsetMinutes >= 0 ? "+" : "-";
+  const timezone = `UTC${offsetSign}${String(offsetHours).padStart(2, "0")}:${String(offsetMins).padStart(2, "0")}`;
+  
+  return `${year}-${month}-${day} ${hours}:${minutes} ${timezone}`;
+}

package/lib/usage-handler.ts

@@ -0,0 +1,55 @@
+import { sendIgnoredMessage } from "./shared/notification";
+import { registry } from "./providers/registry";
+
+interface UsageContext {
+  client: any;
+  sessionID: string;
+  params: any;
+}
+
+/**
+ * Main handler for the /usage command
+ * Fetches data from all registered providers and displays to user
+ */
+export async function handleUsageCommand(ctx: UsageContext): Promise<void> {
+  const { client, sessionID, params } = ctx;
+
+  // Gets all registered providers
+  const providers = registry.getAll();
+
+  // Fetches data from all providers in parallel
+  const results = await Promise.all(
+    providers.map(async (provider) => {
+      try {
+        const result = await provider.getUsageData();
+        if (result && result.content) {
+          return {
+            provider: provider.name,
+            content: result.content,
+          };
+        }
+        return null;
+      } catch (error) {
+        console.error(`[${provider.name} Error]`, error);
+        return null;
+      }
+    }),
+  );
+
+  // Filters only providers with valid data
+  const validResults = results.filter((r): r is { provider: string; content: string } => r !== null);
+
+  // If no provider returned data, shows error message
+  if (validResults.length === 0) {
+    const message =
+      "No usage service configured.\nConfigure GitHub Copilot, Claude Code or Z.ai in your auth file.";
+    await sendIgnoredMessage(client, sessionID, message, params);
+    return;
+  }
+
+  // Joins all provider messages
+  const message = validResults.map((r) => r.content).join("\n\n");
+
+  // Sends final message to user
+  await sendIgnoredMessage(client, sessionID, message, params);
+}

package/opencode.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["./"]
+}

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@toninho09/opencode-usage",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.ts",
+  "dependencies": {
+    "@opencode-ai/plugin": "latest",
+    "@types/node": "^25.2.2",
+    "openai": "^6.19.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["*.ts", "lib/**/*.ts"]
+}