@mcp-z/cli 1.0.0

package/dist/esm/commands/manifest/env-prompting.js

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

package/dist/esm/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":["confirm","input","password","select","redactValue","value","isSecret","length","substring","substituteTemplateVars","template","variables","replace","match","varName","key","Object","keys","find","k","toLowerCase","getDynamicPlaceholder","envVar","placeholder","promptForEnvVars","serverName","envVars","options","env","envValue","process","name","defaultValue","default","yes","stdin","isTTY","redactedValue","useEnvChoice","choices","isRequired","push","message","promptFn","customValue","validate","trim","actionChoices","action","newValue","console","log","templateVars","shouldSet","description"],"mappings":"AAAA,OAAOA,aAAa,oBAAoB;AACxC,OAAOC,WAAW,kBAAkB;AACpC,OAAOC,cAAc,qBAAqB;AAC1C,OAAOC,YAAY,mBAAmB;AAGtC;;;CAGC,GACD,SAASC,YAAYC,KAAa,EAAEC,QAAiB;IACnD,IAAI,CAACA,UAAU;QACb,OAAOD;IACT;IAEA,IAAIA,MAAME,MAAM,IAAI,GAAG;QACrB,OAAO;IACT;IAEA,OAAO,GAAGF,MAAMG,SAAS,CAAC,GAAG,GAAG,GAAG,CAAC;AACtC;AAEA;;;;CAIC,GACD,OAAO,SAASC,uBAAuBC,QAA4B,EAAEC,SAAkC;IACrG,IAAI,CAACD,YAAY,CAACC,WAAW;QAC3B,OAAOD;IACT;IAEA,0EAA0E;IAC1E,OAAOA,SAASE,OAAO,CAAC,gBAAgB,CAACC,OAAOC;QAC9C,0BAA0B;QAC1B,MAAMC,MAAMC,OAAOC,IAAI,CAACN,WAAWO,IAAI,CAAC,CAACC,IAAMA,EAAEC,WAAW,OAAON,QAAQM,WAAW;QACtF,OAAOL,MAAMJ,SAAS,CAACI,IAAI,GAAGF;IAChC;AACF;AAEA;;CAEC,GACD,SAASQ,sBAAsBC,MAAsB,EAAEX,SAAkC;IACvF,OAAOF,uBAAuBa,OAAOC,WAAW,EAAEZ;AACpD;AAEA;;;;;;;;;CASC,GACD,OAAO,eAAea,iBAAiBC,UAAkB,EAAEC,OAAyB,EAAEC,UAAoE,CAAC,CAAC;IAC1J,MAAMC,MAA8B,CAAC;IAErC,KAAK,MAAMN,UAAUI,QAAS;YAGPJ;QAFrB,MAAMO,WAAWC,QAAQF,GAAG,CAACN,OAAOS,IAAI,CAAC;QACzC,2EAA2E;QAC3E,MAAMC,gBAAeV,kBAAAA,OAAOW,OAAO,cAAdX,6BAAAA,kBAAkBA,OAAOjB,KAAK;QAEnD,IAAI2B,cAAc;YAChB,+CAA+C;YAC/CJ,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAGC;QACrB,OAAO,IAAIH,YAAY,CAACF,QAAQO,GAAG,IAAIJ,QAAQK,KAAK,CAACC,KAAK,EAAE;YAC1D,sEAAsE;YACtE,MAAMC,gBAAgBjC,YAAYyB,UAAUP,OAAOhB,QAAQ;YAC3D,MAAMgC,eAAe,GAAGD,cAAc,cAAc,CAAC;YAErD,IAAIf,OAAOiB,OAAO,IAAIjB,OAAOiB,OAAO,CAAChC,MAAM,GAAG,GAAG;gBAC/C,mDAAmD;gBACnD,MAAMgC,UAAU;oBAACD;uBAAiBhB,OAAOiB,OAAO;oBAAE;iBAAqB;gBAEvE,sCAAsC;gBACtC,IAAI,CAACjB,OAAOkB,UAAU,EAAE;oBACtBD,QAAQE,IAAI,CAAC;gBACf;gBAEA,MAAMC,UAAU,CAAC,CAAC,EAAEjB,WAAW,EAAE,EAAEH,OAAOS,IAAI,EAAE;gBAEhD,MAAM1B,QAAQ,MAAMF,OAAO;oBACzBuC;oBACAH;gBACF;gBAEA,IAAIlC,UAAUiC,cAAc;oBAC1BV,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAGF;gBACrB,OAAO,IAAIxB,UAAU,mBAAmB;gBACtC,uDAAuD;gBACzD,OAAO,IAAIA,UAAU,sBAAsB;oBACzC,MAAMsC,WAAWrB,OAAOhB,QAAQ,GAAGJ,WAAWD;oBAC9C,MAAM2C,cAAc,MAAMD,SAAS;wBACjCD,SAAS,CAAC,CAAC,EAAEjB,WAAW,EAAE,EAAEH,OAAOS,IAAI,CAAC,cAAc,CAAC;wBACvDc,UAAU,CAAC5C;4BACT,IAAIqB,OAAOkB,UAAU,IAAK,CAAA,CAACvC,SAASA,MAAM6C,IAAI,OAAO,EAAC,GAAI;gCACxD,OAAO;4BACT;4BACA,OAAO;wBACT;oBACF;oBACAlB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAGa;gBACrB,OAAO;oBACLhB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAG1B;gBACrB;YACF,OAAO;gBACL,gDAAgD;gBAChD,MAAM0C,gBAAgB;oBACpB;wBAAEhB,MAAM,CAAC,IAAI,EAAEO,cAAc;wBAAEjC,OAAO;oBAAU;oBAChD;wBAAE0B,MAAM;wBAAmB1B,OAAO;oBAAY;iBAC/C;gBAED,sCAAsC;gBACtC,IAAI,CAACiB,OAAOkB,UAAU,EAAE;oBACtBO,cAAcN,IAAI,CAAC;wBAAEV,MAAM;wBAAmB1B,OAAO;oBAAO;gBAC9D;gBAEA,MAAMqC,UAAU,CAAC,CAAC,EAAEjB,WAAW,EAAE,EAAEH,OAAOS,IAAI,EAAE;gBAEhD,MAAMiB,SAAS,MAAM7C,OAAO;oBAC1BuC;oBACAH,SAASQ;gBACX;gBAEA,IAAIC,WAAW,WAAW;oBACxBpB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAGF;gBACrB,OAAO,IAAImB,WAAW,QAAQ;gBAC5B,uDAAuD;gBACzD,OAAO;oBACL,MAAML,WAAWrB,OAAOhB,QAAQ,GAAGJ,WAAWD;oBAC9C,MAAMgD,WAAW,MAAMN,SAAS;wBAC9BD,SAAS,CAAC,CAAC,EAAEjB,WAAW,EAAE,EAAEH,OAAOS,IAAI,CAAC,cAAc,CAAC;wBACvDc,UAAU,CAAC5C;4BACT,IAAIqB,OAAOkB,UAAU,IAAK,CAAA,CAACvC,SAASA,MAAM6C,IAAI,OAAO,EAAC,GAAI;gCACxD,OAAO;4BACT;4BACA,OAAO;wBACT;oBACF;oBACAlB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAGkB;gBACrB;YACF;QACF,OAAO,IAAItB,QAAQO,GAAG,EAAE;YACtB,yEAAyE;YACzE,IAAIZ,OAAOiB,OAAO,IAAIjB,OAAOiB,OAAO,CAAChC,MAAM,GAAG,KAAKe,OAAOiB,OAAO,CAAC,EAAE,EAAE;gBACpE,iCAAiC;gBACjCX,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAGT,OAAOiB,OAAO,CAAC,EAAE;YACtC,OAAO,IAAIjB,OAAOkB,UAAU,EAAE;gBAC5B,8CAA8C;gBAC9CU,QAAQC,GAAG,CAAC,CAAC,gBAAgB,EAAE7B,OAAOS,IAAI,EAAE;YAC9C;QACA,gDAAgD;QAClD,OAAO,IAAIT,OAAOiB,OAAO,IAAIjB,OAAOiB,OAAO,CAAChC,MAAM,GAAG,KAAKe,OAAOiB,OAAO,CAAC,EAAE,EAAE;YAC3E,IAAIT,QAAQK,KAAK,CAACC,KAAK,EAAE;gBACvB,wDAAwD;gBACxD,MAAMG,UAAU;uBAAIjB,OAAOiB,OAAO;iBAAC;gBAEnC,sCAAsC;gBACtC,IAAI,CAACjB,OAAOkB,UAAU,EAAE;oBACtBD,QAAQE,IAAI,CAAC;gBACf;gBAEA,MAAMpC,QAAQ,MAAMF,OAAO;oBACzBuC,SAAS,CAAC,CAAC,EAAEjB,WAAW,EAAE,EAAEH,OAAOS,IAAI,EAAE;oBACzCQ;gBACF;gBAEA,IAAIlC,UAAU,mBAAmB;oBAC/BuB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAG1B;gBACrB;YACA,yDAAyD;YAC3D,OAAO;gBACL,oCAAoC;gBACpCuB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAGT,OAAOiB,OAAO,CAAC,EAAE;YACtC;QACF,OAAO,IAAIjB,OAAOkB,UAAU,EAAE;YAC5B,IAAIV,QAAQK,KAAK,CAACC,KAAK,EAAE;gBACvB,uDAAuD;gBACvD,MAAMO,WAAWrB,OAAOhB,QAAQ,GAAGJ,WAAWD;gBAC9C,MAAMsB,cAAcF,sBAAsBC,QAAQK,QAAQyB,YAAY;gBACtE,MAAM/C,QAAQ,MAAMsC,SAAS;oBAC3BD,SAAS,CAAC,CAAC,EAAEjB,WAAW,EAAE,EAAEH,OAAOS,IAAI,CAAC,WAAW,CAAC;oBACpD,GAAIR,cAAc;wBAAEU,SAASV;oBAAY,IAAI,CAAC,CAAC;oBAC/CsB,UAAU,CAAC5C;wBACT,IAAI,CAACA,SAASA,MAAM6C,IAAI,OAAO,IAAI;4BACjC,OAAO;wBACT;wBACA,OAAO;oBACT;gBACF;gBACAlB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAG1B;YACrB;QACA,4EAA4E;QAC9E,OAAO,IAAI,CAACiB,OAAOkB,UAAU,IAAI,CAACb,QAAQO,GAAG,IAAIJ,QAAQK,KAAK,CAACC,KAAK,EAAE;YACpE,uDAAuD;YACvD,kCAAkC;YAClC,MAAMiB,YAAY,MAAMrD,QAAQ;gBAC9B0C,SAAS,CAAC,CAAC,EAAEjB,WAAW,eAAe,EAAEH,OAAOS,IAAI,CAAC,GAAG,EAAET,OAAOgC,WAAW,IAAI,WAAW,CAAC,CAAC;gBAC7FrB,SAAS;YACX;YAEA,IAAIoB,WAAW;gBACb,MAAMV,WAAWrB,OAAOhB,QAAQ,GAAGJ,WAAWD;gBAC9C,MAAMsB,cAAcF,sBAAsBC,QAAQK,QAAQyB,YAAY;gBACtE,MAAM/C,QAAQ,MAAMsC,SAAS;oBAC3BD,SAAS,CAAC,CAAC,EAAEjB,WAAW,EAAE,EAAEH,OAAOS,IAAI,EAAE;oBACzC,GAAIR,cAAc;wBAAEU,SAASV;oBAAY,IAAI,CAAC,CAAC;gBACjD;gBAEA,IAAIlB,SAAS,AAACA,MAAiByC,IAAI,OAAO,IAAI;oBAC5ClB,GAAG,CAACN,OAAOS,IAAI,CAAC,GAAG1B;gBACrB;YACF;QACF;IACA,sCAAsC;IACxC;IAEA,OAAOuB;AACT"}

package/dist/esm/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>;