agentradar-cli 0.2.7 → 0.2.8

package/dist/index.js

@@ -89,7 +89,7 @@ async function main() {
         const call = args[0] === "call";
         const parsed = parseCallArgs(args.slice(call ? 1 : 2));
         if (!parsed || (!call && parsed.flags.length)) {
-            console.error(call ? "Usage: agentradar call <runner-id> <tool> [--<argument> <value> ...] [--args '<json>']" : "Usage: agentradar tool run <runner-id> <tool-key> [--args '<json>']");
+            console.error(call ? "Usage: agentradar run <runner-id> <tool> [--<argument> <value> ...] [--args '<json>'] | agentradar run <runner-id> [<tool>] --help" : "Usage: agentradar tool run <runner-id> <tool-key> [--args '<json>']");
             process.exitCode = 1;
             return;
         }

package/dist/tool-run.js

@@ -21,6 +21,8 @@ export async function runServiceToolOverCli(runnerId, toolKey, argumentsJson, de
 }
 /** `agentradar call <runner-id> <tool> [--<argument> <value> ...] [--args '<json>']`: any AWP tool from a shell, so a just-joined agent works before its harness reloads MCP tools. */
 export async function callToolOverCli(runnerId, tool, argumentsJson, deps = {}, flags = []) {
+    if (flags.some(([flag]) => flag === "help"))
+        return await describeTools(runnerId, tool, deps);
     const parameters = argumentsJson === undefined ? {} : parseArgumentsObject(argumentsJson, deps.logError ?? console.error);
     if (!parameters)
         return 1;
@@ -65,6 +67,10 @@ export function parseCallArgs(rest) {
             positional.push(arg);
             continue;
         }
+        if (arg === "--help") {
+            flags.push(["help", ""]);
+            continue;
+        }
         const value = rest[++i];
         if (value === undefined)
             return null;
@@ -73,7 +79,37 @@ export function parseCallArgs(rest) {
         else
             flags.push([arg.slice(2), value]);
     }
-    return positional.length === 2 ? { runnerId: positional[0], tool: positional[1], json, flags } : null;
+    const help = flags.some(([flag]) => flag === "help");
+    return positional.length === 2 || (help && positional.length === 1)
+        ? { runnerId: positional[0], tool: positional[1] ?? "", json, flags } : null;
+}
+async function listedTools(runnerId, deps) {
+    const listed = await awpRequest(runnerId, "tools/list", {}, deps);
+    return listed ? listed.result?.tools ?? [] : null;
+}
+// An agent that guessed a tool name from memory needs the real list, or it goes looking with commands
+// its harness has not allowed and the session stalls on a permission prompt.
+const unknownTool = (runnerId, tool, tools) => `${tool} is not a tool on this server. Its tools: ${tools.map((entry) => entry.name).join(" ")}. `
+    + `\`agentradar run ${runnerId} <tool> --help\` shows a tool's arguments.`;
+/** `agentradar run <runner-id> [<tool>] --help`: the server's own tool list or one tool's arguments. */
+async function describeTools(runnerId, tool, deps) {
+    const tools = await listedTools(runnerId, deps);
+    if (!tools)
+        return 1;
+    const log = deps.log ?? console.log;
+    if (!tool) {
+        log(`Tools: ${tools.map((entry) => entry.name).join(" ")}. \`agentradar run ${runnerId} <tool> --help\` shows a tool's arguments.`);
+        return 0;
+    }
+    const entry = tools.find((candidate) => candidate.name === tool);
+    if (!entry) {
+        (deps.logError ?? console.error)(unknownTool(runnerId, tool, tools));
+        return 1;
+    }
+    const required = entry.inputSchema?.required ?? [];
+    const names = Object.keys(entry.inputSchema?.properties ?? {}).map((name) => `--${name}${required.includes(name) ? " (required)" : ""}`);
+    log(`${tool}: ${entry.description ?? ""}\nArguments: ${names.join(" ") || "none"}`);
+    return 0;
 }
 /**
  * `--text "hi" --conversation-id X` as the tool's own arguments, typed by the inputSchema the server
@@ -81,10 +117,15 @@ export function parseCallArgs(rest) {
  */
 async function flagArguments(runnerId, tool, flags, deps) {
     const logError = deps.logError ?? console.error;
-    const listed = await awpRequest(runnerId, "tools/list", {}, deps);
-    if (!listed)
+    const tools = await listedTools(runnerId, deps);
+    if (!tools)
+        return null;
+    const entry = tools.find((candidate) => candidate.name === tool);
+    if (!entry) {
+        logError(unknownTool(runnerId, tool, tools));
         return null;
-    const schema = listed.result?.tools?.find((entry) => entry.name === tool)?.inputSchema?.properties ?? {};
+    }
+    const schema = entry.inputSchema?.properties ?? {};
     const out = {};
     const camel = (flag) => flag.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
     for (let [flag, value] of flags) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentradar-cli",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "engines": {
     "node": ">=20"
   },