feat(tools): add tools:cli for inspecting tool configuration
New CLI commands: - pnpm tools:cli list - list available tools with optional filtering - pnpm tools:cli groups - show all tool groups - pnpm tools:cli profiles - show all profiles Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Jiang Bohan
parent
67d54306a1
commit
ae6d516952
2 changed files with 192 additions and 0 deletions
|
|
@ -16,6 +16,7 @@
|
|||
"agent:interactive": "tsx --env-file=.env src/agent/interactive-cli.ts",
|
||||
"agent:profile": "tsx --env-file=.env src/agent/profile-cli.ts",
|
||||
"skills:cli": "tsx --env-file=.env src/agent/skills-cli.ts",
|
||||
"tools:cli": "tsx --env-file=.env src/agent/tools-cli.ts",
|
||||
"dev:gateway": "tsx --env-file=.env --watch src/gateway/main.ts",
|
||||
"dev:console": "tsx --env-file=.env --watch src/console/main.ts",
|
||||
"dev:web": "pnpm --filter @multica/web dev",
|
||||
|
|
|
|||
191
src/agent/tools-cli.ts
Normal file
191
src/agent/tools-cli.ts
Normal file
|
|
@ -0,0 +1,191 @@
|
|||
#!/usr/bin/env node
|
||||
/**
|
||||
* CLI tool to inspect and test tool policy configuration.
|
||||
*
|
||||
* Usage:
|
||||
* pnpm tools:cli list # List all available tools
|
||||
* pnpm tools:cli list --profile coding # List tools after applying profile
|
||||
* pnpm tools:cli list --deny exec # List tools after denying exec
|
||||
* pnpm tools:cli groups # Show all tool groups
|
||||
* pnpm tools:cli profiles # Show all profiles
|
||||
*/
|
||||
|
||||
import { createAllTools } from "./tools.js";
|
||||
import { filterTools, type ToolsConfig } from "./tools/policy.js";
|
||||
import { TOOL_GROUPS, TOOL_PROFILES, expandToolGroups } from "./tools/groups.js";
|
||||
|
||||
type Command = "list" | "groups" | "profiles" | "help";
|
||||
|
||||
interface CliOptions {
|
||||
command: Command;
|
||||
profile?: string;
|
||||
allow?: string[];
|
||||
deny?: string[];
|
||||
provider?: string;
|
||||
isSubagent?: boolean;
|
||||
}
|
||||
|
||||
function printUsage() {
|
||||
console.log("Usage: pnpm tools:cli <command> [options]");
|
||||
console.log("");
|
||||
console.log("Commands:");
|
||||
console.log(" list List available tools (with optional filtering)");
|
||||
console.log(" groups Show all tool groups");
|
||||
console.log(" profiles Show all profiles");
|
||||
console.log(" help Show this help");
|
||||
console.log("");
|
||||
console.log("Options for 'list':");
|
||||
console.log(" --profile PROFILE Apply profile filter (minimal, coding, web, full)");
|
||||
console.log(" --allow TOOLS Allow specific tools (comma-separated)");
|
||||
console.log(" --deny TOOLS Deny specific tools (comma-separated)");
|
||||
console.log(" --provider NAME Apply provider-specific rules");
|
||||
console.log(" --subagent Apply subagent restrictions");
|
||||
console.log("");
|
||||
console.log("Examples:");
|
||||
console.log(" pnpm tools:cli list");
|
||||
console.log(" pnpm tools:cli list --profile coding");
|
||||
console.log(" pnpm tools:cli list --profile coding --deny exec");
|
||||
console.log(" pnpm tools:cli list --allow group:fs,web_fetch");
|
||||
console.log(" pnpm tools:cli groups");
|
||||
}
|
||||
|
||||
function parseArgs(argv: string[]): CliOptions {
|
||||
const args = [...argv];
|
||||
const command = (args.shift() || "help") as Command;
|
||||
|
||||
const opts: CliOptions = { command };
|
||||
|
||||
while (args.length > 0) {
|
||||
const arg = args.shift();
|
||||
if (!arg) break;
|
||||
|
||||
if (arg === "--profile") {
|
||||
opts.profile = args.shift();
|
||||
continue;
|
||||
}
|
||||
if (arg === "--allow") {
|
||||
const value = args.shift();
|
||||
opts.allow = value?.split(",").map((s) => s.trim()) ?? [];
|
||||
continue;
|
||||
}
|
||||
if (arg === "--deny") {
|
||||
const value = args.shift();
|
||||
opts.deny = value?.split(",").map((s) => s.trim()) ?? [];
|
||||
continue;
|
||||
}
|
||||
if (arg === "--provider") {
|
||||
opts.provider = args.shift();
|
||||
continue;
|
||||
}
|
||||
if (arg === "--subagent") {
|
||||
opts.isSubagent = true;
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
return opts;
|
||||
}
|
||||
|
||||
function listTools(opts: CliOptions) {
|
||||
const allTools = createAllTools(process.cwd());
|
||||
|
||||
console.log(`Total tools available: ${allTools.length}`);
|
||||
console.log("");
|
||||
|
||||
// Build config
|
||||
const config: ToolsConfig | undefined =
|
||||
opts.profile || opts.allow || opts.deny
|
||||
? {
|
||||
profile: opts.profile as any,
|
||||
allow: opts.allow,
|
||||
deny: opts.deny,
|
||||
}
|
||||
: undefined;
|
||||
|
||||
const filtered = filterTools(allTools, {
|
||||
config,
|
||||
provider: opts.provider,
|
||||
isSubagent: opts.isSubagent,
|
||||
});
|
||||
|
||||
if (config || opts.provider || opts.isSubagent) {
|
||||
console.log("Applied filters:");
|
||||
if (opts.profile) console.log(` Profile: ${opts.profile}`);
|
||||
if (opts.allow) console.log(` Allow: ${opts.allow.join(", ")}`);
|
||||
if (opts.deny) console.log(` Deny: ${opts.deny.join(", ")}`);
|
||||
if (opts.provider) console.log(` Provider: ${opts.provider}`);
|
||||
if (opts.isSubagent) console.log(` Subagent: true`);
|
||||
console.log("");
|
||||
console.log(`Tools after filtering: ${filtered.length}`);
|
||||
console.log("");
|
||||
}
|
||||
|
||||
console.log("Tools:");
|
||||
for (const tool of filtered) {
|
||||
const desc = tool.description?.slice(0, 60) || "";
|
||||
console.log(` ${tool.name.padEnd(15)} ${desc}${desc.length >= 60 ? "..." : ""}`);
|
||||
}
|
||||
|
||||
if (filtered.length < allTools.length) {
|
||||
const removed = allTools.filter((t) => !filtered.find((f) => f.name === t.name));
|
||||
console.log("");
|
||||
console.log(`Filtered out (${removed.length}):`);
|
||||
for (const tool of removed) {
|
||||
console.log(` ${tool.name}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function showGroups() {
|
||||
console.log("Tool Groups:");
|
||||
console.log("");
|
||||
for (const [name, tools] of Object.entries(TOOL_GROUPS)) {
|
||||
console.log(` ${name}:`);
|
||||
console.log(` ${tools.join(", ")}`);
|
||||
console.log("");
|
||||
}
|
||||
}
|
||||
|
||||
function showProfiles() {
|
||||
console.log("Tool Profiles:");
|
||||
console.log("");
|
||||
for (const [name, policy] of Object.entries(TOOL_PROFILES)) {
|
||||
console.log(` ${name}:`);
|
||||
if (policy.allow) {
|
||||
const expanded = expandToolGroups(policy.allow);
|
||||
console.log(` Allow: ${policy.allow.join(", ")}`);
|
||||
console.log(` Expands to: ${expanded.join(", ")}`);
|
||||
} else {
|
||||
console.log(` Allow: (all tools)`);
|
||||
}
|
||||
if (policy.deny) {
|
||||
console.log(` Deny: ${policy.deny.join(", ")}`);
|
||||
}
|
||||
console.log("");
|
||||
}
|
||||
}
|
||||
|
||||
async function main() {
|
||||
const opts = parseArgs(process.argv.slice(2));
|
||||
|
||||
switch (opts.command) {
|
||||
case "list":
|
||||
listTools(opts);
|
||||
break;
|
||||
case "groups":
|
||||
showGroups();
|
||||
break;
|
||||
case "profiles":
|
||||
showProfiles();
|
||||
break;
|
||||
case "help":
|
||||
default:
|
||||
printUsage();
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
main().catch((err) => {
|
||||
console.error(err?.stack || String(err));
|
||||
process.exit(1);
|
||||
});
|
||||
Loading…
Add table
Add a link
Reference in a new issue