padrone 1.4.0 → 1.6.0

package/dist/serve-Bk0JUlCj.mjs

@@ -0,0 +1,402 @@
+import { m as serializeArgsToFlags, r as collectEndpoints, t as buildInputSchema } from "./commands-B_gufyR9.mjs";
+import { a as readStreamAsText } from "./stream-DC4H8YTx.mjs";
+import { i as RoutingError, o as ValidationError } from "./errors-CL63UOzt.mjs";
+import { t as generateHelp } from "./help-B5Kk83of.mjs";
+//#region src/feature/serve.ts
+/** Convert an endpoint dot-path to a URL path segment. */
+function toUrlPath(name) {
+	return name.replace(/\./g, "/");
+}
+/** Convert a URL path segment back to a command path (slash → space). */
+function toCommandPath(urlPath) {
+	return urlPath.replace(/\//g, " ");
+}
+function jsonResponse(body, status = 200, headers) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: {
+			"Content-Type": "application/json",
+			...headers
+		}
+	});
+}
+function errorToStatus(error) {
+	if (error instanceof RoutingError) return 404;
+	if (error instanceof ValidationError) return 400;
+	return 500;
+}
+function errorToResponse(error) {
+	const status = errorToStatus(error);
+	if (error instanceof ValidationError) return jsonResponse({
+		ok: false,
+		error: "validation",
+		message: error.message,
+		issues: error.issues.map((i) => ({
+			path: i.path?.map(String),
+			message: i.message
+		}))
+	}, status);
+	if (error instanceof RoutingError) return jsonResponse({
+		ok: false,
+		error: "not_found",
+		message: error.message,
+		suggestions: error.suggestions
+	}, status);
+	return jsonResponse({
+		ok: false,
+		error: "action_error",
+		message: error instanceof Error ? error.message : String(error)
+	}, status);
+}
+/** Generate an OpenAPI 3.1.0 spec from the command tree. */
+function buildOpenApiSpec(existingCommand, endpoints, basePath) {
+	const paths = {};
+	const responseSchema = {
+		"200": {
+			description: "Successful response",
+			content: { "application/json": { schema: {
+				type: "object",
+				properties: {
+					ok: {
+						type: "boolean",
+						const: true
+					},
+					result: {}
+				}
+			} } }
+		},
+		"400": {
+			description: "Validation error",
+			content: { "application/json": { schema: {
+				type: "object",
+				properties: {
+					ok: {
+						type: "boolean",
+						const: false
+					},
+					error: {
+						type: "string",
+						const: "validation"
+					},
+					message: { type: "string" },
+					issues: {
+						type: "array",
+						items: {
+							type: "object",
+							properties: {
+								path: { type: "array" },
+								message: { type: "string" }
+							}
+						}
+					}
+				}
+			} } }
+		},
+		"404": {
+			description: "Command not found",
+			content: { "application/json": { schema: {
+				type: "object",
+				properties: {
+					ok: {
+						type: "boolean",
+						const: false
+					},
+					error: {
+						type: "string",
+						const: "not_found"
+					},
+					message: { type: "string" }
+				}
+			} } }
+		},
+		"500": {
+			description: "Action error",
+			content: { "application/json": { schema: {
+				type: "object",
+				properties: {
+					ok: {
+						type: "boolean",
+						const: false
+					},
+					error: {
+						type: "string",
+						const: "action_error"
+					},
+					message: { type: "string" }
+				}
+			} } }
+		}
+	};
+	for (const { name, command: cmd } of endpoints) {
+		const urlPath = `${basePath}${toUrlPath(name)}`;
+		const inputSchema = buildInputSchema(cmd);
+		const description = cmd.description || cmd.title || `Run the "${name}" command`;
+		const pathItem = {};
+		const postOp = {
+			summary: cmd.title || name,
+			description,
+			operationId: `post_${name.replace(/\./g, "_")}`,
+			requestBody: { content: { "application/json": { schema: inputSchema } } },
+			responses: responseSchema
+		};
+		if (cmd.mutation) pathItem.post = postOp;
+		else {
+			const properties = inputSchema.properties ?? {};
+			const queryParams = Object.entries(properties).map(([key, schema]) => ({
+				name: key,
+				in: "query",
+				schema,
+				required: inputSchema.required?.includes(key) ?? false
+			}));
+			pathItem.get = {
+				summary: cmd.title || name,
+				description,
+				operationId: `get_${name.replace(/\./g, "_")}`,
+				parameters: queryParams,
+				responses: responseSchema
+			};
+			pathItem.post = postOp;
+		}
+		paths[urlPath] = pathItem;
+	}
+	return {
+		openapi: "3.1.0",
+		info: {
+			title: existingCommand.title || existingCommand.name,
+			description: existingCommand.description,
+			version: existingCommand.version ?? "0.0.0"
+		},
+		paths
+	};
+}
+function scalarDocsHtml(openapiUrl, title) {
+	return `<!doctype html>
+<html>
+<head>
+  <title>${title} — API Docs</title>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+</head>
+<body>
+  <script id="api-reference" data-url="${openapiUrl}"><\/script>
+  <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"><\/script>
+</body>
+</html>`;
+}
+/** Create the serve request handler. */
+function createServeHandler(existingCommand, evalCommand, prefs) {
+	const basePath = (prefs?.basePath ?? "/").replace(/\/$/, "/");
+	const corsOrigin = prefs?.cors !== false ? prefs?.cors ?? "*" : void 0;
+	const builtins = {
+		health: true,
+		help: true,
+		schema: true,
+		docs: true,
+		...prefs?.builtins
+	};
+	const endpoints = collectEndpoints(existingCommand.commands, "");
+	if (existingCommand.action || existingCommand.argsSchema) endpoints.unshift({
+		name: "",
+		command: existingCommand
+	});
+	const routeMap = /* @__PURE__ */ new Map();
+	for (const ep of endpoints) routeMap.set(toUrlPath(ep.name), ep);
+	let cachedOpenApiSpec;
+	const getOpenApiSpec = () => cachedOpenApiSpec ??= buildOpenApiSpec(existingCommand, endpoints, basePath);
+	function addCorsHeaders(res) {
+		if (!corsOrigin) return res;
+		const headers = new Headers(res.headers);
+		headers.set("Access-Control-Allow-Origin", corsOrigin);
+		headers.set("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+		headers.set("Access-Control-Allow-Headers", "Content-Type");
+		return new Response(res.body, {
+			status: res.status,
+			statusText: res.statusText,
+			headers
+		});
+	}
+	async function evalAndRespond(commandString, request) {
+		const output = [];
+		const errors = [];
+		const result = await evalCommand(commandString || void 0, {
+			caller: "serve",
+			runtime: {
+				output: (...args) => output.push(args.map(String).join(" ")),
+				error: (text) => errors.push(text),
+				interactive: "unsupported",
+				format: "json"
+			}
+		});
+		if (result.error) return prefs?.onError ? prefs.onError(result.error, request) : errorToResponse(result.error);
+		if (result.argsResult?.issues) return jsonResponse({
+			ok: false,
+			error: "validation",
+			issues: result.argsResult.issues.map((i) => ({
+				path: i.path?.map(String),
+				message: i.message
+			}))
+		}, 400);
+		return jsonResponse({
+			ok: true,
+			result: result.result ?? null
+		});
+	}
+	return async function handleRequest(req) {
+		if (req.method === "OPTIONS") return addCorsHeaders(new Response(null, { status: corsOrigin ? 204 : 405 }));
+		if (prefs?.onRequest) {
+			const hookResponse = await prefs.onRequest(req);
+			if (hookResponse) return addCorsHeaders(hookResponse);
+		}
+		const url = new URL(req.url, "http://localhost");
+		let pathname = url.pathname;
+		if (basePath !== "/" && pathname.startsWith(basePath)) pathname = pathname.slice(basePath.length - 1);
+		const routePath = pathname.replace(/^\//, "");
+		if (req.method === "GET") {
+			if (builtins.health && routePath === "_health") return addCorsHeaders(jsonResponse({ status: "ok" }));
+			if (builtins.schema && routePath === "_schema") {
+				const schemaMap = {};
+				for (const ep of endpoints) schemaMap[toUrlPath(ep.name) || "/"] = buildInputSchema(ep.command);
+				return addCorsHeaders(jsonResponse(schemaMap));
+			}
+			if (builtins.schema && routePath.startsWith("_schema/")) {
+				const cmdPath = routePath.slice(8);
+				const ep = routeMap.get(cmdPath);
+				if (!ep) return addCorsHeaders(jsonResponse({
+					ok: false,
+					error: "not_found",
+					message: `Command not found: ${cmdPath}`
+				}, 404));
+				return addCorsHeaders(jsonResponse(buildInputSchema(ep.command)));
+			}
+			if (builtins.help && routePath === "_help") {
+				const format = (req.headers.get("accept") ?? "").includes("application/json") ? "json" : "markdown";
+				const helpText = generateHelp(existingCommand, existingCommand, {
+					format,
+					detail: "full"
+				});
+				if (format === "json") return addCorsHeaders(jsonResponse(JSON.parse(helpText)));
+				return addCorsHeaders(new Response(helpText, {
+					status: 200,
+					headers: { "Content-Type": "text/markdown" }
+				}));
+			}
+			if (builtins.help && routePath.startsWith("_help/")) {
+				const cmdPath = routePath.slice(6);
+				const ep = routeMap.get(cmdPath);
+				if (!ep) return addCorsHeaders(jsonResponse({
+					ok: false,
+					error: "not_found",
+					message: `Command not found: ${cmdPath}`
+				}, 404));
+				const format = (req.headers.get("accept") ?? "").includes("application/json") ? "json" : "markdown";
+				const helpText = generateHelp(existingCommand, ep.command, {
+					format,
+					detail: "full"
+				});
+				if (format === "json") return addCorsHeaders(jsonResponse(JSON.parse(helpText)));
+				return addCorsHeaders(new Response(helpText, {
+					status: 200,
+					headers: { "Content-Type": "text/markdown" }
+				}));
+			}
+			if (builtins.docs && routePath === "_openapi") return addCorsHeaders(jsonResponse(getOpenApiSpec()));
+			if (builtins.docs && routePath === "_docs") {
+				const html = scalarDocsHtml(`${basePath}_openapi`, existingCommand.title || existingCommand.name);
+				return addCorsHeaders(new Response(html, {
+					status: 200,
+					headers: { "Content-Type": "text/html" }
+				}));
+			}
+		}
+		const endpoint = routeMap.get(routePath);
+		if (!endpoint) return addCorsHeaders(jsonResponse({
+			ok: false,
+			error: "not_found",
+			message: `Command not found: ${routePath || "/"}`
+		}, 404));
+		if (endpoint.command.mutation && req.method === "GET") return addCorsHeaders(new Response(JSON.stringify({
+			ok: false,
+			error: "method_not_allowed",
+			message: "Mutation commands only accept POST"
+		}), {
+			status: 405,
+			headers: {
+				"Content-Type": "application/json",
+				Allow: "POST"
+			}
+		}));
+		if (req.method !== "GET" && req.method !== "POST") return addCorsHeaders(new Response(null, {
+			status: 405,
+			headers: { Allow: endpoint.command.mutation ? "POST" : "GET, POST" }
+		}));
+		const commandPath = toCommandPath(routePath);
+		let argParts;
+		if (req.method === "POST") try {
+			argParts = serializeArgsToFlags(await req.json());
+		} catch {
+			return addCorsHeaders(jsonResponse({
+				ok: false,
+				error: "bad_request",
+				message: "Invalid JSON body"
+			}, 400));
+		}
+		else {
+			argParts = [];
+			for (const [key, value] of url.searchParams.entries()) if (key === "_") argParts.push(value);
+			else argParts.push(value === "" ? `--${key}` : `--${key}=${value}`);
+		}
+		return addCorsHeaders(await evalAndRespond([commandPath, ...argParts].filter(Boolean).join(" "), req));
+	};
+}
+/** Start the serve HTTP server. */
+async function startServeServer(_program, existingCommand, evalCommand, prefs) {
+	const handler = createServeHandler(existingCommand, evalCommand, prefs);
+	const http = await import("node:http");
+	const port = prefs?.port ?? 3e3;
+	const host = prefs?.host ?? "127.0.0.1";
+	const basePath = (prefs?.basePath ?? "/").replace(/\/$/, "/");
+	const server = http.createServer(async (req, res) => {
+		const url = `http://${host}:${port}${req.url}`;
+		const headers = new Headers();
+		for (const [key, value] of Object.entries(req.headers)) if (value) headers.set(key, Array.isArray(value) ? value.join(", ") : value);
+		const response = await handler(new Request(url, {
+			method: req.method,
+			headers,
+			body: req.method !== "GET" && req.method !== "HEAD" ? await readBody(req) : void 0
+		}));
+		const resHeaders = {};
+		response.headers.forEach((v, k) => {
+			resHeaders[k] = v;
+		});
+		res.writeHead(response.status, resHeaders);
+		const body = await response.text();
+		res.end(body);
+	});
+	const { getCommandRuntime } = await import("./commands-B_gufyR9.mjs").then((n) => n.a);
+	const runtime = getCommandRuntime(existingCommand);
+	return new Promise((resolve, reject) => {
+		server.listen(port, host, () => {
+			runtime.error(`REST server listening on http://${host}:${port}${basePath}`);
+			if ({
+				health: true,
+				help: true,
+				schema: true,
+				docs: true,
+				...prefs?.builtins
+			}.docs) runtime.error(`API docs: http://${host}:${port}${basePath}_docs`);
+		});
+		server.on("error", reject);
+		const unsubscribe = runtime.onSignal?.(() => {
+			server.close(() => resolve());
+		});
+		server.on("close", () => unsubscribe?.());
+	});
+}
+/** Read the full body from a Node.js IncomingMessage. */
+async function readBody(req) {
+	return readStreamAsText(req);
+}
+//#endregion
+export { startServeServer };
+
+//# sourceMappingURL=serve-Bk0JUlCj.mjs.map

package/dist/serve-Bk0JUlCj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-Bk0JUlCj.mjs","names":[],"sources":["../src/feature/serve.ts"],"sourcesContent":["import { buildInputSchema, type CollectedEndpoint, collectEndpoints, serializeArgsToFlags } from '../core/commands.ts';\nimport { RoutingError, ValidationError } from '../core/errors.ts';\nimport { generateHelp } from '../output/help.ts';\nimport type { AnyPadroneCommand, AnyPadroneProgram } from '../types/index.ts';\nimport { readStreamAsText } from '../util/stream.ts';\n\nexport type PadroneServePreferences = {\n  /** Port to listen on. Default: 3000 */\n  port?: number;\n  /** Host to bind to. Default: '127.0.0.1' */\n  host?: string;\n  /** Base path prefix for all routes. Default: '/' */\n  basePath?: string;\n  /** CORS allowed origin. Default: '*'. Set to `false` to disable CORS headers. */\n  cors?: string | false;\n  /** Control built-in utility endpoints. All enabled by default. */\n  builtins?: {\n    /** GET /_health — returns 200 OK. */\n    health?: boolean;\n    /** GET /_help and GET /_help/:command — returns help text. */\n    help?: boolean;\n    /** GET /_schema and GET /_schema/:command — returns JSON Schema. */\n    schema?: boolean;\n    /** GET /_docs — Scalar OpenAPI docs viewer. */\n    docs?: boolean;\n  };\n  /** Hook to run before each request. Return a Response to short-circuit. */\n  onRequest?: (req: Request) => Response | void | Promise<Response | void>;\n  /** Transform errors into responses. */\n  onError?: (error: unknown, req: Request) => Response;\n};\n\n/** Convert an endpoint dot-path to a URL path segment. */\nfunction toUrlPath(name: string): string {\n  return name.replace(/\\./g, '/');\n}\n\n/** Convert a URL path segment back to a command path (slash → space). */\nfunction toCommandPath(urlPath: string): string {\n  return urlPath.replace(/\\//g, ' ');\n}\n\nfunction jsonResponse(body: unknown, status = 200, headers?: Record<string, string>): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { 'Content-Type': 'application/json', ...headers },\n  });\n}\n\nfunction errorToStatus(error: unknown): number {\n  if (error instanceof RoutingError) return 404;\n  if (error instanceof ValidationError) return 400;\n  return 500;\n}\n\nfunction errorToResponse(error: unknown): Response {\n  const status = errorToStatus(error);\n  if (error instanceof ValidationError) {\n    return jsonResponse(\n      {\n        ok: false,\n        error: 'validation',\n        message: error.message,\n        issues: error.issues.map((i) => ({ path: i.path?.map(String), message: i.message })),\n      },\n      status,\n    );\n  }\n  if (error instanceof RoutingError) {\n    return jsonResponse({ ok: false, error: 'not_found', message: error.message, suggestions: error.suggestions }, status);\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  return jsonResponse({ ok: false, error: 'action_error', message }, status);\n}\n\n/** Generate an OpenAPI 3.1.0 spec from the command tree. */\nfunction buildOpenApiSpec(existingCommand: AnyPadroneCommand, endpoints: CollectedEndpoint[], basePath: string): Record<string, unknown> {\n  const paths: Record<string, unknown> = {};\n\n  const responseSchema = {\n    '200': {\n      description: 'Successful response',\n      content: { 'application/json': { schema: { type: 'object', properties: { ok: { type: 'boolean', const: true }, result: {} } } } },\n    },\n    '400': {\n      description: 'Validation error',\n      content: {\n        'application/json': {\n          schema: {\n            type: 'object',\n            properties: {\n              ok: { type: 'boolean', const: false },\n              error: { type: 'string', const: 'validation' },\n              message: { type: 'string' },\n              issues: { type: 'array', items: { type: 'object', properties: { path: { type: 'array' }, message: { type: 'string' } } } },\n            },\n          },\n        },\n      },\n    },\n    '404': {\n      description: 'Command not found',\n      content: {\n        'application/json': {\n          schema: {\n            type: 'object',\n            properties: {\n              ok: { type: 'boolean', const: false },\n              error: { type: 'string', const: 'not_found' },\n              message: { type: 'string' },\n            },\n          },\n        },\n      },\n    },\n    '500': {\n      description: 'Action error',\n      content: {\n        'application/json': {\n          schema: {\n            type: 'object',\n            properties: {\n              ok: { type: 'boolean', const: false },\n              error: { type: 'string', const: 'action_error' },\n              message: { type: 'string' },\n            },\n          },\n        },\n      },\n    },\n  };\n\n  for (const { name, command: cmd } of endpoints) {\n    const urlPath = `${basePath}${toUrlPath(name)}`;\n    const inputSchema = buildInputSchema(cmd);\n    const description = cmd.description || cmd.title || `Run the \"${name}\" command`;\n    const pathItem: Record<string, unknown> = {};\n\n    const postOp = {\n      summary: cmd.title || name,\n      description,\n      operationId: `post_${name.replace(/\\./g, '_')}`,\n      requestBody: { content: { 'application/json': { schema: inputSchema } } },\n      responses: responseSchema,\n    };\n\n    if (cmd.mutation) {\n      pathItem.post = postOp;\n    } else {\n      // GET: args as query parameters\n      const properties = (inputSchema.properties ?? {}) as Record<string, Record<string, unknown>>;\n      const queryParams = Object.entries(properties).map(([key, schema]) => ({\n        name: key,\n        in: 'query',\n        schema,\n        required: (inputSchema.required as string[] | undefined)?.includes(key) ?? false,\n      }));\n      pathItem.get = {\n        summary: cmd.title || name,\n        description,\n        operationId: `get_${name.replace(/\\./g, '_')}`,\n        parameters: queryParams,\n        responses: responseSchema,\n      };\n      pathItem.post = postOp;\n    }\n\n    paths[urlPath] = pathItem;\n  }\n\n  return {\n    openapi: '3.1.0',\n    info: {\n      title: existingCommand.title || existingCommand.name,\n      description: existingCommand.description,\n      version: existingCommand.version ?? '0.0.0',\n    },\n    paths,\n  };\n}\n\nfunction scalarDocsHtml(openapiUrl: string, title: string): string {\n  return `<!doctype html>\n<html>\n<head>\n  <title>${title} — API Docs</title>\n  <meta charset=\"utf-8\" />\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n</head>\n<body>\n  <script id=\"api-reference\" data-url=\"${openapiUrl}\"></script>\n  <script src=\"https://cdn.jsdelivr.net/npm/@scalar/api-reference\"></script>\n</body>\n</html>`;\n}\n\n/** Create the serve request handler. */\nexport function createServeHandler(\n  existingCommand: AnyPadroneCommand,\n  evalCommand: AnyPadroneProgram['eval'],\n  prefs?: PadroneServePreferences,\n): (req: Request) => Promise<Response> {\n  const basePath = (prefs?.basePath ?? '/').replace(/\\/$/, '/');\n  const corsOrigin = prefs?.cors !== false ? (prefs?.cors ?? '*') : undefined;\n  const builtins = { health: true, help: true, schema: true, docs: true, ...prefs?.builtins };\n\n  const endpoints = collectEndpoints(existingCommand.commands, '');\n  if (existingCommand.action || existingCommand.argsSchema) {\n    endpoints.unshift({ name: '', command: existingCommand });\n  }\n\n  const routeMap = new Map<string, CollectedEndpoint>();\n  for (const ep of endpoints) {\n    routeMap.set(toUrlPath(ep.name), ep);\n  }\n\n  let cachedOpenApiSpec: Record<string, unknown> | undefined;\n  const getOpenApiSpec = () => (cachedOpenApiSpec ??= buildOpenApiSpec(existingCommand, endpoints, basePath));\n\n  function addCorsHeaders(res: Response): Response {\n    if (!corsOrigin) return res;\n    const headers = new Headers(res.headers);\n    headers.set('Access-Control-Allow-Origin', corsOrigin);\n    headers.set('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');\n    headers.set('Access-Control-Allow-Headers', 'Content-Type');\n    return new Response(res.body, { status: res.status, statusText: res.statusText, headers });\n  }\n\n  async function evalAndRespond(commandString: string, request: Request): Promise<Response> {\n    const output: string[] = [];\n    const errors: string[] = [];\n    const result = await evalCommand(commandString || (undefined as any), {\n      caller: 'serve',\n      runtime: {\n        output: (...args: unknown[]) => output.push(args.map(String).join(' ')),\n        error: (text: string) => errors.push(text),\n        interactive: 'unsupported',\n        format: 'json',\n      },\n    });\n\n    if (result.error) {\n      return prefs?.onError ? prefs.onError(result.error, request) : errorToResponse(result.error);\n    }\n\n    if (result.argsResult?.issues) {\n      const issues = (result.argsResult.issues as { path?: PropertyKey[]; message: string }[]).map((i) => ({\n        path: i.path?.map(String),\n        message: i.message,\n      }));\n      return jsonResponse({ ok: false, error: 'validation', issues }, 400);\n    }\n\n    return jsonResponse({ ok: true, result: result.result ?? null });\n  }\n\n  return async function handleRequest(req: Request): Promise<Response> {\n    // CORS preflight\n    if (req.method === 'OPTIONS') {\n      return addCorsHeaders(new Response(null, { status: corsOrigin ? 204 : 405 }));\n    }\n\n    // onRequest hook\n    if (prefs?.onRequest) {\n      const hookResponse = await prefs.onRequest(req);\n      if (hookResponse) return addCorsHeaders(hookResponse);\n    }\n\n    const url = new URL(req.url, 'http://localhost');\n    let pathname = url.pathname;\n\n    // Strip basePath prefix\n    if (basePath !== '/' && pathname.startsWith(basePath)) {\n      pathname = pathname.slice(basePath.length - 1);\n    }\n    // Remove leading slash for route matching\n    const routePath = pathname.replace(/^\\//, '');\n\n    // Built-in endpoints\n    if (req.method === 'GET') {\n      if (builtins.health && routePath === '_health') {\n        return addCorsHeaders(jsonResponse({ status: 'ok' }));\n      }\n\n      if (builtins.schema && routePath === '_schema') {\n        const schemaMap: Record<string, unknown> = {};\n        for (const ep of endpoints) {\n          schemaMap[toUrlPath(ep.name) || '/'] = buildInputSchema(ep.command);\n        }\n        return addCorsHeaders(jsonResponse(schemaMap));\n      }\n\n      if (builtins.schema && routePath.startsWith('_schema/')) {\n        const cmdPath = routePath.slice('_schema/'.length);\n        const ep = routeMap.get(cmdPath);\n        if (!ep) return addCorsHeaders(jsonResponse({ ok: false, error: 'not_found', message: `Command not found: ${cmdPath}` }, 404));\n        return addCorsHeaders(jsonResponse(buildInputSchema(ep.command)));\n      }\n\n      if (builtins.help && routePath === '_help') {\n        const accept = req.headers.get('accept') ?? '';\n        const format = accept.includes('application/json') ? 'json' : 'markdown';\n        const helpText = generateHelp(existingCommand, existingCommand, { format, detail: 'full' });\n        if (format === 'json') return addCorsHeaders(jsonResponse(JSON.parse(helpText)));\n        return addCorsHeaders(new Response(helpText, { status: 200, headers: { 'Content-Type': 'text/markdown' } }));\n      }\n\n      if (builtins.help && routePath.startsWith('_help/')) {\n        const cmdPath = routePath.slice('_help/'.length);\n        const ep = routeMap.get(cmdPath);\n        if (!ep) return addCorsHeaders(jsonResponse({ ok: false, error: 'not_found', message: `Command not found: ${cmdPath}` }, 404));\n        const accept = req.headers.get('accept') ?? '';\n        const format = accept.includes('application/json') ? 'json' : 'markdown';\n        const helpText = generateHelp(existingCommand, ep.command, { format, detail: 'full' });\n        if (format === 'json') return addCorsHeaders(jsonResponse(JSON.parse(helpText)));\n        return addCorsHeaders(new Response(helpText, { status: 200, headers: { 'Content-Type': 'text/markdown' } }));\n      }\n\n      if (builtins.docs && routePath === '_openapi') {\n        return addCorsHeaders(jsonResponse(getOpenApiSpec()));\n      }\n\n      if (builtins.docs && routePath === '_docs') {\n        const openapiUrl = `${basePath}_openapi`;\n        const title = existingCommand.title || existingCommand.name;\n        const html = scalarDocsHtml(openapiUrl, title);\n        return addCorsHeaders(new Response(html, { status: 200, headers: { 'Content-Type': 'text/html' } }));\n      }\n    }\n\n    // Route to command\n    const endpoint = routeMap.get(routePath);\n    if (!endpoint) {\n      return addCorsHeaders(jsonResponse({ ok: false, error: 'not_found', message: `Command not found: ${routePath || '/'}` }, 404));\n    }\n\n    // Enforce method based on mutation flag\n    if (endpoint.command.mutation && req.method === 'GET') {\n      return addCorsHeaders(\n        new Response(JSON.stringify({ ok: false, error: 'method_not_allowed', message: 'Mutation commands only accept POST' }), {\n          status: 405,\n          headers: { 'Content-Type': 'application/json', Allow: 'POST' },\n        }),\n      );\n    }\n\n    if (req.method !== 'GET' && req.method !== 'POST') {\n      return addCorsHeaders(new Response(null, { status: 405, headers: { Allow: endpoint.command.mutation ? 'POST' : 'GET, POST' } }));\n    }\n\n    // Build command string from request\n    const commandPath = toCommandPath(routePath);\n    let argParts: string[];\n\n    if (req.method === 'POST') {\n      try {\n        const body = (await req.json()) as Record<string, unknown>;\n        argParts = serializeArgsToFlags(body);\n      } catch {\n        return addCorsHeaders(jsonResponse({ ok: false, error: 'bad_request', message: 'Invalid JSON body' }, 400));\n      }\n    } else {\n      // GET: query string → flags\n      argParts = [];\n      for (const [key, value] of url.searchParams.entries()) {\n        if (key === '_') {\n          // Positional args\n          argParts.push(value);\n        } else {\n          argParts.push(value === '' ? `--${key}` : `--${key}=${value}`);\n        }\n      }\n    }\n\n    const commandString = [commandPath, ...argParts].filter(Boolean).join(' ');\n    const response = await evalAndRespond(commandString, req);\n    return addCorsHeaders(response);\n  };\n}\n\n/** Start the serve HTTP server. */\nexport async function startServeServer(\n  _program: AnyPadroneProgram,\n  existingCommand: AnyPadroneCommand,\n  evalCommand: AnyPadroneProgram['eval'],\n  prefs?: PadroneServePreferences,\n): Promise<void> {\n  const handler = createServeHandler(existingCommand, evalCommand, prefs);\n  const http = await import('node:http');\n\n  const port = prefs?.port ?? 3000;\n  const host = prefs?.host ?? '127.0.0.1';\n  const basePath = (prefs?.basePath ?? '/').replace(/\\/$/, '/');\n\n  const server = http.createServer(async (req, res) => {\n    const url = `http://${host}:${port}${req.url}`;\n    const headers = new Headers();\n    for (const [key, value] of Object.entries(req.headers)) {\n      if (value) headers.set(key, Array.isArray(value) ? value.join(', ') : value);\n    }\n\n    const fetchReq = new Request(url, {\n      method: req.method,\n      headers,\n      body: req.method !== 'GET' && req.method !== 'HEAD' ? await readBody(req) : undefined,\n    });\n\n    const response = await handler(fetchReq);\n    const resHeaders: Record<string, string> = {};\n    response.headers.forEach((v, k) => {\n      resHeaders[k] = v;\n    });\n    res.writeHead(response.status, resHeaders);\n    const body = await response.text();\n    res.end(body);\n  });\n\n  const { getCommandRuntime } = await import('../core/commands.ts');\n  const runtime = getCommandRuntime(existingCommand);\n\n  return new Promise<void>((resolve, reject) => {\n    server.listen(port, host, () => {\n      runtime.error(`REST server listening on http://${host}:${port}${basePath}`);\n      const builtins = { health: true, help: true, schema: true, docs: true, ...prefs?.builtins };\n      if (builtins.docs) runtime.error(`API docs: http://${host}:${port}${basePath}_docs`);\n    });\n    server.on('error', reject);\n    const unsubscribe = runtime.onSignal?.(() => {\n      server.close(() => resolve());\n    });\n    server.on('close', () => unsubscribe?.());\n  });\n}\n\n/** Read the full body from a Node.js IncomingMessage. */\nasync function readBody(req: import('node:http').IncomingMessage): Promise<string> {\n  return readStreamAsText(req as AsyncIterable<Uint8Array>);\n}\n"],"mappings":"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"}

package/dist/stream-DC4H8YTx.mjs

@@ -0,0 +1,77 @@
+//#region src/util/stream.ts
+let asyncStreamIdCounter = 1;
+const asyncStreamRegistry = /* @__PURE__ */ new Map();
+/**
+* Returns metadata to mark a schema field as an async stream via `.meta()`.
+*
+* When used with `stdin`, padrone pipes stdin data as an `AsyncIterable` instead of
+* buffering it. Each line is validated against the item schema (if provided) as it arrives.
+*
+* @param itemSchema - Optional item schema for per-item validation.
+*   Non-string schemas cause each stdin line to be `JSON.parse`'d before validation.
+*
+* @example
+* ```ts
+* import { asyncStream } from 'padrone';
+*
+* // String lines
+* z.object({ lines: z.custom<AsyncIterable<string>>().meta(asyncStream()) })
+*
+* // Typed items — each line JSON.parse'd and validated
+* z.object({ records: z.custom<AsyncIterable<{ name: string }>>().meta(asyncStream(recordSchema)) })
+* ```
+*/
+function asyncStream(itemSchema) {
+	const id = asyncStreamIdCounter++;
+	const meta = itemSchema ? {
+		asyncStream: id,
+		itemSchema
+	} : { asyncStream: id };
+	asyncStreamRegistry.set(id, meta);
+	return meta;
+}
+/**
+* Creates an `AsyncIterable` from a stdin source, optionally validating each item.
+* When no stdin is available (TTY / undefined), yields nothing.
+*
+* - No item schema: yields raw string lines
+* - With item schema: `JSON.parse`s each line, validates, then yields
+*/
+function createStdinStream(stdin, itemSchema) {
+	if (!stdin) return emptyAsyncIterable;
+	if (!itemSchema) return stdin.lines();
+	return { async *[Symbol.asyncIterator]() {
+		for await (const line of stdin.lines()) {
+			const result = itemSchema["~standard"].validate(line);
+			const resolved = result instanceof Promise ? await result : result;
+			if ("issues" in resolved && resolved.issues) throw new Error(`Stream item validation failed: ${resolved.issues.map((i) => i.message).join(", ")}`);
+			yield resolved.value;
+		}
+	} };
+}
+const emptyAsyncIterable = { async *[Symbol.asyncIterator]() {} };
+const textEncoder = /* @__PURE__ */ new TextEncoder();
+const textDecoder = /* @__PURE__ */ new TextDecoder();
+/** Concatenate multiple `Uint8Array` chunks into a single array. */
+function concatBytes(chunks) {
+	if (chunks.length === 1) return chunks[0];
+	let totalLength = 0;
+	for (const chunk of chunks) totalLength += chunk.byteLength;
+	const result = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const chunk of chunks) {
+		result.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return result;
+}
+/** Read an async iterable of chunks into a UTF-8 string. */
+async function readStreamAsText(stream) {
+	const chunks = [];
+	for await (const chunk of stream) chunks.push(typeof chunk === "string" ? textEncoder.encode(chunk) : chunk);
+	return textDecoder.decode(concatBytes(chunks));
+}
+//#endregion
+export { readStreamAsText as a, createStdinStream as i, asyncStreamRegistry as n, concatBytes as r, asyncStream as t };
+
+//# sourceMappingURL=stream-DC4H8YTx.mjs.map

package/dist/stream-DC4H8YTx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-DC4H8YTx.mjs","names":[],"sources":["../src/util/stream.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { PadroneSchema } from '../types/index.ts';\n\nexport interface AsyncStreamMeta {\n  [x: string]: unknown;\n  readonly asyncStream: number;\n  readonly itemSchema?: StandardSchemaV1;\n}\n\nlet asyncStreamIdCounter = 1;\nexport const asyncStreamRegistry = new Map<number, AsyncStreamMeta>();\n\n/**\n * Returns metadata to mark a schema field as an async stream via `.meta()`.\n *\n * When used with `stdin`, padrone pipes stdin data as an `AsyncIterable` instead of\n * buffering it. Each line is validated against the item schema (if provided) as it arrives.\n *\n * @param itemSchema - Optional item schema for per-item validation.\n *   Non-string schemas cause each stdin line to be `JSON.parse`'d before validation.\n *\n * @example\n * ```ts\n * import { asyncStream } from 'padrone';\n *\n * // String lines\n * z.object({ lines: z.custom<AsyncIterable<string>>().meta(asyncStream()) })\n *\n * // Typed items — each line JSON.parse'd and validated\n * z.object({ records: z.custom<AsyncIterable<{ name: string }>>().meta(asyncStream(recordSchema)) })\n * ```\n */\nexport function asyncStream<T = string>(itemSchema?: PadroneSchema<T>): AsyncStreamMeta {\n  const id = asyncStreamIdCounter++;\n  const meta: AsyncStreamMeta = itemSchema ? { asyncStream: id, itemSchema } : { asyncStream: id };\n  asyncStreamRegistry.set(id, meta);\n  return meta;\n}\n\n/** Stdin interface matching PadroneRuntime.stdin */\ninterface StdinSource {\n  isTTY?: boolean;\n  text(): Promise<string>;\n  lines(): AsyncIterable<string>;\n}\n\n/**\n * Creates an `AsyncIterable` from a stdin source, optionally validating each item.\n * When no stdin is available (TTY / undefined), yields nothing.\n *\n * - No item schema: yields raw string lines\n * - With item schema: `JSON.parse`s each line, validates, then yields\n */\nexport function createStdinStream(stdin: StdinSource | undefined, itemSchema?: StandardSchemaV1): AsyncIterable<unknown> {\n  if (!stdin) return emptyAsyncIterable;\n\n  if (!itemSchema) return stdin.lines();\n\n  return {\n    async *[Symbol.asyncIterator]() {\n      for await (const line of stdin.lines()) {\n        const result = itemSchema['~standard'].validate(line);\n        const resolved = result instanceof Promise ? await result : result;\n        if ('issues' in resolved && resolved.issues) {\n          throw new Error(`Stream item validation failed: ${resolved.issues.map((i) => i.message).join(', ')}`);\n        }\n        yield (resolved as { value: unknown }).value;\n      }\n    },\n  };\n}\n\nconst emptyAsyncIterable: AsyncIterable<never> = {\n  async *[Symbol.asyncIterator]() {},\n};\n\nconst textEncoder = /* @__PURE__ */ new TextEncoder();\nconst textDecoder = /* @__PURE__ */ new TextDecoder();\n\n/** Concatenate multiple `Uint8Array` chunks into a single array. */\nexport function concatBytes(chunks: Uint8Array[]): Uint8Array {\n  if (chunks.length === 1) return chunks[0]!;\n  let totalLength = 0;\n  for (const chunk of chunks) totalLength += chunk.byteLength;\n  const result = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    result.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  return result;\n}\n\n/** Read an async iterable of chunks into a UTF-8 string. */\nexport async function readStreamAsText(stream: AsyncIterable<Uint8Array | string>): Promise<string> {\n  const chunks: Uint8Array[] = [];\n  for await (const chunk of stream) {\n    chunks.push(typeof chunk === 'string' ? textEncoder.encode(chunk) : chunk);\n  }\n  return textDecoder.decode(concatBytes(chunks));\n}\n"],"mappings":";AASA,IAAI,uBAAuB;AAC3B,MAAa,sCAAsB,IAAI,KAA8B;;;;;;;;;;;;;;;;;;;;;AAsBrE,SAAgB,YAAwB,YAAgD;CACtF,MAAM,KAAK;CACX,MAAM,OAAwB,aAAa;EAAE,aAAa;EAAI;EAAY,GAAG,EAAE,aAAa,IAAI;AAChG,qBAAoB,IAAI,IAAI,KAAK;AACjC,QAAO;;;;;;;;;AAiBT,SAAgB,kBAAkB,OAAgC,YAAuD;AACvH,KAAI,CAAC,MAAO,QAAO;AAEnB,KAAI,CAAC,WAAY,QAAO,MAAM,OAAO;AAErC,QAAO,EACL,QAAQ,OAAO,iBAAiB;AAC9B,aAAW,MAAM,QAAQ,MAAM,OAAO,EAAE;GACtC,MAAM,SAAS,WAAW,aAAa,SAAS,KAAK;GACrD,MAAM,WAAW,kBAAkB,UAAU,MAAM,SAAS;AAC5D,OAAI,YAAY,YAAY,SAAS,OACnC,OAAM,IAAI,MAAM,kCAAkC,SAAS,OAAO,KAAK,MAAM,EAAE,QAAQ,CAAC,KAAK,KAAK,GAAG;AAEvG,SAAO,SAAgC;;IAG5C;;AAGH,MAAM,qBAA2C,EAC/C,QAAQ,OAAO,iBAAiB,IACjC;AAED,MAAM,8BAA8B,IAAI,aAAa;AACrD,MAAM,8BAA8B,IAAI,aAAa;;AAGrD,SAAgB,YAAY,QAAkC;AAC5D,KAAI,OAAO,WAAW,EAAG,QAAO,OAAO;CACvC,IAAI,cAAc;AAClB,MAAK,MAAM,SAAS,OAAQ,gBAAe,MAAM;CACjD,MAAM,SAAS,IAAI,WAAW,YAAY;CAC1C,IAAI,SAAS;AACb,MAAK,MAAM,SAAS,QAAQ;AAC1B,SAAO,IAAI,OAAO,OAAO;AACzB,YAAU,MAAM;;AAElB,QAAO;;;AAIT,eAAsB,iBAAiB,QAA6D;CAClG,MAAM,SAAuB,EAAE;AAC/B,YAAW,MAAM,SAAS,OACxB,QAAO,KAAK,OAAO,UAAU,WAAW,YAAY,OAAO,MAAM,GAAG,MAAM;AAE5E,QAAO,YAAY,OAAO,YAAY,OAAO,CAAC"}

package/dist/test.d.mts

@@ -1,6 +1,6 @@
-import { b as PadroneRuntime, n as AnyPadroneCommand } from "./types-DjIdJN5G.mjs";
+import { nt as PadroneRuntime, u as AnyPadroneCommand } from "./index-BaU3X6dY.mjs";
 
-//#region src/test.d.ts
+//#region src/feature/test.d.ts
 /**
  * Result from a single command execution in test mode.
  * Extends the standard PadroneCommandResult with captured I/O.
@@ -31,8 +31,7 @@ type TestReplResult = {
 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 config files. Keys are file paths, values are parsed config objects. */
-  config(files: Record<string, Record<string, unknown>>): TestCliBuilder; /** Provide mock stdin data (simulates piped input). */
+  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.
@@ -97,9 +96,7 @@ type TestCliBuilder = {
  * Avoids strict variance issues with `AnyPadroneProgram`.
  */
 type TestableProgram = {
-  eval: (input: string, prefs?: {
-    autoOutput?: boolean;
-  }) => any;
+  eval: (input: string, prefs?: Record<string, unknown>) => any;
   runtime: (runtime: PadroneRuntime) => TestableProgram;
   repl: (options?: {
     greeting?: false;
@@ -108,5 +105,5 @@ type TestableProgram = {
 };
 declare function testCli(program: TestableProgram): TestCliBuilder;
 //#endregion
-export { TestCliBuilder, TestCliResult, TestReplResult, testCli };
+export { type TestCliBuilder, type TestCliResult, type TestReplResult, testCli };
 //# sourceMappingURL=test.d.mts.map

package/dist/test.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.mts","names":[],"sources":["../src/test.ts"],"mappings":";;;;AAOA;;;KAAY,aAAA;EAEV,2BAAA,OAAA,EAAS,iBAAA,EAET;EAAA,IAAA,WAIA;EAFA,MAAA,WAE2B;EAA3B,MAAA;IAAU,OAAA;IAAiB,IAAA,GAAO,WAAA;EAAA,iBAM7B;EAJL,MAAA,aAUU;EARV,MAAA;EAEA,KAAA;AAAA;;;;KAMU,cAAA;EAMJ,wGAJN,OAAA,EAAS,IAAA,CAAK,aAAA,0BAUJ;EARV,MAAA;EAEA,MAAA;AAAA;;;;KAMU,cAAA;EAQI,mEANd,IAAA,CAAK,KAAA,WAAgB,cAAA,EAQA;EANrB,GAAA,CAAI,IAAA,EAAM,MAAA,+BAAqC,cAAA,EAW1B;EATrB,MAAA,CAAO,OAAA,EAAS,MAAA,oBAA0B,cAAA,EAelB;EAbxB,MAAA,CAAO,KAAA,EAAO,MAAA,SAAe,MAAA,qBAA2B,cAAA,EAazB;EAX/B,KAAA,CAAM,IAAA,WAAe,cAAA;EARhB;;;;EAaL,GAAA,CAAI,KAAA,YAAiB,OAAA,CAAQ,aAAA;EAXkB;;;;;EAiB/C,IAAA,CAAK,MAAA,aAAmB,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;;;;;;;AAChC;;;;;;;;;;;;;;;;;;;;;;;AA0DF;;;;;;;;;;;KANK,eAAA;EACH,IAAA,GAAO,KAAA,UAAe,KAAA;IAAU,UAAA;EAAA;EAChC,OAAA,GAAU,OAAA,EAAS,cAAA,KAAmB,eAAA;EACtC,IAAA,GAAO,OAAA;IAAY,QAAA;IAAkB,IAAA;EAAA,MAAmB,aAAA;AAAA;AAAA,iBAG1C,OAAA,CAAQ,OAAA,EAAS,eAAA,GAAkB,cAAA"}
+{"version":3,"file":"test.d.mts","names":[],"sources":["../src/feature/test.ts"],"mappings":";;;;AAOA;;;KAAY,aAAA;EAEV,2BAAA,OAAA,EAAS,iBAAA,EAET;EAAA,IAAA,WAIA;EAFA,MAAA,WAE2B;EAA3B,MAAA;IAAU,OAAA;IAAiB,IAAA,GAAO,WAAA;EAAA,iBAM7B;EAJL,MAAA,aAUU;EARV,MAAA;EAEA,KAAA;AAAA;;;;KAMU,cAAA;EAMJ,wGAJN,OAAA,EAAS,IAAA,CAAK,aAAA,0BAUJ;EARV,MAAA;EAEA,MAAA;AAAA;;;;KAMU,cAAA;EAamB,mEAX7B,IAAA,CAAK,KAAA,WAAgB,cAAA,EAiBW;EAfhC,GAAA,CAAI,IAAA,EAAM,MAAA,+BAAqC,cAAA,EAehB;EAb/B,MAAA,CAAO,OAAA,EAAS,MAAA,oBAA0B,cAAA,EAJ1C;EAMA,KAAA,CAAM,IAAA,WAAe,cAAA;EANA;;;;EAWrB,GAAA,CAAI,KAAA,YAAiB,OAAA,CAAQ,aAAA;EAP7B;;;;;EAaA,IAAA,CAAK,MAAA,aAAmB,OAAA,CAAQ,cAAA;AAAA;;;;;;;;;;;AAChC;;;;;;;;;;;;;;;;;;;;;;;;AA0DF;;;;;;;;;;;;;;;;KANK,eAAA;EACH,IAAA,GAAO,KAAA,UAAe,KAAA,GAAQ,MAAA;EAC9B,OAAA,GAAU,OAAA,EAAS,cAAA,KAAmB,eAAA;EACtC,IAAA,GAAO,OAAA;IAAY,QAAA;IAAkB,IAAA;EAAA,MAAmB,aAAA;AAAA;AAAA,iBAG1C,OAAA,CAAQ,OAAA,EAAS,eAAA,GAAkB,cAAA"}

package/dist/test.mjs

@@ -1,9 +1,8 @@
-//#region src/test.ts
+//#region src/feature/test.ts
 function testCli(program) {
 	let input;
 	let envVars;
 	let promptAnswers;
-	let configFiles;
 	let stdinData;
 	const builder = {
 		args(args) {
@@ -18,10 +17,6 @@ function testCli(program) {
 			promptAnswers = answers;
 			return builder;
 		},
-		config(files) {
-			configFiles = files;
-			return builder;
-		},
 		stdin(data) {
 			stdinData = data;
 			return builder;
@@ -32,24 +27,11 @@ function testCli(program) {
 			const runtime = buildRuntime(stdout, stderr, {
 				envVars,
 				promptAnswers,
-				configFiles,
 				stdinData
 			});
-			const testProgram = program.runtime(runtime);
-			try {
-				return toTestResult(await testProgram.eval(runInput ?? input ?? "", { autoOutput: false }), stdout, stderr);
-			} catch (err) {
-				stderr.push(err instanceof Error ? err.message : String(err));
-				return {
-					command: void 0,
-					args: void 0,
-					result: void 0,
-					issues: void 0,
-					stdout,
-					stderr,
-					error: err
-				};
-			}
+			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 = [];
@@ -57,7 +39,6 @@ function testCli(program) {
 			const runtime = buildRuntime(stdout, stderr, {
 				envVars,
 				promptAnswers,
-				configFiles,
 				readLine: createMockReadLine(inputs)
 			});
 			const testProgram = program.runtime(runtime);
@@ -85,6 +66,7 @@ function toTestResult(evalResult, stdout, stderr) {
 		command: evalResult.command,
 		args: evalResult.args,
 		result: evalResult.result,
+		error: evalResult.error,
 		issues: evalResult.argsResult?.issues,
 		stdout,
 		stderr
@@ -100,10 +82,6 @@ function buildRuntime(stdout, stderr, opts) {
 		runtime.interactive = "supported";
 		runtime.prompt = async (config) => opts.promptAnswers[config.name];
 	}
-	if (opts.configFiles) {
-		runtime.loadConfigFile = (path) => opts.configFiles[path];
-		runtime.findFile = (names) => names.find((n) => n in opts.configFiles);
-	}
 	if (opts.readLine) runtime.readLine = opts.readLine;
 	if (opts.stdinData !== void 0) runtime.stdin = {
 		isTTY: false,