@decaf-ts/mcp-server 0.0.2 → 0.0.4

package/lib/McpWrapper.cjs

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpWrapper = void 0;
+/* istanbul ignore file */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const constants_1 = require("./constants.cjs");
+const utils_1 = require("./utils.cjs");
+const fastmcp_1 = require("fastmcp");
+const logging_1 = require("@decaf-ts/logging");
+const metadata_1 = require("./metadata.cjs");
+/**
+ * @description Utility class to handle CLI functionality from all Decaf modules
+ * @summary This class provides a wrapper around Commander.js to handle CLI commands from different Decaf modules.
+ * It crawls the filesystem to find CLI modules, loads them, and registers their commands.
+ *
+ * @param {string} [basePath] The base path to look for modules in. Defaults to `./`
+ * @param {number} [crawlLevels] Number of folder levels to crawl to find modules from the basePath. Defaults to 4
+ *
+ * @example
+ * // Create a new CLI wrapper and run it with custom options
+ * const cli = new CliWrapper('./src', 2);
+ * cli.run(process.argv).then(() => {
+ *   console.log('CLI commands executed successfully');
+ * });
+ *
+ * @class McpWrapper
+ */
+class McpWrapper extends logging_1.LoggedClass {
+    constructor(basePath = "./", crawlLevels = 4) {
+        super();
+        this.basePath = basePath;
+        this.crawlLevels = crawlLevels;
+        this.modules = {};
+        this.rootPath = path_1.default.resolve(__dirname, "..");
+    }
+    /**
+     * @description Retrieves and initializes the Commander Command object
+     * @summary Lazy-loads the Command object, initializing it with the package name, description, and version
+     * @return {Command} The initialized Command object
+     * @private
+     */
+    get mcp() {
+        if (!this._mcp) {
+            this._mcp = new fastmcp_1.FastMCP({
+                name: "decaf-ts MCP server",
+                instructions: "",
+                version: metadata_1.VERSION,
+            });
+        }
+        return this._mcp;
+    }
+    /**
+     * @description Loads and registers an mcp extension module from a file
+     * @summary Dynamically imports an mcp extension module from the specified file path, initializes it, and registers it in the modules collection
+     *
+     */
+    async load(server, filePath) {
+        const log = this.log.for(this.load);
+        let pkg, version, enrich;
+        try {
+            const res = await utils_1.McpUtils.loadFromFile(filePath);
+            pkg = res.PACKAGE_NAME;
+            version = res.VERSION;
+            enrich = res.enrich;
+        }
+        catch (e) {
+            throw new Error(e.message || e);
+        }
+        try {
+            log.info(`Enriching mcp server with module ${pkg} v${version}`);
+            const result = enrich(server);
+            server = result instanceof Promise ? await result : result;
+        }
+        catch (e) {
+            throw new Error(`failed to enrich mcp with module ${pkg || "unnamed"} under ${filePath}: ${e instanceof Error ? e.message : e}`);
+        }
+        return {
+            mcp: server,
+            package: pkg,
+            version: version,
+        };
+    }
+    /**
+     * @description Finds and loads all CLI modules in the basePath
+     * @summary Uses the crawl method to find all CLI modules in the specified base path,
+     * then loads and registers each module as a subcommand
+     *
+     * @return {Promise<void>} A promise that resolves when all modules are loaded
+     *
+     * @private
+     * @mermaid
+     * sequenceDiagram
+     *   participant CliWrapper
+     *   participant Filesystem
+     *   participant Module
+     *
+     *   CliWrapper->>Filesystem: Join basePath with cwd
+     *   CliWrapper->>CliWrapper: crawl(basePath, crawlLevels)
+     *   CliWrapper-->>CliWrapper: modules[]
+     *   loop For each module
+     *     alt Not @decaf-ts/cli
+     *       CliWrapper->>CliWrapper: load(module, cwd)
+     *       CliWrapper-->>CliWrapper: name
+     *       CliWrapper->>CliWrapper: Check if command exists
+     *       alt Command doesn't exist
+     *         CliWrapper->>Command: command(name).addCommand(modules[name])
+     *       end
+     *     end
+     *   end
+     *   CliWrapper->>Console: Log loaded modules
+     */
+    async boot() {
+        const log = this.log.for(this.boot);
+        const basePath = path_1.default.resolve(this.rootPath, this.basePath);
+        const modules = this.crawl(basePath, this.crawlLevels);
+        let server = this.mcp;
+        for (const module of modules) {
+            if (module.includes("@decaf-ts/mcp")) {
+                continue;
+            }
+            try {
+                const res = await this.load(server, module);
+                server = res.mcp;
+            }
+            catch (e) {
+                log.error(`Failed to load MCP configs for ${module}: ${e}`);
+            }
+        }
+        console.log(`loaded modules:\n${Object.keys(this.modules)
+            .map((k) => `- ${k}`)
+            .join("\n")}`);
+        return server;
+    }
+    /**
+     * @description Recursively searches for CLI module files in the directory structure
+     * @summary Crawls the basePath up to the specified number of folder levels to find files named according to CLI_FILE_NAME
+     *
+     * @param {string} basePath The absolute base path to start searching in
+     * @param {number} [levels=2] The maximum number of directory levels to crawl
+     * @return {string[]} An array of file paths to CLI modules
+     *
+     * @private
+     */
+    crawl(basePath, levels = 2) {
+        if (levels <= 0)
+            return [];
+        return fs_1.default.readdirSync(basePath).reduce((accum, file) => {
+            file = path_1.default.join(basePath, file);
+            if (fs_1.default.statSync(file).isDirectory()) {
+                accum.push(...this.crawl(file, levels - 1));
+            }
+            else if (file.match(new RegExp(`${constants_1.MCP_FILE_NAME}.[cm]?js$`, "gm"))) {
+                accum.push(file);
+            }
+            return accum;
+        }, []);
+    }
+    /**
+     * @description Executes the CLI with the provided arguments
+     * @summary Boots the CLI by loading all modules, then parses and executes the command specified in the arguments
+     *
+     * @param {string[]} [args=process.argv] Command line arguments to parse and execute
+     * @return {Promise<void>} A promise that resolves when the command execution is complete
+     *
+     * @mermaid
+     * sequenceDiagram
+     *   participant Client
+     *   participant CliWrapper
+     *   participant Command
+     *
+     *   Client->>CliWrapper: run(args)
+     *   CliWrapper->>CliWrapper: boot()
+     *   Note over CliWrapper: Loads all modules
+     *   CliWrapper->>Command: parseAsync(args)
+     *   Command-->>CliWrapper: result
+     *   CliWrapper-->>Client: result
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async run(args = process.argv) {
+        const server = await this.boot();
+        await server.start({ transportType: "stdio" });
+    }
+}
+exports.McpWrapper = McpWrapper;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTWNwV3JhcHBlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9NY3BXcmFwcGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLDBCQUEwQjtBQUMxQiw0Q0FBb0I7QUFDcEIsZ0RBQXdCO0FBQ3hCLCtDQUE0QztBQUM1Qyx1Q0FBbUM7QUFDbkMscUNBQWtDO0FBQ2xDLCtDQUFnRDtBQUNoRCw2Q0FBcUM7QUFFckM7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCxNQUFhLFVBQVcsU0FBUSxxQkFBVztJQUt6QyxZQUNVLFdBQW1CLElBQUksRUFDdkIsY0FBYyxDQUFDO1FBRXZCLEtBQUssRUFBRSxDQUFDO1FBSEEsYUFBUSxHQUFSLFFBQVEsQ0FBZTtRQUN2QixnQkFBVyxHQUFYLFdBQVcsQ0FBSTtRQUxqQixZQUFPLEdBQTJCLEVBQUUsQ0FBQztRQVEzQyxJQUFJLENBQUMsUUFBUSxHQUFHLGNBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQ2hELENBQUM7SUFFRDs7Ozs7T0FLRztJQUNILElBQVksR0FBRztRQUNiLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDZixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksaUJBQU8sQ0FBQztnQkFDdEIsSUFBSSxFQUFFLHFCQUFxQjtnQkFDM0IsWUFBWSxFQUFFLEVBQUU7Z0JBQ2hCLE9BQU8sRUFBRSxrQkFBYzthQUN4QixDQUFDLENBQUM7UUFDTCxDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDO0lBQ25CLENBQUM7SUFFRDs7OztPQUlHO0lBQ0ssS0FBSyxDQUFDLElBQUksQ0FDaEIsTUFBZSxFQUNmLFFBQWdCO1FBRWhCLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUVwQyxJQUFJLEdBQVcsRUFBRSxPQUFlLEVBQUUs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LFlBQUUsQ0FBQyxXQUFXLENBQUMsUUFBUSxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsS0FBZSxFQUFFLElBQUksRUFBRSxFQUFFO1lBQy9ELElBQUksR0FBRyxjQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsQ0FBQztZQUNqQyxJQUFJLFlBQUUsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLENBQUMsV0FBVyxFQUFFLEVBQUUsQ0FBQztnQkFDcEMsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQzlDLENBQUM7aUJBQU0sSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLEdBQUcseUJBQWEsV0FBVyxFQUFFLElBQUksQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDckUsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUNuQixDQUFDO1lBQ0QsT0FBTyxLQUFLLENBQUM7UUFDZixDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDVCxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7T0FtQkc7SUFDSCw2REFBNkQ7SUFDN0QsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFpQixPQUFPLENBQUMsSUFBSTtRQUNyQyxNQUFNLE1BQU0sR0FBRyxNQUFNLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNqQyxNQUFNLE1BQU0sQ0FBQyxLQUFLLENBQUMsRUFBRSxhQUFhLEVBQUUsT0FBTyxFQUFFLENBQUMsQ0FBQztJQUNqRCxDQUFDO0NBQ0Y7QUF4S0QsZ0NBd0tDIiwic291cmNlc0NvbnRlbnQiOlsiLyogaXN0YW5idWwgaWdub3JlIGZpbGUgKi9cbmltcG9ydCBmcyBmcm9tIFwiZnNcIjtcbmltcG9ydCBwYXRoIGZyb20gXCJwYXRoXCI7XG5pbXBvcnQgeyBNQ1BfRklMRV9OQU1FIH0gZnJvbSBcIi4vY29uc3RhbnRzXCI7XG5pbXBvcnQgeyBNY3BVdGlscyB9IGZyb20gXCIuL3V0aWxzXCI7XG5pbXBvcnQgeyBGYXN0TUNQIH0gZnJvbSBcImZhc3RtY3BcIjtcbmltcG9ydCB7IExvZ2dlZENsYXNzIH0gZnJvbSBcIkBkZWNhZi10cy9sb2dnaW5nXCI7XG5pbXBvcnQgeyBWRVJTSU9OIH0gZnJvbSBcIi4vbWV0YWRhdGFcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gVXRpbGl0eSBjbGFzcyB0byBoYW5kbGUgQ0xJIGZ1bmN0aW9uYWxpdHkgZnJvbSBhbGwgRGVjYWYgbW9kdWxlc1xuICogQHN1bW1hcnkgVGhpcyBjbGFzcyBwcm92aWRlcyBhIHdyYXBwZXIgYXJvdW5kIENvbW1hbmRlci5qcyB0byBoYW5kbGUgQ0xJIGNvbW1hbmRzIGZyb20gZGlmZmVyZW50IERlY2FmIG1vZHVsZXMuXG4gKiBJdCBjcmF3bHMgdGhlIGZpbGVzeXN0ZW0gdG8gZmluZCBDTEkgbW9kdWxlcywgbG9hZHMgdGhlbSwgYW5kIHJlZ2lzdGVycyB0aGVpciBjb21tYW5kcy5cbiAqXG4gKiBAcGFyYW0ge3N0cmluZ30gW2Jhc2VQYXRoXSBUaGUgYmFzZSBwYXRoIHRvIGxvb2sgZm9yIG1vZHVsZXMgaW4uIERlZmF1bHRzIHRvIGAuL2BcbiAqIEBwYXJhbSB7bnVtYmVyfSBbY3Jhd2xMZXZlbHNdIE51bWJlciBvZiBmb2xkZXIgbGV2ZWxzIHRvIGNyYXdsIHRvIGZpbmQgbW9kdWxlcyBmcm9tIHRoZSBiYXNlUGF0aC4gRGVmYXVsdHMgdG8gNFxuICpcbiAqIEBleGFtcGxlXG4gKiAvLyBDcmVhdGUgYSBuZXcgQ0xJIHdyYXBwZXIgYW5kIHJ1biBpdCB3aXRoIGN1c3RvbSBvcHRpb25zXG4gKiBjb25zdCBjbGkgPSBuZXcgQ2xpV3JhcHBlcignLi9zcmMnLCAyKTtcbiAqIGNsaS5ydW4ocHJvY2Vzcy5hcmd2KS50aGVuKCgpID0+IHtcbiAqICAgY29uc29sZS5sb2coJ0NMSSBjb21tYW5kcyBleGVjdXRlZCBzdWNjZXNzZnVsbHknKTtcbiAqIH0pO1xuICpcbiAqIEBjbGFzcyBNY3BXcmFwcGVyXG4gKi9cbmV4cG9ydCBjbGFzcyBNY3BXcmFwcGVyIGV4dGVuZHMgTG9nZ2VkQ2xhc3Mge1xuICBwcml2YXRlIF9tY3A/OiBGYXN0TUNQO1xuICBwcml2YXRlIG1vZHVsZXM6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4gPSB7fTtcbiAgcHJpdmF0ZSByZWFkb25seSByb290UGF0aDogc3RyaW5nO1xuXG4gIGNvbnN0cnVjdG9yKFxuICAgIHByaXZhdGUgYmFzZVBhdGg6IHN0cmluZyA9IFwiLi9cIixcbiAgICBwcml2YXRlIGNyYXdsTGV2ZWxzID0gNFxuICApIHtcbiAgICBzdXBlcigpO1xuICAgIHRoaXMucm9vdFBhdGggPSBwYXRoLnJlc29sdmUoX19kaXJuYW1lLCBcIi4uXCIpO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBSZXRyaWV2ZXMgYW5kIGluaXRpYWxpemVzIHRoZSBDb21tYW5kZXIgQ29tbWFuZCBvYmplY3RcbiAgICogQHN1bW1hcnkgTGF6eS1sb2FkcyB0aGUgQ29tbWFuZCBvYmplY3QsIGluaXRpYWxpemluZyBpdCB3aXRoIHRoZSBwYWNrYWdlIG5hbWUsIGRlc2NyaXB0aW9uLCBhbmQgdmVyc2lvblxuICAgKiBAcmV0dXJuIHtDb21tYW5kfSBUaGUgaW5pdGlhbGl6ZWQgQ29tbWFuZCBvYmplY3RcbiAgICogQHByaXZhdGVcbiAgICovXG4gIHByaXZhdGUgZ2V0IG1jcCgpIHtcbiAgICBpZiAoIXRoaXMuX21jcCkge1xuICAgICAgdGhpcy5fbWNwID0gbmV3IEZhc3RNQ1Aoe1xuICAgICAgICBuYW1lOiBcImRlY2FmLXRzIE1DUCBzZXJ2ZXJcIixcbiAgICAgICAgaW5zdHJ1Y3Rpb25zOiBcIlwiLFxuICAgICAgICB2ZXJzaW9uOiBWRVJTSU9OIGFzIGFueSxcbiAgICAgIH0pO1xuICAgIH1cbiAgICByZXR1cm4gdGhpcy5fbWNwO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBMb2FkcyBhbmQgcmVnaXN0ZXJzIGFuIG1jcCBleHRlbnNpb24gbW9kdWxlIGZyb20gYSBmaWxlXG4gICAqIEBzdW1tYXJ5IER5bmFtaWNhbGx5IGltcG9ydHMgYW4gbWNwIGV4dGVuc2lvbiBtb2R1bGUgZnJvbSB0aGUgc3BlY2lmaWVkIGZpbGUgcGF0aCwgaW5pdGlhbGl6ZXMgaXQsIGFuZCByZWdpc3RlcnMgaXQgaW4gdGhlIG1vZHVsZXMgY29sbGVjdGlvblxuICAgKlxuICAgKi9cbiAgcHJpdmF0ZSBhc3luYyBsb2FkKFxuICAgIHNlcnZlcjogRmFzdE1DUCxcbiAgICBmaWxlUGF0aDogc3RyaW5nXG4gICk6IFByb21pc2U8eyBtY3A6IEZhc3RNQ1A7IHBhY2thZ2U6IHN0cmluZzsgdmVyc2lvbjogc3RyaW5nIH0+IHtcbiAgICBjb25zdCBsb2cgPSB0aGlzLmxvZy5mb3IodGhpcy5sb2FkKTtcblxuICAgIGxldCBwa2c6IHN0cmluZywgdmVyc2lvbjogc3RyaW5nLCBlbnJpY2g6IGFueTtcbiAgICB0cnkge1xuICAgICAgY29uc3QgcmVzID0gYXdhaXQgTWNwVXRpbHMubG9hZEZyb21GaWxlKGZpbGVQYXRoKTtcbiAgICAgIHBrZyA9IHJlcy5QQUNLQUdFX05BTUU7XG4gICAgICB2ZXJzaW9uID0gcmVzLlZFUlNJT047XG4gICAgICBlbnJpY2ggPSByZXMuZW5yaWNoO1xuICAgIH0gY2F0Y2ggKGU6IHVua25vd24pIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcigoZSBhcyBhbnkpLm1lc3NhZ2UgfHwgKGUgYXMgYW55KSk7XG4gICAgfVxuICAgIHRyeSB7XG4gICAgICBsb2cuaW5mbyhgRW5yaWNoaW5nIG1jcCBzZXJ2ZXIgd2l0aCBtb2R1bGUgJHtwa2d9IHYke3ZlcnNpb259YCk7XG4gICAgICBjb25zdCByZXN1bHQgPSBlbnJpY2goc2VydmVyKTtcbiAgICAgIHNlcnZlciA9IHJlc3VsdCBpbnN0YW5jZW9mIFByb21pc2UgPyBhd2FpdCByZXN1bHQgOiByZXN1bHQ7XG4gICAgfSBjYXRjaCAoZTogdW5rbm93bikge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgICBgZmFpbGVkIHRvIGVucmljaCBtY3Agd2l0aCBtb2R1bGUgJHtwa2cgfHwgXCJ1bm5hbWVkXCJ9IHVuZGVyICR7ZmlsZVBhdGh9OiAke2UgaW5zdGFuY2VvZiBFcnJvciA/IGUubWVzc2FnZSA6IGV9YFxuICAgICAgKTtcbiAgICB9XG4gICAgcmV0dXJuIHtcbiAgICAgIG1jcDogc2VydmVyLFxuICAgICAgcGFja2FnZTogcGtnLFxuICAgICAgdmVyc2lvbjogdmVyc2lvbixcbiAgICB9O1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBGaW5kcyBhbmQgbG9hZHMgYWxsIENMSSBtb2R1bGVzIGluIHRoZSBiYXNlUGF0aFxuICAgKiBAc3VtbWFyeSBVc2VzIHRoZSBjcmF3bCBtZXRob2QgdG8gZmluZCBhbGwgQ0xJIG1vZHVsZXMgaW4gdGhlIHNwZWNpZmllZCBiYXNlIHBhdGgsXG4gICAqIHRoZW4gbG9hZHMgYW5kIHJlZ2lzdGVycyBlYWNoIG1vZHVsZSBhcyBhIHN1YmNvbW1hbmRcbiAgICpcbiAgICogQHJldHVybiB7UHJvbWlzZTx2b2lkPn0gQSBwcm9taXNlIHRoYXQgcmVzb2x2ZXMgd2hlbiBhbGwgbW9kdWxlcyBhcmUgbG9hZGVkXG4gICAqXG4gICAqIEBwcml2YXRlXG4gICAqIEBtZXJtYWlkXG4gICAqIHNlcXVlbmNlRGlhZ3JhbVxuICAgKiAgIHBhcnRpY2lwYW50IENsaVdyYXBwZXJcbiAgICogICBwYXJ0aWNpcGFudCBGaWxlc3lzdGVtXG4gICAqICAgcGFydGljaXBhbnQgTW9kdWxlXG4gICAqXG4gICAqICAgQ2xpV3JhcHBlci0+PkZpbGVzeXN0ZW06IEpvaW4gYmFzZVBhdGggd2l0aCBjd2RcbiAgICogICBDbGlXcmFwcGVyLT4+Q2xpV3JhcHBlcjogY3Jhd2woYmFzZVBhdGgsIGNyYXdsTGV2ZWxzKVxuICAgKiAgIENsaVdyYXBwZXItLT4+Q2xpV3JhcHBlcjogbW9kdWxlc1tdXG4gICAqICAgbG9vcCBGb3IgZWFjaCBtb2R1bGVcbiAgICogICAgIGFsdCBOb3QgQGRlY2FmLXRzL2NsaVxuICAgKiAgICAgICBDbGlXcmFwcGVyLT4+Q2xpV3JhcHBlcjogbG9hZChtb2R1bGUsIGN3ZClcbiAgICogICAgICAgQ2xpV3JhcHBlci0tPj5DbGlXcmFwcGVyOiBuYW1lXG4gICAqICAgICAgIENsaVdyYXBwZXItPj5DbGlXcmFwcGVyOiBDaGVjayBpZiBjb21tYW5kIGV4aXN0c1xuICAgKiAgICAgICBhbHQgQ29tbWFuZCBkb2Vzbid0IGV4aXN0XG4gICAqICAgICAgICAgQ2xpV3JhcHBlci0+PkNvbW1hbmQ6IGNvbW1hbmQobmFtZSkuYWRkQ29tbWFuZChtb2R1bGVzW25hbWVdKVxuICAgKiAgICAgICBlbmRcbiAgICogICAgIGVuZFxuICAgKiAgIGVuZFxuICAgKiAgIENsaVdyYXBwZXItPj5Db25zb2xlOiBMb2cgbG9hZGVkIG1vZHVsZXNcbiAgICovXG4gIHByaXZhdGUgYXN5bmMgYm9vdCgpIHtcbiAgICBjb25zdCBsb2cgPSB0aGlzLmxvZy5mb3IodGhpcy5ib290KTtcblxuICAgIGNvbnN0IGJhc2VQYXRoID0gcGF0aC5yZXNvbHZlKHRoaXMucm9vdFBhdGgsIHRoaXMuYmFzZVBhdGgpO1xuICAgIGNvbnN0IG1vZHVsZXMgPSB0aGlzLmNyYXdsKGJhc2VQYXRoLCB0aGlzLmNyYXdsTGV2ZWxzKTtcbiAgICBsZXQgc2VydmVyID0gdGhpcy5tY3A7XG4gICAgZm9yIChjb25zdCBtb2R1bGUgb2YgbW9kdWxlcykge1xuICAgICAgaWYgKG1vZHVsZS5pbmNsdWRlcyhcIkBkZWNhZi10cy9tY3BcIikpIHtcbiAgICAgICAgY29udGludWU7XG4gICAgICB9XG4gICAgICB0cnkge1xuICAgICAgICBjb25zdCByZXMgPSBhd2FpdCB0aGlzLmxvYWQoc2VydmVyLCBtb2R1bGUpO1xuICAgICAgICBzZXJ2ZXIgPSByZXMubWNwO1xuICAgICAgfSBjYXRjaCAoZTogdW5rbm93bikge1xuICAgICAgICBsb2cuZXJyb3IoYEZhaWxlZCB0byBsb2FkIE1DUCBjb25maWdzIGZvciAke21vZHVsZX06ICR7ZX1gKTtcbiAgICAgIH1cbiAgICB9XG4gICAgY29uc29sZS5sb2coXG4gICAgICBgbG9hZGVkIG1vZHVsZXM6XFxuJHtPYmplY3Qua2V5cyh0aGlzLm1vZHVsZXMpXG4gICAgICAgIC5tYXAoKGspID0+IGAtICR7a31gKVxuICAgICAgICAuam9pbihcIlxcblwiKX1gXG4gICAgKTtcbiAgICByZXR1cm4gc2VydmVyO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBSZWN1cnNpdmVseSBzZWFyY2hlcyBmb3IgQ0xJIG1vZHVsZSBmaWxlcyBpbiB0aGUgZGlyZWN0b3J5IHN0cnVjdHVyZVxuICAgKiBAc3VtbWFyeSBDcmF3bHMgdGhlIGJhc2VQYXRoIHVwIHRvIHRoZSBzcGVjaWZpZWQgbnVtYmVyIG9mIGZvbGRlciBsZXZlbHMgdG8gZmluZCBmaWxlcyBuYW1lZCBhY2NvcmRpbmcgdG8gQ0xJX0ZJTEVfTkFNRVxuICAgKlxuICAgKiBAcGFyYW0ge3N0cmluZ30gYmFzZVBhdGggVGhlIGFic29sdXRlIGJhc2UgcGF0aCB0byBzdGFydCBzZWFyY2hpbmcgaW5cbiAgICogQHBhcmFtIHtudW1iZXJ9IFtsZXZlbHM9Ml0gVGhlIG1heGltdW0gbnVtYmVyIG9mIGRpcmVjdG9yeSBsZXZlbHMgdG8gY3Jhd2xcbiAgICogQHJldHVybiB7c3RyaW5nW119IEFuIGFycmF5IG9mIGZpbGUgcGF0aHMgdG8gQ0xJIG1vZHVsZXNcbiAgICpcbiAgICogQHByaXZhdGVcbiAgICovXG4gIHByaXZhdGUgY3Jhd2woYmFzZVBhdGg6IHN0cmluZywgbGV2ZWxzOiBudW1iZXIgPSAyKSB7XG4gICAgaWYgKGxldmVscyA8PSAwKSByZXR1cm4gW107XG4gICAgcmV0dXJuIGZzLnJlYWRkaXJTeW5jKGJhc2VQYXRoKS5yZWR1Y2UoKGFjY3VtOiBzdHJpbmdbXSwgZmlsZSkgPT4ge1xuICAgICAgZmlsZSA9IHBhdGguam9pbihiYXNlUGF0aCwgZmlsZSk7XG4gICAgICBpZiAoZnMuc3RhdFN5bmMoZmlsZSkuaXNEaXJlY3RvcnkoKSkge1xuICAgICAgICBhY2N1bS5wdXNoKC4uLnRoaXMuY3Jhd2woZmlsZSwgbGV2ZWxzIC0gMSkpO1xuICAgICAgfSBlbHNlIGlmIChmaWxlLm1hdGNoKG5ldyBSZWdFeHAoYCR7TUNQX0ZJTEVfTkFNRX0uW2NtXT9qcyRgLCBcImdtXCIpKSkge1xuICAgICAgICBhY2N1bS5wdXNoKGZpbGUpO1xuICAgICAgfVxuICAgICAgcmV0dXJuIGFjY3VtO1xuICAgIH0sIFtdKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBAZGVzY3JpcHRpb24gRXhlY3V0ZXMgdGhlIENMSSB3aXRoIHRoZSBwcm92aWRlZCBhcmd1bWVudHNcbiAgICogQHN1bW1hcnkgQm9vdHMgdGhlIENMSSBieSBsb2FkaW5nIGFsbCBtb2R1bGVzLCB0aGVuIHBhcnNlcyBhbmQgZXhlY3V0ZXMgdGhlIGNvbW1hbmQgc3BlY2lmaWVkIGluIHRoZSBhcmd1bWVudHNcbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmdbXX0gW2FyZ3M9cHJvY2Vzcy5hcmd2XSBDb21tYW5kIGxpbmUgYXJndW1lbnRzIHRvIHBhcnNlIGFuZCBleGVjdXRlXG4gICAqIEByZXR1cm4ge1Byb21pc2U8dm9pZD59IEEgcHJvbWlzZSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIGNvbW1hbmQgZXhlY3V0aW9uIGlzIGNvbXBsZXRlXG4gICAqXG4gICAqIEBtZXJtYWlkXG4gICAqIHNlcXVlbmNlRGlhZ3JhbVxuICAgKiAgIHBhcnRpY2lwYW50IENsaWVudFxuICAgKiAgIHBhcnRpY2lwYW50IENsaVdyYXBwZXJcbiAgICogICBwYXJ0aWNpcGFudCBDb21tYW5kXG4gICAqXG4gICAqICAgQ2xpZW50LT4+Q2xpV3JhcHBlcjogcnVuKGFyZ3MpXG4gICAqICAgQ2xpV3JhcHBlci0+PkNsaVdyYXBwZXI6IGJvb3QoKVxuICAgKiAgIE5vdGUgb3ZlciBDbGlXcmFwcGVyOiBMb2FkcyBhbGwgbW9kdWxlc1xuICAgKiAgIENsaVdyYXBwZXItPj5Db21tYW5kOiBwYXJzZUFzeW5jKGFyZ3MpXG4gICAqICAgQ29tbWFuZC0tPj5DbGlXcmFwcGVyOiByZXN1bHRcbiAgICogICBDbGlXcmFwcGVyLS0+PkNsaWVudDogcmVzdWx0XG4gICAqL1xuICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVudXNlZC12YXJzXG4gIGFzeW5jIHJ1bihhcmdzOiBzdHJpbmdbXSA9IHByb2Nlc3MuYXJndikge1xuICAgIGNvbnN0IHNlcnZlciA9IGF3YWl0IHRoaXMuYm9vdCgpO1xuICAgIGF3YWl0IHNlcnZlci5zdGFydCh7IHRyYW5zcG9ydFR5cGU6IFwic3RkaW9cIiB9KTtcbiAgfVxufVxuIl19

package/lib/McpWrapper.d.ts

@@ -0,0 +1,101 @@
+import { LoggedClass } from "@decaf-ts/logging";
+/**
+ * @description Utility class to handle CLI functionality from all Decaf modules
+ * @summary This class provides a wrapper around Commander.js to handle CLI commands from different Decaf modules.
+ * It crawls the filesystem to find CLI modules, loads them, and registers their commands.
+ *
+ * @param {string} [basePath] The base path to look for modules in. Defaults to `./`
+ * @param {number} [crawlLevels] Number of folder levels to crawl to find modules from the basePath. Defaults to 4
+ *
+ * @example
+ * // Create a new CLI wrapper and run it with custom options
+ * const cli = new CliWrapper('./src', 2);
+ * cli.run(process.argv).then(() => {
+ *   console.log('CLI commands executed successfully');
+ * });
+ *
+ * @class McpWrapper
+ */
+export declare class McpWrapper extends LoggedClass {
+    private basePath;
+    private crawlLevels;
+    private _mcp?;
+    private modules;
+    private readonly rootPath;
+    constructor(basePath?: string, crawlLevels?: number);
+    /**
+     * @description Retrieves and initializes the Commander Command object
+     * @summary Lazy-loads the Command object, initializing it with the package name, description, and version
+     * @return {Command} The initialized Command object
+     * @private
+     */
+    private get mcp();
+    /**
+     * @description Loads and registers an mcp extension module from a file
+     * @summary Dynamically imports an mcp extension module from the specified file path, initializes it, and registers it in the modules collection
+     *
+     */
+    private load;
+    /**
+     * @description Finds and loads all CLI modules in the basePath
+     * @summary Uses the crawl method to find all CLI modules in the specified base path,
+     * then loads and registers each module as a subcommand
+     *
+     * @return {Promise<void>} A promise that resolves when all modules are loaded
+     *
+     * @private
+     * @mermaid
+     * sequenceDiagram
+     *   participant CliWrapper
+     *   participant Filesystem
+     *   participant Module
+     *
+     *   CliWrapper->>Filesystem: Join basePath with cwd
+     *   CliWrapper->>CliWrapper: crawl(basePath, crawlLevels)
+     *   CliWrapper-->>CliWrapper: modules[]
+     *   loop For each module
+     *     alt Not @decaf-ts/cli
+     *       CliWrapper->>CliWrapper: load(module, cwd)
+     *       CliWrapper-->>CliWrapper: name
+     *       CliWrapper->>CliWrapper: Check if command exists
+     *       alt Command doesn't exist
+     *         CliWrapper->>Command: command(name).addCommand(modules[name])
+     *       end
+     *     end
+     *   end
+     *   CliWrapper->>Console: Log loaded modules
+     */
+    private boot;
+    /**
+     * @description Recursively searches for CLI module files in the directory structure
+     * @summary Crawls the basePath up to the specified number of folder levels to find files named according to CLI_FILE_NAME
+     *
+     * @param {string} basePath The absolute base path to start searching in
+     * @param {number} [levels=2] The maximum number of directory levels to crawl
+     * @return {string[]} An array of file paths to CLI modules
+     *
+     * @private
+     */
+    private crawl;
+    /**
+     * @description Executes the CLI with the provided arguments
+     * @summary Boots the CLI by loading all modules, then parses and executes the command specified in the arguments
+     *
+     * @param {string[]} [args=process.argv] Command line arguments to parse and execute
+     * @return {Promise<void>} A promise that resolves when the command execution is complete
+     *
+     * @mermaid
+     * sequenceDiagram
+     *   participant Client
+     *   participant CliWrapper
+     *   participant Command
+     *
+     *   Client->>CliWrapper: run(args)
+     *   CliWrapper->>CliWrapper: boot()
+     *   Note over CliWrapper: Loads all modules
+     *   CliWrapper->>Command: parseAsync(args)
+     *   Command-->>CliWrapper: result
+     *   CliWrapper-->>Client: result
+     */
+    run(args?: string[]): Promise<void>;
+}

package/lib/bin/cli.cjs

@@ -1,62 +1,38 @@
+#!/usr/bin/env node
 "use strict";
 /**
- * @namespace cli
- * @description This script demonstrates a basic command-line interface (CLI) that counts down from 60 seconds and then exits.
- * @summary A simple CLI countdown timer that serves as a minimal example of how to create a CLI application using TypeScript.
- *
- * All files in the ./src/bin folder will have `#!/usr/bin/env node` included at the beginning of the file
- *
+ * BIN_CALL_PLACEHOLDER - DO NOT REMOVE
+ */
+/**
+ * @description Decaf-ts' CLI entry point
+ * @summary This file serves as the main executable entry point for the Decaf CLI. It creates a CliWrapper instance
+ * and runs it with the process arguments. The CLI will crawl the current working directory for files called
+ * MCP_FILE_NAME within the @decaf-ts namespace and load them as subcommands.
  *
  * @example
- * // Run the script
- * node cli.js
+ * // Run a module command
+ * $ npx decaf <module name> <module command> ...<module command options>
  *
- * @mermaid
- * sequenceDiagram
- *   participant User
- *   participant CLI
- *   participant Timer
- *   User->>CLI: Run script
- *   CLI->>User: Display initial message
- *   CLI->>Timer: Start countdown
- *   loop Every second
- *     Timer->>CLI: Decrement counter
- *     CLI->>User: Display current count
- *   end
- *   Timer->>CLI: Counter reaches 0
- *   CLI->>User: Exit process
+ * // Get help for a specific module
+ * $ npx decaf help <module name>
  *
- * @memberOf module:ts-workspace
- * @see {@link https://nodejs.org/api/process.html#process_process_exit_code|Node.js process.exit()}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/setTimeout|MDN setTimeout()}
- */
-/**
- * @const counter
- * @name counter
- * @description The countdown timer, initialized to 60 seconds.
- * @summary Used to track the remaining time in the countdown.
- * @type {number}
- * @memberOf module:ts-workspace.cli
- */
-let counter = 60;
-console.log(`This is a poor example of a cli. will stop in ${60} seconds`);
-/**
- * @function iterator
- * @description A recursive function that manages the countdown timer.
- * @summary It uses setTimeout to create a delay of 1 second between each count.
- * The function decrements the counter, logs the current count, and calls itself
- * until the counter reaches 0. When the counter reaches 0, the process exits.
+ * // List all imported modules
+ * $ npx decaf list
+ *
+ * // Get general CLI help
+ * $ npx decaf help
  *
- * @return {void}
- * @memberOf module:ts-workspace.cli
+ * @memberOf module:MCP
  */
-function iterator() {
-    setTimeout(() => {
-        if (!--counter)
-            process.exit(1);
-        console.log(counter);
-        iterator();
-    }, 1000);
-}
-iterator();
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Jpbi9jbGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E4Qkc7QUFFSDs7Ozs7OztHQU9HO0FBQ0gsSUFBSSxPQUFPLEdBQUcsRUFBRSxDQUFDO0FBQ2pCLE9BQU8sQ0FBQyxHQUFHLENBQUMsaURBQWlELEVBQUUsVUFBVSxDQUFDLENBQUM7QUFFM0U7Ozs7Ozs7OztHQVNHO0FBQ0gsU0FBUyxRQUFRO0lBQ2YsVUFBVSxDQUFDLEdBQUcsRUFBRTtRQUNkLElBQUksQ0FBQyxFQUFFLE9BQU87WUFBRSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQ2hDLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDckIsUUFBUSxFQUFFLENBQUM7SUFDYixDQUFDLEVBQUUsSUFBSSxDQUFDLENBQUM7QUFDWCxDQUFDO0FBRUQsUUFBUSxFQUFFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBuYW1lc3BhY2UgY2xpXG4gKiBAZGVzY3JpcHRpb24gVGhpcyBzY3JpcHQgZGVtb25zdHJhdGVzIGEgYmFzaWMgY29tbWFuZC1saW5lIGludGVyZmFjZSAoQ0xJKSB0aGF0IGNvdW50cyBkb3duIGZyb20gNjAgc2Vjb25kcyBhbmQgdGhlbiBleGl0cy5cbiAqIEBzdW1tYXJ5IEEgc2ltcGxlIENMSSBjb3VudGRvd24gdGltZXIgdGhhdCBzZXJ2ZXMgYXMgYSBtaW5pbWFsIGV4YW1wbGUgb2YgaG93IHRvIGNyZWF0ZSBhIENMSSBhcHBsaWNhdGlvbiB1c2luZyBUeXBlU2NyaXB0LlxuICpcbiAqIEFsbCBmaWxlcyBpbiB0aGUgLi9zcmMvYmluIGZvbGRlciB3aWxsIGhhdmUgYCMhL3Vzci9iaW4vZW52IG5vZGVgIGluY2x1ZGVkIGF0IHRoZSBiZWdpbm5pbmcgb2YgdGhlIGZpbGVcbiAqXG4gKlxuICogQGV4YW1wbGVcbiAqIC8vIFJ1biB0aGUgc2NyaXB0XG4gKiBub2RlIGNsaS5qc1xuICpcbiAqIEBtZXJtYWlkXG4gKiBzZXF1ZW5jZURpYWdyYW1cbiAqICAgcGFydGljaXBhbnQgVXNlclxuICogICBwYXJ0aWNpcGFudCBDTElcbiAqICAgcGFydGljaXBhbnQgVGltZXJcbiAqICAgVXNlci0+PkNMSTogUnVuIHNjcmlwdFxuICogICBDTEktPj5Vc2VyOiBEaXNwbGF5IGluaXRpYWwgbWVzc2FnZVxuICogICBDTEktPj5UaW1lcjogU3RhcnQgY291bnRkb3duXG4gKiAgIGxvb3AgRXZlcnkgc2Vjb25kXG4gKiAgICAgVGltZXItPj5DTEk6IERlY3JlbWVudCBjb3VudGVyXG4gKiAgICAgQ0xJLT4+VXNlcjogRGlzcGxheSBjdXJyZW50IGNvdW50XG4gKiAgIGVuZFxuICogICBUaW1lci0+PkNMSTogQ291bnRlciByZWFjaGVzIDBcbiAqICAgQ0xJLT4+VXNlcjogRXhpdCBwcm9jZXNzXG4gKlxuICogQG1lbWJlck9mIG1vZHVsZTp0cy13b3Jrc3BhY2VcbiAqIEBzZWUge0BsaW5rIGh0dHBzOi8vbm9kZWpzLm9yZy9hcGkvcHJvY2Vzcy5odG1sI3Byb2Nlc3NfcHJvY2Vzc19leGl0X2NvZGV8Tm9kZS5qcyBwcm9jZXNzLmV4aXQoKX1cbiAqIEBzZWUge0BsaW5rIGh0dHBzOi8vZGV2ZWxvcGVyLm1vemlsbGEub3JnL2VuLVVTL2RvY3MvV2ViL0FQSS9zZXRUaW1lb3V0fE1ETiBzZXRUaW1lb3V0KCl9XG4gKi9cblxuLyoqXG4gKiBAY29uc3QgY291bnRlclxuICogQG5hbWUgY291bnRlclxuICogQGRlc2NyaXB0aW9uIFRoZSBjb3VudGRvd24gdGltZXIsIGluaXRpYWxpemVkIHRvIDYwIHNlY29uZHMuXG4gKiBAc3VtbWFyeSBVc2VkIHRvIHRyYWNrIHRoZSByZW1haW5pbmcgdGltZSBpbiB0aGUgY291bnRkb3duLlxuICogQHR5cGUge251bWJlcn1cbiAqIEBtZW1iZXJPZiBtb2R1bGU6dHMtd29ya3NwYWNlLmNsaVxuICovXG5sZXQgY291bnRlciA9IDYwO1xuY29uc29sZS5sb2coYFRoaXMgaXMgYSBwb29yIGV4YW1wbGUgb2YgYSBjbGkuIHdpbGwgc3RvcCBpbiAkezYwfSBzZWNvbmRzYCk7XG5cbi8qKlxuICogQGZ1bmN0aW9uIGl0ZXJhdG9yXG4gKiBAZGVzY3JpcHRpb24gQSByZWN1cnNpdmUgZnVuY3Rpb24gdGhhdCBtYW5hZ2VzIHRoZSBjb3VudGRvd24gdGltZXIuXG4gKiBAc3VtbWFyeSBJdCB1c2VzIHNldFRpbWVvdXQgdG8gY3JlYXRlIGEgZGVsYXkgb2YgMSBzZWNvbmQgYmV0d2VlbiBlYWNoIGNvdW50LlxuICogVGhlIGZ1bmN0aW9uIGRlY3JlbWVudHMgdGhlIGNvdW50ZXIsIGxvZ3MgdGhlIGN1cnJlbnQgY291bnQsIGFuZCBjYWxscyBpdHNlbGZcbiAqIHVudGlsIHRoZSBjb3VudGVyIHJlYWNoZXMgMC4gV2hlbiB0aGUgY291bnRlciByZWFjaGVzIDAsIHRoZSBwcm9jZXNzIGV4aXRzLlxuICpcbiAqIEByZXR1cm4ge3ZvaWR9XG4gKiBAbWVtYmVyT2YgbW9kdWxlOnRzLXdvcmtzcGFjZS5jbGlcbiAqL1xuZnVuY3Rpb24gaXRlcmF0b3IoKSB7XG4gIHNldFRpbWVvdXQoKCkgPT4ge1xuICAgIGlmICghLS1jb3VudGVyKSBwcm9jZXNzLmV4aXQoMSk7XG4gICAgY29uc29sZS5sb2coY291bnRlcik7XG4gICAgaXRlcmF0b3IoKTtcbiAgfSwgMTAwMCk7XG59XG5cbml0ZXJhdG9yKCk7XG4iXX0=
+Object.defineProperty(exports, "__esModule", { value: true });
+const McpWrapper_1 = require("./../McpWrapper.cjs");
+new McpWrapper_1.McpWrapper()
+    .run(process.argv)
+    .then(() => {
+    console.log("Thank you for using decaf-ts' mcp server");
+})
+    .catch((e) => {
+    console.error(`${e instanceof Error ? e.message : e}`);
+    process.exit(1);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Jpbi9jbGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOztHQUVHO0FBQ0g7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBb0JHOztBQUVILG9EQUEyQztBQUMzQyxJQUFJLHVCQUFVLEVBQUU7S0FDYixHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQztLQUNqQixJQUFJLENBQUMsR0FBRyxFQUFFO0lBQ1QsT0FBTyxDQUFDLEdBQUcsQ0FBQywwQ0FBMEMsQ0FBQyxDQUFDO0FBQzFELENBQUMsQ0FBQztLQUNELEtBQUssQ0FBQyxDQUFDLENBQVUsRUFBRSxFQUFFO0lBQ3BCLE9BQU8sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ3ZELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDbEIsQ0FBQyxDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEJJTl9DQUxMX1BMQUNFSE9MREVSIC0gRE8gTk9UIFJFTU9WRVxuICovXG4vKipcbiAqIEBkZXNjcmlwdGlvbiBEZWNhZi10cycgQ0xJIGVudHJ5IHBvaW50XG4gKiBAc3VtbWFyeSBUaGlzIGZpbGUgc2VydmVzIGFzIHRoZSBtYWluIGV4ZWN1dGFibGUgZW50cnkgcG9pbnQgZm9yIHRoZSBEZWNhZiBDTEkuIEl0IGNyZWF0ZXMgYSBDbGlXcmFwcGVyIGluc3RhbmNlXG4gKiBhbmQgcnVucyBpdCB3aXRoIHRoZSBwcm9jZXNzIGFyZ3VtZW50cy4gVGhlIENMSSB3aWxsIGNyYXdsIHRoZSBjdXJyZW50IHdvcmtpbmcgZGlyZWN0b3J5IGZvciBmaWxlcyBjYWxsZWRcbiAqIE1DUF9GSUxFX05BTUUgd2l0aGluIHRoZSBAZGVjYWYtdHMgbmFtZXNwYWNlIGFuZCBsb2FkIHRoZW0gYXMgc3ViY29tbWFuZHMuXG4gKlxuICogQGV4YW1wbGVcbiAqIC8vIFJ1biBhIG1vZHVsZSBjb21tYW5kXG4gKiAkIG5weCBkZWNhZiA8bW9kdWxlIG5hbWU+IDxtb2R1bGUgY29tbWFuZD4gLi4uPG1vZHVsZSBjb21tYW5kIG9wdGlvbnM+XG4gKlxuICogLy8gR2V0IGhlbHAgZm9yIGEgc3BlY2lmaWMgbW9kdWxlXG4gKiAkIG5weCBkZWNhZiBoZWxwIDxtb2R1bGUgbmFtZT5cbiAqXG4gKiAvLyBMaXN0IGFsbCBpbXBvcnRlZCBtb2R1bGVzXG4gKiAkIG5weCBkZWNhZiBsaXN0XG4gKlxuICogLy8gR2V0IGdlbmVyYWwgQ0xJIGhlbHBcbiAqICQgbnB4IGRlY2FmIGhlbHBcbiAqXG4gKiBAbWVtYmVyT2YgbW9kdWxlOk1DUFxuICovXG5cbmltcG9ydCB7IE1jcFdyYXBwZXIgfSBmcm9tIFwiLi4vTWNwV3JhcHBlclwiO1xubmV3IE1jcFdyYXBwZXIoKVxuICAucnVuKHByb2Nlc3MuYXJndilcbiAgLnRoZW4oKCkgPT4ge1xuICAgIGNvbnNvbGUubG9nKFwiVGhhbmsgeW91IGZvciB1c2luZyBkZWNhZi10cycgbWNwIHNlcnZlclwiKTtcbiAgfSlcbiAgLmNhdGNoKChlOiB1bmtub3duKSA9PiB7XG4gICAgY29uc29sZS5lcnJvcihgJHtlIGluc3RhbmNlb2YgRXJyb3IgPyBlLm1lc3NhZ2UgOiBlfWApO1xuICAgIHByb2Nlc3MuZXhpdCgxKTtcbiAgfSk7XG4iXX0=

package/lib/bin/cli.d.ts

@@ -1,51 +1,25 @@
 /**
- * @namespace cli
- * @description This script demonstrates a basic command-line interface (CLI) that counts down from 60 seconds and then exits.
- * @summary A simple CLI countdown timer that serves as a minimal example of how to create a CLI application using TypeScript.
- *
- * All files in the ./src/bin folder will have `#!/usr/bin/env node` included at the beginning of the file
- *
+ * BIN_CALL_PLACEHOLDER - DO NOT REMOVE
+ */
+/**
+ * @description Decaf-ts' CLI entry point
+ * @summary This file serves as the main executable entry point for the Decaf CLI. It creates a CliWrapper instance
+ * and runs it with the process arguments. The CLI will crawl the current working directory for files called
+ * MCP_FILE_NAME within the @decaf-ts namespace and load them as subcommands.
  *
  * @example
- * // Run the script
- * node cli.js
+ * // Run a module command
+ * $ npx decaf <module name> <module command> ...<module command options>
  *
- * @mermaid
- * sequenceDiagram
- *   participant User
- *   participant CLI
- *   participant Timer
- *   User->>CLI: Run script
- *   CLI->>User: Display initial message
- *   CLI->>Timer: Start countdown
- *   loop Every second
- *     Timer->>CLI: Decrement counter
- *     CLI->>User: Display current count
- *   end
- *   Timer->>CLI: Counter reaches 0
- *   CLI->>User: Exit process
+ * // Get help for a specific module
+ * $ npx decaf help <module name>
  *
- * @memberOf module:ts-workspace
- * @see {@link https://nodejs.org/api/process.html#process_process_exit_code|Node.js process.exit()}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/setTimeout|MDN setTimeout()}
- */
-/**
- * @const counter
- * @name counter
- * @description The countdown timer, initialized to 60 seconds.
- * @summary Used to track the remaining time in the countdown.
- * @type {number}
- * @memberOf module:ts-workspace.cli
- */
-declare let counter: number;
-/**
- * @function iterator
- * @description A recursive function that manages the countdown timer.
- * @summary It uses setTimeout to create a delay of 1 second between each count.
- * The function decrements the counter, logs the current count, and calls itself
- * until the counter reaches 0. When the counter reaches 0, the process exits.
+ * // List all imported modules
+ * $ npx decaf list
+ *
+ * // Get general CLI help
+ * $ npx decaf help
  *
- * @return {void}
- * @memberOf module:ts-workspace.cli
+ * @memberOf module:MCP
  */
-declare function iterator(): void;
+export {};

package/lib/constants.cjs

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_FILE_NAME = void 0;
+/**
+ * @description The filename that identifies Decaf CLI modules
+ * @summary The standard filename for CLI module files where each library must export a single CliModule function
+ *
+ * @const MCP_FILE_NAME
+ * @memberOf module:MCP
+ */
+exports.MCP_FILE_NAME = "mcp-module";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQTs7Ozs7O0dBTUc7QUFDVSxRQUFBLGFBQWEsR0FBRyxZQUFZLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBkZXNjcmlwdGlvbiBUaGUgZmlsZW5hbWUgdGhhdCBpZGVudGlmaWVzIERlY2FmIENMSSBtb2R1bGVzXG4gKiBAc3VtbWFyeSBUaGUgc3RhbmRhcmQgZmlsZW5hbWUgZm9yIENMSSBtb2R1bGUgZmlsZXMgd2hlcmUgZWFjaCBsaWJyYXJ5IG11c3QgZXhwb3J0IGEgc2luZ2xlIENsaU1vZHVsZSBmdW5jdGlvblxuICpcbiAqIEBjb25zdCBNQ1BfRklMRV9OQU1FXG4gKiBAbWVtYmVyT2YgbW9kdWxlOk1DUFxuICovXG5leHBvcnQgY29uc3QgTUNQX0ZJTEVfTkFNRSA9IFwibWNwLW1vZHVsZVwiO1xuIl19

package/lib/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @description The filename that identifies Decaf CLI modules
+ * @summary The standard filename for CLI module files where each library must export a single CliModule function
+ *
+ * @const MCP_FILE_NAME
+ * @memberOf module:MCP
+ */
+export declare const MCP_FILE_NAME = "mcp-module";

package/lib/esm/McpWrapper.d.ts

@@ -0,0 +1,101 @@
+import { LoggedClass } from "@decaf-ts/logging";
+/**
+ * @description Utility class to handle CLI functionality from all Decaf modules
+ * @summary This class provides a wrapper around Commander.js to handle CLI commands from different Decaf modules.
+ * It crawls the filesystem to find CLI modules, loads them, and registers their commands.
+ *
+ * @param {string} [basePath] The base path to look for modules in. Defaults to `./`
+ * @param {number} [crawlLevels] Number of folder levels to crawl to find modules from the basePath. Defaults to 4
+ *
+ * @example
+ * // Create a new CLI wrapper and run it with custom options
+ * const cli = new CliWrapper('./src', 2);
+ * cli.run(process.argv).then(() => {
+ *   console.log('CLI commands executed successfully');
+ * });
+ *
+ * @class McpWrapper
+ */
+export declare class McpWrapper extends LoggedClass {
+    private basePath;
+    private crawlLevels;
+    private _mcp?;
+    private modules;
+    private readonly rootPath;
+    constructor(basePath?: string, crawlLevels?: number);
+    /**
+     * @description Retrieves and initializes the Commander Command object
+     * @summary Lazy-loads the Command object, initializing it with the package name, description, and version
+     * @return {Command} The initialized Command object
+     * @private
+     */
+    private get mcp();
+    /**
+     * @description Loads and registers an mcp extension module from a file
+     * @summary Dynamically imports an mcp extension module from the specified file path, initializes it, and registers it in the modules collection
+     *
+     */
+    private load;
+    /**
+     * @description Finds and loads all CLI modules in the basePath
+     * @summary Uses the crawl method to find all CLI modules in the specified base path,
+     * then loads and registers each module as a subcommand
+     *
+     * @return {Promise<void>} A promise that resolves when all modules are loaded
+     *
+     * @private
+     * @mermaid
+     * sequenceDiagram
+     *   participant CliWrapper
+     *   participant Filesystem
+     *   participant Module
+     *
+     *   CliWrapper->>Filesystem: Join basePath with cwd
+     *   CliWrapper->>CliWrapper: crawl(basePath, crawlLevels)
+     *   CliWrapper-->>CliWrapper: modules[]
+     *   loop For each module
+     *     alt Not @decaf-ts/cli
+     *       CliWrapper->>CliWrapper: load(module, cwd)
+     *       CliWrapper-->>CliWrapper: name
+     *       CliWrapper->>CliWrapper: Check if command exists
+     *       alt Command doesn't exist
+     *         CliWrapper->>Command: command(name).addCommand(modules[name])
+     *       end
+     *     end
+     *   end
+     *   CliWrapper->>Console: Log loaded modules
+     */
+    private boot;
+    /**
+     * @description Recursively searches for CLI module files in the directory structure
+     * @summary Crawls the basePath up to the specified number of folder levels to find files named according to CLI_FILE_NAME
+     *
+     * @param {string} basePath The absolute base path to start searching in
+     * @param {number} [levels=2] The maximum number of directory levels to crawl
+     * @return {string[]} An array of file paths to CLI modules
+     *
+     * @private
+     */
+    private crawl;
+    /**
+     * @description Executes the CLI with the provided arguments
+     * @summary Boots the CLI by loading all modules, then parses and executes the command specified in the arguments
+     *
+     * @param {string[]} [args=process.argv] Command line arguments to parse and execute
+     * @return {Promise<void>} A promise that resolves when the command execution is complete
+     *
+     * @mermaid
+     * sequenceDiagram
+     *   participant Client
+     *   participant CliWrapper
+     *   participant Command
+     *
+     *   Client->>CliWrapper: run(args)
+     *   CliWrapper->>CliWrapper: boot()
+     *   Note over CliWrapper: Loads all modules
+     *   CliWrapper->>Command: parseAsync(args)
+     *   Command-->>CliWrapper: result
+     *   CliWrapper-->>Client: result
+     */
+    run(args?: string[]): Promise<void>;
+}