Function startRemoteTUIChat

extensions/cli/src/ui/index.ts:128–174

(
  remoteUrl: string,
  initialPrompt?: string,
)

}

export async function startRemoteTUIChat(
  remoteUrl: string,
  initialPrompt?: string,
) {
  // Critical safeguard: Prevent TUI initialization in TTY-less environment
  if (isTTYless()) {
    throw new Error(
      "Cannot start remote TUI in TTY-less environment. No TTY available for interactive mode.",
    );
  }

  // Test raw mode capability for remote TUI
  if (
    process.stdin.isTTY &&
    typeof (process.stdin as any).setRawMode === "function"
  ) {
    try {
      (process.stdin as any).setRawMode(true);
      (process.stdin as any).setRawMode(false);
      logger.debug("Raw mode test passed for remote TUI");
    } catch {
      throw new Error(
        "Terminal does not support raw mode required for interactive UI.",
      );
    }
  }

  // Start the TUI in remote mode - no services needed
  const { unmount } = render(
    React.createElement(ServiceContainerProvider, {
      children: React.createElement(AppRoot, {
        remoteUrl,
        initialPrompt,
      }),
    }),
    {
      stdin: process.stdin,
      stdout: process.stdout,
      stderr: process.stderr,
    },
  );

  // Register unmount function with main process for two-stage Ctrl+C exit
  setTUIUnmount(unmount);

  return { unmount };
}