@easynet/agent-tool 1.0.0

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

@@ -0,0 +1,31 @@
+import type { SkillDefinition, SkillFrontmatter, SkillResource } from "./SkillManifest.js";
+/**
+ * Parse a SKILL.md file into its constituent parts:
+ * - YAML frontmatter (metadata)
+ * - Markdown body (instructions)
+ *
+ * Supports the standard YAML frontmatter format:
+ * ```
+ * ---
+ * name: my-skill
+ * description: Does something useful
+ * ---
+ *
+ * # Instructions here...
+ * ```
+ */
+export declare function parseSkillMd(content: string, filePath: string): {
+    frontmatter: SkillFrontmatter;
+    instructions: string;
+};
+/**
+ * Scan a skill directory for bundled resource files (Level 3).
+ * Recursively finds all files except SKILL.md and tool.json.
+ */
+export declare function scanSkillResources(dirPath: string): Promise<SkillResource[]>;
+/**
+ * Load and parse a complete skill from a directory containing SKILL.md.
+ * Returns the full SkillDefinition with all three progressive disclosure levels.
+ */
+export declare function loadSkillDefinition(dirPath: string): Promise<SkillDefinition>;
+//# sourceMappingURL=SkillMdParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SkillMdParser.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/SkillMdParser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAgB5B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf;IAAE,WAAW,EAAE,gBAAgB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAsEzD;AA8CD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAIlF;AAgDD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAwBnF"}

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

@@ -0,0 +1,6 @@
+export { loadMCPTool } from "./MCPLoader.js";
+export { loadLangChainTool } from "./LangChainLoader.js";
+export { loadSkillTool, loadSkillTools } from "./SkillLoader.js";
+export { loadN8nTool } from "./N8nLoader.js";
+export { resolveEntryPoint } from "./resolveEntry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Resolve the entry point file for a tool directory.
+ * If baseName already has an extension, verifies the file exists.
+ * Otherwise tries each extension in order.
+ */
+export declare function resolveEntryPoint(dirPath: string, baseName: string, extensions?: string[]): Promise<string>;
+//# sourceMappingURL=resolveEntry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveEntry.d.ts","sourceRoot":"","sources":["../../../src/discovery/load/resolveEntry.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAM,EAAuB,GACxC,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/dist/discovery/scan/DirectoryScanner.d.ts

@@ -0,0 +1,37 @@
+import type { ToolSpec } from "../../types/ToolSpec.js";
+import type { DirectoryScannerOptions } from "../types.js";
+/**
+ * Scans filesystem directories for tool definitions.
+ * A tool can be declared via tool.json or inferred from conventional files
+ * (SKILL.md, workflow.json, mcp.json, or an index entry point).
+ */
+export declare class DirectoryScanner {
+    private readonly roots;
+    private readonly extensions;
+    private readonly onError?;
+    constructor(options: DirectoryScannerOptions);
+    /**
+     * Scan all root directories and return discovered ToolSpecs.
+     * Errors in individual tool directories are reported via onError
+     * and do not prevent other tools from loading.
+     */
+    scan(): Promise<ToolSpec[]>;
+    private scanRoot;
+    /**
+     * Recursively scan directories for tool definitions.
+     * Directories can be detected via tool.json or inferred markers.
+     */
+    private scanRecursive;
+    private loadToolDir;
+    private inferManifest;
+    private fileExists;
+    private hasEntryPoint;
+    private hasLangchainFiles;
+    private listLangchainEntryFiles;
+    private loadByKind;
+    private loadLangChainTools;
+    private toToolSpec;
+    private buildBaseSpec;
+    private applyKindSpecificFields;
+}
+//# sourceMappingURL=DirectoryScanner.d.ts.map

package/dist/discovery/scan/DirectoryScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryScanner.d.ts","sourceRoot":"","sources":["../../../src/discovery/scan/DirectoryScanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,aAAa,CAAC;AAUrB;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IACnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0C;gBAEvD,OAAO,EAAE,uBAAuB;IAe5C;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAWnB,QAAQ;IAItB;;;OAGG;YACW,aAAa;YAyCb,WAAW;YA8EX,aAAa;YAuCb,UAAU;YASV,aAAa;YASb,iBAAiB;YAKjB,uBAAuB;YAuBvB,UAAU;YA2BV,kBAAkB;IAkDhC,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,uBAAuB;CAmFhC"}

package/dist/discovery/scan/scanUtil.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared scan utilities for directory-based tool discovery.
+ * Used by discovery (DirectoryScanner) and codegen (scanSkill, scanN8n, etc.).
+ */
+/**
+ * Recursively find all directories under rootPath that contain a file named fileName.
+ * Skips node_modules and dot-directories.
+ */
+export declare function findDirsContainingFile(rootPath: string, fileName: string): Promise<string[]>;
+/**
+ * Build tool display name from relative path + program/export name.
+ * e.g. "skill-dir" + "my-skill" → "skill-dir.my-skill";
+ *      "src/tools/example.ts" + "add" → "src.tools.example.add"
+ */
+export declare function pathToToolName(sourcePath: string, programName: string): string;
+//# sourceMappingURL=scanUtil.d.ts.map

package/dist/discovery/scan/scanUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanUtil.d.ts","sourceRoot":"","sources":["../../../src/discovery/scan/scanUtil.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AA+BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ9E"}

package/dist/discovery/types.d.ts

@@ -0,0 +1,99 @@
+import type { Capability, CostHints, ToolKind } from "../types/ToolSpec.js";
+import type { SkillDefinition } from "./load/SkillManifest.js";
+/**
+ * Cursor-compatible MCP server configuration.
+ * Supports command-based (stdio) and URL-based (SSE/HTTP) servers.
+ */
+export interface MCPServerConfig {
+    /** Command to spawn the MCP server process */
+    command?: string;
+    /** Arguments for the command */
+    args?: string[];
+    /** Environment variables for the spawned process */
+    env?: Record<string, string>;
+    /** Working directory when spawning (stdio); default to caller cwd */
+    cwd?: string;
+    /** SSE/HTTP URL for remote MCP server */
+    url?: string;
+}
+/**
+ * Discoverable tool kinds (subset of ToolKind that can be directory-discovered).
+ */
+export type DiscoverableKind = Extract<ToolKind, "mcp" | "langchain" | "skill" | "n8n">;
+/**
+ * Tool manifest read from tool.json or inferred from conventional files.
+ */
+export interface ToolManifest {
+    /** Tool kind — determines which loader and adapter handle this tool */
+    kind: DiscoverableKind;
+    /** Tool name override (default: "<namespace>/<dirname>") */
+    name?: string;
+    /** Semver version (default: "1.0.0") */
+    version?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Searchable tags */
+    tags?: string[];
+    /** Required capabilities for PolicyEngine gating */
+    capabilities?: Capability[];
+    /** Cost hints for routing/budgeting */
+    costHints?: CostHints;
+    /**
+     * Entry point file relative to tool directory.
+     * Defaults per kind:
+     *   mcp → "mcp.json"
+     *   langchain → "index" (or all *.js/*.mjs files when inside a "langchain" folder)
+     *   skill → "handler"
+     *   n8n → "workflow.json"
+     */
+    entryPoint?: string;
+    /**
+     * For skills only: multiple programs (entry points) in this skill directory.
+     * Map of program key → entry file (e.g. { "default": "handler.js", "report": "report.js" }).
+     * "default" is the main tool name (e.g. tools/yahoo-finance); others get tools/yahoo-finance/report.
+     * When absent, single entryPoint (or "handler") is used.
+     */
+    programs?: Record<string, string>;
+    /** JSON Schema for input validation */
+    inputSchema?: object;
+    /** JSON Schema for output validation */
+    outputSchema?: object;
+    /** Whether this tool is enabled (default: true). Set false to skip. */
+    enabled?: boolean;
+}
+/**
+ * Configuration for the DirectoryScanner.
+ */
+export interface DirectoryScannerOptions {
+    /** One or more root directories to scan for tool subdirectories */
+    roots: Array<string | {
+        path: string;
+        namespace?: string;
+    }>;
+    /** Namespace prefix for discovered tool names (default: "dir") */
+    namespace?: string;
+    /** File extensions to try for JS/TS entry points (default: [".js", ".mjs"]) */
+    extensions?: string[];
+    /** Callback for non-fatal errors during scan (tool dir path, error) */
+    onError?: (toolDir: string, error: Error) => void;
+}
+/**
+ * Result from loading a single tool directory.
+ */
+export interface LoadedTool {
+    /** The parsed manifest */
+    manifest: ToolManifest;
+    /** Absolute path to the tool directory */
+    dirPath: string;
+    /** Loaded implementation (LangChainToolLike instance or SkillHandler function) */
+    impl?: unknown;
+    /** For MCP tools: the parsed server config from mcp.json */
+    mcpConfig?: MCPServerConfig;
+    /** For n8n tools: the parsed workflow definition */
+    workflowDef?: unknown;
+    /** For Skill tools: the parsed SKILL.md definition with progressive disclosure levels */
+    skillDefinition?: SkillDefinition;
+    /** For Skill tools with multiple programs: key for naming (e.g. "default", "report") */
+    programKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/discovery/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,IAAI,EAAE,gBAAgB,CAAC;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oDAAoD;IACpD,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,uCAAuC;IACvC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yFAAyF;IACzF,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}