@h-rig/cli 0.0.6-alpha.80 → 0.0.6-alpha.81

package/dist/src/app-opentui/pi-pty-host.d.ts

@@ -0,0 +1,64 @@
+import { StyledText } from "@opentui/core";
+export type PiPtyHostStatus = "starting" | "running" | "exited" | "failed";
+export type PiPtyHostSnapshot = {
+    readonly runId: string;
+    readonly status: PiPtyHostStatus;
+    readonly cols: number;
+    readonly rows: number;
+    readonly lines: readonly string[];
+    readonly styledLines?: readonly StyledText[];
+    readonly message?: string;
+    readonly exitCode?: number;
+    readonly signal?: string | null;
+};
+type PiPtyInput = string | Uint8Array<ArrayBufferLike> | BufferSource;
+export type PiPtyHostOptions = {
+    readonly runId: string;
+    readonly projectRoot: string;
+    readonly cols: number;
+    readonly rows: number;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly onSnapshot?: (snapshot: PiPtyHostSnapshot) => void;
+    readonly onExit?: (snapshot: PiPtyHostSnapshot) => void;
+    readonly onError?: (error: unknown, snapshot: PiPtyHostSnapshot) => void;
+};
+export declare function getActivePiHost(): PiPtyHost | null;
+export declare function startPiPtyHost(options: PiPtyHostOptions): Promise<PiPtyHost>;
+export declare function stopActivePiHost(reason?: string): void;
+export declare class PiPtyHost {
+    private readonly runId;
+    private readonly projectRoot;
+    private readonly onSnapshot?;
+    private readonly onExit?;
+    private readonly onError?;
+    private readonly terminal;
+    private readonly disposables;
+    private readonly decoder;
+    private proc;
+    private pty;
+    private status;
+    private cols;
+    private rows;
+    private message;
+    private exitCode;
+    private signal;
+    private notifyTimer;
+    private _disposed;
+    constructor(options: PiPtyHostOptions);
+    get disposed(): boolean;
+    get snapshot(): PiPtyHostSnapshot;
+    start(): Promise<void>;
+    write(data: PiPtyInput): void;
+    resize(cols: number, rows: number): void;
+    detach(): PiPtyHostSnapshot;
+    dispose(reason?: string, options?: {
+        readonly kill?: boolean;
+        readonly notify?: boolean;
+    }): void;
+    private handlePtyData;
+    private emitSnapshotSoon;
+    private createSnapshot;
+    private registerTerminalResponders;
+    private respondToRawTerminalQueries;
+}
+export {};

package/dist/src/app-opentui/pi-pty-host.js

@@ -0,0 +1,384 @@
+// @bun
+// packages/cli/src/app-opentui/pi-pty-host.ts
+import { fileURLToPath } from "url";
+import { basename } from "path";
+import { RGBA, StyledText, TextAttributes } from "@opentui/core";
+import { Terminal as XtermTerminal } from "@xterm/headless";
+var MIN_COLS = 40;
+var MIN_ROWS = 12;
+var MAX_ROWS = 300;
+var MAX_SNAPSHOT_LINES = 1200;
+var fallbackChildScriptPath = fileURLToPath(new URL("./pi-host-child.ts", import.meta.url));
+var activeHost = null;
+function clampCols(cols) {
+  return Math.max(MIN_COLS, Math.trunc(cols || 100));
+}
+function clampRows(rows) {
+  return Math.max(MIN_ROWS, Math.min(MAX_ROWS, Math.trunc(rows || 35)));
+}
+var XTERM_COLOR_MODE_INDEXED_16 = 16777216;
+var XTERM_COLOR_MODE_INDEXED_256 = 33554432;
+var XTERM_COLOR_MODE_RGB = 50331648;
+function rgbaFromXtermColor(mode, value) {
+  if (mode === 1 || mode === 2 || mode === XTERM_COLOR_MODE_INDEXED_16 || mode === XTERM_COLOR_MODE_INDEXED_256) {
+    return RGBA.fromIndex(value);
+  }
+  if (mode === 3 || mode === XTERM_COLOR_MODE_RGB) {
+    return RGBA.fromInts(value >> 16 & 255, value >> 8 & 255, value & 255);
+  }
+  return;
+}
+function textAttributesFromCell(cell) {
+  let attributes = TextAttributes.NONE;
+  if (cell.isBold())
+    attributes |= TextAttributes.BOLD;
+  if (cell.isDim())
+    attributes |= TextAttributes.DIM;
+  if (cell.isItalic())
+    attributes |= TextAttributes.ITALIC;
+  if (cell.isUnderline())
+    attributes |= TextAttributes.UNDERLINE;
+  if (cell.isBlink())
+    attributes |= TextAttributes.BLINK;
+  if (cell.isInverse())
+    attributes |= TextAttributes.INVERSE;
+  if (cell.isInvisible())
+    attributes |= TextAttributes.HIDDEN;
+  if (cell.isStrikethrough())
+    attributes |= TextAttributes.STRIKETHROUGH;
+  return attributes;
+}
+function sameRgba(a, b) {
+  if (!a && !b)
+    return true;
+  return Boolean(a && b && a.equals(b));
+}
+function sameStyle(a, b) {
+  return sameRgba(a.fg, b.fg) && sameRgba(a.bg, b.bg) && (a.attributes ?? 0) === (b.attributes ?? 0);
+}
+function styleFromCell(cell) {
+  return {
+    fg: rgbaFromXtermColor(cell.getFgColorMode(), cell.getFgColor()),
+    bg: rgbaFromXtermColor(cell.getBgColorMode(), cell.getBgColor()),
+    attributes: textAttributesFromCell(cell)
+  };
+}
+function lineToStyledText(line, cols) {
+  if (!line)
+    return new StyledText([{ __isChunk: true, text: "" }]);
+  const chunks = [];
+  let run = "";
+  let runStyle = null;
+  const flush = () => {
+    if (!run)
+      return;
+    chunks.push({
+      __isChunk: true,
+      text: run,
+      ...runStyle?.fg ? { fg: runStyle.fg } : {},
+      ...runStyle?.bg ? { bg: runStyle.bg } : {},
+      ...(runStyle?.attributes ?? 0) !== 0 ? { attributes: runStyle.attributes } : {}
+    });
+    run = "";
+  };
+  for (let index = 0;index < cols; index += 1) {
+    const cell = line.getCell(index);
+    if (!cell) {
+      if (runStyle !== null)
+        flush();
+      runStyle = null;
+      run += " ";
+      continue;
+    }
+    if (cell.getWidth() === 0)
+      continue;
+    const style = styleFromCell(cell);
+    if (!runStyle || !sameStyle(runStyle, style)) {
+      flush();
+      runStyle = style;
+    }
+    run += cell.getChars() || " ";
+  }
+  flush();
+  return new StyledText(chunks.length > 0 ? chunks : [{ __isChunk: true, text: "" }]);
+}
+function childCommandPrefix() {
+  const execName = basename(process.execPath).toLowerCase();
+  const currentEntry = process.argv[1];
+  if ((execName === "bun" || execName === "bun.exe") && currentEntry) {
+    return [process.execPath, currentEntry, "__opentui-pi-host"];
+  }
+  if (currentEntry)
+    return [process.execPath, "__opentui-pi-host"];
+  return [process.execPath, fallbackChildScriptPath];
+}
+function withEnv(base) {
+  const env = {};
+  for (const [key, value] of Object.entries(base ?? process.env)) {
+    if (key === "RIG_PLAIN" || key === "RIG_CLI_PLAIN_HELP")
+      continue;
+    if (typeof value === "string")
+      env[key] = value;
+  }
+  return {
+    ...env,
+    TERM: "xterm-256color",
+    COLORTERM: "truecolor",
+    FORCE_COLOR: env.FORCE_COLOR ?? "1",
+    RIG_OPENTUI_PI_HOST: "1"
+  };
+}
+function getActivePiHost() {
+  return activeHost && !activeHost.disposed ? activeHost : null;
+}
+async function startPiPtyHost(options) {
+  activeHost?.dispose("replace");
+  const host = new PiPtyHost(options);
+  activeHost = host;
+  await host.start();
+  return host;
+}
+function stopActivePiHost(reason = "detach") {
+  activeHost?.dispose(reason);
+  activeHost = null;
+}
+
+class PiPtyHost {
+  runId;
+  projectRoot;
+  onSnapshot;
+  onExit;
+  onError;
+  terminal;
+  disposables = [];
+  decoder = new TextDecoder("utf-8");
+  proc = null;
+  pty = null;
+  status = "starting";
+  cols;
+  rows;
+  message = "starting bundled Pi";
+  exitCode;
+  signal;
+  notifyTimer = null;
+  _disposed = false;
+  constructor(options) {
+    this.runId = options.runId;
+    this.projectRoot = options.projectRoot;
+    this.cols = clampCols(options.cols);
+    this.rows = clampRows(options.rows);
+    this.onSnapshot = options.onSnapshot;
+    this.onExit = options.onExit;
+    this.onError = options.onError;
+    this.terminal = new XtermTerminal({
+      allowProposedApi: true,
+      cols: this.cols,
+      rows: this.rows,
+      scrollback: 5000
+    });
+    this.registerTerminalResponders();
+  }
+  get disposed() {
+    return this._disposed;
+  }
+  get snapshot() {
+    return this.createSnapshot();
+  }
+  async start() {
+    if (this._disposed)
+      throw new Error("Pi PTY host is disposed.");
+    if (typeof Bun.Terminal !== "function") {
+      throw new Error("Bun native PTY is unavailable in this runtime. Rig OpenTUI Pi host requires Bun.Terminal.");
+    }
+    const spawnOptions = {
+      cwd: this.projectRoot,
+      env: withEnv(process.env),
+      terminal: {
+        cols: this.cols,
+        rows: this.rows,
+        name: "xterm-256color",
+        data: (_terminal, data) => this.handlePtyData(data)
+      }
+    };
+    const proc = Bun.spawn([
+      ...childCommandPrefix(),
+      "--run-id",
+      this.runId,
+      "--project-root",
+      this.projectRoot
+    ], spawnOptions);
+    if (!proc.terminal)
+      throw new Error("Bun did not attach a terminal to the bundled Pi child process.");
+    this.proc = proc;
+    this.pty = proc.terminal;
+    this.status = "running";
+    this.message = "bundled Pi running inside Rig";
+    this.emitSnapshotSoon(0);
+    proc.exited.then((exitCode) => {
+      if (this._disposed)
+        return;
+      this.status = exitCode === 0 ? "exited" : "failed";
+      this.exitCode = exitCode;
+      this.signal = null;
+      this.message = exitCode === 0 ? "bundled Pi exited" : `bundled Pi exited with code ${exitCode}`;
+      const snapshot = this.createSnapshot();
+      this.onSnapshot?.(snapshot);
+      this.onExit?.(snapshot);
+      if (activeHost === this)
+        activeHost = null;
+      this.dispose("exit", { kill: false, notify: false });
+    }).catch((error) => {
+      if (this._disposed)
+        return;
+      this.status = "failed";
+      this.message = error instanceof Error ? error.message : String(error);
+      const snapshot = this.createSnapshot();
+      this.onSnapshot?.(snapshot);
+      this.onError?.(error, snapshot);
+      if (activeHost === this)
+        activeHost = null;
+      this.dispose("error", { kill: false, notify: false });
+    });
+  }
+  write(data) {
+    if (this._disposed || !this.pty)
+      return;
+    try {
+      this.pty.write(data);
+    } catch (error) {
+      this.status = "failed";
+      this.message = error instanceof Error ? error.message : String(error);
+      const snapshot = this.createSnapshot();
+      this.onSnapshot?.(snapshot);
+      this.onError?.(error, snapshot);
+    }
+  }
+  resize(cols, rows) {
+    const nextCols = clampCols(cols);
+    const nextRows = clampRows(rows);
+    if (nextCols === this.cols && nextRows === this.rows)
+      return;
+    this.cols = nextCols;
+    this.rows = nextRows;
+    this.terminal.resize(nextCols, nextRows);
+    try {
+      this.pty?.resize(nextCols, nextRows);
+    } catch {}
+    this.emitSnapshotSoon(0);
+  }
+  detach() {
+    this.dispose("detach");
+    return this.createSnapshot("detached from bundled Pi");
+  }
+  dispose(reason = "dispose", options = {}) {
+    if (this._disposed)
+      return;
+    this._disposed = true;
+    if (this.notifyTimer)
+      clearTimeout(this.notifyTimer);
+    this.notifyTimer = null;
+    for (const disposable of this.disposables.splice(0)) {
+      try {
+        disposable.dispose();
+      } catch {}
+    }
+    if (options.kill !== false) {
+      try {
+        this.proc?.kill("SIGTERM");
+      } catch {}
+    }
+    try {
+      this.pty?.close();
+    } catch {}
+    try {
+      this.terminal.dispose();
+    } catch {}
+    if (activeHost === this)
+      activeHost = null;
+    if (options.notify) {
+      this.message = reason;
+      this.onSnapshot?.(this.createSnapshot(reason));
+    }
+  }
+  handlePtyData(data) {
+    if (this._disposed)
+      return;
+    const text = this.decoder.decode(data, { stream: true });
+    this.respondToRawTerminalQueries(text);
+    this.terminal.write(data, () => this.emitSnapshotSoon());
+  }
+  emitSnapshotSoon(delayMs = 16) {
+    if (this._disposed || this.notifyTimer)
+      return;
+    this.notifyTimer = setTimeout(() => {
+      this.notifyTimer = null;
+      if (this._disposed)
+        return;
+      this.onSnapshot?.(this.createSnapshot());
+    }, delayMs);
+  }
+  createSnapshot(message = this.message) {
+    const buffer = this.terminal.buffer.active;
+    const end = buffer.length;
+    const start = Math.max(0, end - MAX_SNAPSHOT_LINES);
+    const lines = [];
+    const styledLines = [];
+    for (let row = start;row < end; row += 1) {
+      const line = buffer.getLine(row);
+      lines.push((line?.translateToString(false) ?? "").slice(0, this.cols));
+      styledLines.push(lineToStyledText(line, this.cols));
+    }
+    while (lines.length < this.rows) {
+      lines.push("");
+      styledLines.push(new StyledText([{ __isChunk: true, text: "" }]));
+    }
+    return {
+      runId: this.runId,
+      status: this.status,
+      cols: this.cols,
+      rows: this.rows,
+      lines,
+      styledLines,
+      message,
+      ...this.exitCode !== undefined ? { exitCode: this.exitCode } : {},
+      ...this.signal !== undefined ? { signal: this.signal } : {}
+    };
+  }
+  registerTerminalResponders() {
+    this.disposables.push(this.terminal.parser.registerCsiHandler({ final: "c" }, (params) => {
+      if (params.length === 0 || params[0] === 0)
+        this.write("\x1B[?62;22c");
+      return false;
+    }));
+    this.disposables.push(this.terminal.parser.registerCsiHandler({ prefix: ">", final: "c" }, (params) => {
+      if (params.length === 0 || params[0] === 0)
+        this.write("\x1B[>0;0;0c");
+      return false;
+    }));
+    this.disposables.push(this.terminal.parser.registerCsiHandler({ final: "n" }, (params) => {
+      if (params[0] === 5) {
+        this.write("\x1B[0n");
+      } else if (params[0] === 6) {
+        const row = this.terminal.buffer.active.cursorY + 1;
+        const col = this.terminal.buffer.active.cursorX + 1;
+        this.write(`\x1B[${row};${col}R`);
+      }
+      return false;
+    }));
+  }
+  respondToRawTerminalQueries(text) {
+    if (!text)
+      return;
+    const decrqm = /\x1b\[\?(\d+)\$p/g;
+    let match;
+    while ((match = decrqm.exec(text)) !== null) {
+      this.write(`\x1B[?${match[1]};2$y`);
+    }
+  }
+}
+export {
+  stopActivePiHost,
+  startPiPtyHost,
+  getActivePiHost,
+  PiPtyHost
+};

package/dist/src/app-opentui/registry.d.ts

@@ -0,0 +1,4 @@
+import type { AppLaunchOptions } from "./types";
+type Registry = Pick<Required<AppLaunchOptions>, "adapters" | "sceneRenderers">;
+export declare function createOpenTuiAppRegistry(): Registry;
+export {};