@aisa-one/cli 0.3.0 → 0.5.1

package/dist/commands/connect-terminal.d.ts

@@ -0,0 +1,65 @@
+import { type Lang } from "./flow.js";
+import type { ClientInfo, Selection } from "./connect-shared.js";
+import type { LiveServer } from "./mcp.js";
+import { cells } from "../utils/width.js";
+/** A client as the flow sees it: detection plus whether we could install it. */
+export interface FlowClient extends ClientInfo {
+    installable: boolean;
+    command?: string;
+}
+/** Same rule the page applies, so both offer the same rows. */
+export declare function flowClients(clients: ClientInfo[], canInstall: boolean): FlowClient[];
+/**
+ * The connect flow, rendered in the terminal.
+ *
+ * Not a fallback for the page — the same flow, drawn differently. Every
+ * question, option and sentence comes from flow.ts, which is also what the
+ * page renders, so the two cannot describe the same choice in different
+ * words. A menu numbered here matches the card order there because both sort
+ * by `agentRank`.
+ *
+ * Two reasons this exists rather than "open the page":
+ *
+ *  · A machine with no browser. Linux without a desktop, an SSH session, a
+ *    container — where printing a localhost URL is not an offer, it is a
+ *    dead end.
+ *  · A browser that did not work. The page failing to open used to end the
+ *    run; now it drops through to here.
+ *
+ * ── Staying in step with the page ─────────────────────────────────────────
+ * Both surfaces read and write one draft on the server (RunState.draft).
+ * Answering here POSTs the choice, so a page open at the same time shows it;
+ * between questions this polls, so a choice made in the page appears here.
+ * Neither is the master.
+ */
+export interface TerminalFlowOptions {
+    baseUrl: string;
+    token: string;
+    lang: Lang;
+    servers: LiveServer[];
+    clients: FlowClient[];
+    /** Set when this is the only surface — no page was opened. */
+    headless: boolean;
+}
+/** Strip the markup the page needs and the terminal cannot show. */
+export declare function plain(html: string): string;
+/** Two columns wide in a terminal: CJK, and the punctuation that comes with it. */
+/** Kept as a name because wrap() reads better with it; the maths is shared. */
+export declare const displayWidth: typeof cells;
+/**
+ * Wrap to the terminal width.
+ *
+ * Splitting on spaces alone is wrong for Chinese, which has none: a whole
+ * sentence arrives as one "word" and the line runs far past the margin —
+ * observed on the welcome step, where a paragraph overflowed by half a line.
+ * So a run that is itself too wide is broken between characters, and width is
+ * measured in cells rather than characters because CJK glyphs take two.
+ */
+export declare function wrap(text: string, width?: number): string[];
+/**
+ * Walk the flow in the terminal and return what was chosen.
+ *
+ * Returns undefined when the user abandons it, which the caller treats the
+ * same way as closing the page.
+ */
+export declare function runTerminalFlow(o: TerminalFlowOptions): Promise<Selection | undefined>;