@easynet/agent-tool-hub 1.0.6

package/dist/cli.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+import { loadToolHubConfig, createToolHub } from './chunk-HPDQEW2P.js';
+import './chunk-YSYEED4K.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import fs from 'fs/promises';
+
+var DEFAULT_CONFIG = "toolhub.yaml";
+function parseArgv(argv) {
+  const args = argv.slice(2);
+  let command = "help";
+  let configPath = path.resolve(process.cwd(), DEFAULT_CONFIG);
+  let detail = "normal";
+  let help = false;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+    } else if (arg === "--config" || arg === "-c") {
+      configPath = path.resolve(process.cwd(), args[++i] ?? "");
+    } else if (arg === "--detail" || arg === "-d") {
+      const v = (args[++i] ?? "normal").toLowerCase();
+      detail = v === "short" || v === "full" ? v : "normal";
+    } else if (arg && !arg.startsWith("-") && (arg === "scan" || arg === "verify" || arg === "list" || arg === "help")) {
+      command = arg;
+    }
+  }
+  return { command, configPath, detail, help };
+}
+function printHelp() {
+  const bin = "agent-tool-hub";
+  process.stdout.write(`
+Usage: ${bin} <command> [options]
+
+Commands:
+  scan     Scan configured tool roots and load tools into the hub.
+  verify   Scan and verify tools; exit with code 1 if any discovery errors.
+  list     List discovered tools (use --detail to control output).
+
+Options:
+  --config, -c <path>   Config file path (default: ./${DEFAULT_CONFIG}).
+  --detail, -d <level>  For 'list': short | normal | full (default: normal).
+  --help, -h            Show this help.
+
+Examples:
+  ${bin} scan
+  ${bin} verify -c ./toolhub.yaml
+  ${bin} list --detail short
+  ${bin} list --detail full
+`);
+}
+async function ensureConfig(configPath) {
+  try {
+    await fs.access(configPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function runWithHub(configPath, collectErrors) {
+  const errors = [];
+  const { options } = await loadToolHubConfig(configPath);
+  const optionsWithErrorHandler = {
+    ...options,
+    ...{
+      onDiscoverError(dir, err) {
+        errors.push({ dir, message: err.message });
+      }
+    } 
+  };
+  const hub = await createHubAndInit(optionsWithErrorHandler);
+  return { hub, errors };
+}
+async function createHubAndInit(options) {
+  const hub = createToolHub(options);
+  await hub.initAllTools();
+  return hub;
+}
+function formatRoot(root) {
+  if (typeof root === "string") return root;
+  return root.namespace ? `${root.path} (${root.namespace})` : root.path;
+}
+async function cmdScan(configPath) {
+  const { options } = await loadToolHubConfig(configPath);
+  const hub = await createHubAndInit(options);
+  const specs = hub.getRegistry().snapshot();
+  const roots = options.roots ?? [];
+  process.stdout.write(`Scanned ${specs.length} tool(s) from ${roots.length} root(s).
+`);
+  process.stdout.write(`Roots: ${roots.map(formatRoot).join(", ")}
+`);
+  await hub.shutdown();
+  return 0;
+}
+async function cmdVerify(configPath) {
+  const { hub, errors } = await runWithHub(configPath);
+  const specs = hub.getRegistry().snapshot();
+  await hub.shutdown();
+  if (errors.length > 0) {
+    process.stderr.write(`Verify failed: ${errors.length} error(s) during discovery.
+`);
+    for (const e of errors) {
+      process.stderr.write(`  ${e.dir}: ${e.message}
+`);
+    }
+    return 1;
+  }
+  process.stdout.write(`Verified ${specs.length} tool(s). No errors.
+`);
+  return 0;
+}
+function formatSpecShort(spec) {
+  return spec.name;
+}
+function formatSpecNormal(spec) {
+  const desc = (spec.description ?? "").replace(/\n/g, " ").slice(0, 60);
+  return `${spec.name}	${spec.kind}	${desc}${desc.length >= 60 ? "\u2026" : ""}`;
+}
+function formatSpecFull(spec) {
+  return JSON.stringify(
+    {
+      name: spec.name,
+      kind: spec.kind,
+      version: spec.version,
+      description: spec.description,
+      tags: spec.tags,
+      capabilities: spec.capabilities,
+      endpoint: spec.endpoint,
+      resourceId: spec.resourceId
+    },
+    null,
+    2
+  );
+}
+async function cmdList(configPath, detail) {
+  const { options } = await loadToolHubConfig(configPath);
+  const hub = await createHubAndInit(options);
+  const specs = hub.getRegistry().snapshot();
+  const formatter = detail === "short" ? formatSpecShort : detail === "full" ? formatSpecFull : formatSpecNormal;
+  if (detail === "normal") {
+    process.stdout.write("name	kind	description\n");
+  }
+  for (const spec of specs) {
+    process.stdout.write(formatter(spec) + "\n");
+  }
+  await hub.shutdown();
+  return 0;
+}
+async function main(argv = process.argv) {
+  const { command, configPath, detail, help } = parseArgv(argv);
+  if (help || command === "help") {
+    printHelp();
+    return 0;
+  }
+  const configExists = await ensureConfig(configPath);
+  if (!configExists) {
+    process.stderr.write(`Error: config file not found: ${configPath}
+`);
+    return 1;
+  }
+  switch (command) {
+    case "scan":
+      return cmdScan(configPath);
+    case "verify":
+      return cmdVerify(configPath);
+    case "list":
+      return cmdList(configPath, detail);
+    default:
+      printHelp();
+      return command === "help" ? 0 : 1;
+  }
+}
+async function run(argv) {
+  return main(argv);
+}
+var isMain = typeof process !== "undefined" && process.argv[1] !== void 0 && process.argv[1] === fileURLToPath(import.meta.url);
+if (isMain) {
+  main().then((code) => process.exit(code)).catch((err) => {
+    process.stderr.write(String(err?.message ?? err) + "\n");
+    process.exit(1);
+  });
+}
+
+export { run };
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":"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","file":"cli.js","sourcesContent":["#!/usr/bin/env node\n/**\n * CLI for @easynet/agent-tool-hub: scan tools folders, verify tools, list tools.\n * Usage: agent-tool-hub <command> [options]\n * Commands: scan | verify | list\n */\n\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport fs from \"node:fs/promises\";\nimport { loadToolHubConfig } from \"./config/ToolHubConfig.js\";\nimport { createToolHub } from \"./tool-hub/ToolHub.js\";\nimport type { ToolHubInitOptions } from \"./tool-hub/ToolHub.js\";\nimport type { ToolSpec } from \"./types/ToolSpec.js\";\n\nconst DEFAULT_CONFIG = \"toolhub.yaml\";\n\ntype DetailLevel = \"short\" | \"normal\" | \"full\";\n\ninterface CliArgs {\n  command: \"scan\" | \"verify\" | \"list\" | \"help\";\n  configPath: string;\n  detail: DetailLevel;\n  help: boolean;\n}\n\nfunction parseArgv(argv: string[]): CliArgs {\n  const args = argv.slice(2);\n  let command: CliArgs[\"command\"] = \"help\";\n  let configPath = path.resolve(process.cwd(), DEFAULT_CONFIG);\n  let detail: DetailLevel = \"normal\";\n  let help = false;\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (arg === \"--help\" || arg === \"-h\") {\n      help = true;\n    } else if (arg === \"--config\" || arg === \"-c\") {\n      configPath = path.resolve(process.cwd(), args[++i] ?? \"\");\n    } else if (arg === \"--detail\" || arg === \"-d\") {\n      const v = (args[++i] ?? \"normal\").toLowerCase();\n      detail = v === \"short\" || v === \"full\" ? v : \"normal\";\n    } else if (arg && !arg.startsWith(\"-\") && (arg === \"scan\" || arg === \"verify\" || arg === \"list\" || arg === \"help\")) {\n      command = arg;\n    }\n  }\n\n  return { command, configPath, detail, help };\n}\n\nfunction printHelp(): void {\n  const bin = \"agent-tool-hub\";\n  process.stdout.write(`\nUsage: ${bin} <command> [options]\n\nCommands:\n  scan     Scan configured tool roots and load tools into the hub.\n  verify   Scan and verify tools; exit with code 1 if any discovery errors.\n  list     List discovered tools (use --detail to control output).\n\nOptions:\n  --config, -c <path>   Config file path (default: ./${DEFAULT_CONFIG}).\n  --detail, -d <level>  For 'list': short | normal | full (default: normal).\n  --help, -h            Show this help.\n\nExamples:\n  ${bin} scan\n  ${bin} verify -c ./toolhub.yaml\n  ${bin} list --detail short\n  ${bin} list --detail full\n`);\n}\n\nasync function ensureConfig(configPath: string): Promise<boolean> {\n  try {\n    await fs.access(configPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function runWithHub(\n  configPath: string,\n  collectErrors: boolean,\n): Promise<{ hub: Awaited<ReturnType<typeof createHubAndInit>>; errors: Array<{ dir: string; message: string }> }> {\n  const errors: Array<{ dir: string; message: string }> = [];\n  const { options } = await loadToolHubConfig(configPath);\n  const optionsWithErrorHandler: ToolHubInitOptions = {\n    ...options,\n    ...(collectErrors\n      ? {\n          onDiscoverError(dir: string, err: Error) {\n            errors.push({ dir, message: err.message });\n          },\n        }\n      : {}),\n  };\n  const hub = await createHubAndInit(optionsWithErrorHandler);\n  return { hub, errors };\n}\n\nasync function createHubAndInit(options: ToolHubInitOptions) {\n  const hub = createToolHub(options);\n  await hub.initAllTools();\n  return hub;\n}\n\nfunction formatRoot(root: string | { path: string; namespace?: string }): string {\n  if (typeof root === \"string\") return root;\n  return root.namespace ? `${root.path} (${root.namespace})` : root.path;\n}\n\nasync function cmdScan(configPath: string): Promise<number> {\n  const { options } = await loadToolHubConfig(configPath);\n  const hub = await createHubAndInit(options);\n  const specs = hub.getRegistry().snapshot();\n  const roots: Array<string | { path: string; namespace?: string }> = options.roots ?? [];\n  process.stdout.write(`Scanned ${specs.length} tool(s) from ${roots.length} root(s).\\n`);\n  process.stdout.write(`Roots: ${roots.map(formatRoot).join(\", \")}\\n`);\n  await hub.shutdown();\n  return 0;\n}\n\nasync function cmdVerify(configPath: string): Promise<number> {\n  const { hub, errors } = await runWithHub(configPath, true);\n  const specs = hub.getRegistry().snapshot();\n  await hub.shutdown();\n  if (errors.length > 0) {\n    process.stderr.write(`Verify failed: ${errors.length} error(s) during discovery.\\n`);\n    for (const e of errors) {\n      process.stderr.write(`  ${e.dir}: ${e.message}\\n`);\n    }\n    return 1;\n  }\n  process.stdout.write(`Verified ${specs.length} tool(s). No errors.\\n`);\n  return 0;\n}\n\nfunction formatSpecShort(spec: ToolSpec): string {\n  return spec.name;\n}\n\nfunction formatSpecNormal(spec: ToolSpec): string {\n  const desc = (spec.description ?? \"\").replace(/\\n/g, \" \").slice(0, 60);\n  return `${spec.name}\\t${spec.kind}\\t${desc}${desc.length >= 60 ? \"…\" : \"\"}`;\n}\n\nfunction formatSpecFull(spec: ToolSpec): string {\n  return JSON.stringify(\n    {\n      name: spec.name,\n      kind: spec.kind,\n      version: spec.version,\n      description: spec.description,\n      tags: spec.tags,\n      capabilities: spec.capabilities,\n      endpoint: spec.endpoint,\n      resourceId: spec.resourceId,\n    },\n    null,\n    2,\n  );\n}\n\nasync function cmdList(configPath: string, detail: DetailLevel): Promise<number> {\n  const { options } = await loadToolHubConfig(configPath);\n  const hub = await createHubAndInit(options);\n  const specs = hub.getRegistry().snapshot();\n  const formatter = detail === \"short\" ? formatSpecShort : detail === \"full\" ? formatSpecFull : formatSpecNormal;\n  if (detail === \"normal\") {\n    process.stdout.write(\"name\\tkind\\tdescription\\n\");\n  }\n  for (const spec of specs) {\n    process.stdout.write(formatter(spec) + \"\\n\");\n  }\n  await hub.shutdown();\n  return 0;\n}\n\nasync function main(argv: string[] = process.argv): Promise<number> {\n  const { command, configPath, detail, help } = parseArgv(argv);\n\n  if (help || command === \"help\") {\n    printHelp();\n    return 0;\n  }\n\n  const configExists = await ensureConfig(configPath);\n  if (!configExists) {\n    process.stderr.write(`Error: config file not found: ${configPath}\\n`);\n    return 1;\n  }\n\n  switch (command) {\n    case \"scan\":\n      return cmdScan(configPath);\n    case \"verify\":\n      return cmdVerify(configPath);\n    case \"list\":\n      return cmdList(configPath, detail);\n    default:\n      printHelp();\n      return command === \"help\" ? 0 : 1;\n  }\n}\n\n/** Run CLI with the given argv (same shape as process.argv). Exported for tests. */\nexport async function run(argv: string[]): Promise<number> {\n  return main(argv);\n}\n\nconst isMain =\n  typeof process !== \"undefined\" &&\n  process.argv[1] !== undefined &&\n  process.argv[1] === fileURLToPath(import.meta.url);\n\nif (isMain) {\n  main()\n    .then((code) => process.exit(code))\n    .catch((err) => {\n      process.stderr.write(String(err?.message ?? err) + \"\\n\");\n      process.exit(1);\n    });\n}\n"]}