@kairyou/agent-tools 0.1.0

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@kairyou/agent-tools",
+  "version": "0.1.0",
+  "description": "Skills and runtime integrations for Codex, Claude Code, and opencode.",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "config.default.jsonc",
+    "hooks/",
+    "lib/",
+    "plugins/",
+    "scripts/",
+    "skills/",
+    "statusline/"
+  ],
+  "dependencies": {
+    "jsonc-parser": "3.3.1"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.mjs"
+  },
+  "bin": {
+    "agent-tools": "./scripts/install.mjs"
+  }
+}

package/plugins/opencode/usage-plugin.mjs

@@ -0,0 +1,95 @@
+import { queryProviderUsage } from "../../lib/usage.mjs";
+
+const DEFAULT_REFRESH_MS = 60_000;
+
+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;
+}
+
+export const AgentToolsUsage = async ({ client }, options = {}) => {
+  const contexts = new Map();
+  const refreshedAt = new Map();
+  const inFlight = 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: 8000,
+        },
+      });
+    } catch {
+      // Headless OpenCode sessions do not have a TUI to notify.
+    }
+  }
+
+  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);
+      }
+    },
+  };
+};

package/plugins/opencode/usage-tui.mjs

@@ -0,0 +1,49 @@
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(homedir(), ".agent-tools");
+const 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 "";
+  }
+}
+
+const 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: 8000,
+          });
+        },
+      },
+    ],
+  });
+};
+
+export default {
+  id: "agent-tools-usage",
+  tui,
+};