@orkestrel/terminal 0.0.8 → 0.0.10

package/dist/src/core/index.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _orkestrel_console = require("@orkestrel/console");
 let _orkestrel_contract = require("@orkestrel/contract");
 let _orkestrel_emitter = require("@orkestrel/emitter");
+let _orkestrel_form = require("@orkestrel/form");
 let _orkestrel_sse = require("@orkestrel/sse");
 let _orkestrel_database = require("@orkestrel/database");
 //#region src/core/constants.ts
@@ -128,38 +129,9 @@ var CONTROL_NAMES = Object.freeze({
 		ctrl: true
 	})
 });
-/** The default mask glyph a {@link import('./types.js').PasswordState} renders each input character as — `*`. */
+/** The default mask glyph {@link import('./helpers.js').createPasswordState} uses — `*`. */
 var DEFAULT_MASK = "*";
 /**
-* Matches an HTTP(S) URL. The `url` rule tests against this. Kept locally because it is
-* narrower than `FORMAT_PATTERNS.uri`, which accepts other URI schemes.
-*/
-var URL_PATTERN = /^https?:\/\/.+/;
-/** Matches a numeric value (integer or decimal, optional sign). The `numeric` rule tests against this. */
-var NUMERIC_PATTERN = /^-?\d+(\.\d+)?$/;
-/** Matches an integer (optional sign). The `integer` rule tests against this. */
-var INTEGER_PATTERN = /^-?\d+$/;
-/** Matches an alphanumeric string (letters and digits only). The `alphanumeric` rule tests against this. */
-var ALPHANUMERIC_PATTERN = /^[a-zA-Z0-9]+$/;
-/**
-* Each built-in validation rule's default error message — what the composed {@link
-* import('./types.js').Validator} returns when that rule fails (the `minimum` / `maximum`
-* messages are interpolated with the configured length at build time). Frozen; the source of
-* truth for the rule-failure copy.
-*/
-var RULE_MESSAGES = Object.freeze({
-	required: "This field is required",
-	minimum: "Must be at least {count} characters",
-	maximum: "Must be at most {count} characters",
-	pattern: "Must match pattern: {pattern}",
-	email: "Must be a valid email address",
-	url: "Must be a valid URL",
-	numeric: "Must be a numeric value",
-	integer: "Must be an integer",
-	alphanumeric: "Must contain only letters and digits",
-	invalid: "Invalid input"
-});
-/**
 * The six default glyphs {@link DEFAULT_PROMPT_THEME} assembles its `icons` from. Read only when
 * the default theme is assembled; a view reads its resolved theme and never this constant. Frozen.
 *
@@ -255,11 +227,11 @@ var DEFAULT_PROMPT_TIMEOUT_MS = 3e5;
 /** How long (ms) the {@link import('./types.js').PromptClientInterface} waits before each reconnect attempt — 2 seconds. */
 var DEFAULT_RECONNECT_DELAY_MS = 2e3;
 /**
-* The SSE `event:` names the broker emits and the {@link import('./types.js').PromptClient}
+* The SSE `event:` names the broker emits and the {@link import('./types.js').PromptClientInterface}
 * dispatches on. Frozen; the source of truth for the wire event vocabulary.
 *
 * @remarks
-* - `pending` — a serialized {@link import('./types.js').PendingPrompt} to dispatch + answer.
+* - `pending` — a serialized {@link import('./types.js').PendingForm} to dispatch and answer.
 * - `expire` — an `{ id }` payload: the broker expired a parked prompt (the client drops it).
 * - `shutdown` — the broker is going away; the client disconnects (no auto-reconnect) but stays reusable.
 */
@@ -268,12 +240,12 @@ var SSE_EVENTS = Object.freeze({
 	expire: "expire",
 	shutdown: "shutdown"
 });
-/** The auth-token request header the {@link import('./types.js').PromptClient} sends when a `token` is configured. */
+/** The auth-token request header the {@link import('./types.js').PromptClientInterface} sends. */
 var HEADER_TOKEN = "x-orkestrel-token";
 /** The `Accept` header value that opens the broker's SSE stream. */
 var ACCEPT_EVENT_STREAM = "text/event-stream";
 /**
-* The maximum number of characters the {@link import('./types.js').PromptClient} lets its
+* The maximum number of characters the {@link import('./types.js').PromptClientInterface} lets its
 * SSE parser buffer before treating the stream as hostile — 1 MiB, comfortably above any
 * legitimate prompt payload. Passed as the `limit` to `createSSEParser` so an unterminated
 * or oversized `data:` field cannot grow the buffer without bound (a memory-exhaustion guard).
@@ -282,19 +254,20 @@ var SSE_BUFFER_LIMIT = 1048576;
 //#endregion
 //#region src/core/errors.ts
 /**
-* An error a {@link import('./Prompt.js').Prompt} broker rejects a parked prompt's Promise with.
+* The error the terminal surfaces for its own refusals: parking on a destroyed or full broker, an
+* unusable driver stream, a manager routing fault, or a ctrl-c cancellation. A parked form's own
+* lifecycle failures reject through the form's `answer` with the form package's error, never with
+* this one.
 *
 * @remarks
-* Carries a {@link TerminalErrorCode} and an optional `context` bag (the prompt `id`). Thrown —
-* as a Promise rejection on the awaited prompt call — when a parked prompt is not answered before
-* its `timeout`, or when the broker is `destroy`ed while the prompt is still `pending` (both
-* `EXPIRE`); or when the user aborts an interactive server-`Terminal` prompt with ctrl-c
-* (`CANCEL`). Narrow a caught value with {@link isTerminalError} and branch on `error.code`.
+* Carries a {@link TerminalErrorCode} and an optional `context` bag naming the offending values:
+* `{ cap }` on `LIMIT`, `{ to, known }` on `TARGET`, and `{ from, to, path }` on `DEADLOCK`. Narrow
+* a caught value with {@link isTerminalError} and branch on `error.code`.
 */
 var TerminalError = class extends Error {
 	/** The machine-readable condition — see {@link TerminalErrorCode}. */
 	code;
-	/** An optional context bag naming the offending prompt id. */
+	/** An optional context bag naming the offending values — see the class {@link TerminalError remarks}. */
 	context;
 	constructor(code, message, context) {
 		super(message);
@@ -312,9 +285,11 @@ var TerminalError = class extends Error {
 * @example
 * ```ts
 * try {
-* 	const name = await prompt.input({ message: 'Your name' })
+* 	await terminal.ask(form)
 * } catch (error) {
-* 	if (isTerminalError(error) && error.code === 'EXPIRE') retryLater()
+* 	if (isTerminalError(error) && error.code === 'CANCEL') {
+* 		// the person aborted
+* 	}
 * }
 * ```
 */
@@ -323,83 +298,39 @@ function isTerminalError(value) {
 }
 //#endregion
 //#region src/core/validators.ts
-/** Narrow an unknown value to a {@link PromptType} — one of the six prompt forms. */
-var isPromptType = (0, _orkestrel_contract.literalOf)("input", "password", "confirm", "select", "checkbox", "editor");
-/** Narrow an unknown value to a {@link PendingPromptStatus}. */
-var isPendingPromptStatus = (0, _orkestrel_contract.literalOf)("pending", "answered", "expired");
-/**
-* Narrow an unknown wire value to a {@link PendingPrompt} before dispatching it.
-*
-* @param value - The decoded wire value to inspect
-* @returns Whether `value` is a complete pending-prompt record
-*/
-var isPendingPrompt = (0, _orkestrel_contract.recordOf)({
-	id: _orkestrel_contract.isNonEmptyString,
-	form: isPromptType,
-	message: _orkestrel_contract.isString,
-	options: _orkestrel_contract.isRecord,
-	status: isPendingPromptStatus,
-	time: _orkestrel_contract.isNumber,
-	from: _orkestrel_contract.isString,
-	to: _orkestrel_contract.isString
-}, ["from", "to"]);
+/** Narrow an unknown value to a {@link PendingFormStatus}. */
+var isPendingFormStatus = (0, _orkestrel_contract.literalOf)("pending", "answered", "expired");
 /**
-* Narrow an unknown value to a console {@link Style} — the value every
-* {@link import('./types.js').PromptRole} carries, built from the console module's own
-* {@link import('@orkestrel/console').COLORS} + {@link import('@orkestrel/console').ATTRIBUTES} so
-* the style vocabulary has ONE source.
+* Narrow an unknown wire value to a {@link PendingForm} envelope.
 *
 * @remarks
-* The record is CLOSED and matches the `Style` contract exactly: `foreground` and `background` are
-* optional and each must name a color (`default` included, as the console `Color` union has it),
-* `attributes` is REQUIRED and must be an array over the attribute set, and any other key rejects
-* the whole value.
+* This guard checks the transport record and proves only that `schema` is a record. The Form
+* package's `parseForm` owns the schema payload and its semantic audit.
+*
+* @param value - The decoded wire value to inspect
+* @returns Whether the value is a complete pending-form envelope
 */
-var isStyle = (0, _orkestrel_contract.recordOf)({
-	foreground: (0, _orkestrel_contract.literalOf)(..._orkestrel_console.COLORS, "default"),
-	background: (0, _orkestrel_contract.literalOf)(..._orkestrel_console.COLORS, "default"),
-	attributes: (0, _orkestrel_contract.arrayOf)((0, _orkestrel_contract.literalOf)(..._orkestrel_console.ATTRIBUTES))
-}, ["foreground", "background"]);
+function isPendingForm(value) {
+	return (0, _orkestrel_contract.recordOf)({
+		id: _orkestrel_contract.isNonEmptyString,
+		schema: _orkestrel_contract.isRecord,
+		status: isPendingFormStatus,
+		time: _orkestrel_contract.isNumber,
+		from: _orkestrel_contract.isString,
+		to: _orkestrel_contract.isString
+	}, ["from", "to"])(value);
+}
 /**
-* Narrow an unknown wire value to a {@link PromptThemeOptions} — the §14 guard a remote prompt's
-* `theme` option passes before it reaches a local prompt.
+* Narrow an unknown value to a transport-neutral {@link WireEvent}.
 *
-* @remarks
-* The shape is CLOSED at every level: an unknown icon slot, an unknown role, a non-string glyph, or
-* a role whose value is not a {@link isStyle}-shaped console style rejects the whole theme, so a
-* hostile payload degrades to the default theme rather than partially applying. Glyphs still carry
-* arbitrary text at this point — {@link import('./helpers.js').sanitizeThemeIcons} strips their
-* control bytes on dispatch.
-*
-* The icons and roles shapes are checked against their complete union-keyed guard records. A slot
-* added to either union without an entry here is a compile error rather than a wire theme that is
-* silently refused.
+* @param value - The candidate wire event
+* @returns Whether the value carries an event name, serialized data, and an optional id
 */
-var isPromptThemeOptions = (0, _orkestrel_contract.recordOf)({
-	icons: (0, _orkestrel_contract.recordOf)({
-		question: _orkestrel_contract.isString,
-		pointer: _orkestrel_contract.isString,
-		dot: _orkestrel_contract.isString,
-		selected: _orkestrel_contract.isString,
-		checked: _orkestrel_contract.isString,
-		unchecked: _orkestrel_contract.isString,
-		success: _orkestrel_contract.isString,
-		error: _orkestrel_contract.isString
-	}, true),
-	roles: (0, _orkestrel_contract.recordOf)({
-		question: isStyle,
-		pointer: isStyle,
-		message: isStyle,
-		content: isStyle,
-		success: isStyle,
-		error: isStyle,
-		selected: isStyle,
-		focus: isStyle,
-		hint: isStyle,
-		description: isStyle,
-		muted: isStyle
-	}, true)
-}, true);
+var isWireEvent = (0, _orkestrel_contract.recordOf)({
+	event: _orkestrel_contract.isString,
+	data: _orkestrel_contract.isString,
+	id: _orkestrel_contract.isString
+}, ["id"]);
 /** Narrow an unknown value to a {@link TerminalSnapshot}. */
 var isTerminalSnapshot = (0, _orkestrel_contract.recordOf)({
 	id: _orkestrel_contract.isNonEmptyString,
@@ -480,156 +411,6 @@ function isPrintable(character) {
 	return code >= 32 && code !== 127;
 }
 /**
-* Evaluate ONE built-in validation rule against `input`, returning its error message when the
-* rule fails or `undefined` when it passes. The atomic check {@link buildRuleValidator} wraps
-* into a {@link Validator}. Pure.
-*
-* @remarks
-* A function `check` is the custom-override path: it is called and its `true` ⇒ pass, a string
-* ⇒ that message, anything else ⇒ the generic {@link RULE_MESSAGES.invalid}. A primitive `check`
-* runs the named built-in: `required` (non-empty trimmed), `minimum` / `maximum` (length
-* bounds, the message interpolated with the count), `pattern` (a regex source), and the
-* `email` / `url` / `numeric` / `integer` / `alphanumeric` pattern tests.
-*
-* @param rule - The rule name (`'required'`, `'minimum'`, …)
-* @param check - The configured value (a primitive toggle / bound / pattern, or a custom {@link Validator})
-* @param input - The input string to test
-* @returns The error message when the rule fails, else `undefined`
-*/
-function evaluateRule(rule, check, input) {
-	if (typeof check === "function") {
-		const result = check(input);
-		if (result === true) return void 0;
-		return (0, _orkestrel_contract.isString)(result) ? result : RULE_MESSAGES.invalid;
-	}
-	switch (rule) {
-		case "required":
-			if (check === true && input.trim().length === 0) return RULE_MESSAGES.required;
-			break;
-		case "minimum":
-			if ((0, _orkestrel_contract.isNumber)(check) && [...input].length < check) return RULE_MESSAGES.minimum.replace("{count}", String(check));
-			break;
-		case "maximum":
-			if ((0, _orkestrel_contract.isNumber)(check) && [...input].length > check) return RULE_MESSAGES.maximum.replace("{count}", String(check));
-			break;
-		case "pattern":
-			if ((0, _orkestrel_contract.isString)(check)) {
-				let compiled;
-				try {
-					compiled = new RegExp(check);
-				} catch {
-					return RULE_MESSAGES.pattern.replace("{pattern}", check);
-				}
-				if (!compiled.test(input)) return RULE_MESSAGES.pattern.replace("{pattern}", check);
-			}
-			break;
-		case "email":
-			if (check === true && !_orkestrel_contract.FORMAT_PATTERNS.email.test(input)) return RULE_MESSAGES.email;
-			break;
-		case "url":
-			if (check === true && !URL_PATTERN.test(input)) return RULE_MESSAGES.url;
-			break;
-		case "numeric":
-			if (check === true && !NUMERIC_PATTERN.test(input)) return RULE_MESSAGES.numeric;
-			break;
-		case "integer":
-			if (check === true && !INTEGER_PATTERN.test(input)) return RULE_MESSAGES.integer;
-			break;
-		case "alphanumeric":
-			if (check === true && !ALPHANUMERIC_PATTERN.test(input)) return RULE_MESSAGES.alphanumeric;
-			break;
-	}
-}
-/** Wrap a named rule + its primitive check into a {@link Validator} (returns `true` or the rule's message). */
-function buildRuleValidator(rule, check) {
-	return (input) => evaluateRule(rule, check, input) ?? true;
-}
-/**
-* Append a rule-backed {@link Validator} to `validators` when the rule is enabled — a `false` /
-* `undefined` `check` is skipped, a function `check` is added verbatim (the custom override), and
-* a primitive `check` is wrapped via {@link buildRuleValidator}. Mutates `validators` in place.
-*/
-function appendRule(validators, rule, check) {
-	if (check === void 0 || check === false) return;
-	if (typeof check === "function") {
-		validators.push(check);
-		return;
-	}
-	validators.push(buildRuleValidator(rule, check));
-}
-/**
-* Compose several {@link Validator}s into ONE short-circuiting validator — it runs them in order
-* and returns the FIRST error message, or `true` when all pass. The empty composition always
-* passes.
-*/
-function composeValidators(...validators) {
-	return (input) => {
-		for (const validator of validators) {
-			const result = validator(input);
-			if (result !== true) return result;
-		}
-		return true;
-	};
-}
-/**
-* Compile a {@link Validator} or declarative {@link ValidationRules} (or nothing) into ONE
-* composed {@link Validator}. A bare validator passes through; rules are appended in the fixed
-* order (required → minimum → maximum → pattern → email → url → numeric → integer → alphanumeric
-* → custom) and composed; absent / empty input yields an always-passing validator. Pure.
-*
-* @remarks
-* Unlike a prior variant (which returned `Validator | undefined`), this ALWAYS returns a
-* `Validator` — an absent or empty rule set yields a validator that returns `true` for every
-* input. That keeps a prompt's state unconditional (it always holds a real validator to apply on
-* submit), with no `undefined` branch at the call site.
-*
-* @param validate - A custom {@link Validator}, a {@link ValidationRules} bag, or `undefined`
-* @returns The composed {@link Validator} (always-passing when nothing was supplied)
-*
-* @example
-* ```ts
-* const v = resolveValidation({ required: true, minimum: 3 })
-* v('')    // 'This field is required'
-* v('ab')  // 'Must be at least 3 characters'
-* v('abc') // true
-* ```
-*/
-function resolveValidation(validate) {
-	if (validate === void 0) return passing;
-	if (typeof validate === "function") return validate;
-	const validators = [];
-	appendRule(validators, "required", validate.required);
-	appendRule(validators, "minimum", validate.minimum);
-	appendRule(validators, "maximum", validate.maximum);
-	appendRule(validators, "pattern", validate.pattern);
-	appendRule(validators, "email", validate.email);
-	appendRule(validators, "url", validate.url);
-	appendRule(validators, "numeric", validate.numeric);
-	appendRule(validators, "integer", validate.integer);
-	appendRule(validators, "alphanumeric", validate.alphanumeric);
-	if (typeof validate.custom === "function") validators.push(validate.custom);
-	if (validators.length === 0) return passing;
-	return composeValidators(...validators);
-}
-/** The always-passing {@link Validator} — the resolved validator when no rules were supplied. */
-function passing(_input) {
-	return true;
-}
-/** Normalize a select choice input into a full {@link PromptChoice} (a bare string becomes both name and value). */
-function normalizeChoice(choice) {
-	return (0, _orkestrel_contract.isString)(choice) ? {
-		name: choice,
-		value: choice
-	} : choice;
-}
-/** Normalize a checkbox choice input into a full {@link CheckboxChoice} (a bare string becomes both name and value). */
-function normalizeCheckboxChoice(choice) {
-	return (0, _orkestrel_contract.isString)(choice) ? {
-		name: choice,
-		value: choice
-	} : choice;
-}
-/**
 * Build a complete {@link PromptTheme} by merging a partial one over
 * {@link DEFAULT_PROMPT_THEME}, leaf by leaf — each supplied icon replaces that glyph, each
 * supplied role replaces that {@link Style}, and everything else keeps its default. Each supplied
@@ -665,11 +446,11 @@ function createPromptTheme(options) {
 	});
 }
 /**
-* Sanitize text for one single-line display slot. Composes console's {@link stripControls} pass
-* with removal of tab, line feed, and carriage return, so no C0 control or DEL survives.
+* Sanitize text for one single-line display slot. Composes console's ANSI {@link strip} and C0
+* {@link stripControls} passes with removal of tab, line feed, and carriage return.
 *
 * @param text - The text to sanitize for a glyph or hint slot
-* @returns The text with every C0 control character and DEL removed
+* @returns The text with ANSI sequences, every C0 control character, and DEL removed
 *
 * @example
 * ```ts
@@ -677,7 +458,126 @@ function createPromptTheme(options) {
 * ```
 */
 function sanitizeDisplayText(text) {
-	return (0, _orkestrel_console.stripControls)(text).replaceAll("	", "").replaceAll("\n", "").replaceAll("\r", "");
+	return (0, _orkestrel_console.stripControls)((0, _orkestrel_console.strip)(text)).replaceAll("	", "").replaceAll("\n", "").replaceAll("\r", "");
+}
+/**
+* Sanitize every terminal-readable string in a parsed form schema.
+*
+* @remarks
+* Display strings pass through {@link sanitizeDisplayText}: labels, help, placeholders, masks,
+* choice labels and help, file accept entries, and pattern sources. Identity and answer strings
+* stay verbatim: schema, group, and field names, group references, choice values, and defaults.
+* Rewriting those would sever the rendering copy from the authoritative form. Field metadata is
+* removed because terminal neither renders nor interprets it. Pattern sources are sanitized as
+* text only and are never compiled or executed here.
+*
+* @param schema - A schema already accepted by the Form package's `parseForm`
+* @returns A new schema with terminal-readable strings sanitized and field metadata omitted
+*
+* @example
+* ```ts
+* sanitizeSchema({ fields: [{ control: 'text', name: 'na\u001bme', label: 'N\u0000ame' }] })
+* // { fields: [{ control: 'text', name: 'na\u001bme', label: 'Name' }] }
+* ```
+*/
+function sanitizeSchema(schema) {
+	const groups = schema.groups?.map((group) => ({
+		name: group.name,
+		label: sanitizeDisplayText(group.label),
+		...group.help !== void 0 ? { help: sanitizeDisplayText(group.help) } : {}
+	}));
+	const fields = [];
+	for (const source of schema.fields) {
+		const { meta: _meta, ...field } = source;
+		const rule = field.rule === void 0 ? void 0 : {
+			...field.rule,
+			...field.rule.pattern !== void 0 ? { pattern: sanitizeDisplayText(field.rule.pattern) } : {}
+		};
+		const shared = {
+			name: field.name,
+			...field.label !== void 0 ? { label: sanitizeDisplayText(field.label) } : {},
+			...field.help !== void 0 ? { help: sanitizeDisplayText(field.help) } : {},
+			...field.group !== void 0 ? { group: field.group } : {},
+			...rule !== void 0 ? { rule } : {}
+		};
+		switch (field.control) {
+			case "text":
+			case "editor":
+				fields.push({
+					...field,
+					...shared,
+					...field.placeholder !== void 0 ? { placeholder: sanitizeDisplayText(field.placeholder) } : {}
+				});
+				break;
+			case "password":
+				fields.push({
+					...field,
+					...shared,
+					...field.mask !== void 0 ? { mask: sanitizeDisplayText(field.mask) } : {}
+				});
+				break;
+			case "number":
+				fields.push({
+					...field,
+					...shared,
+					...field.placeholder !== void 0 ? { placeholder: sanitizeDisplayText(field.placeholder) } : {}
+				});
+				break;
+			case "date":
+			case "time":
+			case "datetime":
+			case "color":
+				fields.push({
+					...field,
+					...shared
+				});
+				break;
+			case "confirm":
+				fields.push({
+					...field,
+					...shared
+				});
+				break;
+			case "select":
+				fields.push({
+					...field,
+					...shared,
+					choices: field.choices.map((choice) => ({
+						...choice,
+						value: choice.value,
+						label: sanitizeDisplayText(choice.label),
+						...choice.help !== void 0 ? { help: sanitizeDisplayText(choice.help) } : {}
+					}))
+				});
+				break;
+			case "checkbox":
+				fields.push({
+					...field,
+					...shared,
+					choices: field.choices.map((choice) => ({
+						...choice,
+						value: choice.value,
+						label: sanitizeDisplayText(choice.label),
+						...choice.help !== void 0 ? { help: sanitizeDisplayText(choice.help) } : {}
+					}))
+				});
+				break;
+			case "file":
+				fields.push({
+					...field,
+					...shared,
+					...field.accept !== void 0 ? { accept: field.accept.map(sanitizeDisplayText) } : {}
+				});
+				break;
+		}
+	}
+	return {
+		...schema.name !== void 0 ? { name: schema.name } : {},
+		...schema.label !== void 0 ? { label: sanitizeDisplayText(schema.label) } : {},
+		...schema.help !== void 0 ? { help: sanitizeDisplayText(schema.help) } : {},
+		...groups !== void 0 ? { groups } : {},
+		fields
+	};
 }
 /**
 * Sanitize every glyph a wire-supplied {@link PromptThemeOptions} carries for a single-line display
@@ -719,32 +619,38 @@ function hintedHeader(styler, theme, message, hint) {
 function submitHeader(styler, theme, message) {
 	return `${styler.render(theme.roles.success, theme.icons.success)} ${styler.render(theme.roles.message, message)}`;
 }
-/** The styled error line (`✖ message`) — appended beneath a prompt view when the last submit failed validation, themed by the `error` role. */
+/** The styled error line (`✖ message`) a form driver appends for a field failure. */
 function errorLine(styler, theme, message) {
 	return `${styler.render(theme.roles.error, theme.icons.error)} ${styler.render(theme.roles.error, message)}`;
 }
-/** Build the initial {@link InputState} from {@link InputOptions} — resolving the validator + styler + theme, seeding an empty value. */
-function createInputState(options) {
+/**
+* Build the initial text-field key state.
+*
+* @param field - The text field to render
+* @param styler - The styler used to render the view
+* @param theme - The optional terminal theme
+* @returns The initial immutable key state
+*/
+function createInputState(field, styler = (0, _orkestrel_console.createStyler)(), theme) {
 	return {
-		message: options.message,
-		default: options.default ?? "",
-		validator: resolveValidation(options.validate),
-		styler: options.styler ?? (0, _orkestrel_console.createStyler)(),
-		theme: createPromptTheme(options.theme),
+		message: sanitizeDisplayText(field.label ?? field.name),
+		default: field.default ?? "",
+		styler,
+		theme: createPromptTheme(theme),
 		value: ""
 	};
 }
-/** Render an {@link InputState} as a styled view — the header, the typed value painted by the `content` role (or the default painted as a hint), and any error. */
+/** Render a text-field key state as a styled view. */
 function inputView(state) {
-	const shown = state.value.length > 0 ? state.styler.render(state.theme.roles.content, state.value) : state.styler.render(state.theme.roles.hint, state.default);
-	const head = `${promptHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer)} ${shown}`;
-	return state.error === void 0 ? head : `${head}\n${errorLine(state.styler, state.theme, state.error)}`;
+	const content = state.value.length > 0 ? state.value : state.default;
+	const role = state.value.length > 0 ? state.theme.roles.content : state.theme.roles.hint;
+	const shown = state.styler.render(role, sanitizeDisplayText(content));
+	return `${promptHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer)} ${shown}`;
 }
 /**
 * Advance an input prompt by one {@link KeyEvent} — the pure `(state, key) → PromptStep<string>`
 * reducer. Printable characters extend the value; backspace shrinks it; ctrl-u clears it; ctrl-c
-* cancels; return submits (the empty line falls back to the default) through the validator — an
-* invalid submit stays active with the error in the view.
+* cancels; return produces the candidate value, with an empty line falling back to the default.
 */
 function inputReduce(state, key) {
 	if (key.ctrl && key.name === "c") return {
@@ -752,27 +658,14 @@ function inputReduce(state, key) {
 		view: inputView(state),
 		status: "cancel"
 	};
-	const { error: _error, ...clear } = state;
 	if (key.name === "return") {
 		const answer = state.value.length > 0 ? state.value : state.default;
-		const result = state.validator(answer);
-		if (result !== true) {
-			const next = {
-				...state,
-				error: result
-			};
-			return {
-				state: next,
-				view: inputView(next),
-				status: "active"
-			};
-		}
 		return {
 			state: {
-				...clear,
+				...state,
 				value: answer
 			},
-			view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, answer)}`,
+			view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, sanitizeDisplayText(answer))}`,
 			status: "submit",
 			value: answer
 		};
@@ -784,7 +677,7 @@ function inputReduce(state, key) {
 		status: "active"
 	};
 	const next = {
-		...clear,
+		...state,
 		value
 	};
 	return {
@@ -793,28 +686,32 @@ function inputReduce(state, key) {
 		status: "active"
 	};
 }
-/** Build the initial {@link PasswordState} from {@link PasswordOptions} — resolving the validator + styler + theme + mask. */
-function createPasswordState(options) {
+/**
+* Build the initial password-field key state.
+*
+* @param field - The password field to render
+* @param styler - The styler used to render the view
+* @param theme - The optional terminal theme
+* @returns The initial immutable key state
+*/
+function createPasswordState(field, styler = (0, _orkestrel_console.createStyler)(), theme) {
 	return {
-		message: options.message,
-		mask: options.mask ?? "*",
-		validator: resolveValidation(options.validate),
-		styler: options.styler ?? (0, _orkestrel_console.createStyler)(),
-		theme: createPromptTheme(options.theme),
+		message: sanitizeDisplayText(field.label ?? field.name),
+		mask: sanitizeDisplayText(field.mask ?? "*"),
+		styler,
+		theme: createPromptTheme(theme),
 		value: ""
 	};
 }
-/** Render a {@link PasswordState} as a styled view — the header, the value masked to `mask` repeated and painted by the `content` role, and any error. */
+/** Render a password-field key state as a styled view. */
 function passwordView(state) {
 	const masked = state.styler.render(state.theme.roles.content, state.mask.repeat(state.value.length));
-	const head = `${promptHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer)} ${masked}`;
-	return state.error === void 0 ? head : `${head}\n${errorLine(state.styler, state.theme, state.error)}`;
+	return `${promptHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer)} ${masked}`;
 }
 /**
 * Advance a password prompt by one {@link KeyEvent} — the pure `(state, key) → PromptStep<string>`
 * reducer. Identical line-editing to {@link inputReduce} (printable extends, backspace shrinks,
-* ctrl-u clears, ctrl-c cancels) but the view masks the value; return submits through the
-* validator (no default fallback — a password has no echoed default).
+* ctrl-u clears, ctrl-c cancels) but the view masks the value. Return produces the candidate value.
 */
 function passwordReduce(state, key) {
 	if (key.ctrl && key.name === "c") return {
@@ -822,27 +719,12 @@ function passwordReduce(state, key) {
 		view: passwordView(state),
 		status: "cancel"
 	};
-	const { error: _error, ...clear } = state;
-	if (key.name === "return") {
-		const result = state.validator(state.value);
-		if (result !== true) {
-			const next = {
-				...state,
-				error: result
-			};
-			return {
-				state: next,
-				view: passwordView(next),
-				status: "active"
-			};
-		}
-		return {
-			state: clear,
-			view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, state.mask.repeat(state.value.length))}`,
-			status: "submit",
-			value: state.value
-		};
-	}
+	if (key.name === "return") return {
+		state,
+		view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, state.mask.repeat(state.value.length))}`,
+		status: "submit",
+		value: state.value
+	};
 	const value = editLine(state.value, key);
 	if (value === void 0) return {
 		state,
@@ -850,7 +732,7 @@ function passwordReduce(state, key) {
 		status: "active"
 	};
 	const next = {
-		...clear,
+		...state,
 		value
 	};
 	return {
@@ -859,23 +741,26 @@ function passwordReduce(state, key) {
 		status: "active"
 	};
 }
-/** Build the initial {@link ConfirmState} from {@link ConfirmOptions} — defaulting the answer to `false`, resolving the styler + theme, carrying any hint override. */
-function createConfirmState(options) {
+/**
+* Build the initial confirm-field key state.
+*
+* @param field - The confirm field to render
+* @param styler - The styler used to render the view
+* @param theme - The optional terminal theme
+* @returns The initial immutable key state
+*/
+function createConfirmState(field, styler = (0, _orkestrel_console.createStyler)(), theme) {
 	return {
-		message: options.message,
-		default: options.default ?? false,
-		...options.hint !== void 0 ? { hint: options.hint } : {},
-		styler: options.styler ?? (0, _orkestrel_console.createStyler)(),
-		theme: createPromptTheme(options.theme)
+		message: sanitizeDisplayText(field.label ?? field.name),
+		default: field.default ?? false,
+		styler,
+		theme: createPromptTheme(theme)
 	};
 }
 /**
-* Render a {@link ConfirmState} as a styled view — the header plus the `(Y/n)` group with the
-* default letter painted by the `selected` role. A supplied `hint` replaces that whole group,
-* parentheses included, painted by the `hint` role.
+* Render a confirm-field key state as a styled view. The selected role paints the default letter.
 */
 function confirmView(state) {
-	if (state.hint !== void 0) return hintedHeader(state.styler, state.theme, state.message, state.hint);
 	const head = promptHeader(state.styler, state.theme, state.message);
 	const answer = state.default ? `${state.styler.render(state.theme.roles.selected, "Y")}${state.styler.render(state.theme.roles.hint, "/n")}` : `${state.styler.render(state.theme.roles.hint, "y/")}${state.styler.render(state.theme.roles.selected, "N")}`;
 	return `${head} ${state.styler.render(state.theme.roles.hint, "(")}${answer}${state.styler.render(state.theme.roles.hint, ")")}`;
@@ -908,26 +793,32 @@ function confirmReduce(state, key) {
 		value: answer
 	};
 }
-/** Build the initial {@link SelectState} from {@link SelectOptions} — normalizing choices, resolving the styler + theme, carrying any hint, and pre-focusing the default. */
-function createSelectState(options) {
-	const choices = options.choices.map(normalizeChoice);
-	const index = choices.findIndex((choice) => choice.value === options.default);
+/**
+* Build the initial select-field key state.
+*
+* @param field - The select field to render
+* @param styler - The styler used to render the view
+* @param theme - The optional terminal theme
+* @returns The initial immutable key state
+*/
+function createSelectState(field, styler = (0, _orkestrel_console.createStyler)(), theme) {
+	const choices = [...field.choices];
+	const index = choices.findIndex((choice) => choice.value === field.default);
 	return {
-		message: options.message,
+		message: sanitizeDisplayText(field.label ?? field.name),
 		choices,
-		...options.hint !== void 0 ? { hint: options.hint } : {},
-		styler: options.styler ?? (0, _orkestrel_console.createStyler)(),
-		theme: createPromptTheme(options.theme),
+		styler,
+		theme: createPromptTheme(theme),
 		focused: index >= 0 ? index : 0
 	};
 }
-/** Render a {@link SelectState} as a MULTI-LINE styled view — the header (plus any hint) followed by one row per choice, the focused row marked. */
+/** Render a select-field key state as a multi-line styled view. */
 function selectView(state) {
 	const lines = state.choices.map((choice, index) => {
 		const active = index === state.focused;
-		return `${active ? state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer) : " "} ${active ? state.styler.render(state.theme.roles.selected, state.theme.icons.selected) : state.styler.render(state.theme.roles.muted, state.theme.icons.dot)} ${active ? state.styler.render(state.theme.roles.focus, choice.name) : state.styler.render(state.theme.roles.content, choice.name)}${choice.description === void 0 ? "" : `  ${state.styler.render(state.theme.roles.description, choice.description)}`}`;
+		return `${active ? state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer) : " "} ${active ? state.styler.render(state.theme.roles.selected, state.theme.icons.selected) : state.styler.render(state.theme.roles.muted, state.theme.icons.dot)} ${active ? state.styler.render(state.theme.roles.focus, choice.label) : state.styler.render(state.theme.roles.content, choice.label)}${choice.help === void 0 ? "" : `  ${state.styler.render(state.theme.roles.description, choice.help)}`}`;
 	});
-	return [hintedHeader(state.styler, state.theme, state.message, state.hint), ...lines].join("\n");
+	return [promptHeader(state.styler, state.theme, state.message), ...lines].join("\n");
 }
 /**
 * Advance a select prompt by one {@link KeyEvent} — the pure `(state, key) → PromptStep<string>`
@@ -974,7 +865,7 @@ function selectReduce(state, key) {
 		const value = choice?.value ?? "";
 		return {
 			state,
-			view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, choice?.name ?? "")}`,
+			view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, choice?.label ?? "")}`,
 			status: "submit",
 			value
 		};
@@ -985,46 +876,48 @@ function selectReduce(state, key) {
 		status: "active"
 	};
 }
-/** Build the initial {@link CheckboxState} from {@link CheckboxOptions} — normalizing choices, resolving the styler + theme, carrying any hint, seeding the checked set, carrying min/max. */
-function createCheckboxState(options) {
-	const choices = options.choices.map(normalizeCheckboxChoice);
+/**
+* Build the initial checkbox-field key state.
+*
+* @param field - The checkbox field to render
+* @param styler - The styler used to render the view
+* @param theme - The optional terminal theme
+* @returns The initial immutable key state
+*/
+function createCheckboxState(field, styler = (0, _orkestrel_console.createStyler)(), theme) {
+	const choices = [...field.choices];
 	const checked = choices.reduce((indices, choice, index) => {
-		if (choice.checked === true) indices.push(index);
+		if (field.default?.includes(choice.value) === true) indices.push(index);
 		return indices;
 	}, []);
 	return {
-		message: options.message,
+		message: sanitizeDisplayText(field.label ?? field.name),
 		choices,
-		...options.hint !== void 0 ? { hint: options.hint } : {},
-		styler: options.styler ?? (0, _orkestrel_console.createStyler)(),
-		theme: createPromptTheme(options.theme),
+		styler,
+		theme: createPromptTheme(theme),
 		focused: 0,
-		checked,
-		...options.min !== void 0 ? { min: options.min } : {},
-		...options.max !== void 0 ? { max: options.max } : {}
+		checked
 	};
 }
-/** Render a {@link CheckboxState} as a MULTI-LINE styled view — the header (plus any hint), one box per choice (focused + checked marked), a count, and any error. */
+/** Render a checkbox-field key state as a multi-line styled view. */
 function checkboxView(state) {
 	const lines = state.choices.map((choice, index) => {
 		const active = index === state.focused;
 		const ticked = state.checked.includes(index);
-		return `${active ? state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer) : " "} ${ticked ? state.styler.render(state.theme.roles.selected, state.theme.icons.checked) : state.styler.render(state.theme.roles.muted, state.theme.icons.unchecked)} ${active ? state.styler.render(state.theme.roles.focus, choice.name) : state.styler.render(state.theme.roles.content, choice.name)}${choice.description === void 0 ? "" : `  ${state.styler.render(state.theme.roles.description, choice.description)}`}`;
+		return `${active ? state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer) : " "} ${ticked ? state.styler.render(state.theme.roles.selected, state.theme.icons.checked) : state.styler.render(state.theme.roles.muted, state.theme.icons.unchecked)} ${active ? state.styler.render(state.theme.roles.focus, choice.label) : state.styler.render(state.theme.roles.content, choice.label)}${choice.help === void 0 ? "" : `  ${state.styler.render(state.theme.roles.description, choice.help)}`}`;
 	});
 	const summary = state.styler.render(state.theme.roles.hint, `${state.checked.length} selected`);
-	const body = [
-		hintedHeader(state.styler, state.theme, state.message, state.hint),
+	return [
+		promptHeader(state.styler, state.theme, state.message),
 		...lines,
 		summary
 	].join("\n");
-	return state.error === void 0 ? body : `${body}\n${errorLine(state.styler, state.theme, state.error)}`;
 }
 /**
 * Advance a checkbox prompt by one {@link KeyEvent} — the pure
 * `(state, key) → PromptStep<readonly string[]>` reducer. `up` / `down` (and `k` / `j`) move the
 * focus (wrapping); `space` toggles the focused index in the checked set; return submits the
-* checked values in CHOICE order — gated by `min` / `max` (an out-of-range count stays active with
-* the reason in the view); ctrl-c cancels.
+* checked values in choice order; ctrl-c cancels. The form applies selection-count rules.
 */
 function checkboxReduce(state, key) {
 	if (key.ctrl && key.name === "c") return {
@@ -1033,10 +926,9 @@ function checkboxReduce(state, key) {
 		status: "cancel"
 	};
 	const count = state.choices.length;
-	const { error: _error, ...clear } = state;
 	if ((key.name === "up" || key.name === "k") && count > 0) {
 		const next = {
-			...clear,
+			...state,
 			focused: (state.focused - 1 + count) % count
 		};
 		return {
@@ -1047,7 +939,7 @@ function checkboxReduce(state, key) {
 	}
 	if ((key.name === "down" || key.name === "j") && count > 0) {
 		const next = {
-			...clear,
+			...state,
 			focused: (state.focused + 1) % count
 		};
 		return {
@@ -1059,7 +951,7 @@ function checkboxReduce(state, key) {
 	if (key.name === "space" && count > 0) {
 		const checked = toggleIndex(state.checked, state.focused);
 		const next = {
-			...clear,
+			...state,
 			checked
 		};
 		return {
@@ -1069,23 +961,11 @@ function checkboxReduce(state, key) {
 		};
 	}
 	if (key.name === "return") {
-		const error = gateSelection(state.checked.length, state.min, state.max);
-		if (error !== void 0) {
-			const next = {
-				...state,
-				error
-			};
-			return {
-				state: next,
-				view: checkboxView(next),
-				status: "active"
-			};
-		}
 		const ordered = [...state.checked].sort((a, b) => a - b);
 		const values = ordered.map((index) => state.choices[index]?.value).filter((value) => value !== void 0);
-		const summary = ordered.map((index) => state.choices[index]?.name).filter((name) => name !== void 0).join(", ");
+		const summary = ordered.map((index) => state.choices[index]?.label).filter((name) => name !== void 0).join(", ");
 		return {
-			state: clear,
+			state,
 			view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, summary)}`,
 			status: "submit",
 			value: values
@@ -1101,41 +981,37 @@ function checkboxReduce(state, key) {
 function toggleIndex(indices, index) {
 	return indices.includes(index) ? indices.filter((i) => i !== index) : [...indices, index];
 }
-/** The min/max gate for a checkbox submit — the rejection message when `count` is out of range, else `undefined`. */
-function gateSelection(count, min, max) {
-	if (min !== void 0 && count < min) return `Select at least ${String(min)} option${min === 1 ? "" : "s"}`;
-	if (max !== void 0 && count > max) return `Select no more than ${String(max)} option${max === 1 ? "" : "s"}`;
-}
-/** Build the initial {@link EditorState} from {@link EditorOptions} — resolving the validator + styler + theme, carrying any hint override, seeding empty lines. */
-function createEditorState(options) {
+/**
+* Build the initial editor-field key state.
+*
+* @param field - The editor field to render
+* @param styler - The styler used to render the view
+* @param theme - The optional terminal theme
+* @returns The initial immutable key state
+*/
+function createEditorState(field, styler = (0, _orkestrel_console.createStyler)(), theme) {
 	return {
-		message: options.message,
-		default: options.default ?? "",
-		...options.hint !== void 0 ? { hint: options.hint } : {},
-		validator: resolveValidation(options.validate),
-		styler: options.styler ?? (0, _orkestrel_console.createStyler)(),
-		theme: createPromptTheme(options.theme),
+		message: sanitizeDisplayText(field.label ?? field.name),
+		default: field.default ?? "",
+		styler,
+		theme: createPromptTheme(theme),
 		lines: [],
 		current: ""
 	};
 }
 /**
-* Render an {@link EditorState} as a MULTI-LINE styled view — the header with its finish hint, the
-* committed and in-progress lines painted by the `content` role, and any error. A supplied `hint`
-* replaces `(Ctrl+D to finish)` in full; the finish key stays ctrl-d.
+* Render an editor-field key state as a multi-line styled view with its finish hint.
 */
 function editorView(state) {
-	const head = hintedHeader(state.styler, state.theme, state.message, state.hint ?? "(Ctrl+D to finish)");
+	const head = hintedHeader(state.styler, state.theme, state.message, "(Ctrl+D to finish)");
 	const pointer = state.styler.render(state.theme.roles.pointer, state.theme.icons.pointer);
-	const view = [head, ...[...state.lines.map((line) => state.styler.render(state.theme.roles.content, line)), `${pointer} ${state.styler.render(state.theme.roles.content, state.current)}`]].join("\n");
-	return state.error === void 0 ? view : `${view}\n${errorLine(state.styler, state.theme, state.error)}`;
+	return [head, ...[...state.lines.map((line) => state.styler.render(state.theme.roles.content, line)), `${pointer} ${state.styler.render(state.theme.roles.content, state.current)}`]].join("\n");
 }
 /**
 * Advance an editor prompt by one {@link KeyEvent} — the pure `(state, key) → PromptStep<string>`
 * reducer. Printable characters extend the current line; backspace shrinks it; return commits the
 * current line and starts a fresh one; ctrl-d FINISHES (joining all lines, falling back to the
-* default when empty) through the validator; ctrl-c cancels. An invalid finish stays active with
-* the error.
+* default when empty); ctrl-c cancels. The form validates the candidate after the driver fills it.
 */
 function editorReduce(state, key) {
 	if (key.ctrl && key.name === "c") return {
@@ -1143,25 +1019,12 @@ function editorReduce(state, key) {
 		view: editorView(state),
 		status: "cancel"
 	};
-	const { error: _error, ...clear } = state;
 	if (key.ctrl && key.name === "d") {
 		const lines = state.current.length > 0 ? [...state.lines, state.current] : state.lines;
 		const joined = lines.join("\n");
 		const answer = joined.length > 0 ? joined : state.default;
-		const result = state.validator(answer);
-		if (result !== true) {
-			const next = {
-				...state,
-				error: result
-			};
-			return {
-				state: next,
-				view: editorView(next),
-				status: "active"
-			};
-		}
 		return {
-			state: clear,
+			state,
 			view: `${submitHeader(state.styler, state.theme, state.message)} ${state.styler.render(state.theme.roles.hint, `${String(lines.length)} line${lines.length === 1 ? "" : "s"}`)}`,
 			status: "submit",
 			value: answer
@@ -1169,7 +1032,7 @@ function editorReduce(state, key) {
 	}
 	if (key.name === "return") {
 		const next = {
-			...clear,
+			...state,
 			lines: [...state.lines, state.current],
 			current: ""
 		};
@@ -1186,7 +1049,7 @@ function editorReduce(state, key) {
 		status: "active"
 	};
 	const next = {
-		...clear,
+		...state,
 		current
 	};
 	return {
@@ -1208,227 +1071,6 @@ function editLine(value, key) {
 	if (!key.ctrl && !key.meta && [...key.name].length === 1 && isPrintable(key.name)) return `${value}${key.sequence}`;
 }
 /**
-* Produce the WIRE-SAFE form of a prompt's options — the {@link PendingPrompt.options} a broker
-* serializes over SSE. Drops everything that cannot cross the wire (a `styler`, and any
-* function-valued `validate` rule), while KEEPING the declarative data a remote client needs to
-* reconstruct the prompt: the {@link ValidationRules} as data, plus `message` / `choices` /
-* `default` / `mask` / `min` / `max` / `hint` / `theme`. This is WHY T-a's validation is
-* rules-as-data, and why a theme is data too: a `Validator`
-* FUNCTION can't be serialized, but its declarative rules can — the client rebuilds the validator
-* from them via {@link resolveValidation}.
-*
-* @remarks
-* - **Functions are dropped.** A top-level function value (e.g. a bare-`Validator` `validate`) is
-*   omitted entirely; the `styler` (a fluent function-bearing object) is dropped by key.
-* - **`validate` rules are flattened.** A {@link ValidationRules} bag is copied with each
-*   function rule replaced by `true` (the rule's INTENT survives as the built-in check; its
-*   custom function does not). A bare-function `validate` is dropped (no declarative form to keep).
-* - **`choices` are function-stripped.** Each choice keeps its plain fields (`name` / `value` /
-*   `description` / `checked`); a bare string passes through.
-*
-* @param options - The raw prompt options bag (may hold functions / a styler)
-* @returns A JSON-safe options record — only serializable, declarative data
-*/
-function serializePromptOptions(options) {
-	const result = {};
-	for (const [key, value] of Object.entries(options)) {
-		if (key === "styler" || typeof value === "function") continue;
-		if (key === "validate") {
-			const rules = serializeValidationRules(value);
-			if (rules !== void 0) result[key] = rules;
-			continue;
-		}
-		if (key === "choices") {
-			result[key] = serializeChoices(value);
-			continue;
-		}
-		result[key] = value;
-	}
-	return result;
-}
-/**
-* Flatten a `validate` option to its wire-safe {@link ValidationRules} DATA — a function rule
-* becomes `true` (its built-in check survives; its body cannot cross the wire). A bare-function
-* `validate` (no rules object) has no declarative form, so it yields `undefined` (dropped).
-*/
-function serializeValidationRules(validate) {
-	if (!(0, _orkestrel_contract.isRecord)(validate)) return void 0;
-	const rules = {};
-	for (const [rule, value] of Object.entries(validate)) rules[rule] = typeof value === "function" ? true : value;
-	return rules;
-}
-/** Strip functions from a `choices` option — each choice keeps its plain fields; a bare string passes through. */
-function serializeChoices(choices) {
-	if (!Array.isArray(choices)) return [];
-	return choices.map((choice) => {
-		if ((0, _orkestrel_contract.isString)(choice)) return choice;
-		if (!(0, _orkestrel_contract.isRecord)(choice)) return choice;
-		const normalized = {};
-		for (const [key, value] of Object.entries(choice)) if (typeof value !== "function") normalized[key] = value;
-		return normalized;
-	});
-}
-/**
-* Rebuild a wire-decoded `validate` payload into a {@link ValidationRules} bag — the inverse of
-* {@link serializeValidationRules}. Keeps only the primitive rule values (`boolean` / `number` /
-* `string`) a serialized prompt could carry; an empty / non-record / all-dropped payload yields
-* `undefined` (no rules to apply). The client feeds the result back through {@link resolveValidation}.
-*/
-function reconstructValidationRules(value) {
-	if (!(0, _orkestrel_contract.isRecord)(value)) return void 0;
-	const rules = {};
-	let count = 0;
-	for (const [rule, item] of Object.entries(value)) {
-		if (rule === "pattern") continue;
-		if ((0, _orkestrel_contract.isBoolean)(item) || (0, _orkestrel_contract.isNumber)(item) || (0, _orkestrel_contract.isString)(item)) {
-			rules[rule] = item;
-			count += 1;
-		}
-	}
-	if (count === 0) return void 0;
-	return rules;
-}
-/** Read one option by key, narrowed by `guard` — `undefined` when absent or off-shape (§14, never an `as`). */
-function resolveOption(options, key, guard) {
-	const value = options[key];
-	return guard(value) ? value : void 0;
-}
-/** Narrow an unknown value to a {@link PromptChoice} — the `recordOf` shape inlined so no non-exported member lingers (§5). */
-function isPromptChoice(value) {
-	return (0, _orkestrel_contract.recordOf)({
-		name: _orkestrel_contract.isString,
-		value: _orkestrel_contract.isString,
-		description: _orkestrel_contract.isString
-	}, ["description"])(value);
-}
-/** Narrow an unknown value to a {@link CheckboxChoice} — the `recordOf` shape inlined so no non-exported member lingers (§5). */
-function isCheckboxChoice(value) {
-	return (0, _orkestrel_contract.recordOf)({
-		name: _orkestrel_contract.isString,
-		value: _orkestrel_contract.isString,
-		description: _orkestrel_contract.isString,
-		checked: _orkestrel_contract.isBoolean
-	}, ["description", "checked"])(value);
-}
-/** Read a `choices` option as a list of bare strings / full choices — each element narrowed by `guard`, off-shape elements stringified. */
-function resolveChoices(options, guard) {
-	const choices = options.choices;
-	if (!Array.isArray(choices)) return [];
-	return choices.map((choice) => {
-		if ((0, _orkestrel_contract.isString)(choice)) return choice;
-		if (guard(choice)) return choice;
-		return String(choice);
-	});
-}
-/**
-* Sanitize a list of resolved choices' human-readable labels (`name` + `description`) with
-* {@link stripControls} — shared by the `select` and `checkbox` branches of
-* {@link dispatchPendingPrompt} so a remote-supplied choice can never inject raw control bytes
-* into the local terminal's rendered view.
-*
-* @param choices - The resolved choices (bare strings or full {@link PromptChoice} /
-*   {@link CheckboxChoice} objects) as returned by {@link resolveChoices}
-* @returns The same choices with every `name` / `description` control-stripped
-*/
-function sanitizeChoiceLabels(choices) {
-	return choices.map((choice) => {
-		if ((0, _orkestrel_contract.isString)(choice)) return (0, _orkestrel_console.stripControls)(choice);
-		return {
-			...choice,
-			name: (0, _orkestrel_console.stripControls)(choice.name),
-			...choice.description !== void 0 ? { description: (0, _orkestrel_console.stripControls)(choice.description) } : {}
-		};
-	});
-}
-/**
-* Dispatch a {@link PendingPrompt} to the matching {@link PromptFormInterface} method — the bridge
-* step a {@link PromptClient} runs to drive a LOCAL terminal with a prompt issued elsewhere.
-* Reconstructs typed options from the wire-safe {@link PendingPrompt.options} (every field
-* §14-narrowed, never an `as`; the validator rebuilt from rules via {@link reconstructValidationRules}),
-* then calls the matching prompt form and returns its resolved value.
-*
-* @remarks
-* `theme` and `hint` are plain data, so they cross the wire with the rest of the options bag and
-* are reconstructed here for every form that accepts them: the theme is narrowed by
-* {@link import('./validators.js').isPromptThemeOptions} (an off-shape theme is dropped, leaving
-* the defaults), then every glyph and hint is passed through {@link sanitizeDisplayText}. Choice
-* labels use the stream-safe {@link sanitizeChoiceLabels} treatment instead.
-*
-* @param terminal - The local {@link PromptFormInterface} to drive
-* @param pending - The decoded pending prompt to dispatch
-* @returns The prompt's resolved value (a `string` / `boolean` / `readonly string[]` per form)
-*/
-function dispatchPendingPrompt(terminal, pending) {
-	const options = pending.options;
-	const validate = reconstructValidationRules(options.validate);
-	const message = (0, _orkestrel_console.stripControls)(pending.message);
-	const supplied = resolveOption(options, "theme", isPromptThemeOptions);
-	const theme = supplied === void 0 ? void 0 : sanitizeThemeIcons(supplied);
-	const raw = resolveOption(options, "hint", _orkestrel_contract.isString);
-	const hint = raw === void 0 ? void 0 : sanitizeDisplayText(raw);
-	switch (pending.form) {
-		case "input": {
-			const value = resolveOption(options, "default", _orkestrel_contract.isString);
-			return terminal.input({
-				message,
-				...value !== void 0 ? { default: (0, _orkestrel_console.stripControls)(value) } : {},
-				...validate !== void 0 ? { validate } : {},
-				...theme !== void 0 ? { theme } : {}
-			});
-		}
-		case "password": {
-			const value = resolveOption(options, "mask", _orkestrel_contract.isString);
-			return terminal.password({
-				message,
-				...value !== void 0 ? { mask: (0, _orkestrel_console.stripControls)(value) } : {},
-				...validate !== void 0 ? { validate } : {},
-				...theme !== void 0 ? { theme } : {}
-			});
-		}
-		case "confirm": {
-			const value = resolveOption(options, "default", _orkestrel_contract.isBoolean);
-			return terminal.confirm({
-				message,
-				...value !== void 0 ? { default: value } : {},
-				...hint !== void 0 ? { hint } : {},
-				...theme !== void 0 ? { theme } : {}
-			});
-		}
-		case "select": {
-			const value = resolveOption(options, "default", _orkestrel_contract.isString);
-			return terminal.select({
-				message,
-				choices: sanitizeChoiceLabels(resolveChoices(options, isPromptChoice)),
-				...value !== void 0 ? { default: (0, _orkestrel_console.stripControls)(value) } : {},
-				...hint !== void 0 ? { hint } : {},
-				...theme !== void 0 ? { theme } : {}
-			});
-		}
-		case "checkbox": {
-			const min = resolveOption(options, "min", _orkestrel_contract.isNumber);
-			const max = resolveOption(options, "max", _orkestrel_contract.isNumber);
-			return terminal.checkbox({
-				message,
-				choices: sanitizeChoiceLabels(resolveChoices(options, isCheckboxChoice)),
-				...min !== void 0 ? { min } : {},
-				...max !== void 0 ? { max } : {},
-				...hint !== void 0 ? { hint } : {},
-				...theme !== void 0 ? { theme } : {}
-			});
-		}
-		case "editor": {
-			const value = resolveOption(options, "default", _orkestrel_contract.isString);
-			return terminal.editor({
-				message,
-				...value !== void 0 ? { default: (0, _orkestrel_console.stripControls)(value) } : {},
-				...validate !== void 0 ? { validate } : {},
-				...hint !== void 0 ? { hint } : {},
-				...theme !== void 0 ? { theme } : {}
-			});
-		}
-	}
-}
-/**
 * The default {@link import('./types.js').TimerHandler} — a thin host `setTimeout` / `clearTimeout`
 * wrapper that arms `callback` after `ms` and returns a {@link TimerCancel}. The deadline seam
 * behind both the {@link import('./Prompt.js').Prompt} broker (its expiry) and the
@@ -1479,12 +1121,12 @@ function isInsecureRemote(url) {
 	const hostname = host.startsWith("[") ? host.slice(0, host.indexOf("]") + 1) : host.split(":")[0] ?? "";
 	return hostname !== "localhost" && hostname !== "127.0.0.1" && hostname !== "[::1]";
 }
-/** Serialize a parked {@link PendingPrompt} into a {@link WireEvent} — event `'pending'`, `data` the JSON-stringified prompt, `id` the prompt's own id (an SSE bridge sets its frame `id:` from this). */
-function serializePending(prompt) {
+/** Serialize a parked {@link PendingForm} into a {@link WireEvent}. */
+function serializePending(form) {
 	return {
 		event: "pending",
-		data: JSON.stringify(prompt),
-		id: prompt.id
+		data: JSON.stringify(form),
+		id: form.id
 	};
 }
 /** Serialize a parked prompt's expiry into a {@link WireEvent} — event `'expire'`, `data` the JSON-stringified `{ id }` payload. */
@@ -1501,44 +1143,24 @@ function serializeShutdown() {
 		data: ""
 	};
 }
-/** Narrow an unknown wire payload to an answer POST body — a non-empty `id` string plus a `value` key (of any shape) present. */
-function isAnswerPayload(value) {
-	return (0, _orkestrel_contract.isRecord)(value) && (0, _orkestrel_contract.isNonEmptyString)(value.id) && "value" in value;
-}
 //#endregion
 //#region src/core/Prompt.ts
 /**
-* The headless prompt BROKER (observable §13) — parks each {@link PromptInterface} call as a
-* pending prompt and returns a Promise that resolves when the prompt is {@link answer}ed (or
-* rejects on timeout / teardown). The tri-surface's headless arm: there is no terminal here, so a
-* transport forwards each `pending` event to whoever can answer, and {@link answer} resolves the
-* parked Promise — for environments where direct user access is unavailable (a headless server on
-* stdio, a browser with no TTY, a prompt issued on one machine answered on another).
+* The headless form broker. It parks live forms, exposes their serialized schemas, and applies
+* remote answers to the authoritative form.
 *
 * @remarks
-* - **Park-as-Promise.** Each `input` / `password` / `confirm` / `select` / `checkbox` / `editor`
-*   mints an id (`crypto.randomUUID()`), parks a wire-safe {@link PendingPrompt}, emits `pending`,
-*   and returns an unresolved Promise. The prompt's options are serialized
-*   ({@link serializePromptOptions}) so a transport can forward them as-is.
-* - **Answer validates + type-checks.** {@link answer} runs the prompt's per-form gate: it
-*   type-checks `value` to the form (string / boolean / string[]) AND, for the text forms, runs
-*   the validator resolved from the original `validate` rules. A rejected answer returns a failure
-*   `Result` with error `'rejected'` and the prompt stays `pending`; an accepted answer resolves the
-*   Promise, emits `answer`, and removes the prompt.
-* - **Timeout → expire → reject.** An unanswered prompt expires after `timeout` ms (via the
-*   INJECTED timer): `expire` fires and the parked Promise rejects with a {@link TerminalError}
-*   (`code: 'EXPIRE'`). {@link destroy} expires every still-pending prompt the same way.
-* - **Deterministic.** The timer is injectable ({@link import('./types.js').TimerHandler}); a test
-*   supplies one that fires on demand, so expiry is driven without real time.
+* A parked record carries one call to `serializeForm`. A failed fill or submit leaves the record
+* parked for another answer. A successful submit settles the form once, emits `answer`, and removes
+* the record. Timeout and teardown abandon every unsettled form through its own `destroy` method.
 *
 * @example
 * ```ts
-* const prompt = createPrompt({ timeout: 60_000 })
-* prompt.emitter.on('pending', (pending) => broadcast(pending)) // forward to a client
-*
-* const name = await prompt.input({ message: 'Your name' }) // parks; resolves on answer()
-* // ...elsewhere, a client POSTs the answer back:
-* prompt.answer(id, 'Ada') // resolves the awaited input() above
+* const form = createForm({ fields: [{ control: 'text', name: 'name' }] })
+* const prompt = createPrompt()
+* const id = prompt.park(form)
+* prompt.answer(id, { name: 'Ada' })
+* await form.answer // { name: 'Ada' }
 * ```
 */
 var Prompt = class {
@@ -1564,211 +1186,164 @@ var Prompt = class {
 		return this.#parked.size;
 	}
 	pending(id) {
-		if (id !== void 0) return this.#parked.get(id)?.prompt;
-		const result = [];
-		for (const parked of this.#parked.values()) result.push(parked.prompt);
-		return result;
-	}
-	answer(id, value) {
-		const parked = this.#parked.get(id);
-		if (parked === void 0) return {
-			success: false,
-			error: "unknown"
-		};
-		const accepted = parked.respond(value);
-		if (accepted === void 0) return {
-			success: false,
-			error: "rejected"
+		if (id !== void 0) return this.#parked.get(id)?.pending;
+		const forms = [];
+		for (const parked of this.#parked.values()) forms.push(parked.pending);
+		return forms;
+	}
+	park(form, request) {
+		if (this.#destroyed) {
+			form.destroy();
+			throw new TerminalError("EXPIRE", "The broker has been destroyed");
+		}
+		if (this.#cap !== void 0 && this.#parked.size >= this.#cap) {
+			form.destroy();
+			throw new TerminalError("LIMIT", `The parked-form cap (${String(this.#cap)}) was reached`, { cap: this.#cap });
+		}
+		const id = crypto.randomUUID();
+		const pending = {
+			id,
+			schema: (0, _orkestrel_form.serializeForm)(form.schema),
+			status: "pending",
+			time: Date.now(),
+			...request?.from !== void 0 ? { from: request.from } : {},
+			...request?.to !== void 0 ? { to: request.to } : {}
 		};
-		parked.cancel();
-		this.#emitter.emit("answer", id, accepted);
-		this.#parked.delete(id);
+		const cancel = this.#timer(() => this.#expire(id), this.#timeout);
+		this.#parked.set(id, {
+			form,
+			pending,
+			cancel
+		});
+		this.#emitter.emit("pending", pending);
+		return id;
+	}
+	answer(id, values) {
+		const outcome = (0, _orkestrel_contract.attempt)(() => this.#answer(id, values));
+		if (outcome.success) return outcome.value;
 		return {
-			success: true,
-			value: accepted
+			success: false,
+			error: {
+				reason: "rejected",
+				errors: [{
+					field: "form",
+					message: "The form rejected the answer"
+				}]
+			}
 		};
 	}
-	park(request) {
-		const gate = this.#gate(request.form, request.options);
-		return this.#park(request.form, request.options.message, request.options, gate, request.from, request.to);
-	}
-	input(options) {
-		return this.#park("input", options.message, options, this.#gate("input", options)).value;
-	}
-	password(options) {
-		return this.#park("password", options.message, options, this.#gate("password", options)).value;
-	}
-	confirm(options) {
-		return this.#park("confirm", options.message, options, this.#gate("confirm", options)).value;
-	}
-	select(options) {
-		return this.#park("select", options.message, options, this.#gate("select", options)).value;
-	}
-	checkbox(options) {
-		return this.#park("checkbox", options.message, options, this.#gate("checkbox", options)).value;
-	}
-	editor(options) {
-		return this.#park("editor", options.message, options, this.#gate("editor", options)).value;
-	}
 	destroy() {
 		if (this.#destroyed) return;
 		this.#destroyed = true;
 		for (const id of [...this.#parked.keys()]) this.#expire(id);
-		this.#parked.clear();
 		this.#emitter.destroy();
 	}
-	#park(form, message, options, gate, from, to) {
-		if (this.#destroyed) return {
-			id: crypto.randomUUID(),
-			value: Promise.reject(new TerminalError("EXPIRE", "broker destroyed"))
-		};
-		if (this.#cap !== void 0 && this.#parked.size >= this.#cap) return {
-			id: crypto.randomUUID(),
-			value: Promise.reject(new TerminalError("LIMIT", `parked-prompt cap (${this.#cap}) reached`, { cap: this.#cap }))
-		};
-		const id = crypto.randomUUID();
-		const prompt = {
-			id,
-			form,
-			message,
-			options: serializePromptOptions(options),
-			status: "pending",
-			time: Date.now(),
-			...from !== void 0 ? { from } : {},
-			...to !== void 0 ? { to } : {}
-		};
-		return {
-			id,
-			value: new Promise((resolve, reject) => {
-				const cancel = this.#timer(() => this.#expire(id), this.#timeout);
-				const respond = this.#createRespond(id, gate, resolve);
-				const expire = this.#createExpire(id, reject);
-				this.#parked.set(id, {
-					prompt,
-					respond,
-					expire,
-					cancel
-				});
-				this.#emitter.emit("pending", prompt);
-			})
-		};
-	}
-	#createRespond(id, gate, resolve) {
-		return (answer) => {
-			const accepted = gate(answer);
-			if (accepted === void 0) return void 0;
-			const current = this.#parked.get(id);
-			if (current !== void 0) this.#parked.set(id, {
-				...current,
-				prompt: {
-					...current.prompt,
-					status: "answered"
-				}
-			});
-			resolve(accepted);
-			return accepted;
+	#answer(id, values) {
+		const parked = this.#parked.get(id);
+		if (parked === void 0 || parked.pending.status !== "pending") return {
+			success: false,
+			error: { reason: "unknown" }
 		};
-	}
-	#createExpire(id, reject) {
-		return () => reject(new TerminalError("EXPIRE", `prompt ${id} expired`, { id }));
-	}
-	#gate(form, options) {
-		switch (form) {
-			case "input":
-			case "password":
-			case "editor": {
-				if (!this.#isTextOptions(form, options)) return () => void 0;
-				const validator = resolveValidation(options.validate);
-				return (value) => (0, _orkestrel_contract.isString)(value) && validator(value) === true ? value : void 0;
+		const outcome = (0, _orkestrel_contract.attempt)(() => this.#submit(parked.form, values));
+		if (!outcome.success) return {
+			success: false,
+			error: {
+				reason: "rejected",
+				errors: this.#errors(outcome.error, parked.form)
 			}
-			case "confirm":
-				if (!this.#isConfirmOptions(form, options)) return () => void 0;
-				return (value) => (0, _orkestrel_contract.isBoolean)(value) ? value : void 0;
-			case "select": {
-				if (!this.#isSelectOptions(form, options)) return () => void 0;
-				const values = new Set(options.choices.map(normalizeChoice).map((choice) => choice.value));
-				return (value) => (0, _orkestrel_contract.isString)(value) && values.has(value) ? value : void 0;
+		};
+		if (!outcome.value.success) return {
+			success: false,
+			error: {
+				reason: "rejected",
+				errors: outcome.value.error
 			}
-			case "checkbox": {
-				if (!this.#isCheckboxOptions(form, options)) return () => void 0;
-				const values = new Set(options.choices.map(normalizeCheckboxChoice).map((choice) => choice.value));
-				const { min, max } = options;
-				return (value) => {
-					if (!(0, _orkestrel_contract.isArray)(value) || !value.every(_orkestrel_contract.isString)) return void 0;
-					if (!value.every((item) => values.has(item))) return void 0;
-					if (min !== void 0 && value.length < min) return void 0;
-					if (max !== void 0 && value.length > max) return void 0;
-					return value;
-				};
+		};
+		parked.cancel();
+		const answered = {
+			...parked,
+			pending: {
+				...parked.pending,
+				status: "answered"
 			}
+		};
+		this.#parked.set(id, answered);
+		this.#emitter.emit("answer", id, outcome.value.value);
+		this.#parked.delete(id);
+		return outcome.value;
+	}
+	#submit(form, values) {
+		for (const [field, value] of Object.entries(values)) {
+			const outcome = (0, _orkestrel_contract.attempt)(() => form.fill(field, value));
+			if (!outcome.success) return {
+				success: false,
+				error: this.#errors(outcome.error, form, field)
+			};
 		}
+		return form.submit();
+	}
+	#errors(error, form, field) {
+		if ((0, _orkestrel_form.isFormError)(error)) {
+			if ((0, _orkestrel_form.isFieldError)(error.context)) return [error.context];
+			const named = error.context?.field;
+			return [{
+				field: typeof named === "string" ? named : this.#field(form, field),
+				message: error.message
+			}];
+		}
+		return [{
+			field: this.#field(form, field),
+			message: "The form rejected the answer"
+		}];
 	}
-	#isTextOptions(form, _options) {
-		return form === "input" || form === "password" || form === "editor";
-	}
-	#isConfirmOptions(form, _options) {
-		return form === "confirm";
-	}
-	#isSelectOptions(form, _options) {
-		return form === "select";
-	}
-	#isCheckboxOptions(form, _options) {
-		return form === "checkbox";
+	#field(form, field) {
+		return field ?? form.schema.fields[0]?.name ?? form.schema.name ?? "form";
 	}
 	#expire(id) {
 		const parked = this.#parked.get(id);
-		if (parked === void 0) return;
+		if (parked === void 0 || parked.pending.status !== "pending") return;
 		parked.cancel();
-		this.#parked.set(id, {
+		const expired = {
 			...parked,
-			prompt: {
-				...parked.prompt,
+			pending: {
+				...parked.pending,
 				status: "expired"
 			}
-		});
+		};
+		this.#parked.set(id, expired);
+		parked.form.destroy();
 		this.#emitter.emit("expire", id);
 		this.#parked.delete(id);
-		parked.expire();
 	}
 };
 //#endregion
 //#region src/core/PromptClient.ts
 /**
-* The SSE prompt BRIDGE (observable §13) — the client-side counterpart to
-* {@link import('./Prompt.js').Prompt}. Connects to a remote broker's SSE endpoint, receives
-* serialized pending prompts, dispatches EACH to a LOCAL {@link PromptFormInterface} terminal (so
-* a human at THIS machine answers a prompt parked elsewhere), and POSTs the answer back.
-* Universal — `fetch` + SSE are web-standard, so it runs in a browser or on a server; the
-* injected `fetch` / timer make it fully deterministic in tests.
+* The SSE form bridge. It ingests serialized forms from a remote broker, renders them through a
+* local terminal, and posts answers back without blocking the event stream.
 *
 * @remarks
-* - **Connect + reconnect.** {@link connect} opens the SSE stream (via the injected `fetch` + the
-*   core `SSEParser`) and loops, reconnecting after the stream drops with the `delay` backoff
-*   (driven by the injected timer) — unless `reconnect` is `false`, the client was
-*   {@link destroy}ed, or the drop was a deliberate {@link disconnect} (an abort).
-* - **Dispatch + answer.** Each decoded `pending` event is narrowed to a `PendingPrompt` (§14 —
-*   never an `as`), dispatched to `terminal`, and its resolved value POSTed back to `url`.
-*   Dispatch is strictly SERIAL: the read loop drives the terminal for ONE prompt at a time and
-*   only reads/dispatches the next event after the current prompt fully settles (its answer
-*   POSTed). A prompt id redelivered (e.g. after a reconnect) WHILE its prior dispatch is still
-*   in flight is skipped (a `#seen` set tracks in-flight ids); once that dispatch settles (or the
-*   broker sends `expire` for the id) the id is dropped from `#seen`, so a later redelivery of the
-*   SAME id after completion is dispatched again — the client does not dedupe across completion.
-* - **Server signals.** An `expire` event (the broker dropped a parked prompt) emits `expire`; a
-*   `shutdown` event calls {@link disconnect} (not {@link destroy}) — the client stops streaming
-*   without auto-reconnect but stays reusable; a later {@link connect} recovers it.
-* - **Lean events (§13).** `connect` / `disconnect` / `expire` / `error` — errors are `unknown`.
-*   `disconnect` fires exactly once per connected-to-disconnected transition, whether triggered by
-*   the server ending the stream cleanly or by a deliberate {@link disconnect} / {@link destroy}.
+* - **Connect + reconnect.** {@link connect} opens the SSE stream and reconnects after a transport
+*   drop with the injected backoff unless reconnect is disabled, the client was destroyed, or
+*   {@link disconnect} deliberately stopped it.
+* - **Ingest + render.** Each `pending` envelope passes through `isPendingForm`, Form's `parseForm`,
+*   and terminal's `sanitizeSchema`, then enters a serial render queue. The SSE reader never awaits
+*   that queue, so `expire` and `shutdown` remain live while a person is answering.
+* - **Safe local form.** The rendering copy omits every wire `pattern`, because Form compiles a
+*   pattern during local evaluation. The broker's parked form retains it and remains authoritative.
+* - **Refusal retry.** A structured `rejected` response seeds a new rendering form with the values
+*   just submitted, applies every {@link FieldError} through `invalidate`, and asks again. No retry
+*   counter truncates the loop; acceptance, expiry, and shutdown are its bounds.
+* - **Replay safety.** A replayed id is skipped while it is queued, rendering, or posting. Once an
+*   attempt ends, a later delivery of that id may be rendered again.
 *
 * @example
 * ```ts
 * const client = createPromptClient({
 * 	url: 'http://localhost:3001/prompts',
-* 	terminal: createTerminal(), // a local PromptFormInterface (T-c)
-* 	on: { connect: () => log('connected') },
+* 	terminal: createTerminal(),
 * })
-* await client.connect() // streams remote prompts to the local terminal, POSTs answers back
+* await client.connect()
 * ```
 */
 var PromptClient = class {
@@ -1786,8 +1361,11 @@ var PromptClient = class {
 	#connecting = false;
 	#connected = false;
 	#destroyed = false;
+	#draining = false;
 	#warnedInsecureToken = false;
 	#seen = /* @__PURE__ */ new Set();
+	#queue = /* @__PURE__ */ new Map();
+	#active;
 	constructor(options) {
 		this.url = options.url;
 		this.#terminal = options.terminal;
@@ -1808,8 +1386,7 @@ var PromptClient = class {
 		return this.#connected;
 	}
 	async connect() {
-		if (this.#destroyed) return;
-		if (this.#connecting) return;
+		if (this.#destroyed || this.#connecting) return;
 		this.#connecting = true;
 		while (this.#connecting && !this.#destroyed) {
 			try {
@@ -1838,7 +1415,7 @@ var PromptClient = class {
 		if (this.#destroyed) return;
 		this.#destroyed = true;
 		this.disconnect();
-		this.#seen.clear();
+		this.#interrupt();
 		this.#emitter.destroy();
 	}
 	async #stream() {
@@ -1864,49 +1441,158 @@ var PromptClient = class {
 			for (;;) {
 				const { done, value } = await reader.read();
 				if (done) break;
-				for (const event of parser.parse(decoder.decode(value, { stream: true }))) await this.#handle(event);
+				for (const event of parser.parse(decoder.decode(value, { stream: true }))) {
+					this.#handle(event);
+					if (!this.#connecting) break;
+				}
+				if (!this.#connecting) break;
 			}
 		} finally {
 			reader.releaseLock();
 		}
 		this.#markDisconnected();
 	}
-	async #handle(event) {
+	#handle(event) {
 		if (event.event === SSE_EVENTS.pending) {
 			const parsed = (0, _orkestrel_contract.parseJSON)(event.data);
-			if (isPendingPrompt(parsed) && !this.#seen.has(parsed.id)) await this.#dispatch(parsed.id, parsed);
+			if (!isPendingForm(parsed) || this.#seen.has(parsed.id)) return;
+			const schema = (0, _orkestrel_form.parseForm)(parsed.schema);
+			if (schema === void 0) {
+				this.#emitter.emit("error", /* @__PURE__ */ new Error(`broker sent an invalid form schema for ${parsed.id}`));
+				return;
+			}
+			this.#seen.add(parsed.id);
+			this.#queue.set(parsed.id, sanitizeSchema(schema));
+			this.#drain();
 			return;
 		}
 		if (event.event === SSE_EVENTS.expire) {
 			const parsed = (0, _orkestrel_contract.parseJSON)(event.data);
-			if ((0, _orkestrel_contract.isRecord)(parsed) && (0, _orkestrel_contract.isString)(parsed.id)) {
-				this.#seen.delete(parsed.id);
-				this.#emitter.emit("expire", parsed.id);
-			}
+			if ((0, _orkestrel_contract.isRecord)(parsed) && (0, _orkestrel_contract.isString)(parsed.id)) this.#expire(parsed.id);
 			return;
 		}
-		if (event.event === SSE_EVENTS.shutdown) this.disconnect();
+		if (event.event === SSE_EVENTS.shutdown) {
+			this.disconnect();
+			this.#interrupt();
+		}
 	}
-	async #dispatch(id, pending) {
-		this.#seen.add(id);
+	async #drain() {
+		if (this.#draining) return;
+		this.#draining = true;
 		try {
-			const value = await dispatchPendingPrompt(this.#terminal, pending);
-			await this.#post(id, value);
-		} catch (error) {
-			this.#emitter.emit("error", error);
+			while (!this.#destroyed) {
+				let queued;
+				for (const entry of this.#queue) {
+					queued = entry;
+					break;
+				}
+				if (queued === void 0) return;
+				const [id, schema] = queued;
+				this.#queue.delete(id);
+				try {
+					await this.#render(id, schema);
+				} catch (error) {
+					const active = this.#active;
+					if (active?.id !== id || !active.stopped) this.#emitter.emit("error", error);
+				} finally {
+					const active = this.#active;
+					if (active?.id === id) {
+						active.form.destroy();
+						this.#active = void 0;
+					}
+					if (!this.#queue.has(id)) this.#seen.delete(id);
+				}
+			}
 		} finally {
-			this.#seen.delete(id);
+			this.#draining = false;
+		}
+	}
+	async #render(id, schema) {
+		let values;
+		let errors = [];
+		while (this.#seen.has(id) && !this.#destroyed) {
+			const form = this.#createRenderingForm(schema, values);
+			this.#active = {
+				id,
+				form,
+				stopped: false
+			};
+			for (const error of errors) form.invalidate(error.field, sanitizeDisplayText(error.message));
+			const submitted = await this.#terminal.ask(form);
+			const active = this.#active;
+			if (active?.id !== id || active.stopped) return;
+			const rejected = await this.#post(id, submitted);
+			const posted = this.#active;
+			if (posted?.id !== id || posted.stopped || rejected === void 0) return;
+			values = submitted;
+			errors = rejected;
+			form.destroy();
+			this.#active = void 0;
 		}
 	}
-	async #post(id, value) {
-		if (!(await this.#fetch(this.url, {
+	#createRenderingForm(schema, values) {
+		const fields = schema.fields.map((field) => {
+			if (field.rule?.pattern === void 0) return field;
+			const { pattern: _pattern, ...rule } = field.rule;
+			return {
+				...field,
+				rule
+			};
+		});
+		const form = (0, _orkestrel_form.createForm)({
+			...schema,
+			fields
+		}, values === void 0 ? void 0 : { values });
+		form.answer.catch(() => void 0);
+		return form;
+	}
+	async #post(id, values) {
+		const response = await this.#fetch(this.url, {
 			method: "POST",
 			headers: this.#headers({ "Content-Type": "application/json" }),
 			body: JSON.stringify({
 				id,
-				value
+				values
 			})
-		})).ok) this.#emitter.emit("error", /* @__PURE__ */ new Error(`broker rejected answer ${id}`));
+		});
+		if (!response.ok) this.#emitter.emit("error", /* @__PURE__ */ new Error(`broker rejected answer ${id}`));
+		const parsed = (0, _orkestrel_contract.parseJSON)(await response.text());
+		if (!(0, _orkestrel_contract.isRecord)(parsed) || !(0, _orkestrel_contract.isBoolean)(parsed.success)) {
+			this.#emitter.emit("error", /* @__PURE__ */ new Error(`broker returned an invalid answer result for ${id}`));
+			return;
+		}
+		if (parsed.success) return void 0;
+		const error = parsed.error;
+		if (!(0, _orkestrel_contract.isRecord)(error) || !(0, _orkestrel_contract.isString)(error.reason)) {
+			this.#emitter.emit("error", /* @__PURE__ */ new Error(`broker returned an invalid answer error for ${id}`));
+			return;
+		}
+		if (error.reason === "unknown") return void 0;
+		if (error.reason === "rejected" && (0, _orkestrel_contract.arrayOf)(_orkestrel_form.isFieldError)(error.errors)) return error.errors;
+		this.#emitter.emit("error", /* @__PURE__ */ new Error(`broker returned an invalid answer refusal for ${id}`));
+	}
+	#expire(id) {
+		const active = this.#active;
+		if (active?.id === id) {
+			this.#active = {
+				...active,
+				stopped: true
+			};
+			this.#seen.delete(id);
+			active.form.destroy();
+		} else if (this.#queue.delete(id)) this.#seen.delete(id);
+		this.#emitter.emit("expire", id);
+	}
+	#interrupt() {
+		this.#queue.clear();
+		this.#seen.clear();
+		const active = this.#active;
+		if (active === void 0) return;
+		this.#active = {
+			...active,
+			stopped: true
+		};
+		active.form.destroy();
 	}
 	#markDisconnected() {
 		if (!this.#connected) return;
@@ -1939,8 +1625,8 @@ var PromptClient = class {
 //#region src/core/TerminalManager.ts
 /**
 * The multi-endpoint terminal MANAGER — a registry of named {@link PromptInterface} brokers (one
-* per endpoint), so several parties can `ask` prompts of each other by NAME with a `from` → `to`
-* attribution edge on every parked prompt, and a transitive DEADLOCK check across all in-flight
+* per endpoint), so several parties can `ask` forms of each other by NAME with a `from` → `to`
+* attribution edge on every parked form, and a transitive DEADLOCK check across all in-flight
 * asks.
 *
 * @remarks
@@ -1951,22 +1637,23 @@ var PromptClient = class {
 * - **`ask`.** The target must already be mounted via {@link add} — `ask` never auto-adds it;
 *   rejects `TARGET` for an unknown `to` (listing the known names). Rejects `DEADLOCK` when parking
 *   `from → to` would close a cycle over the CURRENT in-flight edge set (walked transitively);
-*   otherwise parks through the target's broker and resolves with the ORIGINAL ticket Promise (edge
-*   cleanup is attached via `.then`, never altering the value/rejection the caller observes).
+*   otherwise parks the caller's live form through the target's broker and returns that form's own
+*   `answer` promise. Edge cleanup never alters the value or rejection the caller observes.
 * - **Durable open / save.** `open(name)` restores an EMPTY broker from the `store` (parked
 *   Promises are process-bound and never resurrected); `save(name)` persists the endpoint's
 *   configured `timeout`.
 * - **Removal.** `remove` drops one endpoint, a batch (§9.2, array overload FIRST), or every
-*   endpoint when called without an argument. It destroys each broker, which expires every prompt
+*   endpoint when called without an argument. It destroys each broker, which expires every form
 *   still parked on it. `destroy` is idempotent.
 *
 * @example
 * ```ts
+* const form = createForm({ fields: [{ control: 'text', name: 'name' }] })
 * const manager = new TerminalManager()
 * manager.add('agent')
-* const name = manager.ask('user', 'agent', 'input', { message: 'Your name' })
-* manager.answer('agent', manager.pending('agent')[0].id, 'Ada')
-* await name // 'Ada'
+* const answer = manager.ask('user', 'agent', form)
+* manager.answer('agent', manager.pending('agent')[0].id, { name: 'Ada' })
+* await answer // { name: 'Ada' }
 * ```
 */
 var TerminalManager = class {
@@ -2010,6 +1697,8 @@ var TerminalManager = class {
 		const timer = options?.timer ?? this.#timer;
 		const cap = options?.cap ?? this.#cap;
 		const broker = createPrompt({
+			...options?.on !== void 0 ? { on: options.on } : {},
+			...options?.error !== void 0 ? { error: options.error } : {},
 			...timeout !== void 0 ? { timeout } : {},
 			...timer !== void 0 ? { timer } : {},
 			...cap !== void 0 ? { cap } : {}
@@ -2023,11 +1712,11 @@ var TerminalManager = class {
 		broker.emitter.on("answer", listeners.answer);
 		broker.emitter.on("expire", listeners.expire);
 		this.#terminals.set(name, broker);
-		this.#config.set(name, options ?? {});
+		this.#config.set(name, { ...options });
 		this.#listeners.set(name, listeners);
 		return broker;
 	}
-	ask(from, to, form, options) {
+	ask(from, to, form) {
 		const broker = this.#terminals.get(to);
 		if (broker === void 0) {
 			const known = this.terminals();
@@ -2042,21 +1731,18 @@ var TerminalManager = class {
 			to,
 			path: cycle
 		}));
-		const ticket = broker.park({
-			form,
-			options,
+		const id = broker.park(form, {
 			from,
 			to
 		});
-		if (broker.pending(ticket.id) !== void 0) {
-			this.#edges.set(ticket.id, {
+		if (broker.pending(id) !== void 0) {
+			this.#edges.set(id, {
 				from,
 				to
 			});
-			const clear = this.#createEdgeClear(ticket.id);
-			ticket.value.then(clear, clear);
+			form.answer.then(this.#createEdgeClear(id), this.#createEdgeClear(id));
 		}
-		return ticket.value;
+		return form.answer;
 	}
 	pending(to) {
 		if (to !== void 0) {
@@ -2067,13 +1753,15 @@ var TerminalManager = class {
 		for (const broker of this.#terminals.values()) result.push(...broker.pending());
 		return result;
 	}
-	answer(to, id, value) {
+	answer(to, id, values) {
 		const broker = this.#terminals.get(to);
 		if (broker === void 0) return {
 			success: false,
-			error: "terminal"
+			error: { reason: "terminal" }
 		};
-		return broker.answer(id, value);
+		const result = broker.answer(id, values);
+		if (result.success) this.#edges.delete(id);
+		return result;
 	}
 	async open(name) {
 		if (this.#destroyed) throw new TerminalError("DESTROYED", "manager destroyed");
@@ -2112,16 +1800,23 @@ var TerminalManager = class {
 		if (this.#destroyed) return;
 		this.#destroyed = true;
 		this.remove();
+		this.#edges.clear();
 		this.#emitter.destroy();
 	}
 	#createPendingListener() {
-		return (prompt) => this.#emitter.emit("pending", prompt);
+		return (form) => this.#emitter.emit("pending", form);
 	}
 	#createAnswerListener(name) {
-		return (id, value) => this.#emitter.emit("answer", name, id, value);
+		return (id, values) => {
+			this.#edges.delete(id);
+			this.#emitter.emit("answer", name, id, values);
+		};
 	}
 	#createExpireListener(name) {
-		return (id) => this.#emitter.emit("expire", name, id);
+		return (id) => {
+			this.#edges.delete(id);
+			this.#emitter.emit("expire", name, id);
+		};
 	}
 	#createEdgeClear(id) {
 		return () => {
@@ -2141,8 +1836,12 @@ var TerminalManager = class {
 		this.#terminals.delete(name);
 		this.#config.delete(name);
 		this.#listeners.delete(name);
+		this.#clearEdges(name);
 		return true;
 	}
+	#clearEdges(to) {
+		for (const [id, edge] of this.#edges) if (edge.to === to) this.#edges.delete(id);
+	}
 	#findCycle(from, to) {
 		if (from === to) return [from, to];
 		const visited = /* @__PURE__ */ new Set([to]);
@@ -2290,30 +1989,26 @@ var DatabaseTerminalStore = class {
 //#endregion
 //#region src/core/factories.ts
 /**
-* Create the headless prompt {@link PromptInterface} BROKER — it parks each prompt call as a
-* pending prompt and resolves it when {@link PromptInterface.answer} arrives (or rejects on
-* timeout). The tri-surface's headless arm: subscribe `emitter.on('pending', …)` to forward each
-* prompt to whoever can answer (an SSE transport, a remote terminal), then route the answer back
-* through `answer(id, value)`.
+* Create the headless {@link PromptInterface} broker. It parks live forms and applies remote
+* answers to the authoritative instances.
 *
 * @param options - See {@link PromptOptions}
 * @returns A {@link PromptInterface}
 *
 * @remarks
-* - **Park-as-Promise.** `await prompt.input({ message })` blocks until `answer(id, value)` accepts
-*   a matching value; the value is validated (text forms) and type-checked to the form first.
-* - **Timeout → expire → reject (deterministic).** An unanswered prompt expires after
-*   `options.timeout` (default {@link import('./constants.js').DEFAULT_PROMPT_TIMEOUT_MS}) and its
-*   Promise rejects with a {@link import('./errors.js').TerminalError}; inject `options.timer` to
-*   drive expiry without real time.
+* The caller awaits the parked form's own `answer`. Timeout or teardown destroys the form, so that
+* promise rejects with the Form package's `ABANDONED` error. Inject `options.timer` to drive
+* expiry without real time.
 *
 * @example
 * ```ts
 * import { createPrompt } from '@src/core'
+* import { createForm } from '@orkestrel/form'
 *
 * const prompt = createPrompt()
-* prompt.emitter.on('pending', (pending) => send(pending)) // forward to a remote client
-* const name = await prompt.input({ message: 'Your name', validate: { required: true } })
+* const form = createForm({ fields: [{ control: 'text', name: 'name' }] })
+* const id = prompt.park(form)
+* prompt.answer(id, { name: 'Ada' })
 * ```
 */
 function createPrompt(options) {
@@ -2321,9 +2016,8 @@ function createPrompt(options) {
 }
 /**
 * Create the SSE prompt {@link PromptClientInterface} BRIDGE — it connects to a remote broker's SSE
-* endpoint, dispatches each received prompt to a LOCAL {@link import('./types.js').PromptFormInterface}
-* terminal (so a human at this machine answers a prompt parked elsewhere), and POSTs the answer
-* back. Universal — `fetch` / SSE are web-standard.
+* endpoint, dispatches each received form to a local {@link import('./types.js').TerminalInterface},
+* and POSTs the answer back. Universal — `fetch` / SSE are web-standard.
 *
 * @param options - See {@link PromptClientOptions} (`url` + `terminal` required)
 * @returns A {@link PromptClientInterface}
@@ -2347,12 +2041,12 @@ function createPromptClient(options) {
 	return new PromptClient(options);
 }
 /**
-* Create the multi-endpoint {@link TerminalManagerInterface} — a named registry of
+* Create the multi-endpoint {@link TerminalManager} — a named registry of
 * {@link PromptInterface} brokers so several parties can `ask` prompts of each other by name,
 * with a transitive DEADLOCK check across every in-flight ask.
 *
 * @param options - See {@link TerminalManagerOptions}
-* @returns A {@link TerminalManagerInterface}
+* @returns A {@link TerminalManager}
 *
 * @example
 * ```ts
@@ -2407,7 +2101,6 @@ function createDatabaseTerminalStore(driver = (0, _orkestrel_database.createMemo
 }
 //#endregion
 exports.ACCEPT_EVENT_STREAM = ACCEPT_EVENT_STREAM;
-exports.ALPHANUMERIC_PATTERN = ALPHANUMERIC_PATTERN;
 exports.BACKSPACE = BACKSPACE;
 exports.CONTROL_NAMES = CONTROL_NAMES;
 exports.CTRL_A = CTRL_A;
@@ -2423,18 +2116,15 @@ exports.DELETE = DELETE;
 exports.DatabaseTerminalStore = DatabaseTerminalStore;
 exports.ESCAPE = ESCAPE;
 exports.HEADER_TOKEN = HEADER_TOKEN;
-exports.INTEGER_PATTERN = INTEGER_PATTERN;
 exports.KEY_CSI = KEY_CSI;
 exports.KEY_SS3 = KEY_SS3;
 exports.MemoryTerminalStore = MemoryTerminalStore;
 exports.NEWLINE = NEWLINE;
-exports.NUMERIC_PATTERN = NUMERIC_PATTERN;
 exports.PROMPT_ICONS = PROMPT_ICONS;
 exports.PROMPT_ROLES = PROMPT_ROLES;
 exports.Prompt = Prompt;
 exports.PromptClient = PromptClient;
 exports.RETURN = RETURN;
-exports.RULE_MESSAGES = RULE_MESSAGES;
 exports.SEQUENCE_NAMES = SEQUENCE_NAMES;
 exports.SPACE = SPACE;
 exports.SSE_BUFFER_LIMIT = SSE_BUFFER_LIMIT;
@@ -2442,12 +2132,8 @@ exports.SSE_EVENTS = SSE_EVENTS;
 exports.TAB = TAB;
 exports.TerminalError = TerminalError;
 exports.TerminalManager = TerminalManager;
-exports.URL_PATTERN = URL_PATTERN;
-exports.appendRule = appendRule;
-exports.buildRuleValidator = buildRuleValidator;
 exports.checkboxReduce = checkboxReduce;
 exports.checkboxView = checkboxView;
-exports.composeValidators = composeValidators;
 exports.confirmReduce = confirmReduce;
 exports.confirmView = confirmView;
 exports.createCheckboxState = createCheckboxState;
@@ -2463,52 +2149,34 @@ exports.createPromptTheme = createPromptTheme;
 exports.createSelectState = createSelectState;
 exports.createTerminalManager = createTerminalManager;
 exports.defaultTimer = defaultTimer;
-exports.dispatchPendingPrompt = dispatchPendingPrompt;
 exports.editLine = editLine;
 exports.editorReduce = editorReduce;
 exports.editorView = editorView;
 exports.errorLine = errorLine;
-exports.evaluateRule = evaluateRule;
-exports.gateSelection = gateSelection;
 exports.globalFetch = globalFetch;
 exports.hintedHeader = hintedHeader;
 exports.inputReduce = inputReduce;
 exports.inputView = inputView;
 exports.isAbortError = isAbortError;
-exports.isAnswerPayload = isAnswerPayload;
-exports.isCheckboxChoice = isCheckboxChoice;
 exports.isInsecureRemote = isInsecureRemote;
-exports.isPendingPrompt = isPendingPrompt;
-exports.isPendingPromptStatus = isPendingPromptStatus;
+exports.isPendingForm = isPendingForm;
+exports.isPendingFormStatus = isPendingFormStatus;
 exports.isPrintable = isPrintable;
-exports.isPromptChoice = isPromptChoice;
-exports.isPromptThemeOptions = isPromptThemeOptions;
-exports.isPromptType = isPromptType;
-exports.isStyle = isStyle;
 exports.isTerminalError = isTerminalError;
 exports.isTerminalSnapshot = isTerminalSnapshot;
-exports.normalizeCheckboxChoice = normalizeCheckboxChoice;
-exports.normalizeChoice = normalizeChoice;
+exports.isWireEvent = isWireEvent;
 exports.parseKey = parseKey;
-exports.passing = passing;
 exports.passwordReduce = passwordReduce;
 exports.passwordView = passwordView;
 exports.promptHeader = promptHeader;
-exports.reconstructValidationRules = reconstructValidationRules;
-exports.resolveChoices = resolveChoices;
-exports.resolveOption = resolveOption;
-exports.resolveValidation = resolveValidation;
-exports.sanitizeChoiceLabels = sanitizeChoiceLabels;
 exports.sanitizeDisplayText = sanitizeDisplayText;
+exports.sanitizeSchema = sanitizeSchema;
 exports.sanitizeThemeIcons = sanitizeThemeIcons;
 exports.selectReduce = selectReduce;
 exports.selectView = selectView;
-exports.serializeChoices = serializeChoices;
 exports.serializeExpire = serializeExpire;
 exports.serializePending = serializePending;
-exports.serializePromptOptions = serializePromptOptions;
 exports.serializeShutdown = serializeShutdown;
-exports.serializeValidationRules = serializeValidationRules;
 exports.submitHeader = submitHeader;
 exports.toggleIndex = toggleIndex;