@ibm/ibmi-mcp-server 0.3.2 → 0.4.1

package/dist/cli/commands/tool.js

@@ -0,0 +1,194 @@
+/**
+ * @fileoverview Dynamic YAML tool execution command.
+ *
+ * `ibmi tool <name> [options]` — run any YAML-defined tool from the CLI.
+ *
+ * The command uses allowUnknownOption() to accept arbitrary tool-specific
+ * options, then resolves them against the YAML parameter definitions.
+ *
+ * Supports --dry-run to show the resolved SQL and parameters without executing.
+ *
+ * @module cli/commands/tool
+ */
+import { Command } from "commander";
+import { loadYamlTools, } from "../utils/yaml-loader.js";
+import { registerToolOptions, optsToParams, validateRequiredParams, } from "../utils/yaml-to-commander.js";
+import { getFormat, isStreaming, createCliContext, } from "../utils/command-helpers.js";
+import { resolveSystem } from "../config/resolver.js";
+import { connectSystem } from "../utils/connection.js";
+import { renderOutput, renderNdjson, renderError, } from "../formatters/output.js";
+import { ExitCode, classifyError, ErrorCode } from "../utils/exit-codes.js";
+/**
+ * Register `ibmi tool <name>` — dynamic YAML tool execution.
+ */
+export function registerToolCommand(program) {
+    program
+        .command("tool <name>")
+        .description("Run a YAML-defined tool by name")
+        .option("--dry-run", "Show resolved SQL and parameters without executing")
+        .allowUnknownOption()
+        .allowExcessArguments()
+        .action(async (name, _opts, cmd) => {
+        const format = getFormat(cmd);
+        try {
+            // Resolve --tools paths from global options
+            const globalOpts = cmd.optsWithGlobals();
+            const toolsOpt = globalOpts["tools"];
+            if (!toolsOpt) {
+                renderError(new Error("No tools path specified. Use --tools <path> to specify YAML tool file(s)."), format, undefined, ErrorCode.USAGE_ERROR);
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+            const paths = toolsOpt.split(",").map((p) => p.trim());
+            const config = loadYamlTools(paths);
+            // Find the tool
+            const tool = config.tools[name];
+            if (!tool) {
+                const available = Object.keys(config.tools).join(", ");
+                renderError(new Error(`Tool '${name}' not found. Available tools: ${available || "(none)"}`), format, undefined, ErrorCode.NOT_FOUND);
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+            // Build a sub-command with tool-specific options and re-parse
+            const toolParams = resolveToolParams(cmd, tool);
+            // Validate required parameters
+            const missing = validateRequiredParams(toolParams, tool.parameters);
+            if (missing.length > 0) {
+                const flags = missing.map((n) => `--${n.replace(/_/g, "-")}`).join(", ");
+                renderError(new Error(`Missing required parameter(s): ${flags}`), format, undefined, ErrorCode.USAGE_ERROR);
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+            // Dry-run: show SQL and parameters
+            const dryRun = globalOpts["dryRun"] || _opts["dryRun"];
+            if (dryRun) {
+                await handleDryRun(name, tool, toolParams, cmd);
+                return;
+            }
+            // Execute the tool
+            await executeTool(name, tool, toolParams, cmd);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            const classified = classifyError(error);
+            renderError(error, format, undefined, classified.errorCode);
+            process.exitCode = classified.exitCode;
+        }
+    });
+}
+/**
+ * Parse tool-specific options from the raw argv using a dynamic Commander sub-command.
+ */
+function resolveToolParams(cmd, tool) {
+    if (tool.parameters.length === 0)
+        return {};
+    // Build a temporary command with tool-specific options
+    const tempCmd = new Command("temp");
+    tempCmd.exitOverride();
+    tempCmd.allowUnknownOption();
+    registerToolOptions(tempCmd, tool.parameters);
+    // Extract the raw args that were passed through by the parent command
+    // Commander stores unparsed args in cmd.args (after the <name> positional)
+    const rawArgs = cmd.args ?? [];
+    try {
+        tempCmd.parse(rawArgs, { from: "user" });
+    }
+    catch {
+        // Commander may throw for unrecognized options; we allow that
+    }
+    return optsToParams(tempCmd.opts(), tool.parameters);
+}
+/**
+ * Handle --dry-run: show resolved SQL and parameters.
+ */
+async function handleDryRun(name, tool, params, cmd) {
+    const format = getFormat(cmd);
+    if (!tool.statement) {
+        renderError(new Error(`Tool '${name}' has no SQL statement defined.`), format, undefined, ErrorCode.USAGE_ERROR);
+        process.exitCode = ExitCode.USAGE;
+        return;
+    }
+    if (format === "json") {
+        renderOutput([
+            {
+                tool: name,
+                dry_run: true,
+                sql: tool.statement.trim(),
+                parameters: params,
+            },
+        ], format, { rowCount: 1, command: `tool:${name}` });
+        return;
+    }
+    // Human-readable dry-run output
+    const globalOpts = cmd.optsWithGlobals();
+    const systemName = globalOpts["system"];
+    const lines = [];
+    if (systemName) {
+        lines.push(`Would execute on [${systemName}]:`);
+    }
+    else {
+        lines.push("Would execute:");
+    }
+    lines.push("────────────────────────────────────────");
+    lines.push(tool.statement.trim());
+    if (Object.keys(params).length > 0) {
+        lines.push("");
+        lines.push(`Parameters: ${JSON.stringify(params)}`);
+    }
+    lines.push("────────────────────────────────────────");
+    process.stdout.write(lines.join("\n") + "\n");
+}
+/**
+ * Execute a YAML tool against the connected system.
+ */
+async function executeTool(name, tool, params, cmd) {
+    const format = getFormat(cmd);
+    const stream = isStreaming(cmd);
+    const globalOpts = cmd.optsWithGlobals();
+    if (!tool.statement) {
+        renderError(new Error(`Tool '${name}' has no SQL statement defined.`), format, undefined, ErrorCode.USAGE_ERROR);
+        process.exitCode = ExitCode.USAGE;
+        return;
+    }
+    // Resolve system and connect
+    const resolved = resolveSystem(globalOpts["system"]);
+    const cleanup = await connectSystem(resolved);
+    try {
+        const ctx = createCliContext(name);
+        const startTime = Date.now();
+        // Dynamic import to avoid loading server infrastructure until execution time
+        const { ParameterProcessor } = await import("../../ibmi-mcp-server/utils/sql/parameterProcessor.js");
+        const { IBMiConnectionPool } = await import("../../ibmi-mcp-server/services/connectionPool.js");
+        // Process SQL parameters (BindingValue from mapepire-js)
+        let processedSql;
+        let bindingParams = [];
+        if (tool.parameters.length > 0 && Object.keys(params).length > 0) {
+            // Convert YamlToolParameter[] to the SqlToolParameter shape expected by ParameterProcessor
+            const result = await ParameterProcessor.process(tool.statement, params, tool.parameters, { context: ctx });
+            processedSql = result.sql;
+            bindingParams = result.parameters;
+        }
+        else {
+            processedSql = tool.statement;
+        }
+        // Execute the query
+        const result = await IBMiConnectionPool.executeQuery(processedSql, bindingParams, ctx);
+        const elapsedMs = Date.now() - startTime;
+        const data = (result.data ?? []);
+        // NDJSON streaming: one JSON object per line
+        if (stream && format === "json") {
+            renderNdjson(data);
+            return;
+        }
+        renderOutput(data, format, {
+            rowCount: data.length,
+            elapsedMs,
+            system: resolved,
+            command: `tool:${name}`,
+        });
+    }
+    finally {
+        await cleanup();
+    }
+}
+//# sourceMappingURL=tool.js.map

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

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

package/dist/cli/commands/tools-list.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @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 { Command } from "commander";
+/**
+ * Register `ibmi tools` — list available YAML tools.
+ */
+export declare function registerToolsCommand(program: Command): void;
+/**
+ * Register `ibmi toolsets` — list available toolsets.
+ */
+export declare function registerToolsetsCommand(program: Command): void;
+//# sourceMappingURL=tools-list.d.ts.map

package/dist/cli/commands/tools-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tools-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CpC;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+I3D;AAoBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoC9D"}

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"}