@orkestrel/terminal 0.0.4 → 0.0.6

package/dist/src/core/index.cjs

@@ -229,7 +229,7 @@ var TerminalError = class extends Error {
 		super(message);
 		this.name = "TerminalError";
 		this.code = code;
-		this.context = context;
+		if (context !== void 0) this.context = context;
 	}
 };
 /**
@@ -251,6 +251,33 @@ function isTerminalError(value) {
 	return value instanceof TerminalError;
 }
 //#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 TerminalSnapshot}. */
+var isTerminalSnapshot = (0, _orkestrel_contract.recordOf)({
+	id: _orkestrel_contract.isNonEmptyString,
+	timeout: _orkestrel_contract.isNumber
+}, ["timeout"]);
+//#endregion
 //#region src/core/helpers.ts
 /**
 * Decode one keypress's bytes into a {@link KeyEvent} — total, never throws. A `Uint8Array` is
@@ -514,6 +541,7 @@ 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);
@@ -530,9 +558,8 @@ function inputReduce(state, key) {
 		}
 		return {
 			state: {
-				...state,
-				value: answer,
-				error: void 0
+				...clear,
+				value: answer
 			},
 			view: `${submitHeader(state.styler, state.message)} ${state.styler.dim(answer)}`,
 			status: "submit",
@@ -546,9 +573,8 @@ function inputReduce(state, key) {
 		status: "active"
 	};
 	const next = {
-		...state,
-		value,
-		error: void 0
+		...clear,
+		value
 	};
 	return {
 		state: next,
@@ -584,6 +610,7 @@ 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) {
@@ -598,10 +625,7 @@ function passwordReduce(state, key) {
 			};
 		}
 		return {
-			state: {
-				...state,
-				error: void 0
-			},
+			state: clear,
 			view: `${submitHeader(state.styler, state.message)} ${state.styler.dim(state.mask.repeat(state.value.length))}`,
 			status: "submit",
 			value: state.value
@@ -614,9 +638,8 @@ function passwordReduce(state, key) {
 		status: "active"
 	};
 	const next = {
-		...state,
-		value,
-		error: void 0
+		...clear,
+		value
 	};
 	return {
 		state: next,
@@ -753,8 +776,8 @@ function createCheckboxState(options) {
 		styler: options.styler ?? (0, _orkestrel_console.createStyler)(),
 		focused: 0,
 		checked,
-		min: options.min,
-		max: options.max
+		...options.min !== void 0 ? { min: options.min } : {},
+		...options.max !== void 0 ? { max: options.max } : {}
 	};
 }
 /** Render a {@link CheckboxState} as a MULTI-LINE styled view — the header, one box per choice (focused + checked marked), a count, and any error. */
@@ -786,11 +809,11 @@ 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 = {
-			...state,
-			focused: (state.focused - 1 + count) % count,
-			error: void 0
+			...clear,
+			focused: (state.focused - 1 + count) % count
 		};
 		return {
 			state: next,
@@ -800,9 +823,8 @@ function checkboxReduce(state, key) {
 	}
 	if ((key.name === "down" || key.name === "j") && count > 0) {
 		const next = {
-			...state,
-			focused: (state.focused + 1) % count,
-			error: void 0
+			...clear,
+			focused: (state.focused + 1) % count
 		};
 		return {
 			state: next,
@@ -813,9 +835,8 @@ function checkboxReduce(state, key) {
 	if (key.name === "space" && count > 0) {
 		const checked = toggleIndex(state.checked, state.focused);
 		const next = {
-			...state,
-			checked,
-			error: void 0
+			...clear,
+			checked
 		};
 		return {
 			state: next,
@@ -840,10 +861,7 @@ function checkboxReduce(state, key) {
 		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(", ");
 		return {
-			state: {
-				...state,
-				error: void 0
-			},
+			state: clear,
 			view: `${submitHeader(state.styler, state.message)} ${state.styler.dim(summary)}`,
 			status: "submit",
 			value: values
@@ -893,6 +911,7 @@ 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");
@@ -910,10 +929,7 @@ function editorReduce(state, key) {
 			};
 		}
 		return {
-			state: {
-				...state,
-				error: void 0
-			},
+			state: clear,
 			view: `${submitHeader(state.styler, state.message)} ${state.styler.dim(`${String(lines.length)} line${lines.length === 1 ? "" : "s"}`)}`,
 			status: "submit",
 			value: answer
@@ -921,10 +937,9 @@ function editorReduce(state, key) {
 	}
 	if (key.name === "return") {
 		const next = {
-			...state,
+			...clear,
 			lines: [...state.lines, state.current],
-			current: "",
-			error: void 0
+			current: ""
 		};
 		return {
 			state: next,
@@ -939,9 +954,8 @@ function editorReduce(state, key) {
 		status: "active"
 	};
 	const next = {
-		...state,
-		current,
-		error: void 0
+		...clear,
+		current
 	};
 	return {
 		state: next,
@@ -1021,24 +1035,6 @@ function serializeChoices(choices) {
 		return normalized;
 	});
 }
-/** 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} — the §14 guard a {@link PromptClient}
-* applies to each decoded SSE `pending` payload before dispatching it (never an `as`).
-*/
-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"]);
 /**
 * Rebuild a wire-decoded `validate` payload into a {@link ValidationRules} bag — the inverse of
 * {@link serializeValidationRules}. Keeps only the primitive rule values (`boolean` / `number` /
@@ -1104,11 +1100,10 @@ function resolveChoices(options, guard) {
 function sanitizeChoiceLabels(choices) {
 	return choices.map((choice) => {
 		if ((0, _orkestrel_contract.isString)(choice)) return (0, _orkestrel_console.stripControls)(choice);
-		const description = choice.description === void 0 ? void 0 : (0, _orkestrel_console.stripControls)(choice.description);
 		return {
 			...choice,
 			name: (0, _orkestrel_console.stripControls)(choice.name),
-			description
+			...choice.description !== void 0 ? { description: (0, _orkestrel_console.stripControls)(choice.description) } : {}
 		};
 	});
 }
@@ -1132,42 +1127,49 @@ function dispatchPendingPrompt(terminal, pending) {
 			const value = resolveOption(options, "default", _orkestrel_contract.isString);
 			return terminal.input({
 				message,
-				default: value === void 0 ? void 0 : (0, _orkestrel_console.stripControls)(value),
-				validate
+				...value !== void 0 ? { default: (0, _orkestrel_console.stripControls)(value) } : {},
+				...validate !== void 0 ? { validate } : {}
 			});
 		}
 		case "password": {
 			const value = resolveOption(options, "mask", _orkestrel_contract.isString);
 			return terminal.password({
 				message,
-				mask: value === void 0 ? void 0 : (0, _orkestrel_console.stripControls)(value),
-				validate
+				...value !== void 0 ? { mask: (0, _orkestrel_console.stripControls)(value) } : {},
+				...validate !== void 0 ? { validate } : {}
+			});
+		}
+		case "confirm": {
+			const value = resolveOption(options, "default", _orkestrel_contract.isBoolean);
+			return terminal.confirm({
+				message,
+				...value !== void 0 ? { default: value } : {}
 			});
 		}
-		case "confirm": return terminal.confirm({
-			message,
-			default: resolveOption(options, "default", _orkestrel_contract.isBoolean)
-		});
 		case "select": {
 			const value = resolveOption(options, "default", _orkestrel_contract.isString);
 			return terminal.select({
 				message,
 				choices: sanitizeChoiceLabels(resolveChoices(options, isPromptChoice)),
-				default: value === void 0 ? void 0 : (0, _orkestrel_console.stripControls)(value)
+				...value !== void 0 ? { default: (0, _orkestrel_console.stripControls)(value) } : {}
+			});
+		}
+		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 } : {}
 			});
 		}
-		case "checkbox": return terminal.checkbox({
-			message,
-			choices: sanitizeChoiceLabels(resolveChoices(options, isCheckboxChoice)),
-			min: resolveOption(options, "min", _orkestrel_contract.isNumber),
-			max: resolveOption(options, "max", _orkestrel_contract.isNumber)
-		});
 		case "editor": {
 			const value = resolveOption(options, "default", _orkestrel_contract.isString);
 			return terminal.editor({
 				message,
-				default: value === void 0 ? void 0 : (0, _orkestrel_console.stripControls)(value),
-				validate
+				...value !== void 0 ? { default: (0, _orkestrel_console.stripControls)(value) } : {},
+				...validate !== void 0 ? { validate } : {}
 			});
 		}
 	}
@@ -1262,11 +1264,6 @@ function serializeShutdown() {
 function isAnswerPayload(value) {
 	return (0, _orkestrel_contract.isRecord)(value) && (0, _orkestrel_contract.isNonEmptyString)(value.id) && "value" in value;
 }
-/** Narrow an unknown value to a {@link TerminalSnapshot} — a non-empty `id` plus an optional numeric `timeout`. */
-var isTerminalSnapshot = (0, _orkestrel_contract.recordOf)({
-	id: _orkestrel_contract.isNonEmptyString,
-	timeout: _orkestrel_contract.isNumber
-}, ["timeout"]);
 //#endregion
 //#region src/core/Prompt.ts
 /**
@@ -1315,8 +1312,8 @@ var Prompt = class {
 		this.#timer = options?.timer ?? defaultTimer;
 		this.#cap = options?.cap;
 		this.#emitter = new _orkestrel_emitter.Emitter({
-			on: options?.on,
-			error: options?.error
+			...options?.on !== void 0 ? { on: options.on } : {},
+			...options?.error !== void 0 ? { error: options.error } : {}
 		});
 	}
 	get emitter() {
@@ -1403,23 +1400,8 @@ var Prompt = class {
 			id,
 			value: new Promise((resolve, reject) => {
 				const cancel = this.#timer(() => this.#expire(id), this.#timeout);
-				const respond = (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;
-				};
-				const expire = () => {
-					reject(new TerminalError("EXPIRE", `prompt ${id} expired`, { id }));
-				};
+				const respond = this.#createRespond(id, gate, resolve);
+				const expire = this.#createExpire(id, reject);
 				this.#parked.set(id, {
 					prompt,
 					respond,
@@ -1430,6 +1412,25 @@ var Prompt = class {
 			})
 		};
 	}
+	#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;
+		};
+	}
+	#createExpire(id, reject) {
+		return () => reject(new TerminalError("EXPIRE", `prompt ${id} expired`, { id }));
+	}
 	#gate(form, options) {
 		switch (form) {
 			case "input":
@@ -1555,8 +1556,8 @@ var PromptClient = class {
 		this.#fetch = options.fetch ?? globalFetch;
 		this.#timer = options.timer ?? defaultTimer;
 		this.#emitter = new _orkestrel_emitter.Emitter({
-			on: options.on,
-			error: options.error
+			...options.on !== void 0 ? { on: options.on } : {},
+			...options.error !== void 0 ? { error: options.error } : {}
 		});
 	}
 	get emitter() {
@@ -1680,17 +1681,18 @@ var PromptClient = class {
 	}
 	#wait(ms) {
 		return new Promise((resolve) => {
-			const settle = () => {
-				this.#backoff = void 0;
-				this.#wake = void 0;
-				resolve();
-			};
+			const settle = this.#createSettler(resolve);
 			this.#wake = settle;
-			this.#backoff = this.#timer(() => {
-				settle();
-			}, ms);
+			this.#backoff = this.#timer(settle, ms);
 		});
 	}
+	#createSettler(resolve) {
+		return () => {
+			this.#backoff = void 0;
+			this.#wake = void 0;
+			resolve();
+		};
+	}
 };
 //#endregion
 //#region src/core/TerminalManager.ts
@@ -1743,8 +1745,8 @@ var TerminalManager = class {
 		this.#timer = options?.timer;
 		this.#cap = options?.cap;
 		this.#emitter = new _orkestrel_emitter.Emitter({
-			on: options?.on,
-			error: options?.error
+			...options?.on !== void 0 ? { on: options.on } : {},
+			...options?.error !== void 0 ? { error: options.error } : {}
 		});
 	}
 	get emitter() {
@@ -1772,9 +1774,9 @@ var TerminalManager = class {
 			...cap !== void 0 ? { cap } : {}
 		});
 		const listeners = {
-			pending: (prompt) => this.#emitter.emit("pending", prompt),
-			answer: (id, value) => this.#emitter.emit("answer", name, id, value),
-			expire: (id) => this.#emitter.emit("expire", name, id)
+			pending: this.#createPendingListener(),
+			answer: this.#createAnswerListener(name),
+			expire: this.#createExpireListener(name)
 		};
 		broker.emitter.on("pending", listeners.pending);
 		broker.emitter.on("answer", listeners.answer);
@@ -1810,9 +1812,7 @@ var TerminalManager = class {
 				from,
 				to
 			});
-			const clear = () => {
-				this.#edges.delete(ticket.id);
-			};
+			const clear = this.#createEdgeClear(ticket.id);
 			ticket.value.then(clear, clear);
 		}
 		return ticket.value;
@@ -1872,6 +1872,20 @@ var TerminalManager = class {
 		this.clear();
 		this.#emitter.destroy();
 	}
+	#createPendingListener() {
+		return (prompt) => this.#emitter.emit("pending", prompt);
+	}
+	#createAnswerListener(name) {
+		return (id, value) => this.#emitter.emit("answer", name, id, value);
+	}
+	#createExpireListener(name) {
+		return (id) => this.#emitter.emit("expire", name, id);
+	}
+	#createEdgeClear(id) {
+		return () => {
+			this.#edges.delete(id);
+		};
+	}
 	#removeOne(name) {
 		const broker = this.#terminals.get(name);
 		if (broker === void 0) return false;
@@ -1983,7 +1997,7 @@ var MemoryTerminalStore = class {
 * - **`set(snapshot)` upserts under the snapshot's OWN `id`** (no separate id param) — it writes
 *   the row `{ id: snapshot.id, snapshot }`.
 * - **`get(id)` resolves the stored snapshot for an id**, narrowing the opaque JSON column back to
-*   a {@link TerminalSnapshot} ({@link import('./helpers.js').isTerminalSnapshot} — the AGENTS §14
+*   a {@link TerminalSnapshot} ({@link import('./validators.js').isTerminalSnapshot} — the AGENTS §14
 *   boundary narrow for an untrusted storage read), or `undefined` if none is stored.
 * - **`delete(id)` drops a snapshot by id**; an absent id is a no-op (no throw).
 *