@mcp-z/cli 1.0.0

package/dist/cjs/commands/manifest/env-prompting.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/commands/manifest/env-prompting.ts"],"sourcesContent":["import confirm from '@inquirer/confirm';\nimport input from '@inquirer/input';\nimport password from '@inquirer/password';\nimport select from '@inquirer/select';\nimport type { EnvVarMetadata } from './metadata-reader.ts';\n\n/**\n * Redact sensitive values for display, showing only first 4 characters\n * Example: \"sk-1234567890abcdef\" -> \"sk-1XXX\"\n */\nfunction redactValue(value: string, isSecret: boolean): string {\n  if (!isSecret) {\n    return value;\n  }\n\n  if (value.length <= 6) {\n    return 'XXX';\n  }\n\n  return `${value.substring(0, 4)}XXX`;\n}\n\n/**\n * Substitute template variables in a string\n * Replaces any {VARIABLE_NAME} with the corresponding value from the variables map\n * Variable names are case-insensitive\n */\nexport function substituteTemplateVars(template: string | undefined, variables?: Record<string, string>): string | undefined {\n  if (!template || !variables) {\n    return template;\n  }\n\n  // Replace any {VARIABLE_NAME} with corresponding value from variables map\n  return template.replace(/\\{([^}]+)\\}/g, (match, varName) => {\n    // Case-insensitive lookup\n    const key = Object.keys(variables).find((k) => k.toLowerCase() === varName.toLowerCase());\n    return key ? variables[key] : match;\n  });\n}\n\n/**\n * Get dynamic placeholder for env vars by substituting template variables\n */\nfunction getDynamicPlaceholder(envVar: EnvVarMetadata, variables?: Record<string, string>): string | undefined {\n  return substituteTemplateVars(envVar.placeholder, variables);\n}\n\n/**\n * Prompt user for environment variables with support for:\n * - Environment variable detection with partial redaction\n * - Interactive prompts for required fields\n * - Choice-based selection\n * - Password input for secrets\n * - Default values\n * - Non-interactive mode (-y flag)\n * - Dynamic placeholders via template variable substitution\n */\nexport async function promptForEnvVars(serverName: string, envVars: EnvVarMetadata[], options: { yes?: boolean; templateVars?: Record<string, string> } = {}): Promise<Record<string, string>> {\n  const env: Record<string, string> = {};\n\n  for (const envVar of envVars) {\n    const envValue = process.env[envVar.name];\n    // Support both 'default' (MCP schema standard) and 'value' (legacy) fields\n    const defaultValue = envVar.default ?? envVar.value;\n\n    if (defaultValue) {\n      // Use default value from metadata if available\n      env[envVar.name] = defaultValue;\n    } else if (envValue && !options.yes && process.stdin.isTTY) {\n      // Environment variable exists - present option with partial redaction\n      const redactedValue = redactValue(envValue, envVar.isSecret);\n      const useEnvChoice = `${redactedValue} (environment)`;\n\n      if (envVar.choices && envVar.choices.length > 0) {\n        // Has choices - add environment value as an option\n        const choices = [useEnvChoice, ...envVar.choices, 'Enter custom value'];\n\n        // Add skip option for optional fields\n        if (!envVar.isRequired) {\n          choices.push('Skip (optional)');\n        }\n\n        const message = `[${serverName}] ${envVar.name}`;\n\n        const value = await select({\n          message,\n          choices,\n        });\n\n        if (value === useEnvChoice) {\n          env[envVar.name] = envValue;\n        } else if (value === 'Skip (optional)') {\n          // Skip this optional env var - don't add to env object\n        } else if (value === 'Enter custom value') {\n          const promptFn = envVar.isSecret ? password : input;\n          const customValue = await promptFn({\n            message: `[${serverName}] ${envVar.name} (enter value)`,\n            validate: (input: string) => {\n              if (envVar.isRequired && (!input || input.trim() === '')) {\n                return 'This field is required';\n              }\n              return true;\n            },\n          });\n          env[envVar.name] = customValue as string;\n        } else {\n          env[envVar.name] = value as string;\n        }\n      } else {\n        // No choices - simple confirmation or new value\n        const actionChoices = [\n          { name: `Use ${useEnvChoice}`, value: 'use-env' },\n          { name: 'Enter new value', value: 'enter-new' },\n        ];\n\n        // Add skip option for optional fields\n        if (!envVar.isRequired) {\n          actionChoices.push({ name: 'Skip (optional)', value: 'skip' });\n        }\n\n        const message = `[${serverName}] ${envVar.name}`;\n\n        const action = await select({\n          message,\n          choices: actionChoices,\n        });\n\n        if (action === 'use-env') {\n          env[envVar.name] = envValue;\n        } else if (action === 'skip') {\n          // Skip this optional env var - don't add to env object\n        } else {\n          const promptFn = envVar.isSecret ? password : input;\n          const newValue = await promptFn({\n            message: `[${serverName}] ${envVar.name} (enter value)`,\n            validate: (input: string) => {\n              if (envVar.isRequired && (!input || input.trim() === '')) {\n                return 'This field is required';\n              }\n              return true;\n            },\n          });\n          env[envVar.name] = newValue as string;\n        }\n      }\n    } else if (options.yes) {\n      // -y mode: skip required vars without defaults (trust shell environment)\n      if (envVar.choices && envVar.choices.length > 0 && envVar.choices[0]) {\n        // Has choices - use first choice\n        env[envVar.name] = envVar.choices[0];\n      } else if (envVar.isRequired) {\n        // Required but no default - skip with warning\n        console.log(`   ⚠️  Skipping ${envVar.name}`);\n      }\n      // Optional vars without defaults: skip silently\n    } else if (envVar.choices && envVar.choices.length > 0 && envVar.choices[0]) {\n      if (process.stdin.isTTY) {\n        // Interactive mode with choices - prompt user to select\n        const choices = [...envVar.choices];\n\n        // Add skip option for optional fields\n        if (!envVar.isRequired) {\n          choices.push('Skip (optional)');\n        }\n\n        const value = await select({\n          message: `[${serverName}] ${envVar.name}`,\n          choices,\n        });\n\n        if (value !== 'Skip (optional)') {\n          env[envVar.name] = value as string;\n        }\n        // If 'Skip (optional)' selected, don't add to env object\n      } else {\n        // Non-interactive: use first choice\n        env[envVar.name] = envVar.choices[0];\n      }\n    } else if (envVar.isRequired) {\n      if (process.stdin.isTTY) {\n        // Interactive mode - required field - prompt for value\n        const promptFn = envVar.isSecret ? password : input;\n        const placeholder = getDynamicPlaceholder(envVar, options.templateVars);\n        const value = await promptFn({\n          message: `[${serverName}] ${envVar.name} (required)`,\n          ...(placeholder ? { default: placeholder } : {}),\n          validate: (input: string) => {\n            if (!input || input.trim() === '') {\n              return 'This field is required';\n            }\n            return true;\n          },\n        });\n        env[envVar.name] = value as string;\n      }\n      // Non-interactive without -y: skip (will fail at runtime if truly required)\n    } else if (!envVar.isRequired && !options.yes && process.stdin.isTTY) {\n      // Interactive mode - optional env var without defaults\n      // Ask user if they want to set it\n      const shouldSet = await confirm({\n        message: `[${serverName}] Set optional ${envVar.name}? (${envVar.description || 'optional'})`,\n        default: false,\n      });\n\n      if (shouldSet) {\n        const promptFn = envVar.isSecret ? password : input;\n        const placeholder = getDynamicPlaceholder(envVar, options.templateVars);\n        const value = await promptFn({\n          message: `[${serverName}] ${envVar.name}`,\n          ...(placeholder ? { default: placeholder } : {}),\n        });\n\n        if (value && (value as string).trim() !== '') {\n          env[envVar.name] = value as string;\n        }\n      }\n    }\n    // Other optional env vars are skipped\n  }\n\n  return env;\n}\n"],"names":["promptForEnvVars","substituteTemplateVars","redactValue","value","isSecret","length","substring","template","variables","replace","match","varName","key","Object","keys","find","k","toLowerCase","getDynamicPlaceholder","envVar","placeholder","serverName","envVars","options","env","envValue","defaultValue","redactedValue","useEnvChoice","choices","message","promptFn","customValue","actionChoices","action","newValue","shouldSet","process","name","default","yes","stdin","isTTY","isRequired","push","select","password","input","validate","trim","console","log","templateVars","confirm","description"],"mappings":"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"}

package/dist/cjs/commands/manifest/generate.d.cts

@@ -0,0 +1,124 @@
+import type { MCPConfiguration } from '../../types.js';
+import { promptForEnvVars } from './env-prompting.js';
+import { MetadataReader, type ServerMetadata } from './metadata-reader.js';
+export type ConfigurationMode = 'env' | 'args' | 'both' | 'none';
+export interface Dimension {
+    name: string;
+    type: 'env' | 'arg';
+    choices: string[];
+}
+export interface Combination {
+    name: string;
+    envKeys: string[];
+    argNames: string[];
+    defaults: Record<string, string>;
+    argDefaults: Record<string, string>;
+    dimensionValues: Record<string, string>;
+}
+export interface ConfigChoice {
+    combination: Combination;
+    transport: 'stdio' | 'streamable-http';
+    label: string;
+}
+/** Maps user-facing transport names to internal types */
+export declare const TRANSPORT_MAP: Record<string, 'stdio' | 'streamable-http'>;
+/**
+ * Build config choices from combinations and transports.
+ * Used for both "select all" and "select specific" flows.
+ * @param combinations - Array of config combinations
+ * @param transports - Array of transport names ('stdio', 'http', or 'streamable-http')
+ * @returns Array of ConfigChoice objects
+ */
+export declare function createConfigChoices(combinations: Combination[], transports: string[]): ConfigChoice[];
+/**
+ * Filter config choices by selected labels.
+ * @param allChoices - All available config choices
+ * @param selectedLabels - Labels of configs to include
+ * @returns Filtered array of ConfigChoice objects
+ */
+export declare function filterConfigChoices(allChoices: ConfigChoice[], selectedLabels: string[]): ConfigChoice[];
+/**
+ * Generate combinations from env vars with choices (simple cartesian product).
+ * All combinations are generated - user can filter via selection pass.
+ */
+export declare function generateMatrixCombinations(envVars: Array<{
+    name: string;
+    choices: string[];
+}>): Combination[];
+/**
+ * Generate combinations respecting dependsOn relationships.
+ * Conditional dimensions are only included when their dependencies are satisfied.
+ * Example: DCR_MODE only generates variations when AUTH_MODE=dcr
+ */
+export declare function generateConditionalCombinations(envVars: Array<{
+    name: string;
+    choices: string[];
+    dependsOn?: Record<string, string[]>;
+}>): Combination[];
+/**
+ * Check if an environment variable should be prompted based on dependsOn conditions.
+ * Returns true if the envVar has no dependencies, or if all dependencies are satisfied.
+ *
+ * @param envVar - Environment variable metadata with optional dependsOn field
+ * @param selectedValues - Currently selected dimension values (e.g., { AUTH_MODE: 'loopback-oauth' })
+ * @returns true if the env var should be prompted, false if it should be skipped
+ */
+export declare function shouldPromptEnvVar(envVar: {
+    dependsOn?: Record<string, string[]>;
+}, selectedValues: Record<string, string>): boolean;
+/**
+ * Generate server configuration interactively.
+ * Discovers server.json in current directory, prompts for configuration,
+ * and generates config files for selected combinations and transports.
+ *
+ * @param options - Command options
+ * @param options.source - Use source code paths (node instead of npx)
+ * @param options.json - Output to stdout instead of writing files
+ * @param options.matrix - Non-interactive mode: generate all matrix combinations
+ * @param options.output - Output directory (default: examples for --matrix, . otherwise)
+ * @param options.quick - Skip all optional env var prompts, use defaults
+ */
+export declare function generateCommand(options?: {
+    source?: boolean;
+    json?: boolean;
+    matrix?: boolean;
+    output?: string;
+    quick?: boolean;
+}): Promise<void>;
+/** Exported for testing */
+export declare function discoverServerJson(basePath?: string): string | null;
+/** Exported for testing */
+export declare function extractServerName(packageName: string): string;
+/** Generate config object (for JSON output or testing) - Exported for testing */
+export declare function generateConfigObject(params: {
+    serverName: string;
+    combination: Combination;
+    transport: string;
+    packageName: string;
+    packageDir?: string;
+    binPath?: string;
+    metadata: ServerMetadata;
+    metadataReader: Pick<MetadataReader, 'getPackageForTransport'>;
+    httpHost?: string;
+    httpPort?: number;
+    useSource?: boolean;
+    quick?: boolean;
+    optionalVarsToPrompt?: Set<string>;
+}, envPromptFn?: typeof promptForEnvVars): Promise<MCPConfiguration>;
+/** Generate config file - Exported for testing */
+export declare function generateConfigFile(params: {
+    serverName: string;
+    combination: Combination;
+    transport: string;
+    outputDir: string;
+    packageName: string;
+    packageDir?: string;
+    binPath?: string;
+    metadata: ServerMetadata;
+    metadataReader: Pick<MetadataReader, 'getPackageForTransport'>;
+    httpHost?: string;
+    httpPort?: number;
+    useSource?: boolean;
+    quick?: boolean;
+    optionalVarsToPrompt?: Set<string>;
+}, envPromptFn?: typeof promptForEnvVars): Promise<boolean>;

package/dist/cjs/commands/manifest/generate.d.ts

@@ -0,0 +1,124 @@
+import type { MCPConfiguration } from '../../types.js';
+import { promptForEnvVars } from './env-prompting.js';
+import { MetadataReader, type ServerMetadata } from './metadata-reader.js';
+export type ConfigurationMode = 'env' | 'args' | 'both' | 'none';
+export interface Dimension {
+    name: string;
+    type: 'env' | 'arg';
+    choices: string[];
+}
+export interface Combination {
+    name: string;
+    envKeys: string[];
+    argNames: string[];
+    defaults: Record<string, string>;
+    argDefaults: Record<string, string>;
+    dimensionValues: Record<string, string>;
+}
+export interface ConfigChoice {
+    combination: Combination;
+    transport: 'stdio' | 'streamable-http';
+    label: string;
+}
+/** Maps user-facing transport names to internal types */
+export declare const TRANSPORT_MAP: Record<string, 'stdio' | 'streamable-http'>;
+/**
+ * Build config choices from combinations and transports.
+ * Used for both "select all" and "select specific" flows.
+ * @param combinations - Array of config combinations
+ * @param transports - Array of transport names ('stdio', 'http', or 'streamable-http')
+ * @returns Array of ConfigChoice objects
+ */
+export declare function createConfigChoices(combinations: Combination[], transports: string[]): ConfigChoice[];
+/**
+ * Filter config choices by selected labels.
+ * @param allChoices - All available config choices
+ * @param selectedLabels - Labels of configs to include
+ * @returns Filtered array of ConfigChoice objects
+ */
+export declare function filterConfigChoices(allChoices: ConfigChoice[], selectedLabels: string[]): ConfigChoice[];
+/**
+ * Generate combinations from env vars with choices (simple cartesian product).
+ * All combinations are generated - user can filter via selection pass.
+ */
+export declare function generateMatrixCombinations(envVars: Array<{
+    name: string;
+    choices: string[];
+}>): Combination[];
+/**
+ * Generate combinations respecting dependsOn relationships.
+ * Conditional dimensions are only included when their dependencies are satisfied.
+ * Example: DCR_MODE only generates variations when AUTH_MODE=dcr
+ */
+export declare function generateConditionalCombinations(envVars: Array<{
+    name: string;
+    choices: string[];
+    dependsOn?: Record<string, string[]>;
+}>): Combination[];
+/**
+ * Check if an environment variable should be prompted based on dependsOn conditions.
+ * Returns true if the envVar has no dependencies, or if all dependencies are satisfied.
+ *
+ * @param envVar - Environment variable metadata with optional dependsOn field
+ * @param selectedValues - Currently selected dimension values (e.g., { AUTH_MODE: 'loopback-oauth' })
+ * @returns true if the env var should be prompted, false if it should be skipped
+ */
+export declare function shouldPromptEnvVar(envVar: {
+    dependsOn?: Record<string, string[]>;
+}, selectedValues: Record<string, string>): boolean;
+/**
+ * Generate server configuration interactively.
+ * Discovers server.json in current directory, prompts for configuration,
+ * and generates config files for selected combinations and transports.
+ *
+ * @param options - Command options
+ * @param options.source - Use source code paths (node instead of npx)
+ * @param options.json - Output to stdout instead of writing files
+ * @param options.matrix - Non-interactive mode: generate all matrix combinations
+ * @param options.output - Output directory (default: examples for --matrix, . otherwise)
+ * @param options.quick - Skip all optional env var prompts, use defaults
+ */
+export declare function generateCommand(options?: {
+    source?: boolean;
+    json?: boolean;
+    matrix?: boolean;
+    output?: string;
+    quick?: boolean;
+}): Promise<void>;
+/** Exported for testing */
+export declare function discoverServerJson(basePath?: string): string | null;
+/** Exported for testing */
+export declare function extractServerName(packageName: string): string;
+/** Generate config object (for JSON output or testing) - Exported for testing */
+export declare function generateConfigObject(params: {
+    serverName: string;
+    combination: Combination;
+    transport: string;
+    packageName: string;
+    packageDir?: string;
+    binPath?: string;
+    metadata: ServerMetadata;
+    metadataReader: Pick<MetadataReader, 'getPackageForTransport'>;
+    httpHost?: string;
+    httpPort?: number;
+    useSource?: boolean;
+    quick?: boolean;
+    optionalVarsToPrompt?: Set<string>;
+}, envPromptFn?: typeof promptForEnvVars): Promise<MCPConfiguration>;
+/** Generate config file - Exported for testing */
+export declare function generateConfigFile(params: {
+    serverName: string;
+    combination: Combination;
+    transport: string;
+    outputDir: string;
+    packageName: string;
+    packageDir?: string;
+    binPath?: string;
+    metadata: ServerMetadata;
+    metadataReader: Pick<MetadataReader, 'getPackageForTransport'>;
+    httpHost?: string;
+    httpPort?: number;
+    useSource?: boolean;
+    quick?: boolean;
+    optionalVarsToPrompt?: Set<string>;
+}, envPromptFn?: typeof promptForEnvVars): Promise<boolean>;