opencode-usage-stats 0.1.0 → 0.2.0

package/README.md

@@ -17,13 +17,19 @@ OpenCode will install the npm package automatically on startup.
 
 ## Use
 
-In any OpenCode session, ask the agent to show your usage:
+In any OpenCode session, run the slash command:
+
+```
+/usage
+```
+
+Or ask the agent:
 
 ```
 Show my OpenCode usage
 ```
 
-The agent will call the custom `usage` tool and return a markdown summary.
+The plugin will return a markdown summary of sessions, messages, tokens, cost, model/tool breakdown.
 
 ## Configuration
 

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 import type { Plugin } from "@opencode-ai/plugin";
 declare const OpenCodeUsage: Plugin;
-export default OpenCodeUsage;
+declare const plugin: {
+    id: string;
+    server: Plugin;
+};
+export default plugin;
 export { OpenCodeUsage };
 export * from "./api.js";
 export * from "./config.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,qBAAqB,CAAA;AAM7E,QAAA,MAAM,aAAa,EAAE,MAuDpB,CAAA;eAEc,aAAa;AAC5B,OAAO,EAAE,aAAa,EAAE,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,qBAAqB,CAAA;AAmB7E,QAAA,MAAM,aAAa,EAAE,MA2EpB,CAAA;AAED,QAAA,MAAM,MAAM;IACV,EAAE;IACF,MAAM;CACP,CAAA;eAEc,MAAM;AACrB,OAAO,EAAE,aAAa,EAAE,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -1,63 +1,234 @@
+// src/index.ts
 import { tool } from "@opencode-ai/plugin";
-import { fetchCloudUsage } from "./api.js";
-import { resolveConfig } from "./config.js";
-import { aggregateUsage, formatUsage } from "./usage.js";
-const OpenCodeUsage = async (input, options) => {
-    const config = resolveConfig(options);
-    const { client } = input;
-    return {
-        tool: {
-            usage: tool({
-                description: "Show OpenCode usage statistics (sessions, messages, tokens, cost, model/tool breakdown). " +
-                    "When OpenCode exposes a cloud usage API, this can also show plan limits and remaining quota.",
-                args: {
-                    cloud: tool.schema
-                        .boolean()
-                        .optional()
-                        .describe("Force fetch cloud usage information if available."),
-                },
-                async execute(args) {
-                    const wantsCloud = args.cloud ?? config.enableCloudApi;
-                    if (wantsCloud) {
-                        const cloud = await fetchCloudUsage(config);
-                        if (cloud) {
-                            return {
-                                title: "OpenCode Cloud Usage",
-                                output: [
-                                    "## OpenCode Cloud Usage",
-                                    "",
-                                    `- Plan: ${cloud.plan ?? "unknown"}`,
-                                    `- Billing Period: ${cloud.billingPeriod ?? "unknown"}`,
-                                    `- Monthly Limit: ${cloud.monthlyLimit ?? "unknown"}`,
-                                    `- Monthly Used: ${cloud.monthlyUsed ?? "unknown"}`,
-                                    `- Remaining: ${cloud.remaining ?? "unknown"}`,
-                                    `- Estimated Cost: ${cloud.estimatedCost !== undefined ? `$${cloud.estimatedCost.toFixed(4)}` : "unknown"}`,
-                                ].join("\n"),
-                            };
-                        }
-                    }
-                    try {
-                        const stats = await aggregateUsage(client);
-                        return {
-                            title: "OpenCode Usage",
-                            output: formatUsage(stats),
-                        };
-                    }
-                    catch (error) {
-                        const message = error instanceof Error ? error.message : String(error);
-                        return {
-                            title: "OpenCode Usage Error",
-                            output: `Failed to gather OpenCode usage statistics.\n\n${message}\n\nMake sure OpenCode is running and the plugin has access to its local API.`,
-                        };
-                    }
-                },
-            }),
+
+// src/api.ts
+async function fetchCloudUsage(_config) {
+  return null;
+}
+
+// src/config.ts
+function resolveConfig(options) {
+  const cfg = options ?? {};
+  return {
+    enableCloudApi: cfg.enableCloudApi ?? false,
+    cloudApiUrl: cfg.cloudApiUrl ?? "https://console.opencode.ai/api/usage",
+    apiKey: cfg.apiKey ?? ""
+  };
+}
+
+// src/usage.ts
+function isAssistantMessage(message) {
+  return "role" in message && message.role === "assistant";
+}
+function isToolPart(part) {
+  return part.type === "tool";
+}
+function aggregateMessages(messages) {
+  const stats = {
+    totalSessions: 0,
+    totalMessages: messages.length,
+    totalCost: 0,
+    totalInputTokens: 0,
+    totalOutputTokens: 0,
+    totalReasoningTokens: 0,
+    totalCacheRead: 0,
+    totalCacheWrite: 0,
+    modelUsage: {},
+    toolUsage: {}
+  };
+  for (const { info, parts } of messages) {
+    if (!isAssistantMessage(info)) continue;
+    stats.totalCost += info.cost ?? 0;
+    const tokens = info.tokens;
+    if (tokens) {
+      stats.totalInputTokens += tokens.input ?? 0;
+      stats.totalOutputTokens += tokens.output ?? 0;
+      stats.totalReasoningTokens += tokens.reasoning ?? 0;
+      stats.totalCacheRead += tokens.cache?.read ?? 0;
+      stats.totalCacheWrite += tokens.cache?.write ?? 0;
+    }
+    const modelKey = `${info.providerID}/${info.modelID}`;
+    if (!stats.modelUsage[modelKey]) {
+      stats.modelUsage[modelKey] = {
+        messages: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheRead: 0,
+        cacheWrite: 0,
+        cost: 0
+      };
+    }
+    const model = stats.modelUsage[modelKey];
+    model.messages += 1;
+    if (tokens) {
+      model.inputTokens += tokens.input ?? 0;
+      model.outputTokens += tokens.output ?? 0;
+      model.cacheRead += tokens.cache?.read ?? 0;
+      model.cacheWrite += tokens.cache?.write ?? 0;
+    }
+    model.cost += info.cost ?? 0;
+    for (const part of parts) {
+      if (isToolPart(part)) {
+        stats.toolUsage[part.tool] = (stats.toolUsage[part.tool] ?? 0) + 1;
+      }
+    }
+  }
+  return stats;
+}
+async function aggregateUsage(client) {
+  const sessionsResponse = await client.session.list();
+  const sessions = Array.isArray(sessionsResponse.data) ? sessionsResponse.data : [];
+  const allMessages = [];
+  for (const session of sessions) {
+    try {
+      const response = await client.session.messages({ path: { id: session.id } });
+      const messages = Array.isArray(response.data) ? response.data : [];
+      allMessages.push(...messages);
+    } catch (error) {
+      continue;
+    }
+  }
+  const stats = aggregateMessages(allMessages);
+  stats.totalSessions = sessions.length;
+  return stats;
+}
+function formatUsage(stats) {
+  const totalTokens = stats.totalInputTokens + stats.totalOutputTokens + stats.totalReasoningTokens + stats.totalCacheRead + stats.totalCacheWrite;
+  const lines = [
+    "## OpenCode Usage",
+    "",
+    `- Sessions: ${stats.totalSessions.toLocaleString()}`,
+    `- Messages: ${stats.totalMessages.toLocaleString()}`,
+    `- Total Cost: $${stats.totalCost.toFixed(4)}`,
+    `- Total Tokens: ${totalTokens.toLocaleString()}`,
+    `  - Input: ${stats.totalInputTokens.toLocaleString()}`,
+    `  - Output: ${stats.totalOutputTokens.toLocaleString()}`,
+    `  - Reasoning: ${stats.totalReasoningTokens.toLocaleString()}`,
+    `  - Cache Read: ${stats.totalCacheRead.toLocaleString()}`,
+    `  - Cache Write: ${stats.totalCacheWrite.toLocaleString()}`,
+    ""
+  ];
+  const models = Object.entries(stats.modelUsage).sort(([, a], [, b]) => b.messages - a.messages);
+  if (models.length > 0) {
+    lines.push("### Model Usage");
+    lines.push("");
+    for (const [model, usage] of models) {
+      lines.push(`- ${model}`);
+      lines.push(`  - Messages: ${usage.messages.toLocaleString()}`);
+      lines.push(
+        `  - Tokens: ${(usage.inputTokens + usage.outputTokens).toLocaleString()} (in ${usage.inputTokens.toLocaleString()} / out ${usage.outputTokens.toLocaleString()})`
+      );
+      lines.push(`  - Cost: $${usage.cost.toFixed(4)}`);
+    }
+    lines.push("");
+  }
+  const tools = Object.entries(stats.toolUsage).sort(([, a], [, b]) => b - a);
+  if (tools.length > 0) {
+    lines.push("### Tool Usage");
+    lines.push("");
+    for (const [tool2, count] of tools) {
+      lines.push(`- ${tool2}: ${count.toLocaleString()}`);
+    }
+    lines.push("");
+  }
+  lines.push(
+    "_Cloud plan/quota information is not available because OpenCode does not expose a public usage API yet. Set `opencode-usage-stats.enableCloudApi: true` once it is supported._"
+  );
+  return lines.join("\n");
+}
+
+// src/index.ts
+var createLogger = (client) => {
+  return {
+    debug: async (message, extra) => client.app.log({ body: { service: "opencode-usage-stats", level: "debug", message, extra } }),
+    info: async (message, extra) => client.app.log({ body: { service: "opencode-usage-stats", level: "info", message, extra } }),
+    warn: async (message, extra) => client.app.log({ body: { service: "opencode-usage-stats", level: "warn", message, extra } }),
+    error: async (message, extra) => client.app.log({ body: { service: "opencode-usage-stats", level: "error", message, extra } })
+  };
+};
+var OpenCodeUsage = async (input, options) => {
+  const config = resolveConfig(options);
+  const { client } = input;
+  const logger = createLogger(client);
+  await logger.info("Plugin initialized", { enableCloudApi: config.enableCloudApi });
+  return {
+    tool: {
+      usage: tool({
+        description: "Show OpenCode usage statistics (sessions, messages, tokens, cost, model/tool breakdown). When OpenCode exposes a cloud usage API, this can also show plan limits and remaining quota.",
+        args: {
+          cloud: tool.schema.boolean().optional().describe("Force fetch cloud usage information if available.")
         },
-    };
+        async execute(args) {
+          const wantsCloud = args.cloud ?? config.enableCloudApi;
+          if (wantsCloud) {
+            await logger.info("Fetching cloud usage", { cloudApiUrl: config.cloudApiUrl });
+            const cloud = await fetchCloudUsage(config);
+            if (cloud) {
+              return {
+                title: "OpenCode Cloud Usage",
+                output: [
+                  "## OpenCode Cloud Usage",
+                  "",
+                  `- Plan: ${cloud.plan ?? "unknown"}`,
+                  `- Billing Period: ${cloud.billingPeriod ?? "unknown"}`,
+                  `- Monthly Limit: ${cloud.monthlyLimit ?? "unknown"}`,
+                  `- Monthly Used: ${cloud.monthlyUsed ?? "unknown"}`,
+                  `- Remaining: ${cloud.remaining ?? "unknown"}`,
+                  `- Estimated Cost: ${cloud.estimatedCost !== void 0 ? `$${cloud.estimatedCost.toFixed(4)}` : "unknown"}`
+                ].join("\n")
+              };
+            }
+            await logger.warn("Cloud API returned no data, falling back to local usage");
+          }
+          try {
+            await logger.info("Aggregating local usage");
+            const stats = await aggregateUsage(client);
+            await logger.info("Local usage aggregated", {
+              sessions: stats.totalSessions,
+              messages: stats.totalMessages,
+              cost: stats.totalCost
+            });
+            return {
+              title: "OpenCode Usage",
+              output: formatUsage(stats)
+            };
+          } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await logger.error("Failed to aggregate local usage", { error: message });
+            return {
+              title: "OpenCode Usage Error",
+              output: `Failed to gather OpenCode usage statistics.
+
+${message}
+
+Make sure OpenCode is running and the plugin has access to its local API.`
+            };
+          }
+        }
+      })
+    },
+    async config(config2) {
+      config2.command = config2.command ?? {};
+      config2.command.usage = {
+        template: "Call the usage tool and display the formatted usage summary.",
+        description: "Show OpenCode local usage statistics"
+      };
+      await logger.info("Registered /usage command");
+    }
+  };
+};
+var plugin = {
+  id: "opencode-usage-stats",
+  server: OpenCodeUsage
+};
+var index_default = plugin;
+export {
+  OpenCodeUsage,
+  aggregateMessages,
+  aggregateUsage,
+  index_default as default,
+  fetchCloudUsage,
+  formatUsage,
+  resolveConfig
 };
-export default OpenCodeUsage;
-export { OpenCodeUsage };
-export * from "./api.js";
-export * from "./config.js";
-export * from "./usage.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,aAAa,GAAW,KAAK,EAAE,KAAkB,EAAE,OAAuB,EAAE,EAAE;IAClF,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAExB,OAAO;QACL,IAAI,EAAE;YACJ,KAAK,EAAE,IAAI,CAAC;gBACV,WAAW,EACT,2FAA2F;oBAC3F,8FAA8F;gBAChG,IAAI,EAAE;oBACJ,KAAK,EAAE,IAAI,CAAC,MAAM;yBACf,OAAO,EAAE;yBACT,QAAQ,EAAE;yBACV,QAAQ,CAAC,mDAAmD,CAAC;iBACjE;gBACD,KAAK,CAAC,OAAO,CAAC,IAAI;oBAChB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,cAAc,CAAA;oBAEtD,IAAI,UAAU,EAAE,CAAC;wBACf,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAA;wBAC3C,IAAI,KAAK,EAAE,CAAC;4BACV,OAAO;gCACL,KAAK,EAAE,sBAAsB;gCAC7B,MAAM,EAAE;oCACN,yBAAyB;oCACzB,EAAE;oCACF,WAAW,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE;oCACpC,qBAAqB,KAAK,CAAC,aAAa,IAAI,SAAS,EAAE;oCACvD,oBAAoB,KAAK,CAAC,YAAY,IAAI,SAAS,EAAE;oCACrD,mBAAmB,KAAK,CAAC,WAAW,IAAI,SAAS,EAAE;oCACnD,gBAAgB,KAAK,CAAC,SAAS,IAAI,SAAS,EAAE;oCAC9C,qBAAqB,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE;iCAC5G,CAAC,IAAI,CAAC,IAAI,CAAC;6BACb,CAAA;wBACH,CAAC;oBACH,CAAC;oBAED,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;wBAC1C,OAAO;4BACL,KAAK,EAAE,gBAAgB;4BACvB,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC;yBAC3B,CAAA;oBACH,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;wBACtE,OAAO;4BACL,KAAK,EAAE,sBAAsB;4BAC7B,MAAM,EAAE,kDAAkD,OAAO,+EAA+E;yBACjJ,CAAA;oBACH,CAAC;gBACH,CAAC;aACF,CAAC;SACH;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe,aAAa,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/api.ts", "../src/config.ts", "../src/usage.ts"],
+  "sourcesContent": ["import type { Plugin, PluginInput, PluginOptions } from \"@opencode-ai/plugin\"\nimport { tool } from \"@opencode-ai/plugin\"\nimport { fetchCloudUsage } from \"./api.js\"\nimport { resolveConfig } from \"./config.js\"\nimport { aggregateUsage, formatUsage } from \"./usage.js\"\n\nconst createLogger = (client: PluginInput[\"client\"]) => {\n  return {\n    debug: async (message: string, extra?: Record<string, unknown>) =>\n      client.app.log({ body: { service: \"opencode-usage-stats\", level: \"debug\", message, extra } }),\n    info: async (message: string, extra?: Record<string, unknown>) =>\n      client.app.log({ body: { service: \"opencode-usage-stats\", level: \"info\", message, extra } }),\n    warn: async (message: string, extra?: Record<string, unknown>) =>\n      client.app.log({ body: { service: \"opencode-usage-stats\", level: \"warn\", message, extra } }),\n    error: async (message: string, extra?: Record<string, unknown>) =>\n      client.app.log({ body: { service: \"opencode-usage-stats\", level: \"error\", message, extra } }),\n  }\n}\n\nconst OpenCodeUsage: Plugin = async (input: PluginInput, options?: PluginOptions) => {\n  const config = resolveConfig(options)\n  const { client } = input\n  const logger = createLogger(client)\n\n  await logger.info(\"Plugin initialized\", { enableCloudApi: config.enableCloudApi })\n\n  return {\n    tool: {\n      usage: tool({\n        description:\n          \"Show OpenCode usage statistics (sessions, messages, tokens, cost, model/tool breakdown). \" +\n          \"When OpenCode exposes a cloud usage API, this can also show plan limits and remaining quota.\",\n        args: {\n          cloud: tool.schema\n            .boolean()\n            .optional()\n            .describe(\"Force fetch cloud usage information if available.\"),\n        },\n        async execute(args) {\n          const wantsCloud = args.cloud ?? config.enableCloudApi\n\n          if (wantsCloud) {\n            await logger.info(\"Fetching cloud usage\", { cloudApiUrl: config.cloudApiUrl })\n            const cloud = await fetchCloudUsage(config)\n            if (cloud) {\n              return {\n                title: \"OpenCode Cloud Usage\",\n                output: [\n                  \"## OpenCode Cloud Usage\",\n                  \"\",\n                  `- Plan: ${cloud.plan ?? \"unknown\"}`,\n                  `- Billing Period: ${cloud.billingPeriod ?? \"unknown\"}`,\n                  `- Monthly Limit: ${cloud.monthlyLimit ?? \"unknown\"}`,\n                  `- Monthly Used: ${cloud.monthlyUsed ?? \"unknown\"}`,\n                  `- Remaining: ${cloud.remaining ?? \"unknown\"}`,\n                  `- Estimated Cost: ${cloud.estimatedCost !== undefined ? `$${cloud.estimatedCost.toFixed(4)}` : \"unknown\"}`,\n                ].join(\"\\n\"),\n              }\n            }\n            await logger.warn(\"Cloud API returned no data, falling back to local usage\")\n          }\n\n          try {\n            await logger.info(\"Aggregating local usage\")\n            const stats = await aggregateUsage(client)\n            await logger.info(\"Local usage aggregated\", {\n              sessions: stats.totalSessions,\n              messages: stats.totalMessages,\n              cost: stats.totalCost,\n            })\n            return {\n              title: \"OpenCode Usage\",\n              output: formatUsage(stats),\n            }\n          } catch (error) {\n            const message = error instanceof Error ? error.message : String(error)\n            await logger.error(\"Failed to aggregate local usage\", { error: message })\n            return {\n              title: \"OpenCode Usage Error\",\n              output: `Failed to gather OpenCode usage statistics.\\n\\n${message}\\n\\nMake sure OpenCode is running and the plugin has access to its local API.`,\n            }\n          }\n        },\n      }),\n    },\n    async config(config) {\n      config.command = config.command ?? {}\n      config.command.usage = {\n        template: \"Call the usage tool and display the formatted usage summary.\",\n        description: \"Show OpenCode local usage statistics\",\n      }\n      await logger.info(\"Registered /usage command\")\n    },\n  }\n}\n\nconst plugin = {\n  id: \"opencode-usage-stats\",\n  server: OpenCodeUsage,\n}\n\nexport default plugin\nexport { OpenCodeUsage }\nexport * from \"./api.js\"\nexport * from \"./config.js\"\nexport * from \"./usage.js\"\n", "import type { OpenCodeUsageConfig } from \"./config.js\"\n\n/**\n * Cloud usage response shape.\n *\n * This is intentionally generic because OpenCode does not currently expose a\n * public REST endpoint for plan/usage data. When such an API becomes available,\n * this interface can be tightened to match the real schema.\n */\nexport interface CloudUsageInfo {\n  plan?: string\n  monthlyLimit?: number\n  monthlyUsed?: number\n  remaining?: number\n  billingPeriod?: string\n  currency?: string\n  estimatedCost?: number\n}\n\n/**\n * Fetch usage information from a cloud usage API.\n *\n * Currently this is a placeholder. The official OpenCode project does not\n * expose a public REST endpoint for billing/usage/remaining quota. When it does,\n * implement the real network call here and flip `enableCloudApi` to `true` in\n * your OpenCode config.\n *\n * @returns Cloud usage data, or `null` if not available.\n */\nexport async function fetchCloudUsage(\n  _config: Required<OpenCodeUsageConfig>,\n): Promise<CloudUsageInfo | null> {\n  // Placeholder: C-2 is reserved but not enabled by default.\n  // Real implementation should:\n  // 1. Validate config.apiKey and config.cloudApiUrl\n  // 2. Make an authenticated request to the usage endpoint\n  // 3. Parse and return the response\n  return null\n}\n", "import type { PluginOptions } from \"@opencode-ai/plugin\"\n\n/**\n * Configuration shape for the OpenCodeUsage plugin.\n *\n * This is read from the OpenCode config under the `OpenCodeUsage` key,\n * e.g.:\n *\n * ```json\n * {\n *   \"plugin\": [\"OpenCodeUsage\"],\n *   \"OpenCodeUsage\": {\n *     \"enableCloudApi\": false,\n *     \"cloudApiUrl\": \"https://console.opencode.ai/api/usage\",\n *     \"apiKey\": \"\"\n *   }\n * }\n * ```\n */\nexport interface OpenCodeUsageConfig {\n  /** When true, attempt to call the cloud usage API (C-2). Default false (C-1). */\n  enableCloudApi?: boolean\n  /** Base URL for the cloud usage API. Reserved for future OpenCode usage endpoints. */\n  cloudApiUrl?: string\n  /** API key for the cloud usage API. Reserved for future use. */\n  apiKey?: string\n}\n\nexport function resolveConfig(options?: PluginOptions): Required<OpenCodeUsageConfig> {\n  const cfg = (options ?? {}) as OpenCodeUsageConfig\n  return {\n    enableCloudApi: cfg.enableCloudApi ?? false,\n    cloudApiUrl: cfg.cloudApiUrl ?? \"https://console.opencode.ai/api/usage\",\n    apiKey: cfg.apiKey ?? \"\",\n  }\n}\n", "import type { createOpencodeClient, Message, Part, Session } from \"@opencode-ai/sdk\"\n\nexport interface ModelUsage {\n  messages: number\n  inputTokens: number\n  outputTokens: number\n  cacheRead: number\n  cacheWrite: number\n  cost: number\n}\n\nexport interface ToolUsage {\n  [tool: string]: number\n}\n\nexport interface UsageStats {\n  totalSessions: number\n  totalMessages: number\n  totalCost: number\n  totalInputTokens: number\n  totalOutputTokens: number\n  totalReasoningTokens: number\n  totalCacheRead: number\n  totalCacheWrite: number\n  modelUsage: Record<string, ModelUsage>\n  toolUsage: ToolUsage\n}\n\nexport type OpencodeClient = ReturnType<typeof createOpencodeClient>\n\nfunction isAssistantMessage(message: Message): message is Extract<Message, { role: \"assistant\" }> {\n  return \"role\" in message && message.role === \"assistant\"\n}\n\nfunction isToolPart(part: Part): part is Extract<Part, { type: \"tool\" }> {\n  return part.type === \"tool\"\n}\n\nexport function aggregateMessages(messages: { info: Message; parts: Part[] }[]): UsageStats {\n  const stats: UsageStats = {\n    totalSessions: 0,\n    totalMessages: messages.length,\n    totalCost: 0,\n    totalInputTokens: 0,\n    totalOutputTokens: 0,\n    totalReasoningTokens: 0,\n    totalCacheRead: 0,\n    totalCacheWrite: 0,\n    modelUsage: {},\n    toolUsage: {},\n  }\n\n  for (const { info, parts } of messages) {\n    if (!isAssistantMessage(info)) continue\n\n    stats.totalCost += info.cost ?? 0\n\n    const tokens = info.tokens\n    if (tokens) {\n      stats.totalInputTokens += tokens.input ?? 0\n      stats.totalOutputTokens += tokens.output ?? 0\n      stats.totalReasoningTokens += tokens.reasoning ?? 0\n      stats.totalCacheRead += tokens.cache?.read ?? 0\n      stats.totalCacheWrite += tokens.cache?.write ?? 0\n    }\n\n    const modelKey = `${info.providerID}/${info.modelID}`\n    if (!stats.modelUsage[modelKey]) {\n      stats.modelUsage[modelKey] = {\n        messages: 0,\n        inputTokens: 0,\n        outputTokens: 0,\n        cacheRead: 0,\n        cacheWrite: 0,\n        cost: 0,\n      }\n    }\n    const model = stats.modelUsage[modelKey]\n    model.messages += 1\n    if (tokens) {\n      model.inputTokens += tokens.input ?? 0\n      model.outputTokens += tokens.output ?? 0\n      model.cacheRead += tokens.cache?.read ?? 0\n      model.cacheWrite += tokens.cache?.write ?? 0\n    }\n    model.cost += info.cost ?? 0\n\n    for (const part of parts) {\n      if (isToolPart(part)) {\n        stats.toolUsage[part.tool] = (stats.toolUsage[part.tool] ?? 0) + 1\n      }\n    }\n  }\n\n  return stats\n}\n\nexport async function aggregateUsage(client: OpencodeClient): Promise<UsageStats> {\n  const sessionsResponse = await client.session.list()\n  const sessions = Array.isArray(sessionsResponse.data)\n    ? (sessionsResponse.data as Session[])\n    : []\n\n  const allMessages: { info: Message; parts: Part[] }[] = []\n\n  for (const session of sessions) {\n    try {\n      const response = await client.session.messages({ path: { id: session.id } })\n      const messages = Array.isArray(response.data) ? response.data : []\n      allMessages.push(...messages)\n    } catch (error) {\n      // Skip sessions we cannot read.\n      continue\n    }\n  }\n\n  const stats = aggregateMessages(allMessages)\n  stats.totalSessions = sessions.length\n  return stats\n}\n\nexport function formatUsage(stats: UsageStats): string {\n  const totalTokens =\n    stats.totalInputTokens +\n    stats.totalOutputTokens +\n    stats.totalReasoningTokens +\n    stats.totalCacheRead +\n    stats.totalCacheWrite\n\n  const lines: string[] = [\n    \"## OpenCode Usage\",\n    \"\",\n    `- Sessions: ${stats.totalSessions.toLocaleString()}`,\n    `- Messages: ${stats.totalMessages.toLocaleString()}`,\n    `- Total Cost: $${stats.totalCost.toFixed(4)}`,\n    `- Total Tokens: ${totalTokens.toLocaleString()}`,\n    `  - Input: ${stats.totalInputTokens.toLocaleString()}`,\n    `  - Output: ${stats.totalOutputTokens.toLocaleString()}`,\n    `  - Reasoning: ${stats.totalReasoningTokens.toLocaleString()}`,\n    `  - Cache Read: ${stats.totalCacheRead.toLocaleString()}`,\n    `  - Cache Write: ${stats.totalCacheWrite.toLocaleString()}`,\n    \"\",\n  ]\n\n  const models = Object.entries(stats.modelUsage).sort(([, a], [, b]) => b.messages - a.messages)\n  if (models.length > 0) {\n    lines.push(\"### Model Usage\")\n    lines.push(\"\")\n    for (const [model, usage] of models) {\n      lines.push(`- ${model}`)\n      lines.push(`  - Messages: ${usage.messages.toLocaleString()}`)\n      lines.push(\n        `  - Tokens: ${(usage.inputTokens + usage.outputTokens).toLocaleString()} (in ${usage.inputTokens.toLocaleString()} / out ${usage.outputTokens.toLocaleString()})`,\n      )\n      lines.push(`  - Cost: $${usage.cost.toFixed(4)}`)\n    }\n    lines.push(\"\")\n  }\n\n  const tools = Object.entries(stats.toolUsage).sort(([, a], [, b]) => b - a)\n  if (tools.length > 0) {\n    lines.push(\"### Tool Usage\")\n    lines.push(\"\")\n    for (const [tool, count] of tools) {\n      lines.push(`- ${tool}: ${count.toLocaleString()}`)\n    }\n    lines.push(\"\")\n  }\n\n  lines.push(\n    \"_Cloud plan/quota information is not available because OpenCode does not expose a public usage API yet. Set `opencode-usage-stats.enableCloudApi: true` once it is supported._\",\n  )\n\n  return lines.join(\"\\n\")\n}\n"],
+  "mappings": "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",
+  "names": ["tool", "config"]
+}

package/package.json

@@ -1,17 +1,28 @@
 {
   "name": "opencode-usage-stats",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "An OpenCode plugin that surfaces local usage statistics and reserves a cloud usage API integration.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "files": [
     "dist",
     "README.md",
     "LICENSE"
   ],
+  "oc-plugin": [
+    "server"
+  ],
   "scripts": {
-    "build": "tsc",
+    "build": "npm run build:bundle && npm run build:types",
+    "build:bundle": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --external:@opencode-ai/plugin --external:@opencode-ai/sdk --external:node:* --sourcemap",
+    "build:types": "tsc --emitDeclarationOnly",
     "test": "vitest run",
     "prepublishOnly": "npm run build"
   },
@@ -39,9 +50,10 @@
   "devDependencies": {
     "@opencode-ai/plugin": "^1.18.11",
     "@opencode-ai/sdk": "^1.18.11",
-    "@types/node": "^26.1.2",
-    "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.25.0",
+    "typescript": "^7.0.0",
+    "vitest": "^4.0.0"
   },
   "engines": {
     "node": ">=18"