@ibm/ibmi-mcp-server 0.3.2 → 0.4.0

package/dist/cli/commands/tools-list.js

@@ -0,0 +1,209 @@
+/**
+ * @fileoverview Discovery commands for YAML-defined tools.
+ *
+ * - `ibmi tools` — List all available tools
+ * - `ibmi tools show <name>` — Show detailed info for a single tool
+ * - `ibmi toolsets` — List all toolsets
+ *
+ * These are read-only commands that parse YAML files without connecting to a system.
+ * @module cli/commands/tools-list
+ */
+import { loadYamlTools, buildToolsetMap, } from "../utils/yaml-loader.js";
+import { getFormat } from "../utils/command-helpers.js";
+import { renderOutput, renderError, renderMessage, } from "../formatters/output.js";
+import { ExitCode } from "../utils/exit-codes.js";
+/**
+ * Resolve the --tools paths from command options.
+ * Falls back to the default tools/ directory relative to the package root.
+ */
+function resolveToolsPaths(cmd) {
+    const opts = cmd.optsWithGlobals();
+    const toolsOpt = opts["tools"];
+    if (toolsOpt) {
+        return toolsOpt.split(",").map((p) => p.trim());
+    }
+    return [];
+}
+/**
+ * Load YAML tools config from CLI options, with error handling.
+ */
+function loadToolsConfig(cmd) {
+    const paths = resolveToolsPaths(cmd);
+    if (paths.length === 0) {
+        process.stderr.write("No tools path specified. Use --tools <path> to specify YAML tool file(s) or directory.\n");
+        return null;
+    }
+    return loadYamlTools(paths);
+}
+/**
+ * Register `ibmi tools` — list available YAML tools.
+ */
+export function registerToolsCommand(program) {
+    const toolsCmd = program
+        .command("tools")
+        .description("List available YAML-defined tools")
+        .option("--toolset <name>", "Filter by toolset name");
+    // ibmi tools (default: list all)
+    toolsCmd.action((opts, cmd) => {
+        const format = getFormat(cmd);
+        try {
+            const config = loadToolsConfig(cmd);
+            if (!config) {
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+            const toolsetMap = buildToolsetMap(config.toolsets);
+            const toolsetFilter = opts["toolset"];
+            const rows = [];
+            for (const [name, tool] of Object.entries(config.tools)) {
+                if (tool.enabled === false)
+                    continue;
+                const toolsets = toolsetMap.get(name) ?? [];
+                // Filter by toolset if specified
+                if (toolsetFilter && !toolsets.includes(toolsetFilter))
+                    continue;
+                rows.push({
+                    TOOL: name,
+                    TOOLSET: toolsets.join(", ") || "-",
+                    DESCRIPTION: tool.description,
+                    PARAMS: tool.parameters.length,
+                    READ_ONLY: tool.security?.readOnly ?? tool.annotations?.["readOnlyHint"] ?? true,
+                });
+            }
+            if (rows.length === 0) {
+                renderMessage(toolsetFilter
+                    ? `No tools found in toolset '${toolsetFilter}'.`
+                    : "No tools found.", format);
+                return;
+            }
+            renderOutput(rows, format, { rowCount: rows.length });
+        }
+        catch (err) {
+            renderError(err instanceof Error ? err : new Error(String(err)), format);
+            process.exitCode = ExitCode.GENERAL;
+        }
+    });
+    // ibmi tools show <name>
+    toolsCmd
+        .command("show <name>")
+        .description("Show detailed information for a tool")
+        .action((name, _opts, cmd) => {
+        const format = getFormat(cmd);
+        try {
+            const config = loadToolsConfig(cmd);
+            if (!config) {
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+            const tool = config.tools[name];
+            if (!tool) {
+                renderError(new Error(`Tool '${name}' not found. Use 'ibmi tools --tools <path>' to list available tools.`), format);
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+            const toolsetMap = buildToolsetMap(config.toolsets);
+            const toolsets = toolsetMap.get(name) ?? [];
+            if (format === "json") {
+                // JSON: output structured data
+                renderOutput([
+                    {
+                        name,
+                        description: tool.description,
+                        source: tool.source,
+                        toolsets,
+                        readOnly: tool.security?.readOnly ?? true,
+                        parameters: tool.parameters,
+                        sql: tool.statement ?? null,
+                    },
+                ], format, { rowCount: 1 });
+            }
+            else {
+                // Human-readable detail view
+                const lines = [];
+                lines.push(`Tool: ${name}`);
+                lines.push(`Description: ${tool.description}`);
+                lines.push(`Source: ${tool.source}`);
+                if (toolsets.length > 0) {
+                    lines.push(`Toolsets: ${toolsets.join(", ")}`);
+                }
+                lines.push(`Read-only: ${tool.security?.readOnly ?? tool.annotations?.["readOnlyHint"] ?? true}`);
+                lines.push("");
+                // Parameters
+                if (tool.parameters.length > 0) {
+                    lines.push("Parameters:");
+                    for (const p of tool.parameters) {
+                        lines.push(formatParameter(p));
+                    }
+                }
+                else {
+                    lines.push("Parameters: (none)");
+                }
+                lines.push("");
+                // SQL
+                if (tool.statement) {
+                    lines.push("SQL:");
+                    lines.push(tool.statement.trim());
+                }
+                process.stdout.write(lines.join("\n") + "\n");
+            }
+        }
+        catch (err) {
+            renderError(err instanceof Error ? err : new Error(String(err)), format);
+            process.exitCode = ExitCode.GENERAL;
+        }
+    });
+}
+/**
+ * Format a parameter for human-readable display.
+ */
+function formatParameter(p) {
+    const parts = [];
+    parts.push(`  --${p.name.replace(/_/g, "-")}`);
+    parts.push(`(${p.type})`);
+    if (p.required)
+        parts.push("[required]");
+    if (p.default !== undefined)
+        parts.push(`default: ${JSON.stringify(p.default)}`);
+    if (p.enum && p.enum.length > 0) {
+        parts.push(`choices: ${p.enum.join(", ")}`);
+    }
+    if (p.description)
+        parts.push(`— ${p.description}`);
+    return parts.join(" ");
+}
+/**
+ * Register `ibmi toolsets` — list available toolsets.
+ */
+export function registerToolsetsCommand(program) {
+    program
+        .command("toolsets")
+        .description("List available toolsets")
+        .action((_opts, cmd) => {
+        const format = getFormat(cmd);
+        try {
+            const config = loadToolsConfig(cmd);
+            if (!config) {
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+            const rows = [];
+            for (const [name, ts] of Object.entries(config.toolsets)) {
+                rows.push({
+                    TOOLSET: name,
+                    TOOLS: ts.tools.length,
+                    DESCRIPTION: ts.description ?? ts.title ?? "-",
+                });
+            }
+            if (rows.length === 0) {
+                renderMessage("No toolsets found.", format);
+                return;
+            }
+            renderOutput(rows, format, { rowCount: rows.length });
+        }
+        catch (err) {
+            renderError(err instanceof Error ? err : new Error(String(err)), format);
+            process.exitCode = ExitCode.GENERAL;
+        }
+    });
+}
+//# sourceMappingURL=tools-list.js.map

package/dist/cli/commands/tools-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-list.js","sourceRoot":"","sources":["../../../src/cli/commands/tools-list.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview `ibmi validate "<sql>"` command — validate SQL syntax and object references.
+ * @module cli/commands/validate
+ */
+import { Command } from "commander";
+export declare function registerValidateCommand(program: Command): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwF9D"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview `ibmi validate "<sql>"` command — validate SQL syntax and object references.
+ * @module cli/commands/validate
+ */
+import { withConnection } from "../utils/command-helpers.js";
+export function registerValidateCommand(program) {
+    program
+        .command("validate <sql>")
+        .description("Validate SQL syntax and verify referenced objects exist")
+        .action(async (sql, _opts, cmd) => {
+        await withConnection(cmd, "validate_query", async (_resolved, ctx) => {
+            const { validateQueryLogic } = await import("../../ibmi-mcp-server/tools/validateQuery.tool.js");
+            const result = await validateQueryLogic({ sql_statement: sql }, ctx, {});
+            if (!result.success) {
+                throw new Error(result.error?.message ?? "Failed to validate query");
+            }
+            // Build a summary view for CLI output
+            const summary = [];
+            // Parse results summary
+            if (result.data && result.data.length > 0) {
+                const stmtTypes = [
+                    ...new Set(result.data
+                        .map((r) => r.SQL_STATEMENT_TYPE)
+                        .filter(Boolean)),
+                ];
+                summary.push({
+                    CHECK: "Syntax",
+                    STATUS: "PASS",
+                    DETAILS: stmtTypes.length > 0
+                        ? `Statement type: ${stmtTypes.join(", ")}`
+                        : "Parsed successfully",
+                });
+            }
+            else {
+                summary.push({
+                    CHECK: "Syntax",
+                    STATUS: "FAIL",
+                    DETAILS: "Statement could not be parsed (syntax error)",
+                });
+            }
+            // Object validation summary
+            const ov = result.objectValidation;
+            if (ov) {
+                summary.push({
+                    CHECK: "Tables",
+                    STATUS: ov.tables.invalid.length === 0 ? "PASS" : "FAIL",
+                    DETAILS: ov.tables.invalid.length === 0
+                        ? `${ov.tables.valid.length} table(s) verified`
+                        : `Not found: ${ov.tables.invalid.join(", ")}`,
+                });
+                if (ov.columns.valid.length > 0 || ov.columns.invalid.length > 0) {
+                    summary.push({
+                        CHECK: "Columns",
+                        STATUS: ov.columns.invalid.length === 0 ? "PASS" : "WARN",
+                        DETAILS: ov.columns.invalid.length === 0
+                            ? `${ov.columns.valid.length} column(s) verified`
+                            : `Not verified: ${ov.columns.invalid.join(", ")}`,
+                    });
+                }
+                if (ov.routines.valid.length > 0 || ov.routines.invalid.length > 0) {
+                    summary.push({
+                        CHECK: "Routines",
+                        STATUS: ov.routines.invalid.length === 0 ? "PASS" : "WARN",
+                        DETAILS: ov.routines.invalid.length === 0
+                            ? `${ov.routines.valid.length} routine(s) verified`
+                            : `Not verified: ${ov.routines.invalid.join(", ")}`,
+                    });
+                }
+            }
+            return {
+                data: summary,
+                meta: { rowCount: summary.length },
+            };
+        });
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"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"}

package/dist/cli/config/credentials.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Credential management for the IBM i CLI.
+ * Handles environment variable expansion in config values and interactive password prompting.
+ * @module cli/config/credentials
+ */
+/**
+ * Expand ${ENV_VAR} references in a string value.
+ * Returns the original string if no env var pattern is found or the var is not set.
+ */
+export declare function expandEnvVars(value: string): string;
+/**
+ * Prompt the user for a password interactively (hidden input).
+ * Returns the entered password string.
+ */
+export declare function promptPassword(prompt: string): Promise<string>;
+/**
+ * Resolve the password for a system config.
+ * Priority: config password (with env expansion) → interactive prompt.
+ */
+export declare function resolvePassword(systemName: string, configPassword: string | undefined, user: string, host: string): Promise<string>;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/cli/config/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/cli/config/credentials.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDpE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/cli/config/credentials.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Credential management for the IBM i CLI.
+ * Handles environment variable expansion in config values and interactive password prompting.
+ * @module cli/config/credentials
+ */
+import * as readline from "readline";
+/**
+ * Expand ${ENV_VAR} references in a string value.
+ * Returns the original string if no env var pattern is found or the var is not set.
+ */
+export function expandEnvVars(value) {
+    return value.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+        const envValue = process.env[varName];
+        if (envValue === undefined) {
+            return _match; // Leave unexpanded if not set
+        }
+        return envValue;
+    });
+}
+/**
+ * Prompt the user for a password interactively (hidden input).
+ * Returns the entered password string.
+ */
+export async function promptPassword(prompt) {
+    return new Promise((resolve, reject) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stderr, // Use stderr so it doesn't interfere with piped output
+            terminal: true,
+        });
+        // Disable echoing for password entry
+        if (process.stdin.isTTY) {
+            process.stderr.write(prompt);
+            const stdin = process.stdin;
+            const wasRaw = stdin.isRaw;
+            stdin.setRawMode(true);
+            let password = "";
+            const onData = (char) => {
+                const c = char.toString("utf8");
+                if (c === "\n" || c === "\r") {
+                    stdin.setRawMode(wasRaw ?? false);
+                    stdin.removeListener("data", onData);
+                    process.stderr.write("\n");
+                    rl.close();
+                    resolve(password);
+                }
+                else if (c === "\u0003") {
+                    // Ctrl+C — throw to let withConnection's finally block run cleanup
+                    stdin.setRawMode(wasRaw ?? false);
+                    stdin.removeListener("data", onData);
+                    process.stderr.write("\n");
+                    rl.close();
+                    reject(new Error("Cancelled"));
+                    return;
+                }
+                else if (c === "\u007f" || c === "\b") {
+                    // Backspace
+                    if (password.length > 0) {
+                        password = password.slice(0, -1);
+                    }
+                }
+                else {
+                    password += c;
+                }
+            };
+            stdin.on("data", onData);
+        }
+        else {
+            // Non-interactive: read a line
+            rl.question(prompt, (answer) => {
+                rl.close();
+                resolve(answer);
+            });
+        }
+    });
+}
+/**
+ * Resolve the password for a system config.
+ * Priority: config password (with env expansion) → interactive prompt.
+ */
+export async function resolvePassword(systemName, configPassword, user, host) {
+    if (configPassword) {
+        const expanded = expandEnvVars(configPassword);
+        // If expansion resolved to a non-empty value, use it
+        if (expanded && !expanded.includes("${")) {
+            return expanded;
+        }
+    }
+    // Fall back to interactive prompt
+    if (!process.stdin.isTTY) {
+        throw new Error(`No password configured for system "${systemName}" and stdin is not a terminal. ` +
+            `Set the password in config or via environment variable.`);
+    }
+    return promptPassword(`Password for ${user}@${host} [${systemName}]: `);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/cli/config/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../../src/cli/config/credentials.ts"],"names":[],"mappings":"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"}

package/dist/cli/config/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Barrel export for CLI configuration modules.
+ * @module cli/config
+ */
+export { CliConfigSchema, SystemConfigSchema, validateConfig } from "./schema.js";
+export { loadConfig, saveUserConfig, upsertSystem, removeSystem, setDefaultSystem, getProjectConfigPath, getUserConfigPath, } from "./loader.js";
+export { resolveSystem } from "./resolver.js";
+export { expandEnvVars, promptPassword, resolvePassword, } from "./credentials.js";
+export type { CliConfig, SystemConfig, ResolvedSystem, OutputFormat, GlobalOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/cli/config/index.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Barrel export for CLI configuration modules.
+ * @module cli/config
+ */
+export { CliConfigSchema, SystemConfigSchema, validateConfig } from "./schema.js";
+export { loadConfig, saveUserConfig, upsertSystem, removeSystem, setDefaultSystem, getProjectConfigPath, getUserConfigPath, } from "./loader.js";
+export { resolveSystem } from "./resolver.js";
+export { expandEnvVars, promptPassword, resolvePassword, } from "./credentials.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/cli/config/loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Configuration file loader for the IBM i CLI.
+ * Finds and parses .ibmi/config.yaml from project and user directories,
+ * merging them with project-level taking precedence.
+ * @module cli/config/loader
+ */
+import type { CliConfig, SystemConfig } from "./types.js";
+/** Get the project-level config file path (nearest .ibmi/config.yaml walking up from cwd). */
+export declare function getProjectConfigPath(): string;
+/** Get the user-level config file path. */
+export declare function getUserConfigPath(): string;
+/**
+ * Load the full CLI configuration by merging user-level and project-level configs.
+ * Project-level config takes precedence over user-level.
+ *
+ * @returns The merged, validated, and env-expanded configuration.
+ */
+export declare function loadConfig(): CliConfig;
+/**
+ * Save a config to the user-level config file.
+ */
+export declare function saveUserConfig(config: CliConfig): void;
+/**
+ * Add or update a system in the user config.
+ */
+export declare function upsertSystem(name: string, system: SystemConfig): void;
+/**
+ * Remove a system from the user config.
+ * @returns true if the system existed and was removed.
+ */
+export declare function removeSystem(name: string): boolean;
+/**
+ * Set the default system in the user config.
+ */
+export declare function setDefaultSystem(name: string): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/cli/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/cli/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgC1D,8FAA8F;AAC9F,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAkED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAsBtC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAatD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,GACnB,IAAI,CAgBN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAsBlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkBnD"}