@gururea/opencode-commandcode-provider 0.2.0 → 0.2.1

package/README.md

@@ -34,7 +34,7 @@ Restart opencode, then:
 - **`commandcode_status` tool / `/commandcode-status`.** Shows plugin diagnostics: catalog source (live/cache/fallback), model count, last fetch time, endpoint, zero-data-retention setting, and version.
 - Command Code API keys (`user_...`) do not expire, so they are stored once and reused.
 
-> The `/commandcode-quota` and `/commandcode-status` **tools** are registered by the plugin. The corresponding **slash commands** are provided as `.opencode/command/*.md` files in the package, which you can copy into your project's `.opencode/command/` directory if your opencode setup does not auto-discover package commands.
+> The plugin installs the `commandcode-quota.md` and `commandcode-status.md` slash-command files into your project's `.opencode/command/` directory on startup, so the `/commandcode-quota` and `/commandcode-status` commands appear in the TUI autocomplete. The commands invoke the corresponding tools registered by the plugin.
 
 ## Environment variables
 

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 import { homedir } from "os";
-import { join } from "path";
+import { join as join2 } from "path";
 
 // src/auth.ts
 import { randomBytes } from "crypto";
@@ -237,6 +237,41 @@ function createAuthHook(options = {}) {
   };
 }
 
+// src/commands.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { join } from "path";
+var QUOTA_TEMPLATE = `---
+description: Show Command Code account usage and quota (credits, plan, usage)
+---
+
+Use the **commandcode_quota** tool to fetch and report the user's Command Code account usage and quota. Summarize the credits remaining and used, the plan, the billing-period usage (cost, requests, tokens), and the 5-hour and weekly usage windows. If no API key is configured, tell the user to run \`/connect\` and select Command Code.
+`;
+var STATUS_TEMPLATE = `---
+description: Show Command Code plugin diagnostics (catalog source, model count, endpoint)
+---
+
+Use the **commandcode_status** tool to fetch and report the Command Code plugin diagnostics: the model catalog source (live/cache/fallback), model count, when the catalog was last fetched, the API endpoint, the zero-data-retention setting, and the plugin version.
+`;
+var COMMANDS = [
+  { name: "commandcode-quota.md", content: QUOTA_TEMPLATE },
+  { name: "commandcode-status.md", content: STATUS_TEMPLATE }
+];
+async function installCommandFiles(directory) {
+  if (!directory) return;
+  const commandDir = join(directory, ".opencode", "command");
+  await mkdir(commandDir, { recursive: true });
+  for (const command of COMMANDS) {
+    const target = join(commandDir, command.name);
+    try {
+      const existing = await readFile(target, "utf-8");
+      if (existing === command.content) continue;
+      return;
+    } catch {
+    }
+    await writeFile(target, command.content, "utf-8");
+  }
+}
+
 // src/quota-tool.ts
 import { tool } from "@opencode-ai/plugin";
 
@@ -743,7 +778,7 @@ function createStatusTool({
 }
 
 // src/models.ts
-import { mkdir, readFile, rename, rm, writeFile } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile2, rename, rm, writeFile as writeFile2 } from "fs/promises";
 import { dirname } from "path";
 var DEFAULT_PROVIDER_API_BASE = "https://api.commandcode.ai/provider/v1";
 var DEFAULT_MODELS_URL = `${DEFAULT_PROVIDER_API_BASE}/models`;
@@ -970,14 +1005,14 @@ function commandCodeModelsFromCache(value) {
   return models;
 }
 async function readCommandCodeModelsCache(cachePath) {
-  const contents = await readFile(cachePath, "utf-8");
+  const contents = await readFile2(cachePath, "utf-8");
   return commandCodeModelsFromCache(JSON.parse(contents));
 }
 async function writeCommandCodeModelsCache(cachePath, models, fetchedAt = Date.now()) {
-  await mkdir(dirname(cachePath), { recursive: true });
+  await mkdir2(dirname(cachePath), { recursive: true });
   const temporaryPath = `${cachePath}.${process.pid}.tmp`;
   try {
-    await writeFile(
+    await writeFile2(
       temporaryPath,
       `${JSON.stringify({ version: MODEL_CACHE_VERSION, fetchedAt, models }, null, 2)}
 `,
@@ -1033,7 +1068,7 @@ async function loadCommandCodeModels(options) {
 }
 async function cachedTimestamp(cachePath) {
   try {
-    const contents = await readFile(cachePath, "utf-8");
+    const contents = await readFile2(cachePath, "utf-8");
     const parsed = JSON.parse(contents);
     if (!isRecord3(parsed)) return null;
     return typeof parsed.fetchedAt === "number" && Number.isFinite(parsed.fetchedAt) ? parsed.fetchedAt : null;
@@ -1123,7 +1158,7 @@ function providerBaseUrl() {
 function modelsCachePath() {
   const configured = process.env.COMMANDCODE_MODELS_CACHE;
   if (configured && configured.length > 0) return configured;
-  return join(homedir(), ".cache", "opencode", "commandcode-models.json");
+  return join2(homedir(), ".cache", "opencode", "commandcode-models.json");
 }
 async function loadProviderModels(modelsUrl, cachePath, providerBaseUrl2, logWarn, logInfo) {
   const result = await loadCommandCodeModels({
@@ -1149,10 +1184,12 @@ function getModelsTimeoutMs() {
   const parsed = Number(raw);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_MODELS_TIMEOUT_MS;
 }
-var CommandCodePlugin = async ({ client }) => {
+var CommandCodePlugin = async ({ client, directory }) => {
   const apiBase = providerBaseUrl();
   const modelsUrl = process.env.COMMANDCODE_MODELS_URL ?? `${apiBase}/models`;
   const cachePath = modelsCachePath();
+  installCommandFiles(directory).catch(() => {
+  });
   const { modelMap: models, modelsInfo } = await loadProviderModels(
     modelsUrl,
     cachePath,
@@ -1179,6 +1216,15 @@ var CommandCodePlugin = async ({ client }) => {
         },
         models
       };
+      cfg.command ??= {};
+      cfg.command["commandcode-quota"] = {
+        description: "Show Command Code account usage and quota (credits, plan, usage)",
+        template: "Use the commandcode_quota tool to fetch and report the user's Command Code account usage and quota. Summarize credits remaining and used, the plan, billing-period usage (cost, requests, tokens), and the 5-hour and weekly usage windows."
+      };
+      cfg.command["commandcode-status"] = {
+        description: "Show Command Code plugin diagnostics (catalog source, model count, endpoint)",
+        template: "Use the commandcode_status tool to fetch and report the Command Code plugin diagnostics: catalog source (live/cache/fallback), model count, last fetch time, API endpoint, zero-data-retention setting, and plugin version."
+      };
       client.app.log({
         body: {
           service: "opencode-commandcode",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gururea/opencode-commandcode-provider",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "OpenCode plugin that adds the Command Code (commandcode.ai) provider and its authentication to the interface.",
   "type": "module",
   "main": "./dist/index.js",