@easynet/agent-tool 1.0.53 → 1.0.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,353 @@
1
+ 'use strict';
2
+
3
+ var chunkD2T3NTFN_cjs = require('./chunk-D2T3NTFN.cjs');
4
+ var fs2 = require('fs/promises');
5
+ var path3 = require('path');
6
+ var url = require('url');
7
+ var child_process = require('child_process');
8
+
9
+ var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
10
+ function _interopNamespace(e) {
11
+ if (e && e.__esModule) return e;
12
+ var n = Object.create(null);
13
+ if (e) {
14
+ Object.keys(e).forEach(function (k) {
15
+ if (k !== 'default') {
16
+ var d = Object.getOwnPropertyDescriptor(e, k);
17
+ Object.defineProperty(n, k, d.get ? d : {
18
+ enumerable: true,
19
+ get: function () { return e[k]; }
20
+ });
21
+ }
22
+ });
23
+ }
24
+ n.default = e;
25
+ return Object.freeze(n);
26
+ }
27
+
28
+ var fs2__namespace = /*#__PURE__*/_interopNamespace(fs2);
29
+ var path3__namespace = /*#__PURE__*/_interopNamespace(path3);
30
+
31
+ var TEMPLATES = {
32
+ "package.json": `{
33
+ "name": "my-mcp-tools",
34
+ "version": "1.0.0",
35
+ "private": true,
36
+ "type": "module",
37
+ "scripts": {
38
+ "build": "node build.mjs",
39
+ "start": "node start.mjs"
40
+ },
41
+ "devDependencies": {
42
+ "@easynet/agent-tool": "latest"
43
+ }
44
+ }
45
+ `,
46
+ "build.mjs": `import { buildMcpPackage } from "@easynet/agent-tool";
47
+
48
+ const result = await buildMcpPackage({ outDir: "dist" });
49
+ console.log("Built", result.toolCount, "tool(s) ->", result.outDir);
50
+ `,
51
+ "start.mjs": `import { runMcpServer } from "@easynet/agent-tool";
52
+
53
+ const { process: child } = await runMcpServer({ path: "./dist" });
54
+ child.stdin?.pipe(process.stdin);
55
+ child.stdout?.pipe(process.stdout);
56
+ child.stderr?.pipe(process.stderr);
57
+ process.stdin?.ref();
58
+ child.on("close", (code) => process.exit(code ?? 0));
59
+ `,
60
+ "tsconfig.json": `{
61
+ "compilerOptions": {
62
+ "target": "ES2022",
63
+ "module": "ESNext",
64
+ "strict": true,
65
+ "skipLibCheck": true,
66
+ "noEmit": true
67
+ },
68
+ "include": ["src/**/*.ts"]
69
+ }
70
+ `,
71
+ "src/tools/example.ts": `/**
72
+ * Add two numbers.
73
+ * @tool
74
+ */
75
+ export async function add(a: number, b: number): Promise<number> {
76
+ return a + b;
77
+ }
78
+ `,
79
+ "skills/hello-skill/SKILL.md": `---
80
+ name: hello-skill
81
+ description: Say hello with a name.
82
+ ---
83
+
84
+ # Hello Skill
85
+
86
+ Returns a greeting for the given name.
87
+ `,
88
+ "skills/hello-skill/handler.js": `export default async function handler(args, ctx) {
89
+ const name = args?.name ?? "World";
90
+ return { message: \`Hello, \${name}!\` };
91
+ }
92
+ `,
93
+ "README.md": `# MCP Tool Project
94
+
95
+ Scaffolded by \`agent-tool init\`. Workflow:
96
+
97
+ 1. **init** \u2014 create project template (you are here)
98
+ 2. **npm install** \u2014 install dependencies
99
+ 3. **npm run build** \u2014 generate MCP package under \`dist/\`
100
+ 4. **npm start** \u2014 start the MCP server for testing
101
+
102
+ ## Quick start
103
+
104
+ \`\`\`bash
105
+ npm install
106
+ npm run build
107
+ npm start
108
+ \`\`\`
109
+
110
+ Edit \`src/tools/*.ts\` (add \`@tool\` JSDoc) and/or \`skills/*/SKILL.md\`, then \`npm run build\` again.
111
+ `
112
+ };
113
+ async function initProject(options = {}) {
114
+ const targetPath = path3__namespace.resolve(options.targetPath ?? process.cwd());
115
+ const filesCreated = [];
116
+ await fs2__namespace.mkdir(targetPath, { recursive: true });
117
+ for (const [relPath, content] of Object.entries(TEMPLATES)) {
118
+ const fullPath = path3__namespace.join(targetPath, relPath);
119
+ await fs2__namespace.mkdir(path3__namespace.dirname(fullPath), { recursive: true });
120
+ try {
121
+ await fs2__namespace.access(fullPath);
122
+ if (relPath === "package.json") continue;
123
+ } catch {
124
+ }
125
+ await fs2__namespace.writeFile(fullPath, content, "utf8");
126
+ filesCreated.push(relPath);
127
+ }
128
+ return { targetPath, filesCreated };
129
+ }
130
+ async function scanForAllTools(projectPath, options = {}) {
131
+ const include = options.include ?? ["**/*.ts"];
132
+ const tsconfigPath = options.tsconfigPath;
133
+ const includeN8n = options.includeN8n === true;
134
+ const opts = { include, tsconfigPath };
135
+ const results = await Promise.all([
136
+ chunkD2T3NTFN_cjs.discoverTools("function", projectPath, opts),
137
+ chunkD2T3NTFN_cjs.discoverTools("skill", projectPath, opts),
138
+ ...includeN8n ? [chunkD2T3NTFN_cjs.discoverTools("n8n", projectPath, opts)] : []
139
+ ]);
140
+ const specs = results.flatMap((r) => r.specs);
141
+ const errors = results.flatMap((r) => r.errors);
142
+ const warnings = results.flatMap((r) => r.warnings ?? []);
143
+ return { specs, errors, warnings };
144
+ }
145
+ var __dirname$1 = path3__namespace.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-TFT4RYFZ.cjs', document.baseURI).href))));
146
+ async function loadTemplate(name) {
147
+ for (const dir of [
148
+ path3__namespace.join(__dirname$1, "templates"),
149
+ path3__namespace.join(__dirname$1, "..", "templates")
150
+ ]) {
151
+ try {
152
+ return await fs2__namespace.readFile(path3__namespace.join(dir, name), "utf-8");
153
+ } catch {
154
+ continue;
155
+ }
156
+ }
157
+ throw new Error(`Template not found: ${name}. Tried templates/ next to generator and ../templates.`);
158
+ }
159
+ var TEMPLATE_NAMES = {
160
+ mcpServer: "mcp-server.js",
161
+ toolIndex: "tool-index.js",
162
+ skillInvoker: "skill-invoker.js",
163
+ n8nInvoker: "n8n-invoker.js"
164
+ };
165
+ function buildToolIndexCases(specs, fromGeneratedToProject) {
166
+ return specs.map((s) => {
167
+ const modPath = path3__namespace.join(fromGeneratedToProject, s._meta.sourcePath).replace(/\\/g, "/");
168
+ return ` case "${s.name}": return (await import("${modPath}")).${s._meta.exportName};`;
169
+ }).join("\n");
170
+ }
171
+ function buildSkillInvokerCases(specs, fromGeneratedToProject) {
172
+ return specs.map((s) => {
173
+ const handlerPath = path3__namespace.join(fromGeneratedToProject, s._meta.sourcePath, "handler").replace(/\\/g, "/");
174
+ const descEscaped = (s.description ?? "").replace(/"/g, '\\"');
175
+ return ` case "${s.name}": {
176
+ const mod = await import("${handlerPath}.js")
177
+ .catch(() => import("${handlerPath}.mjs"))
178
+ .catch(() => null);
179
+ if (!mod) return { result: null, error: "No handler" };
180
+ const fn = mod.default ?? mod.handler;
181
+ if (typeof fn !== "function") return { result: null, error: "No handler" };
182
+ const ctx = { requestId: "mcp", taskId: "mcp", skill: { name: "${s.name}", description: "${descEscaped}", instructions: "", resources: [], readResource: async () => "", getResourcesByType: () => [], dirPath: "" } };
183
+ const out = await fn(args, ctx);
184
+ return out?.result !== undefined ? out.result : out;
185
+ }`;
186
+ }).join("\n");
187
+ }
188
+ function buildN8nInvokerCases(specs) {
189
+ return specs.map((s) => {
190
+ const webhookUrl = s.endpoint;
191
+ const url = webhookUrl ? `"${webhookUrl}"` : "process.env.N8N_WEBHOOK_" + s.name.replace(/[^a-zA-Z0-9]/g, "_").toUpperCase() + " ?? null";
192
+ return ` case "${s.name}": {
193
+ const url = ${url};
194
+ if (!url) throw new Error("n8n webhook not configured for ${s.name}. Set N8N_WEBHOOK_* or add webhook to workflow.");
195
+ const res = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(args) });
196
+ if (!res.ok) throw new Error("n8n request failed: " + res.status);
197
+ return res.json().catch(() => ({}));
198
+ }`;
199
+ }).join("\n");
200
+ }
201
+ async function generate(options) {
202
+ const { specs, outDir, projectPath } = options;
203
+ await fs2__namespace.mkdir(outDir, { recursive: true });
204
+ const functionSpecs = specs.filter(
205
+ (s) => s.kind === chunkD2T3NTFN_cjs.FUNCTION_KIND && s._meta?.sourcePath != null && s._meta?.exportName != null
206
+ );
207
+ const skillSpecs = specs.filter(
208
+ (s) => s.kind === chunkD2T3NTFN_cjs.SKILL_KIND && s._meta?.sourcePath != null
209
+ );
210
+ const n8nSpecs = specs.filter((s) => s.kind === chunkD2T3NTFN_cjs.N8N_KIND);
211
+ const toolSpecsJson = specs.map((s) => ({
212
+ kind: s.kind,
213
+ name: s.name,
214
+ description: s.description,
215
+ inputSchema: s.inputSchema,
216
+ ...s.kind === chunkD2T3NTFN_cjs.FUNCTION_KIND && s._meta?.sourcePath != null && s._meta?.exportName != null && {
217
+ outputSchema: s.outputSchema ?? { type: "object", additionalProperties: true },
218
+ sourcePath: s._meta.sourcePath,
219
+ exportName: s._meta.exportName
220
+ },
221
+ _meta: s._meta,
222
+ ...s.kind === chunkD2T3NTFN_cjs.SKILL_KIND && s._meta?.sourcePath != null && { sourcePath: s._meta.sourcePath },
223
+ ...s.kind === chunkD2T3NTFN_cjs.N8N_KIND && {
224
+ sourcePath: s._meta?.sourcePath,
225
+ webhookUrl: s.endpoint
226
+ }
227
+ }));
228
+ await fs2__namespace.writeFile(
229
+ path3__namespace.join(outDir, "tool-specs.json"),
230
+ JSON.stringify(toolSpecsJson, null, 2),
231
+ "utf-8"
232
+ );
233
+ const configJson = { projectPath: path3__namespace.resolve(projectPath) };
234
+ await fs2__namespace.writeFile(path3__namespace.join(outDir, "config.json"), JSON.stringify(configJson, null, 2), "utf-8");
235
+ const rel = path3__namespace.relative(outDir, projectPath) || ".";
236
+ const fromGeneratedToProject = rel.split(path3__namespace.sep).length ? rel : ".";
237
+ const [mcpServerTemplate, toolIndexTemplate, skillInvokerTemplate, n8nInvokerTemplate] = await Promise.all([
238
+ loadTemplate(TEMPLATE_NAMES.mcpServer),
239
+ loadTemplate(TEMPLATE_NAMES.toolIndex),
240
+ loadTemplate(TEMPLATE_NAMES.skillInvoker),
241
+ loadTemplate(TEMPLATE_NAMES.n8nInvoker)
242
+ ]);
243
+ const toolIndexTs = toolIndexTemplate.replace("{{CASES}}", buildToolIndexCases(functionSpecs, fromGeneratedToProject));
244
+ await fs2__namespace.writeFile(path3__namespace.join(outDir, "tool-index.ts"), toolIndexTs, "utf-8");
245
+ const skillCases = buildSkillInvokerCases(skillSpecs, fromGeneratedToProject);
246
+ const skillDefaultCase = skillSpecs.length === 0 ? "default: throw new Error('Unknown skill: ' + name);" : 'default: throw new Error("Unknown skill: " + name);';
247
+ const skillInvokerTs = skillInvokerTemplate.replace("{{CASES}}", skillCases).replace("{{DEFAULT_CASE}}", skillDefaultCase);
248
+ await fs2__namespace.writeFile(path3__namespace.join(outDir, "skill-invoker.ts"), skillInvokerTs, "utf-8");
249
+ const n8nCases = buildN8nInvokerCases(n8nSpecs);
250
+ const n8nDefaultCase = n8nSpecs.length === 0 ? "default: throw new Error('Unknown n8n tool: ' + name);" : 'default: throw new Error("Unknown n8n tool: " + name);';
251
+ const n8nInvokerTs = n8nInvokerTemplate.replace("{{CASES}}", n8nCases).replace("{{DEFAULT_CASE}}", n8nDefaultCase);
252
+ await fs2__namespace.writeFile(path3__namespace.join(outDir, "n8n-invoker.ts"), n8nInvokerTs, "utf-8");
253
+ await fs2__namespace.writeFile(path3__namespace.join(outDir, "mcp-server.ts"), mcpServerTemplate, "utf-8");
254
+ const mcpJson = {
255
+ command: "npx",
256
+ args: ["-y", "tsx", path3__namespace.join(outDir, "mcp-server.ts")]
257
+ };
258
+ await fs2__namespace.writeFile(path3__namespace.join(outDir, "mcp.json"), JSON.stringify(mcpJson, null, 2), "utf-8");
259
+ const packageJson = {
260
+ name: "function-tools-mcp",
261
+ version: "1.0.0",
262
+ type: "module",
263
+ description: "MCP server generated from @tool functions, SKILL.md, and workflow.json",
264
+ main: "mcp-server.ts",
265
+ scripts: { start: "npx tsx mcp-server.ts" },
266
+ dependencies: {
267
+ "@modelcontextprotocol/sdk": "^1.25.3",
268
+ typescript: ">=5.0.0",
269
+ tsx: ">=4.0.0"
270
+ }
271
+ };
272
+ await fs2__namespace.writeFile(path3__namespace.join(outDir, "package.json"), JSON.stringify(packageJson, null, 2), "utf-8");
273
+ return {
274
+ entryPath: path3__namespace.join(outDir, "mcp-server.ts"),
275
+ mcpJsonPath: path3__namespace.join(outDir, "mcp.json")
276
+ };
277
+ }
278
+
279
+ // src/api/expose/mcp-build/build.ts
280
+ async function buildMcpPackage(options = {}) {
281
+ const projectPath = path3__namespace.resolve(options.projectPath ?? process.cwd());
282
+ const outDir = path3__namespace.resolve(projectPath, options.outDir ?? "dist");
283
+ const include = options.include ?? ["**/*.ts"];
284
+ const tsconfigPath = options.tsconfigPath;
285
+ const scanResult = await scanForAllTools(projectPath, {
286
+ include,
287
+ tsconfigPath,
288
+ includeN8n: options.includeN8n
289
+ });
290
+ if (scanResult.errors.length > 0) {
291
+ const msg = scanResult.errors.map((e) => `${e.file}: ${e.message}`).join("; ");
292
+ throw new Error(`Scan failed: ${msg}`);
293
+ }
294
+ const allSpecs = scanResult.specs;
295
+ if (allSpecs.length === 0) {
296
+ throw new Error(
297
+ "No tools found. Add @tool functions (JSDoc), SKILL.md directories, or workflow.json directories."
298
+ );
299
+ }
300
+ const { entryPath, mcpJsonPath } = await generate({
301
+ specs: allSpecs,
302
+ outDir,
303
+ projectPath
304
+ });
305
+ return {
306
+ outDir,
307
+ toolCount: allSpecs.length,
308
+ entryPath,
309
+ mcpJsonPath
310
+ };
311
+ }
312
+ var buildFunctionToTool = buildMcpPackage;
313
+ async function runMcpServer(options = {}) {
314
+ const base = options.path ?? process.cwd();
315
+ const candidates = [
316
+ path3__namespace.join(base, "mcp-server.ts"),
317
+ path3__namespace.join(base, "mcp-server.js"),
318
+ path3__namespace.join(base, "dist", "mcp-server.ts"),
319
+ path3__namespace.join(base, "dist", "mcp-server.js"),
320
+ path3__namespace.join(base, "generated", "mcp-server.ts"),
321
+ path3__namespace.join(base, "generated", "mcp-server.js")
322
+ ];
323
+ let entry = "";
324
+ for (const p of candidates) {
325
+ try {
326
+ await fs2__namespace.access(p);
327
+ entry = p;
328
+ break;
329
+ } catch {
330
+ }
331
+ }
332
+ if (!entry) {
333
+ throw new Error(
334
+ `MCP entrypoint not found. Run "agent-tool build" first, or pass --path to a directory containing mcp-server.ts. Tried: ${candidates.join(", ")}`
335
+ );
336
+ }
337
+ const dir = path3__namespace.dirname(entry);
338
+ const child = child_process.spawn("npx", ["-y", "tsx", path3__namespace.basename(entry)], {
339
+ cwd: dir,
340
+ stdio: ["pipe", "pipe", "inherit"],
341
+ shell: false
342
+ });
343
+ return { process: child };
344
+ }
345
+ var runGeneratedMCP = runMcpServer;
346
+
347
+ exports.buildFunctionToTool = buildFunctionToTool;
348
+ exports.buildMcpPackage = buildMcpPackage;
349
+ exports.initProject = initProject;
350
+ exports.runGeneratedMCP = runGeneratedMCP;
351
+ exports.runMcpServer = runMcpServer;
352
+ //# sourceMappingURL=chunk-TFT4RYFZ.cjs.map
353
+ //# sourceMappingURL=chunk-TFT4RYFZ.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/api/expose/mcp-build/init.ts","../src/tools/scanPackage.ts","../src/api/expose/mcp-build/generator.ts","../src/api/expose/mcp-build/build.ts","../src/api/expose/mcp-build/run.ts"],"names":["path","fs","discoverTools","__dirname","path3","fileURLToPath","fs2","FUNCTION_KIND","SKILL_KIND","N8N_KIND","path4","path5","fs3","spawn"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,IAAM,SAAA,GAAY;AAAA,EAChB,cAAA,EAAgB,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAAA,EAchB,WAAA,EAAa,CAAA;;AAAA;AAAA;AAAA,CAAA;AAAA,EAKb,WAAA,EAAa,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAAA,EASb,eAAA,EAAiB,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAAA,EAWjB,sBAAA,EAAwB,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAAA,EAQxB,6BAAA,EAA+B,CAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA,CAAA;AAAA,EAS/B,+BAAA,EAAiC,CAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAAA,EAKjC,WAAA,EAAa,CAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAmBf,CAAA;AAMA,eAAsB,WAAA,CAAY,OAAA,GAAuB,EAAC,EAA4D;AACpH,EAAA,MAAM,aAAkBA,gBAAA,CAAA,OAAA,CAAQ,OAAA,CAAQ,UAAA,IAAc,OAAA,CAAQ,KAAK,CAAA;AACnE,EAAA,MAAM,eAAyB,EAAC;AAEhC,EAAA,MAASC,cAAA,CAAA,KAAA,CAAM,UAAA,EAAY,EAAE,SAAA,EAAW,MAAM,CAAA;AAE9C,EAAA,KAAA,MAAW,CAAC,OAAA,EAAS,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,SAAS,CAAA,EAAG;AAC1D,IAAA,MAAM,QAAA,GAAgBD,gBAAA,CAAA,IAAA,CAAK,UAAA,EAAY,OAAO,CAAA;AAC9C,IAAA,MAASC,qBAAWD,gBAAA,CAAA,OAAA,CAAQ,QAAQ,GAAG,EAAE,SAAA,EAAW,MAAM,CAAA;AAC1D,IAAA,IAAI;AACF,MAAA,MAASC,sBAAO,QAAQ,CAAA;AACxB,MAAA,IAAI,YAAY,cAAA,EAAgB;AAAA,IAClC,CAAA,CAAA,MAAQ;AAAA,IAER;AACA,IAAA,MAASA,cAAA,CAAA,SAAA,CAAU,QAAA,EAAU,OAAA,EAAS,MAAM,CAAA;AAC5C,IAAA,YAAA,CAAa,KAAK,OAAO,CAAA;AAAA,EAC3B;AAEA,EAAA,OAAO,EAAE,YAAY,YAAA,EAAa;AACpC;AC/FA,eAAsB,eAAA,CACpB,WAAA,EACA,OAAA,GAA+B,EAAC,EACH;AAC7B,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,OAAA,IAAW,CAAC,SAAS,CAAA;AAC7C,EAAA,MAAM,eAAe,OAAA,CAAQ,YAAA;AAC7B,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,KAAe,IAAA;AAC1C,EAAA,MAAM,IAAA,GAA6B,EAAE,OAAA,EAAS,YAAA,EAAa;AAE3D,EAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,GAAA,CAAI;AAAA,IAChCC,+BAAA,CAAc,UAAA,EAAY,WAAA,EAAa,IAAI,CAAA;AAAA,IAC3CA,+BAAA,CAAc,OAAA,EAAS,WAAA,EAAa,IAAI,CAAA;AAAA,IACxC,GAAI,aAAa,CAACA,+BAAA,CAAc,OAAO,WAAA,EAAa,IAAI,CAAC,CAAA,GAAI;AAAC,GAC/D,CAAA;AACD,EAAA,MAAM,QAAQ,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAA,KAAM,EAAE,KAAK,CAAA;AAC5C,EAAA,MAAM,SAAS,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAA,KAAM,EAAE,MAAM,CAAA;AAC9C,EAAA,MAAM,QAAA,GAAW,QAAQ,OAAA,CAAQ,CAAC,MAAM,CAAA,CAAE,QAAA,IAAY,EAAE,CAAA;AAExD,EAAA,OAAO,EAAE,KAAA,EAAO,MAAA,EAAQ,QAAA,EAAS;AACnC;AC/BA,IAAMC,WAAA,GAAiBC,gBAAA,CAAA,OAAA,CAAQC,iBAAA,CAAc,oQAAe,CAAC,CAAA;AAqB7D,eAAe,aAAa,IAAA,EAA+B;AACzD,EAAA,KAAA,MAAW,GAAA,IAAO;AAAA,IACXD,gBAAA,CAAA,IAAA,CAAKD,aAAW,WAAW,CAAA;AAAA,IAC3BC,gBAAA,CAAA,IAAA,CAAKD,WAAA,EAAW,IAAA,EAAM,WAAW;AAAA,GACxC,EAAG;AACD,IAAA,IAAI;AACF,MAAA,OAAO,MAASG,cAAA,CAAA,QAAA,CAAcF,gBAAA,CAAA,IAAA,CAAK,GAAA,EAAK,IAAI,GAAG,OAAO,CAAA;AAAA,IACxD,CAAA,CAAA,MAAQ;AACN,MAAA;AAAA,IACF;AAAA,EACF;AACA,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,IAAI,CAAA,sDAAA,CAAwD,CAAA;AACrG;AAEA,IAAM,cAAA,GAAiB;AAAA,EACrB,SAAA,EAAW,eAAA;AAAA,EACX,SAAA,EAAW,eAAA;AAAA,EACX,YAAA,EAAc,kBAAA;AAAA,EACd,UAAA,EAAY;AACd,CAAA;AAEA,SAAS,mBAAA,CAAoB,OAAiC,sBAAA,EAAwC;AACpG,EAAA,OAAO,KAAA,CACJ,GAAA,CAAI,CAAC,CAAA,KAAM;AACV,IAAA,MAAM,OAAA,GAAeA,sBAAK,sBAAA,EAAwB,CAAA,CAAE,MAAM,UAAU,CAAA,CAAE,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA;AACxF,IAAA,OAAO,CAAA,UAAA,EAAa,EAAE,IAAI,CAAA,yBAAA,EAA4B,OAAO,CAAA,IAAA,EAAO,CAAA,CAAE,MAAM,UAAU,CAAA,CAAA,CAAA;AAAA,EACxF,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AACd;AAEA,SAAS,sBAAA,CAAuB,OAA8B,sBAAA,EAAwC;AACpG,EAAA,OAAO,KAAA,CACJ,GAAA,CAAI,CAAC,CAAA,KAAM;AACV,IAAA,MAAM,WAAA,GAAmBA,gBAAA,CAAA,IAAA,CAAK,sBAAA,EAAwB,CAAA,CAAE,KAAA,CAAM,YAAY,SAAS,CAAA,CAAE,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA;AACvG,IAAA,MAAM,eAAe,CAAA,CAAE,WAAA,IAAe,EAAA,EAAI,OAAA,CAAQ,MAAM,KAAK,CAAA;AAC7D,IAAA,OAAO,CAAA,UAAA,EAAa,EAAE,IAAI,CAAA;AAAA,gCAAA,EACE,WAAW,CAAA;AAAA,6BAAA,EACd,WAAW,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qEAAA,EAK6B,CAAA,CAAE,IAAI,CAAA,iBAAA,EAAoB,WAAW,CAAA;AAAA;AAAA;AAAA,KAAA,CAAA;AAAA,EAIxG,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AACd;AAEA,SAAS,qBAAqB,KAAA,EAAoC;AAChE,EAAA,OAAO,KAAA,CACJ,GAAA,CAAI,CAAC,CAAA,KAAM;AACV,IAAA,MAAM,aAAa,CAAA,CAAE,QAAA;AACrB,IAAA,MAAM,GAAA,GACJ,UAAA,GACI,CAAA,CAAA,EAAI,UAAU,CAAA,CAAA,CAAA,GACd,0BAAA,GAA6B,CAAA,CAAE,IAAA,CAAK,OAAA,CAAQ,eAAA,EAAiB,GAAG,CAAA,CAAE,aAAY,GAAI,UAAA;AACxF,IAAA,OAAO,CAAA,UAAA,EAAa,EAAE,IAAI,CAAA;AAAA,kBAAA,EACZ,GAAG,CAAA;AAAA,gEAAA,EAC2C,EAAE,IAAI,CAAA;AAAA;AAAA;AAAA;AAAA,KAAA,CAAA;AAAA,EAKpE,CAAC,CAAA,CACA,IAAA,CAAK,IAAI,CAAA;AACd;AAGA,eAAsB,SAAS,OAAA,EAIyB;AACtD,EAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,WAAA,EAAY,GAAI,OAAA;AACvC,EAAA,MAASE,cAAA,CAAA,KAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AAE1C,EAAA,MAAM,gBAAgB,KAAA,CAAM,MAAA;AAAA,IAC1B,CAAC,CAAA,KACC,CAAA,CAAE,IAAA,KAASC,+BAAA,IAAiB,CAAA,CAAE,KAAA,EAAO,UAAA,IAAc,IAAA,IAAQ,CAAA,CAAE,KAAA,EAAO,UAAA,IAAc;AAAA,GACtF;AACA,EAAA,MAAM,aAAa,KAAA,CAAM,MAAA;AAAA,IACvB,CAAC,CAAA,KAAgC,CAAA,CAAE,SAASC,4BAAA,IAAc,CAAA,CAAE,OAAO,UAAA,IAAc;AAAA,GACnF;AACA,EAAA,MAAM,WAAW,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAA8B,CAAA,CAAE,SAASC,0BAAQ,CAAA;AAEhF,EAAA,MAAM,aAAA,GAAgB,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,IACtC,MAAM,CAAA,CAAE,IAAA;AAAA,IACR,MAAM,CAAA,CAAE,IAAA;AAAA,IACR,aAAa,CAAA,CAAE,WAAA;AAAA,IACf,aAAa,CAAA,CAAE,WAAA;AAAA,IACf,GAAI,CAAA,CAAE,IAAA,KAASF,+BAAA,IAAiB,CAAA,CAAE,KAAA,EAAO,UAAA,IAAc,IAAA,IAAQ,CAAA,CAAE,KAAA,EAAO,UAAA,IAAc,IAAA,IAAQ;AAAA,MAC5F,cAAc,CAAA,CAAE,YAAA,IAAgB,EAAE,IAAA,EAAM,QAAA,EAAU,sBAAsB,IAAA,EAAK;AAAA,MAC7E,UAAA,EAAY,EAAE,KAAA,CAAM,UAAA;AAAA,MACpB,UAAA,EAAY,EAAE,KAAA,CAAM;AAAA,KACtB;AAAA,IACA,OAAO,CAAA,CAAE,KAAA;AAAA,IACT,GAAI,CAAA,CAAE,IAAA,KAASC,4BAAA,IAAc,CAAA,CAAE,KAAA,EAAO,UAAA,IAAc,IAAA,IAAQ,EAAE,UAAA,EAAY,CAAA,CAAE,KAAA,CAAM,UAAA,EAAW;AAAA,IAC7F,GAAI,CAAA,CAAE,IAAA,KAASC,0BAAA,IAAY;AAAA,MACzB,UAAA,EAAY,EAAE,KAAA,EAAO,UAAA;AAAA,MACrB,YAAY,CAAA,CAAE;AAAA;AAChB,GACF,CAAE,CAAA;AACF,EAAA,MAASH,cAAA,CAAA,SAAA;AAAA,IACFF,gBAAA,CAAA,IAAA,CAAK,QAAQ,iBAAiB,CAAA;AAAA,IACnC,IAAA,CAAK,SAAA,CAAU,aAAA,EAAe,IAAA,EAAM,CAAC,CAAA;AAAA,IACrC;AAAA,GACF;AAEA,EAAA,MAAM,UAAA,GAAa,EAAE,WAAA,EAAkBA,gBAAA,CAAA,OAAA,CAAQ,WAAW,CAAA,EAAE;AAC5D,EAAA,MAASE,cAAA,CAAA,SAAA,CAAeF,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,aAAa,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,UAAA,EAAY,IAAA,EAAM,CAAC,CAAA,EAAG,OAAO,CAAA;AAEjG,EAAA,MAAM,GAAA,GAAWA,gBAAA,CAAA,QAAA,CAAS,MAAA,EAAQ,WAAW,CAAA,IAAK,GAAA;AAClD,EAAA,MAAM,yBAAyB,GAAA,CAAI,KAAA,CAAWA,gBAAA,CAAA,GAAG,CAAA,CAAE,SAAS,GAAA,GAAM,GAAA;AAElE,EAAA,MAAM,CAAC,mBAAmB,iBAAA,EAAmB,oBAAA,EAAsB,kBAAkB,CAAA,GAAI,MAAM,QAAQ,GAAA,CAAI;AAAA,IACzG,YAAA,CAAa,eAAe,SAAS,CAAA;AAAA,IACrC,YAAA,CAAa,eAAe,SAAS,CAAA;AAAA,IACrC,YAAA,CAAa,eAAe,YAAY,CAAA;AAAA,IACxC,YAAA,CAAa,eAAe,UAAU;AAAA,GACvC,CAAA;AAED,EAAA,MAAM,cAAc,iBAAA,CAAkB,OAAA,CAAQ,aAAa,mBAAA,CAAoB,aAAA,EAAe,sBAAsB,CAAC,CAAA;AACrH,EAAA,MAASE,yBAAeF,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,eAAe,CAAA,EAAG,aAAa,OAAO,CAAA;AAE3E,EAAA,MAAM,UAAA,GAAa,sBAAA,CAAuB,UAAA,EAAY,sBAAsB,CAAA;AAC5E,EAAA,MAAM,gBAAA,GACJ,UAAA,CAAW,MAAA,KAAW,CAAA,GAAI,qDAAA,GAAwD,qDAAA;AACpF,EAAA,MAAM,cAAA,GAAiB,qBAAqB,OAAA,CAAQ,WAAA,EAAa,UAAU,CAAA,CAAE,OAAA,CAAQ,oBAAoB,gBAAgB,CAAA;AACzH,EAAA,MAASE,yBAAeF,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,kBAAkB,CAAA,EAAG,gBAAgB,OAAO,CAAA;AAEjF,EAAA,MAAM,QAAA,GAAW,qBAAqB,QAAQ,CAAA;AAC9C,EAAA,MAAM,cAAA,GACJ,QAAA,CAAS,MAAA,KAAW,CAAA,GAAI,wDAAA,GAA2D,wDAAA;AACrF,EAAA,MAAM,YAAA,GAAe,mBAAmB,OAAA,CAAQ,WAAA,EAAa,QAAQ,CAAA,CAAE,OAAA,CAAQ,oBAAoB,cAAc,CAAA;AACjH,EAAA,MAASE,yBAAeF,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,gBAAgB,CAAA,EAAG,cAAc,OAAO,CAAA;AAE7E,EAAA,MAASE,yBAAeF,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,eAAe,CAAA,EAAG,mBAAmB,OAAO,CAAA;AAEjF,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,OAAA,EAAS,KAAA;AAAA,IACT,MAAM,CAAC,IAAA,EAAM,OAAYA,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,eAAe,CAAC;AAAA,GACxD;AACA,EAAA,MAASE,cAAA,CAAA,SAAA,CAAeF,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,UAAU,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA,EAAG,OAAO,CAAA;AAE3F,EAAA,MAAM,WAAA,GAAc;AAAA,IAClB,IAAA,EAAM,oBAAA;AAAA,IACN,OAAA,EAAS,OAAA;AAAA,IACT,IAAA,EAAM,QAAA;AAAA,IACN,WAAA,EAAa,wEAAA;AAAA,IACb,IAAA,EAAM,eAAA;AAAA,IACN,OAAA,EAAS,EAAE,KAAA,EAAO,uBAAA,EAAwB;AAAA,IAC1C,YAAA,EAAc;AAAA,MACZ,2BAAA,EAA6B,SAAA;AAAA,MAC7B,UAAA,EAAY,SAAA;AAAA,MACZ,GAAA,EAAK;AAAA;AACP,GACF;AACA,EAAA,MAASE,cAAA,CAAA,SAAA,CAAeF,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,cAAc,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,WAAA,EAAa,IAAA,EAAM,CAAC,CAAA,EAAG,OAAO,CAAA;AAEnG,EAAA,OAAO;AAAA,IACL,SAAA,EAAgBA,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,eAAe,CAAA;AAAA,IAC5C,WAAA,EAAkBA,gBAAA,CAAA,IAAA,CAAK,MAAA,EAAQ,UAAU;AAAA,GAC3C;AACF;;;AC7KA,eAAsB,eAAA,CAAgB,OAAA,GAAwB,EAAC,EAAyB;AACtF,EAAA,MAAM,cAAmBM,gBAAA,CAAA,OAAA,CAAQ,OAAA,CAAQ,WAAA,IAAe,OAAA,CAAQ,KAAK,CAAA;AACrE,EAAA,MAAM,MAAA,GAAcA,gBAAA,CAAA,OAAA,CAAQ,WAAA,EAAa,OAAA,CAAQ,UAAU,MAAM,CAAA;AACjE,EAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,OAAA,IAAW,CAAC,SAAS,CAAA;AAC7C,EAAA,MAAM,eAAe,OAAA,CAAQ,YAAA;AAE7B,EAAA,MAAM,UAAA,GAAa,MAAM,eAAA,CAAgB,WAAA,EAAa;AAAA,IACpD,OAAA;AAAA,IACA,YAAA;AAAA,IACA,YAAY,OAAA,CAAQ;AAAA,GACrB,CAAA;AAED,EAAA,IAAI,UAAA,CAAW,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AAChC,IAAA,MAAM,GAAA,GAAM,UAAA,CAAW,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,IAAI,KAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC7E,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,aAAA,EAAgB,GAAG,CAAA,CAAE,CAAA;AAAA,EACvC;AAEA,EAAA,MAAM,WAAuB,UAAA,CAAW,KAAA;AAExC,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,EAAE,SAAA,EAAW,WAAA,EAAY,GAAI,MAAM,QAAA,CAAS;AAAA,IAChD,KAAA,EAAO,QAAA;AAAA,IACP,MAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,WAAW,QAAA,CAAS,MAAA;AAAA,IACpB,SAAA;AAAA,IACA;AAAA,GACF;AACF;AAGO,IAAM,mBAAA,GAAsB;AChDnC,eAAsB,YAAA,CAAa,OAAA,GAAsB,EAAC,EAAmD;AAC3G,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,IAAQ,OAAA,CAAQ,GAAA,EAAI;AACzC,EAAA,MAAM,UAAA,GAAa;AAAA,IACZC,gBAAA,CAAA,IAAA,CAAK,MAAM,eAAe,CAAA;AAAA,IAC1BA,gBAAA,CAAA,IAAA,CAAK,MAAM,eAAe,CAAA;AAAA,IAC1BA,gBAAA,CAAA,IAAA,CAAK,IAAA,EAAM,MAAA,EAAQ,eAAe,CAAA;AAAA,IAClCA,gBAAA,CAAA,IAAA,CAAK,IAAA,EAAM,MAAA,EAAQ,eAAe,CAAA;AAAA,IAClCA,gBAAA,CAAA,IAAA,CAAK,IAAA,EAAM,WAAA,EAAa,eAAe,CAAA;AAAA,IACvCA,gBAAA,CAAA,IAAA,CAAK,IAAA,EAAM,WAAA,EAAa,eAAe;AAAA,GAC9C;AACA,EAAA,IAAI,KAAA,GAAQ,EAAA;AACZ,EAAA,KAAA,MAAW,KAAK,UAAA,EAAY;AAC1B,IAAA,IAAI;AACF,MAAA,MAASC,sBAAO,CAAC,CAAA;AACjB,MAAA,KAAA,GAAQ,CAAA;AACR,MAAA;AAAA,IACF,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACA,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,uHAAA,EAA0H,UAAA,CAAW,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACjJ;AAAA,EACF;AAEA,EAAA,MAAM,GAAA,GAAWD,yBAAQ,KAAK,CAAA;AAC9B,EAAA,MAAM,KAAA,GAAQE,oBAAM,KAAA,EAAO,CAAC,MAAM,KAAA,EAAYF,gBAAA,CAAA,QAAA,CAAS,KAAK,CAAC,CAAA,EAAG;AAAA,IAC9D,GAAA,EAAK,GAAA;AAAA,IACL,KAAA,EAAO,CAAC,MAAA,EAAQ,MAAA,EAAQ,SAAS,CAAA;AAAA,IACjC,KAAA,EAAO;AAAA,GACR,CAAA;AAED,EAAA,OAAO,EAAE,SAAS,KAAA,EAAM;AAC1B;AAGO,IAAM,eAAA,GAAkB","file":"chunk-TFT4RYFZ.cjs","sourcesContent":["/**\n * Scaffold a new MCP tool project: @tool TS, SKILL sample, tsconfig, README.\n * Use: init → build → run.\n */\n\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\n\nexport interface InitOptions {\n /** Target directory to create project (default: cwd). */\n targetPath?: string;\n}\n\nconst TEMPLATES = {\n \"package.json\": `{\n \"name\": \"my-mcp-tools\",\n \"version\": \"1.0.0\",\n \"private\": true,\n \"type\": \"module\",\n \"scripts\": {\n \"build\": \"node build.mjs\",\n \"start\": \"node start.mjs\"\n },\n \"devDependencies\": {\n \"@easynet/agent-tool\": \"latest\"\n }\n}\n`,\n \"build.mjs\": `import { buildMcpPackage } from \"@easynet/agent-tool\";\n\nconst result = await buildMcpPackage({ outDir: \"dist\" });\nconsole.log(\"Built\", result.toolCount, \"tool(s) ->\", result.outDir);\n`,\n \"start.mjs\": `import { runMcpServer } from \"@easynet/agent-tool\";\n\nconst { process: child } = await runMcpServer({ path: \"./dist\" });\nchild.stdin?.pipe(process.stdin);\nchild.stdout?.pipe(process.stdout);\nchild.stderr?.pipe(process.stderr);\nprocess.stdin?.ref();\nchild.on(\"close\", (code) => process.exit(code ?? 0));\n`,\n \"tsconfig.json\": `{\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"module\": \"ESNext\",\n \"strict\": true,\n \"skipLibCheck\": true,\n \"noEmit\": true\n },\n \"include\": [\"src/**/*.ts\"]\n}\n`,\n \"src/tools/example.ts\": `/**\n * Add two numbers.\n * @tool\n */\nexport async function add(a: number, b: number): Promise<number> {\n return a + b;\n}\n`,\n \"skills/hello-skill/SKILL.md\": `---\nname: hello-skill\ndescription: Say hello with a name.\n---\n\n# Hello Skill\n\nReturns a greeting for the given name.\n`,\n \"skills/hello-skill/handler.js\": `export default async function handler(args, ctx) {\n const name = args?.name ?? \"World\";\n return { message: \\`Hello, \\${name}!\\` };\n}\n`,\n \"README.md\": `# MCP Tool Project\n\nScaffolded by \\`agent-tool init\\`. Workflow:\n\n1. **init** — create project template (you are here)\n2. **npm install** — install dependencies\n3. **npm run build** — generate MCP package under \\`dist/\\`\n4. **npm start** — start the MCP server for testing\n\n## Quick start\n\n\\`\\`\\`bash\nnpm install\nnpm run build\nnpm start\n\\`\\`\\`\n\nEdit \\`src/tools/*.ts\\` (add \\`@tool\\` JSDoc) and/or \\`skills/*/SKILL.md\\`, then \\`npm run build\\` again.\n`,\n};\n\n/**\n * Create project template at targetPath. Writes tsconfig, src/tools/example.ts,\n * skills/hello-skill (SKILL.md + handler.js), and README.\n */\nexport async function initProject(options: InitOptions = {}): Promise<{ targetPath: string; filesCreated: string[] }> {\n const targetPath = path.resolve(options.targetPath ?? process.cwd());\n const filesCreated: string[] = [];\n\n await fs.mkdir(targetPath, { recursive: true });\n\n for (const [relPath, content] of Object.entries(TEMPLATES)) {\n const fullPath = path.join(targetPath, relPath);\n await fs.mkdir(path.dirname(fullPath), { recursive: true });\n try {\n await fs.access(fullPath);\n if (relPath === \"package.json\") continue; // skip so we don't overwrite existing\n } catch {\n // file doesn't exist, write it\n }\n await fs.writeFile(fullPath, content, \"utf8\");\n filesCreated.push(relPath);\n }\n\n return { targetPath, filesCreated };\n}\n","/**\n * Scan package for tools: scanForAllTools, scanPackageForTools, registerPackageTools.\n * Aggregates function/skill/n8n discovery and optional directory discovery.\n */\n\nimport * as path from \"node:path\";\nimport type { ToolSpec } from \"../core/types/ToolSpec.js\";\nimport {\n discoverTools,\n DirectoryScanner,\n type DiscoverToolsOptions,\n} from \"./discoveryFactory.js\";\n\nexport interface ScanAllToolsResult {\n specs: ToolSpec[];\n errors: Array<{ file: string; message: string }>;\n warnings: Array<{ file: string; message: string }>;\n}\n\nexport interface ScanAllToolsOptions {\n include?: string[];\n tsconfigPath?: string;\n includeN8n?: boolean;\n}\n\nexport async function scanForAllTools(\n projectPath: string,\n options: ScanAllToolsOptions = {},\n): Promise<ScanAllToolsResult> {\n const include = options.include ?? [\"**/*.ts\"];\n const tsconfigPath = options.tsconfigPath;\n const includeN8n = options.includeN8n === true;\n const opts: DiscoverToolsOptions = { include, tsconfigPath };\n\n const results = await Promise.all([\n discoverTools(\"function\", projectPath, opts),\n discoverTools(\"skill\", projectPath, opts),\n ...(includeN8n ? [discoverTools(\"n8n\", projectPath, opts)] : []),\n ]);\n const specs = results.flatMap((r) => r.specs);\n const errors = results.flatMap((r) => r.errors);\n const warnings = results.flatMap((r) => r.warnings ?? []);\n\n return { specs, errors, warnings };\n}\n\nexport interface ScanPackageResult {\n specs: ToolSpec[];\n errors: Array<{ file: string; message: string }>;\n warnings: Array<{ file: string; message: string }>;\n}\n\nexport interface ScanPackageOptions extends ScanAllToolsOptions {\n includeDirectoryDiscovery?: boolean;\n namespace?: string;\n}\n\nexport async function scanPackageForTools(\n packagePath: string,\n options: ScanPackageOptions = {},\n): Promise<ScanPackageResult> {\n const root = path.resolve(packagePath);\n const includeDirectoryDiscovery = options.includeDirectoryDiscovery !== false;\n const namespace = options.namespace ?? \"pkg\";\n\n const errors: Array<{ file: string; message: string }> = [];\n const warnings: Array<{ file: string; message: string }> = [];\n\n const scanResult = await scanForAllTools(root, {\n include: options.include,\n tsconfigPath: options.tsconfigPath,\n includeN8n: options.includeN8n,\n });\n errors.push(...scanResult.errors);\n warnings.push(...scanResult.warnings);\n\n let dirSpecs: ToolSpec[] = [];\n if (includeDirectoryDiscovery) {\n const scanner = new DirectoryScanner({\n roots: [root],\n namespace,\n onError: (dir, err) => errors.push({ file: dir, message: err.message }),\n });\n try {\n dirSpecs = await scanner.scan();\n } catch (err) {\n errors.push({\n file: root,\n message: err instanceof Error ? err.message : String(err),\n });\n }\n }\n\n const byName = new Map<string, ToolSpec>();\n for (const spec of dirSpecs) byName.set(spec.name, spec);\n for (const spec of scanResult.specs) {\n if (!byName.has(spec.name)) byName.set(spec.name, spec);\n }\n\n return { specs: Array.from(byName.values()), errors, warnings };\n}\n\nexport async function registerPackageTools(\n registry: { bulkRegister: (specs: ToolSpec[]) => void },\n packagePath: string,\n options: ScanPackageOptions = {},\n): Promise<ScanPackageResult> {\n const result = await scanPackageForTools(packagePath, options);\n if (result.specs.length > 0) registry.bulkRegister(result.specs);\n return result;\n}\n","/**\n * Generate MCP server entrypoint, tool-specs.json, invokers for function/skill/n8n.\n * Accepts unified ToolSpec[] (reads _meta.sourcePath/exportName, endpoint for codegen).\n */\n\nimport * as path from \"node:path\";\nimport * as fs from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ToolSpec } from \"../../../core/types/ToolSpec.js\";\nimport { FUNCTION_KIND } from \"../../../tools/function/types.js\";\nimport { SKILL_KIND } from \"../../../tools/skill/types.js\";\nimport { N8N_KIND } from \"../../../tools/n8n/types.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n/** Function spec with required codegen fields (from ToolSpec._meta). */\ninterface FunctionSpecForCodegen extends ToolSpec {\n kind: \"function\";\n _meta: { sourcePath: string; exportName: string; projectPath?: string };\n}\n\n/** Skill spec with required codegen fields. */\ninterface SkillSpecForCodegen extends ToolSpec {\n kind: \"skill\";\n _meta: { sourcePath: string; projectPath?: string };\n}\n\n/** N8n spec with endpoint (webhook URL) and _meta.sourcePath. */\ninterface N8nSpecForCodegen extends ToolSpec {\n kind: \"n8n\";\n endpoint?: string;\n _meta?: { sourcePath?: string };\n}\n\nasync function loadTemplate(name: string): Promise<string> {\n for (const dir of [\n path.join(__dirname, \"templates\"),\n path.join(__dirname, \"..\", \"templates\"),\n ]) {\n try {\n return await fs.readFile(path.join(dir, name), \"utf-8\");\n } catch {\n continue;\n }\n }\n throw new Error(`Template not found: ${name}. Tried templates/ next to generator and ../templates.`);\n}\n\nconst TEMPLATE_NAMES = {\n mcpServer: \"mcp-server.js\",\n toolIndex: \"tool-index.js\",\n skillInvoker: \"skill-invoker.js\",\n n8nInvoker: \"n8n-invoker.js\",\n} as const;\n\nfunction buildToolIndexCases(specs: FunctionSpecForCodegen[], fromGeneratedToProject: string): string {\n return specs\n .map((s) => {\n const modPath = path.join(fromGeneratedToProject, s._meta.sourcePath).replace(/\\\\/g, \"/\");\n return ` case \"${s.name}\": return (await import(\"${modPath}\")).${s._meta.exportName};`;\n })\n .join(\"\\n\");\n}\n\nfunction buildSkillInvokerCases(specs: SkillSpecForCodegen[], fromGeneratedToProject: string): string {\n return specs\n .map((s) => {\n const handlerPath = path.join(fromGeneratedToProject, s._meta.sourcePath, \"handler\").replace(/\\\\/g, \"/\");\n const descEscaped = (s.description ?? \"\").replace(/\"/g, '\\\\\"');\n return ` case \"${s.name}\": {\n const mod = await import(\"${handlerPath}.js\")\n .catch(() => import(\"${handlerPath}.mjs\"))\n .catch(() => null);\n if (!mod) return { result: null, error: \"No handler\" };\n const fn = mod.default ?? mod.handler;\n if (typeof fn !== \"function\") return { result: null, error: \"No handler\" };\n const ctx = { requestId: \"mcp\", taskId: \"mcp\", skill: { name: \"${s.name}\", description: \"${descEscaped}\", instructions: \"\", resources: [], readResource: async () => \"\", getResourcesByType: () => [], dirPath: \"\" } };\n const out = await fn(args, ctx);\n return out?.result !== undefined ? out.result : out;\n }`;\n })\n .join(\"\\n\");\n}\n\nfunction buildN8nInvokerCases(specs: N8nSpecForCodegen[]): string {\n return specs\n .map((s) => {\n const webhookUrl = s.endpoint;\n const url =\n webhookUrl\n ? `\"${webhookUrl}\"`\n : \"process.env.N8N_WEBHOOK_\" + s.name.replace(/[^a-zA-Z0-9]/g, \"_\").toUpperCase() + \" ?? null\";\n return ` case \"${s.name}\": {\n const url = ${url};\n if (!url) throw new Error(\"n8n webhook not configured for ${s.name}. Set N8N_WEBHOOK_* or add webhook to workflow.\");\n const res = await fetch(url, { method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify(args) });\n if (!res.ok) throw new Error(\"n8n request failed: \" + res.status);\n return res.json().catch(() => ({}));\n }`;\n })\n .join(\"\\n\");\n}\n\n/** Write generated files into outDir. projectPath is the folder containing source. */\nexport async function generate(options: {\n specs: ToolSpec[];\n outDir: string;\n projectPath: string;\n}): Promise<{ entryPath: string; mcpJsonPath: string }> {\n const { specs, outDir, projectPath } = options;\n await fs.mkdir(outDir, { recursive: true });\n\n const functionSpecs = specs.filter(\n (s): s is FunctionSpecForCodegen =>\n s.kind === FUNCTION_KIND && s._meta?.sourcePath != null && s._meta?.exportName != null,\n );\n const skillSpecs = specs.filter(\n (s): s is SkillSpecForCodegen => s.kind === SKILL_KIND && s._meta?.sourcePath != null,\n );\n const n8nSpecs = specs.filter((s): s is N8nSpecForCodegen => s.kind === N8N_KIND);\n\n const toolSpecsJson = specs.map((s) => ({\n kind: s.kind,\n name: s.name,\n description: s.description,\n inputSchema: s.inputSchema,\n ...(s.kind === FUNCTION_KIND && s._meta?.sourcePath != null && s._meta?.exportName != null && {\n outputSchema: s.outputSchema ?? { type: \"object\", additionalProperties: true },\n sourcePath: s._meta.sourcePath,\n exportName: s._meta.exportName,\n }),\n _meta: s._meta,\n ...(s.kind === SKILL_KIND && s._meta?.sourcePath != null && { sourcePath: s._meta.sourcePath }),\n ...(s.kind === N8N_KIND && {\n sourcePath: s._meta?.sourcePath,\n webhookUrl: s.endpoint,\n }),\n }));\n await fs.writeFile(\n path.join(outDir, \"tool-specs.json\"),\n JSON.stringify(toolSpecsJson, null, 2),\n \"utf-8\",\n );\n\n const configJson = { projectPath: path.resolve(projectPath) };\n await fs.writeFile(path.join(outDir, \"config.json\"), JSON.stringify(configJson, null, 2), \"utf-8\");\n\n const rel = path.relative(outDir, projectPath) || \".\";\n const fromGeneratedToProject = rel.split(path.sep).length ? rel : \".\";\n\n const [mcpServerTemplate, toolIndexTemplate, skillInvokerTemplate, n8nInvokerTemplate] = await Promise.all([\n loadTemplate(TEMPLATE_NAMES.mcpServer),\n loadTemplate(TEMPLATE_NAMES.toolIndex),\n loadTemplate(TEMPLATE_NAMES.skillInvoker),\n loadTemplate(TEMPLATE_NAMES.n8nInvoker),\n ]);\n\n const toolIndexTs = toolIndexTemplate.replace(\"{{CASES}}\", buildToolIndexCases(functionSpecs, fromGeneratedToProject));\n await fs.writeFile(path.join(outDir, \"tool-index.ts\"), toolIndexTs, \"utf-8\");\n\n const skillCases = buildSkillInvokerCases(skillSpecs, fromGeneratedToProject);\n const skillDefaultCase =\n skillSpecs.length === 0 ? \"default: throw new Error('Unknown skill: ' + name);\" : 'default: throw new Error(\"Unknown skill: \" + name);';\n const skillInvokerTs = skillInvokerTemplate.replace(\"{{CASES}}\", skillCases).replace(\"{{DEFAULT_CASE}}\", skillDefaultCase);\n await fs.writeFile(path.join(outDir, \"skill-invoker.ts\"), skillInvokerTs, \"utf-8\");\n\n const n8nCases = buildN8nInvokerCases(n8nSpecs);\n const n8nDefaultCase =\n n8nSpecs.length === 0 ? \"default: throw new Error('Unknown n8n tool: ' + name);\" : 'default: throw new Error(\"Unknown n8n tool: \" + name);';\n const n8nInvokerTs = n8nInvokerTemplate.replace(\"{{CASES}}\", n8nCases).replace(\"{{DEFAULT_CASE}}\", n8nDefaultCase);\n await fs.writeFile(path.join(outDir, \"n8n-invoker.ts\"), n8nInvokerTs, \"utf-8\");\n\n await fs.writeFile(path.join(outDir, \"mcp-server.ts\"), mcpServerTemplate, \"utf-8\");\n\n const mcpJson = {\n command: \"npx\",\n args: [\"-y\", \"tsx\", path.join(outDir, \"mcp-server.ts\")],\n };\n await fs.writeFile(path.join(outDir, \"mcp.json\"), JSON.stringify(mcpJson, null, 2), \"utf-8\");\n\n const packageJson = {\n name: \"function-tools-mcp\",\n version: \"1.0.0\",\n type: \"module\",\n description: \"MCP server generated from @tool functions, SKILL.md, and workflow.json\",\n main: \"mcp-server.ts\",\n scripts: { start: \"npx tsx mcp-server.ts\" },\n dependencies: {\n \"@modelcontextprotocol/sdk\": \"^1.25.3\",\n typescript: \">=5.0.0\",\n tsx: \">=4.0.0\",\n },\n };\n await fs.writeFile(path.join(outDir, \"package.json\"), JSON.stringify(packageJson, null, 2), \"utf-8\");\n\n return {\n entryPath: path.join(outDir, \"mcp-server.ts\"),\n mcpJsonPath: path.join(outDir, \"mcp.json\"),\n };\n}\n","/**\n * MCP build: scan project for @tool, SKILL, n8n; generate MCP entrypoint and npm package.\n */\n\nimport * as path from \"node:path\";\nimport { scanForAllTools } from \"../../../tools/scanPackage.js\";\nimport { generate } from \"./generator.js\";\nimport type { BuildResult } from \"./types.js\";\nimport type { ToolSpec } from \"../../../core/types/ToolSpec.js\";\n\nexport interface BuildOptions {\n /** Project root (folder to scan; default: cwd). */\n projectPath?: string;\n /** Output directory for generated files (default: projectPath/dist). */\n outDir?: string;\n /** Glob patterns for TS files (default: [\"**\\/*.ts\"]). Used for @tool (TypeScript) scanning only. */\n include?: string[];\n /** Path to tsconfig.json (default: projectPath/tsconfig.json). Used for @tool scanning only. */\n tsconfigPath?: string;\n /** Include n8n (workflow.json) tools. Default false: we do not start or install n8n-local; set true if you use n8n. */\n includeN8n?: boolean;\n}\n\n/**\n * Scan project for all tools (@tool, SKILL, n8n); generate MCP server + tool-specs + invokers (npm package).\n */\nexport async function buildMcpPackage(options: BuildOptions = {}): Promise<BuildResult> {\n const projectPath = path.resolve(options.projectPath ?? process.cwd());\n const outDir = path.resolve(projectPath, options.outDir ?? \"dist\");\n const include = options.include ?? [\"**/*.ts\"];\n const tsconfigPath = options.tsconfigPath;\n\n const scanResult = await scanForAllTools(projectPath, {\n include,\n tsconfigPath,\n includeN8n: options.includeN8n,\n });\n\n if (scanResult.errors.length > 0) {\n const msg = scanResult.errors.map((e) => `${e.file}: ${e.message}`).join(\"; \");\n throw new Error(`Scan failed: ${msg}`);\n }\n\n const allSpecs: ToolSpec[] = scanResult.specs;\n\n if (allSpecs.length === 0) {\n throw new Error(\n \"No tools found. Add @tool functions (JSDoc), SKILL.md directories, or workflow.json directories.\",\n );\n }\n\n const { entryPath, mcpJsonPath } = await generate({\n specs: allSpecs,\n outDir,\n projectPath,\n });\n\n return {\n outDir,\n toolCount: allSpecs.length,\n entryPath,\n mcpJsonPath,\n };\n}\n\n/** @deprecated Use buildMcpPackage. */\nexport const buildFunctionToTool = buildMcpPackage;\n","/**\n * Run step: start the generated MCP server (stdio) for testing. Spawns entrypoint via npx tsx.\n */\n\nimport { spawn } from \"node:child_process\";\nimport * as path from \"node:path\";\nimport * as fs from \"node:fs/promises\";\n\nexport interface RunOptions {\n /** Directory containing generated mcp-server (default: cwd or cwd/dist). */\n path?: string;\n}\n\n/**\n * Start the MCP server from the given directory.\n * Expects mcp-server.ts and tool-specs.json there; runs via npx tsx mcp-server.ts.\n * Returns a child process; caller should handle stdin/stdout and cleanup.\n */\nexport async function runMcpServer(options: RunOptions = {}): Promise<{ process: ReturnType<typeof spawn> }> {\n const base = options.path ?? process.cwd();\n const candidates = [\n path.join(base, \"mcp-server.ts\"),\n path.join(base, \"mcp-server.js\"),\n path.join(base, \"dist\", \"mcp-server.ts\"),\n path.join(base, \"dist\", \"mcp-server.js\"),\n path.join(base, \"generated\", \"mcp-server.ts\"),\n path.join(base, \"generated\", \"mcp-server.js\"),\n ];\n let entry = \"\";\n for (const p of candidates) {\n try {\n await fs.access(p);\n entry = p;\n break;\n } catch {\n // continue\n }\n }\n if (!entry) {\n throw new Error(\n `MCP entrypoint not found. Run \"agent-tool build\" first, or pass --path to a directory containing mcp-server.ts. Tried: ${candidates.join(\", \")}`,\n );\n }\n\n const dir = path.dirname(entry);\n const child = spawn(\"npx\", [\"-y\", \"tsx\", path.basename(entry)], {\n cwd: dir,\n stdio: [\"pipe\", \"pipe\", \"inherit\"],\n shell: false,\n });\n\n return { process: child };\n}\n\n/** @deprecated Use runMcpServer. */\nexport const runGeneratedMCP = runMcpServer;\n"]}