agent-dir 0.4.1 → 1.0.0

package/dist/bin/agent-dir.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { createHash, randomBytes } from "node:crypto";
-import { mkdirSync, readFileSync, unlinkSync, watch, writeFileSync } from "node:fs";
+import { createHash, randomBytes, randomUUID } from "node:crypto";
+import { watch } from "node:fs";
 import { createRequire } from "node:module";
 import { resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
@@ -12,6 +12,7 @@ import { hasConfigFile, runFirstTimeSetup, shouldOfferSetup } from "../src/setup
 import { summarizeTelemetry } from "../src/telemetry/aggregate.js";
 import { isTelemetryLevel } from "../src/telemetry/config.js";
 import { formatTelemetrySummary } from "../src/telemetry/format.js";
+import { ensureTelemetryDirectory, migrateLegacyTelemetry, readAllTelemetryEvents, resetTelemetry, TELEMETRY_DIRECTORY, } from "../src/telemetry/storage.js";
 import { startTunnel } from "../src/tunnel.js";
 const require = createRequire(import.meta.url);
 const packageVersion = require("../../package.json").version;
@@ -41,12 +42,15 @@ const { values, positionals } = parseArgs({
         directory: { type: "string", short: "d" },
         port: { type: "string", short: "p" },
         tunnel: { type: "string", short: "t" },
+        wormhole: { type: "boolean", short: "w" },
+        cloudflared: { type: "boolean", short: "c" },
         subdomain: { type: "string", short: "s" },
+        hostname: { type: "string" },
+        "cloudflared-token": { type: "string" },
         npm: { type: "string" },
         command: { type: "string" },
         blacklist: { type: "string" },
         token: { type: "string" },
-        git: { type: "boolean" },
         rotate: { type: "boolean" },
         "no-tunnel": { type: "boolean" },
         random: { type: "boolean" },
@@ -75,7 +79,8 @@ if (command === "setup") {
 if (shouldOfferSetup(await hasConfigFile(), {
     random: values.random,
     noTunnel: values["no-tunnel"],
-    tunnel: values.tunnel,
+    tunnel: values.tunnel ??
+        (values.wormhole ? "wormhole" : values.cloudflared ? "cloudflared" : undefined),
 }) &&
     command !== "config" &&
     command !== "telemetry") {
@@ -90,7 +95,8 @@ if (shouldOfferSetup(await hasConfigFile(), {
 if (command === "telemetry") {
     const action = positionals[1];
     const currentLevel = config.telemetry?.level ?? "none";
-    const telemetryFile = resolve(`${process.env.HOME ?? "."}/.config/agent-dir/telemetry.jsonl`);
+    const telemetryProfile = positionals[2];
+    const telemetrySession = positionals[3];
     if (action === "status") {
         console.log(`Telemetry: ${currentLevel === "none" ? "disabled" : "enabled"}`);
         console.log(`Level: ${currentLevel}`);
@@ -138,12 +144,13 @@ if (command === "telemetry") {
         process.exit(0);
     }
     if (action === "summary") {
-        console.log(formatTelemetrySummary(summarizeTelemetry(readTelemetryEvents(telemetryFile)), currentLevel));
+        console.log(formatTelemetrySummary(summarizeTelemetry(readAllTelemetryEvents().filter((event) => !telemetryProfile || event.configId === telemetryProfile)), currentLevel));
         process.exit(0);
     }
     if (action === "show") {
         const printEvents = () => {
-            const events = readTelemetryEvents(telemetryFile);
+            const events = readAllTelemetryEvents().filter((event) => (!telemetryProfile || event.configId === telemetryProfile) &&
+                (!telemetrySession || event.sessionId === telemetrySession));
             const grouped = new Map();
             for (const event of events) {
                 const configId = isRecord(event) && typeof event.configId === "string" ? event.configId : "unknown";
@@ -170,17 +177,8 @@ if (command === "telemetry") {
         };
         printEvents();
         if (values.follow) {
-            mkdirSync(resolve(`${process.env.HOME ?? "."}/.config/agent-dir`), {
-                recursive: true,
-                mode: 0o700,
-            });
-            try {
-                readFileSync(telemetryFile);
-            }
-            catch {
-                writeFileSync(telemetryFile, "", { encoding: "utf8", mode: 0o600 });
-            }
-            const watcher = watch(telemetryFile, () => {
+            ensureTelemetryDirectory();
+            const watcher = watch(TELEMETRY_DIRECTORY, { recursive: true }, () => {
                 process.stdout.write("\x1b[2J\x1b[H");
                 printEvents();
             });
@@ -195,16 +193,21 @@ if (command === "telemetry") {
         process.exit(0);
     }
     if (action === "reset") {
-        delete config.telemetry;
-        await saveConfig(config);
-        try {
-            unlinkSync(telemetryFile);
+        if (values.all && telemetryProfile)
+            fail("Use either a profile name or --all, not both.");
+        if (!values.all && !telemetryProfile)
+            fail("Usage: agent-dir telemetry reset <profile> | --all");
+        if (values.all) {
+            delete config.telemetry;
+            await saveConfig(config);
+            resetTelemetry(undefined, true);
+            console.log("✓ Telemetry settings reset and all recorded data was cleared.");
         }
-        catch (error) {
-            if (isRecord(error) && error.code !== "ENOENT")
-                throw error;
+        else {
+            migrateLegacyTelemetry();
+            resetTelemetry(telemetryProfile);
+            console.log(`✓ Telemetry data cleared for profile: ${telemetryProfile}`);
         }
-        console.log("✓ Telemetry reset to defaults and all recorded data was cleared.");
         process.exit(0);
     }
     fail("Usage: agent-dir telemetry {status|enable|disable|schema|show|summary|reset}");
@@ -223,6 +226,8 @@ if (command === "config") {
         const profile = structuredClone(config.profiles[name]);
         if (profile.token)
             profile.token = "<configured>";
+        if (profile.tunnels?.cloudflared?.token)
+            profile.tunnels.cloudflared.token = "<configured>";
         console.log(JSON.stringify(profile, null, 2));
         process.exit(0);
     }
@@ -283,8 +288,21 @@ if (command === "config") {
             fail("Usage: agent-dir config add <name> [options]");
         if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name))
             fail("Profile names may contain letters, numbers, dots, underscores, and hyphens.");
-        const tunnel = values.tunnel ?? "none";
-        if (tunnel !== "none" && tunnel !== "wormhole")
+        if (values.wormhole && values.cloudflared)
+            fail("Choose only one of -w or -c.");
+        if ((values.wormhole || values.cloudflared) && values.tunnel)
+            fail("Use either -w/-c or --tunnel, not both.");
+        const tunnel = values.wormhole
+            ? "wormhole"
+            : values.cloudflared
+                ? "cloudflared"
+                : (values.tunnel ??
+                    (values.hostname
+                        ? "cloudflared"
+                        : values.subdomain || values.random
+                            ? "wormhole"
+                            : "none"));
+        if (tunnel !== "none" && tunnel !== "wormhole" && tunnel !== "cloudflared")
             fail(`Unsupported tunnel provider: ${tunnel}`);
         const profile = {
             directory: resolve(values.directory ?? "."),
@@ -294,6 +312,28 @@ if (command === "config") {
         };
         if (values.subdomain)
             profile.subdomain = values.subdomain;
+        if (values.hostname)
+            profile.hostname = values.hostname;
+        if (values.subdomain || values.hostname || values.random) {
+            profile.tunnels = {
+                ...(values.subdomain || values.random
+                    ? {
+                        wormhole: {
+                            ...(values.subdomain ? { subdomain: values.subdomain } : { random: true }),
+                        },
+                    }
+                    : {}),
+                ...(values.hostname
+                    ? {
+                        cloudflared: {
+                            hostname: values.hostname,
+                            ...(values["cloudflared-token"] ? { token: values["cloudflared-token"] } : {}),
+                        },
+                    }
+                    : {}),
+            };
+            profile.defaultTunnel = tunnel;
+        }
         const npm = parseList(values.npm);
         if (npm !== undefined)
             profile.npm = { allowedScripts: npm };
@@ -303,11 +343,12 @@ if (command === "config") {
         const blacklist = parseList(values.blacklist);
         if (blacklist !== undefined)
             profile.blacklistedCommands = blacklist;
-        if (values.git !== undefined)
-            profile.git = values.git;
         if (profile.tunnel === "wormhole" && !profile.subdomain && !values.random) {
             fail("Wormhole profiles require --subdomain <name>, or use --random.");
         }
+        if (profile.tunnel === "cloudflared" && !profile.hostname) {
+            fail("Cloudflared profiles require --hostname <host> (a hostname already routed to your named Cloudflare Tunnel).");
+        }
         config.profiles[name] = profile;
         await saveConfig(config);
         console.log(`✓ Saved profile '${name}'.`);
@@ -323,17 +364,37 @@ if (command && command !== "config" && !profile && command.startsWith("-")) {
 const positionalDirectory = profile ? positionals[1] : positionals[0];
 const directory = resolve(values.directory ?? profile?.directory ?? positionalDirectory ?? ".");
 const port = parsePort(values.port, profile?.port ?? 3002);
-const tunnelValue = values["no-tunnel"] ? "none" : (values.tunnel ?? profile?.tunnel ?? "none");
-if (tunnelValue !== "none" && tunnelValue !== "wormhole") {
+if (values.wormhole && values.cloudflared)
+    fail("Choose only one of -w or -c.");
+if ((values.wormhole || values.cloudflared) && values.tunnel)
+    fail("Use either -w/-c or --tunnel, not both.");
+const configuredDefault = profile?.defaultTunnel ??
+    (profile?.tunnels?.cloudflared ? "cloudflared" : (profile?.tunnel ?? "none"));
+const tunnelValue = values["no-tunnel"]
+    ? "none"
+    : values.wormhole
+        ? "wormhole"
+        : values.cloudflared
+            ? "cloudflared"
+            : (values.tunnel ?? configuredDefault);
+if (tunnelValue !== "none" && tunnelValue !== "wormhole" && tunnelValue !== "cloudflared") {
     fail(`Unsupported tunnel provider: ${tunnelValue}`);
 }
 const tunnel = tunnelValue;
-const randomTunnel = values.random === true;
-const subdomain = randomTunnel ? undefined : (values.subdomain ?? profile?.subdomain);
+const randomTunnel = values.random === true ||
+    (values.subdomain === undefined && profile?.tunnels?.wormhole?.random === true);
+const subdomain = randomTunnel
+    ? undefined
+    : (values.subdomain ?? profile?.tunnels?.wormhole?.subdomain ?? profile?.subdomain);
+const hostname = values.hostname ?? profile?.tunnels?.cloudflared?.hostname ?? profile?.hostname;
+const cloudflaredToken = values["cloudflared-token"] ?? profile?.tunnels?.cloudflared?.token;
 if (tunnel === "wormhole" && !subdomain && !randomTunnel) {
     fail("Wormhole requires --subdomain <name>, or use --random.");
 }
-if (randomTunnel && tunnel === "none") {
+if (tunnel === "cloudflared" && !hostname) {
+    fail("Cloudflared requires --hostname <host> (a hostname already routed to your named Cloudflare Tunnel).");
+}
+if (randomTunnel && tunnel !== "wormhole") {
     fail("--random requires --tunnel wormhole.");
 }
 const token = values.token ?? profile?.token ?? randomBytes(24).toString("hex");
@@ -347,8 +408,6 @@ if (commands !== undefined)
     overrides.commands = commands;
 if (blacklist !== undefined)
     overrides.blacklistedCommands = blacklist;
-if (values.git !== undefined)
-    overrides.git = values.git;
 const commandConfig = mergeProfile(profile ?? { directory, port, tunnel }, overrides);
 const telemetryConfigId = profile
     ? command
@@ -358,11 +417,11 @@ const telemetryConfigId = profile
         port,
         tunnel,
         subdomain,
+        hostname,
         randomTunnel,
         npm: commandConfig.npm?.allowedScripts ?? [],
         commands: commandConfig.commands ?? [],
         blacklistedCommands: commandConfig.blacklistedCommands ?? [],
-        git: commandConfig.git ?? commandConfig.commands?.includes("git") ?? false,
     }))
         .digest("hex")
         .slice(0, 12);
@@ -377,6 +436,8 @@ if (profile && command)
     bannerOptions.profileName = command;
 if (subdomain)
     bannerOptions.subdomain = subdomain;
+if (hostname)
+    bannerOptions.hostname = hostname;
 if (npmScripts)
     bannerOptions.npmScripts = npmScripts;
 if (allowedCommands)
@@ -384,8 +445,8 @@ if (allowedCommands)
 if (commandConfig.blacklistedCommands?.length) {
     bannerOptions.blacklistedCommands = commandConfig.blacklistedCommands;
 }
-bannerOptions.gitEnabled = commandConfig.git ?? commandConfig.commands?.includes("git") ?? false;
 printBanner(bannerOptions);
+const telemetrySessionId = randomUUID();
 const server = await startServer({
     root: directory,
     port,
@@ -394,6 +455,7 @@ const server = await startServer({
     telemetry: {
         ...(config.telemetry ?? { level: "none" }),
         ...(telemetryConfigId ? { configId: telemetryConfigId } : {}),
+        sessionId: telemetrySessionId,
         persist: true,
     },
 });
@@ -405,12 +467,15 @@ console.log("    Token        : <configured>");
 if (tunnel !== "none") {
     try {
         tunnelResult = await startTunnel({
-            provider: "wormhole",
+            provider: tunnel,
             port,
+            ...(hostname ? { hostname } : {}),
+            ...(cloudflaredToken ? { cloudflaredToken } : {}),
             token,
             telemetry: {
                 ...(config.telemetry ?? { level: "none" }),
                 ...(telemetryConfigId ? { configId: telemetryConfigId } : {}),
+                sessionId: telemetrySessionId,
                 persist: true,
             },
             random: randomTunnel,
@@ -453,14 +518,3 @@ async function confirmConfigDelete(message, skipPrompt) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function readTelemetryEvents(path) {
-    try {
-        return readFileSync(path, "utf8")
-            .split("\n")
-            .filter(Boolean)
-            .map((line) => JSON.parse(line));
-    }
-    catch {
-        return [];
-    }
-}

package/dist/src/auth.js

@@ -14,7 +14,9 @@ function secureCompare(left, right) {
     return timingSafeEqual(leftHash, rightHash);
 }
 export function unauthorized() {
-    return new Response(JSON.stringify({ error: "Unauthorized" }), {
+    return new Response(JSON.stringify({
+        error: "Unauthorized: provide a valid Authorization: Bearer <token> header.",
+    }), {
         status: 401,
         headers: {
             "content-type": "application/json; charset=utf-8",

package/dist/src/config.js

@@ -63,12 +63,42 @@ function isProfile(value) {
         return false;
     if (port < 1 || port > 65_535)
         return false;
-    if (profile.tunnel !== "none" && profile.tunnel !== "wormhole")
+    if (profile.tunnel !== "none" &&
+        profile.tunnel !== "wormhole" &&
+        profile.tunnel !== "cloudflared")
         return false;
     if (profile.subdomain !== undefined && typeof profile.subdomain !== "string")
         return false;
+    if (profile.hostname !== undefined && typeof profile.hostname !== "string")
+        return false;
     if (profile.token !== undefined && typeof profile.token !== "string")
         return false;
+    if (profile.defaultTunnel !== undefined &&
+        !["none", "wormhole", "cloudflared"].includes(String(profile.defaultTunnel)))
+        return false;
+    if (profile.tunnels !== undefined) {
+        if (!profile.tunnels || typeof profile.tunnels !== "object")
+            return false;
+        const tunnels = profile.tunnels;
+        if (tunnels.wormhole !== undefined) {
+            if (!tunnels.wormhole || typeof tunnels.wormhole !== "object")
+                return false;
+            const wormhole = tunnels.wormhole;
+            if (wormhole.subdomain !== undefined && typeof wormhole.subdomain !== "string")
+                return false;
+            if (wormhole.random !== undefined && typeof wormhole.random !== "boolean")
+                return false;
+        }
+        if (tunnels.cloudflared !== undefined) {
+            if (!tunnels.cloudflared || typeof tunnels.cloudflared !== "object")
+                return false;
+            const cloudflared = tunnels.cloudflared;
+            if (typeof cloudflared.hostname !== "string" || !cloudflared.hostname)
+                return false;
+            if (cloudflared.token !== undefined && typeof cloudflared.token !== "string")
+                return false;
+        }
+    }
     if (profile.npm !== undefined) {
         if (!profile.npm || typeof profile.npm !== "object")
             return false;
@@ -87,7 +117,5 @@ function isProfile(value) {
             profile.blacklistedCommands.some((item) => typeof item !== "string"))
             return false;
     }
-    if (profile.git !== undefined && typeof profile.git !== "boolean")
-        return false;
     return true;
 }

package/dist/src/logging.d.ts

@@ -6,11 +6,11 @@ export declare function printBanner(options: {
     tunnel: string;
     profileName?: string;
     subdomain?: string;
+    hostname?: string;
     token?: string;
     npmScripts?: string[];
     commands?: string[];
     blacklistedCommands?: string[];
-    gitEnabled?: boolean;
 }): void;
 export declare function printRequestLog(entry: RequestLog): void;
 export declare function logRequest(entry: RequestLog): void;

package/dist/src/logging.js

@@ -9,53 +9,24 @@ const BRIGHT_BLUE = "\x1b[94m";
 const BRIGHT_CYAN = "\x1b[96m";
 const BRIGHT_MAGENTA = "\x1b[95m";
 const BRIGHT_YELLOW = "\x1b[93m";
-const BRIGHT_RED = "\x1b[91m";
-const BRIGHT_GREEN = "\x1b[92m";
 const writeLine = (line = "") => {
     process.stdout.write(`${line}\r\n`);
 };
 const color = (value, code) => `${code}${value}${RESET}`;
 const TOOL_ICONS = {
-    list_files: "📂",
-    list_dirs: "🗂️",
     read_range: "📐",
-    read_files: "📚",
-    write_files: "📝",
-    patch_files: "🧩",
-    delete_files: "🗑️",
     run_npm_batch: "🔧",
     run_command_batch: "🛠️",
-    search_files: "🔎",
     find_files: "🧭",
     search_code: "🧠",
     find_symbol: "🔹",
-    find_definition: "🎯",
     find_references: "🔗",
-    find_imports: "↪",
-    find_exports: "↗",
-    git_status: "🌿",
-    git_stage: "➕",
-    git_unstage: "➖",
-    git_commit: "●",
-    git_restore: "↩",
-    git_push: "⬆",
-    git_diff: "📝",
-    git_log: "📜",
-    project_overview: "🗺️",
-    package_info: "📦",
-    allowed_commands: "🔐",
     file_info: "ℹ️",
-    diagnostics: "🩺",
     project_context: "🧭",
-    inspect: "🔎",
-    locate: "🎯",
-    read_relevant: "🎯",
-    git_changes: "📋",
     apply_changes: "✏️",
     validate: "✓",
 };
 const MCP_METHOD_ICONS = {
-    initialize: "🚀",
     "notifications/initialized": "✓",
     "notifications/cancelled": "✖",
     "notifications/progress": "⏳",
@@ -80,19 +51,8 @@ const MCP_METHOD_ICONS = {
 const TOOL_NAME_WIDTH = Math.max(...Object.keys(TOOL_ICONS).map((name) => name.length));
 const MCP_METHOD_NAME_WIDTH = Math.max(...Object.keys(MCP_METHOD_ICONS).map((name) => name.length));
 const TOOL_COLORS = {
-    list_files: CYAN,
-    list_dirs: BRIGHT_CYAN,
-    read_files: BRIGHT_GREEN,
-    write_files: BRIGHT_YELLOW,
-    patch_files: BRIGHT_MAGENTA,
-    delete_files: BRIGHT_RED,
     run_npm_batch: BRIGHT_BLUE,
     run_command_batch: BRIGHT_CYAN,
-    git_stage: YELLOW,
-    git_unstage: MAGENTA,
-    git_commit: BRIGHT_GREEN,
-    git_restore: RED,
-    git_push: BRIGHT_BLUE,
 };
 const NARROW_TOOL_ICONS = new Set(["✎", "✖", "⚙", "⌘", "↪", "↗"]);
 const TOOL_ICON_SLOT_WIDTH = 3;
@@ -116,14 +76,16 @@ export function printHelp() {
     writeLine("");
     writeLine("Options:");
     writeLine("  -p, --port <port>          Local server port");
-    writeLine("  -t, --tunnel <provider>    Tunnel provider (none, wormhole)");
+    writeLine("  -t, --tunnel <provider>    Explicit tunnel provider (none, wormhole, cloudflared)");
+    writeLine("  -w, --wormhole             Use Wormhole for this run");
+    writeLine("  -c, --cloudflared          Use Cloudflare Tunnel for this run");
     writeLine("  -s, --subdomain <name>     Wormhole subdomain");
+    writeLine("      --hostname <host>      Hostname routed to a Cloudflare Tunnel");
+    writeLine("      --cloudflared-token <token> Cloudflare Tunnel connector token (stored in config)");
     writeLine("      --directory <path>     Directory to expose");
     writeLine("      --npm <scripts>        Comma-separated allowed npm scripts");
     writeLine("      --command <commands>   Comma-separated allowed commands");
     writeLine("      --blacklist <commands> Comma-separated blocked command prefixes");
-    writeLine("      --git                  Enable dedicated Git MCP tools");
-    writeLine("      --no-git               Disable dedicated Git MCP tools");
     writeLine("      --token <token>        Explicit Bearer token");
     writeLine("      --no-tunnel            Disable tunneling");
     writeLine("      --random               Use a random Wormhole URL (no subdomain)");
@@ -169,43 +131,24 @@ export function printBanner(options) {
     }
     if (options.subdomain)
         writeLine(`  Domain       https://${options.subdomain}.wormhole.bar`);
+    if (options.hostname)
+        writeLine(`  Domain       https://${options.hostname}`);
     writeLine("");
     writeLine("  MCP");
     writeLine(`    ${color("⚡ /mcp", CYAN)}`);
     writeLine("");
     writeLine("  TOOLS");
-    writeLine(`    ${color(toolLabel("list_files"), CYAN)}`);
-    writeLine(`    ${color(toolLabel("list_dirs"), BRIGHT_CYAN)}`);
-    writeLine(`    ${color(toolLabel("read_range"), GREEN)}`);
-    writeLine(`    ${color(toolLabel("read_files"), BRIGHT_GREEN)}`);
-    writeLine(`    ${color(toolLabel("write_files"), BRIGHT_YELLOW)}`);
-    writeLine(`    ${color(toolLabel("patch_files"), BRIGHT_MAGENTA)}`);
-    writeLine(`    ${color(toolLabel("delete_files"), BRIGHT_RED)}`);
-    writeLine(`    ${color(toolLabel("run_npm_batch"), BRIGHT_BLUE)}`);
-    writeLine(`    ${color(toolLabel("run_command_batch"), BRIGHT_CYAN)}`);
-    writeLine(`    ${color(toolLabel("search_files"), CYAN)}`);
+    writeLine(`    ${color(toolLabel("project_context"), BRIGHT_CYAN)}`);
     writeLine(`    ${color(toolLabel("find_files"), CYAN)}`);
     writeLine(`    ${color(toolLabel("search_code"), BRIGHT_CYAN)}`);
     writeLine(`    ${color(toolLabel("find_symbol"), GREEN)}`);
-    writeLine(`    ${color(toolLabel("find_definition"), GREEN)}`);
     writeLine(`    ${color(toolLabel("find_references"), GREEN)}`);
-    writeLine(`    ${color(toolLabel("find_imports"), BRIGHT_GREEN)}`);
-    writeLine(`    ${color(toolLabel("find_exports"), BRIGHT_GREEN)}`);
-    if (options.gitEnabled) {
-        writeLine(`    ${color(toolLabel("git_status"), CYAN)}`);
-        writeLine(`    ${color(toolLabel("git_stage"), YELLOW)}`);
-        writeLine(`    ${color(toolLabel("git_unstage"), MAGENTA)}`);
-        writeLine(`    ${color(toolLabel("git_commit"), BRIGHT_GREEN)}`);
-        writeLine(`    ${color(toolLabel("git_restore"), RED)}`);
-        writeLine(`    ${color(toolLabel("git_push"), BRIGHT_BLUE)}`);
-        writeLine(`    ${color(toolLabel("git_diff"), CYAN)}`);
-        writeLine(`    ${color(toolLabel("git_log"), CYAN)}`);
-    }
-    writeLine(`    ${color(toolLabel("project_overview"), BRIGHT_CYAN)}`);
-    writeLine(`    ${color(toolLabel("package_info"), YELLOW)}`);
-    writeLine(`    ${color(toolLabel("allowed_commands"), YELLOW)}`);
+    writeLine(`    ${color(toolLabel("read_range"), GREEN)}`);
+    writeLine(`    ${color(toolLabel("apply_changes"), BRIGHT_MAGENTA)}`);
+    writeLine(`    ${color(toolLabel("validate"), BRIGHT_YELLOW)}`);
+    writeLine(`    ${color(toolLabel("run_npm_batch"), BRIGHT_BLUE)}`);
+    writeLine(`    ${color(toolLabel("run_command_batch"), BRIGHT_CYAN)}`);
     writeLine(`    ${color(toolLabel("file_info"), YELLOW)}`);
-    writeLine(`    ${color(toolLabel("diagnostics"), BRIGHT_YELLOW)}`);
     writeLine("");
     if (options.npmScripts?.length) {
         writeLine("  NPM COMMANDS");