@aigne/afs-ui 1.11.0-beta.12

package/dist/term.d.mts

@@ -0,0 +1,84 @@
+import { PromptOptions, PromptResult, ReadOptions, UIBackend, ViewportInfo, WriteOptions } from "./backend.mjs";
+import { TTYInputSource } from "./tty.mjs";
+
+//#region src/term.d.ts
+interface TermBackendOptions {
+  /** Port to listen on (0 = OS-assigned random port) */
+  port?: number;
+  /** Host to bind to */
+  host?: string;
+  /** For testing: custom input source (bypasses WebSocket) */
+  inputSource?: TTYInputSource & {
+    push?: (line: string) => void;
+  };
+  /** For testing: custom output handler (bypasses WebSocket) */
+  stdout?: {
+    write(data: string): boolean;
+  };
+}
+/**
+ * TermBackend — HTTP + WebSocket based xterm.js terminal.
+ *
+ * Serves an xterm.js web page and communicates via WebSocket.
+ * Line-based I/O: client sends complete lines on Enter, server writes output text.
+ */
+declare class TermBackend implements UIBackend {
+  readonly type = "term";
+  readonly supportedFormats: string[];
+  readonly capabilities: string[];
+  private port;
+  private host;
+  private server;
+  private wss;
+  private clients;
+  private sockets;
+  private inputSource;
+  private outputHandler;
+  /** Queue for messages sent before any client connects */
+  private pendingMessages;
+  /** Pending prompt resolve */
+  private promptResolve;
+  /** Pending prompt message — re-sent on client reconnect */
+  private pendingPromptMessage;
+  /** Viewport info from last resize */
+  private viewportCols;
+  private viewportRows;
+  private testMode;
+  private _url;
+  /** Per-client session tracking */
+  private sessionForClient;
+  private createSessionCallback;
+  constructor(options?: TermBackendOptions);
+  /** URL of the running server, or null if not started. */
+  get url(): string | null;
+  /** Register a factory that creates a session for each new WebSocket client. */
+  setSessionFactory(fn: (endpoint: string, requestedSessionId?: string, requestedSessionToken?: string, caps?: Record<string, unknown>) => {
+    sessionId: string;
+    sessionToken?: string;
+  }): void;
+  /** Start the HTTP + WebSocket server. */
+  listen(): Promise<{
+    port: number;
+    host: string;
+  }>;
+  /** Shut down the server and disconnect all clients. */
+  close(): Promise<void>;
+  write(content: string, options?: WriteOptions): Promise<void>;
+  read(options?: ReadOptions): Promise<string>;
+  prompt(options: PromptOptions): Promise<PromptResult>;
+  notify(message: string): Promise<void>;
+  clear(): Promise<void>;
+  hasPendingInput(): boolean;
+  getViewport(): ViewportInfo;
+  dispose(): Promise<void>;
+  private onConnection;
+  private onMessage;
+  private broadcast;
+  private isLoopbackHost;
+  private isAllowedWsOrigin;
+  /** TTY-style prompt for test mode */
+  private ttyStylePrompt;
+}
+//#endregion
+export { TermBackend, TermBackendOptions };
+//# sourceMappingURL=term.d.mts.map

package/dist/term.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"term.d.mts","names":[],"sources":["../src/term.ts"],"mappings":";;;;UAciB,kBAAA;;EAEf,IAAA;EAFiC;EAIjC,IAAA;EAE4B;EAA5B,WAAA,GAAc,cAAA;IAAmB,IAAA,IAAQ,IAAA;EAAA;EAA3B;EAEd,MAAA;IAAW,KAAA,CAAM,IAAA;EAAA;AAAA;;;;AASnB;;;cAAa,WAAA,YAAuB,SAAA;EAAA,SACzB,IAAA;EAAA,SACA,gBAAA;EAAA,SACA,YAAA;EAAA,QAED,IAAA;EAAA,QACA,IAAA;EAAA,QACA,MAAA;EAAA,QACA,GAAA;EAAA,QACA,OAAA;EAAA,QACA,OAAA;EAAA,QAEA,WAAA;EAAA,QACA,aAAA;EAmMO;EAAA,QAhMP,eAAA;EAgNS;EAAA,QA7MT,aAAA;EAnBmC;EAAA,QAqBnC,oBAAA;EArB0B;EAAA,QAwB1B,YAAA;EAAA,QACA,YAAA;EAAA,QAEA,QAAA;EAAA,QACA,IAAA;EAtBA;EAAA,QAyBA,gBAAA;EAAA,QACA,qBAAA;cASI,OAAA,GAAS,kBAAA;EA/Bb;EAAA,IA2DJ,GAAA,CAAA;EAxDI;EA6DR,iBAAA,CACE,EAAA,GACE,QAAA,UACA,kBAAA,WACA,qBAAA,WACA,IAAA,GAAO,MAAA;IACF,SAAA;IAAmB,YAAA;EAAA;EAvDpB;EA6DF,MAAA,CAAA,GAAU,OAAA;IAAU,IAAA;IAAc,IAAA;EAAA;;EA0ClC,KAAA,CAAA,GAAS,OAAA;EA0BT,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,YAAA,GAAe,OAAA;EAahD,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA;EAQ7B,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EAyBxC,MAAA,CAAO,OAAA,WAAkB,OAAA;EAQzB,KAAA,CAAA,GAAS,OAAA;EAQf,eAAA,CAAA;EAIA,WAAA,CAAA,GAAe,YAAA;EAIT,OAAA,CAAA,GAAW,OAAA;EAAA,QAMT,YAAA;EAAA,QAkDA,SAAA;EAAA,QAwBA,SAAA;EAAA,QAQA,cAAA;EAAA,QAIA,iBAAA;EAtOkB;EAAA,QAkPZ,cAAA;AAAA"}

package/dist/term.mjs

@@ -0,0 +1,296 @@
+import { TERM_CLIENT_HTML } from "./term-page.mjs";
+import { createMockInputSource } from "./tty.mjs";
+import { createServer } from "node:http";
+import { WebSocketServer } from "ws";
+
+//#region src/term.ts
+/**
+* TermBackend — HTTP + WebSocket based xterm.js terminal.
+*
+* Serves an xterm.js web page and communicates via WebSocket.
+* Line-based I/O: client sends complete lines on Enter, server writes output text.
+*/
+var TermBackend = class {
+	type = "term";
+	supportedFormats = ["text"];
+	capabilities = ["text"];
+	port;
+	host;
+	server = null;
+	wss = null;
+	clients = /* @__PURE__ */ new Set();
+	sockets = /* @__PURE__ */ new Set();
+	inputSource;
+	outputHandler;
+	/** Queue for messages sent before any client connects */
+	pendingMessages = [];
+	/** Pending prompt resolve */
+	promptResolve = null;
+	/** Pending prompt message — re-sent on client reconnect */
+	pendingPromptMessage = null;
+	/** Viewport info from last resize */
+	viewportCols = 80;
+	viewportRows = 24;
+	testMode;
+	_url = null;
+	/** Per-client session tracking */
+	sessionForClient = /* @__PURE__ */ new Map();
+	createSessionCallback = null;
+	constructor(options = {}) {
+		this.port = options.port ?? 0;
+		this.host = options.host ?? "localhost";
+		if (options.inputSource) {
+			this.testMode = true;
+			this.inputSource = options.inputSource;
+			this.outputHandler = options.stdout ? (data) => {
+				options.stdout.write(data);
+			} : () => {};
+		} else {
+			this.testMode = false;
+			this.inputSource = createMockInputSource();
+			this.outputHandler = (data) => {
+				const payload = JSON.stringify({
+					type: "output",
+					data
+				});
+				if (this.clients.size === 0) this.pendingMessages.push(payload);
+				else this.broadcast(payload);
+			};
+		}
+	}
+	/** URL of the running server, or null if not started. */
+	get url() {
+		return this._url;
+	}
+	/** Register a factory that creates a session for each new WebSocket client. */
+	setSessionFactory(fn) {
+		this.createSessionCallback = fn;
+	}
+	/** Start the HTTP + WebSocket server. */
+	async listen() {
+		return new Promise((resolve, reject) => {
+			const server = createServer((req, res) => {
+				if (req.url === "/" || req.url === "/index.html") {
+					res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+					res.end(TERM_CLIENT_HTML);
+				} else {
+					res.writeHead(404);
+					res.end("Not Found");
+				}
+			});
+			server.on("connection", (socket) => {
+				this.sockets.add(socket);
+				socket.on("close", () => this.sockets.delete(socket));
+			});
+			server.on("error", (err) => {
+				server.close();
+				reject(err);
+			});
+			const bindHost = this.host === "localhost" ? "127.0.0.1" : this.host;
+			server.listen({
+				port: this.port,
+				host: bindHost,
+				exclusive: true
+			}, () => {
+				this.server = server;
+				const addr = server.address();
+				if (typeof addr === "object" && addr) this.port = addr.port;
+				this._url = `http://127.0.0.1:${this.port}`;
+				this.wss = new WebSocketServer({ server });
+				this.wss.on("connection", (ws, req) => this.onConnection(ws, req));
+				resolve({
+					port: this.port,
+					host: this.host
+				});
+			});
+		});
+	}
+	/** Shut down the server and disconnect all clients. */
+	async close() {
+		for (const ws of this.clients) ws.terminate();
+		this.clients.clear();
+		this.sessionForClient.clear();
+		if (this.wss) {
+			this.wss.close();
+			this.wss = null;
+		}
+		if (this.server) {
+			this.server.close();
+			for (const socket of this.sockets) socket.destroy();
+			this.sockets.clear();
+			this.server = null;
+		}
+		this._url = null;
+	}
+	async write(content, options) {
+		if (options?.format && options.format !== "text") throw new Error(`Term backend does not support format: ${options.format}`);
+		if (this.testMode) {
+			this.outputHandler(content);
+			return;
+		}
+		this.outputHandler(content);
+	}
+	async read(options) {
+		const timeout = options?.timeout ?? 0;
+		if (timeout > 0) return withTimeout(this.inputSource.readLine(), timeout);
+		return this.inputSource.readLine();
+	}
+	async prompt(options) {
+		if (this.testMode) return this.ttyStylePrompt(options);
+		const msg = JSON.stringify({
+			type: "prompt",
+			message: options.message,
+			promptType: options.type,
+			options: options.options
+		});
+		this.pendingPromptMessage = msg;
+		if (this.clients.size > 0) this.broadcast(msg);
+		else this.pendingMessages.push(msg);
+		return new Promise((resolve) => {
+			this.promptResolve = resolve;
+		});
+	}
+	async notify(message) {
+		if (this.testMode) {
+			this.outputHandler(`${message}\n`);
+			return;
+		}
+		this.broadcast(JSON.stringify({
+			type: "notify",
+			message
+		}));
+	}
+	async clear() {
+		if (this.testMode) {
+			this.outputHandler("\x1B[2J\x1B[H");
+			return;
+		}
+		this.broadcast(JSON.stringify({ type: "clear" }));
+	}
+	hasPendingInput() {
+		return this.inputSource.hasPending();
+	}
+	getViewport() {
+		return {
+			cols: this.viewportCols,
+			rows: this.viewportRows
+		};
+	}
+	async dispose() {
+		await this.close();
+	}
+	onConnection(ws, req) {
+		const origin = req.headers.origin;
+		if (typeof origin === "string" && origin && !this.isAllowedWsOrigin(origin)) {
+			ws.close(1008, "Invalid origin");
+			return;
+		}
+		this.clients.add(ws);
+		let sessionId;
+		if (this.createSessionCallback) {
+			const created = this.createSessionCallback(this.type);
+			sessionId = created.sessionId;
+			this.sessionForClient.set(ws, sessionId);
+			ws.send(JSON.stringify({
+				type: "session",
+				sessionId,
+				sessionToken: created.sessionToken ?? null
+			}));
+		}
+		for (const msg of this.pendingMessages) ws.send(msg);
+		this.pendingMessages = [];
+		if (this.pendingPromptMessage && this.promptResolve) ws.send(this.pendingPromptMessage);
+		ws.on("message", (data) => {
+			try {
+				const msg = JSON.parse(data.toString());
+				this.onMessage(msg);
+			} catch {}
+		});
+		ws.on("close", () => {
+			this.clients.delete(ws);
+			if (sessionId) this.sessionForClient.delete(ws);
+		});
+	}
+	onMessage(msg) {
+		switch (msg.type) {
+			case "line": {
+				const content = String(msg.content ?? "");
+				this.inputSource.push?.(content);
+				break;
+			}
+			case "prompt_response":
+				if (this.promptResolve) {
+					const resolve = this.promptResolve;
+					this.promptResolve = null;
+					this.pendingPromptMessage = null;
+					resolve(msg.value);
+				}
+				break;
+			case "resize":
+				if (typeof msg.cols === "number") this.viewportCols = msg.cols;
+				if (typeof msg.rows === "number") this.viewportRows = msg.rows;
+				break;
+		}
+	}
+	broadcast(data) {
+		for (const ws of this.clients) if (ws.readyState === 1) ws.send(data);
+	}
+	isLoopbackHost(hostname) {
+		return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1";
+	}
+	isAllowedWsOrigin(origin) {
+		try {
+			const u = new URL(origin);
+			if (!this.isLoopbackHost(u.hostname)) return false;
+			return (u.port || (u.protocol === "https:" ? "443" : "80")) === String(this.port);
+		} catch {
+			return false;
+		}
+	}
+	/** TTY-style prompt for test mode */
+	async ttyStylePrompt(options) {
+		const { message, type } = options;
+		switch (type) {
+			case "text":
+			case "password":
+				this.outputHandler(`${message} `);
+				return (await this.read()).trim();
+			case "confirm":
+				this.outputHandler(`${message} (y/n) `);
+				return (await this.read()).trim().toLowerCase().startsWith("y");
+			case "select": {
+				if (!options.options || options.options.length === 0) throw new Error("select prompt requires options");
+				this.outputHandler(`${message}\n`);
+				for (let i = 0; i < options.options.length; i++) this.outputHandler(`  ${i + 1}. ${options.options[i]}\n`);
+				this.outputHandler("Choice: ");
+				const input = await this.read();
+				const idx = Number.parseInt(input.trim(), 10) - 1;
+				if (idx >= 0 && idx < options.options.length) return options.options[idx];
+				return options.options[0];
+			}
+			case "multiselect":
+				if (!options.options || options.options.length === 0) throw new Error("multiselect prompt requires options");
+				this.outputHandler(`${message}\n`);
+				for (let i = 0; i < options.options.length; i++) this.outputHandler(`  ${i + 1}. ${options.options[i]}\n`);
+				this.outputHandler("Choices (comma-separated): ");
+				return (await this.read()).split(",").map((s) => Number.parseInt(s.trim(), 10) - 1).filter((i) => i >= 0 && i < options.options.length).map((i) => options.options[i]);
+			default: throw new Error(`Unknown prompt type: ${type}`);
+		}
+	}
+};
+function withTimeout(promise, ms) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error("Input timeout")), ms);
+		promise.then((val) => {
+			clearTimeout(timer);
+			resolve(val);
+		}, (err) => {
+			clearTimeout(timer);
+			reject(err);
+		});
+	});
+}
+
+//#endregion
+export { TermBackend };
+//# sourceMappingURL=term.mjs.map

package/dist/term.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"term.mjs","names":[],"sources":["../src/term.ts"],"sourcesContent":["import { createServer, type IncomingMessage, type Server, type ServerResponse } from \"node:http\";\nimport type { Socket } from \"node:net\";\nimport { type WebSocket, WebSocketServer } from \"ws\";\nimport type {\n  PromptOptions,\n  PromptResult,\n  ReadOptions,\n  UIBackend,\n  ViewportInfo,\n  WriteOptions,\n} from \"./backend.js\";\nimport { TERM_CLIENT_HTML } from \"./term-page.js\";\nimport { createMockInputSource, type TTYInputSource } from \"./tty.js\";\n\nexport interface TermBackendOptions {\n  /** Port to listen on (0 = OS-assigned random port) */\n  port?: number;\n  /** Host to bind to */\n  host?: string;\n  /** For testing: custom input source (bypasses WebSocket) */\n  inputSource?: TTYInputSource & { push?: (line: string) => void };\n  /** For testing: custom output handler (bypasses WebSocket) */\n  stdout?: { write(data: string): boolean };\n}\n\n/**\n * TermBackend — HTTP + WebSocket based xterm.js terminal.\n *\n * Serves an xterm.js web page and communicates via WebSocket.\n * Line-based I/O: client sends complete lines on Enter, server writes output text.\n */\nexport class TermBackend implements UIBackend {\n  readonly type = \"term\";\n  readonly supportedFormats = [\"text\"];\n  readonly capabilities = [\"text\"];\n\n  private port: number;\n  private host: string;\n  private server: Server | null = null;\n  private wss: WebSocketServer | null = null;\n  private clients = new Set<WebSocket>();\n  private sockets = new Set<Socket>();\n\n  private inputSource: TTYInputSource & { push?: (line: string) => void };\n  private outputHandler: (data: string) => void;\n\n  /** Queue for messages sent before any client connects */\n  private pendingMessages: string[] = [];\n\n  /** Pending prompt resolve */\n  private promptResolve: ((value: PromptResult) => void) | null = null;\n  /** Pending prompt message — re-sent on client reconnect */\n  private pendingPromptMessage: string | null = null;\n\n  /** Viewport info from last resize */\n  private viewportCols = 80;\n  private viewportRows = 24;\n\n  private testMode: boolean;\n  private _url: string | null = null;\n\n  /** Per-client session tracking */\n  private sessionForClient = new Map<WebSocket, string>();\n  private createSessionCallback:\n    | ((\n        endpoint: string,\n        requestedSessionId?: string,\n        requestedSessionToken?: string,\n        caps?: Record<string, unknown>,\n      ) => { sessionId: string; sessionToken?: string })\n    | null = null;\n\n  constructor(options: TermBackendOptions = {}) {\n    this.port = options.port ?? 0;\n    this.host = options.host ?? \"localhost\";\n\n    if (options.inputSource) {\n      this.testMode = true;\n      this.inputSource = options.inputSource;\n      this.outputHandler = options.stdout\n        ? (data) => {\n            options.stdout!.write(data);\n          }\n        : () => {};\n    } else {\n      this.testMode = false;\n      const queue = createMockInputSource();\n      this.inputSource = queue;\n      this.outputHandler = (data) => {\n        const payload = JSON.stringify({ type: \"output\", data });\n        if (this.clients.size === 0) {\n          this.pendingMessages.push(payload);\n        } else {\n          this.broadcast(payload);\n        }\n      };\n    }\n  }\n\n  /** URL of the running server, or null if not started. */\n  get url(): string | null {\n    return this._url;\n  }\n\n  /** Register a factory that creates a session for each new WebSocket client. */\n  setSessionFactory(\n    fn: (\n      endpoint: string,\n      requestedSessionId?: string,\n      requestedSessionToken?: string,\n      caps?: Record<string, unknown>,\n    ) => { sessionId: string; sessionToken?: string },\n  ): void {\n    this.createSessionCallback = fn;\n  }\n\n  /** Start the HTTP + WebSocket server. */\n  async listen(): Promise<{ port: number; host: string }> {\n    return new Promise((resolve, reject) => {\n      const server = createServer((req: IncomingMessage, res: ServerResponse) => {\n        if (req.url === \"/\" || req.url === \"/index.html\") {\n          res.writeHead(200, { \"Content-Type\": \"text/html; charset=utf-8\" });\n          res.end(TERM_CLIENT_HTML);\n        } else {\n          res.writeHead(404);\n          res.end(\"Not Found\");\n        }\n      });\n\n      server.on(\"connection\", (socket: Socket) => {\n        this.sockets.add(socket);\n        socket.on(\"close\", () => this.sockets.delete(socket));\n      });\n\n      server.on(\"error\", (err) => {\n        server.close();\n        reject(err);\n      });\n\n      const bindHost = this.host === \"localhost\" ? \"127.0.0.1\" : this.host;\n      server.listen({ port: this.port, host: bindHost, exclusive: true }, () => {\n        this.server = server;\n\n        const addr = server.address();\n        if (typeof addr === \"object\" && addr) {\n          this.port = addr.port;\n        }\n\n        this._url = `http://127.0.0.1:${this.port}`;\n\n        this.wss = new WebSocketServer({ server });\n        this.wss.on(\"connection\", (ws, req) => this.onConnection(ws, req));\n\n        resolve({ port: this.port, host: this.host });\n      });\n    });\n  }\n\n  /** Shut down the server and disconnect all clients. */\n  async close(): Promise<void> {\n    for (const ws of this.clients) {\n      ws.terminate();\n    }\n    this.clients.clear();\n    this.sessionForClient.clear();\n\n    if (this.wss) {\n      this.wss.close();\n      this.wss = null;\n    }\n\n    if (this.server) {\n      this.server.close();\n      for (const socket of this.sockets) {\n        socket.destroy();\n      }\n      this.sockets.clear();\n      this.server = null;\n    }\n\n    this._url = null;\n  }\n\n  // ─── UIBackend Interface ──────────────────────────────────\n\n  async write(content: string, options?: WriteOptions): Promise<void> {\n    if (options?.format && options.format !== \"text\") {\n      throw new Error(`Term backend does not support format: ${options.format}`);\n    }\n\n    if (this.testMode) {\n      this.outputHandler(content);\n      return;\n    }\n\n    this.outputHandler(content);\n  }\n\n  async read(options?: ReadOptions): Promise<string> {\n    const timeout = options?.timeout ?? 0;\n    if (timeout > 0) {\n      return withTimeout(this.inputSource.readLine(), timeout);\n    }\n    return this.inputSource.readLine();\n  }\n\n  async prompt(options: PromptOptions): Promise<PromptResult> {\n    if (this.testMode) {\n      return this.ttyStylePrompt(options);\n    }\n\n    const msg = JSON.stringify({\n      type: \"prompt\",\n      message: options.message,\n      promptType: options.type,\n      options: options.options,\n    });\n\n    this.pendingPromptMessage = msg;\n\n    if (this.clients.size > 0) {\n      this.broadcast(msg);\n    } else {\n      this.pendingMessages.push(msg);\n    }\n\n    return new Promise((resolve) => {\n      this.promptResolve = resolve;\n    });\n  }\n\n  async notify(message: string): Promise<void> {\n    if (this.testMode) {\n      this.outputHandler(`${message}\\n`);\n      return;\n    }\n    this.broadcast(JSON.stringify({ type: \"notify\", message }));\n  }\n\n  async clear(): Promise<void> {\n    if (this.testMode) {\n      this.outputHandler(\"\\x1b[2J\\x1b[H\");\n      return;\n    }\n    this.broadcast(JSON.stringify({ type: \"clear\" }));\n  }\n\n  hasPendingInput(): boolean {\n    return this.inputSource.hasPending();\n  }\n\n  getViewport(): ViewportInfo {\n    return { cols: this.viewportCols, rows: this.viewportRows };\n  }\n\n  async dispose(): Promise<void> {\n    await this.close();\n  }\n\n  // ─── Private ──────────────────────────────────────────────\n\n  private onConnection(ws: WebSocket, req: IncomingMessage): void {\n    const origin = req.headers.origin;\n    if (typeof origin === \"string\" && origin && !this.isAllowedWsOrigin(origin)) {\n      ws.close(1008, \"Invalid origin\");\n      return;\n    }\n\n    this.clients.add(ws);\n\n    // Allocate session for this client\n    let sessionId: string | undefined;\n    if (this.createSessionCallback) {\n      const created = this.createSessionCallback(this.type);\n      sessionId = created.sessionId;\n      this.sessionForClient.set(ws, sessionId);\n      ws.send(\n        JSON.stringify({\n          type: \"session\",\n          sessionId,\n          sessionToken: created.sessionToken ?? null,\n        }),\n      );\n    }\n\n    // Flush pending messages\n    for (const msg of this.pendingMessages) {\n      ws.send(msg);\n    }\n    this.pendingMessages = [];\n\n    // Re-send pending prompt to reconnecting client\n    if (this.pendingPromptMessage && this.promptResolve) {\n      ws.send(this.pendingPromptMessage);\n    }\n\n    ws.on(\"message\", (data) => {\n      try {\n        const msg = JSON.parse(data.toString()) as Record<string, unknown>;\n        this.onMessage(msg);\n      } catch {\n        // Ignore malformed messages\n      }\n    });\n\n    ws.on(\"close\", () => {\n      this.clients.delete(ws);\n      if (sessionId) this.sessionForClient.delete(ws);\n    });\n  }\n\n  private onMessage(msg: Record<string, unknown>): void {\n    switch (msg.type) {\n      case \"line\": {\n        const content = String(msg.content ?? \"\");\n        this.inputSource.push?.(content);\n        break;\n      }\n      case \"prompt_response\": {\n        if (this.promptResolve) {\n          const resolve = this.promptResolve;\n          this.promptResolve = null;\n          this.pendingPromptMessage = null;\n          resolve(msg.value as PromptResult);\n        }\n        break;\n      }\n      case \"resize\": {\n        if (typeof msg.cols === \"number\") this.viewportCols = msg.cols;\n        if (typeof msg.rows === \"number\") this.viewportRows = msg.rows;\n        break;\n      }\n    }\n  }\n\n  private broadcast(data: string): void {\n    for (const ws of this.clients) {\n      if (ws.readyState === 1 /* OPEN */) {\n        ws.send(data);\n      }\n    }\n  }\n\n  private isLoopbackHost(hostname: string): boolean {\n    return hostname === \"localhost\" || hostname === \"127.0.0.1\" || hostname === \"::1\";\n  }\n\n  private isAllowedWsOrigin(origin: string): boolean {\n    try {\n      const u = new URL(origin);\n      if (!this.isLoopbackHost(u.hostname)) return false;\n      const port = u.port || (u.protocol === \"https:\" ? \"443\" : \"80\");\n      return port === String(this.port);\n    } catch {\n      return false;\n    }\n  }\n\n  /** TTY-style prompt for test mode */\n  private async ttyStylePrompt(options: PromptOptions): Promise<PromptResult> {\n    const { message, type } = options;\n\n    switch (type) {\n      case \"text\":\n      case \"password\": {\n        this.outputHandler(`${message} `);\n        const input = await this.read();\n        return input.trim();\n      }\n      case \"confirm\": {\n        this.outputHandler(`${message} (y/n) `);\n        const input = await this.read();\n        return input.trim().toLowerCase().startsWith(\"y\");\n      }\n      case \"select\": {\n        if (!options.options || options.options.length === 0) {\n          throw new Error(\"select prompt requires options\");\n        }\n        this.outputHandler(`${message}\\n`);\n        for (let i = 0; i < options.options.length; i++) {\n          this.outputHandler(`  ${i + 1}. ${options.options[i]}\\n`);\n        }\n        this.outputHandler(\"Choice: \");\n        const input = await this.read();\n        const idx = Number.parseInt(input.trim(), 10) - 1;\n        if (idx >= 0 && idx < options.options.length) {\n          return options.options[idx]!;\n        }\n        return options.options[0]!;\n      }\n      case \"multiselect\": {\n        if (!options.options || options.options.length === 0) {\n          throw new Error(\"multiselect prompt requires options\");\n        }\n        this.outputHandler(`${message}\\n`);\n        for (let i = 0; i < options.options.length; i++) {\n          this.outputHandler(`  ${i + 1}. ${options.options[i]}\\n`);\n        }\n        this.outputHandler(\"Choices (comma-separated): \");\n        const input = await this.read();\n        const indices = input\n          .split(\",\")\n          .map((s) => Number.parseInt(s.trim(), 10) - 1)\n          .filter((i) => i >= 0 && i < options.options!.length);\n        return indices.map((i) => options.options![i]!);\n      }\n      default:\n        throw new Error(`Unknown prompt type: ${type}`);\n    }\n  }\n}\n\nfunction withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n  return new Promise((resolve, reject) => {\n    const timer = setTimeout(() => reject(new Error(\"Input timeout\")), ms);\n    promise.then(\n      (val) => {\n        clearTimeout(timer);\n        resolve(val);\n      },\n      (err) => {\n        clearTimeout(timer);\n        reject(err);\n      },\n    );\n  });\n}\n"],"mappings":"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"}

package/dist/tty.cjs

@@ -0,0 +1,136 @@
+
+//#region src/tty.ts
+var TTYBackend = class {
+	type = "tty";
+	supportedFormats = ["text"];
+	capabilities = ["text"];
+	stdout;
+	inputSource;
+	inputTimeout;
+	constructor(options = {}) {
+		this.stdout = options.stdout ?? process.stdout;
+		this.inputSource = options.inputSource ?? createStdinSource();
+		this.inputTimeout = options.inputTimeout ?? 0;
+	}
+	async write(content, options) {
+		if (options?.format && options.format !== "text") throw new Error(`TTY backend does not support format: ${options.format}`);
+		this.stdout.write(content);
+	}
+	async read(options) {
+		const timeout = options?.timeout ?? this.inputTimeout;
+		if (timeout > 0) return withTimeout(this.inputSource.readLine(), timeout);
+		return this.inputSource.readLine();
+	}
+	async prompt(options) {
+		const { message, type } = options;
+		switch (type) {
+			case "text":
+			case "password":
+				this.stdout.write(`${message} `);
+				return (await this.read()).trim();
+			case "confirm":
+				this.stdout.write(`${message} (y/n) `);
+				return (await this.read()).trim().toLowerCase().startsWith("y");
+			case "select": {
+				if (!options.options || options.options.length === 0) throw new Error("select prompt requires options");
+				this.stdout.write(`${message}\n`);
+				for (let i = 0; i < options.options.length; i++) this.stdout.write(`  ${i + 1}. ${options.options[i]}\n`);
+				this.stdout.write("Choice: ");
+				const input = await this.read();
+				const idx = Number.parseInt(input.trim(), 10) - 1;
+				if (idx >= 0 && idx < options.options.length) return options.options[idx];
+				return options.options[0];
+			}
+			case "multiselect":
+				if (!options.options || options.options.length === 0) throw new Error("multiselect prompt requires options");
+				this.stdout.write(`${message}\n`);
+				for (let i = 0; i < options.options.length; i++) this.stdout.write(`  ${i + 1}. ${options.options[i]}\n`);
+				this.stdout.write("Choices (comma-separated): ");
+				return (await this.read()).split(",").map((s) => Number.parseInt(s.trim(), 10) - 1).filter((i) => i >= 0 && i < options.options.length).map((i) => options.options[i]);
+			default: throw new Error(`Unknown prompt type: ${type}`);
+		}
+	}
+	async notify(message) {
+		this.stdout.write(`${message}\n`);
+	}
+	async clear() {
+		this.stdout.write("\x1B[2J\x1B[H");
+	}
+	hasPendingInput() {
+		return this.inputSource.hasPending();
+	}
+	getViewport() {
+		if (typeof process !== "undefined" && process.stdout && "columns" in process.stdout) return {
+			cols: process.stdout.columns,
+			rows: process.stdout.rows
+		};
+		return {};
+	}
+	async dispose() {}
+};
+/** Create a stdin-based input source (production use) */
+function createStdinSource() {
+	const pendingLines = [];
+	let pendingResolve = null;
+	if (typeof process !== "undefined" && process.stdin) {
+		process.stdin.setEncoding("utf8");
+		process.stdin.on("data", (data) => {
+			const lines = data.split("\n").filter((l) => l.length > 0);
+			for (const line of lines) if (pendingResolve) {
+				const resolve = pendingResolve;
+				pendingResolve = null;
+				resolve(line);
+			} else pendingLines.push(line);
+		});
+	}
+	return {
+		readLine() {
+			if (pendingLines.length > 0) return Promise.resolve(pendingLines.shift());
+			return new Promise((resolve) => {
+				pendingResolve = resolve;
+			});
+		},
+		hasPending() {
+			return pendingLines.length > 0;
+		}
+	};
+}
+/** Create a mock input source for testing */
+function createMockInputSource(inputs = []) {
+	const queue = [...inputs];
+	let pendingResolve = null;
+	return {
+		readLine() {
+			if (queue.length > 0) return Promise.resolve(queue.shift());
+			return new Promise((resolve) => {
+				pendingResolve = resolve;
+			});
+		},
+		hasPending() {
+			return queue.length > 0;
+		},
+		push(line) {
+			if (pendingResolve) {
+				const resolve = pendingResolve;
+				pendingResolve = null;
+				resolve(line);
+			} else queue.push(line);
+		}
+	};
+}
+function withTimeout(promise, ms) {
+	return new Promise((resolve, reject) => {
+		const timer = setTimeout(() => reject(/* @__PURE__ */ new Error("Input timeout")), ms);
+		promise.then((val) => {
+			clearTimeout(timer);
+			resolve(val);
+		}, (err) => {
+			clearTimeout(timer);
+			reject(err);
+		});
+	});
+}
+
+//#endregion
+exports.TTYBackend = TTYBackend;
+exports.createMockInputSource = createMockInputSource;

package/dist/tty.d.cts

@@ -0,0 +1,53 @@
+import { PromptOptions, PromptResult, ReadOptions, UIBackend, ViewportInfo, WriteOptions } from "./backend.cjs";
+
+//#region src/tty.d.ts
+/**
+ * TTY Backend — stdin/stdout based terminal I/O.
+ *
+ * For testing, provide mock stdin/stdout via options.
+ */
+interface TTYBackendOptions {
+  /** Custom writable stream (defaults to process.stdout) */
+  stdout?: {
+    write(data: string): boolean;
+  };
+  /** Custom input source for testing */
+  inputSource?: TTYInputSource;
+  /** Input timeout in ms (0 = no timeout) */
+  inputTimeout?: number;
+}
+/**
+ * Input source abstraction for testability.
+ * In production, reads from process.stdin.
+ * In tests, provides programmatic input.
+ */
+interface TTYInputSource {
+  /** Read a line of input */
+  readLine(): Promise<string>;
+  /** Check if input is available */
+  hasPending(): boolean;
+}
+declare class TTYBackend implements UIBackend {
+  readonly type = "tty";
+  readonly supportedFormats: string[];
+  readonly capabilities: string[];
+  private stdout;
+  private inputSource;
+  private inputTimeout;
+  constructor(options?: TTYBackendOptions);
+  write(content: string, options?: WriteOptions): Promise<void>;
+  read(options?: ReadOptions): Promise<string>;
+  prompt(options: PromptOptions): Promise<PromptResult>;
+  notify(message: string): Promise<void>;
+  clear(): Promise<void>;
+  hasPendingInput(): boolean;
+  getViewport(): ViewportInfo;
+  dispose(): Promise<void>;
+}
+/** Create a mock input source for testing */
+declare function createMockInputSource(inputs?: string[]): TTYInputSource & {
+  push(line: string): void;
+};
+//#endregion
+export { TTYBackend, TTYBackendOptions, TTYInputSource, createMockInputSource };
+//# sourceMappingURL=tty.d.cts.map

package/dist/tty.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.cts","names":[],"sources":["../src/tty.ts"],"mappings":";;;;;AAcA;;;UAAiB,iBAAA;EAEf;EAAA,MAAA;IAAW,KAAA,CAAM,IAAA;EAAA;EAEH;EAAd,WAAA,GAAc,cAAA;EAEF;EAAZ,YAAA;AAAA;;;;;;UAQe,cAAA;EAIL;EAFV,QAAA,IAAY,OAAA;EAKD;EAHX,UAAA;AAAA;AAAA,cAGW,UAAA,YAAsB,SAAA;EAAA,SACxB,IAAA;EAAA,SACA,gBAAA;EAAA,SACA,YAAA;EAAA,QAED,MAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;cAEI,OAAA,GAAS,iBAAA;EAMf,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,YAAA,GAAe,OAAA;EAOhD,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA;EAQ7B,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EAoDxC,MAAA,CAAO,OAAA,WAAkB,OAAA;EAIzB,KAAA,CAAA,GAAS,OAAA;EAKf,eAAA,CAAA;EAIA,WAAA,CAAA,GAAe,YAAA;EAUT,OAAA,CAAA,GAAW,OAAA;AAAA;;iBA0CH,qBAAA,CAAsB,MAAA,cAAwB,cAAA;EAC5D,IAAA,CAAK,IAAA;AAAA"}

package/dist/tty.d.mts

@@ -0,0 +1,53 @@
+import { PromptOptions, PromptResult, ReadOptions, UIBackend, ViewportInfo, WriteOptions } from "./backend.mjs";
+
+//#region src/tty.d.ts
+/**
+ * TTY Backend — stdin/stdout based terminal I/O.
+ *
+ * For testing, provide mock stdin/stdout via options.
+ */
+interface TTYBackendOptions {
+  /** Custom writable stream (defaults to process.stdout) */
+  stdout?: {
+    write(data: string): boolean;
+  };
+  /** Custom input source for testing */
+  inputSource?: TTYInputSource;
+  /** Input timeout in ms (0 = no timeout) */
+  inputTimeout?: number;
+}
+/**
+ * Input source abstraction for testability.
+ * In production, reads from process.stdin.
+ * In tests, provides programmatic input.
+ */
+interface TTYInputSource {
+  /** Read a line of input */
+  readLine(): Promise<string>;
+  /** Check if input is available */
+  hasPending(): boolean;
+}
+declare class TTYBackend implements UIBackend {
+  readonly type = "tty";
+  readonly supportedFormats: string[];
+  readonly capabilities: string[];
+  private stdout;
+  private inputSource;
+  private inputTimeout;
+  constructor(options?: TTYBackendOptions);
+  write(content: string, options?: WriteOptions): Promise<void>;
+  read(options?: ReadOptions): Promise<string>;
+  prompt(options: PromptOptions): Promise<PromptResult>;
+  notify(message: string): Promise<void>;
+  clear(): Promise<void>;
+  hasPendingInput(): boolean;
+  getViewport(): ViewportInfo;
+  dispose(): Promise<void>;
+}
+/** Create a mock input source for testing */
+declare function createMockInputSource(inputs?: string[]): TTYInputSource & {
+  push(line: string): void;
+};
+//#endregion
+export { TTYBackend, TTYBackendOptions, TTYInputSource, createMockInputSource };
+//# sourceMappingURL=tty.d.mts.map

package/dist/tty.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.mts","names":[],"sources":["../src/tty.ts"],"mappings":";;;;;AAcA;;;UAAiB,iBAAA;EAEf;EAAA,MAAA;IAAW,KAAA,CAAM,IAAA;EAAA;EAEH;EAAd,WAAA,GAAc,cAAA;EAEF;EAAZ,YAAA;AAAA;;;;;;UAQe,cAAA;EAIL;EAFV,QAAA,IAAY,OAAA;EAKD;EAHX,UAAA;AAAA;AAAA,cAGW,UAAA,YAAsB,SAAA;EAAA,SACxB,IAAA;EAAA,SACA,gBAAA;EAAA,SACA,YAAA;EAAA,QAED,MAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;cAEI,OAAA,GAAS,iBAAA;EAMf,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,YAAA,GAAe,OAAA;EAOhD,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA;EAQ7B,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EAoDxC,MAAA,CAAO,OAAA,WAAkB,OAAA;EAIzB,KAAA,CAAA,GAAS,OAAA;EAKf,eAAA,CAAA;EAIA,WAAA,CAAA,GAAe,YAAA;EAUT,OAAA,CAAA,GAAW,OAAA;AAAA;;iBA0CH,qBAAA,CAAsB,MAAA,cAAwB,cAAA;EAC5D,IAAA,CAAK,IAAA;AAAA"}