@tooee/shell

Composition layer wiring Tooee apps together.

Part of the Tooee monorepo. See the main repo for documentation.

Session lifecycle

Use mountTooee when a host owns the renderer. Unmounting removes only the React tree; it never destroys the renderer or installs local terminal-health listeners.

const mount = mountTooee(sshRenderer, <App />, {
  provider: { initialMode: "normal" },
});

mount.unmount();

Use launchCli for a locally owned renderer, or runCliSession when the UI settles one result. Local handles own renderer destruction, terminal-health listeners, and any /dev/tty stream opened by stdinPolicy: "tty-if-piped".

const result = await runCliSession<string>(
  ({ resolve, cancel }) => <Prompt onSubmit={resolve} onCancel={cancel} />,
  {
    provider: { initialMode: "insert" },
    stdinPolicy: "tty-if-piped",
  },
);

Repeated unmount, destroy, resolve, and cancel calls are safe. A session returns null on cancellation or initialization/render failure.