paygate-mcp 10.2.0 → 10.3.0

package/README.md

@@ -32,7 +32,10 @@ Monetize any MCP server with one command. Add API key auth, per-tool pricing, ra
 ## Quick Start
 
 ```bash
-# Wrap a local MCP server (stdio transport)
+# Interactive setup wizard (generates paygate.json)
+npx paygate-mcp init
+
+# Or wrap directly with CLI flags
 npx paygate-mcp wrap --server "npx @modelcontextprotocol/server-filesystem /tmp"
 
 # Gate a remote MCP server (Streamable HTTP transport)
@@ -551,6 +554,42 @@ These MCP methods pass through without auth or billing:
 
 **Gated methods:** `tools/call` (single), `tools/call_batch` (batch — all-or-nothing billing, parallel execution). See [Batch Tool Calls](#batch-tool-calls).
 
+## CLI Commands
+
+```bash
+paygate-mcp wrap [options]             # Start a payment-gated MCP proxy
+paygate-mcp init [--output] [--force]  # Interactive setup wizard
+paygate-mcp validate --config <path>   # Validate config without starting
+paygate-mcp completions <bash|zsh|fish> # Generate shell completions
+paygate-mcp version [--json]           # Print version
+```
+
+### Shell Completions
+
+```bash
+# Bash
+paygate-mcp completions bash > ~/.local/share/bash-completion/completions/paygate-mcp
+
+# Zsh
+paygate-mcp completions zsh > ~/.zfunc/_paygate-mcp
+# Add to .zshrc: fpath=(~/.zfunc $fpath) && compinit
+
+# Fish
+paygate-mcp completions fish > ~/.config/fish/completions/paygate-mcp.fish
+```
+
+### Machine-Readable Output
+
+```bash
+# Version as JSON (for CI/CD)
+paygate-mcp version --json
+# → {"version":"10.3.0"}
+
+# Validate config with structured output
+paygate-mcp validate --config paygate.json --json
+# → {"valid":true,"diagnostics":[...],"errors":0,"warnings":0}
+```
+
 ## CLI Options
 
 ```
@@ -571,10 +610,22 @@ These MCP methods pass through without auth or billing:
 --refund-on-failure  Refund credits when downstream tool call fails
 --redis-url <url>    Redis URL for distributed state (e.g. "redis://localhost:6379")
 --config <path>      Load settings from a JSON config file
+--discovery <mode>   Tool discovery mode: static (default) or dynamic
+--json               Machine-readable JSON output
 ```
 
 > **Note:** Use `--server` OR `--remote-url` for single-server mode. Use `servers` in a config file for multi-server mode.
 
+### Dynamic Tool Discovery
+
+For servers with many tools, dynamic discovery mode reduces agent context window bloat by exposing 3 meta-tools instead of the full tool list:
+
+```bash
+npx paygate-mcp wrap --server "your-server" --discovery dynamic
+```
+
+Agents see 3 tools: `paygate_list_tools` (paginated listing), `paygate_search_tools` (keyword search), and `paygate_call_tool` (proxy any tool). This reduces N tools to 3 in the context window while preserving full functionality.
+
 ### Persistent Storage
 
 Add `--state-file` to save API keys and credits to disk. Data survives server restarts.

package/dist/cli-completions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shell Completions — Generate tab completion scripts for bash, zsh, and fish.
+ *
+ * Usage:
+ *   paygate-mcp completions bash  > ~/.local/share/bash-completion/completions/paygate-mcp
+ *   paygate-mcp completions zsh   > ~/.zfunc/_paygate-mcp
+ *   paygate-mcp completions fish  > ~/.config/fish/completions/paygate-mcp.fish
+ */
+export declare function generateCompletions(shell: string): string;
+//# sourceMappingURL=cli-completions.d.ts.map

package/dist/cli-completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-completions.d.ts","sourceRoot":"","sources":["../src/cli-completions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQzD"}

package/dist/cli-completions.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * Shell Completions — Generate tab completion scripts for bash, zsh, and fish.
+ *
+ * Usage:
+ *   paygate-mcp completions bash  > ~/.local/share/bash-completion/completions/paygate-mcp
+ *   paygate-mcp completions zsh   > ~/.zfunc/_paygate-mcp
+ *   paygate-mcp completions fish  > ~/.config/fish/completions/paygate-mcp.fish
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCompletions = generateCompletions;
+const COMMANDS = ['wrap', 'init', 'validate', 'completions', 'version', 'help'];
+const WRAP_FLAGS = [
+    '--server', '--remote-url', '--config', '--port', '--price',
+    '--rate-limit', '--name', '--shadow', '--admin-key', '--tool-price',
+    '--import-key', '--state-file', '--stripe-secret', '--webhook-url',
+    '--webhook-secret', '--webhook-retries', '--refund-on-failure',
+    '--redis-url', '--header', '--trusted-proxies', '--dry-run',
+    '--log-level', '--log-format', '--request-timeout', '--headers-timeout',
+    '--keepalive-timeout', '--max-requests-per-socket', '--admin-rate-limit',
+    '--discovery', '--json',
+];
+const INIT_FLAGS = ['--output', '--force'];
+const VALIDATE_FLAGS = ['--config', '--json'];
+const LOG_LEVELS = ['debug', 'info', 'warn', 'error', 'silent'];
+const LOG_FORMATS = ['text', 'json'];
+function generateCompletions(shell) {
+    switch (shell.toLowerCase()) {
+        case 'bash': return generateBash();
+        case 'zsh': return generateZsh();
+        case 'fish': return generateFish();
+        default:
+            throw new Error(`Unsupported shell: ${shell}. Supported: bash, zsh, fish`);
+    }
+}
+function generateBash() {
+    return `# paygate-mcp bash completion
+# Install: paygate-mcp completions bash > ~/.local/share/bash-completion/completions/paygate-mcp
+# Or:      paygate-mcp completions bash >> ~/.bashrc
+
+_paygate_mcp() {
+  local cur prev words cword
+  _init_completion || return
+
+  local commands="${COMMANDS.join(' ')}"
+  local wrap_flags="${WRAP_FLAGS.join(' ')}"
+  local init_flags="${INIT_FLAGS.join(' ')}"
+  local validate_flags="${VALIDATE_FLAGS.join(' ')}"
+  local log_levels="${LOG_LEVELS.join(' ')}"
+  local log_formats="${LOG_FORMATS.join(' ')}"
+  local shells="bash zsh fish"
+
+  # Complete commands at position 1
+  if [[ \${cword} -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
+    return
+  fi
+
+  local cmd="\${words[1]}"
+
+  # Complete based on previous flag
+  case "\${prev}" in
+    --log-level)
+      COMPREPLY=( $(compgen -W "\${log_levels}" -- "\${cur}") )
+      return
+      ;;
+    --log-format)
+      COMPREPLY=( $(compgen -W "\${log_formats}" -- "\${cur}") )
+      return
+      ;;
+    --config|--state-file|--output)
+      COMPREPLY=( $(compgen -f -- "\${cur}") )
+      return
+      ;;
+    --discovery)
+      COMPREPLY=( $(compgen -W "static dynamic" -- "\${cur}") )
+      return
+      ;;
+  esac
+
+  # Complete flags based on command
+  case "\${cmd}" in
+    wrap)
+      COMPREPLY=( $(compgen -W "\${wrap_flags}" -- "\${cur}") )
+      ;;
+    init)
+      COMPREPLY=( $(compgen -W "\${init_flags}" -- "\${cur}") )
+      ;;
+    validate)
+      COMPREPLY=( $(compgen -W "\${validate_flags}" -- "\${cur}") )
+      ;;
+    completions)
+      COMPREPLY=( $(compgen -W "\${shells}" -- "\${cur}") )
+      ;;
+  esac
+}
+
+complete -F _paygate_mcp paygate-mcp
+`;
+}
+function generateZsh() {
+    const wrapFlagDefs = WRAP_FLAGS.map(f => `'${f}[${flagDescription(f)}]'`).join('\n      ');
+    return `#compdef paygate-mcp
+# paygate-mcp zsh completion
+# Install: paygate-mcp completions zsh > ~/.zfunc/_paygate-mcp
+# Then add: fpath=(~/.zfunc $fpath) and run: compinit
+
+_paygate_mcp() {
+  local -a commands
+  commands=(
+    'wrap:Start a payment-gated MCP proxy'
+    'init:Interactive setup wizard'
+    'validate:Validate a config file'
+    'completions:Generate shell completions'
+    'version:Print version'
+    'help:Show help'
+  )
+
+  _arguments -C \\
+    '1:command:->command' \\
+    '*::arg:->args'
+
+  case $state in
+    command)
+      _describe 'command' commands
+      ;;
+    args)
+      case $words[1] in
+        wrap)
+          _arguments \\
+            '--server[MCP server command to wrap]:command:' \\
+            '--remote-url[Remote MCP server URL]:url:' \\
+            '--config[Config file path]:file:_files' \\
+            '--port[HTTP port]:port:' \\
+            '--price[Default credits per call]:credits:' \\
+            '--rate-limit[Max calls/min per key]:limit:' \\
+            '--name[Server display name]:name:' \\
+            '--shadow[Shadow mode]' \\
+            '--admin-key[Admin key]:key:' \\
+            '--tool-price[Per-tool pricing]:pricing:' \\
+            '--state-file[State persistence file]:file:_files' \\
+            '--stripe-secret[Stripe webhook secret]:secret:' \\
+            '--webhook-url[Webhook URL]:url:' \\
+            '--webhook-secret[Webhook HMAC secret]:secret:' \\
+            '--redis-url[Redis URL]:url:' \\
+            '--dry-run[Discover tools and exit]' \\
+            '--log-level[Log level]:level:(debug info warn error silent)' \\
+            '--log-format[Log format]:format:(text json)' \\
+            '--json[JSON output mode]' \\
+            '--refund-on-failure[Refund on downstream failure]' \\
+            '--discovery[Tool discovery mode]:mode:(static dynamic)'
+          ;;
+        init)
+          _arguments \\
+            '--output[Output file path]:file:_files' \\
+            '--force[Overwrite existing file]'
+          ;;
+        validate)
+          _arguments \\
+            '--config[Config file path]:file:_files' \\
+            '--json[JSON output mode]'
+          ;;
+        completions)
+          _arguments '1:shell:(bash zsh fish)'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_paygate_mcp "$@"
+`;
+}
+function generateFish() {
+    return `# paygate-mcp fish completion
+# Install: paygate-mcp completions fish > ~/.config/fish/completions/paygate-mcp.fish
+
+# Disable file completions by default
+complete -c paygate-mcp -f
+
+# Commands
+complete -c paygate-mcp -n "__fish_use_subcommand" -a "wrap" -d "Start a payment-gated MCP proxy"
+complete -c paygate-mcp -n "__fish_use_subcommand" -a "init" -d "Interactive setup wizard"
+complete -c paygate-mcp -n "__fish_use_subcommand" -a "validate" -d "Validate a config file"
+complete -c paygate-mcp -n "__fish_use_subcommand" -a "completions" -d "Generate shell completions"
+complete -c paygate-mcp -n "__fish_use_subcommand" -a "version" -d "Print version"
+complete -c paygate-mcp -n "__fish_use_subcommand" -a "help" -d "Show help"
+
+# wrap flags
+${WRAP_FLAGS.map(f => `complete -c paygate-mcp -n "__fish_seen_subcommand_from wrap" -l "${f.slice(2)}" -d "${flagDescription(f)}"`).join('\n')}
+
+# init flags
+complete -c paygate-mcp -n "__fish_seen_subcommand_from init" -l "output" -d "Output file path" -r -F
+complete -c paygate-mcp -n "__fish_seen_subcommand_from init" -l "force" -d "Overwrite existing file"
+
+# validate flags
+complete -c paygate-mcp -n "__fish_seen_subcommand_from validate" -l "config" -d "Config file path" -r -F
+complete -c paygate-mcp -n "__fish_seen_subcommand_from validate" -l "json" -d "JSON output mode"
+
+# completions shells
+complete -c paygate-mcp -n "__fish_seen_subcommand_from completions" -a "bash zsh fish"
+
+# log-level values
+complete -c paygate-mcp -n "__fish_seen_subcommand_from wrap; and __fish_prev_arg_in --log-level" -a "debug info warn error silent"
+
+# log-format values
+complete -c paygate-mcp -n "__fish_seen_subcommand_from wrap; and __fish_prev_arg_in --log-format" -a "text json"
+
+# discovery mode values
+complete -c paygate-mcp -n "__fish_seen_subcommand_from wrap; and __fish_prev_arg_in --discovery" -a "static dynamic"
+`;
+}
+function flagDescription(flag) {
+    const descriptions = {
+        '--server': 'MCP server command',
+        '--remote-url': 'Remote MCP server URL',
+        '--config': 'Config file path',
+        '--port': 'HTTP port',
+        '--price': 'Default credits per call',
+        '--rate-limit': 'Max calls/min per key',
+        '--name': 'Server display name',
+        '--shadow': 'Shadow mode',
+        '--admin-key': 'Admin key',
+        '--tool-price': 'Per-tool pricing',
+        '--import-key': 'Import API key with credits',
+        '--state-file': 'State persistence file',
+        '--stripe-secret': 'Stripe webhook secret',
+        '--webhook-url': 'Webhook URL',
+        '--webhook-secret': 'Webhook HMAC secret',
+        '--webhook-retries': 'Max webhook retries',
+        '--refund-on-failure': 'Refund on downstream failure',
+        '--redis-url': 'Redis URL',
+        '--header': 'Custom response header',
+        '--trusted-proxies': 'Trusted proxy IPs',
+        '--dry-run': 'Discover tools and exit',
+        '--log-level': 'Log level',
+        '--log-format': 'Log format',
+        '--request-timeout': 'Max request time (ms)',
+        '--headers-timeout': 'Max header receive time (ms)',
+        '--keepalive-timeout': 'Idle connection timeout (ms)',
+        '--max-requests-per-socket': 'Max requests per socket',
+        '--admin-rate-limit': 'Admin rate limit per IP',
+        '--json': 'JSON output mode',
+        '--discovery': 'Tool discovery mode (static/dynamic)',
+    };
+    return descriptions[flag] || flag.slice(2);
+}
+//# sourceMappingURL=cli-completions.js.map

package/dist/cli-completions.js.map

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

package/dist/cli-init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI Init Wizard — Interactive setup for paygate-mcp.
+ *
+ * Generates a paygate.json config file with guided prompts.
+ * Uses only Node.js built-in readline — zero dependencies.
+ */
+export declare function runInit(flags: Record<string, string>): Promise<void>;
+//# sourceMappingURL=cli-init.d.ts.map

package/dist/cli-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-init.d.ts","sourceRoot":"","sources":["../src/cli-init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0FH,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAyI1E"}

package/dist/cli-init.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * CLI Init Wizard — Interactive setup for paygate-mcp.
+ *
+ * Generates a paygate.json config file with guided prompts.
+ * Uses only Node.js built-in readline — zero dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const readline_1 = require("readline");
+const fs_1 = require("fs");
+const path_1 = require("path");
+// ─── Readline helpers ─────────────────────────────────────────────────────────
+function createRl() {
+    return (0, readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+}
+function ask(rl, question, defaultValue) {
+    const prompt = defaultValue ? `${question} [${defaultValue}]: ` : `${question}: `;
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+}
+function askYesNo(rl, question, defaultYes = false) {
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    return new Promise((resolve) => {
+        rl.question(`${question} ${hint}: `, (answer) => {
+            const a = answer.trim().toLowerCase();
+            if (!a)
+                return resolve(defaultYes);
+            resolve(a === 'y' || a === 'yes');
+        });
+    });
+}
+function askChoice(rl, question, choices, defaultIndex = 0) {
+    return new Promise((resolve) => {
+        console.log(`\n  ${question}`);
+        choices.forEach((c, i) => {
+            const marker = i === defaultIndex ? '>' : ' ';
+            console.log(`  ${marker} ${i + 1}. ${c}`);
+        });
+        rl.question(`  Choice [${defaultIndex + 1}]: `, (answer) => {
+            const idx = parseInt(answer.trim(), 10) - 1;
+            if (idx >= 0 && idx < choices.length) {
+                resolve(choices[idx]);
+            }
+            else {
+                resolve(choices[defaultIndex]);
+            }
+        });
+    });
+}
+const TEMPLATES = [
+    {
+        name: 'filesystem',
+        description: 'Wrap the MCP filesystem server',
+        serverCommand: 'npx',
+        serverArgs: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'],
+        defaultPrice: 1,
+        rateLimit: 60,
+    },
+    {
+        name: 'custom-stdio',
+        description: 'Wrap a custom stdio MCP server',
+        serverCommand: '',
+        serverArgs: [],
+        defaultPrice: 1,
+        rateLimit: 60,
+    },
+    {
+        name: 'remote-http',
+        description: 'Gate a remote MCP server (Streamable HTTP)',
+        serverCommand: '',
+        serverArgs: [],
+        defaultPrice: 1,
+        rateLimit: 60,
+    },
+];
+// ─── Init Command ─────────────────────────────────────────────────────────────
+async function runInit(flags) {
+    const outputPath = (0, path_1.resolve)(flags['output'] || flags['o'] || 'paygate.json');
+    // Check if file already exists
+    if ((0, fs_1.existsSync)(outputPath) && !flags['force']) {
+        console.error(`\n  Error: ${outputPath} already exists. Use --force to overwrite.\n`);
+        process.exit(1);
+    }
+    console.log(`
+  ╔══════════════════════════════════════════════════╗
+  ║       PayGate MCP — Interactive Setup            ║
+  ║       Monetize any MCP server in seconds         ║
+  ╚══════════════════════════════════════════════════╝
+  `);
+    const rl = createRl();
+    try {
+        // Step 1: Choose template
+        const templateChoice = await askChoice(rl, 'What type of MCP server do you want to gate?', TEMPLATES.map(t => `${t.name} — ${t.description}`), 0);
+        const templateIdx = TEMPLATES.findIndex(t => templateChoice.startsWith(t.name));
+        const template = TEMPLATES[templateIdx >= 0 ? templateIdx : 0];
+        const config = {};
+        // Step 2: Server command or remote URL
+        if (template.name === 'remote-http') {
+            const url = await ask(rl, 'Remote MCP server URL', 'https://my-server.example.com/mcp');
+            config.remoteUrl = url;
+        }
+        else if (template.name === 'filesystem') {
+            const dir = await ask(rl, 'Directory to serve', '/tmp');
+            config.serverCommand = 'npx';
+            config.serverArgs = ['-y', '@modelcontextprotocol/server-filesystem', dir];
+        }
+        else {
+            const cmd = await ask(rl, 'Server command (e.g., "node server.js" or "python server.py")');
+            if (!cmd) {
+                console.error('\n  Error: server command is required.\n');
+                process.exit(1);
+            }
+            const parts = cmd.split(/\s+/);
+            config.serverCommand = parts[0];
+            config.serverArgs = parts.slice(1);
+        }
+        // Step 3: Port
+        const portStr = await ask(rl, 'Port', '3402');
+        config.port = parseInt(portStr, 10) || 3402;
+        // Step 4: Pricing
+        const priceStr = await ask(rl, 'Default credits per tool call', String(template.defaultPrice));
+        config.defaultCreditsPerCall = parseInt(priceStr, 10) || 1;
+        // Step 5: Rate limit
+        const rateStr = await ask(rl, 'Rate limit (calls/min per key, 0=unlimited)', String(template.rateLimit));
+        config.globalRateLimitPerMin = parseInt(rateStr, 10);
+        // Step 6: Shadow mode
+        const shadow = await askYesNo(rl, 'Enable shadow mode? (log without enforcing)', false);
+        if (shadow) {
+            config.shadowMode = true;
+        }
+        // Step 7: State persistence
+        const persist = await askYesNo(rl, 'Persist state to disk? (survives restarts)', true);
+        if (persist) {
+            const stateFile = await ask(rl, 'State file path', 'paygate-state.json');
+            config.stateFile = stateFile;
+        }
+        // Step 8: Stripe integration
+        const stripe = await askYesNo(rl, 'Enable Stripe integration for credit purchases?', false);
+        if (stripe) {
+            const stripeSecret = await ask(rl, 'Stripe webhook signing secret (whsec_...)');
+            if (stripeSecret) {
+                config.stripeWebhookSecret = stripeSecret;
+            }
+            // Add credit packages placeholder
+            config.creditPackages = [
+                { id: 'starter', credits: 100, priceInCents: 999, currency: 'usd', name: 'Starter Pack' },
+                { id: 'pro', credits: 1000, priceInCents: 4999, currency: 'usd', name: 'Pro Pack' },
+            ];
+        }
+        // Step 9: Webhook
+        const webhook = await askYesNo(rl, 'Send usage events to a webhook?', false);
+        if (webhook) {
+            const webhookUrl = await ask(rl, 'Webhook URL');
+            if (webhookUrl) {
+                config.webhookUrl = webhookUrl;
+                const webhookSecret = await ask(rl, 'Webhook HMAC secret (optional)');
+                if (webhookSecret) {
+                    config.webhookSecret = webhookSecret;
+                }
+            }
+        }
+        // Step 10: Log format
+        const jsonLogs = await askYesNo(rl, 'Use JSON log format? (recommended for production)', false);
+        if (jsonLogs) {
+            config.logFormat = 'json';
+        }
+        // Write config file
+        const configJson = JSON.stringify(config, null, 2);
+        (0, fs_1.writeFileSync)(outputPath, configJson + '\n', 'utf-8');
+        console.log(`
+  ✓ Config written to ${outputPath}
+
+  Next steps:
+    1. Start PayGate:
+       paygate-mcp wrap --config ${outputPath.endsWith('paygate.json') ? 'paygate.json' : outputPath}
+
+    2. Create an API key:
+       curl -X POST http://localhost:${config.port}/keys \\
+         -H "X-Admin-Key: <admin-key>" \\
+         -H "Content-Type: application/json" \\
+         -d '{"name":"my-client","credits":100}'
+
+    3. Make a tool call:
+       curl http://localhost:${config.port}/mcp \\
+         -H "X-API-Key: <api-key>" \\
+         -H "Content-Type: application/json" \\
+         -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"tool_name","arguments":{}},"id":1}'
+
+  Admin dashboard: http://localhost:${config.port}/dashboard
+  API docs:        http://localhost:${config.port}/docs
+  `);
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=cli-init.js.map

package/dist/cli-init.js.map

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

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAkOH;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6B9C,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AA2OH;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6B9C,CAAC"}