@openziti/ziti-mcp-server 0.1.0

package/dist/utils/scopes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Default scopes to be used when no specific scopes are provided.
+ * This is an empty array, meaning no scopes are required by default to
+ * promote security by default.
+ */
+export declare const DEFAULT_SCOPES: string[];
+/**
+ * Returns a unique list of all required scopes across all tools.
+ *
+ * @returns {string[]} - An array of unique scopes required by all tools.
+ */
+export declare function getAllScopes(): string[];

package/dist/utils/scopes.js

@@ -0,0 +1,19 @@
+import { TOOLS } from '../tools/index.js';
+/**
+ * Default scopes to be used when no specific scopes are provided.
+ * This is an empty array, meaning no scopes are required by default to
+ * promote security by default.
+ */
+export const DEFAULT_SCOPES = [];
+/**
+ * Returns a unique list of all required scopes across all tools.
+ *
+ * @returns {string[]} - An array of unique scopes required by all tools.
+ */
+export function getAllScopes() {
+    // Use flatMap to extract and flatten all scopes, with empty fallback
+    const allScopes = TOOLS.flatMap((tool) => tool._meta?.requiredScopes ?? []);
+    // Create unique set from collected scopes
+    return [...new Set(allScopes)];
+}
+//# sourceMappingURL=scopes.js.map

package/dist/utils/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../src/utils/scopes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAa,EAAE,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,qEAAqE;IACrE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC;IAE5E,0CAA0C;IAC1C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AACjC,CAAC"}

package/dist/utils/terminal.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Generic function to prompt user for a choice from a list of options
+ */
+export declare function promptForChoice<T extends string>(question: string, choices: Array<{
+    label: string;
+    value: T;
+}>, defaultChoice?: T): Promise<T>;
+/**
+ * Generic function to prompt user for a file/directory path with validation
+ */
+export declare function promptForPath(question: string, options?: {
+    required?: boolean;
+    mustExist?: boolean;
+    mustBeDirectory?: boolean;
+    mustBeFile?: boolean;
+}): Promise<string>;
+export declare const cliOutput: (message: string) => boolean;
+export declare const startSpinner: (message: string) => void;
+export declare const stopSpinner: () => void;
+export declare const getTenantFromToken: (accessToken: string) => string;
+export declare const promptForBrowserPermission: () => Promise<boolean>;
+export declare const promptForScopeSelection: (providedScopes?: string[]) => Promise<string[]>;
+/**
+ * Masks a tenant name according to the specified format:
+ * - Shows letters before the dash
+ * - Shows 3 letters after the dash
+ * - Shows the last word after the last dot
+ * - Masks everything else with "xxx"
+ *
+ * Example: "dev-sfhjdfhdgfghhjdfhf.us.auth0.com" becomes "dev-sfh***com"
+ *
+ * @param tenantName The tenant name to mask
+ * @returns The masked tenant name or the original if it doesn't match the expected format
+ */
+export declare function maskTenantName(tenantName: string | undefined | null): string;

package/dist/utils/terminal.js

@@ -0,0 +1,409 @@
+import chalk from 'chalk';
+import { jwtDecode } from 'jwt-decode';
+import readline from 'readline';
+import * as fs from 'fs';
+import * as path from 'path';
+import { getAllScopes } from './scopes.js';
+/**
+ * Generic function to prompt user for a choice from a list of options
+ */
+export async function promptForChoice(question, choices, defaultChoice) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        console.log(chalk.cyan(`\n${question}`));
+        choices.forEach((choice, index) => {
+            console.log(`${index + 1}. ${choice.label}`);
+        });
+        rl.question(chalk.yellow(`Enter your choice (1-${choices.length}): `), (answer) => {
+            rl.close();
+            const choice = answer.trim();
+            const choiceIndex = parseInt(choice, 10) - 1;
+            if (choiceIndex >= 0 && choiceIndex < choices.length) {
+                resolve(choices[choiceIndex].value);
+            }
+            else {
+                // Try to match by label (case insensitive)
+                const matchedChoice = choices.find((c) => c.value.toLowerCase() === choice.toLowerCase() ||
+                    c.label.toLowerCase().includes(choice.toLowerCase()));
+                if (matchedChoice) {
+                    resolve(matchedChoice.value);
+                }
+                else if (defaultChoice) {
+                    console.log(chalk.yellow(`Invalid choice, defaulting to ${defaultChoice}.`));
+                    resolve(defaultChoice);
+                }
+                else {
+                    console.log(chalk.yellow(`Invalid choice, defaulting to first option.`));
+                    resolve(choices[0].value);
+                }
+            }
+        });
+    });
+}
+/**
+ * Generic function to prompt user for a file/directory path with validation
+ */
+export async function promptForPath(question, options = {}) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        const askForPath = () => {
+            rl.question(chalk.yellow(question), (input) => {
+                const trimmedInput = input.trim();
+                if (options.required && !trimmedInput) {
+                    console.log(chalk.red('Path is required'));
+                    askForPath();
+                    return;
+                }
+                if (!trimmedInput) {
+                    rl.close();
+                    resolve('');
+                    return;
+                }
+                const resolvedPath = path.resolve(trimmedInput);
+                if (options.mustExist && !fs.existsSync(resolvedPath)) {
+                    console.log(chalk.red(`Path does not exist: ${resolvedPath}`));
+                    askForPath();
+                    return;
+                }
+                if (options.mustBeDirectory &&
+                    fs.existsSync(resolvedPath) &&
+                    !fs.statSync(resolvedPath).isDirectory()) {
+                    console.log(chalk.red(`Path is not a directory: ${resolvedPath}`));
+                    askForPath();
+                    return;
+                }
+                if (options.mustBeFile &&
+                    fs.existsSync(resolvedPath) &&
+                    !fs.statSync(resolvedPath).isFile()) {
+                    console.log(chalk.red(`Path is not a file: ${resolvedPath}`));
+                    askForPath();
+                    return;
+                }
+                rl.close();
+                resolve(resolvedPath);
+            });
+        };
+        askForPath();
+    });
+}
+/**
+ * Handles terminal interactions, output formatting, spinners, and user input
+ */
+class Terminal {
+    spinnerInterval = null;
+    currentMessage = '';
+    spinnerConfig = {
+        frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+        interval: 80,
+    };
+    audiencePath = '/api/v2/';
+    /**
+     * Writes a message to stdout
+     *
+     * @param {string} message - The message to output
+     * @returns {boolean} - Always returns true
+     */
+    output(message) {
+        process.stdout.write(message);
+        return true;
+    }
+    /**
+     * Starts a spinner with the given message
+     *
+     * @param {string} message - Message to display alongside the spinner
+     */
+    startSpinner(message) {
+        let frameIndex = 0;
+        this.currentMessage = message;
+        // Clear any existing spinner
+        this.stopSpinnerWithoutMessage();
+        // Initial spinner state
+        process.stdout.write(`\r${chalk.cyan(this.spinnerConfig.frames[0])} ${message}`);
+        this.spinnerInterval = setInterval(() => {
+            process.stdout.write(`\r${chalk.cyan(this.spinnerConfig.frames[frameIndex])} ${message}`);
+            frameIndex = (frameIndex + 1) % this.spinnerConfig.frames.length;
+        }, this.spinnerConfig.interval);
+    }
+    /**
+     * Stops the spinner and clears the line without showing a completion message
+     */
+    stopSpinnerWithoutMessage() {
+        if (this.spinnerInterval) {
+            clearInterval(this.spinnerInterval);
+            this.spinnerInterval = null;
+            // Clear the spinner line
+            process.stdout.write('\r\x1B[K');
+        }
+    }
+    /**
+     * Stops the spinner and shows a completion message
+     */
+    stopSpinner() {
+        if (this.spinnerInterval) {
+            this.stopSpinnerWithoutMessage();
+            this.output(`${chalk.green('✓')} ${this.currentMessage}\n`);
+        }
+    }
+    /**
+     * Extracts tenant information from an access token
+     *
+     * @param {string} accessToken - JWT access token
+     * @returns {string} - The tenant hostname
+     * @throws {Error} - If tenant extraction fails
+     */
+    getTenantFromToken(accessToken) {
+        try {
+            const payload = jwtDecode(accessToken);
+            const audiences = Array.isArray(payload.aud) ? payload.aud : [payload.aud];
+            for (const aud of audiences) {
+                const url = new URL(aud);
+                if (url.pathname === this.audiencePath) {
+                    return url.host;
+                }
+            }
+            throw new Error('No valid audience found in token');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to extract tenant: ${errorMessage}`);
+        }
+    }
+    /**
+     * Prompts user for permission to open browser
+     *
+     * @returns {Promise<boolean>} - Resolves to true when user presses Enter
+     */
+    async promptForBrowserPermission() {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(chalk.yellow(`Press Enter to open the browser to log in or ${chalk.cyan('^C')} to quit.\n`), () => {
+                rl.close();
+                resolve(true);
+            });
+        });
+    }
+    /**
+     * Prompts user to select scopes or uses provided ones
+     *
+     * @param {string[]} [providedScopes] - Optional pre-selected scopes
+     * @returns {Promise<string[]>} - Resolves to array of selected scopes
+     */
+    async promptForScopeSelection(providedScopes) {
+        // If providedScopes were specified via --scopes flag, return them directly
+        if (providedScopes && providedScopes.length > 0) {
+            console.log(chalk.green(`Using provided scopes: ${providedScopes.join(', ')}`));
+            return providedScopes;
+        }
+        const scopeSelector = new ScopeSelector();
+        return scopeSelector.selectScopes();
+    }
+}
+/**
+ * Handles interactive scope selection in the terminal
+ */
+class ScopeSelector {
+    allScopes = [];
+    selectedScopes = new Set();
+    currentIndex = 0;
+    /**
+     * Creates a new scope selector instance
+     */
+    constructor() {
+        this.allScopes = getAllScopes();
+    }
+    /**
+     * Displays the interactive scope selection UI
+     *
+     * @returns {Promise<string[]>} - Resolves to an array of selected scopes
+     */
+    async selectScopes() {
+        // Display header
+        console.log(chalk.cyan.bold('\nSelect scopes using spacebar, then press Enter to confirm:'));
+        console.log(chalk.dim('(Press spacebar to toggle selection, arrows to navigate, Enter when done)'));
+        console.log();
+        // Only add newlines if there are actually scopes to display
+        if (this.allScopes.length === 0) {
+            console.log(chalk.yellow('No scopes available to select.'));
+            return [];
+        }
+        // Hide cursor
+        process.stdout.write('\x1B[?25l');
+        // Handle keyboard input
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        // Add initial newlines for menu display
+        this.allScopes.forEach(() => console.log(''));
+        // Display the menu initially
+        this.renderMenu();
+        return this.handleKeyboardInput();
+    }
+    /**
+     * Sets up event listeners for keyboard input during scope selection
+     *
+     * @returns {Promise<string[]>} - Resolves to the selected scopes
+     */
+    handleKeyboardInput() {
+        return new Promise((resolve) => {
+            process.stdin.on('data', (key) => {
+                const keyString = String(key);
+                if (this.handleControlKey(keyString, resolve)) {
+                    return;
+                }
+                if (keyString === ' ') {
+                    this.toggleCurrentSelection();
+                }
+                else if (keyString.startsWith('\u001B[')) {
+                    this.handleArrowKeys(keyString);
+                }
+            });
+        });
+    }
+    /**
+     * Handles control keys (Enter, Ctrl+C) during selection
+     *
+     * @param {string} keyString - The key input string
+     * @param {(scopes: string[]) => void} resolve - The promise resolve function
+     * @returns {boolean} - True if a control key was handled, false otherwise
+     */
+    handleControlKey(keyString, resolve) {
+        if (keyString === '\r' || keyString === '\n') {
+            // Enter key - finish selection
+            this.cleanup();
+            const result = Array.from(this.selectedScopes);
+            if (result.length === 0) {
+                console.log(chalk.yellow('No scopes selected.'));
+            }
+            else {
+                console.log(chalk.green(`Selected scopes: ${result.join(', ')}`));
+            }
+            resolve(result);
+            return true;
+        }
+        if (keyString === '\u0003') {
+            // Ctrl+C - exit
+            this.cleanup();
+            console.log(chalk.red('Selection cancelled.'));
+            process.exit(0);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Toggles selection of the current scope
+     */
+    toggleCurrentSelection() {
+        const scope = this.allScopes[this.currentIndex];
+        if (this.selectedScopes.has(scope)) {
+            this.selectedScopes.delete(scope);
+        }
+        else {
+            this.selectedScopes.add(scope);
+        }
+        this.renderMenu();
+    }
+    /**
+     * Handles arrow key navigation
+     *
+     * @param {string} keyString - The key input string
+     */
+    handleArrowKeys(keyString) {
+        // Simple arrow keys (up/down)
+        if (keyString === '\u001B[A') {
+            this.currentIndex = Math.max(0, this.currentIndex - 1);
+            this.renderMenu();
+            return;
+        }
+        if (keyString === '\u001B[B') {
+            this.currentIndex = Math.min(this.allScopes.length - 1, this.currentIndex + 1);
+            this.renderMenu();
+            return;
+        }
+        // Handle other arrow key combinations
+        const arrowMatch = keyString.match(/\u001B\[(\d+)?([A-D])/);
+        if (arrowMatch) {
+            const [_, count, direction] = arrowMatch;
+            const moveCount = parseInt(count || '1', 10);
+            if (direction === 'A') {
+                // Up arrow
+                this.currentIndex = Math.max(0, this.currentIndex - moveCount);
+                this.renderMenu();
+            }
+            else if (direction === 'B') {
+                // Down arrow
+                this.currentIndex = Math.min(this.allScopes.length - 1, this.currentIndex + moveCount);
+                this.renderMenu();
+            }
+        }
+    }
+    /**
+     * Renders the scope selection menu in the terminal
+     */
+    renderMenu() {
+        // Clear previous menu
+        process.stdout.write('\r\x1B[K'); // Clear current line
+        for (let i = 0; i < this.allScopes.length; i++) {
+            process.stdout.write('\x1B[1A\x1B[K'); // Move up and clear line
+        }
+        // Display each scope with selection indicator
+        this.allScopes.forEach((scope, index) => {
+            const isSelected = this.selectedScopes.has(scope);
+            const isCurrent = index === this.currentIndex;
+            process.stdout.write(`${isCurrent ? '>' : ' '} ${isSelected ? '[x]' : '[ ]'} ${chalk.green(scope)}\n`);
+        });
+    }
+    /**
+     * Cleans up terminal state after selection
+     */
+    cleanup() {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.removeAllListeners('data');
+        process.stdout.write('\x1B[?25h'); // Show cursor
+        console.log(''); // Add a newline
+    }
+}
+// Create and export the Terminal instance
+const terminal = new Terminal();
+// Export functions that match the original API
+export const cliOutput = (message) => terminal.output(message);
+export const startSpinner = (message) => terminal.startSpinner(message);
+export const stopSpinner = () => terminal.stopSpinner();
+export const getTenantFromToken = (accessToken) => terminal.getTenantFromToken(accessToken);
+export const promptForBrowserPermission = () => terminal.promptForBrowserPermission();
+export const promptForScopeSelection = (providedScopes) => terminal.promptForScopeSelection(providedScopes);
+/**
+ * Masks a tenant name according to the specified format:
+ * - Shows letters before the dash
+ * - Shows 3 letters after the dash
+ * - Shows the last word after the last dot
+ * - Masks everything else with "xxx"
+ *
+ * Example: "dev-sfhjdfhdgfghhjdfhf.us.auth0.com" becomes "dev-sfh***com"
+ *
+ * @param tenantName The tenant name to mask
+ * @returns The masked tenant name or the original if it doesn't match the expected format
+ */
+export function maskTenantName(tenantName) {
+    if (!tenantName) {
+        return 'unknown';
+    }
+    const dashIndex = tenantName.indexOf('-');
+    const lastDotIndex = tenantName.lastIndexOf('.');
+    if (dashIndex === -1 || lastDotIndex === -1) {
+        return tenantName; // Return as is if format doesn't match expected pattern
+    }
+    const prefix = tenantName.substring(0, dashIndex);
+    const threeAfterDash = tenantName.substring(dashIndex + 1, dashIndex + 4);
+    const lastPart = tenantName.substring(lastDotIndex + 1);
+    return `${prefix}-${threeAfterDash}***${lastPart}`;
+}
+//# sourceMappingURL=terminal.js.map

package/dist/utils/terminal.js.map

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

package/dist/utils/tools.d.ts

@@ -0,0 +1,63 @@
+import { Tool } from './types.js';
+/**
+ * Filters the provided tools collection based on specified glob patterns and readOnly flag.
+ * This function processes the input patterns against available tools to determine
+ * which tools should be returned. It handles special cases like wildcard patterns,
+ * empty pattern arrays, and pattern matching errors. When readOnly is true,
+ * it only returns tools that have _meta.readOnly set to true or tools that follow read-only patterns.
+ *
+ * IMPORTANT: The readOnly flag takes priority over pattern matching for security reasons.
+ * Even if patterns match non-read-only tools, when readOnly=true is specified,
+ * only read-only tools will be returned.
+ *
+ * @param allTools - Complete collection of available tools to be filtered
+ * @param patterns - Optional glob patterns to filter tools by (e.g., 'ziti*', 'jwt-*')
+ *                   If omitted or empty, all tools will be returned
+ *                   A single '*' pattern will return all tools
+ * @param readOnly - Optional flag to only return read-only tools
+ *                   When true, only returns tools marked as readOnly
+ *                   Takes priority over pattern matching for security
+ * @returns Array of Tool objects that match the specified criteria
+ *          Returns all tools if no patterns provided or on error
+ *
+ * @example
+ * // Return all tools that start with "auth"
+ * const authTools = getAvailableTools(tools, ['auth*']);
+ *
+ * @example
+ * // Return all read-only tools (regardless of pattern matching)
+ * const readOnlyTools = getAvailableTools(tools, ['*'], true);
+ *
+ * @example
+ * // Return only read-only tools that match the pattern
+ * // Note: --read-only takes priority, so even if the pattern matches non-read-only tools,
+ * // only the read-only ones will be returned
+ * const readOnlyAuthTools = getAvailableTools(tools, ['ziti_*_application'], true);
+ */
+export declare function getAvailableTools(allTools: Tool[], patterns?: string[], readOnly?: boolean): Tool[];
+/**
+ * Validates tool patterns against available tools to ensure each pattern matches at least one tool.
+ * This function verifies that each provided pattern (including glob patterns) corresponds to
+ * at least one available tool, throwing specific errors for different validation scenarios.
+ *
+ * @param patterns - Array of tool name patterns to validate
+ *                   Can include glob patterns with wildcards (e.g., 'ziti*')
+ *                   Empty array or undefined will skip validation
+ * @param availableTools - Collection of Tool objects to validate patterns against
+ *
+ * @throws {Error} If availableTools is not a valid array or is empty
+ * @throws {Error} If any pattern doesn't match at least one tool name, with different
+ *                 error messages for exact matches vs. wildcard patterns
+ *
+ * @example
+ * // Validate specific tool names
+ * validatePatterns(['ziti-jwt', 'ziti-management'], tools);
+ *
+ * @example
+ * // Validate with glob patterns
+ * validatePatterns(['ziti*', 'jwt-*'], tools);
+ *
+ * @see {@link Glob} for the pattern matching implementation
+ * @see {@link getAvailableTools} for filtering tools using these patterns
+ */
+export declare function validatePatterns(patterns: string[], availableTools: Tool[]): void;