@kairyou/agent-tools 0.2.0 → 0.3.0

package/dist/vision/mcp-server.mjs

@@ -30952,11 +30952,11 @@ var StdioServerTransport = class {
   }
 };
 
-// lib/vision/inspect.mjs
+// integrations/vision/lib/inspect.mjs
 import crypto3 from "node:crypto";
 import path4 from "node:path";
 
-// lib/vision/config.mjs
+// integrations/vision/lib/config.mjs
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -31820,7 +31820,7 @@ var ParseErrorCode;
   ParseErrorCode2[ParseErrorCode2["InvalidCharacter"] = 16] = "InvalidCharacter";
 })(ParseErrorCode || (ParseErrorCode = {}));
 
-// lib/vision/errors.mjs
+// integrations/vision/lib/errors.mjs
 var ERROR_CODES = Object.freeze({
   CONFIG: "config_error",
   INPUT: "input_error",
@@ -31848,7 +31848,7 @@ function toVisionError(err, fallbackCode = ERROR_CODES.PROVIDER_HTTP) {
   return new VisionError(fallbackCode, message, { cause: err });
 }
 
-// lib/vision/config.mjs
+// integrations/vision/lib/config.mjs
 var PROVIDERS = Object.freeze(["openai-compatible", "anthropic-compatible"]);
 var CONFIG_DEFAULTS = Object.freeze({
   timeoutMs: 3e4,
@@ -31986,7 +31986,7 @@ function loadVisionConfig({ file: file2, env = process.env } = {}) {
   };
 }
 
-// lib/vision/image-source.mjs
+// integrations/vision/lib/image-source.mjs
 import fs2 from "node:fs";
 import os2 from "node:os";
 import path2 from "node:path";
@@ -32234,7 +32234,7 @@ async function loadImageSource(source, { maxImageBytes, timeoutMs, fetchImpl } =
   throw new VisionError(ERROR_CODES.INPUT, `Unsupported image_source.type: ${JSON.stringify(source.type)}`);
 }
 
-// lib/vision/rate-limit.mjs
+// integrations/vision/lib/rate-limit.mjs
 import crypto from "node:crypto";
 import fs3 from "node:fs";
 import path3 from "node:path";
@@ -32391,7 +32391,7 @@ function createLimiter(config2, now = Date.now, { stateFile = null } = {}) {
   return stateFile ? createSharedLimiter(config2, now, stateFile) : createProcessLimiter(config2, now);
 }
 
-// lib/vision/redact.mjs
+// integrations/vision/lib/redact.mjs
 var MASK = "***";
 function redactSecrets(text, secrets) {
   if (typeof text !== "string" || text.length === 0) return text;
@@ -32403,7 +32403,7 @@ function redactSecrets(text, secrets) {
   return out;
 }
 
-// lib/vision/providers/shared.mjs
+// integrations/vision/lib/providers/shared.mjs
 import crypto2 from "node:crypto";
 async function* encodeBase64(readable) {
   let carry = Buffer.alloc(0);
@@ -32616,7 +32616,7 @@ async function postJson({ url: url2, headers, body, timeoutMs, fetchImpl, provid
   }
 }
 
-// lib/vision/providers/anthropic-compatible.mjs
+// integrations/vision/lib/providers/anthropic-compatible.mjs
 function messagesUrl(baseUrl) {
   return baseUrl.endsWith("/v1") ? `${baseUrl}/messages` : `${baseUrl}/v1/messages`;
 }
@@ -32667,7 +32667,7 @@ async function inspectWithAnthropicCompatible({ config: config2, image, question
   return normalizeAnswers(text, questions);
 }
 
-// lib/vision/providers/openai-compatible.mjs
+// integrations/vision/lib/providers/openai-compatible.mjs
 function replyText2(json2) {
   const message = json2?.choices?.[0]?.message;
   if (typeof message?.content === "string") return message.content;
@@ -32714,7 +32714,7 @@ async function inspectWithOpenAICompatible({ config: config2, image, questions,
   return normalizeAnswers(text, questions);
 }
 
-// lib/vision/inspect.mjs
+// integrations/vision/lib/inspect.mjs
 var PROVIDER_IMPL = {
   "openai-compatible": inspectWithOpenAICompatible,
   "anthropic-compatible": inspectWithAnthropicCompatible
@@ -32798,7 +32798,7 @@ function createVisionService({ config: config2, fetchImpl, now, limiterStateFile
   return { config: resolved, inspect };
 }
 
-// plugins/vision/mcp-server.mjs
+// integrations/vision/mcp-server.mjs
 var TOOL_DESCRIPTION = [
   "This is a callable MCP tool, not an MCP resource. Invoke it directly; never use list_mcp_resources or read_mcp_resource, and never treat inspect_image as a resource URI.",
   "Ask a vision model factual questions about one image (local file path or http(s) URL).",

package/{statusline/claude/statusline.mjs → integrations/statusline/claude-statusline.mjs}

@@ -20,7 +20,9 @@ const AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || join(SCRIPT_DIR, "..",
 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");
-const USAGE_RUNTIME = join(AGENT_TOOLS_HOME, "lib", "usage.mjs");
+// 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");
 const DEFAULT_SNAPSHOT_TTL_MS = 60_000;
 const DEFAULT_REFRESH_COOLDOWN_MS = 30_000;
 const DEFAULT_FAILURE_BACKOFF_MS = 120_000;

package/integrations/usage/cli.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+// Local CLI used by the managed at-usage skills.
+
+import { queryAgentProviderUsage } from "./core.mjs";
+
+function parseAgent(argv) {
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--agent" && argv[index + 1]) return argv[index + 1];
+    if (arg.startsWith("--agent=")) return arg.slice("--agent=".length);
+  }
+  return null;
+}
+
+const agent = parseAgent(process.argv.slice(2));
+if (agent !== "claude" && agent !== "codex") {
+  process.stderr.write(agent ? `Unsupported agent: ${agent}\n` : "Missing --agent <claude|codex>\n");
+  process.exitCode = 2;
+} else {
+  try {
+    const result = await queryAgentProviderUsage(agent);
+    if (result?.text) process.stdout.write(`${result.text}\n`);
+  } catch {
+    // Usage is informational. Leave stdout empty so the skill can report the
+    // provider as unavailable without exposing endpoint or credential details.
+  }
+}

package/{hooks/codex/usage-hook.mjs → integrations/usage/codex-hook.mjs}

@@ -11,7 +11,7 @@ import { fileURLToPath } from "node:url";
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const AGENT_TOOLS_HOME = process.env.AGENT_TOOLS_HOME || path.resolve(SCRIPT_DIR, "..", "..");
-const USAGE_SCRIPT = path.join(AGENT_TOOLS_HOME, "lib", "usage.mjs");
+const USAGE_SCRIPT = path.join(SCRIPT_DIR, "core.mjs");
 const LOG_PATH = path.join(AGENT_TOOLS_HOME, "logs", "usage-hook.log");
 const TIMEOUT_MS = Number(process.env.AGENT_TOOLS_USAGE_HOOK_TIMEOUT_MS || 4500);
 const MAX_LOG_BYTES = Number(process.env.AGENT_TOOLS_USAGE_HOOK_LOG_BYTES || 256 * 1024);

package/{lib/usage.mjs → integrations/usage/core.mjs}

@@ -1171,6 +1171,10 @@ export async function queryProviderUsage(input, options = {}) {
 }
 
 async function refresh(agent = "codex") {
+  return await queryAgentProviderUsage(agent);
+}
+
+export async function queryAgentProviderUsage(agent = "codex") {
   return await queryUsageContext(await usageContext(agent), {
     agent,
     rememberSnapshot: agent === "claude",

package/{plugins/opencode/usage-plugin.mjs → integrations/usage/opencode-plugin.mjs}

@@ -1,4 +1,4 @@
-import { queryProviderUsage } from "../../lib/usage.mjs";
+import { queryProviderUsage } from "./core.mjs";
 
 const DEFAULT_REFRESH_MS = 60_000;
 

package/integrations/usage/skills/at-usage/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: at-usage
+description: Query and display the current API provider balance and recent usage.
+---
+
+Run this installed local command once using the shell or command-execution tool:
+
+```text
+node "{{USAGE_CLI_PATH}}" --agent {{USAGE_AGENT}}
+```
+
+Return stdout verbatim as the complete response. Do not explain, reformat, or
+wrap it in Markdown. If stdout is empty, say exactly `Provider usage is unavailable.`
+
+Never run `npx`, `npm`, `pnpm`, `bun`, install a package, or substitute another
+usage script. Use only the installed command above.

package/{plugins → integrations}/vision/mcp-server.mjs

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-// Vision MCP stdio server. Thin shell over lib/vision: registers the
+// Vision MCP stdio server. Thin shell over ./lib: registers the
 // inspect_image tool, translates results/errors, and nothing else. Launched by
-// hosts as `agent-tools mcp-vision` (or `node plugins/vision/mcp-server.mjs`).
+// hosts as `agent-tools mcp-vision` (or `node integrations/vision/mcp-server.mjs`).
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { createVisionService, QUESTION_LIMITS } from "../../lib/vision/inspect.mjs";
-import { isVisionError } from "../../lib/vision/errors.mjs";
+import { createVisionService, QUESTION_LIMITS } from "./lib/inspect.mjs";
+import { isVisionError } from "./lib/errors.mjs";
 
 // Stable soft constraints live here: this text follows the tool into every
 // session, whether or not the at-vision skill is loaded.

package/package.json

@@ -1,24 +1,20 @@
 {
   "name": "@kairyou/agent-tools",
-  "version": "0.2.0",
-  "description": "Skills and runtime integrations for Codex, Claude Code, and opencode.",
+  "version": "0.3.0",
+  "description": "Reusable Agent Skills, plus runtime integrations for Codex, Claude Code, and opencode.",
   "license": "MIT",
   "engines": {
     "node": ">=22"
   },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "access": "public"
   },
   "files": [
     "config.default.jsonc",
     "dist/vision/",
-    "hooks/",
-    "lib/",
-    "plugins/",
+    "integrations/",
     "scripts/",
-    "skills/",
-    "statusline/"
+    "skills/"
   ],
   "dependencies": {
     "jsonc-parser": "3.3.1"

package/scripts/build-vision.mjs

@@ -12,8 +12,8 @@ const STAGE_DIR = path.join(ROOT, "dist", `.vision-build-${process.pid}-${Date.n
 try {
   await build({
     entryPoints: {
-      "mcp-server": path.join(ROOT, "plugins", "vision", "mcp-server.mjs"),
-      cli: path.join(ROOT, "lib", "vision", "cli.mjs"),
+      "mcp-server": path.join(ROOT, "integrations", "vision", "mcp-server.mjs"),
+      cli: path.join(ROOT, "integrations", "vision", "lib", "cli.mjs"),
     },
     outdir: STAGE_DIR,
     bundle: true,