padrone 1.8.2 → 2.0.0

package/dist/extension/version.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.mts","names":[],"sources":["../../src/extension/version.ts"],"mappings":";;;;KAUY,cAAA,GAAiB,cAAc,gBAAgB,aAAA;AAAA,KAE/C,WAAA,MAAiB,WAAA,CAAY,CAAA,aAAc,cAAA;;AAFvD;;;;AAAwE;AAExE;;;;iBAwCgB,cAAA,eAA6B,gBAAA,EAAkB,OAAA,EAAS,CAAA,KAAM,WAAA,CAAY,CAAA"}

package/dist/extension/version.mjs

@@ -0,0 +1,51 @@
+import { resolveCommand } from "../core/commands.mjs";
+import { thenMaybe } from "../core/results.mjs";
+import { defineInterceptor } from "../core/interceptors.mjs";
+import { getRootCommand, getVersion } from "../util/utils.mjs";
+//#region src/extension/version.ts
+const versionInterceptor = defineInterceptor({
+	id: "padrone:version",
+	name: "padrone:version",
+	order: -1e3
+}, () => ({ parse(_ctx, next) {
+	return thenMaybe(next(), (res) => {
+		if ((res.rawArgs.version || res.rawArgs.v || res.rawArgs.V) && !res.command.parent) {
+			delete res.rawArgs.version;
+			delete res.rawArgs.v;
+			delete res.rawArgs.V;
+			const versionCmd = res.command.commands?.find((c) => c.name === "version");
+			if (versionCmd) {
+				resolveCommand(versionCmd);
+				return {
+					...res,
+					command: versionCmd,
+					rawArgs: {},
+					positionalArgs: []
+				};
+			}
+		}
+		return res;
+	});
+} }));
+/**
+* Extension that adds version support:
+* - `version` command
+* - `--version` / `-v` / `-V` flags (root command only)
+*
+* Usage:
+* ```ts
+* createPadrone('my-cli').extend(padroneVersion())
+* ```
+*/
+function padroneVersion() {
+	return ((builder) => builder.command("version", (c) => c.configure({
+		description: "Display the version number",
+		hidden: true
+	}).action((_args, ctx) => {
+		return getVersion(getRootCommand(ctx.command).version);
+	})).intercept(versionInterceptor));
+}
+//#endregion
+export { padroneVersion };
+
+//# sourceMappingURL=version.mjs.map

package/dist/extension/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","names":[],"sources":["../../src/extension/version.ts"],"sourcesContent":["import { thenMaybe } from '#src/core/results.ts';\nimport { resolveCommand } from '../core/commands.ts';\nimport { defineInterceptor } from '../core/interceptors.ts';\nimport type { AnyPadroneBuilder, CommandTypesBase, PadroneCommand } from '../types/index.ts';\nimport type { PadroneSchema } from '../types/schema.ts';\nimport type { WithCommand } from '../util/type-utils.ts';\nimport { getRootCommand, getVersion } from '../util/utils.ts';\n\n// ── Types ────────────────────────────────────────────────────────────────\n\nexport type VersionCommand = PadroneCommand<'version', '', PadroneSchema<void>, string, [], [], false>;\n\nexport type WithVersion<T> = WithCommand<T, 'version', VersionCommand>;\n\n// ── Interceptor ─────────────────────────────────────────────────────────\n\nconst versionInterceptor = defineInterceptor({ id: 'padrone:version', name: 'padrone:version', order: -1000 }, () => ({\n  parse(_ctx, next) {\n    return thenMaybe(next(), (res) => {\n      const hasVersionFlag = res.rawArgs.version || res.rawArgs.v || res.rawArgs.V;\n\n      // Only show version for root command (no subcommand matched)\n      if (hasVersionFlag && !res.command.parent) {\n        delete res.rawArgs.version;\n        delete res.rawArgs.v;\n        delete res.rawArgs.V;\n\n        // Route to the version command so its action handles the rest\n        const versionCmd = res.command.commands?.find((c) => c.name === 'version');\n        if (versionCmd) {\n          resolveCommand(versionCmd);\n          return { ...res, command: versionCmd, rawArgs: {}, positionalArgs: [] };\n        }\n      }\n\n      return res;\n    });\n  },\n}));\n\n// ── Extension ────────────────────────────────────────────────────────────\n\n/**\n * Extension that adds version support:\n * - `version` command\n * - `--version` / `-v` / `-V` flags (root command only)\n *\n * Usage:\n * ```ts\n * createPadrone('my-cli').extend(padroneVersion())\n * ```\n */\nexport function padroneVersion(): <T extends CommandTypesBase>(builder: T) => WithVersion<T> {\n  return ((builder: AnyPadroneBuilder) =>\n    builder\n      .command('version', (c) =>\n        c.configure({ description: 'Display the version number', hidden: true }).action((_args, ctx) => {\n          const rootCommand = getRootCommand(ctx.command);\n          return getVersion(rootCommand.version);\n        }),\n      )\n      .intercept(versionInterceptor)) as any;\n}\n"],"mappings":";;;;;AAgBA,MAAM,qBAAqB,kBAAkB;CAAE,IAAI;CAAmB,MAAM;CAAmB,OAAO;AAAM,UAAU,EACpH,MAAM,MAAM,MAAM;CAChB,OAAO,UAAU,KAAK,IAAI,QAAQ;EAIhC,KAHuB,IAAI,QAAQ,WAAW,IAAI,QAAQ,KAAK,IAAI,QAAQ,MAGrD,CAAC,IAAI,QAAQ,QAAQ;GACzC,OAAO,IAAI,QAAQ;GACnB,OAAO,IAAI,QAAQ;GACnB,OAAO,IAAI,QAAQ;GAGnB,MAAM,aAAa,IAAI,QAAQ,UAAU,MAAM,MAAM,EAAE,SAAS,SAAS;GACzE,IAAI,YAAY;IACd,eAAe,UAAU;IACzB,OAAO;KAAE,GAAG;KAAK,SAAS;KAAY,SAAS,CAAC;KAAG,gBAAgB,CAAC;IAAE;GACxE;EACF;EAEA,OAAO;CACT,CAAC;AACH,EACF,EAAE;;;;;;;;;;;AAcF,SAAgB,iBAA6E;CAC3F,SAAS,YACP,QACG,QAAQ,YAAY,MACnB,EAAE,UAAU;EAAE,aAAa;EAA8B,QAAQ;CAAK,CAAC,CAAC,CAAC,QAAQ,OAAO,QAAQ;EAE9F,OAAO,WADa,eAAe,IAAI,OACX,CAAC,CAAC,OAAO;CACvC,CAAC,CACH,CAAC,CACA,UAAU,kBAAkB;AACnC"}

package/dist/{completion-UnBKfGuk.mjs → feature/completion.mjs}

@@ -1,4 +1,5 @@
-import { a as getJsonSchema, d as detectShell, i as extractSchemaMetadata, m as writeToRcFile, p as getRcFile } from "./args-DrCXxXeP.mjs";
+import { detectShell, getRcFile, writeToRcFile } from "../util/shell-utils.mjs";
+import { extractSchemaMetadata, getJsonSchema } from "../core/args.mjs";
 //#region src/feature/completion.ts
 /**
 * Collects all commands from a program recursively.
@@ -390,6 +391,6 @@ function buildSetupSnippet(programName, shell, beginMarker, endMarker) {
 	}
 }
 //#endregion
-export { detectShell, generateCompletionOutput, setupCompletions };
+export { detectShell, generateBashCompletion, generateCompletion, generateCompletionOutput, generateFishCompletion, generatePowerShellCompletion, generateZshCompletion, getCompletionInstallInstructions, setupCompletions };
 
-//# sourceMappingURL=completion-UnBKfGuk.mjs.map
+//# sourceMappingURL=completion.mjs.map

package/dist/feature/completion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.mjs","names":[],"sources":["../../src/feature/completion.ts"],"sourcesContent":["import { extractSchemaMetadata, getJsonSchema } from '../core/args.ts';\nimport type { AnyPadroneCommand } from '../types/index.ts';\nimport { detectShell, getRcFile, type ShellType, writeToRcFile } from '../util/shell-utils.ts';\n\nexport { detectShell, escapeRegExp, getRcFile, type ShellType, writeToRcFile } from '../util/shell-utils.ts';\n\n/**\n * Collects all commands from a program recursively.\n */\nfunction collectAllCommands(cmd: AnyPadroneCommand): AnyPadroneCommand[] {\n  const result: AnyPadroneCommand[] = [];\n\n  if (cmd.commands) {\n    for (const subcmd of cmd.commands) {\n      if (!subcmd.hidden) {\n        result.push(subcmd);\n        result.push(...collectAllCommands(subcmd));\n      }\n    }\n  }\n\n  return result;\n}\n\ninterface ExtractedArg {\n  name: string;\n  alias?: string;\n  isBoolean: boolean;\n  enum?: string[];\n  description?: string;\n}\n\n/**\n * Extracts all argument names from a command's schema.\n */\nfunction extractArguments(cmd: AnyPadroneCommand): ExtractedArg[] {\n  const argList: ExtractedArg[] = [];\n\n  if (!cmd.argsSchema) return argList;\n\n  try {\n    const argsMeta = cmd.meta?.fields;\n    const { aliases } = extractSchemaMetadata(cmd.argsSchema, argsMeta, cmd.meta?.autoAlias);\n\n    // Build reverse map: argName → aliasName\n    const argToAlias: Record<string, string> = {};\n    for (const [aliasName, argName] of Object.entries(aliases)) {\n      if (!argToAlias[argName]) argToAlias[argName] = aliasName;\n    }\n\n    const jsonSchema = getJsonSchema(cmd.argsSchema) as Record<string, any>;\n\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      for (const [key, prop] of Object.entries(jsonSchema.properties as Record<string, any>)) {\n        const enumValues = (prop.enum ?? prop.items?.enum) as string[] | undefined;\n        const optMeta = argsMeta?.[key];\n        argList.push({\n          name: key,\n          alias: argToAlias[key],\n          isBoolean: prop?.type === 'boolean',\n          enum: enumValues,\n          description: optMeta?.description ?? prop.description,\n        });\n      }\n    }\n  } catch {\n    // Ignore schema parsing errors\n  }\n\n  return argList;\n}\n\n/**\n * Collects unique args across all commands, preserving first-seen enum values.\n */\nfunction collectUniqueArgs(program: AnyPadroneCommand, commands: AnyPadroneCommand[]): Map<string, ExtractedArg> {\n  const seen = new Map<string, ExtractedArg>();\n\n  for (const cmd of [program, ...commands]) {\n    for (const arg of extractArguments(cmd)) {\n      if (!seen.has(arg.name)) {\n        seen.set(arg.name, arg);\n      }\n    }\n  }\n\n  return seen;\n}\n\n/**\n * Generates a Bash completion script for the program.\n */\nexport function generateBashCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n  const commandNames = commands.map((c) => c.name).join(' ');\n  const uniqueArgs = collectUniqueArgs(program, commands);\n\n  // Collect all option names\n  const allArguments = new Set<string>();\n  allArguments.add('--help');\n  allArguments.add('--version');\n\n  for (const arg of uniqueArgs.values()) {\n    allArguments.add(`--${arg.name}`);\n    if (arg.alias) allArguments.add(`--${arg.alias}`);\n  }\n\n  const argsList = Array.from(allArguments).join(' ');\n\n  // Build case branches for options with enum values\n  const enumCases: string[] = [];\n  for (const arg of uniqueArgs.values()) {\n    if (!arg.enum || arg.enum.length === 0) continue;\n    const values = arg.enum.join(' ');\n    const patterns = [`--${arg.name}`];\n    if (arg.alias) patterns.push(`--${arg.alias}`);\n    enumCases.push(`      ${patterns.join('|')}) COMPREPLY=($(compgen -W \"${values}\" -- \"$cur\")); return 0 ;;`);\n  }\n\n  const enumBlock =\n    enumCases.length > 0\n      ? `\n    # Complete option values\n    case \"$prev\" in\n${enumCases.join('\\n')}\n    esac\n\n`\n      : '\\n';\n\n  return `###-begin-${programName}-completion-###\n#\n# ${programName} command completion script\n#\n# Installation: ${programName} completion >> ~/.bashrc  (or ~/.zshrc)\n# Or, maybe: ${programName} completion > /usr/local/etc/bash_completion.d/${programName}\n#\n\nif type complete &>/dev/null; then\n  _${programName}_completion() {\n    local cur prev words cword\n    if type _get_comp_words_by_ref &>/dev/null; then\n      _get_comp_words_by_ref -n = -n @ -n : -w words -i cword\n    else\n      cword=\"$COMP_CWORD\"\n      words=(\"\\${COMP_WORDS[@]}\")\n    fi\n\n    cur=\"\\${words[cword]}\"\n    prev=\"\\${words[cword-1]}\"\n\n    local commands=\"${commandNames}\"\n    local args=\"${argsList}\"\n${enumBlock}    # Complete args when current word starts with -\n    if [[ \"$cur\" == -* ]]; then\n      COMPREPLY=($(compgen -W \"$args\" -- \"$cur\"))\n      return 0\n    fi\n\n    # Complete commands\n    COMPREPLY=($(compgen -W \"$commands\" -- \"$cur\"))\n  }\n  complete -o bashdefault -o default -o nospace -F _${programName}_completion ${programName}\nelif type compdef &>/dev/null; then\n  _${programName}_completion() {\n    local si=$IFS\n    local commands=\"${commandNames}\"\n    local args=\"${argsList}\"\n\n    if [[ \"\\${words[CURRENT]}\" == -* ]]; then\n      compadd -- \\${=args}\n    else\n      compadd -- \\${=commands}\n    fi\n    IFS=$si\n  }\n  compdef _${programName}_completion ${programName}\nelif type compctl &>/dev/null; then\n  _${programName}_completion() {\n    local commands=\"${commandNames}\"\n    local args=\"${argsList}\"\n\n    if [[ \"\\${words[CURRENT]}\" == -* ]]; then\n      reply=(\\${=args})\n    else\n      reply=(\\${=commands})\n    fi\n  }\n  compctl -K _${programName}_completion ${programName}\nfi\n###-end-${programName}-completion-###`;\n}\n\n/**\n * Generates a Zsh completion script for the program.\n */\nexport function generateZshCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n\n  // Generate command completions with descriptions\n  const commandCompletions = commands\n    .map((cmd) => {\n      const desc = cmd.description || cmd.title || '';\n      const escapedDesc = desc.replace(/'/g, \"'\\\\''\").replace(/:/g, '\\\\:');\n      return `      '${cmd.name}:${escapedDesc}'`;\n    })\n    .join('\\n');\n\n  // Collect all args with descriptions and enum values\n  const argumentCompletions: string[] = [];\n  argumentCompletions.push(\"      '--help[Show help information]'\");\n  argumentCompletions.push(\"      '--version[Show version number]'\");\n\n  const uniqueArgs = collectUniqueArgs(program, commands);\n\n  for (const arg of uniqueArgs.values()) {\n    const desc = arg.description || '';\n    const escapedDesc = desc.replace(/'/g, \"'\\\\''\").replace(/\\[/g, '\\\\[').replace(/\\]/g, '\\\\]');\n\n    // Zsh action spec for enum values: :label:(val1 val2 val3)\n    const valueAction = arg.enum?.length ? `: :(${arg.enum.join(' ')})` : '';\n\n    if (arg.alias) {\n      argumentCompletions.push(`      {--${arg.alias},--${arg.name}}'[${escapedDesc}]${valueAction}'`);\n    } else {\n      argumentCompletions.push(`      '--${arg.name}[${escapedDesc}]${valueAction}'`);\n    }\n  }\n\n  return `#compdef ${programName}\n###-begin-${programName}-completion-###\n#\n# ${programName} command completion script for Zsh\n#\n# Installation: ${programName} completion >> ~/.zshrc\n# Or: ${programName} completion > ~/.zsh/completions/_${programName}\n#\n\n_${programName}() {\n  local -a commands\n  local -a args\n\n  commands=(\n${commandCompletions}\n  )\n\n  args=(\n${argumentCompletions.join('\\n')}\n  )\n\n  _arguments -s \\\\\n    $args \\\\\n    '1: :->command' \\\\\n    '*::arg:->args'\n\n  case \"$state\" in\n    command)\n      _describe 'command' commands\n      ;;\n  esac\n}\n\n_${programName}\n###-end-${programName}-completion-###`;\n}\n\n/**\n * Generates a Fish completion script for the program.\n */\nexport function generateFishCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n\n  const lines: string[] = [\n    `###-begin-${programName}-completion-###`,\n    '#',\n    `# ${programName} command completion script for Fish`,\n    '#',\n    `# Installation: ${programName} completion > ~/.config/fish/completions/${programName}.fish`,\n    '#',\n    '',\n    `# Clear existing completions`,\n    `complete -c ${programName} -e`,\n    '',\n    '# Commands',\n  ];\n\n  for (const cmd of commands) {\n    const desc = cmd.description || cmd.title || '';\n    const escapedDesc = desc.replace(/'/g, \"\\\\'\");\n    lines.push(`complete -c ${programName} -n \"__fish_use_subcommand\" -a \"${cmd.name}\" -d '${escapedDesc}'`);\n  }\n\n  lines.push('');\n  lines.push('# Global arguments');\n  lines.push(`complete -c ${programName} -l help -d 'Show help information'`);\n  lines.push(`complete -c ${programName} -l version -d 'Show version number'`);\n\n  const uniqueArgs = collectUniqueArgs(program, commands);\n\n  for (const arg of uniqueArgs.values()) {\n    const desc = arg.description || '';\n    const escapedDesc = desc.replace(/'/g, \"\\\\'\");\n    // Fish: -xa 'val1 val2' provides exclusive value completions\n    const valueFlag = arg.enum?.length ? ` -xa '${arg.enum.join(' ')}'` : '';\n\n    if (arg.alias) {\n      lines.push(`complete -c ${programName} -l ${arg.name} -s ${arg.alias} -d '${escapedDesc}'${valueFlag}`);\n    } else {\n      lines.push(`complete -c ${programName} -l ${arg.name} -d '${escapedDesc}'${valueFlag}`);\n    }\n  }\n\n  lines.push(`###-end-${programName}-completion-###`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Generates a PowerShell completion script for the program.\n */\nexport function generatePowerShellCompletion(program: AnyPadroneCommand): string {\n  const programName = program.name;\n  const commands = collectAllCommands(program);\n  const uniqueArgs = collectUniqueArgs(program, commands);\n\n  const commandNames = commands.map((c) => `'${c.name}'`).join(', ');\n\n  // Collect all option names\n  const argNames: string[] = [\"'--help'\", \"'--version'\"];\n  for (const arg of uniqueArgs.values()) {\n    argNames.push(`'--${arg.name}'`);\n    if (arg.alias) argNames.push(`'--${arg.alias}'`);\n  }\n\n  // Build switch cases for option value completion\n  const enumCases: string[] = [];\n  for (const arg of uniqueArgs.values()) {\n    if (!arg.enum || arg.enum.length === 0) continue;\n    const values = arg.enum.map((v) => `'${v}'`).join(', ');\n    const patterns = [`'--${arg.name}'`];\n    if (arg.alias) patterns.push(`'--${arg.alias}'`);\n    enumCases.push(`      ${patterns.join(', ')} { @(${values}) | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {\n        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)\n      }; return }`);\n  }\n\n  const enumBlock =\n    enumCases.length > 0\n      ? `\n  # Complete option values\n  $prevWord = $commandAst.CommandElements | Select-Object -Last 2 | Select-Object -First 1\n  switch ($prevWord) {\n${enumCases.join('\\n')}\n  }\n\n`\n      : '\\n';\n\n  return `###-begin-${programName}-completion-###\n#\n# ${programName} command completion script for PowerShell\n#\n# Installation: ${programName} completion >> $PROFILE\n#\n\nRegister-ArgumentCompleter -Native -CommandName ${programName} -ScriptBlock {\n  param($wordToComplete, $commandAst, $cursorPosition)\n\n  $commands = @(${commandNames})\n  $args = @(${argNames.join(', ')})\n${enumBlock}  if ($wordToComplete -like '-*') {\n    $args | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {\n      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)\n    }\n  } else {\n    $commands | Where-Object { $_ -like \"$wordToComplete*\" } | ForEach-Object {\n      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)\n    }\n  }\n}\n###-end-${programName}-completion-###`;\n}\n\n/**\n * Generates a completion script for the specified shell.\n */\nexport function generateCompletion(program: AnyPadroneCommand, shell: ShellType): string {\n  switch (shell) {\n    case 'bash':\n      return generateBashCompletion(program);\n    case 'zsh':\n      return generateZshCompletion(program);\n    case 'fish':\n      return generateFishCompletion(program);\n    case 'powershell':\n      return generatePowerShellCompletion(program);\n    default:\n      throw new Error(`Unsupported shell: ${shell}`);\n  }\n}\n\n/**\n * Gets the installation instructions for a shell completion script.\n */\nexport function getCompletionInstallInstructions(programName: string, shell: ShellType): string {\n  switch (shell) {\n    case 'bash':\n      return `# Add to ~/.bashrc:\n${programName} completion bash >> ~/.bashrc\n\n# Or install system-wide:\n${programName} completion bash > /usr/local/etc/bash_completion.d/${programName}`;\n\n    case 'zsh':\n      return `# Add to ~/.zshrc:\n${programName} completion zsh >> ~/.zshrc\n\n# Or add to completions directory:\n${programName} completion zsh > ~/.zsh/completions/_${programName}`;\n\n    case 'fish':\n      return `# Install to Fish completions:\n${programName} completion fish > ~/.config/fish/completions/${programName}.fish`;\n\n    case 'powershell':\n      return `# Add to PowerShell profile:\n${programName} completion powershell >> $PROFILE`;\n\n    default:\n      return `# Run: ${programName} completion <shell>\n# Supported shells: bash, zsh, fish, powershell`;\n  }\n}\n\n/**\n * Generates the completion output with automatic shell detection.\n * If shell is not specified, detects the current shell and provides instructions.\n */\nexport async function generateCompletionOutput(program: AnyPadroneCommand, shell?: ShellType): Promise<string> {\n  const programName = program.name;\n\n  if (shell) {\n    return generateCompletion(program, shell);\n  }\n\n  // Auto-detect shell and provide instructions\n  const detectedShell = await detectShell();\n\n  if (detectedShell) {\n    const instructions = getCompletionInstallInstructions(programName, detectedShell);\n    const script = generateCompletion(program, detectedShell);\n\n    return `# Detected shell: ${detectedShell}\n#\n${instructions}\n#\n# Or evaluate directly (temporary, for current session only):\n# eval \"$(${programName} completion ${detectedShell})\"\n\n${script}`;\n  }\n\n  // Could not detect shell - provide usage info\n  return `# Shell auto-detection failed.\n#\n# Usage: ${programName} completion <shell>\n#\n# Supported shells:\n#   bash       - Bash completion script\n#   zsh        - Zsh completion script\n#   fish       - Fish completion script\n#   powershell - PowerShell completion script\n#\n# Example:\n#   ${programName} completion bash >> ~/.bashrc\n#   ${programName} completion zsh >> ~/.zshrc\n#   ${programName} completion fish > ~/.config/fish/completions/${programName}.fish\n#   ${programName} completion powershell >> $PROFILE`;\n}\n\nexport interface SetupCompletionsResult {\n  /** The file that was written to. */\n  file: string;\n  /** Whether an existing completion block was replaced (true) or a new one was appended (false). */\n  updated: boolean;\n}\n\n/**\n * Sets up shell completions by writing an eval snippet to the appropriate shell config file.\n * Uses marker comments for idempotency — re-running replaces the existing block.\n */\nexport async function setupCompletions(programName: string, shell: ShellType): Promise<SetupCompletionsResult> {\n  const { existsSync, mkdirSync, writeFileSync } = await import('node:fs');\n  const { join } = await import('node:path');\n  const { homedir } = await import('node:os');\n\n  const beginMarker = `###-begin-${programName}-completion-###`;\n  const endMarker = `###-end-${programName}-completion-###`;\n  const snippet = buildSetupSnippet(programName, shell, beginMarker, endMarker);\n\n  if (shell === 'fish') {\n    const completionsDir = join(homedir(), '.config', 'fish', 'completions');\n    const filePath = join(completionsDir, `${programName}.fish`);\n    mkdirSync(completionsDir, { recursive: true });\n    const existed = existsSync(filePath);\n    writeFileSync(filePath, `${snippet}\\n`);\n    return { file: filePath, updated: existed };\n  }\n\n  const rcFile = await getRcFile(shell);\n  if (!rcFile) {\n    throw new Error(`Could not determine config file for ${shell}.`);\n  }\n\n  return writeToRcFile(rcFile, snippet, beginMarker, endMarker);\n}\n\nfunction buildSetupSnippet(programName: string, shell: ShellType, beginMarker: string, endMarker: string): string {\n  const evalCmd = `${programName} completion ${shell}`;\n\n  switch (shell) {\n    case 'bash':\n    case 'zsh':\n      return `${beginMarker}\\neval \"$(${evalCmd})\"\\n${endMarker}`;\n    case 'fish':\n      return `${beginMarker}\\n${evalCmd} | source\\n${endMarker}`;\n    case 'powershell':\n      return `${beginMarker}\\n${evalCmd} | Invoke-Expression\\n${endMarker}`;\n  }\n}\n"],"mappings":"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"}

package/dist/feature/interactive.mjs

@@ -0,0 +1,145 @@
+import { getJsonSchema } from "../core/args.mjs";
+//#region src/feature/interactive.ts
+/**
+* Auto-detect the prompt type for a field based on its JSON schema property definition.
+*/
+function detectPromptConfig(name, propSchema, description) {
+	const message = description || propSchema?.description || name;
+	if (!propSchema) return {
+		name,
+		message,
+		type: "input"
+	};
+	if (propSchema.type === "boolean") return {
+		name,
+		message,
+		type: "confirm",
+		default: propSchema.default
+	};
+	if (propSchema.enum) return {
+		name,
+		message,
+		type: "select",
+		choices: propSchema.enum.map((v) => ({
+			label: String(v),
+			value: v
+		})),
+		default: propSchema.default
+	};
+	if (propSchema.type === "array" && propSchema.items?.enum) return {
+		name,
+		message,
+		type: "multiselect",
+		choices: propSchema.items.enum.map((v) => ({
+			label: String(v),
+			value: v
+		})),
+		default: propSchema.default
+	};
+	if (propSchema.format === "password") return {
+		name,
+		message,
+		type: "password",
+		default: propSchema.default
+	};
+	return {
+		name,
+		message,
+		type: "input",
+		default: propSchema.default
+	};
+}
+/**
+* Prompt a single field and validate it against the command's schema.
+* Re-prompts with a warning until the user provides a valid value.
+*/
+async function promptWithValidation(field, config, currentData, command, runtime) {
+	let promptConfig = config;
+	while (true) {
+		const value = await runtime.prompt(promptConfig);
+		if (!command.argsSchema) return value;
+		const testData = {
+			...currentData,
+			[field]: value
+		};
+		const validated = await command.argsSchema["~standard"].validate(testData);
+		if (!validated.issues) return value;
+		const fieldIssues = validated.issues.filter((issue) => {
+			const rootKey = issue.path?.[0];
+			return rootKey !== void 0 && String(rootKey) === field;
+		});
+		if (fieldIssues.length === 0) return value;
+		const messages = fieldIssues.map((i) => i.message).join("; ");
+		runtime.error(`Invalid value for "${field}": ${messages}`);
+		promptConfig = {
+			...config,
+			default: value
+		};
+	}
+}
+/**
+* Prompt for missing interactive fields.
+* Runs after env/config preprocessing and before schema validation.
+*
+* When `force` is true, all configured interactive fields are prompted even if they already
+* have values. The current values are used as defaults in the prompts.
+*/
+async function promptInteractiveFields(data, command, runtime, force) {
+	if (!runtime.prompt) return data;
+	const meta = command.meta;
+	const interactiveConfig = meta?.interactive;
+	const optionalInteractiveConfig = meta?.optionalInteractive;
+	if (!interactiveConfig && !optionalInteractiveConfig) return data;
+	let jsonProperties = {};
+	let requiredFields = /* @__PURE__ */ new Set();
+	if (command.argsSchema) try {
+		const jsonSchema = getJsonSchema(command.argsSchema);
+		if (jsonSchema.type === "object" && jsonSchema.properties) jsonProperties = jsonSchema.properties;
+		if (Array.isArray(jsonSchema.required)) requiredFields = new Set(jsonSchema.required);
+	} catch {}
+	const fieldDescriptions = {};
+	if (meta?.fields) {
+		for (const [key, value] of Object.entries(meta.fields)) if (value?.description) fieldDescriptions[key] = value.description;
+	}
+	const result = { ...data };
+	let fieldsToPrompt = [];
+	if (interactiveConfig === true) if (force) fieldsToPrompt = [...requiredFields];
+	else fieldsToPrompt = [...requiredFields].filter((name) => result[name] === void 0);
+	else if (Array.isArray(interactiveConfig)) if (force) fieldsToPrompt = [...interactiveConfig];
+	else fieldsToPrompt = interactiveConfig.filter((name) => result[name] === void 0);
+	for (const field of fieldsToPrompt) {
+		const config = detectPromptConfig(field, jsonProperties[field], fieldDescriptions[field]);
+		if (force && result[field] !== void 0) config.default = result[field];
+		result[field] = await promptWithValidation(field, config, result, command, runtime);
+	}
+	let optionalFields = [];
+	if (optionalInteractiveConfig === true) if (force) optionalFields = Object.keys(jsonProperties).filter((name) => !requiredFields.has(name));
+	else optionalFields = Object.keys(jsonProperties).filter((name) => !requiredFields.has(name) && result[name] === void 0);
+	else if (Array.isArray(optionalInteractiveConfig)) if (force) optionalFields = [...optionalInteractiveConfig];
+	else optionalFields = optionalInteractiveConfig.filter((name) => result[name] === void 0);
+	if (optionalFields.length > 0) {
+		const selected = await runtime.prompt({
+			name: "_optionalFields",
+			message: "Would you also like to configure:",
+			type: "multiselect",
+			choices: optionalFields.map((f) => {
+				const label = fieldDescriptions[f] || jsonProperties[f]?.description || f;
+				const currentValue = result[f];
+				return {
+					label: force && currentValue !== void 0 ? `${label} (current: ${currentValue})` : label,
+					value: f
+				};
+			})
+		});
+		if (Array.isArray(selected)) for (const field of selected) {
+			const config = detectPromptConfig(field, jsonProperties[field], fieldDescriptions[field]);
+			if (force && result[field] !== void 0) config.default = result[field];
+			result[field] = await promptWithValidation(field, config, result, command, runtime);
+		}
+	}
+	return result;
+}
+//#endregion
+export { detectPromptConfig, promptInteractiveFields };
+
+//# sourceMappingURL=interactive.mjs.map

package/dist/feature/interactive.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.mjs","names":[],"sources":["../../src/feature/interactive.ts"],"sourcesContent":["import { getJsonSchema } from '../core/args.ts';\nimport type { InteractivePromptConfig, ResolvedPadroneRuntime } from '../core/runtime.ts';\nimport type { AnyPadroneCommand } from '../types/index.ts';\n\n/**\n * Auto-detect the prompt type for a field based on its JSON schema property definition.\n */\nexport function detectPromptConfig(\n  name: string,\n  propSchema: Record<string, any> | undefined,\n  description?: string,\n): InteractivePromptConfig {\n  const message = description || propSchema?.description || name;\n\n  if (!propSchema) return { name, message, type: 'input' };\n\n  if (propSchema.type === 'boolean') {\n    return { name, message, type: 'confirm', default: propSchema.default };\n  }\n\n  if (propSchema.enum) {\n    return {\n      name,\n      message,\n      type: 'select',\n      choices: propSchema.enum.map((v: unknown) => ({ label: String(v), value: v })),\n      default: propSchema.default,\n    };\n  }\n\n  if (propSchema.type === 'array' && propSchema.items?.enum) {\n    return {\n      name,\n      message,\n      type: 'multiselect',\n      choices: propSchema.items.enum.map((v: unknown) => ({ label: String(v), value: v })),\n      default: propSchema.default,\n    };\n  }\n\n  if (propSchema.format === 'password') {\n    return { name, message, type: 'password', default: propSchema.default };\n  }\n\n  return { name, message, type: 'input', default: propSchema.default };\n}\n\n/**\n * Prompt a single field and validate it against the command's schema.\n * Re-prompts with a warning until the user provides a valid value.\n */\nasync function promptWithValidation(\n  field: string,\n  config: InteractivePromptConfig,\n  currentData: Record<string, unknown>,\n  command: AnyPadroneCommand,\n  runtime: ResolvedPadroneRuntime,\n): Promise<unknown> {\n  let promptConfig = config;\n\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const value = await runtime.prompt!(promptConfig);\n\n    if (!command.argsSchema) return value;\n\n    // Validate the full object with the new value to catch field-level issues\n    const testData = { ...currentData, [field]: value };\n    const validated = await command.argsSchema['~standard'].validate(testData);\n\n    if (!validated.issues) return value;\n\n    // Only keep issues whose path starts with this field\n    const fieldIssues = validated.issues.filter((issue: { path?: ReadonlyArray<PropertyKey> }) => {\n      const rootKey = issue.path?.[0];\n      return rootKey !== undefined && String(rootKey) === field;\n    });\n\n    if (fieldIssues.length === 0) return value;\n\n    // Warn the user and re-prompt with the invalid value as default\n    const messages = fieldIssues.map((i: { message: string }) => i.message).join('; ');\n    runtime.error(`Invalid value for \"${field}\": ${messages}`);\n    promptConfig = { ...config, default: value };\n  }\n}\n\n/**\n * Prompt for missing interactive fields.\n * Runs after env/config preprocessing and before schema validation.\n *\n * When `force` is true, all configured interactive fields are prompted even if they already\n * have values. The current values are used as defaults in the prompts.\n */\nexport async function promptInteractiveFields(\n  data: Record<string, unknown>,\n  command: AnyPadroneCommand,\n  runtime: ResolvedPadroneRuntime,\n  force?: boolean,\n): Promise<Record<string, unknown>> {\n  if (!runtime.prompt) return data;\n\n  const meta = command.meta;\n  const interactiveConfig = meta?.interactive;\n  const optionalInteractiveConfig = meta?.optionalInteractive;\n  if (!interactiveConfig && !optionalInteractiveConfig) return data;\n\n  // Extract JSON schema properties for prompt type detection\n  let jsonProperties: Record<string, any> = {};\n  let requiredFields: Set<string> = new Set();\n  if (command.argsSchema) {\n    try {\n      const jsonSchema = getJsonSchema(command.argsSchema) as Record<string, any>;\n      if (jsonSchema.type === 'object' && jsonSchema.properties) {\n        jsonProperties = jsonSchema.properties;\n      }\n      if (Array.isArray(jsonSchema.required)) {\n        requiredFields = new Set(jsonSchema.required);\n      }\n    } catch {\n      // Ignore schema parsing errors\n    }\n  }\n\n  const fieldDescriptions: Record<string, string | undefined> = {};\n  if (meta?.fields) {\n    for (const [key, value] of Object.entries(meta.fields)) {\n      if (value?.description) fieldDescriptions[key] = value.description;\n    }\n  }\n\n  const result = { ...data };\n\n  // Determine which required interactive fields to prompt\n  let fieldsToPrompt: string[] = [];\n  if (interactiveConfig === true) {\n    if (force) {\n      // When forced, prompt all required fields regardless of current value\n      fieldsToPrompt = [...requiredFields];\n    } else {\n      // All required fields that are missing\n      fieldsToPrompt = [...requiredFields].filter((name) => result[name] === undefined);\n    }\n  } else if (Array.isArray(interactiveConfig)) {\n    if (force) {\n      fieldsToPrompt = [...interactiveConfig];\n    } else {\n      fieldsToPrompt = interactiveConfig.filter((name) => result[name] === undefined);\n    }\n  }\n\n  // Prompt each required interactive field with per-field validation\n  for (const field of fieldsToPrompt) {\n    const config = detectPromptConfig(field, jsonProperties[field], fieldDescriptions[field]);\n    // When forced, use the current value as the default\n    if (force && result[field] !== undefined) {\n      config.default = result[field];\n    }\n    result[field] = await promptWithValidation(field, config, result, command, runtime);\n  }\n\n  // Determine optional interactive fields\n  let optionalFields: string[] = [];\n  if (optionalInteractiveConfig === true) {\n    if (force) {\n      // When forced, include all non-required fields (even those with values)\n      const allKeys = Object.keys(jsonProperties);\n      optionalFields = allKeys.filter((name) => !requiredFields.has(name));\n    } else {\n      // All non-required fields that are still missing\n      const allKeys = Object.keys(jsonProperties);\n      optionalFields = allKeys.filter((name) => !requiredFields.has(name) && result[name] === undefined);\n    }\n  } else if (Array.isArray(optionalInteractiveConfig)) {\n    if (force) {\n      optionalFields = [...optionalInteractiveConfig];\n    } else {\n      optionalFields = optionalInteractiveConfig.filter((name) => result[name] === undefined);\n    }\n  }\n\n  // Show multiselect for optional fields, then prompt selected ones\n  if (optionalFields.length > 0) {\n    const selected = (await runtime.prompt({\n      name: '_optionalFields',\n      message: 'Would you also like to configure:',\n      type: 'multiselect',\n      choices: optionalFields.map((f) => {\n        const label = fieldDescriptions[f] || jsonProperties[f]?.description || f;\n        const currentValue = result[f];\n        // When forced, show current value next to the label for fields that already have values\n        const displayLabel = force && currentValue !== undefined ? `${label} (current: ${currentValue})` : label;\n        return { label: displayLabel, value: f };\n      }),\n    })) as string[];\n\n    if (Array.isArray(selected)) {\n      for (const field of selected) {\n        const config = detectPromptConfig(field, jsonProperties[field], fieldDescriptions[field]);\n        // When forced, use the current value as the default\n        if (force && result[field] !== undefined) {\n          config.default = result[field];\n        }\n        result[field] = await promptWithValidation(field, config, result, command, runtime);\n      }\n    }\n  }\n\n  return result;\n}\n"],"mappings":"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"}

package/dist/feature/mcp.d.mts

@@ -0,0 +1,18 @@
+//#region src/feature/mcp.d.ts
+type PadroneMcpPreferences = {
+  /** Server name. Defaults to the program name. */name?: string; /** Server version. Defaults to the program version. */
+  version?: string;
+  /**
+   * Transport mode.
+   * - `'http'` — Start a Streamable HTTP server (default). Responds with `application/json` or `text/event-stream` based on the client's `Accept` header. Use `port` and `host` to configure.
+   * - `'stdio'` — Communicate over stdin/stdout with newline-delimited JSON.
+   */
+  transport?: 'http' | 'stdio'; /** HTTP port. Defaults to `3000`. Only used with `transport: 'http'`. */
+  port?: number; /** HTTP host. Defaults to `'127.0.0.1'`. Only used with `transport: 'http'`. */
+  host?: string; /** Base path for the MCP endpoint. Defaults to `'/mcp'`. Only used with `transport: 'http'`. */
+  basePath?: string; /** CORS allowed origin. Defaults to `'*'`. Set to a specific origin or `false` to disable CORS headers. Only used with HTTP transports. */
+  cors?: string | false;
+};
+//#endregion
+export { PadroneMcpPreferences };
+//# sourceMappingURL=mcp.d.mts.map

package/dist/feature/mcp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.mts","names":[],"sources":["../../src/feature/mcp.ts"],"mappings":";KAKY,qBAAA;mDAEV,IAAA,WAF+B;EAI/B,OAAA;EAJ+B;;;;;EAU/B,SAAA,qBAMA;EAJA,IAAA,WAMI;EAJJ,IAAA;EAEA,QAAA;EAEA,IAAA;AAAA"}

package/dist/{mcp-D6PdtjIs.mjs → feature/mcp.mjs}

@@ -1,6 +1,6 @@
-import { m as serializeArgsToFlags, r as collectEndpoints, t as buildInputSchema } from "./commands-DLR0rFgq.mjs";
-import { a as readStreamAsText } from "./stream-DC4H8YTx.mjs";
-import { t as generateHelp } from "./help-B-ZMYyn-.mjs";
+import { readStreamAsText } from "../util/stream.mjs";
+import { buildInputSchema, collectEndpoints, serializeArgsToFlags } from "../core/commands.mjs";
+import { generateHelp } from "../output/help.mjs";
 //#region src/feature/mcp.ts
 const PROTOCOL_VERSION = "2025-11-25";
 /** Convert an endpoint dot-path to a valid MCP tool name. Spec allows: [A-Za-z0-9_\-\.] */
@@ -367,11 +367,11 @@ async function startHttpTransport(handleRequest, prefs, log, onSignal) {
 async function startMcpServer(_program, existingCommand, evalCommand, prefs) {
 	const handleRequest = createMcpHandler(existingCommand, evalCommand, prefs);
 	if ((prefs?.transport ?? "http") === "stdio") return startStdioTransport(handleRequest);
-	const { getCommandRuntime } = await import("./commands-DLR0rFgq.mjs").then((n) => n.a);
+	const { getCommandRuntime } = await import("../core/commands.mjs");
 	const runtime = getCommandRuntime(existingCommand);
 	return startHttpTransport(handleRequest, prefs ?? {}, (msg) => runtime.error(msg), runtime.onSignal);
 }
 //#endregion
-export { startMcpServer };
+export { createMcpHandler, startMcpServer };
 
-//# sourceMappingURL=mcp-D6PdtjIs.mjs.map
+//# sourceMappingURL=mcp.mjs.map

package/dist/feature/mcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.mjs","names":[],"sources":["../../src/feature/mcp.ts"],"sourcesContent":["import { buildInputSchema, collectEndpoints, serializeArgsToFlags } from '../core/commands.ts';\nimport { generateHelp } from '../output/help.ts';\nimport type { AnyPadroneCommand, AnyPadroneProgram } from '../types/index.ts';\nimport { readStreamAsText } from '../util/stream.ts';\n\nexport type PadroneMcpPreferences = {\n  /** Server name. Defaults to the program name. */\n  name?: string;\n  /** Server version. Defaults to the program version. */\n  version?: string;\n  /**\n   * Transport mode.\n   * - `'http'` — Start a Streamable HTTP server (default). Responds with `application/json` or `text/event-stream` based on the client's `Accept` header. Use `port` and `host` to configure.\n   * - `'stdio'` — Communicate over stdin/stdout with newline-delimited JSON.\n   */\n  transport?: 'http' | 'stdio';\n  /** HTTP port. Defaults to `3000`. Only used with `transport: 'http'`. */\n  port?: number;\n  /** HTTP host. Defaults to `'127.0.0.1'`. Only used with `transport: 'http'`. */\n  host?: string;\n  /** Base path for the MCP endpoint. Defaults to `'/mcp'`. Only used with `transport: 'http'`. */\n  basePath?: string;\n  /** CORS allowed origin. Defaults to `'*'`. Set to a specific origin or `false` to disable CORS headers. Only used with HTTP transports. */\n  cors?: string | false;\n};\n\nconst PROTOCOL_VERSION = '2025-11-25';\n\ntype JsonRpcRequest = {\n  jsonrpc: '2.0';\n  id?: string | number;\n  method: string;\n  params?: Record<string, unknown>;\n};\n\ntype JsonRpcResponse = {\n  jsonrpc: '2.0';\n  id: string | number | null;\n  result?: unknown;\n  error?: { code: number; message: string; data?: unknown };\n};\n\n/** Convert an endpoint dot-path to a valid MCP tool name. Spec allows: [A-Za-z0-9_\\-\\.] */\nfunction toToolName(path: string): string {\n  return path.replace(/\\s+/g, '.');\n}\n\n/** Convert a tool name back to a command path (dot → space). */\nfunction toCommandPath(toolName: string): string {\n  return toolName.replace(/\\./g, ' ');\n}\n\n/** Build MCP tool annotations from a command's metadata. */\nfunction buildAnnotations(cmd: AnyPadroneCommand) {\n  if (cmd.mutation == null) return undefined;\n  return {\n    destructiveHint: cmd.mutation || undefined,\n    readOnlyHint: cmd.mutation === false || undefined,\n  };\n}\n\n/** Build an MCP tool definition from a command. */\nfunction buildToolDefinition(name: string, cmd: AnyPadroneCommand) {\n  return {\n    name: toToolName(name),\n    title: cmd.title ?? undefined,\n    description: cmd.description || cmd.title || `Run the \"${name}\" command`,\n    inputSchema: buildInputSchema(cmd),\n    annotations: buildAnnotations(cmd),\n  };\n}\n\n/** Create the MCP request handler. Returns an async function that processes a JSON-RPC request and returns a response (or undefined for notifications). */\nexport function createMcpHandler(\n  existingCommand: AnyPadroneCommand,\n  evalCommand: AnyPadroneProgram['eval'],\n  prefs?: PadroneMcpPreferences,\n) {\n  const serverName = prefs?.name ?? existingCommand.name;\n  const serverVersion = prefs?.version ?? existingCommand.version ?? '0.0.0';\n\n  const rootTools = collectEndpoints(existingCommand.commands, '');\n  if (existingCommand.action || existingCommand.argsSchema) {\n    rootTools.unshift({ name: '', command: existingCommand });\n  }\n\n  const toolMap = new Map(rootTools.map((t) => [toToolName(t.name), t]));\n\n  const helpToolName = 'help';\n  const helpToolDef = {\n    name: helpToolName,\n    title: 'Help',\n    description: `Show help for the \"${serverName}\" program or a specific command`,\n    inputSchema: {\n      type: 'object' as const,\n      properties: { command: { type: 'string', description: 'Command name to get help for (omit for program help)' } },\n      additionalProperties: false,\n    },\n  };\n\n  return async function handleRequest(req: JsonRpcRequest): Promise<JsonRpcResponse | undefined> {\n    const { id, method, params } = req;\n\n    switch (method) {\n      case 'initialize':\n        return {\n          jsonrpc: '2.0',\n          id: id ?? null,\n          result: {\n            protocolVersion: PROTOCOL_VERSION,\n            capabilities: { tools: {} },\n            serverInfo: { name: serverName, version: serverVersion },\n          },\n        };\n\n      case 'notifications/initialized':\n      case 'notifications/cancelled':\n        return undefined;\n\n      case 'ping':\n        return { jsonrpc: '2.0', id: id ?? null, result: {} };\n\n      case 'tools/list': {\n        const tools = [...rootTools.map((t) => buildToolDefinition(t.name, t.command)), helpToolDef];\n        return { jsonrpc: '2.0', id: id ?? null, result: { tools } };\n      }\n\n      case 'tools/call': {\n        const toolName = params?.name as string;\n        const args = (params?.arguments ?? {}) as Record<string, unknown>;\n\n        // Built-in help tool\n        if (toolName === helpToolName) {\n          const cmdName = args.command as string | undefined;\n          const targetCmd = cmdName ? rootTools.find((t) => t.name === cmdName || toToolName(t.name) === cmdName)?.command : undefined;\n          const helpText = generateHelp(existingCommand, targetCmd ?? existingCommand, { format: 'text', detail: 'full' });\n          return {\n            jsonrpc: '2.0',\n            id: id ?? null,\n            result: { content: [{ type: 'text', text: helpText }], isError: false },\n          };\n        }\n\n        const tool = toolMap.get(toolName);\n        if (!tool) {\n          return {\n            jsonrpc: '2.0',\n            id: id ?? null,\n            error: { code: -32602, message: `Unknown tool: ${toolName}` },\n          };\n        }\n\n        // Build command string: convert tool name back to command path + serialize args as flags\n        const commandPath = toCommandPath(tool.name);\n        const argParts = serializeArgsToFlags(args);\n        const input = [commandPath, ...argParts].filter(Boolean).join(' ') || undefined;\n\n        try {\n          const output: string[] = [];\n          const errors: string[] = [];\n          const result = await evalCommand(input as any, {\n            caller: 'mcp',\n            runtime: {\n              output: (...outArgs: unknown[]) => output.push(outArgs.map(String).join(' ')),\n              error: (text: string) => errors.push(text),\n              interactive: 'unsupported',\n              format: 'text',\n            },\n          });\n\n          const content: { type: string; text: string }[] = [];\n\n          if (result.error) {\n            const errorMsg = result.error instanceof Error ? result.error.message : String(result.error);\n            if (errors.length) content.push({ type: 'text', text: errors.join('\\n') });\n            content.push({ type: 'text', text: errorMsg });\n            return { jsonrpc: '2.0', id: id ?? null, result: { content, isError: true } };\n          }\n\n          if (result.argsResult?.issues) {\n            const issueMessages = result.argsResult.issues.map((i: any) => `${i.path?.join('.') || 'root'}: ${i.message}`).join('\\n');\n            content.push({ type: 'text', text: `Validation error:\\n${issueMessages}` });\n            return { jsonrpc: '2.0', id: id ?? null, result: { content, isError: true } };\n          }\n\n          if (output.length) content.push({ type: 'text', text: output.join('\\n') });\n          if (result.result !== undefined && result.result !== null) {\n            const resultText = typeof result.result === 'string' ? result.result : JSON.stringify(result.result, null, 2);\n            content.push({ type: 'text', text: resultText });\n          }\n          if (content.length === 0) content.push({ type: 'text', text: 'Done.' });\n          return { jsonrpc: '2.0', id: id ?? null, result: { content, isError: false } };\n        } catch (err) {\n          const errorMsg = err instanceof Error ? err.message : String(err);\n          return {\n            jsonrpc: '2.0',\n            id: id ?? null,\n            result: { content: [{ type: 'text', text: errorMsg }], isError: true },\n          };\n        }\n      }\n\n      default: {\n        if (id !== undefined) {\n          return { jsonrpc: '2.0', id, error: { code: -32601, message: `Method not found: ${method}` } };\n        }\n        return undefined;\n      }\n    }\n  };\n}\n\n/** stdio transport: newline-delimited JSON per 2025-11-25 spec. */\nasync function startStdioTransport(handleRequest: (req: JsonRpcRequest) => Promise<JsonRpcResponse | undefined>): Promise<void> {\n  const { stdin, stdout } = await import('node:process');\n  const { createInterface } = await import('node:readline');\n\n  function send(msg: JsonRpcResponse) {\n    stdout.write(`${JSON.stringify(msg)}\\n`);\n  }\n\n  const rl = createInterface({ input: stdin, crlfDelay: Infinity });\n\n  for await (const line of rl) {\n    if (!line.trim()) continue;\n    try {\n      const req = JSON.parse(line) as JsonRpcRequest;\n      const res = await handleRequest(req);\n      if (res) send(res);\n    } catch {\n      // Ignore malformed JSON\n    }\n  }\n}\n\n/** Streamable HTTP transport per 2025-11-25 spec. Responds with JSON or SSE based on client's Accept header. */\nasync function startHttpTransport(\n  handleRequest: (req: JsonRpcRequest) => Promise<JsonRpcResponse | undefined>,\n  prefs: PadroneMcpPreferences,\n  log: (msg: string) => void,\n  onSignal?: (callback: () => void) => () => void,\n): Promise<void> {\n  const http = await import('node:http');\n  const crypto = await import('node:crypto');\n\n  const port = prefs.port ?? 3000;\n  const host = prefs.host ?? '127.0.0.1';\n  const endpoint = prefs.basePath ?? '/mcp';\n\n  // Session management\n  let sessionId: string | undefined;\n  let negotiatedVersion: string | undefined;\n\n  const corsOrigin = prefs.cors !== false ? (prefs.cors ?? '*') : undefined;\n\n  const server = http.createServer(async (req, res) => {\n    // CORS headers\n    if (corsOrigin) {\n      res.setHeader('Access-Control-Allow-Origin', corsOrigin);\n      res.setHeader('Access-Control-Allow-Methods', 'POST, GET, DELETE, OPTIONS');\n      res.setHeader('Access-Control-Allow-Headers', 'Content-Type, MCP-Session-Id, MCP-Protocol-Version');\n      res.setHeader('Access-Control-Expose-Headers', 'MCP-Session-Id');\n    }\n\n    if (req.method === 'OPTIONS') {\n      res.writeHead(corsOrigin ? 204 : 405);\n      res.end();\n      return;\n    }\n\n    if (req.url !== endpoint) {\n      res.writeHead(404, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ error: 'Not found' }));\n      return;\n    }\n\n    // DELETE: terminate session\n    if (req.method === 'DELETE') {\n      const reqSessionId = req.headers['mcp-session-id'] as string | undefined;\n      if (sessionId && reqSessionId === sessionId) {\n        sessionId = undefined;\n        negotiatedVersion = undefined;\n        res.writeHead(200);\n        res.end();\n      } else {\n        res.writeHead(404);\n        res.end();\n      }\n      return;\n    }\n\n    // GET: SSE stream (not implemented — return 405)\n    if (req.method === 'GET') {\n      res.writeHead(405, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32601, message: 'SSE stream not supported' } }));\n      return;\n    }\n\n    if (req.method !== 'POST') {\n      res.writeHead(405);\n      res.end();\n      return;\n    }\n\n    // Validate session ID on non-initialize requests\n    const reqSessionId = req.headers['mcp-session-id'] as string | undefined;\n    if (sessionId && reqSessionId && reqSessionId !== sessionId) {\n      res.writeHead(404, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32600, message: 'Invalid session' } }));\n      return;\n    }\n\n    // Validate MCP-Protocol-Version header on post-init requests\n    const reqProtocolVersion = req.headers['mcp-protocol-version'] as string | undefined;\n    if (negotiatedVersion && reqProtocolVersion && reqProtocolVersion !== negotiatedVersion) {\n      res.writeHead(400, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32600, message: 'Protocol version mismatch' } }));\n      return;\n    }\n\n    // Read request body\n    const body = await readStreamAsText(req as AsyncIterable<Uint8Array>);\n\n    let rpcRequest: JsonRpcRequest;\n    try {\n      rpcRequest = JSON.parse(body);\n    } catch {\n      res.writeHead(400, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } }));\n      return;\n    }\n\n    const response = await handleRequest(rpcRequest);\n\n    // On initialize response: create session and set header\n    if (rpcRequest.method === 'initialize' && response?.result) {\n      sessionId = crypto.randomUUID();\n      negotiatedVersion = PROTOCOL_VERSION;\n      res.setHeader('MCP-Session-Id', sessionId);\n    }\n\n    if (response) {\n      const accept = req.headers.accept ?? '';\n      if (accept.includes('text/event-stream')) {\n        res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', Connection: 'keep-alive' });\n        res.write(`event: message\\ndata: ${JSON.stringify(response)}\\n\\n`);\n        res.end();\n      } else {\n        res.writeHead(200, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify(response));\n      }\n    } else {\n      // Notification or response from client — no body\n      res.writeHead(202);\n      res.end();\n    }\n  });\n\n  return new Promise<void>((resolve, reject) => {\n    server.listen(port, host, () => {\n      log(`MCP server listening on http://${host}:${port}${endpoint}`);\n    });\n    server.on('error', reject);\n    const unsubscribe = onSignal?.(() => {\n      server.close(() => resolve());\n    });\n    server.on('close', () => unsubscribe?.());\n  });\n}\n\nexport async function startMcpServer(\n  _program: AnyPadroneProgram,\n  existingCommand: AnyPadroneCommand,\n  evalCommand: AnyPadroneProgram['eval'],\n  prefs?: PadroneMcpPreferences,\n): Promise<void> {\n  const handleRequest = createMcpHandler(existingCommand, evalCommand, prefs);\n  const transport = prefs?.transport ?? 'http';\n\n  if (transport === 'stdio') {\n    return startStdioTransport(handleRequest);\n  }\n\n  const { getCommandRuntime } = await import('../core/commands.ts');\n  const runtime = getCommandRuntime(existingCommand);\n  return startHttpTransport(handleRequest, prefs ?? {}, (msg) => runtime.error(msg), runtime.onSignal);\n}\n"],"mappings":"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"}

package/dist/feature/repl-loop.mjs

@@ -0,0 +1,217 @@
+import { REPL_SIGINT } from "../core/runtime.mjs";
+import { createTerminalReplSession } from "../core/default-runtime.mjs";
+import { buildReplCompleter, findCommandByName, getCommandRuntime } from "../core/commands.mjs";
+import { getVersion } from "../util/utils.mjs";
+//#region src/feature/repl-loop.ts
+/**
+* Creates a REPL async iterable for running commands interactively.
+*/
+function createReplIterator(deps, options) {
+	const { existingCommand, evalCommand, replActiveRef } = deps;
+	if (replActiveRef.value) {
+		getCommandRuntime(existingCommand).error("REPL is already running. Nested REPL sessions are not supported.");
+		return (async function* () {})();
+	}
+	const runtime = getCommandRuntime(existingCommand);
+	const programName = existingCommand.name || "padrone";
+	const env = runtime.env();
+	const useAnsi = runtime.format === "ansi" || runtime.format === "auto" && !env.NO_COLOR && !env.CI && runtime.terminal?.isTTY === true;
+	const commandHistory = [];
+	const resolveScope = (scope) => {
+		const parts = scope.split(/\s+/);
+		const stack = [];
+		let current = existingCommand;
+		for (const part of parts) {
+			const found = findCommandByName(part, current.commands);
+			if (!found) break;
+			stack.push(found);
+			current = found;
+		}
+		return stack;
+	};
+	async function* replIterator() {
+		replActiveRef.value = true;
+		const showGreeting = options?.greeting !== false;
+		const showHint = options?.hint !== false;
+		if (showGreeting || showHint) runtime.output("");
+		if (showGreeting) if (options?.greeting) runtime.output(options.greeting);
+		else {
+			const displayName = existingCommand.title || programName;
+			const version = existingCommand.version ? await getVersion(existingCommand.version) : void 0;
+			const greeting = version ? `Welcome to ${displayName} v${version}` : `Welcome to ${displayName}`;
+			runtime.output(greeting);
+		}
+		if (showHint) {
+			const hintText = (typeof options?.hint === "string" ? options.hint : void 0) ?? "Type \".help\" for more information, \".exit\" to quit.";
+			runtime.output(useAnsi ? `\x1b[2m${hintText}\x1b[0m` : hintText);
+		}
+		if (showGreeting || showHint) runtime.output("");
+		const scopeStack = options?.scope ? resolveScope(options.scope) : [];
+		const getScopeCommand = () => scopeStack.length ? scopeStack[scopeStack.length - 1] : existingCommand;
+		const getScopePath = () => scopeStack.map((c) => c.name).join(" ");
+		const buildPrompt = () => {
+			if (options?.prompt) return typeof options.prompt === "function" ? options.prompt() : options.prompt;
+			const scopePath = getScopePath();
+			const label = scopePath ? `${programName}/${scopePath.replace(/ /g, "/")}` : programName;
+			return useAnsi ? `\x1b[1m${label}\x1b[0m ❯ ` : `${label} ❯ `;
+		};
+		const buildScopedCompleter = () => {
+			return buildReplCompleter(getScopeCommand(), { inScope: scopeStack.length > 0 });
+		};
+		const sessionConfig = { history: options?.history };
+		if (options?.completion !== false) sessionConfig.completer = buildScopedCompleter();
+		const session = runtime.readLine ? void 0 : createTerminalReplSession(sessionConfig);
+		const questionFn = session ? (prompt) => session.question(prompt) : runtime.readLine;
+		const updateCompleter = () => {
+			if (options?.completion === false) return;
+			const completer = buildScopedCompleter();
+			if (session) session.completer = completer;
+			sessionConfig.completer = completer;
+		};
+		let lastSigintTime = 0;
+		try {
+			while (true) {
+				const input = await questionFn(buildPrompt());
+				if (input === null) break;
+				if (input === REPL_SIGINT) {
+					const now = Date.now();
+					if (now - lastSigintTime < 2e3) break;
+					lastSigintTime = now;
+					runtime.output("(press Ctrl+C again to exit, or Ctrl+D)");
+					continue;
+				}
+				const trimmed = input.trim();
+				if (!trimmed) continue;
+				lastSigintTime = 0;
+				commandHistory.push(trimmed);
+				if (trimmed === ".exit" || trimmed === ".quit") break;
+				if (trimmed === ".clear") {
+					runtime.output("\x1B[2J\x1B[H");
+					continue;
+				}
+				if (trimmed === ".help") {
+					const lines = [
+						"REPL Commands:",
+						"  .                 Execute the current scoped command",
+						"  .help             Print this help message",
+						"  .exit             Exit the REPL",
+						"  .clear            Clear the screen",
+						"  .history          Show command history",
+						"  .scope <cmd>      Scope into a subcommand",
+						"  .scope ..         Go up one scope level"
+					];
+					lines.push("", "Keybindings:", "  Ctrl+C       Cancel current line (press twice to exit)", "  Ctrl+D       Exit the REPL", "  Up/Down      Navigate history", "  Tab          Auto-complete", "", "Type \"help\" to see available commands.");
+					runtime.output(lines.join("\n"));
+					continue;
+				}
+				if (trimmed === ".history") {
+					const entries = commandHistory.slice(0, -1);
+					if (entries.length === 0) runtime.output("No history.");
+					else runtime.output(entries.map((entry, i) => `${i + 1}  ${entry}`).join("\n"));
+					continue;
+				}
+				if (trimmed.startsWith(".scope ") || trimmed === ".scope") {
+					const target = trimmed.slice(6).trim();
+					if (target === ".." || target === "") {
+						if (scopeStack.length > 0) {
+							scopeStack.pop();
+							updateCompleter();
+						}
+					} else {
+						const found = findCommandByName(target, getScopeCommand().commands);
+						if (found) if (found.commands?.length) {
+							scopeStack.push(found);
+							updateCompleter();
+						} else runtime.error(`"${target}" has no subcommands to scope into.`);
+						else runtime.error(`Unknown command: ${target}`);
+					}
+					continue;
+				}
+				if (trimmed === "..") {
+					if (scopeStack.length > 0) {
+						scopeStack.pop();
+						updateCompleter();
+					}
+					continue;
+				}
+				let evalInput = trimmed;
+				if (trimmed === ".") evalInput = "";
+				const prefix = options?.outputPrefix;
+				const prefixLines = prefix ? (text) => text.split("\n").map((l) => prefix + l).join("\n") : void 0;
+				const savedRuntimes = [];
+				if (prefixLines) {
+					const prefixedRuntime = {
+						...existingCommand.runtime,
+						output: (...args) => {
+							const first = args[0];
+							runtime.output(typeof first === "string" ? prefixLines(first) : first, ...args.slice(1));
+						},
+						error: (text) => runtime.error(prefixLines(text))
+					};
+					const patchAll = (cmd) => {
+						savedRuntimes.push({
+							cmd,
+							runtime: cmd.runtime
+						});
+						cmd.runtime = prefixedRuntime;
+						cmd.commands?.forEach(patchAll);
+					};
+					patchAll(existingCommand);
+				}
+				const sp = options?.spacing;
+				const isSpacingObject = typeof sp === "object" && sp !== null && !Array.isArray(sp);
+				const spacingBefore = isSpacingObject ? sp.before : sp;
+				const spacingAfter = isSpacingObject ? sp.after : sp;
+				const emitSpacingLine = (value) => {
+					if (typeof value === "string") {
+						const sep = value.length === 1 ? value.repeat(runtime.terminal?.columns ?? 80) : value;
+						runtime.output(sep);
+					} else if (value) runtime.output("");
+				};
+				const emitSpacing = (value) => {
+					if (!value) return;
+					if (Array.isArray(value)) for (const line of value) emitSpacingLine(line);
+					else emitSpacingLine(value);
+				};
+				emitSpacing(spacingBefore);
+				const scopePath = getScopePath();
+				const scopedInput = scopePath ? evalInput ? `${scopePath} ${evalInput}` : scopePath : evalInput;
+				try {
+					const result = await evalCommand(scopedInput, { caller: "repl" });
+					if (result.error) {
+						const msg = result.error instanceof Error ? result.error.message : String(result.error);
+						runtime.error(prefixLines ? prefixLines(msg) : msg);
+					} else if (result.argsResult?.issues) {
+						const msg = `Validation error:\n${result.argsResult.issues.map((i) => `  - ${i.path?.join(".") || "root"}: ${i.message}`).join("\n")}`;
+						runtime.error(prefixLines ? prefixLines(msg) : msg);
+					}
+					yield result;
+				} catch (err) {
+					const msg = err instanceof Error ? err.message : String(err);
+					runtime.error(prefixLines ? prefixLines(msg) : msg);
+				} finally {
+					for (const { cmd, runtime: saved } of savedRuntimes) cmd.runtime = saved;
+					emitSpacing(spacingAfter);
+				}
+			}
+		} finally {
+			replActiveRef.value = false;
+			session?.close();
+		}
+	}
+	const iterable = replIterator();
+	iterable.drain = async () => {
+		try {
+			const results = [];
+			for await (const result of iterable) results.push(result);
+			return { value: results };
+		} catch (err) {
+			return { error: err };
+		}
+	};
+	return iterable;
+}
+//#endregion
+export { createReplIterator };
+
+//# sourceMappingURL=repl-loop.mjs.map