@ibm/ibmi-mcp-server 0.3.1 → 0.4.0

package/README.md

@@ -1380,6 +1380,35 @@ MCP_RATE_LIMIT_ENABLED=false
 
 </details>
 
+<details>
+<summary><strong>🔄 Connection Pool Timeouts</strong></summary>
+
+Controls automatic cleanup of idle Mapepire connection pools and query execution timeouts. Essential for cloud deployments (Railway, Heroku, etc.) where reverse proxies silently kill idle TCP connections, causing queries on stale WebSocket connections to hang indefinitely.
+
+| Variable | Description | Default | Required |
+|----------|-------------|---------|----------|
+| `MCP_POOL_IDLE_TIMEOUT_MS` | Idle timeout for connection pools (ms). Pools closed after inactivity. Fresh connections established automatically on next request. Set to `0` to disable. | `300000` (5 min) | No |
+| `MCP_POOL_QUERY_TIMEOUT_MS` | Query execution timeout (ms). Queries aborted after this period. Pool re-initialized on next request after timeout. Set to `0` to disable. | `30000` (30s) | No |
+
+**Examples:**
+```bash
+# Default: 5-minute idle timeout, 30-second query timeout
+MCP_POOL_IDLE_TIMEOUT_MS=300000
+MCP_POOL_QUERY_TIMEOUT_MS=30000
+
+# Cloud deployment: shorter idle timeout for aggressive proxies
+MCP_POOL_IDLE_TIMEOUT_MS=60000
+MCP_POOL_QUERY_TIMEOUT_MS=30000
+
+# Disable both timeouts (stable network environments only)
+MCP_POOL_IDLE_TIMEOUT_MS=0
+MCP_POOL_QUERY_TIMEOUT_MS=0
+```
+
+> **How it works:** The idle timer checks pools at an interval of `max(10s, timeout/2)`. When a pool exceeds the idle timeout, it is closed — the next query triggers transparent re-initialization via the existing lazy-init path. The query timeout wraps `pool.execute()` with `Promise.race()`, so dead connections fail fast instead of hanging. On timeout, the pool is marked unhealthy and closed for re-initialization.
+
+</details>
+
 <details>
 <summary><strong>🔐 Authentication & Authorization</strong></summary>
 

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

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview `ibmi columns <schema> <table>` command — get column metadata.
+ * @module cli/commands/columns
+ */
+import { Command } from "commander";
+export declare function registerColumnsCommand(program: Command): void;
+//# sourceMappingURL=columns.d.ts.map

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

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

package/dist/cli/commands/columns.js

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview `ibmi columns <schema> <table>` command — get column metadata.
+ * @module cli/commands/columns
+ */
+import { withConnection } from "../utils/command-helpers.js";
+export function registerColumnsCommand(program) {
+    program
+        .command("columns <schema> <table>")
+        .description("Get column metadata for a table")
+        .action(async (schema, table, _opts, cmd) => {
+        await withConnection(cmd, "get_table_columns", async (_resolved, ctx) => {
+            const { getTableColumnsLogic } = await import("../../ibmi-mcp-server/tools/getTableColumns.tool.js");
+            const result = await getTableColumnsLogic({
+                schema_name: schema,
+                table_name: table,
+            }, ctx, {});
+            if (!result.success) {
+                throw new Error(result.error?.message ?? "Failed to get table columns");
+            }
+            return {
+                data: (result.data ?? []),
+                meta: {
+                    rowCount: result.rowCount ?? 0,
+                },
+            };
+        });
+    });
+}
+//# sourceMappingURL=columns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../../src/cli/commands/columns.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,0BAA0B,CAAC;SACnC,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,KAAa,EAAE,KAAK,EAAE,GAAY,EAAE,EAAE;QACnE,MAAM,cAAc,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE;YACtE,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,qDAAqD,CACtD,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC;gBACE,WAAW,EAAE,MAAM;gBACnB,UAAU,EAAE,KAAK;aAClB,EACD,GAAG,EACH,EAAgB,CACjB,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,6BAA6B,CAAC,CAAC;YAC1E,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAA8B;gBACtD,IAAI,EAAE;oBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;iBAC/B;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview `ibmi completion bash|zsh|fish` — generate shell completion scripts.
+ * @module cli/commands/completion
+ */
+import { Command } from "commander";
+/**
+ * Register `ibmi completion bash|zsh|fish`.
+ */
+export declare function registerCompletionCommand(program: Command): void;
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/completion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkNpC;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwBhE"}

package/dist/cli/commands/completion.js

@@ -0,0 +1,225 @@
+/**
+ * @fileoverview `ibmi completion bash|zsh|fish` — generate shell completion scripts.
+ * @module cli/commands/completion
+ */
+import { ExitCode } from "../utils/exit-codes.js";
+/** Top-level commands. */
+const COMMANDS = [
+    "system",
+    "schemas",
+    "tables",
+    "columns",
+    "related",
+    "validate",
+    "sql",
+    "tool",
+    "tools",
+    "toolsets",
+    "completion",
+];
+/** System subcommands. */
+const SYSTEM_SUBCOMMANDS = [
+    "list",
+    "show",
+    "add",
+    "remove",
+    "default",
+    "test",
+    "config-path",
+];
+/** Global options. */
+const GLOBAL_OPTIONS = [
+    "--system",
+    "--format",
+    "--raw",
+    "--stream",
+    "--tools",
+    "--output",
+    "--watch",
+    "--no-color",
+    "--version",
+    "--help",
+];
+/** Format choices. */
+const FORMAT_CHOICES = ["table", "json", "csv", "markdown"];
+/**
+ * Generate a bash completion script.
+ */
+function generateBash() {
+    return `# bash completion for ibmi
+# Add to ~/.bashrc: eval "$(ibmi completion bash)"
+
+_ibmi_completions() {
+  local cur prev commands system_commands global_opts format_choices
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  commands="${COMMANDS.join(" ")}"
+  system_commands="${SYSTEM_SUBCOMMANDS.join(" ")}"
+  global_opts="${GLOBAL_OPTIONS.join(" ")}"
+  format_choices="${FORMAT_CHOICES.join(" ")}"
+
+  # Complete --format values
+  if [[ "\${prev}" == "--format" ]]; then
+    COMPREPLY=( $(compgen -W "\${format_choices}" -- "\${cur}") )
+    return 0
+  fi
+
+  # Complete --system from config
+  if [[ "\${prev}" == "--system" ]]; then
+    local systems
+    if command -v yq &>/dev/null && [[ -f ~/.ibmi/config.yaml ]]; then
+      systems=$(yq -r '.systems | keys | .[]' ~/.ibmi/config.yaml 2>/dev/null)
+    elif command -v python3 &>/dev/null && [[ -f ~/.ibmi/config.yaml ]]; then
+      systems=$(python3 -c "import yaml; c=yaml.safe_load(open('$HOME/.ibmi/config.yaml')); print(' '.join(c.get('systems',{}).keys()))" 2>/dev/null)
+    fi
+    COMPREPLY=( $(compgen -W "\${systems}" -- "\${cur}") )
+    return 0
+  fi
+
+  # Complete file paths for --file, --tools, --output
+  if [[ "\${prev}" == "--file" || "\${prev}" == "--tools" || "\${prev}" == "--output" ]]; then
+    COMPREPLY=( $(compgen -f -- "\${cur}") )
+    return 0
+  fi
+
+  # Complete system subcommands
+  if [[ "\${COMP_WORDS[1]}" == "system" && \${COMP_CWORD} -eq 2 ]]; then
+    COMPREPLY=( $(compgen -W "\${system_commands}" -- "\${cur}") )
+    return 0
+  fi
+
+  # Complete top-level commands
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
+    return 0
+  fi
+
+  # Complete global options
+  if [[ "\${cur}" == -* ]]; then
+    COMPREPLY=( $(compgen -W "\${global_opts}" -- "\${cur}") )
+    return 0
+  fi
+}
+
+complete -F _ibmi_completions ibmi
+`;
+}
+/**
+ * Generate a zsh completion script.
+ */
+function generateZsh() {
+    return `#compdef ibmi
+# zsh completion for ibmi
+# Add to ~/.zshrc: eval "$(ibmi completion zsh)"
+
+_ibmi() {
+  local -a commands system_commands format_choices global_opts
+
+  commands=(
+${COMMANDS.map((c) => `    '${c}:${c} command'`).join("\n")}
+  )
+
+  system_commands=(
+${SYSTEM_SUBCOMMANDS.map((c) => `    '${c}:${c}'`).join("\n")}
+  )
+
+  format_choices=(table json csv markdown)
+
+  global_opts=(
+    '--system[Target system name]:system name:'
+    '--format[Output format]:format:(table json csv markdown)'
+    '--raw[Output as JSON]'
+    '--stream[Stream results as NDJSON]'
+    '--tools[Path to YAML tool files]:file:_files'
+    '--output[Write output to file]:file:_files'
+    '--watch[Re-run at interval]:seconds:'
+    '--no-color[Disable colored output]'
+    '--help[Show help]'
+    '--version[Show version]'
+  )
+
+  _arguments -C \\
+    $global_opts \\
+    '1:command:->command' \\
+    '*::arg:->args'
+
+  case $state in
+    command)
+      _describe -t commands 'ibmi commands' commands
+      ;;
+    args)
+      case $words[1] in
+        system)
+          _describe -t system_commands 'system subcommands' system_commands
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_ibmi "$@"
+`;
+}
+/**
+ * Generate a fish completion script.
+ */
+function generateFish() {
+    const lines = [
+        "# fish completion for ibmi",
+        "# Add to fish config: ibmi completion fish | source",
+        "",
+        "# Disable file completions by default",
+        "complete -c ibmi -f",
+        "",
+        "# Top-level commands",
+    ];
+    for (const cmd of COMMANDS) {
+        lines.push(`complete -c ibmi -n '__fish_use_subcommand' -a '${cmd}' -d '${cmd} command'`);
+    }
+    lines.push("", "# System subcommands");
+    for (const sub of SYSTEM_SUBCOMMANDS) {
+        lines.push(`complete -c ibmi -n '__fish_seen_subcommand_from system' -a '${sub}' -d '${sub}'`);
+    }
+    lines.push("", "# Global options");
+    lines.push("complete -c ibmi -l system -d 'Target system name' -x", "complete -c ibmi -l format -d 'Output format' -x -a 'table json csv markdown'", "complete -c ibmi -l raw -d 'Output as JSON'", "complete -c ibmi -l stream -d 'Stream results as NDJSON'", "complete -c ibmi -l tools -d 'Path to YAML tool files' -r -F", "complete -c ibmi -l output -d 'Write output to file' -r -F", "complete -c ibmi -l watch -d 'Re-run at interval (seconds)' -x", "complete -c ibmi -l no-color -d 'Disable colored output'");
+    return lines.join("\n") + "\n";
+}
+/**
+ * Register `ibmi completion bash|zsh|fish`.
+ */
+export function registerCompletionCommand(program) {
+    program
+        .command("completion [shell]")
+        .description("Generate shell completion script (bash, zsh, fish)")
+        .action((shell) => {
+        const target = shell?.toLowerCase() ?? detectShell();
+        switch (target) {
+            case "bash":
+                process.stdout.write(generateBash());
+                break;
+            case "zsh":
+                process.stdout.write(generateZsh());
+                break;
+            case "fish":
+                process.stdout.write(generateFish());
+                break;
+            default:
+                process.stderr.write(`Unknown shell: ${target}. Supported: bash, zsh, fish\n`);
+                process.exitCode = ExitCode.USAGE;
+        }
+    });
+}
+/**
+ * Auto-detect the current shell from the SHELL environment variable.
+ */
+function detectShell() {
+    const shell = process.env.SHELL ?? "";
+    if (shell.includes("zsh"))
+        return "zsh";
+    if (shell.includes("fish"))
+        return "fish";
+    return "bash";
+}
+//# sourceMappingURL=completion.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview `ibmi related <library> <object>` command — find dependent objects.
+ * @module cli/commands/related
+ */
+import { Command } from "commander";
+export declare function registerRelatedCommand(program: Command): void;
+//# sourceMappingURL=related.d.ts.map

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

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

package/dist/cli/commands/related.js

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview `ibmi related <library> <object>` command — find dependent objects.
+ * @module cli/commands/related
+ */
+import { withConnection } from "../utils/command-helpers.js";
+export function registerRelatedCommand(program) {
+    program
+        .command("related <library> <object>")
+        .description("Find objects that depend on a database file")
+        .option("--type <type>", "Filter by object type (e.g. INDEX, VIEW, TRIGGER, FOREIGN KEY)")
+        .action(async (library, object, opts, cmd) => {
+        await withConnection(cmd, "get_related_objects", async (_resolved, ctx) => {
+            const { getRelatedObjectsLogic } = await import("../../ibmi-mcp-server/tools/getRelatedObjects.tool.js");
+            const result = await getRelatedObjectsLogic({
+                library_name: library,
+                file_name: object,
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                object_type_filter: opts["type"],
+            }, ctx, {});
+            if (!result.success) {
+                throw new Error(result.error?.message ?? "Failed to get related objects");
+            }
+            return {
+                data: (result.data ?? []),
+                meta: {
+                    rowCount: result.rowCount ?? 0,
+                },
+            };
+        });
+    });
+}
+//# sourceMappingURL=related.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"related.js","sourceRoot":"","sources":["../../../src/cli/commands/related.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,4BAA4B,CAAC;SACrC,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CACL,eAAe,EACf,gEAAgE,CACjE;SACA,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,MAAc,EAAE,IAAI,EAAE,GAAY,EAAE,EAAE;QACpE,MAAM,cAAc,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE;YACxE,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAC7C,uDAAuD,CACxD,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC;gBACE,YAAY,EAAE,OAAO;gBACrB,SAAS,EAAE,MAAM;gBACjB,8DAA8D;gBAC9D,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAQ;aACxC,EACD,GAAG,EACH,EAAgB,CACjB,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,+BAA+B,CAAC,CAAC;YAC5E,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAA8B;gBACtD,IAAI,EAAE;oBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;iBAC/B;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview `ibmi schemas` command — list available schemas/libraries.
+ * @module cli/commands/schemas
+ */
+import { Command } from "commander";
+export declare function registerSchemasCommand(program: Command): void;
+//# sourceMappingURL=schemas.d.ts.map

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

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

package/dist/cli/commands/schemas.js

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview `ibmi schemas` command — list available schemas/libraries.
+ * @module cli/commands/schemas
+ */
+import { withConnection } from "../utils/command-helpers.js";
+import { ExitCode } from "../utils/exit-codes.js";
+export function registerSchemasCommand(program) {
+    program
+        .command("schemas")
+        .description("List schemas/libraries on the target system")
+        .option("--filter <pattern>", "Filter by schema name (SQL LIKE pattern, e.g. 'MY%')")
+        .option("--system-schemas", "Include system schemas (Q* and SYS*)", false)
+        .option("--limit <n>", "Maximum rows to return", "50")
+        .option("--offset <n>", "Rows to skip for pagination", "0")
+        .action(async (opts, cmd) => {
+        const limit = parseInt(opts["limit"], 10);
+        const offset = parseInt(opts["offset"], 10);
+        if (isNaN(limit) || limit < 0) {
+            process.stderr.write(`Error: Invalid --limit value: "${opts["limit"]}". Must be a positive integer.\n`);
+            process.exitCode = ExitCode.USAGE;
+            return;
+        }
+        if (isNaN(offset) || offset < 0) {
+            process.stderr.write(`Error: Invalid --offset value: "${opts["offset"]}". Must be a non-negative integer.\n`);
+            process.exitCode = ExitCode.USAGE;
+            return;
+        }
+        await withConnection(cmd, "list_schemas", async (_resolved, ctx) => {
+            const { listSchemasLogic } = await import("../../ibmi-mcp-server/tools/listSchemas.tool.js");
+            const result = await listSchemasLogic({
+                filter: opts["filter"],
+                include_system: opts["systemSchemas"],
+                limit,
+                offset,
+            }, ctx, {});
+            if (!result.success) {
+                throw new Error(result.error?.message ?? "Failed to list schemas");
+            }
+            return {
+                data: (result.data ?? []),
+                meta: {
+                    rowCount: result.rowCount ?? 0,
+                    hasMore: result.hasMore,
+                },
+            };
+        });
+    });
+}
+//# sourceMappingURL=schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/cli/commands/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,oBAAoB,EAAE,sDAAsD,CAAC;SACpF,MAAM,CAAC,kBAAkB,EAAE,sCAAsC,EAAE,KAAK,CAAC;SACzE,MAAM,CAAC,aAAa,EAAE,wBAAwB,EAAE,IAAI,CAAC;SACrD,MAAM,CAAC,cAAc,EAAE,6BAA6B,EAAE,GAAG,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAY,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAW,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAW,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,IAAI,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;YACxG,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;YAClC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,IAAI,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC;YAC9G,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE;YACjE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CACvC,iDAAiD,CAClD,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC;gBACE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;gBAC5C,cAAc,EAAE,IAAI,CAAC,eAAe,CAAY;gBAChD,KAAK;gBACL,MAAM;aACP,EACD,GAAG,EACH,EAAgB,CACjB,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,wBAAwB,CAAC,CAAC;YACrE,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAA8B;gBACtD,IAAI,EAAE;oBACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;oBAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview `ibmi sql "<sql>"` command — execute SQL queries.
+ * Supports inline SQL, --file, and stdin piping.
+ * @module cli/commands/sql
+ */
+import { Command } from "commander";
+export declare function registerSqlCommand(program: Command): void;
+//# sourceMappingURL=sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sql.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgHzD"}

package/dist/cli/commands/sql.js

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview `ibmi sql "<sql>"` command — execute SQL queries.
+ * Supports inline SQL, --file, and stdin piping.
+ * @module cli/commands/sql
+ */
+import { readFileSync } from "fs";
+import { withConnection, getFormat } from "../utils/command-helpers.js";
+import { renderMessage } from "../formatters/output.js";
+import { ExitCode } from "../utils/exit-codes.js";
+/**
+ * Read SQL from stdin (piped input).
+ * Returns null if stdin is a TTY (interactive).
+ */
+function readStdin() {
+    if (process.stdin.isTTY)
+        return null;
+    try {
+        return readFileSync(0, "utf-8").trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function registerSqlCommand(program) {
+    program
+        .command("sql [statement]")
+        .description("Execute a SQL query against the target system")
+        .option("--file <path>", "Read SQL from a file")
+        .option("--limit <n>", "Maximum rows to return")
+        .option("--read-only", "Enforce read-only mode (default: true)", true)
+        .option("--no-read-only", "Allow mutation queries")
+        .option("--dry-run", "Print SQL without executing", false)
+        .action(async (statement, opts, cmd) => {
+        // Resolve SQL source: argument > --file > stdin
+        let sql = statement;
+        if (!sql && opts["file"]) {
+            try {
+                sql = readFileSync(opts["file"], "utf-8").trim();
+            }
+            catch (err) {
+                process.stderr.write(`Error reading file: ${err instanceof Error ? err.message : String(err)}\n`);
+                process.exitCode = ExitCode.USAGE;
+                return;
+            }
+        }
+        if (!sql) {
+            sql = readStdin() ?? undefined;
+        }
+        if (!sql) {
+            process.stderr.write("Error: No SQL provided. Pass as argument, use --file, or pipe via stdin.\n");
+            process.exitCode = ExitCode.USAGE;
+            return;
+        }
+        // Dry run: print SQL and exit
+        if (opts["dryRun"]) {
+            const format = getFormat(cmd);
+            renderMessage(sql, format);
+            return;
+        }
+        await withConnection(cmd, "execute_sql", async (resolved, ctx) => {
+            // Configure read-only mode based on CLI flag and system config
+            const readOnly = opts["readOnly"] || resolved.config.readOnly;
+            // Confirm execution if system requires it
+            if (resolved.config.confirm && process.stdin.isTTY) {
+                const { promptPassword } = await import("../config/credentials.js");
+                const answer = await promptPassword(`Execute on [${resolved.name}]? (y/N) `);
+                if (answer.toLowerCase() !== "y") {
+                    throw new Error("Execution cancelled by user");
+                }
+            }
+            // Apply maxRows limit if not already in the query
+            let execSql = sql;
+            let maxRows = resolved.config.maxRows;
+            if (opts["limit"]) {
+                maxRows = parseInt(opts["limit"], 10);
+                if (isNaN(maxRows) || maxRows < 0) {
+                    throw new Error(`Invalid --limit value: "${opts["limit"]}". Must be a positive integer.`);
+                }
+            }
+            if (maxRows &&
+                !execSql.toUpperCase().includes("FETCH FIRST") &&
+                !execSql.toUpperCase().includes("FETCH NEXT")) {
+                execSql = `${execSql.replace(/;\s*$/, "")} FETCH FIRST ${maxRows} ROWS ONLY`;
+            }
+            // Configure execute_sql tool security before importing
+            const { configureExecuteSqlTool } = await import("../../ibmi-mcp-server/tools/executeSql.tool.js");
+            configureExecuteSqlTool({
+                enabled: true,
+                security: { readOnly },
+            });
+            const { executeSqlTool } = await import("../../ibmi-mcp-server/tools/executeSql.tool.js");
+            const logicFn = executeSqlTool.logic;
+            const result = await logicFn({ sql: execSql }, ctx, {});
+            if (!result.success) {
+                throw new Error(result.error?.message ?? "SQL execution failed");
+            }
+            return {
+                data: (result.data ?? []),
+                meta: {
+                    rowCount: result.rowCount ?? 0,
+                },
+            };
+        });
+    });
+}
+//# sourceMappingURL=sql.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview `ibmi system` commands for managing IBM i system configurations.
+ * Provides list, show, add, remove, default, and test subcommands.
+ * @module cli/commands/system
+ */
+import { Command } from "commander";
+/**
+ * Register all `ibmi system` subcommands.
+ */
+export declare function registerSystemCommand(program: Command): void;
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0DpC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoQ5D"}