padrone 1.8.2 → 2.0.0

package/dist/test.d.mts

@@ -1,109 +1,2 @@
-import { bt as PadroneRuntime, p as AnyPadroneCommand } from "./index-D-Dpz7l_.mjs";
-
-//#region src/feature/test.d.ts
-/**
- * Result from a single command execution in test mode.
- * Extends the standard PadroneCommandResult with captured I/O.
- */
-type TestCliResult = {
-  /** The matched command. */command: AnyPadroneCommand; /** Validated arguments (undefined if validation failed). */
-  args: unknown; /** Action handler return value (undefined if validation failed or no action). */
-  result: unknown; /** Validation issues, if any. */
-  issues: {
-    message: string;
-    path?: PropertyKey[];
-  }[] | undefined; /** All values passed to `runtime.output()`. */
-  stdout: unknown[]; /** All strings passed to `runtime.error()`. */
-  stderr: string[]; /** The thrown error, if the command threw (routing error, action error, etc.). */
-  error?: unknown;
-};
-/**
- * Result from a REPL test session.
- */
-type TestReplResult = {
-  /** One entry per successfully executed command (validation errors are captured in stderr, not here). */results: Omit<TestCliResult, 'stdout' | 'stderr'>[]; /** All output from the entire REPL session. */
-  stdout: unknown[]; /** All errors from the entire REPL session. */
-  stderr: string[];
-};
-/**
- * Fluent builder for setting up CLI test scenarios.
- */
-type TestCliBuilder = {
-  /** Set the CLI input string (e.g. `'deploy --env production'`). */args(input: string): TestCliBuilder; /** Set environment variables visible to the command. */
-  env(vars: Record<string, string | undefined>): TestCliBuilder; /** Provide mock answers for interactive prompts. Keys are field names. */
-  prompt(answers: Record<string, unknown>): TestCliBuilder; /** Provide mock stdin data (simulates piped input). */
-  stdin(data: string): TestCliBuilder;
-  /**
-   * Execute a single command via `eval()` and return the result with captured I/O.
-   * @param input - Optional CLI input string. Overrides `.args()` if provided.
-   */
-  run(input?: string): Promise<TestCliResult>;
-  /**
-   * Run a REPL session with the given sequence of inputs.
-   * Each string in the array is fed as one line of input.
-   * The session ends after all inputs are consumed (EOF).
-   */
-  repl(inputs: string[]): Promise<TestReplResult>;
-};
-/**
- * Creates a fluent test builder for a Padrone program.
- * Captures all I/O and provides a clean interface for assertions.
- *
- * Works with any test framework (bun:test, vitest, jest, node:test, etc.).
- *
- * @example
- * ```ts
- * import { testCli } from 'padrone/test'
- *
- * const result = await testCli(myProgram)
- *   .args('deploy --env production')
- *   .env({ API_KEY: 'xxx' })
- *   .run()
- *
- * expect(result.result).toBe('Deployed')
- * expect(result.stdout).toContain('Deploying...')
- * ```
- *
- * @example
- * ```ts
- * // Shorthand: pass input directly to run()
- * const result = await testCli(myProgram).run('deploy --env production')
- * ```
- *
- * @example
- * ```ts
- * // Test interactive prompts
- * const result = await testCli(myProgram)
- *   .args('init')
- *   .prompt({ name: 'myapp', template: 'react' })
- *   .run()
- *
- * expect(result.args).toEqual({ name: 'myapp', template: 'react' })
- * ```
- *
- * @example
- * ```ts
- * // Test REPL sessions
- * const { results } = await testCli(myProgram)
- *   .repl(['greet World', 'add --a=2 --b=3'])
- *
- * expect(results[0].result).toBe('Hello, World!')
- * expect(results[1].result).toBe(5)
- * ```
- */
-/**
- * Any program-like object that has `eval`, `runtime`, and `repl` methods.
- * Avoids strict variance issues with `AnyPadroneProgram`.
- */
-type TestableProgram = {
-  eval: (input: string, prefs?: Record<string, unknown>) => any;
-  runtime: (runtime: PadroneRuntime) => TestableProgram;
-  repl: (options?: {
-    greeting?: false;
-    hint?: false;
-  }) => AsyncIterable<any>;
-};
-declare function testCli(program: TestableProgram): TestCliBuilder;
-//#endregion
-export { type TestCliBuilder, type TestCliResult, type TestReplResult, testCli };
-//# sourceMappingURL=test.d.mts.map
+import { TestCliBuilder, TestCliResult, TestReplResult, testCli } from "./feature/test.mjs";
+export { type TestCliBuilder, type TestCliResult, type TestReplResult, testCli };

package/dist/test.mjs

@@ -1,116 +1,2 @@
-//#region src/feature/test.ts
-function testCli(program) {
-	let input;
-	let envVars;
-	let promptAnswers;
-	let stdinData;
-	const builder = {
-		args(args) {
-			input = args;
-			return builder;
-		},
-		env(vars) {
-			envVars = vars;
-			return builder;
-		},
-		prompt(answers) {
-			promptAnswers = answers;
-			return builder;
-		},
-		stdin(data) {
-			stdinData = data;
-			return builder;
-		},
-		async run(runInput) {
-			const stdout = [];
-			const stderr = [];
-			const runtime = buildRuntime(stdout, stderr, {
-				envVars,
-				promptAnswers,
-				stdinData
-			});
-			const evalResult = await program.runtime(runtime).eval(runInput ?? input ?? "", {});
-			if (evalResult.error) stderr.push(evalResult.error instanceof Error ? evalResult.error.message : String(evalResult.error));
-			return toTestResult(evalResult, stdout, stderr);
-		},
-		async repl(inputs) {
-			const stdout = [];
-			const stderr = [];
-			const runtime = buildRuntime(stdout, stderr, {
-				envVars,
-				promptAnswers,
-				readLine: createMockReadLine(inputs)
-			});
-			const testProgram = program.runtime(runtime);
-			const results = [];
-			for await (const r of testProgram.repl({
-				greeting: false,
-				hint: false
-			})) results.push({
-				command: r.command,
-				args: r.args,
-				result: r.result,
-				issues: r.argsResult?.issues
-			});
-			return {
-				results,
-				stdout,
-				stderr
-			};
-		}
-	};
-	return builder;
-}
-function toTestResult(evalResult, stdout, stderr) {
-	return {
-		command: evalResult.command,
-		args: evalResult.args,
-		result: evalResult.result,
-		error: evalResult.error,
-		issues: evalResult.argsResult?.issues,
-		stdout,
-		stderr
-	};
-}
-function buildRuntime(stdout, stderr, opts) {
-	const runtime = {
-		output: (...args) => stdout.push(...args),
-		error: (text) => stderr.push(text)
-	};
-	if (opts.envVars) runtime.env = () => opts.envVars;
-	if (opts.promptAnswers) {
-		runtime.interactive = "supported";
-		runtime.prompt = async (config) => opts.promptAnswers[config.name];
-	}
-	if (opts.readLine) runtime.readLine = opts.readLine;
-	if (opts.stdinData !== void 0) runtime.stdin = {
-		isTTY: false,
-		async text() {
-			return opts.stdinData;
-		},
-		async *lines() {
-			const lines = opts.stdinData.split("\n");
-			if (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-			for (const line of lines) yield line;
-		}
-	};
-	else runtime.stdin = {
-		isTTY: true,
-		async text() {
-			return "";
-		},
-		async *lines() {}
-	};
-	return runtime;
-}
-function createMockReadLine(inputs) {
-	let index = 0;
-	return async (_prompt) => {
-		if (index >= inputs.length) return null;
-		return inputs[index++] ?? null;
-	};
-}
-//#endregion
+import { testCli } from "./feature/test.mjs";
 export { testCli };
-
-//# sourceMappingURL=test.mjs.map

package/dist/tracing.d.mts

@@ -0,0 +1,2 @@
+import { OtelSpan, OtelTracer, OtelTracerProvider, PadroneTracer, PadroneTracingConfig, WithTracing, padroneTracing } from "./extension/tracing.mjs";
+export { type OtelSpan, type OtelTracer, type OtelTracerProvider, type PadroneTracer, type PadroneTracingConfig, type WithTracing, padroneTracing };

package/dist/tracing.mjs

@@ -0,0 +1,2 @@
+import { padroneTracing } from "./extension/tracing.mjs";
+export { padroneTracing };

package/dist/types/args-meta.d.mts

@@ -0,0 +1,129 @@
+//#region src/types/args-meta.d.ts
+type Letter = 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z';
+/** A single letter character, valid as a short CLI flag (e.g. `'v'`, `'n'`, `'V'`). */
+type SingleChar = Letter | Uppercase<Letter>;
+interface PadroneFieldMeta {
+  description?: string;
+  /** Single-character short flags (stackable: `-abc` = `-a -b -c`). Used with single dash. */
+  flags?: readonly SingleChar[] | SingleChar;
+  /** Multi-character alternative long names. Used with double dash (e.g. `--dry-run` for `--dryRun`). */
+  alias?: readonly string[] | string;
+  /**
+   * Custom negative keyword(s) for boolean options. When provided, `--<keyword>` sets this option to `false`.
+   * Disables the default `--no-<option>` negation prefix. Set to `''` or `[]` to only disable the prefix.
+   * @example
+   * ```ts
+   * local: z.boolean().default(true).meta({ negative: 'remote' })
+   * // --remote sets local to false, --no-local is disabled
+   * ```
+   */
+  negative?: readonly string[] | string;
+  deprecated?: boolean | string;
+  hidden?: boolean;
+  examples?: readonly unknown[];
+  /** Group name for organizing this option under a labeled section in help output. */
+  group?: string;
+}
+type PositionalArgs<TObj> = TObj extends Record<string, any> ? { [K in keyof TObj]: NonNullable<TObj[K]> extends Array<any> ? `...${K & string}` | (K & string) : K & string }[keyof TObj] : string;
+/**
+ * Meta configuration for arguments, including positional arguments.
+ * The `positional` array defines which arguments are positional and their order.
+ * Use '...name' prefix to indicate variadic (rest) arguments, matching JS/TS rest syntax.
+ *
+ * @example
+ * ```ts
+ * .arguments(schema, {
+ *   positional: ['source', '...files', 'dest'],  // '...files' is variadic
+ * })
+ * ```
+ */
+/**
+ * Configuration for reading from stdin and mapping it to an argument field.
+ * Simply specify the field name — the read mode is inferred from the schema:
+ * - `string` field → reads all stdin as text
+ * - `string[]` field → reads stdin line-by-line
+ */
+type StdinConfig<TObj = Record<string, any>> = keyof TObj & string;
+interface PadroneArgsSchemaMeta<TObj = Record<string, any>> {
+  /**
+   * Array of argument names that should be treated as positional arguments.
+   * Order in array determines position. Use '...name' prefix for variadic args.
+   * @example ['source', '...files', 'dest'] - 'files' captures multiple values
+   */
+  positional?: readonly PositionalArgs<TObj>[];
+  /**
+   * Per-argument metadata.
+   */
+  fields?: { [K in keyof TObj]?: PadroneFieldMeta };
+  /**
+   * Automatically generate kebab-case aliases for camelCase option names.
+   * For example, `dryRun` automatically gets `--dry-run` as an alias.
+   * Defaults to `true`. Set to `false` to disable.
+   *
+   * @default true
+   * @example
+   * ```ts
+   * // Auto-aliases enabled (default): --dry-run → dryRun
+   * .arguments(z.object({ dryRun: z.boolean() }))
+   *
+   * // Disable auto-aliases
+   * .arguments(z.object({ dryRun: z.boolean() }), { autoAlias: false })
+   * ```
+   */
+  autoAlias?: boolean;
+  /**
+   * Read from stdin and inject the data into the specified argument field.
+   * Only reads when stdin is piped (not a TTY) and the field wasn't already provided via CLI flags.
+   *
+   * The read mode is inferred from the schema type of the target field:
+   * - `string` field → reads all stdin as a single string
+   * - `string[]` field → reads stdin line-by-line into an array
+   *
+   * Precedence: CLI flags > stdin > env vars > config file > schema defaults.
+   *
+   * @example
+   * ```ts
+   * // Read all stdin as text into 'data' field
+   * .arguments(z.object({ data: z.string() }), { stdin: 'data' })
+   *
+   * // Read stdin lines into 'lines' field (inferred from array schema)
+   * .arguments(z.object({ lines: z.string().array() }), { stdin: 'lines' })
+   * ```
+   */
+  stdin?: StdinConfig<TObj>;
+  /**
+   * Fields to interactively prompt for when their values are missing after CLI/env/config resolution.
+   * - `true`: prompt for all required fields that are missing.
+   * - `string[]`: prompt for these specific fields if missing.
+   *
+   * Interactive prompting only occurs in `cli()` when the runtime has `interactive: true`.
+   * Setting this makes `parse()` and `cli()` return Promises.
+   *
+   * @example
+   * ```ts
+   * .arguments(schema, {
+   *   interactive: true,                        // prompt all missing required fields
+   *   interactive: ['name', 'template'],         // prompt only these fields
+   * })
+   * ```
+   */
+  interactive?: true | readonly (keyof TObj & string)[];
+  /**
+   * Optional fields offered after required interactive prompts.
+   * Users are shown a multi-select to choose which of these fields to configure.
+   * - `true`: offer all optional fields that are missing.
+   * - `string[]`: offer these specific fields.
+   *
+   * @example
+   * ```ts
+   * .arguments(schema, {
+   *   interactive: ['name'],
+   *   optionalInteractive: ['typescript', 'eslint', 'prettier'],
+   * })
+   * ```
+   */
+  optionalInteractive?: true | readonly (keyof TObj & string)[];
+}
+//#endregion
+export { PadroneArgsSchemaMeta, PadroneFieldMeta, SingleChar, StdinConfig };
+//# sourceMappingURL=args-meta.d.mts.map

package/dist/types/args-meta.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args-meta.d.mts","names":[],"sources":["../../src/types/args-meta.ts"],"mappings":";KAAK,MAAA;;KA6BO,UAAA,GAAa,MAAA,GAAS,SAAA,CAAU,MAAA;AAAA,UAE3B,gBAAA;EACf,WAAA;EAhCS;EAkCT,KAAA,YAAiB,UAAA,KAAe,UAAU;EALtB;EAOpB,KAAA;EAPuB;;;;;;;;;EAiBvB,QAAA;EACA,UAAA;EACA,MAAA;EACA,QAAA;EAf0C;EAiB1C,KAAA;AAAA;AAAA,KAGG,cAAA,SACH,IAAA,SAAa,MAAA,8BAEK,IAAA,GAAO,WAAA,CAAY,IAAA,CAAK,CAAA,WAAY,KAAA,cAAmB,CAAA,eAAgB,CAAA,aAAc,CAAA,kBAC3F,IAAA;;;;;;;AAPP;AACN;;;;;;;;;;;KA2BW,WAAA,QAAmB,MAAA,uBAA6B,IAAI;AAAA,UAE/C,qBAAA,QAA6B,MAAA;EAvBhC;;;;;EA6BZ,UAAA,YAAsB,cAAA,CAAe,IAAA;EA9B9B;;;EAkCP,MAAA,iBAAuB,IAAA,IAAQ,gBAAA;EAlC0C;;;;;AACzD;AAqBlB;;;;;;;;AAAgE;EA4B9D,SAAA;EA1BoC;;;;;;;;;;;;;;;;;;;EA8CpC,KAAA,GAAQ,WAAA,CAAY,IAAA;EApCG;;;;;;;;;;;AAoE0B;;;;;EAfjD,WAAA,0BAAqC,IAAA;;;;;;;;;;;;;;;EAerC,mBAAA,0BAA6C,IAAA;AAAA"}

package/dist/types/builder.d.mts

@@ -0,0 +1,212 @@
+import { PadroneProgress, PadroneRuntime } from "../core/runtime.mjs";
+import { PadroneSchema } from "./schema.mjs";
+import { FindDirectChild, FlattenCommands, FullCommandName, MaybePromise, OrAsync, OrAsyncMeta, PickCommandByName, PickCommandByPossibleCommands, PossibleCommands, RepathCommands, ReplaceOrAppendCommand, SafeString } from "../util/type-utils.mjs";
+import { PadroneLogger } from "../extension/logger.mjs";
+import { PadroneTracer } from "../extension/tracing.mjs";
+import { PadroneMcpPreferences } from "../feature/mcp.mjs";
+import { PadroneServePreferences } from "../feature/serve.mjs";
+import { WrapConfig, WrapResult } from "../feature/wrap.mjs";
+import { HelpPreferences } from "../output/help.mjs";
+import { ExtractInterceptorContext, InterceptorFactory, InterceptorMeta, InterceptorRequiresCheck, InterceptorRequiresError, PadroneContextInterceptor, PadroneInterceptorFn } from "./interceptor.mjs";
+import { AnyPadroneCommand, CommandTypesBase, GetArgsMeta, PadroneActionContext, PadroneCommand, PadroneCommandConfig, PadroneProgramMeta } from "./command.mjs";
+import { PadroneCliPreferences, PadroneEvalPreferences, PadroneReplPreferences } from "./preferences.mjs";
+import { GetArguments, MaybePromiseCommandResult, PadroneAPI, PadroneCommandResult, PadroneDrainResult, PadroneParseResult } from "./result.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+import { Tool } from "ai";
+
+//#region src/types/builder.d.ts
+/**
+ * Helper type to set aliases on a command type.
+ * Uses intersection to override just the aliases while preserving all other type information.
+ */
+type WithAliases<TCommand extends AnyPadroneCommand, TAliases extends string[]> = Omit<TCommand, 'aliases' | '~types'> & {
+  aliases?: TAliases;
+  '~types': Omit<TCommand['~types'], 'aliases'> & {
+    aliases: TAliases;
+  };
+};
+/**
+ * Resolves aliases for a command override: if new aliases are provided (non-empty), use them;
+ * otherwise, preserve the existing command's aliases.
+ */
+type ResolvedAliases<TCommands extends [...AnyPadroneCommand[]], TNameNested extends string, TAliases extends string[]> = TAliases extends [] ? FindDirectChild<TCommands, TNameNested> extends infer E extends AnyPadroneCommand ? E['~types']['aliases'] : [] : TAliases;
+/**
+ * When TContext is `unknown` (no `.context()` called), context param is optional.
+ * Otherwise it is required.
+ */
+type ContextParam<TContext> = unknown extends TContext ? {
+  context?: TContext;
+} : {
+  context: TContext;
+};
+/** Options for the `mount()` method. */
+type MountOptions<TContext, TNewContext> = {
+  context: (ctx: TContext) => TNewContext;
+};
+/**
+ * Resolves the initial builder type for a `.command()` call.
+ * If TNameNested already exists in TCommands, the builder starts pre-populated with that command's types.
+ * Otherwise, a fresh builder with default types is used.
+ */
+type InitialCommandBuilder<TProgramName extends string, TNameNested extends string, TParentPath extends string, TParentArgs extends PadroneSchema, TCommands extends [...AnyPadroneCommand[]], TParentContext> = [FindDirectChild<TCommands, TNameNested>] extends [never] ? PadroneBuilder<TProgramName, TNameNested, TParentPath, PadroneSchema<void>, void, [], TParentArgs, false, TParentContext> : FindDirectChild<TCommands, TNameNested> extends infer E extends AnyPadroneCommand ? PadroneBuilder<TProgramName, TNameNested, TParentPath, E['~types']['argsSchema'], E['~types']['result'], E['~types']['commands'], TParentArgs, E['~types']['async'], E['~types']['context'], E['~types']['contextProvided']> : PadroneBuilder<TProgramName, TNameNested, TParentPath, PadroneSchema<void>, void, [], TParentArgs, false, TParentContext>;
+type AnyPadroneBuilder = InitialCommandBuilder<string, string, string, PadroneSchema, [...AnyPadroneCommand[]], unknown>;
+/**
+ * Like InitialCommandBuilder but uses `any` for args in the fresh case.
+ * Used as the default for TBuilder when no builderFn is provided.
+ */
+type DefaultCommandBuilder<TProgramName extends string, TNameNested extends string, TParentPath extends string, TParentArgs extends PadroneSchema, TCommands extends [...AnyPadroneCommand[]], TParentContext> = [FindDirectChild<TCommands, TNameNested>] extends [never] ? PadroneBuilder<TProgramName, TNameNested, TParentPath, any, void, [], TParentArgs, false, TParentContext> : FindDirectChild<TCommands, TNameNested> extends infer E extends AnyPadroneCommand ? PadroneBuilder<TProgramName, TNameNested, TParentPath, E['~types']['argsSchema'], E['~types']['result'], E['~types']['commands'], TParentArgs, E['~types']['async'], E['~types']['context'], E['~types']['contextProvided']> : PadroneBuilder<TProgramName, TNameNested, TParentPath, any, void, [], TParentArgs, false, TParentContext>;
+/**
+ * Conditional type that returns either PadroneBuilder or PadroneProgram based on TReturn.
+ * Used to avoid repetition in PadroneBuilderMethods return types.
+ */
+type BuilderOrProgram<TReturn extends 'builder' | 'program', TProgramName extends string, TName extends string, TParentName extends string, TArgs extends PadroneSchema, TRes, TCommands extends [...AnyPadroneCommand[]], TParentArgs extends PadroneSchema, TAsync extends boolean, TContext, TContextProvided = unknown> = TReturn extends 'builder' ? PadroneBuilder<TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided> : PadroneProgram<TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided>;
+/**
+ * Base builder methods shared between PadroneBuilder and PadroneProgram.
+ * These methods are used for defining command structure (arguments, action, subcommands).
+ */
+type PadroneBuilderMethods<TProgramName extends string, TName extends string, TParentName extends string, TArgs extends PadroneSchema, TRes, TCommands extends [...AnyPadroneCommand[]], TParentArgs extends PadroneSchema, TAsync extends boolean, TContext, TContextProvided, /** The return type for builder methods - either PadroneBuilder or PadroneProgram */TReturn extends 'builder' | 'program'> = {
+  /** Apply a build-time extension that transforms this builder/program. @category Builder */extend: <TResult extends CommandTypesBase>(extension: PadroneExtension<BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided>, TResult>) => TResult; /** Register a runtime interceptor for lifecycle phases (parse, validate, execute, etc.). @category Builder */
+  intercept: {
+    /** Context-providing interceptor — extends context type. Rejects if required context is not satisfied. */<TInterceptor extends PadroneContextInterceptor<any, StandardSchemaV1.InferOutput<TArgs>, TRes, any>>(interceptor: TInterceptor): InterceptorRequiresCheck<TInterceptor, TContext & TContextProvided> extends true ? BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided & ExtractInterceptorContext<TInterceptor>> : InterceptorRequiresError; /** Plain interceptor — no context change. Rejects if required context is not satisfied. */
+    <TInterceptor extends PadroneInterceptorFn<StandardSchemaV1.InferOutput<TArgs>, TRes, any>>(interceptor: TInterceptor): InterceptorRequiresCheck<TInterceptor, TContext & TContextProvided> extends true ? BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided> : InterceptorRequiresError; /** Register an interceptor with static metadata and a factory function. Context is strongly typed. */
+    (meta: InterceptorMeta, factory: InterceptorFactory<StandardSchemaV1.InferOutput<TArgs>, TRes, TContext & TContextProvided>): BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided>;
+  }; /** Set command metadata like title, description, version, hidden, deprecated, etc. @category Builder */
+  configure: (config: PadroneCommandConfig) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided>; /** Override the runtime adapter (process, IO, environment). @category Builder */
+  runtime: (runtime: PadroneRuntime) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided>; /** Mark this command as async, forcing all return types to be `Promise`-wrapped. @category Builder */
+  async: () => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, true, TContext, TContextProvided>;
+  /**
+   * Declare or transform the user-defined context type for this command.
+   *
+   * - Without a callback: narrows the context type (type-only, no runtime transform).
+   * - With a callback: transforms the parent/current context into a new type. Chainable — multiple calls compose.
+   *
+   * Interceptor-provided context (`TContextProvided`) is preserved across `.context()` calls.
+   * @category Builder
+   */
+  context: {
+    <TNewContext>(): BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TNewContext, TContextProvided>;
+    <TNewContext>(transform: (ctx: TContext) => TNewContext): BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TNewContext, TContextProvided>;
+  }; /** Define the argument/option schema for this command. Accepts a Standard Schema or a function that extends the parent schema. @category Builder */
+  arguments: <TNewArgs extends PadroneSchema = PadroneSchema<void>, TMeta extends GetArgsMeta<TNewArgs> = GetArgsMeta<TNewArgs>>(schema?: TNewArgs | ((parentSchema: TParentArgs) => TNewArgs), meta?: TMeta) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TNewArgs, TRes, TCommands, TParentArgs, OrAsyncMeta<OrAsync<TAsync, TNewArgs>, TMeta>, TContext, TContextProvided>; /** Set the handler function that runs when this command is executed. @category Builder */
+  action: <TNewRes>(handler?: (args: StandardSchemaV1.InferOutput<TArgs>, ctx: PadroneActionContext<TContext & TContextProvided>, base: (args: StandardSchemaV1.InferOutput<TArgs>, ctx: PadroneActionContext<TContext & TContextProvided>) => TRes) => TNewRes) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TNewRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided>; /** Wrap an external CLI tool, delegating execution to a shell command. @category Builder */
+  wrap: <TWrapArgs extends PadroneSchema = TArgs>(config: WrapConfig<TArgs, TWrapArgs>) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, Promise<WrapResult>, TCommands, TParentArgs, TAsync, TContext, TContextProvided>; /** Add or override a subcommand. Pass a builder function to define its schema, action, and nested commands. @category Builder */
+  command: {
+    <TNameNested extends string, TAliases extends string[] = [], TBuilder extends CommandTypesBase = DefaultCommandBuilder<TProgramName, TNameNested, FullCommandName<TName, TParentName>, TArgs, TCommands, TContext & TContextProvided>>(name: TNameNested | readonly [TNameNested, ...TAliases], builderFn?: (builder: InitialCommandBuilder<TProgramName, TNameNested, FullCommandName<TName, TParentName>, TArgs, TCommands, TContext & TContextProvided>) => TBuilder): BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands extends [] ? [WithAliases<TBuilder['~types']['command'], TAliases>] : AnyPadroneCommand[] extends TCommands ? [WithAliases<TBuilder['~types']['command'], TAliases>] : ReplaceOrAppendCommand<TCommands, TNameNested, WithAliases<TBuilder['~types']['command'], ResolvedAliases<TCommands, TNameNested, TAliases>>>, TParentArgs, TAsync, TContext, TContextProvided>;
+    <TNameNested extends string, TAliases extends string[] = [], TBuilder extends CommandTypesBase = CommandTypesBase, TReq = unknown>(name: TNameNested | readonly [TNameNested, ...TAliases], builderFn: ((builder: any) => TBuilder) & {
+      '~contextRequires': (ctx: TReq) => void;
+    }): TContext & TContextProvided extends TReq ? BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands extends [] ? [WithAliases<TBuilder['~types']['command'], TAliases>] : AnyPadroneCommand[] extends TCommands ? [WithAliases<TBuilder['~types']['command'], TAliases>] : ReplaceOrAppendCommand<TCommands, TNameNested, WithAliases<TBuilder['~types']['command'], ResolvedAliases<TCommands, TNameNested, TAliases>>>, TParentArgs, TAsync, TContext, TContextProvided> : DefineCommandRequiresError;
+    <TNameNested extends string, TAliases extends string[] = [], TBuilder extends CommandTypesBase = CommandTypesBase>(name: TNameNested | readonly [TNameNested, ...TAliases], builderFn?: (builder: any) => TBuilder): BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands extends [] ? [WithAliases<TBuilder['~types']['command'], TAliases>] : AnyPadroneCommand[] extends TCommands ? [WithAliases<TBuilder['~types']['command'], TAliases>] : ReplaceOrAppendCommand<TCommands, TNameNested, WithAliases<TBuilder['~types']['command'], ResolvedAliases<TCommands, TNameNested, TAliases>>>, TParentArgs, TAsync, TContext, TContextProvided>;
+  }; /** Mount an existing program as a subcommand, optionally transforming the context. @category Builder */
+  mount: {
+    <TNameNested extends string, TAliases extends string[] = [], TProgram extends CommandTypesBase = CommandTypesBase>(name: TNameNested | readonly [TNameNested, ...TAliases], program: TProgram): BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands extends [] ? [WithAliases<PadroneCommand<TNameNested, FullCommandName<TName, TParentName>, TProgram['~types']['command']['~types']['argsSchema'], TProgram['~types']['command']['~types']['result'], RepathCommands<TProgram['~types']['command']['~types']['commands'], FullCommandName<TNameNested, FullCommandName<TName, TParentName>>>, [], TProgram['~types']['command']['~types']['async'], TContext & TContextProvided>, TAliases>] : AnyPadroneCommand[] extends TCommands ? [WithAliases<PadroneCommand<TNameNested, FullCommandName<TName, TParentName>, TProgram['~types']['command']['~types']['argsSchema'], TProgram['~types']['command']['~types']['result'], RepathCommands<TProgram['~types']['command']['~types']['commands'], FullCommandName<TNameNested, FullCommandName<TName, TParentName>>>, [], TProgram['~types']['command']['~types']['async'], TContext & TContextProvided>, TAliases>] : ReplaceOrAppendCommand<TCommands, TNameNested, WithAliases<PadroneCommand<TNameNested, FullCommandName<TName, TParentName>, TProgram['~types']['command']['~types']['argsSchema'], TProgram['~types']['command']['~types']['result'], RepathCommands<TProgram['~types']['command']['~types']['commands'], FullCommandName<TNameNested, FullCommandName<TName, TParentName>>>, [], TProgram['~types']['command']['~types']['async'], TContext & TContextProvided>, ResolvedAliases<TCommands, TNameNested, TAliases>>>, TParentArgs, TAsync, TContext, TContextProvided>;
+    <TNameNested extends string, TAliases extends string[] = [], TProgram extends CommandTypesBase = CommandTypesBase, TNewContext = unknown>(name: TNameNested | readonly [TNameNested, ...TAliases], program: TProgram, options: MountOptions<TContext & TContextProvided, TNewContext>): BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TArgs, TRes, TCommands extends [] ? [WithAliases<PadroneCommand<TNameNested, FullCommandName<TName, TParentName>, TProgram['~types']['command']['~types']['argsSchema'], TProgram['~types']['command']['~types']['result'], RepathCommands<TProgram['~types']['command']['~types']['commands'], FullCommandName<TNameNested, FullCommandName<TName, TParentName>>>, [], TProgram['~types']['command']['~types']['async'], TNewContext>, TAliases>] : AnyPadroneCommand[] extends TCommands ? [WithAliases<PadroneCommand<TNameNested, FullCommandName<TName, TParentName>, TProgram['~types']['command']['~types']['argsSchema'], TProgram['~types']['command']['~types']['result'], RepathCommands<TProgram['~types']['command']['~types']['commands'], FullCommandName<TNameNested, FullCommandName<TName, TParentName>>>, [], TProgram['~types']['command']['~types']['async'], TNewContext>, TAliases>] : ReplaceOrAppendCommand<TCommands, TNameNested, WithAliases<PadroneCommand<TNameNested, FullCommandName<TName, TParentName>, TProgram['~types']['command']['~types']['argsSchema'], TProgram['~types']['command']['~types']['result'], RepathCommands<TProgram['~types']['command']['~types']['commands'], FullCommandName<TNameNested, FullCommandName<TName, TParentName>>>, [], TProgram['~types']['command']['~types']['async'], TNewContext>, ResolvedAliases<TCommands, TNameNested, TAliases>>>, TParentArgs, TAsync, TContext, TContextProvided>;
+  }; /** @deprecated Internal use only */
+  '~types': {
+    programName: TProgramName;
+    name: TName;
+    parentName: TParentName;
+    path: FullCommandName<TName, TParentName>;
+    aliases: [];
+    argsSchema: TArgs;
+    result: TRes;
+    commands: TCommands;
+    async: TAsync;
+    context: TContext;
+    contextProvided: TContextProvided;
+    command: PadroneCommand<TName, TParentName, TArgs, TRes, TCommands, [], TAsync, TContext, TContextProvided>;
+  };
+};
+type PadroneBuilder<TProgramName extends string = '', TName extends string = string, TParentName extends string = '', TArgs extends PadroneSchema = PadroneSchema<DefaultArgs>, TRes = void, TCommands extends [...AnyPadroneCommand[]] = [], TParentArgs extends PadroneSchema = PadroneSchema<void>, TAsync extends boolean = false, TContext = unknown, TContextProvided = unknown> = PadroneBuilderMethods<TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided, 'builder'>;
+type PadroneProgram<TProgramName extends string = '', TName extends string = string, TParentName extends string = '', TArgs extends PadroneSchema = PadroneSchema<DefaultArgs>, TRes = void, TCommands extends [...AnyPadroneCommand[]] = [], TParentArgs extends PadroneSchema = PadroneSchema<void>, TAsync extends boolean = false, TContext = unknown, TContextProvided = unknown> = PadroneBuilderMethods<TProgramName, TName, TParentName, TArgs, TRes, TCommands, TParentArgs, TAsync, TContext, TContextProvided, 'program'> & {
+  /** Execute a command by name with pre-validated args (skips parsing and validation). @category Execution */run: <const TCommand extends PossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], true, true>>(name: TCommand | SafeString, args: NoInfer<GetArguments<'in', PickCommandByName<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TCommand>>>, prefs?: ContextParam<TContext>) => PadroneCommandResult<PickCommandByName<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TCommand>>; /** Parse and execute a string input through the full interceptor pipeline. @category Execution */
+  eval: <const TCommand extends PossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], true, true>>(input: TCommand | SafeString, prefs?: PadroneEvalPreferences & ContextParam<TContext>) => MaybePromiseCommandResult<PickCommandByPossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TCommand>, PickCommandByPossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TCommand>['~types']['async']>; /** Parse and execute from `process.argv` through the full interceptor pipeline. @category Execution */
+  cli: (prefs?: PadroneCliPreferences & ContextParam<TContext>) => MaybePromiseCommandResult<FlattenCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>]>, TAsync>; /** Parse and validate input without executing the action. @category Execution */
+  parse: <const TCommand extends PossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], true, false>>(input?: TCommand | SafeString) => MaybePromise<PadroneParseResult<PickCommandByPossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TCommand>>, PickCommandByPossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TCommand>['~types']['async']>; /** Serialize args back into a CLI string. @category Utility */
+  stringify: <const TCommand extends PossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], false, true>>(command?: TCommand | SafeString, args?: GetArguments<'out', PickCommandByPossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TCommand>>) => string; /** Look up a command definition by name. @category Utility */
+  find: <const TFind extends PossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], false, true>>(command: TFind | SafeString) => PickCommandByPossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], TFind> | undefined; /** Get a structured API representation of all commands. @category Utility */
+  api: () => PadroneAPI<PadroneCommand<'', '', TArgs, TRes, TCommands>>; /** Start an interactive REPL session. @category Execution */
+  repl: (options?: PadroneReplPreferences<PossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>]>>) => AsyncIterable<PadroneCommandResult<FlattenCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>]>>> & {
+    drain: () => Promise<PadroneDrainResult<PadroneCommandResult<FlattenCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>]>>[]>>;
+  }; /** Export as an AI SDK tool. @category Utility */
+  tool: () => Tool<{
+    command: string;
+  }>; /** Generate help text for a command. @category Utility */
+  help: <const TCommand extends PossibleCommands<[PadroneCommand<'', '', TArgs, TRes, TCommands>], false, true>>(command?: TCommand, prefs?: HelpPreferences) => string; /** Generate shell completion script. @category Utility */
+  completion: (shell?: 'bash' | 'zsh' | 'fish' | 'powershell') => Promise<string>; /** Start a Model Context Protocol server. @category Server */
+  mcp: (prefs?: PadroneMcpPreferences) => Promise<void>; /** Start a REST HTTP server with OpenAPI docs. @category Server */
+  serve: (prefs?: PadroneServePreferences) => Promise<void>; /** Read-only metadata about the program (name, version, description, commands, etc.). @category Utility */
+  info: PadroneProgramMeta<TProgramName>;
+};
+type AnyPadroneProgram = PadroneProgram<string, string, string, any, any, [...AnyPadroneCommand[]]>;
+/**
+ * A build-time extension that transforms a builder/program.
+ * Extensions can add commands, arguments, interceptors, configure settings, etc.
+ *
+ * Use with `.extend(extension)`:
+ * ```ts
+ * const withAuth = (b) => b.arguments(authSchema).command('login', ...)
+ * program.extend(withAuth)
+ * ```
+ */
+type PadroneExtension<TIn extends CommandTypesBase = CommandTypesBase, TOut extends CommandTypesBase = TIn> = (builder: TIn) => TOut;
+/**
+ * Default context type for commands defined with `defineCommand()`.
+ * Includes optional context properties provided by common extensions (logger, tracing, progress).
+ *
+ * Override globally via module augmentation to add your application's context:
+ * ```ts
+ * declare module 'padrone' {
+ *   interface DefineCommandContext {
+ *     db: Database;
+ *   }
+ * }
+ * ```
+ */
+interface DefineCommandContext {
+  logger?: PadroneLogger;
+  tracing?: PadroneTracer;
+  progress?: PadroneProgress;
+}
+/** Error brand returned by `.command()` when a `defineCommand.requires()` context requirement is not satisfied. */
+type DefineCommandRequiresError = {
+  readonly '~error': 'Required context not satisfied. Ensure required interceptors are registered on the program.';
+};
+/**
+ * Type for a command builder callback used with `.command()`.
+ * Use this when defining commands in separate files where full return type inference isn't needed.
+ *
+ * For full type preservation at the parent, use `defineCommand()` instead.
+ *
+ * @example
+ * ```ts
+ * // my-command.ts
+ * export const myCommand: DefineCommand = (c) =>
+ *   c.arguments(z.object({ name: z.string() }))
+ *    .action((args) => console.log(args.name));
+ *
+ * // cli.ts
+ * createPadrone('test').command('my-command', myCommand)
+ * ```
+ */
+type DefineCommand<TContext = unknown, TParentArgs extends PadroneSchema = PadroneSchema> = (builder: PadroneBuilder<string, string, string, PadroneSchema<void>, void, [], TParentArgs, false, TContext, DefineCommandContext>) => CommandTypesBase;
+/**
+ * Builder returned by `defineCommand()` (no-arg form).
+ * Call `.requires<T>()` to declare context dependencies, then `.command()` to provide the builder callback.
+ *
+ * @example
+ * ```ts
+ * const adminCommand = defineCommand()
+ *   .requires<{ adminDb: AdminDB }>()
+ *   .define((c) => c.action((_args, ctx) => ctx.context.adminDb.query(...)));
+ * ```
+ */
+type DefineCommandBuilder<TContextProvided = DefineCommandContext, TBrand = unknown> = {
+  /** Declare context types this command requires. Purely type-level — no runtime effect. */requires: <TRequires>() => DefineCommandBuilder<DefineCommandContext & TRequires, {
+    '~contextRequires': (ctx: TRequires) => void;
+  }>; /** Provide the command builder callback. */
+  define: <TContext = unknown, TOut extends CommandTypesBase = CommandTypesBase>(fn: (builder: PadroneBuilder<string, string, string, PadroneSchema<void>, void, [], any, false, TContext, TContextProvided>) => TOut) => typeof fn & TBrand;
+};
+type DefaultArgs = Record<string, unknown> | void;
+//#endregion
+export { AnyPadroneBuilder, AnyPadroneProgram, DefineCommand, DefineCommandBuilder, DefineCommandContext, DefineCommandRequiresError, PadroneBuilder, PadroneBuilderMethods, PadroneExtension, PadroneProgram };
+//# sourceMappingURL=builder.d.mts.map

package/dist/types/builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.mts","names":[],"sources":["../../src/types/builder.ts"],"mappings":"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"}