@ibm/ibmi-mcp-server 0.3.2 → 0.4.1

package/README.md

@@ -315,24 +315,31 @@ npx -y @ibm/ibmi-mcp-server@latest [options]
 | `--toolsets <list>` | Comma-separated list of toolsets to load |
 | `--list-toolsets` | List all available toolsets and exit |
 | `--transport <type>` | Transport type: `stdio` (default) or `http` |
+| `--builtin-tools` | Enable built-in schema discovery tools (`list_schemas`, `list_tables_in_schema`, `get_table_columns`, `get_related_objects`, `validate_query`) |
+| `--execute-sql` | Enable the `execute_sql` tool for ad-hoc queries |
 | `--help` | Show help message |
 
 <details>
 <summary><strong>Common Examples</strong></summary>
 
-**Run server with stdio transport (for MCP clients):**
+**Full text-to-SQL workflow (schema discovery + query execution):**
 ```bash
-npx -y @ibm/ibmi-mcp-server@latest --transport stdio --tools ./tools
+npx -y @ibm/ibmi-mcp-server@latest --builtin-tools --execute-sql --transport http
 ```
 
-**Run HTTP server for testing:**
+**Schema discovery only (agents explore but can't run arbitrary SQL):**
+```bash
+npx -y @ibm/ibmi-mcp-server@latest --builtin-tools --tools ./tools
+```
+
+**Run server with YAML tools only:**
 ```bash
 npx -y @ibm/ibmi-mcp-server@latest --transport http --tools ./tools
 ```
 
 **Load specific toolsets only:**
 ```bash
-npx -y @ibm/ibmi-mcp-server@latest --toolsets performance,security
+npx -y @ibm/ibmi-mcp-server@latest --toolsets performance,security --tools ./tools
 ```
 
 **List available toolsets:**
@@ -340,11 +347,6 @@ npx -y @ibm/ibmi-mcp-server@latest --toolsets performance,security
 npx -y @ibm/ibmi-mcp-server@latest --list-toolsets --tools ./tools
 ```
 
-**Use custom tools directory:**
-```bash
-npx -y @ibm/ibmi-mcp-server@latest --tools /absolute/path/to/custom-tools
-```
-
 </details>
 
 ---
@@ -1605,12 +1607,19 @@ Settings for controlling built-in MCP tools compiled into the server. These are
 
 ## Built-in Tools Overview
 
-The IBM i MCP Server includes two built-in tools for database operations:
+The IBM i MCP Server includes built-in tools for schema discovery, query validation, and SQL execution. All built-in tools are **disabled by default** (except `describe_sql_object`) and must be explicitly enabled via CLI flags or environment variables.
+
+| Tool | Status | Purpose | CLI Flag | Env Variable |
+|------|--------|---------|----------|-------------|
+| `describe_sql_object` | ✅ Always enabled | Generate DDL for database objects | — | — |
+| `list_schemas` | Disabled by default | List available schemas/libraries | `--builtin-tools` | `IBMI_ENABLE_DEFAULT_TOOLS` |
+| `list_tables_in_schema` | Disabled by default | List tables, views, physical files in a schema | `--builtin-tools` | `IBMI_ENABLE_DEFAULT_TOOLS` |
+| `get_table_columns` | Disabled by default | Get column metadata for a table | `--builtin-tools` | `IBMI_ENABLE_DEFAULT_TOOLS` |
+| `get_related_objects` | Disabled by default | Find dependent objects for impact analysis | `--builtin-tools` | `IBMI_ENABLE_DEFAULT_TOOLS` |
+| `validate_query` | Disabled by default | Validate SQL syntax and verify referenced objects | `--builtin-tools` | `IBMI_ENABLE_DEFAULT_TOOLS` |
+| `execute_sql` | ⚠️ Disabled by default | Execute ad-hoc SQL queries (readonly by default) | `--execute-sql` | `IBMI_ENABLE_EXECUTE_SQL` |
 
-| Tool | Status | Purpose | Configuration |
-|------|--------|---------|---------------|
-| `describe_sql_object` | ✅ Always enabled | Generate DDL for database objects | None (always available) |
-| `execute_sql` | ⚠️ Disabled by default | Execute ad-hoc SQL queries (readonly by default) | `IBMI_ENABLE_EXECUTE_SQL`<br/>`IBMI_EXECUTE_SQL_READONLY` |
+> **Tip:** Use `--builtin-tools --execute-sql` together for the full text-to-SQL workflow. Use `--builtin-tools` alone to let agents discover schema while routing queries through curated YAML tools.
 
 ---
 
@@ -1661,6 +1670,8 @@ CREATE TABLE SALES.CUSTOMER (
 
 The `execute_sql` tool allows MCP clients to run ad-hoc SQL queries against your IBM i Db2 database. This tool is **disabled by default** for security reasons.
 
+Enable via CLI flag `--execute-sql` or environment variables:
+
 | Variable | Description | Type | Default | Required |
 |----------|-------------|------|---------|----------|
 | `IBMI_ENABLE_EXECUTE_SQL` | Enable the built-in `execute_sql` tool | boolean | `false` | No |
@@ -1688,23 +1699,23 @@ The execute_sql tool includes multiple layers of protection:
 **Examples:**
 
 ```bash
-# Development: Enable ad-hoc SELECT queries (readonly mode)
+# Via CLI flags (recommended for development)
+npx -y @ibm/ibmi-mcp-server@latest --execute-sql --transport http
+npx -y @ibm/ibmi-mcp-server@latest --builtin-tools --execute-sql --transport http
+
+# Via environment variables
 IBMI_ENABLE_EXECUTE_SQL=true
 IBMI_EXECUTE_SQL_READONLY=true  # Default - only SELECT queries allowed
 DB2i_HOST=ibmi-dev.local
 DB2i_USER=DEVUSER
 DB2i_PASS=devpass
 
-# Development: Enable write operations (INSERT/UPDATE/DELETE)
+# Enable write operations (INSERT/UPDATE/DELETE)
 IBMI_ENABLE_EXECUTE_SQL=true
 IBMI_EXECUTE_SQL_READONLY=false  # Allow write operations
-DB2i_HOST=ibmi-dev.local
-DB2i_USER=DEVUSER
-DB2i_PASS=devpass
 
 # Production: Use YAML tools instead (more controlled)
-IBMI_ENABLE_EXECUTE_SQL=false
-TOOLS_YAML_PATH=/opt/mcp-tools/production.yaml
+npx -y @ibm/ibmi-mcp-server@latest --tools /opt/mcp-tools/production.yaml
 ```
 
 > **⚠️ Security Recommendation:** Keep `IBMI_EXECUTE_SQL_READONLY=true` (default) unless you explicitly need write operations. For production use cases requiring write access, consider using YAML-defined tools with parameterized queries instead of ad-hoc SQL.
@@ -1721,12 +1732,13 @@ TOOLS_YAML_PATH=/opt/mcp-tools/production.yaml
 | **Security** | PARSE_STATEMENT + AST/Regex validation | Explicit whitelist of queries |
 | **Use Case** | Development & exploration | Production & controlled access |
 | **Configuration** | Environment variables | `TOOLS_YAML_PATH` |
-| **Examples** | `execute_sql`, `describe_sql_object` | Custom performance monitoring, security checks |
+| **Examples** | `list_schemas`, `get_table_columns`, `execute_sql`, `describe_sql_object` | Custom performance monitoring, security checks |
 
 **Recommendation:**
-- Use **`describe_sql_object`** freely - it's safe and helps AI understand your database schema
-- Use **`execute_sql`** in development for quick exploration
+- Use **`--builtin-tools`** for schema discovery — safe, read-only catalog queries that help AI understand your database
+- Use **`--execute-sql`** in development for quick ad-hoc query exploration
 - Use **YAML tools** in production for controlled, curated query access
+- Combine **`--builtin-tools` + YAML tools** to let agents discover schema while executing only curated queries
 
 YAML tools allow you to:
 - Curate specific queries with documentation

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