@kairyou/agent-tools 0.3.0 → 0.4.0

package/dist/usage/opencode-plugin.mjs

@@ -0,0 +1,80 @@
+// integrations/usage/opencode-plugin.mjs
+import { queryProviderUsage } from "./core.mjs";
+var DEFAULT_REFRESH_MS = 6e4;
+function toastMessage(text) {
+  return text.replace(/^API \| /, "");
+}
+function firstString(value, keys) {
+  for (const key of keys) {
+    if (typeof value?.[key] === "string" && value[key].trim()) return value[key].trim();
+  }
+  return "";
+}
+function providerContext(input) {
+  const info = input?.provider?.info || {};
+  const options = input?.provider?.options || {};
+  const providerName = String(input?.model?.providerID || info.id || "opencode");
+  const label = String(info.name || providerName);
+  return {
+    providerName,
+    provider: { name: label },
+    label,
+    baseUrl: process.env.PROVIDER_USAGE_BASE_URL || firstString(options, ["baseURL", "baseUrl", "base_url"]),
+    key: process.env.PROVIDER_USAGE_API_KEY || process.env.SUB2API_API_KEY || firstString(options, ["apiKey", "api_key"])
+  };
+}
+function refreshInterval(options) {
+  const configured = Number(options?.refreshMs || process.env.PROVIDER_USAGE_REFRESH_MS);
+  return Number.isFinite(configured) && configured >= 0 ? configured : DEFAULT_REFRESH_MS;
+}
+var AgentToolsUsage = async ({ client }, options = {}) => {
+  const contexts = /* @__PURE__ */ new Map();
+  const refreshedAt = /* @__PURE__ */ new Map();
+  const inFlight = /* @__PURE__ */ new Map();
+  const refreshMs = refreshInterval(options);
+  async function showUsage(text) {
+    if (!text) return;
+    try {
+      await client.tui.showToast({
+        body: {
+          title: "Provider usage",
+          message: toastMessage(text),
+          variant: "info",
+          duration: 8e3
+        }
+      });
+    } catch {
+    }
+  }
+  async function refreshSession(sessionID) {
+    const context = contexts.get(sessionID);
+    if (!context?.baseUrl || !context?.key) return;
+    const cacheKey = context.baseUrl.replace(/\/+$/, "");
+    const now = Date.now();
+    if (now - (refreshedAt.get(cacheKey) || 0) < refreshMs) return;
+    if (inFlight.has(cacheKey)) return await inFlight.get(cacheKey);
+    refreshedAt.set(cacheKey, now);
+    const task = queryProviderUsage(context, {
+      agent: "opencode",
+      rememberSnapshot: true
+    }).then((result) => showUsage(result?.text || "")).catch(() => {
+    }).finally(() => inFlight.delete(cacheKey));
+    inFlight.set(cacheKey, task);
+    return await task;
+  }
+  return {
+    "chat.params": async (input) => {
+      contexts.set(input.sessionID, providerContext(input));
+    },
+    event: async ({ event }) => {
+      if (event.type === "session.idle") {
+        void refreshSession(event.properties.sessionID);
+      } else if (event.type === "session.deleted") {
+        contexts.delete(event.properties.sessionID);
+      }
+    }
+  };
+};
+export {
+  AgentToolsUsage
+};

package/dist/usage/opencode-tui.mjs

@@ -0,0 +1,46 @@
+// integrations/usage/opencode-tui.mjs
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+var AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(homedir(), ".agent-tools");
+var SNAPSHOT_PATH = join(AGENT_TOOLS_HOME, "cache", "usage-snapshot.json");
+function toastMessage(text) {
+  return text.replace(/^API \| /, "");
+}
+function latestUsage() {
+  try {
+    const data = JSON.parse(readFileSync(SNAPSHOT_PATH, "utf8"));
+    return Object.values(data?.items || {}).filter((item) => typeof item?.text === "string" && item.text).sort((a, b) => String(b.updatedAt || "").localeCompare(String(a.updatedAt || "")))[0]?.text || "";
+  } catch {
+    return "";
+  }
+}
+var tui = async (api) => {
+  api.keymap.registerLayer({
+    commands: [
+      {
+        name: "agent-tools.usage",
+        title: "Provider usage",
+        category: "Agent Tools",
+        namespace: "palette",
+        slashName: "at-usage",
+        run() {
+          const message = latestUsage();
+          api.ui.toast({
+            title: "Provider usage",
+            message: message ? toastMessage(message) : "Provider usage is not available yet",
+            variant: message ? "info" : "warning",
+            duration: 8e3
+          });
+        }
+      }
+    ]
+  });
+};
+var opencode_tui_default = {
+  id: "agent-tools-usage",
+  tui
+};
+export {
+  opencode_tui_default as default
+};

package/integrations/statusline/claude-statusline.mjs

@@ -21,8 +21,8 @@ const DEFAULT_CONFIG_FILE = join(AGENT_TOOLS_HOME, "config.jsonc");
 const SNAPSHOT_FILE = join(AGENT_TOOLS_HOME, "cache", "usage-snapshot.json");
 const REFRESH_STATE_FILE = join(AGENT_TOOLS_HOME, "cache", "usage-refresh-state.json");
 // Cross-integration dependency: statusline renders provider usage via the
-// usage integration's query engine.
-const USAGE_RUNTIME = join(AGENT_TOOLS_HOME, "integrations", "usage", "core.mjs");
+// usage integration's query engine (built artifact; see scripts/build.mjs).
+const USAGE_RUNTIME = join(AGENT_TOOLS_HOME, "dist", "usage", "core.mjs");
 const DEFAULT_SNAPSHOT_TTL_MS = 60_000;
 const DEFAULT_REFRESH_COOLDOWN_MS = 30_000;
 const DEFAULT_FAILURE_BACKOFF_MS = 120_000;
@@ -62,7 +62,7 @@ async function readStdin() {
 function readJsonFile(file) {
   try {
     if (!fs.existsSync(file)) return {};
-    const raw = stripJsonComments(fs.readFileSync(file, "utf8").replace(/^\uFEFF/, ""));
+    const raw = stripTrailingCommas(stripJsonComments(fs.readFileSync(file, "utf8").replace(/^\uFEFF/, "")));
     return raw.trim() ? JSON.parse(raw) : {};
   } catch {
     return {};
@@ -103,6 +103,35 @@ function stripJsonComments(input) {
   return out;
 }
 
+// Matches jsonc-parser's allowTrailingComma so every config.jsonc reader in
+// this package accepts the same syntax. Runs on comment-stripped input.
+function stripTrailingCommas(input) {
+  let out = "";
+  let inString = false;
+  let escaped = false;
+  for (let i = 0; i < input.length; i++) {
+    const ch = input[i];
+    if (inString) {
+      out += ch;
+      escaped = ch === "\\" ? !escaped : false;
+      if (ch === "\"" && !escaped) inString = false;
+      continue;
+    }
+    if (ch === "\"") {
+      inString = true;
+      out += ch;
+      continue;
+    }
+    if (ch === ",") {
+      let j = i + 1;
+      while (j < input.length && /\s/.test(input[j])) j++;
+      if (input[j] === "}" || input[j] === "]") continue;
+    }
+    out += ch;
+  }
+  return out;
+}
+
 function parseArgs(argv) {
   const opts = {};
   for (let i = 0; i < argv.length; i++) {

package/integrations/usage/core.mjs

@@ -236,6 +236,35 @@ function stripJsonComments(input) {
   return out;
 }
 
+// Matches jsonc-parser's allowTrailingComma so every config.jsonc reader in
+// this package accepts the same syntax. Runs on comment-stripped input.
+function stripTrailingCommas(input) {
+  let out = "";
+  let inString = false;
+  let escaped = false;
+  for (let i = 0; i < input.length; i += 1) {
+    const ch = input[i];
+    if (inString) {
+      out += ch;
+      escaped = ch === "\\" ? !escaped : false;
+      if (ch === "\"" && !escaped) inString = false;
+      continue;
+    }
+    if (ch === "\"") {
+      inString = true;
+      out += ch;
+      continue;
+    }
+    if (ch === ",") {
+      let j = i + 1;
+      while (j < input.length && /\s/.test(input[j])) j += 1;
+      if (input[j] === "}" || input[j] === "]") continue;
+    }
+    out += ch;
+  }
+  return out;
+}
+
 let agentConfigCache;
 async function agentConfig() {
   if (agentConfigCache) return agentConfigCache;
@@ -245,7 +274,7 @@ async function agentConfig() {
       agentConfigCache = {};
       return agentConfigCache;
     }
-    const parsed = JSON.parse(stripJsonComments(raw.replace(/^\uFEFF/, "")));
+    const parsed = JSON.parse(stripTrailingCommas(stripJsonComments(raw.replace(/^\uFEFF/, ""))));
     agentConfigCache = parsed.providerUsage || {};
   } catch {
     agentConfigCache = {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kairyou/agent-tools",
-  "version": "0.3.0",
-  "description": "Reusable Agent Skills, plus runtime integrations for Codex, Claude Code, and opencode.",
+  "version": "0.4.0",
+  "description": "Reusable Agent Skills and installable integrations (statusline, provider usage, vision) for Codex, Claude Code, and opencode.",
   "license": "MIT",
   "engines": {
     "node": ">=22"
@@ -11,7 +11,7 @@
   },
   "files": [
     "config.default.jsonc",
-    "dist/vision/",
+    "dist/",
     "integrations/",
     "scripts/",
     "skills/"
@@ -25,8 +25,8 @@
     "zod": "4.4.3"
   },
   "scripts": {
-    "build:vision": "node scripts/build-vision.mjs",
-    "prepare": "npm run build:vision",
+    "build": "node scripts/build.mjs",
+    "prepare": "npm run build",
     "test": "node --test tests/*.test.mjs",
     "release": "node scripts/release.mjs"
   },

package/scripts/build.mjs

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+// Bundles everything that ships to ~/.agent-tools into dist/<capability>.
+// Installed artifacts are always built output; integrations/ holds the sources.
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { build } from "esbuild";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const DIST = path.join(ROOT, "dist");
+
+const TARGETS = {
+  statusline: {
+    entryPoints: {
+      "claude-statusline": path.join(ROOT, "integrations", "statusline", "claude-statusline.mjs"),
+    },
+  },
+  usage: {
+    entryPoints: {
+      core: path.join(ROOT, "integrations", "usage", "core.mjs"),
+      cli: path.join(ROOT, "integrations", "usage", "cli.mjs"),
+      "codex-hook": path.join(ROOT, "integrations", "usage", "codex-hook.mjs"),
+      "opencode-plugin": path.join(ROOT, "integrations", "usage", "opencode-plugin.mjs"),
+      "opencode-tui": path.join(ROOT, "integrations", "usage", "opencode-tui.mjs"),
+    },
+    // core.mjs detects "run as a script" via process.argv[1]; inlining it into
+    // the other entries would re-trigger that check inside their bundles, so it
+    // stays a sibling file that they import at runtime.
+    external: ["./core.mjs"],
+  },
+  vision: {
+    entryPoints: {
+      "mcp-server": path.join(ROOT, "integrations", "vision", "mcp-server.mjs"),
+      cli: path.join(ROOT, "integrations", "vision", "lib", "cli.mjs"),
+    },
+  },
+};
+
+for (const [name, { entryPoints, external = [] }] of Object.entries(TARGETS)) {
+  const outDir = path.join(DIST, name);
+  const stage = path.join(DIST, `.${name}-build-${process.pid}-${Date.now()}`);
+  try {
+    await build({
+      entryPoints,
+      outdir: stage,
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node22",
+      mainFields: ["module", "main"],
+      outExtension: { ".js": ".mjs" },
+      packages: "bundle",
+      external,
+      sourcemap: false,
+      legalComments: "none",
+    });
+
+    fs.rmSync(outDir, { recursive: true, force: true });
+    fs.renameSync(stage, outDir);
+    console.log(`built ${path.relative(ROOT, outDir)}`);
+  } finally {
+    fs.rmSync(stage, { recursive: true, force: true });
+  }
+}

package/scripts/install.mjs

@@ -56,23 +56,25 @@ const INSTALL_ROOT =
   process.env.AGENT_TOOLS_HOME || path.join(os.homedir(), ".agent-tools");
 const META_KEY = "_agentTools";
 const META_VERSION = 1;
+// Everything copied into ~/.agent-tools is built output from dist/ (see
+// scripts/build.mjs); integrations/ holds the sources.
 const SOURCE = {
-  codexUsageHook: path.join(REPO_ROOT, "integrations", "usage", "codex-hook.mjs"),
-  usageScript: path.join(REPO_ROOT, "integrations", "usage", "core.mjs"),
-  usageCli: path.join(REPO_ROOT, "integrations", "usage", "cli.mjs"),
+  codexUsageHook: path.join(REPO_ROOT, "dist", "usage", "codex-hook.mjs"),
+  usageScript: path.join(REPO_ROOT, "dist", "usage", "core.mjs"),
+  usageCli: path.join(REPO_ROOT, "dist", "usage", "cli.mjs"),
   config: path.join(REPO_ROOT, "config.default.jsonc"),
-  claudeStatusline: path.join(REPO_ROOT, "integrations", "statusline", "claude-statusline.mjs"),
-  opencodeUsagePlugin: path.join(REPO_ROOT, "integrations", "usage", "opencode-plugin.mjs"),
-  opencodeUsageTui: path.join(REPO_ROOT, "integrations", "usage", "opencode-tui.mjs"),
+  claudeStatusline: path.join(REPO_ROOT, "dist", "statusline", "claude-statusline.mjs"),
+  opencodeUsagePlugin: path.join(REPO_ROOT, "dist", "usage", "opencode-plugin.mjs"),
+  opencodeUsageTui: path.join(REPO_ROOT, "dist", "usage", "opencode-tui.mjs"),
 };
 const RUNTIME = {
-  codexUsageHook: path.join(INSTALL_ROOT, "integrations", "usage", "codex-hook.mjs"),
-  usageScript: path.join(INSTALL_ROOT, "integrations", "usage", "core.mjs"),
-  usageCli: path.join(INSTALL_ROOT, "integrations", "usage", "cli.mjs"),
+  codexUsageHook: path.join(INSTALL_ROOT, "dist", "usage", "codex-hook.mjs"),
+  usageScript: path.join(INSTALL_ROOT, "dist", "usage", "core.mjs"),
+  usageCli: path.join(INSTALL_ROOT, "dist", "usage", "cli.mjs"),
   config: path.join(INSTALL_ROOT, "config.jsonc"),
-  claudeStatusline: path.join(INSTALL_ROOT, "integrations", "statusline", "claude-statusline.mjs"),
-  opencodeUsagePlugin: path.join(INSTALL_ROOT, "integrations", "usage", "opencode-plugin.mjs"),
-  opencodeUsageTui: path.join(INSTALL_ROOT, "integrations", "usage", "opencode-tui.mjs"),
+  claudeStatusline: path.join(INSTALL_ROOT, "dist", "statusline", "claude-statusline.mjs"),
+  opencodeUsagePlugin: path.join(INSTALL_ROOT, "dist", "usage", "opencode-plugin.mjs"),
+  opencodeUsageTui: path.join(INSTALL_ROOT, "dist", "usage", "opencode-tui.mjs"),
 };
 const ALL_CAPS = ["statusline", "usage", "vision"];
 const ALL_AGENTS = ["claude", "codex", "opencode"];
@@ -137,7 +139,11 @@ function stripJsonComments(input) {
 function readJsonc(file) {
   if (!fs.existsSync(file)) return {};
   const raw = fs.readFileSync(file, "utf8").replace(/^\uFEFF/, "");
-  return raw.trim() ? JSON.parse(stripJsonComments(raw)) : {};
+  if (!raw.trim()) return {};
+  const errors = [];
+  const parsed = parseJsonc(raw, errors, { allowTrailingComma: true });
+  if (errors.length > 0) throw new Error(`Cannot parse ${file} as JSONC`);
+  return parsed ?? {};
 }
 
 function headerComments(text) {
@@ -180,7 +186,7 @@ function isOpenCodeUsageTuiEntry(entry) {
   const spec = Array.isArray(entry) ? entry[0] : entry;
   return (
     typeof spec === "string" &&
-    /\/integrations\/usage\/opencode-tui\.mjs$/i.test(spec.replace(/\\/g, "/"))
+    /\/dist\/usage\/opencode-tui\.mjs$/i.test(spec.replace(/\\/g, "/"))
   );
 }
 
@@ -265,6 +271,11 @@ function installRuntimeAssets(opts) {
     addFile(SOURCE.config, RUNTIME.config, { mergeJsonc: true });
   }
   if (files.length === 0) return;
+  for (const [src] of files) {
+    if (!fs.existsSync(src)) {
+      throw new Error(`Missing built artifact ${src}. Run npm run build.`);
+    }
+  }
   console.log(`runtime: ${INSTALL_ROOT}`);
   for (const [src, dest, options] of files) copyRuntimeFile(src, dest, opts.dryRun, options);
 }
@@ -514,7 +525,7 @@ function installVisionRuntime(opts) {
   }
   for (const name of ["mcp-server.mjs", "cli.mjs"]) {
     if (!fs.existsSync(path.join(VISION_DIST_DIR, name))) {
-      throw new Error(`Missing bundled vision runtime ${path.join(VISION_DIST_DIR, name)}. Run npm run build:vision.`);
+      throw new Error(`Missing bundled vision runtime ${path.join(VISION_DIST_DIR, name)}. Run npm run build.`);
     }
   }
 

package/scripts/build-vision.mjs

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { build } from "esbuild";
-
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const OUT_DIR = path.join(ROOT, "dist", "vision");
-const STAGE_DIR = path.join(ROOT, "dist", `.vision-build-${process.pid}-${Date.now()}`);
-
-try {
-  await build({
-    entryPoints: {
-      "mcp-server": path.join(ROOT, "integrations", "vision", "mcp-server.mjs"),
-      cli: path.join(ROOT, "integrations", "vision", "lib", "cli.mjs"),
-    },
-    outdir: STAGE_DIR,
-    bundle: true,
-    platform: "node",
-    format: "esm",
-    target: "node22",
-    mainFields: ["module", "main"],
-    outExtension: { ".js": ".mjs" },
-    packages: "bundle",
-    sourcemap: false,
-    legalComments: "none",
-  });
-
-  fs.rmSync(OUT_DIR, { recursive: true, force: true });
-  fs.renameSync(STAGE_DIR, OUT_DIR);
-  console.log(`built ${path.relative(ROOT, OUT_DIR)}`);
-} finally {
-  fs.rmSync(STAGE_DIR, { recursive: true, force: true });
-}