@easynet/agent-tool 1.0.0 → 1.0.2

package/dist/utils/cli/index.js

@@ -0,0 +1,412 @@
+#!/usr/bin/env node
+import { initProject, buildMcpPackage, runMcpServer } from '../../chunk-PJ4RUBZL.js';
+import '../../chunk-5SWSNVMI.js';
+import { runMCPServerOverStdio, createHttpService } from '../../chunk-QVH6IQKQ.js';
+import { resolveToolDescriptor, findAndLoadToolConfig, resolveSandboxedPath, createRuntimeFromConfigSync, getDisplayScope } from '../../chunk-Q7KPGWC6.js';
+import '../../chunk-AE6FSNGY.js';
+import { enrichSpecWithCanonicalSchema } from '../../chunk-FR2CXERF.js';
+import path from 'path';
+import { realpathSync } from 'fs';
+import { fileURLToPath } from 'url';
+
+({
+  sandboxRoot: process.cwd()});
+function getRuntimeWithTools(pathOpt) {
+  const cwd = process.cwd();
+  const searchDir = pathOpt ? path.resolve(cwd, pathOpt) : cwd;
+  const config = findAndLoadToolConfig(searchDir);
+  let sandboxRoot = cwd;
+  if (config.sandboxedPath && typeof config.sandboxedPath === "string" && config.configPath) {
+    sandboxRoot = resolveSandboxedPath(config.configPath, config.sandboxedPath);
+  }
+  const coreConfig = { sandboxRoot, allowedHosts: [] };
+  return createRuntimeFromConfigSync({ coreTools: coreConfig });
+}
+function parseToolName(fullName) {
+  const i = fullName.indexOf("/");
+  if (i < 0) return { scope: "", name: fullName };
+  return { scope: fullName.slice(0, i), name: fullName.slice(i + 1) };
+}
+function parseArgv(argv) {
+  const args = argv.slice(2);
+  let command = "help";
+  let startSub = "http";
+  let help = false;
+  let pathOpt = "";
+  let outDir = "";
+  let include = [];
+  let includeN8n = false;
+  let toolName = "";
+  let toolArgsJson = "{}";
+  let port = 3e3;
+  let host = "127.0.0.1";
+  const commands = [
+    "init",
+    "build",
+    "serve",
+    "list",
+    "ls",
+    "show",
+    "describe",
+    "run",
+    "start",
+    "help"
+  ];
+  const startSubcommands = ["mcp", "http"];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+    } else if (arg === "--path" || arg === "-p") {
+      pathOpt = path.resolve(process.cwd(), args[++i] ?? "");
+    } else if (arg === "--out" || arg === "-o") {
+      outDir = path.resolve(process.cwd(), args[++i] ?? "");
+    } else if (arg === "--include" || arg === "-i") {
+      const v = args[++i];
+      if (v) include.push(v);
+    } else if (arg === "--include-n8n") {
+      includeN8n = true;
+    } else if (arg === "--port") {
+      const v = args[++i];
+      if (v !== void 0) port = parseInt(v, 10) || 3e3;
+    } else if (arg === "--host") {
+      const v = args[++i];
+      if (v !== void 0) host = v;
+    } else if (arg && !arg.startsWith("-") && commands.includes(arg)) {
+      command = arg;
+      const nextArg = args[i + 1];
+      if ((command === "show" || command === "describe") && nextArg !== void 0 && !nextArg.startsWith("-")) {
+        toolName = args[++i] ?? "";
+      } else if (command === "run" && nextArg !== void 0 && !nextArg.startsWith("-")) {
+        toolName = args[++i] ?? "";
+        const runNext = args[i + 1];
+        if (runNext !== void 0 && !runNext.startsWith("-")) {
+          toolArgsJson = args[++i] ?? "{}";
+        }
+      } else if (command === "start" && nextArg !== void 0 && !nextArg.startsWith("-") && startSubcommands.includes(nextArg)) {
+        startSub = args[++i];
+      }
+    }
+  }
+  return { command, startSub, help, pathOpt, outDir, include, includeN8n, toolName, toolArgsJson, port, host };
+}
+function printHelp() {
+  const bin = "agent-tool";
+  process.stdout.write(`
+Usage: ${bin} <command> [options] [args]
+
+Primary commands:
+  ls                      List all tools (scope, name, description).
+  describe <tool path>    Show tool details (schema, capabilities, etc.).
+  run <tool path> [params] Run a tool. Params: JSON, e.g. '{"path":"README.md"}'
+  start mcp                Start MCP server over stdio (streamable).
+  start http               Start OpenAPI HTTP server (API + Swagger).
+
+Other commands:
+  init                    Create project template. Then npm install && npm run build.
+  build                   Scan folder for @tool / SKILL / n8n, generate MCP npm package.
+  serve                   Start the generated MCP server (stdio) for testing.
+  list                    Alias for ls.
+  show <tool>             Alias for describe.
+  help                    Show this help.
+
+Options:
+  --path, -p <path>       For init/build/serve: path (default: cwd).
+  --out, -o <path>        For build: output directory.
+  --include, -i <glob>    For build: glob for TS files.
+  --include-n8n           For build: include n8n workflow tools.
+  --port <number>         For start http: port (default: 3000).
+  --host <string>         For start http: host (default: 127.0.0.1).
+  --help, -h              Show this help.
+
+Examples:
+  ${bin} ls
+  ${bin} describe core/fs.readText
+  ${bin} run core/fs.readText '{"path":"README.md"}'
+  ${bin} start mcp
+  ${bin} start http --port 3000
+  ${bin} build --path . --out dist
+
+For agent run (ReAct + agent.yaml): npx @easynet/agent-orchestra run "task" -c agent.yaml
+`);
+}
+async function cmdInit(pathOpt) {
+  try {
+    const { targetPath, filesCreated } = await initProject({ targetPath: pathOpt || void 0 });
+    process.stdout.write(`Initialized project at ${targetPath}
+Created: ${filesCreated.join(", ")}
+Next: npm install && npm run build
+`);
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Init failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+async function cmdBuild(pathOpt, outDir, include, includeN8n) {
+  try {
+    const result = await buildMcpPackage({
+      projectPath: pathOpt || void 0,
+      outDir: outDir || void 0,
+      include: include.length > 0 ? include : void 0,
+      includeN8n: includeN8n || void 0
+    });
+    process.stdout.write(
+      `Built ${result.toolCount} tool(s) -> ${result.outDir}
+Entry: ${result.entryPath}
+mcp.json: ${result.mcpJsonPath}
+`
+    );
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Build failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+async function cmdServe(pathOpt) {
+  try {
+    const { process: child } = await runMcpServer({ path: pathOpt || void 0 });
+    child.stdin?.pipe(process.stdin);
+    child.stdout?.pipe(process.stdout);
+    process.stdin?.unref();
+    const exit = new Promise((resolve) => {
+      child.on("close", (code) => resolve(code ?? 0));
+    });
+    return exit;
+  } catch (err) {
+    process.stderr.write(`Serve failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+var LS_DESC_MAX = 72;
+function formatLsOutput(specs) {
+  const rows = specs.map((spec) => {
+    const { name } = parseToolName(spec.name);
+    const scope = getDisplayScope(spec.name, spec.kind, spec.version);
+    const desc = (spec.description ?? "").replace(/\n/g, " ").trim().slice(0, LS_DESC_MAX);
+    return { scope, name, description: desc || "(no description)" };
+  });
+  const scopeW = Math.max(6, ...rows.map((r) => r.scope.length));
+  const nameW = Math.max(4, ...rows.map((r) => r.name.length));
+  const sep = `${"\u2500".repeat(scopeW)}\u252C${"\u2500".repeat(nameW)}\u252C${"\u2500".repeat(LS_DESC_MAX + 2)}`;
+  const header = [
+    "SCOPE".padEnd(scopeW),
+    "NAME".padEnd(nameW),
+    "DESCRIPTION"
+  ].join(" \u2502 ");
+  const lines = [
+    header,
+    sep,
+    ...rows.map(
+      (r) => [
+        r.scope.padEnd(scopeW),
+        r.name.padEnd(nameW),
+        r.description
+      ].join(" \u2502 ")
+    )
+  ];
+  return lines.join("\n");
+}
+function formatDescribeOutput(spec) {
+  const { name: localName } = parseToolName(spec.name);
+  const scope = getDisplayScope(spec.name, spec.kind, spec.version);
+  const sections = [];
+  sections.push("\u250C\u2500 Tool");
+  sections.push(`\u2502  name:        ${spec.name}`);
+  sections.push(`\u2502  scope:       ${scope}`);
+  sections.push(`\u2502  localName:   ${localName}`);
+  sections.push(`\u2502  version:     ${spec.version}`);
+  sections.push(`\u2502  kind:        ${spec.kind}`);
+  sections.push("\u251C\u2500 Description");
+  sections.push(`\u2502  ${(spec.description ?? "(none)").replace(/\n/g, "\n\u2502  ")}`);
+  sections.push("\u251C\u2500 Tags");
+  sections.push(`\u2502  ${spec.tags?.length ? spec.tags.join(", ") : "(none)"}`);
+  sections.push("\u251C\u2500 Capabilities");
+  sections.push(`\u2502  ${spec.capabilities.join(", ")}`);
+  if (spec._meta?.hitl?.sideEffect) {
+    sections.push("\u251C\u2500 HITL");
+    sections.push(`\u2502  sideEffect: ${spec._meta.hitl.sideEffect}`);
+  }
+  sections.push("\u251C\u2500 Input schema");
+  sections.push(
+    "\u2502  " + JSON.stringify(spec.inputSchema, null, 2).replace(/\n/g, "\n\u2502  ")
+  );
+  sections.push("\u2514\u2500 Output schema");
+  sections.push(
+    "   " + JSON.stringify(spec.outputSchema, null, 2).replace(/\n/g, "\n   ")
+  );
+  return sections.join("\n");
+}
+async function cmdLs(pathOpt) {
+  try {
+    const { registry } = getRuntimeWithTools(pathOpt);
+    const specs = registry.snapshot();
+    if (specs.length === 0) {
+      process.stdout.write("No tools registered.\n");
+      return 0;
+    }
+    specs.sort((a, b) => a.name.localeCompare(b.name));
+    process.stdout.write(formatLsOutput(specs) + "\n");
+    return 0;
+  } catch (err) {
+    process.stderr.write(`ls failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+async function cmdDescribe(toolName, pathOpt) {
+  if (!toolName.trim()) {
+    process.stderr.write("Usage: agent-tool describe <tool path>\n");
+    return 1;
+  }
+  try {
+    const { registry } = getRuntimeWithTools(pathOpt);
+    const registryName = resolveToolDescriptor(toolName.trim());
+    const spec = registry.get(registryName);
+    if (!spec) {
+      process.stderr.write(`Tool not found: ${toolName}
+`);
+      return 1;
+    }
+    process.stdout.write(formatDescribeOutput(enrichSpecWithCanonicalSchema(spec)) + "\n");
+    return 0;
+  } catch (err) {
+    process.stderr.write(`describe failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+function defaultExecContext() {
+  return {
+    requestId: `cli-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+    taskId: `task-${Date.now()}`,
+    permissions: [
+      "read:web",
+      "read:fs",
+      "write:fs",
+      "read:db",
+      "write:db",
+      "network",
+      "workflow",
+      "danger:destructive",
+      "exec"
+    ]
+  };
+}
+async function cmdRun(toolName, toolArgsJson, pathOpt) {
+  if (!toolName.trim()) {
+    process.stderr.write("Usage: agent-tool run <tool path> [<json params>]\n");
+    return 1;
+  }
+  let args = {};
+  if (toolArgsJson.trim()) {
+    try {
+      args = JSON.parse(toolArgsJson);
+    } catch {
+      process.stderr.write(`Invalid JSON for parameters. Example: '{"path":"README.md"}'
+`);
+      return 1;
+    }
+  }
+  try {
+    const { runtime, registry } = getRuntimeWithTools(pathOpt);
+    const registryName = resolveToolDescriptor(toolName.trim());
+    if (!registry.get(registryName)) {
+      process.stderr.write(`Tool not found: ${toolName}
+`);
+      return 1;
+    }
+    const ctx = defaultExecContext();
+    const result = await runtime.invoke(
+      { tool: registryName, args, purpose: "cli" },
+      ctx
+    );
+    if (result.ok) {
+      process.stdout.write(JSON.stringify(result.result, null, 2) + "\n");
+      return 0;
+    }
+    process.stderr.write(`Tool error: ${result.error?.kind ?? "unknown"} - ${result.error?.message ?? ""}
+`);
+    return 1;
+  } catch (err) {
+    process.stderr.write(`Run failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+async function cmdStartMcp(pathOpt) {
+  try {
+    const { runtime } = getRuntimeWithTools(pathOpt);
+    await runMCPServerOverStdio(runtime);
+    return 0;
+  } catch (err) {
+    process.stderr.write(`start mcp failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+async function cmdStartHttp(port, host, pathOpt) {
+  try {
+    const { runtime } = getRuntimeWithTools(pathOpt);
+    const http = await createHttpService(runtime);
+    const { port: actualPort, host: actualHost } = await http.listen({ port, host });
+    const base = `http://${actualHost}:${actualPort}`;
+    process.stdout.write(`API: ${base}/invoke (POST), ${base}/tools (GET)
+`);
+    process.stdout.write(`Swagger UI: ${base}/  (spec: ${base}/openapi.json)
+`);
+    await new Promise(() => {
+    });
+    return 0;
+  } catch (err) {
+    process.stderr.write(`start http failed: ${err instanceof Error ? err.message : String(err)}
+`);
+    return 1;
+  }
+}
+async function main(argv = process.argv) {
+  const { command, startSub, help, pathOpt, outDir, include, includeN8n, toolName, toolArgsJson, port, host } = parseArgv(argv);
+  if (help || command === "help") {
+    printHelp();
+    return 0;
+  }
+  if (command === "init") return cmdInit(pathOpt);
+  if (command === "build") return cmdBuild(pathOpt, outDir, include, includeN8n);
+  if (command === "serve") return cmdServe(pathOpt);
+  if (command === "ls" || command === "list") return cmdLs(pathOpt);
+  if (command === "describe" || command === "show") return cmdDescribe(toolName, pathOpt);
+  if (command === "run") return cmdRun(toolName, toolArgsJson, pathOpt);
+  if (command === "start") {
+    if (startSub === "mcp") return cmdStartMcp(pathOpt);
+    if (startSub === "http") return cmdStartHttp(port, host, pathOpt);
+    process.stderr.write("Usage: agent-tool start mcp | agent-tool start http [--port 3000] [--host 127.0.0.1]\n");
+    return 1;
+  }
+  printHelp();
+  return 1;
+}
+async function run(argv) {
+  return main(argv);
+}
+var scriptPath = fileURLToPath(import.meta.url);
+var invokedPath = process.argv[1];
+var isMain = typeof process !== "undefined" && invokedPath !== void 0 && invokedPath === scriptPath;
+if (!isMain && invokedPath) {
+  try {
+    isMain = realpathSync(invokedPath) === realpathSync(scriptPath);
+  } catch {
+  }
+}
+if (isMain) {
+  main().then((code) => process.exit(code)).catch((err) => {
+    process.stderr.write(String(err?.message ?? err) + "\n");
+    process.exit(1);
+  });
+}
+
+export { run };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/cli/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["#!/usr/bin/env node\n/**\n * CLI for @easynet/agent-tool: ls | describe | run | start mcp | start http | init | build | serve | help.\n * Usage: agent-tool <command> [options] [args]\n * Primary: ls, describe [tool path], run [tool path] [parameters], start mcp, start http.\n */\n\nimport path from \"node:path\";\nimport { realpathSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { initProject } from \"../../api/expose/mcp-build/init.js\";\nimport { buildMcpPackage } from \"../../api/expose/mcp-build/build.js\";\nimport { runMcpServer } from \"../../api/expose/mcp-build/run.js\";\nimport { createRuntimeFromConfigSync } from \"../../api/runtimeFromConfig.js\";\nimport { createHttpService } from \"../../api/expose/openapiHttp.js\";\nimport { runMCPServerOverStdio } from \"../../api/expose/mcpServer.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport { getDisplayScope, resolveToolDescriptor } from \"../../tools/util/toolDescriptor.js\";\nimport { findAndLoadToolConfig, resolveSandboxedPath } from \"../../tools/util/toolConfig.js\";\nimport { enrichSpecWithCanonicalSchema } from \"../../tools/util/canonicalCoreSchemas.js\";\n\ntype CliCommand = \"init\" | \"build\" | \"serve\" | \"list\" | \"ls\" | \"show\" | \"describe\" | \"run\" | \"start\" | \"help\";\ntype StartSubcommand = \"mcp\" | \"http\";\n\ninterface CliArgs {\n  command: CliCommand;\n  startSub: StartSubcommand;\n  help: boolean;\n  pathOpt: string;\n  outDir: string;\n  include: string[];\n  includeN8n: boolean;\n  toolName: string;\n  toolArgsJson: string;\n  port: number;\n  host: string;\n}\n\nconst DEFAULT_CORE_CONFIG = {\n  sandboxRoot: process.cwd(),\n  allowedHosts: [] as string[],\n};\n\nfunction getRuntimeWithTools(pathOpt?: string): { runtime: ReturnType<typeof createRuntimeFromConfigSync>[\"runtime\"]; registry: ReturnType<typeof createRuntimeFromConfigSync>[\"registry\"] } {\n  const cwd = process.cwd();\n  const searchDir = pathOpt ? path.resolve(cwd, pathOpt) : cwd;\n  const config = findAndLoadToolConfig(searchDir);\n  let sandboxRoot = cwd;\n  if (config.sandboxedPath && typeof config.sandboxedPath === \"string\" && config.configPath) {\n    sandboxRoot = resolveSandboxedPath(config.configPath, config.sandboxedPath);\n  }\n  const coreConfig = { sandboxRoot, allowedHosts: [] as string[] };\n  return createRuntimeFromConfigSync({ coreTools: coreConfig });\n}\n\n/** Parse \"scope/name\" into { scope, name }; if no slash, scope is \"\", name is full. */\nfunction parseToolName(fullName: string): { scope: string; name: string } {\n  const i = fullName.indexOf(\"/\");\n  if (i < 0) return { scope: \"\", name: fullName };\n  return { scope: fullName.slice(0, i), name: fullName.slice(i + 1) };\n}\n\nfunction parseArgv(argv: string[]): CliArgs {\n  const args = argv.slice(2);\n  let command: CliCommand = \"help\";\n  let startSub: StartSubcommand = \"http\";\n  let help = false;\n  let pathOpt = \"\";\n  let outDir = \"\";\n  let include: string[] = [];\n  let includeN8n = false;\n  let toolName = \"\";\n  let toolArgsJson = \"{}\";\n  let port = 3000;\n  let host = \"127.0.0.1\";\n\n  const commands: CliCommand[] = [\n    \"init\", \"build\", \"serve\", \"list\", \"ls\", \"show\", \"describe\", \"run\", \"start\", \"help\",\n  ];\n  const startSubcommands: StartSubcommand[] = [\"mcp\", \"http\"];\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 === \"--path\" || arg === \"-p\") {\n      pathOpt = path.resolve(process.cwd(), args[++i] ?? \"\");\n    } else if (arg === \"--out\" || arg === \"-o\") {\n      outDir = path.resolve(process.cwd(), args[++i] ?? \"\");\n    } else if (arg === \"--include\" || arg === \"-i\") {\n      const v = args[++i];\n      if (v) include.push(v);\n    } else if (arg === \"--include-n8n\") {\n      includeN8n = true;\n    } else if (arg === \"--port\") {\n      const v = args[++i];\n      if (v !== undefined) port = parseInt(v, 10) || 3000;\n    } else if (arg === \"--host\") {\n      const v = args[++i];\n      if (v !== undefined) host = v;\n    } else if (arg && !arg.startsWith(\"-\") && commands.includes(arg as CliCommand)) {\n      command = arg as CliCommand;\n      const nextArg = args[i + 1];\n      if ((command === \"show\" || command === \"describe\") && nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n        toolName = args[++i] ?? \"\";\n      } else if (command === \"run\" && nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n        toolName = args[++i] ?? \"\";\n        const runNext = args[i + 1];\n        if (runNext !== undefined && !runNext.startsWith(\"-\")) {\n          toolArgsJson = args[++i] ?? \"{}\";\n        }\n      } else if (command === \"start\" && nextArg !== undefined && !nextArg.startsWith(\"-\") && startSubcommands.includes(nextArg as StartSubcommand)) {\n        startSub = args[++i] as StartSubcommand;\n      }\n    }\n  }\n\n  return { command, startSub, help, pathOpt, outDir, include, includeN8n, toolName, toolArgsJson, port, host };\n}\n\nfunction printHelp(): void {\n  const bin = \"agent-tool\";\n  process.stdout.write(`\nUsage: ${bin} <command> [options] [args]\n\nPrimary commands:\n  ls                      List all tools (scope, name, description).\n  describe <tool path>    Show tool details (schema, capabilities, etc.).\n  run <tool path> [params] Run a tool. Params: JSON, e.g. '{\"path\":\"README.md\"}'\n  start mcp                Start MCP server over stdio (streamable).\n  start http               Start OpenAPI HTTP server (API + Swagger).\n\nOther commands:\n  init                    Create project template. Then npm install && npm run build.\n  build                   Scan folder for @tool / SKILL / n8n, generate MCP npm package.\n  serve                   Start the generated MCP server (stdio) for testing.\n  list                    Alias for ls.\n  show <tool>             Alias for describe.\n  help                    Show this help.\n\nOptions:\n  --path, -p <path>       For init/build/serve: path (default: cwd).\n  --out, -o <path>        For build: output directory.\n  --include, -i <glob>    For build: glob for TS files.\n  --include-n8n           For build: include n8n workflow tools.\n  --port <number>         For start http: port (default: 3000).\n  --host <string>         For start http: host (default: 127.0.0.1).\n  --help, -h              Show this help.\n\nExamples:\n  ${bin} ls\n  ${bin} describe core/fs.readText\n  ${bin} run core/fs.readText '{\"path\":\"README.md\"}'\n  ${bin} start mcp\n  ${bin} start http --port 3000\n  ${bin} build --path . --out dist\n\nFor agent run (ReAct + agent.yaml): npx @easynet/agent-orchestra run \"task\" -c agent.yaml\n`);\n}\n\nasync function cmdInit(pathOpt: string): Promise<number> {\n  try {\n    const { targetPath, filesCreated } = await initProject({ targetPath: pathOpt || undefined });\n    process.stdout.write(`Initialized project at ${targetPath}\\nCreated: ${filesCreated.join(\", \")}\\nNext: npm install && npm run build\\n`);\n    return 0;\n  } catch (err) {\n    process.stderr.write(`Init failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nasync function cmdBuild(\n  pathOpt: string,\n  outDir: string,\n  include: string[],\n  includeN8n: boolean,\n): Promise<number> {\n  try {\n    const result = await buildMcpPackage({\n      projectPath: pathOpt || undefined,\n      outDir: outDir || undefined,\n      include: include.length > 0 ? include : undefined,\n      includeN8n: includeN8n || undefined,\n    });\n    process.stdout.write(\n      `Built ${result.toolCount} tool(s) -> ${result.outDir}\\nEntry: ${result.entryPath}\\nmcp.json: ${result.mcpJsonPath}\\n`,\n    );\n    return 0;\n  } catch (err) {\n    process.stderr.write(`Build failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nasync function cmdServe(pathOpt: string): Promise<number> {\n  try {\n    const { process: child } = await runMcpServer({ path: pathOpt || undefined });\n    child.stdin?.pipe(process.stdin);\n    child.stdout?.pipe(process.stdout);\n    process.stdin?.unref();\n    const exit = new Promise<number>((resolve) => {\n      child.on(\"close\", (code) => resolve(code ?? 0));\n    });\n    return exit;\n  } catch (err) {\n    process.stderr.write(`Serve failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nconst LS_DESC_MAX = 72;\n\n/** Format tool list as table: SCOPE (full package name) | NAME | DESCRIPTION */\nfunction formatLsOutput(specs: ToolSpec[]): string {\n  const rows = specs.map((spec) => {\n    const { name } = parseToolName(spec.name);\n    const scope = getDisplayScope(spec.name, spec.kind, spec.version);\n    const desc = (spec.description ?? \"\")\n      .replace(/\\n/g, \" \")\n      .trim()\n      .slice(0, LS_DESC_MAX);\n    return { scope, name, description: desc || \"(no description)\" };\n  });\n\n  const scopeW = Math.max(6, ...rows.map((r) => r.scope.length));\n  const nameW = Math.max(4, ...rows.map((r) => r.name.length));\n\n  const sep = `${\"─\".repeat(scopeW)}┬${\"─\".repeat(nameW)}┬${\"─\".repeat(LS_DESC_MAX + 2)}`;\n  const header = [\n    \"SCOPE\".padEnd(scopeW),\n    \"NAME\".padEnd(nameW),\n    \"DESCRIPTION\",\n  ].join(\" │ \");\n  const lines = [\n    header,\n    sep,\n    ...rows.map((r) =>\n      [\n        r.scope.padEnd(scopeW),\n        r.name.padEnd(nameW),\n        r.description,\n      ].join(\" │ \")\n    ),\n  ];\n  return lines.join(\"\\n\");\n}\n\n/** Format single tool details (describe) with clear sections */\nfunction formatDescribeOutput(spec: ToolSpec): string {\n  const { name: localName } = parseToolName(spec.name);\n  const scope = getDisplayScope(spec.name, spec.kind, spec.version);\n  const sections: string[] = [];\n\n  sections.push(\"┌─ Tool\");\n  sections.push(`│  name:        ${spec.name}`);\n  sections.push(`│  scope:       ${scope}`);\n  sections.push(`│  localName:   ${localName}`);\n  sections.push(`│  version:     ${spec.version}`);\n  sections.push(`│  kind:        ${spec.kind}`);\n  sections.push(\"├─ Description\");\n  sections.push(`│  ${(spec.description ?? \"(none)\").replace(/\\n/g, \"\\n│  \")}`);\n  sections.push(\"├─ Tags\");\n  sections.push(`│  ${spec.tags?.length ? spec.tags.join(\", \") : \"(none)\"}`);\n  sections.push(\"├─ Capabilities\");\n  sections.push(`│  ${spec.capabilities.join(\", \")}`);\n  if (spec._meta?.hitl?.sideEffect) {\n    sections.push(\"├─ HITL\");\n    sections.push(`│  sideEffect: ${spec._meta.hitl.sideEffect}`);\n  }\n  sections.push(\"├─ Input schema\");\n  sections.push(\n    \"│  \" + JSON.stringify(spec.inputSchema, null, 2).replace(/\\n/g, \"\\n│  \")\n  );\n  sections.push(\"└─ Output schema\");\n  sections.push(\n    \"   \" + JSON.stringify(spec.outputSchema, null, 2).replace(/\\n/g, \"\\n   \")\n  );\n\n  return sections.join(\"\\n\");\n}\n\nasync function cmdLs(pathOpt?: string): Promise<number> {\n  try {\n    const { registry } = getRuntimeWithTools(pathOpt);\n    const specs = registry.snapshot();\n    if (specs.length === 0) {\n      process.stdout.write(\"No tools registered.\\n\");\n      return 0;\n    }\n    specs.sort((a, b) => a.name.localeCompare(b.name));\n    process.stdout.write(formatLsOutput(specs) + \"\\n\");\n    return 0;\n  } catch (err) {\n    process.stderr.write(`ls failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nasync function cmdDescribe(toolName: string, pathOpt?: string): Promise<number> {\n  if (!toolName.trim()) {\n    process.stderr.write(\"Usage: agent-tool describe <tool path>\\n\");\n    return 1;\n  }\n  try {\n    const { registry } = getRuntimeWithTools(pathOpt);\n    const registryName = resolveToolDescriptor(toolName.trim());\n    const spec = registry.get(registryName);\n    if (!spec) {\n      process.stderr.write(`Tool not found: ${toolName}\\n`);\n      return 1;\n    }\n    process.stdout.write(formatDescribeOutput(enrichSpecWithCanonicalSchema(spec)) + \"\\n\");\n    return 0;\n  } catch (err) {\n    process.stderr.write(`describe failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nfunction defaultExecContext(): ExecContext {\n  return {\n    requestId: `cli-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n    taskId: `task-${Date.now()}`,\n    permissions: [\n      \"read:web\",\n      \"read:fs\",\n      \"write:fs\",\n      \"read:db\",\n      \"write:db\",\n      \"network\",\n      \"workflow\",\n      \"danger:destructive\",\n      \"exec\",\n    ],\n  };\n}\n\nasync function cmdRun(toolName: string, toolArgsJson: string, pathOpt?: string): Promise<number> {\n  if (!toolName.trim()) {\n    process.stderr.write(\"Usage: agent-tool run <tool path> [<json params>]\\n\");\n    return 1;\n  }\n  let args: unknown = {};\n  if (toolArgsJson.trim()) {\n    try {\n      args = JSON.parse(toolArgsJson) as unknown;\n    } catch {\n      process.stderr.write(\"Invalid JSON for parameters. Example: '{\\\"path\\\":\\\"README.md\\\"}'\\n\");\n      return 1;\n    }\n  }\n  try {\n    const { runtime, registry } = getRuntimeWithTools(pathOpt);\n    const registryName = resolveToolDescriptor(toolName.trim());\n    if (!registry.get(registryName)) {\n      process.stderr.write(`Tool not found: ${toolName}\\n`);\n      return 1;\n    }\n    const ctx = defaultExecContext();\n    const result = await runtime.invoke(\n      { tool: registryName, args, purpose: \"cli\" },\n      ctx\n    );\n    if (result.ok) {\n      process.stdout.write(JSON.stringify(result.result, null, 2) + \"\\n\");\n      return 0;\n    }\n    process.stderr.write(`Tool error: ${result.error?.kind ?? \"unknown\"} - ${result.error?.message ?? \"\"}\\n`);\n    return 1;\n  } catch (err) {\n    process.stderr.write(`Run failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nasync function cmdStartMcp(pathOpt?: string): Promise<number> {\n  try {\n    const { runtime } = getRuntimeWithTools(pathOpt);\n    await runMCPServerOverStdio(runtime);\n    return 0;\n  } catch (err) {\n    process.stderr.write(`start mcp failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nasync function cmdStartHttp(port: number, host: string, pathOpt?: string): Promise<number> {\n  try {\n    const { runtime } = getRuntimeWithTools(pathOpt);\n    const http = await createHttpService(runtime);\n    const { port: actualPort, host: actualHost } = await http.listen({ port, host });\n    const base = `http://${actualHost}:${actualPort}`;\n    process.stdout.write(`API: ${base}/invoke (POST), ${base}/tools (GET)\\n`);\n    process.stdout.write(`Swagger UI: ${base}/  (spec: ${base}/openapi.json)\\n`);\n    await new Promise<void>(() => {});\n    return 0;\n  } catch (err) {\n    process.stderr.write(`start http failed: ${err instanceof Error ? err.message : String(err)}\\n`);\n    return 1;\n  }\n}\n\nasync function main(argv: string[] = process.argv): Promise<number> {\n  const { command, startSub, help, pathOpt, outDir, include, includeN8n, toolName, toolArgsJson, port, host } =\n    parseArgv(argv);\n\n  if (help || command === \"help\") {\n    printHelp();\n    return 0;\n  }\n\n  if (command === \"init\") return cmdInit(pathOpt);\n  if (command === \"build\") return cmdBuild(pathOpt, outDir, include, includeN8n);\n  if (command === \"serve\") return cmdServe(pathOpt);\n  if (command === \"ls\" || command === \"list\") return cmdLs(pathOpt);\n  if (command === \"describe\" || command === \"show\") return cmdDescribe(toolName, pathOpt);\n  if (command === \"run\") return cmdRun(toolName, toolArgsJson, pathOpt);\n  if (command === \"start\") {\n    if (startSub === \"mcp\") return cmdStartMcp(pathOpt);\n    if (startSub === \"http\") return cmdStartHttp(port, host, pathOpt);\n    process.stderr.write(\"Usage: agent-tool start mcp | agent-tool start http [--port 3000] [--host 127.0.0.1]\\n\");\n    return 1;\n  }\n\n  printHelp();\n  return 1;\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 scriptPath = fileURLToPath(import.meta.url);\nconst invokedPath = process.argv[1];\nlet isMain = typeof process !== \"undefined\" && invokedPath !== undefined && invokedPath === scriptPath;\nif (!isMain && invokedPath) {\n  try {\n    isMain = realpathSync(invokedPath) === realpathSync(scriptPath);\n  } catch {\n    // keep isMain false if realpath fails\n  }\n}\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"]}

package/dist/utils/cli/toolRuntime.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Create a default ToolRegistry + PTCRuntime with no tools registered.
+ * Used by CLI list / show / run. Tools are provided by extensions (e.g. @easynet/agent-tool-builtin-tools).
+ */
+import { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+import { PTCRuntime } from "../../core/runtime/PTCRuntime.js";
+export interface DefaultToolRuntimeOptions {
+    sandboxRoot?: string;
+    allowedHosts?: string[];
+}
+/**
+ * Create PTCRuntime with empty registry. Use for CLI list/show/run when no extension is loaded.
+ * Extensions (e.g. builtin-tools) can register their tools separately.
+ */
+export declare function createDefaultToolRuntime(_options?: DefaultToolRuntimeOptions): {
+    runtime: PTCRuntime;
+    registry: ToolRegistry;
+};
+//# sourceMappingURL=toolRuntime.d.ts.map

package/dist/utils/cli/toolRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRuntime.d.ts","sourceRoot":"","sources":["../../../src/utils/cli/toolRuntime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,GAAE,yBAA8B,GACvC;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,CAIjD"}

package/dist/utils/npmCache.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Framework: resolve an npm package into a local cache folder (like Maven .m2).
+ * Cache root: ~/.agent/cache/, organized by package path and version.
+ * Packs the package, extracts it, runs npm install in that directory so each
+ * downloaded package has its own node_modules—no sharing with the host project—
+ * to avoid package conflicts.
+ */
+export interface EnsurePackageInCacheOptions {
+    /** Custom cache root (default: ~/.agent/cache) */
+    cacheBase?: string;
+    /** Called after npm install; use to add symlinks/aliases in cacheDir/node_modules */
+    afterInstall?: (cacheDir: string, packageName: string) => void;
+}
+/**
+ * Ensure the npm package is in the cache: pack, extract, npm install.
+ * Returns the package root path (with its own node_modules).
+ * Cache layout: ~/.agent/cache/<scope>/<name>/<version>/ (like Maven .m2).
+ */
+export declare function ensurePackageInCache(packageName: string, version?: string, options?: EnsurePackageInCacheOptions): string;
+/**
+ * Resolve the package entry point (main or dist/index.js).
+ */
+export declare function getPackageEntryPath(packageRoot: string): string;
+/**
+ * Dynamic import from a cached package (file URL so Node resolves the package's node_modules).
+ */
+export declare function importFromCache(packageRoot: string): Promise<unknown>;
+//# sourceMappingURL=npmCache.d.ts.map

package/dist/utils/npmCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npmCache.d.ts","sourceRoot":"","sources":["../../src/utils/npmCache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,2BAA2B;IAC1C,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAChE;AA8BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAiB,EAC1B,OAAO,GAAE,2BAAgC,GACxC,MAAM,CA4DR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAY/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI3E"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@easynet/agent-tool",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP build: init → build → run. Turn your project (@tool, SKILL, n8n) into a standalone MCP npm server (no framework embedding, no package conflict).",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "agent-tool": "dist/cli.js"
+    "agent-tool": "dist/utils/cli/index.js"
   },
   "exports": {
     ".": {
@@ -16,25 +16,34 @@
       "require": "./dist/index.cjs"
     },
     "./core": {
-      "types": "./dist/core.d.ts",
-      "import": "./dist/core.js",
-      "require": "./dist/core.cjs"
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.cjs"
+    },
+    "./runtime": {
+      "types": "./dist/core/runtime.d.ts",
+      "import": "./dist/core/runtime.js",
+      "require": "./dist/core/runtime.cjs"
+    },
+    "./api": {
+      "types": "./dist/api/main.d.ts",
+      "import": "./dist/api/main.js",
+      "require": "./dist/api/main.cjs"
     }
   },
   "files": [
-    "dist",
-    "extensions/examples"
+    "dist"
   ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "npx tsup && npx tsc -p tsconfig.dts.json && mkdir -p dist/report && cp src/report/agent-report-template.html dist/report/ && mkdir -p dist/templates && cp src/codegen/templates/*.js dist/templates/",
+    "build": "npx tsup && npx tsc -p tsconfig.dts.json && (mkdir -p dist/templates && cp src/api/expose/mcp-build/templates/*.js dist/templates/ 2>/dev/null || true)",
     "build:ext": "cd extensions/builtin-tools && npm install && npm run build && cd ../example-tools && npm install && npm run build",
     "dev": "npx tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
+    "test": "npm run build && npx tsx test/scripts/ensure-real-packages.ts && node test/scripts/run-vitest.mjs run",
+    "test:watch": "npx tsx test/scripts/ensure-real-packages.ts && node test/scripts/run-vitest.mjs",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist",
     "lint:lines": "./scripts/check-line-count.sh",
@@ -42,7 +51,7 @@
     "deps:tree": "npm ls --all",
     "deps:size": "du -sh node_modules/* 2>/dev/null | sort -hr | head -40",
     "agent": "echo 'Use: npx @easynet/agent-orchestra run \"task\" -c agent.yaml'",
-    "agent:stock": "node extensions/examples/scripts/agent-tool-react-stock.mjs"
+    "agent:stock": "echo 'Use: npx @easynet/agent-orchestra or run your own script'"
   },
   "dependencies": {
     "@easynet/agent-llm": "^1.0.0",

package/dist/chunk-3YLVPZRJ.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/ToolSpec.ts"],"names":[],"mappings":";;;AAwEO,IAAM,oBAAA,GAA+B;AAAA,EAC1C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AAGO,IAAM,qBAAA,GAAgC;AAAA,EAC3C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AA2BO,SAAS,eAAe,IAAA,EAAuC;AACpE,EAAA,MAAM,UAAA,GAAa,KAAK,UAAA,IAAc,MAAA;AACtC,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,OAAA,EAAS,KAAK,OAAA,IAAW,OAAA;AAAA,IACzB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,aAAa,IAAA,CAAK,WAAA;AAAA,IAClB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,WAAA,EAAa,KAAK,WAAA,IAAe,oBAAA;AAAA,IACjC,YAAA,EAAc,KAAK,YAAA,IAAgB,qBAAA;AAAA,IACnC,cAAc,IAAA,CAAK,YAAA;AAAA,IACnB,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,KAAA,EAAO,EAAE,IAAA,EAAM,EAAE,YAAW;AAAE,GAChC;AACF","file":"chunk-3YLVPZRJ.cjs","sourcesContent":["/**\n * Unified tool kinds supported by the tools package.\n */\nexport type ToolKind = \"mcp\" | \"langchain\" | \"n8n\" | \"comfyui\" | \"skill\" | \"core\" | \"example\";\n\n/**\n * Capability declarations for tools.\n * Used by PolicyEngine for permission gating.\n */\nexport type Capability =\n  | \"read:web\"\n  | \"read:fs\"\n  | \"write:fs\"\n  | \"read:db\"\n  | \"write:db\"\n  | \"network\"\n  | \"gpu\"\n  | \"workflow\"\n  | \"danger:destructive\"\n  | \"exec\";\n\n/**\n * HITL (Human-in-the-Loop) side-effect classification.\n * Used to gate execution: external_write / destructive require human approval when onApprovalRequired is set.\n */\nexport type HitlSideEffect = \"none\" | \"local_write\" | \"external_write\" | \"destructive\";\n\n/**\n * Cost hints for tools, used by Budget and routing.\n */\nexport interface CostHints {\n  latencyMsP50?: number;\n  latencyMsP95?: number;\n  isAsync?: boolean;\n}\n\n/**\n * Unified tool specification.\n * All tool types (MCP, LangChain, n8n, SKILL) are described by this interface.\n */\nexport interface ToolSpec {\n  /** Globally unique name, recommended format: namespace/name */\n  name: string;\n  /** Semver version */\n  version: string;\n  /** Tool kind determines which adapter handles execution */\n  kind: ToolKind;\n\n  description?: string;\n  tags?: string[];\n\n  /** JSON Schema for input validation */\n  inputSchema: object;\n  /** JSON Schema for output validation */\n  outputSchema: object;\n\n  /** Required capabilities for this tool */\n  capabilities: Capability[];\n  costHints?: CostHints;\n\n  /** HITL: side-effect level; when external_write/destructive, runtime may require human approval before execute */\n  _meta?: { hitl?: { sideEffect?: HitlSideEffect } };\n\n  /** Adapter-specific: endpoint URL (MCP/n8n) */\n  endpoint?: string;\n  /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */\n  resourceId?: string;\n  /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */\n  impl?: unknown;\n}\n\n/** Default permissive input schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_INPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/** Default permissive output schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_OUTPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/**\n * Minimal options to build a ToolSpec. Use with @effect in JSDoc for HITL sideEffect.\n * Framework fills _meta.hitl.sideEffect from the sideEffect parameter (matches @effect annotation).\n * inputSchema/outputSchema are optional: when omitted, permissive defaults are used (framework supports auto-derived schema at build time in codegen).\n */\nexport interface CreateToolSpecOptions {\n  name: string;\n  version?: string;\n  kind: ToolKind;\n  description?: string;\n  tags?: string[];\n  /** Optional: when omitted, DEFAULT_INPUT_SCHEMA is used. Codegen can derive from handler params. */\n  inputSchema?: object;\n  /** Optional: when omitted, DEFAULT_OUTPUT_SCHEMA is used. Codegen can derive from handler return type. */\n  outputSchema?: object;\n  capabilities: Capability[];\n  costHints?: CostHints;\n  /** HITL: from @effect annotation (none | local_write | external_write | destructive). Default \"none\". */\n  sideEffect?: HitlSideEffect;\n}\n\n/**\n * Build a ToolSpec from minimal options. Use @effect in handler JSDoc as annotation; pass same value as sideEffect.\n * When inputSchema/outputSchema are omitted, permissive defaults are used (schema can be auto-derived at build time).\n */\nexport function createToolSpec(opts: CreateToolSpecOptions): ToolSpec {\n  const sideEffect = opts.sideEffect ?? \"none\";\n  return {\n    name: opts.name,\n    version: opts.version ?? \"1.0.0\",\n    kind: opts.kind,\n    description: opts.description,\n    tags: opts.tags,\n    inputSchema: opts.inputSchema ?? DEFAULT_INPUT_SCHEMA,\n    outputSchema: opts.outputSchema ?? DEFAULT_OUTPUT_SCHEMA,\n    capabilities: opts.capabilities,\n    costHints: opts.costHints,\n    _meta: { hitl: { sideEffect } },\n  };\n}\n\n/**\n * Unified adapter interface.\n * Each protocol adapter (MCP, LangChain, n8n, SKILL) implements this.\n */\nexport interface ToolAdapter {\n  kind: ToolKind;\n  /** Optional: supports dynamic tool discovery */\n  listTools?(): Promise<ToolSpec[]>;\n  /** Execute the tool with validated args */\n  invoke(\n    spec: ToolSpec,\n    args: unknown,\n    ctx: import(\"./ToolIntent.js\").ExecContext,\n  ): Promise<{ result: unknown; raw?: unknown }>;\n}\n"]}

package/dist/chunk-AXUNV4MK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types/ToolSpec.ts"],"names":[],"mappings":";AAwEO,IAAM,oBAAA,GAA+B;AAAA,EAC1C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AAGO,IAAM,qBAAA,GAAgC;AAAA,EAC3C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AA2BO,SAAS,eAAe,IAAA,EAAuC;AACpE,EAAA,MAAM,UAAA,GAAa,KAAK,UAAA,IAAc,MAAA;AACtC,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,OAAA,EAAS,KAAK,OAAA,IAAW,OAAA;AAAA,IACzB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,aAAa,IAAA,CAAK,WAAA;AAAA,IAClB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,WAAA,EAAa,KAAK,WAAA,IAAe,oBAAA;AAAA,IACjC,YAAA,EAAc,KAAK,YAAA,IAAgB,qBAAA;AAAA,IACnC,cAAc,IAAA,CAAK,YAAA;AAAA,IACnB,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,KAAA,EAAO,EAAE,IAAA,EAAM,EAAE,YAAW;AAAE,GAChC;AACF","file":"chunk-AXUNV4MK.js","sourcesContent":["/**\n * Unified tool kinds supported by the tools package.\n */\nexport type ToolKind = \"mcp\" | \"langchain\" | \"n8n\" | \"comfyui\" | \"skill\" | \"core\" | \"example\";\n\n/**\n * Capability declarations for tools.\n * Used by PolicyEngine for permission gating.\n */\nexport type Capability =\n  | \"read:web\"\n  | \"read:fs\"\n  | \"write:fs\"\n  | \"read:db\"\n  | \"write:db\"\n  | \"network\"\n  | \"gpu\"\n  | \"workflow\"\n  | \"danger:destructive\"\n  | \"exec\";\n\n/**\n * HITL (Human-in-the-Loop) side-effect classification.\n * Used to gate execution: external_write / destructive require human approval when onApprovalRequired is set.\n */\nexport type HitlSideEffect = \"none\" | \"local_write\" | \"external_write\" | \"destructive\";\n\n/**\n * Cost hints for tools, used by Budget and routing.\n */\nexport interface CostHints {\n  latencyMsP50?: number;\n  latencyMsP95?: number;\n  isAsync?: boolean;\n}\n\n/**\n * Unified tool specification.\n * All tool types (MCP, LangChain, n8n, SKILL) are described by this interface.\n */\nexport interface ToolSpec {\n  /** Globally unique name, recommended format: namespace/name */\n  name: string;\n  /** Semver version */\n  version: string;\n  /** Tool kind determines which adapter handles execution */\n  kind: ToolKind;\n\n  description?: string;\n  tags?: string[];\n\n  /** JSON Schema for input validation */\n  inputSchema: object;\n  /** JSON Schema for output validation */\n  outputSchema: object;\n\n  /** Required capabilities for this tool */\n  capabilities: Capability[];\n  costHints?: CostHints;\n\n  /** HITL: side-effect level; when external_write/destructive, runtime may require human approval before execute */\n  _meta?: { hitl?: { sideEffect?: HitlSideEffect } };\n\n  /** Adapter-specific: endpoint URL (MCP/n8n) */\n  endpoint?: string;\n  /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */\n  resourceId?: string;\n  /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */\n  impl?: unknown;\n}\n\n/** Default permissive input schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_INPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/** Default permissive output schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_OUTPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/**\n * Minimal options to build a ToolSpec. Use with @effect in JSDoc for HITL sideEffect.\n * Framework fills _meta.hitl.sideEffect from the sideEffect parameter (matches @effect annotation).\n * inputSchema/outputSchema are optional: when omitted, permissive defaults are used (framework supports auto-derived schema at build time in codegen).\n */\nexport interface CreateToolSpecOptions {\n  name: string;\n  version?: string;\n  kind: ToolKind;\n  description?: string;\n  tags?: string[];\n  /** Optional: when omitted, DEFAULT_INPUT_SCHEMA is used. Codegen can derive from handler params. */\n  inputSchema?: object;\n  /** Optional: when omitted, DEFAULT_OUTPUT_SCHEMA is used. Codegen can derive from handler return type. */\n  outputSchema?: object;\n  capabilities: Capability[];\n  costHints?: CostHints;\n  /** HITL: from @effect annotation (none | local_write | external_write | destructive). Default \"none\". */\n  sideEffect?: HitlSideEffect;\n}\n\n/**\n * Build a ToolSpec from minimal options. Use @effect in handler JSDoc as annotation; pass same value as sideEffect.\n * When inputSchema/outputSchema are omitted, permissive defaults are used (schema can be auto-derived at build time).\n */\nexport function createToolSpec(opts: CreateToolSpecOptions): ToolSpec {\n  const sideEffect = opts.sideEffect ?? \"none\";\n  return {\n    name: opts.name,\n    version: opts.version ?? \"1.0.0\",\n    kind: opts.kind,\n    description: opts.description,\n    tags: opts.tags,\n    inputSchema: opts.inputSchema ?? DEFAULT_INPUT_SCHEMA,\n    outputSchema: opts.outputSchema ?? DEFAULT_OUTPUT_SCHEMA,\n    capabilities: opts.capabilities,\n    costHints: opts.costHints,\n    _meta: { hitl: { sideEffect } },\n  };\n}\n\n/**\n * Unified adapter interface.\n * Each protocol adapter (MCP, LangChain, n8n, SKILL) implements this.\n */\nexport interface ToolAdapter {\n  kind: ToolKind;\n  /** Optional: supports dynamic tool discovery */\n  listTools?(): Promise<ToolSpec[]>;\n  /** Execute the tool with validated args */\n  invoke(\n    spec: ToolSpec,\n    args: unknown,\n    ctx: import(\"./ToolIntent.js\").ExecContext,\n  ): Promise<{ result: unknown; raw?: unknown }>;\n}\n"]}