@easynet/agent-tool 1.0.0

package/dist/codegen/generator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generate MCP server entrypoint, tool-specs.json, invokers for function/skill/n8n.
+ * Templates are loaded from ./templates/ (shipped next to this module or in dist/templates).
+ */
+import type { MCPToolSpec } from "./types.js";
+/** Write generated files into outDir. projectPath is the folder containing source. */
+export declare function generate(options: {
+    specs: MCPToolSpec[];
+    outDir: string;
+    projectPath: string;
+}): Promise<{
+    entryPath: string;
+    mcpJsonPath: string;
+}>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/codegen/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/codegen/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAgD,MAAM,YAAY,CAAC;AAqE5F,sFAAsF;AACtF,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACtC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAmFtD"}

package/dist/codegen/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP build: init → build → run. Scan @tool, SKILL, n8n; generate standalone MCP npm package.
+ */
+export { initProject } from "./init.js";
+export type { InitOptions } from "./init.js";
+export { buildMcpPackage, buildFunctionToTool } from "./build.js";
+export type { BuildOptions } from "./build.js";
+export { runMcpServer, runGeneratedMCP } from "./run.js";
+export type { RunOptions } from "./run.js";
+export { scanForTools } from "./scan/scanner.js";
+export type { ScanResult } from "./scan/scanner.js";
+export { scanForSkill } from "./scan/scanSkill.js";
+export type { ScanSkillResult } from "./scan/scanSkill.js";
+export { scanForN8n } from "./scan/scanN8n.js";
+export type { ScanN8nResult } from "./scan/scanN8n.js";
+export { scanForAllTools } from "./scan/scanTools.js";
+export type { ScanAllToolsResult, ScanAllToolsOptions } from "./scan/scanTools.js";
+export { buildInputSchemaFromParams, buildOutputSchemaFromReturnType } from "./scan/schemaFromTs.js";
+export { generate } from "./generator.js";
+export type { FunctionToolSpec, ScanOptions, BuildResult, SideEffect } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/codegen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/codegen/init.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Scaffold a new MCP tool project: @tool TS, SKILL sample, tsconfig, README.
+ * Use: init → build → run.
+ */
+export interface InitOptions {
+    /** Target directory to create project (default: cwd). */
+    targetPath?: string;
+}
+/**
+ * Create project template at targetPath. Writes tsconfig, src/tools/example.ts,
+ * skills/hello-skill (SKILL.md + handler.js), and README.
+ */
+export declare function initProject(options?: InitOptions): Promise<{
+    targetPath: string;
+    filesCreated: string[];
+}>;
+//# sourceMappingURL=init.d.ts.map

package/dist/codegen/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/codegen/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqFD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoBpH"}

package/dist/codegen/run.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Run step: start the generated MCP server (stdio) for testing. Spawns entrypoint via npx tsx.
+ */
+import { spawn } from "node:child_process";
+export interface RunOptions {
+    /** Directory containing generated mcp-server (default: cwd or cwd/dist). */
+    path?: string;
+}
+/**
+ * Start the MCP server from the given directory.
+ * Expects mcp-server.ts and tool-specs.json there; runs via npx tsx mcp-server.ts.
+ * Returns a child process; caller should handle stdin/stdout and cleanup.
+ */
+export declare function runMcpServer(options?: RunOptions): Promise<{
+    process: ReturnType<typeof spawn>;
+}>;
+/** @deprecated Use runMcpServer. */
+export declare const runGeneratedMCP: typeof runMcpServer;
+//# sourceMappingURL=run.d.ts.map

package/dist/codegen/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/codegen/run.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAI3C,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAA;CAAE,CAAC,CAkC3G;AAED,oCAAoC;AACpC,eAAO,MAAM,eAAe,qBAAe,CAAC"}

package/dist/codegen/scan/scanN8n.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Scan project for workflow.json (n8n) directories; produce MCP tool specs.
+ * Reuses discovery: findDirsContainingFile, pathToToolName, readWorkflowMeta (N8nLoader).
+ */
+import type { N8nToolSpec } from "../types.js";
+export interface ScanN8nResult {
+    n8n: N8nToolSpec[];
+    errors: Array<{
+        dir: string;
+        message: string;
+    }>;
+}
+/**
+ * Scan projectPath for workflow.json directories; return n8n tool specs.
+ */
+export declare function scanForN8n(projectPath: string): Promise<ScanN8nResult>;
+//# sourceMappingURL=scanN8n.d.ts.map

package/dist/codegen/scan/scanN8n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanN8n.d.ts","sourceRoot":"","sources":["../../../src/codegen/scan/scanN8n.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,WAAW,EAAE,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAID;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2B5E"}

package/dist/codegen/scan/scanSkill.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Scan project for SKILL.md directories; produce MCP tool specs.
+ * Reuses discovery: findDirsContainingFile, pathToToolName, loadSkillDefinition.
+ */
+import type { SkillToolSpec } from "../types.js";
+export interface ScanSkillResult {
+    skills: SkillToolSpec[];
+    errors: Array<{
+        dir: string;
+        message: string;
+    }>;
+}
+/**
+ * Scan projectPath for SKILL.md directories; return skill tool specs.
+ */
+export declare function scanForSkill(projectPath: string): Promise<ScanSkillResult>;
+//# sourceMappingURL=scanSkill.d.ts.map

package/dist/codegen/scan/scanSkill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanSkill.d.ts","sourceRoot":"","sources":["../../../src/codegen/scan/scanSkill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAID;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA0BhF"}

package/dist/codegen/scan/scanTools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Scan project for all tools: @tool (TypeScript), SKILL.md directories, workflow.json (n8n).
+ * Single entry for MCP build; aggregates specs from scanner, scanSkill, scanN8n.
+ */
+import type { MCPToolSpec } from "../types.js";
+export interface ScanAllToolsResult {
+    /** All tools from function, skill, and n8n sources. */
+    specs: MCPToolSpec[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+    warnings: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+export interface ScanAllToolsOptions {
+    /** Glob patterns for TS files (default: ["**\/*.ts"]). Used for @tool (TypeScript) scanning only. */
+    include?: string[];
+    /** Path to tsconfig.json (default: projectPath/tsconfig.json). Used for @tool scanning only. */
+    tsconfigPath?: string;
+    /** Include n8n (workflow.json) tools. Default false: we do not start or install n8n-local; set true if you use n8n. */
+    includeN8n?: boolean;
+}
+/**
+ * Scan projectPath for all tools (function, SKILL, and optionally n8n); return unified specs and errors.
+ * By default n8n is not scanned (includeN8n: false); we do not start or install n8n-local.
+ */
+export declare function scanForAllTools(projectPath: string, options?: ScanAllToolsOptions): Promise<ScanAllToolsResult>;
+//# sourceMappingURL=scanTools.d.ts.map

package/dist/codegen/scan/scanTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanTools.d.ts","sourceRoot":"","sources":["../../../src/codegen/scan/scanTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uHAAuH;IACvH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA0B7B"}

package/dist/codegen/scan/scanner.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Scan TypeScript source files for exported functions with @tool JSDoc.
+ * Extracts description, @effect, and builds inputSchema from param types.
+ * Reuses discovery pathToToolName for consistent tool naming.
+ */
+import type { FunctionToolSpec } from "../types.js";
+export interface ScanResult {
+    specs: FunctionToolSpec[];
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+    warnings: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Scan a project folder for exported functions annotated with @tool.
+ */
+export declare function scanForTools(options: {
+    projectPath: string;
+    include?: string[];
+    tsconfigPath?: string;
+}): ScanResult;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/codegen/scan/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/codegen/scan/scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOpD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,UAAU,CAmGb"}

package/dist/codegen/scan/schemaFromTs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Build JSON Schema from TypeScript parameter types using the compiler API.
+ * MVP: primitives, optional, array, object. Complex types fallback to {} with warn.
+ */
+import * as ts from "typescript";
+/**
+ * Build output JSON Schema from function return type (unwrap Promise if present).
+ * For use in codegen when auto-deriving schema.
+ */
+export declare function buildOutputSchemaFromReturnType(node: ts.FunctionDeclaration | ts.ArrowFunction | ts.FunctionExpression, typeChecker: ts.TypeChecker, onWarn?: (message: string) => void): object;
+/** Build { type: "object", properties, required } from function parameters. */
+export declare function buildInputSchemaFromParams(node: ts.FunctionDeclaration | ts.ArrowFunction | ts.FunctionExpression, typeChecker: ts.TypeChecker, onWarn?: (message: string) => void): {
+    schema: object;
+    required: string[];
+};
+//# sourceMappingURL=schemaFromTs.d.ts.map

package/dist/codegen/scan/schemaFromTs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaFromTs.d.ts","sourceRoot":"","sources":["../../../src/codegen/scan/schemaFromTs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,EAAE,CAAC,mBAAmB,GAAG,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC,kBAAkB,EACvE,WAAW,EAAE,EAAE,CAAC,WAAW,EAC3B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,MAAM,CAkBR;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,EAAE,CAAC,mBAAmB,GAAG,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC,kBAAkB,EACvE,WAAW,EAAE,EAAE,CAAC,WAAW,EAC3B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA6BxC"}

package/dist/codegen/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Types for MCP build: tools from @tool (TypeScript), SKILL.md, workflow.json (n8n).
+ * See function-to-tool-and-hitl-gateway-mvp.md.
+ */
+/** HITL side-effect classification. */
+export type SideEffect = "none" | "local_write" | "external_write" | "destructive";
+/** Discriminated union: function (from @tool), skill (SKILL.md), or n8n (workflow.json). */
+export type MCPToolSpec = FunctionToolSpec | SkillToolSpec | N8nToolSpec;
+/** Single tool spec from @tool function (before MCP packaging). */
+export interface FunctionToolSpec {
+    kind: "function";
+    /** Tool display name: path-based, e.g. file.test.write for file/test.ts export write. */
+    name: string;
+    /** One-line description from JSDoc. */
+    description: string;
+    /** JSON Schema for arguments (object with param names as properties). Auto-derived from params when not provided. */
+    inputSchema: object;
+    /** JSON Schema for return value. Auto-derived from return type when not provided. */
+    outputSchema?: object;
+    /** HITL metadata. */
+    _meta?: {
+        hitl?: {
+            sideEffect?: SideEffect;
+        };
+    };
+    /** Source file path (relative to project root). */
+    sourcePath: string;
+    /** Export name (function name). */
+    exportName: string;
+}
+/** Single tool spec from SKILL.md directory. */
+export interface SkillToolSpec {
+    kind: "skill";
+    name: string;
+    description: string;
+    inputSchema: object;
+    _meta?: {
+        hitl?: {
+            sideEffect?: SideEffect;
+        };
+    };
+    /** Skill directory path (relative to project root). */
+    sourcePath: string;
+}
+/** Single tool spec from n8n workflow.json directory. */
+export interface N8nToolSpec {
+    kind: "n8n";
+    name: string;
+    description: string;
+    inputSchema: object;
+    _meta?: {
+        hitl?: {
+            sideEffect?: SideEffect;
+        };
+    };
+    /** n8n tool directory path (relative to project root). */
+    sourcePath: string;
+    /** Webhook URL if present in workflow (for runtime invocation). */
+    webhookUrl?: string;
+}
+/** Options for scanning a folder for @tool functions. */
+export interface ScanOptions {
+    /** Project root (folder containing tsconfig or source). */
+    projectPath: string;
+    /** Glob or path pattern for TS files (default: "src/**\/*.ts"). */
+    include?: string[];
+    /** Path to tsconfig.json (default: projectPath/tsconfig.json). */
+    tsconfigPath?: string;
+}
+/** Result of a full build (scan + generate). */
+export interface BuildResult {
+    /** Path to the generated output directory. */
+    outDir: string;
+    /** Number of tools discovered. */
+    toolCount: number;
+    /** Path to generated mcp-server entry (e.g. mcp-server.js or mcp-server.ts). */
+    entryPath: string;
+    /** Path to generated mcp.json (command/args to run the server). */
+    mcpJsonPath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/codegen/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/codegen/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEnF,4FAA4F;AAC5F,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,aAAa,GAAG,WAAW,CAAC;AAEzE,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,qHAAqH;IACrH,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,UAAU,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/C,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,UAAU,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/C,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,UAAU,CAAC,EAAE,UAAU,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/C,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/core.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunk3YLVPZRJ_cjs = require('./chunk-3YLVPZRJ.cjs');
+
+
+
+Object.defineProperty(exports, "DEFAULT_INPUT_SCHEMA", {
+  enumerable: true,
+  get: function () { return chunk3YLVPZRJ_cjs.DEFAULT_INPUT_SCHEMA; }
+});
+Object.defineProperty(exports, "DEFAULT_OUTPUT_SCHEMA", {
+  enumerable: true,
+  get: function () { return chunk3YLVPZRJ_cjs.DEFAULT_OUTPUT_SCHEMA; }
+});
+Object.defineProperty(exports, "createToolSpec", {
+  enumerable: true,
+  get: function () { return chunk3YLVPZRJ_cjs.createToolSpec; }
+});
+//# sourceMappingURL=core.cjs.map
+//# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"core.cjs"}

package/dist/core.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core types and createToolSpec only.
+ * Use this entry point from extensions to avoid circular dependency with the main index
+ * (which re-exports builtin-tools and example-tools).
+ */
+export type { ToolKind, Capability, HitlSideEffect, CostHints, ToolSpec, CreateToolSpecOptions, } from "./types/ToolSpec.js";
+export { createToolSpec, DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, } from "./types/ToolSpec.js";
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EACR,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/core.js

@@ -0,0 +1,3 @@
+export { DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, createToolSpec } from './chunk-AXUNV4MK.js';
+//# sourceMappingURL=core.js.map
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"core.js"}

package/dist/discovery/MCPProcessManager.d.ts

@@ -0,0 +1,57 @@
+import type { MCPServerConfig } from "./types.js";
+/**
+ * Connection info for an MCP server.
+ */
+export interface MCPConnectionInfo {
+    /** Transport type: "url" for SSE/HTTP, "stdio" for command-based */
+    type: "url" | "stdio";
+    /** SSE/HTTP URL (when type="url") */
+    url?: string;
+    /** Command to spawn (when type="stdio") */
+    command?: string;
+    /** Command arguments (when type="stdio") */
+    args?: string[];
+    /** Environment variables (when type="stdio") */
+    env?: Record<string, string>;
+    /** Working directory when spawning (when type="stdio") */
+    cwd?: string;
+}
+/**
+ * Manages MCP server connection information extracted from directory discovery.
+ *
+ * This class provides connection configuration for MCP servers discovered
+ * from mcp.json files. The actual MCP client creation and lifecycle management
+ * is the consumer's responsibility (using @modelcontextprotocol/sdk or similar).
+ *
+ * Usage:
+ * ```ts
+ * const manager = new MCPProcessManager();
+ * const info = manager.getConnectionInfo("my-tool", mcpConfig);
+ * if (info.type === "stdio") {
+ *   // Spawn process with info.command, info.args, info.env
+ * } else {
+ *   // Connect SSE client to info.url
+ * }
+ * ```
+ */
+export declare class MCPProcessManager {
+    private readonly connections;
+    /**
+     * Get connection info for an MCP tool based on its config.
+     * Caches the result by tool name.
+     */
+    getConnectionInfo(toolName: string, config: MCPServerConfig): MCPConnectionInfo;
+    /**
+     * Remove cached connection info for a tool.
+     */
+    remove(toolName: string): boolean;
+    /**
+     * Get all registered tool names.
+     */
+    getToolNames(): string[];
+    /**
+     * Clear all cached connection info.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=MCPProcessManager.d.ts.map

package/dist/discovery/MCPProcessManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPProcessManager.d.ts","sourceRoot":"","sources":["../../src/discovery/MCPProcessManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IAEpE;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,iBAAiB;IAkB/E;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/discovery/errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Error thrown during directory-based tool discovery.
+ */
+export declare class DiscoveryError extends Error {
+    /** Absolute path to the tool directory that caused the error */
+    readonly toolDir: string;
+    /** Phase in which the error occurred */
+    readonly phase: "manifest" | "load" | "validate";
+    /** The underlying cause */
+    readonly cause?: Error;
+    constructor(toolDir: string, phase: "manifest" | "load" | "validate", message: string, cause?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/discovery/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/discovery/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,EACvC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK;CAQhB"}

package/dist/discovery/load/LangChainLoader.d.ts

@@ -0,0 +1,7 @@
+import type { ToolManifest, LoadedTool } from "../types.js";
+/**
+ * Load a LangChain tool from its directory.
+ * Dynamically imports the entry point and validates it has an invoke() method.
+ */
+export declare function loadLangChainTool(dirPath: string, manifest: ToolManifest, extensions?: string[]): Promise<LoadedTool>;
+//# sourceMappingURL=LangChainLoader.d.ts.map

package/dist/discovery/load/LangChainLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LangChainLoader.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/LangChainLoader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI5D;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,UAAU,CAAC,CAyCrB"}

package/dist/discovery/load/MCPLoader.d.ts

@@ -0,0 +1,8 @@
+import type { ToolManifest, LoadedTool } from "../types.js";
+/**
+ * Load an MCP tool from its directory.
+ * Reads mcp.json and validates it has either command or url.
+ * Supports both Cursor's mcpServers wrapper format and bare server config.
+ */
+export declare function loadMCPTool(dirPath: string, manifest: ToolManifest): Promise<LoadedTool>;
+//# sourceMappingURL=MCPLoader.d.ts.map

package/dist/discovery/load/MCPLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPLoader.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/MCPLoader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA+C7E;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAwCrB"}

package/dist/discovery/load/N8nLoader.d.ts

@@ -0,0 +1,25 @@
+import type { ToolManifest, LoadedTool } from "../types.js";
+/** Metadata extracted from workflow.json for spec building (used by N8nLoader and codegen scanN8n). */
+export interface WorkflowMeta {
+    name: string;
+    description: string;
+    webhookUrl?: string;
+    workflowDef: Record<string, unknown>;
+}
+/**
+ * Read and parse workflow.json in dirPath; return metadata and raw workflow.
+ * Shared by loadN8nTool (runtime) and codegen scanN8n.
+ */
+export declare function readWorkflowMeta(dirPath: string, workflowFileName?: string): Promise<WorkflowMeta>;
+/**
+ * Load an n8n tool from its directory.
+ * Reads workflow.json and validates it has a "nodes" array.
+ *
+ * Description for the tool spec is taken (in order) from:
+ * 1. tool.json "description" (if present)
+ * 2. workflow.json "description" or "meta.description"
+ * 3. workflow.json "name" (n8n workflow name)
+ * 4. Fallback: "n8n tool: <dirName>"
+ */
+export declare function loadN8nTool(dirPath: string, manifest: ToolManifest): Promise<LoadedTool>;
+//# sourceMappingURL=N8nLoader.d.ts.map

package/dist/discovery/load/N8nLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"N8nLoader.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/N8nLoader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG5D,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE,MAAwB,GACzC,OAAO,CAAC,YAAY,CAAC,CAwDvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/discovery/load/SkillLoader.d.ts

@@ -0,0 +1,20 @@
+import type { ToolManifest, LoadedTool } from "../types.js";
+/**
+ * Load a Skill tool from its directory following Anthropic's Agent Skills spec.
+ *
+ * Requires a SKILL.md file with YAML frontmatter (name, description).
+ * The SKILL.md body provides instructions (Level 2), and bundled files
+ * in the directory provide resources (Level 3).
+ *
+ * Optionally loads a handler function (handler.js/mjs) for programmatic execution.
+ *
+ * @see https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
+ */
+export declare function loadSkillTool(dirPath: string, manifest: ToolManifest, extensions?: string[]): Promise<LoadedTool>;
+/**
+ * Load one or more skill programs from a directory.
+ * When manifest.programs is set (e.g. { "default": "handler.js", "report": "report.js" }),
+ * returns one LoadedTool per program; otherwise returns a single LoadedTool (entryPoint or "handler").
+ */
+export declare function loadSkillTools(dirPath: string, manifest: ToolManifest, extensions?: string[]): Promise<LoadedTool[]>;
+//# sourceMappingURL=SkillLoader.d.ts.map

package/dist/discovery/load/SkillLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillLoader.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/SkillLoader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuG5D;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,UAAU,EAAE,CAAC,CA8DvB"}

package/dist/discovery/load/SkillManifest.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Parsed SKILL.md manifest following Anthropic's Agent Skills specification.
+ *
+ * A SKILL.md file has:
+ * - YAML frontmatter with `name` and `description` (Level 1: metadata, always loaded)
+ * - Markdown body with instructions (Level 2: loaded when triggered)
+ * - Bundled resource files referenced from the body (Level 3: loaded as needed)
+ *
+ * @see https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
+ */
+/**
+ * YAML frontmatter from SKILL.md (Agent Skills spec).
+ * Level 1 (metadata) — always loaded at startup for discovery.
+ * @see https://agentskills.io/specification
+ */
+export interface SkillFrontmatter {
+    /**
+     * Skill name identifier (required).
+     * - Max 64 characters; lowercase letters, numbers, hyphens only
+     * - Must not start or end with hyphen; no consecutive hyphens
+     */
+    name: string;
+    /**
+     * What the skill does and when to use it (required).
+     * - Max 1024 characters
+     */
+    description: string;
+    /** Optional: license name or reference (e.g. Apache-2.0, LICENSE.txt). */
+    license?: string;
+    /** Optional: environment requirements, max 500 characters. */
+    compatibility?: string;
+    /** Optional: arbitrary key-value metadata. */
+    metadata?: Record<string, string>;
+    /** Optional: space-delimited list of pre-approved tools (experimental). */
+    allowedTools?: string;
+}
+/**
+ * A resource file bundled with the skill.
+ * Resources are Level 3 — loaded only as needed during execution.
+ */
+export interface SkillResource {
+    /** Relative path from the skill directory */
+    relativePath: string;
+    /** Absolute path on disk */
+    absolutePath: string;
+    /** File extension (e.g., ".md", ".py", ".json") */
+    extension: string;
+    /** Resource type inferred from extension */
+    type: "instructions" | "code" | "data";
+}
+/**
+ * Full parsed SKILL.md with progressive disclosure levels.
+ */
+export interface SkillDefinition {
+    /** Level 1: Metadata from YAML frontmatter (always loaded, ~100 tokens) */
+    frontmatter: SkillFrontmatter;
+    /** Level 2: Markdown body instructions (loaded when skill triggered, <5k tokens recommended) */
+    instructions: string;
+    /** Level 3: Bundled resource files (loaded as needed, effectively unlimited) */
+    resources: SkillResource[];
+    /** Absolute path to the skill directory */
+    dirPath: string;
+    /** Absolute path to the SKILL.md file */
+    skillMdPath: string;
+}
+/**
+ * Validation error for SKILL.md parsing.
+ */
+export declare class SkillManifestError extends Error {
+    readonly path: string;
+    readonly field: string;
+    constructor(path: string, field: string, message: string);
+}
+/**
+ * Validate a SkillFrontmatter object.
+ * Throws SkillManifestError if invalid.
+ */
+export declare function validateFrontmatter(fm: Partial<SkillFrontmatter>, filePath: string): asserts fm is SkillFrontmatter;
+//# sourceMappingURL=SkillManifest.d.ts.map

package/dist/discovery/load/SkillManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillManifest.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/SkillManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,WAAW,EAAE,gBAAgB,CAAC;IAE9B,gGAAgG;IAChG,YAAY,EAAE,MAAM,CAAC;IAErB,gFAAgF;IAChF,SAAS,EAAE,aAAa,EAAE,CAAC;IAE3B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,IAAI,EAAE,MAAM;aACZ,KAAK,EAAE,MAAM;gBADb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EAC7B,OAAO,EAAE,MAAM;CAKlB;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,EAAE,IAAI,gBAAgB,CA+EhC"}