brosh 0.2.2 → 0.2.4

package/README.github.md

@@ -0,0 +1,169 @@
+<p align="center">
+  <strong>Built for Claude coders.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/elleryfamilia/brosh/releases"><img src="https://img.shields.io/github/v/release/elleryfamilia/brosh" alt="Release"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/elleryfamilia/brosh" alt="License: MIT"></a>
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue" alt="Platforms">
+</p>
+
+![intro screen](docs/images/intro_screen.png)
+
+## Install
+
+**macOS (Homebrew):**
+
+```bash
+brew install --cask elleryfamilia/brosh/brosh
+```
+
+**Ubuntu/Debian:**
+
+```bash
+curl -fsSL https://elleryfamilia.github.io/brosh/install.sh | sudo bash
+```
+
+**Arch Linux (AUR):**
+
+```bash
+yay -S brosh-bin
+```
+
+**Direct download:** `.dmg` (macOS) / `.deb` (Linux) from the [releases page](https://github.com/elleryfamilia/brosh/releases).
+
+**Build from source:**
+
+```bash
+git clone https://github.com/elleryfamilia/brosh.git
+cd brosh/packages/desktop-electron && npm install && npm run start
+```
+
+**CLI only:** `npm install -g brosh` or `brew install elleryfamilia/brosh/brosh-cli` -- [more install options](./docs/installation.md)
+
+---
+
+## As much or as little as you'd like
+
+brosh gives you a terminal that grows with your workflow. Start minimal, add AI when you need it.
+
+### Just a terminal
+
+At its simplest, brosh is a fast, themeable terminal with split panes, tabs, and a smart status bar.
+
+![terminal](docs/images/terminal_screen.png)
+
+### Add Claude Code
+
+Open a side-by-side pane and Claude Code is right there -- connected to your terminal over MCP, ready to help.
+
+![claude code](docs/images/claudecode_screen.png)
+
+### Plugins when you need them
+
+Git, Context, Plans, Files -- built-in plugins live in the status bar and open as sidebars when you need them. Here the Context plugin gives Claude visibility into your project's CLAUDE.md files, documentation, and codebase structure.
+
+![context plugin](docs/images/context_screen.png)
+
+## Features
+
+- **Claude Code integration** -- Built-in MCP server, model switching, natural language detection, "Continue in Claude" handoff
+- **Built-in plugins** -- Git, Context, Plans, and Files sidebars available when you need them
+- **Split panes & tabs** -- Horizontal/vertical splits with draggable dividers, multi-tab interface
+- **Sandbox mode** -- Restrict filesystem and network access per session
+- **Themes & customization** -- 9 themes, 25+ fonts, cursor styles, window opacity, scrollback
+- **MCP tools** -- Claude Code can type, read, and screenshot your terminal directly
+- **Session recording** -- Record to asciicast format, play back with asciinema
+- **Cross-platform** -- macOS, Linux
+
+## MCP Integration
+
+The desktop app runs a built-in MCP server on a Unix socket, giving Claude Code direct access to your terminal session.
+
+Add to your Claude Code MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "terminal": {
+      "command": "brosh"
+    }
+  }
+}
+```
+
+| Tool | Description |
+|------|-------------|
+| `type` | Send text input to the terminal |
+| `sendKey` | Send special keys and key combinations |
+| `getContent` | Retrieve terminal buffer content |
+| `takeScreenshot` | Capture terminal state with metadata |
+| `startRecording` | Start recording terminal output |
+| `stopRecording` | Stop recording and save file |
+
+See [docs/tools.md](./docs/tools.md) for the full API reference.
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| <kbd>Cmd</kbd>+<kbd>T</kbd> | New tab |
+| <kbd>Cmd</kbd>+<kbd>N</kbd> | New window |
+| <kbd>Cmd</kbd>+<kbd>W</kbd> | Close tab |
+| <kbd>Cmd</kbd>+<kbd>D</kbd> | Split pane vertically |
+| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd> | Split pane horizontally |
+| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | Toggle git sidebar |
+| <kbd>Cmd</kbd>+<kbd>F</kbd> | Find in terminal |
+| <kbd>Cmd</kbd>+<kbd>,</kbd> | Settings |
+
+## CLI Mode
+
+brosh also works as a standalone CLI terminal and MCP server without the desktop app:
+
+```bash
+brosh              # Interactive mode -- shell + MCP server on Unix socket
+brosh --sandbox    # With filesystem/network restrictions
+brosh --record     # With session recording
+```
+
+See the [docs/](./docs/) folder for CLI flags, recording, and sandbox configuration.
+
+## Development
+
+```bash
+# Core library
+npm install && npm run build
+
+# Desktop app
+cd packages/desktop-electron
+npm run dev          # Dev mode with hot-reload
+npm run package      # Build distributable
+```
+
+### Linux: Sandbox binaries
+
+The desktop app bundles statically-compiled `socat` and `bwrap` (bubblewrap) so sandbox mode works out of the box on any Linux distro. The binaries are built automatically during `npm run package` (via `prepackage`). You just need the build tools installed:
+
+```bash
+# One-time setup (Linux only)
+sudo apt-get install -y meson ninja-build pkg-config libcap-dev
+```
+
+The script fetches the latest source releases from upstream, compiles static binaries, and places them in `resources/bin/`. On macOS the step is a no-op. You can also run it manually with `npm run prepare-sandbox-bins`.
+
+## Documentation
+
+- [Overview](./docs/index.md) -- [Installation](./docs/installation.md) -- [Architecture](./docs/architecture.md)
+- [Tools Reference](./docs/tools.md) -- [Configuration](./docs/configuration.md) -- [Examples](./docs/examples.md)
+- [Recording](./docs/recording.md) -- [Sandbox Mode](./docs/sandbox.md)
+
+## Requirements
+
+- **Desktop App**: macOS 10.15+, Linux
+- **CLI**: Node.js 18+
+
+## License
+
+MIT
+
+The Linux desktop build bundles [socat](http://www.dest-unreach.org/socat/) (GPL-2.0) and [bubblewrap](https://github.com/containers/bubblewrap) (LGPL-2.1) as standalone executables for sandbox support. See [`packages/desktop-electron/THIRD-PARTY-NOTICES`](packages/desktop-electron/THIRD-PARTY-NOTICES) for full license texts.

package/README.md

@@ -1,98 +1,26 @@
-<p align="center">
-  <strong>The AI-native terminal. Built for Claude coders.</strong>
-</p>
+# brosh
 
-<p align="center">
-  <a href="https://github.com/elleryfamilia/brosh/releases"><img src="https://img.shields.io/github/v/release/elleryfamilia/brosh" alt="Release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/elleryfamilia/brosh" alt="License: MIT"></a>
-  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue" alt="Platforms">
-</p>
+A terminal emulator and MCP server that gives Claude Code direct access to your terminal.
 
-![brosh desktop](docs/images/brosh_startscreen.png)
+brosh runs a shell inside a PTY with a headless xterm emulator, exposing tools over the [Model Context Protocol](https://modelcontextprotocol.io/) so AI agents can type commands, read output, send key combinations, and take screenshots.
 
 ## Install
 
-**Homebrew (macOS):**
-
 ```bash
-brew install --cask elleryfamilia/brosh/brosh
+npm install -g brosh
 ```
 
-**Direct download:** `.dmg` (macOS) / `.AppImage` (Linux) from the [releases page](https://github.com/elleryfamilia/brosh/releases).
-
-**Build from source:**
+## CLI Usage
 
 ```bash
-git clone https://github.com/elleryfamilia/brosh.git
-cd brosh/packages/desktop-electron && npm install && npm run start
+brosh                # Interactive mode -- shell + MCP server on Unix socket
+brosh --sandbox      # With filesystem/network restrictions
+brosh --record       # With session recording (asciicast format)
 ```
 
-**CLI only:** `npm install -g brosh` or `brew install elleryfamilia/brosh/brosh-cli` -- [more install options](./docs/installation.md)
-
-## Features
-
-- [**Claude Code integration**](#claude-code-integration) -- Natural language detection, model switching, "Continue in Claude" handoff, built-in MCP server
-- [**Split panes & tabs**](#terminal) -- Horizontal/vertical splits with draggable dividers, multi-tab interface
-- [**Git sidebar**](#git-integration) -- Visual commit graph, file change tracking, Monaco diff editor
-- [**Sandbox mode**](#sandbox-mode) -- Restrict filesystem and network access per session
-- [**Themes & customization**](#terminal) -- 9 themes, 25+ fonts, cursor styles, window opacity, scrollback
-- [**MCP tools**](#mcp-integration) -- Give Claude Code direct access to type, read, and screenshot your terminal
-- [**Session recording**](#developer-tools) -- Record to asciicast format, play back with asciinema
-- **Cross-platform** -- macOS, Linux
-
----
-
-## Claude Code Integration
-
-brosh is purpose-built for working with Claude Code. Every part of the terminal is designed to make AI-assisted development seamless.
-
-- **Natural language detection** -- An ML classifier distinguishes commands from questions in real time. Type `git push` and it runs. Type `how do I rebase onto main?` and Claude answers.
-- **Model switching** -- Switch between Sonnet, Opus, and Haiku from the status bar.
-- **MCP server built in** -- Claude Code connects over MCP and can see your terminal, run commands, and read output. No extra setup.
-- **Continue in Claude** -- Start a conversation in the terminal and seamlessly continue it in the Claude Code CLI with full context.
-- **Smart status bar** -- Git branch, active Claude model, MCP connection status, and session info at a glance.
-
-![brosh terminal chat](docs/images/terminal_chat.png)
-
-![MCP enabled](docs/images/mcp-enabled2.png)
-
-## Terminal
-
-- Multi-tab interface with split panes (horizontal and vertical)
-- Draggable panel dividers for custom layouts
-- 9 built-in themes and 25+ fonts
-- Cursor style options, window opacity, and configurable scrollback
-- Find bar for searching terminal output
-
-## Git Integration
-
-Built-in git sidebar with visual commit graph, file change tracking, and a Monaco-powered diff editor.
-
-![git sidebar](docs/images/git_sidebar.png)
-
-Click any changed file to open a full diff view:
-
-![git diff view](docs/images/git_sidebar_diff.png)
-
-## Sandbox Mode
-
-Choose between standard and sandboxed terminal sessions at launch. Sandbox mode restricts filesystem and network access so Claude can only touch what you allow.
-
-![sandbox permissions](docs/images/sandbox_selection2.png)
-
-See [docs/sandbox.md](./docs/sandbox.md) for configuration details.
-
-## Developer Tools
-
-- Monaco code editor integration
-- Terminal session recording ([asciicast format](./docs/recording.md))
-- Cross-platform: macOS, Linux
-
 ## MCP Integration
 
-The desktop app runs a built-in MCP server on a Unix socket, giving Claude Code direct access to your terminal session.
-
-Add to your Claude Code MCP settings:
+Add to your Claude Code MCP config (`~/.claude/settings.json` or `.mcp.json`):
 
 ```json
 {
@@ -104,78 +32,27 @@ Add to your Claude Code MCP settings:
 }
 ```
 
+When Claude Code launches brosh as an MCP server, it connects to the running interactive session over a Unix socket and proxies tool calls.
+
+### Tools
+
 | Tool | Description |
 |------|-------------|
 | `type` | Send text input to the terminal |
-| `sendKey` | Send special keys and key combinations |
+| `sendKey` | Send special keys and key combinations (Enter, Ctrl+C, etc.) |
 | `getContent` | Retrieve terminal buffer content |
-| `takeScreenshot` | Capture terminal state with metadata |
+| `takeScreenshot` | Capture terminal state with ANSI formatting |
 | `startRecording` | Start recording terminal output |
 | `stopRecording` | Stop recording and save file |
 
-See [docs/tools.md](./docs/tools.md) for the full API reference.
-
-## Keyboard Shortcuts
-
-| Shortcut | Action |
-|----------|--------|
-| <kbd>Cmd</kbd>+<kbd>T</kbd> | New tab |
-| <kbd>Cmd</kbd>+<kbd>N</kbd> | New window |
-| <kbd>Cmd</kbd>+<kbd>W</kbd> | Close tab |
-| <kbd>Cmd</kbd>+<kbd>D</kbd> | Split pane vertically |
-| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd> | Split pane horizontally |
-| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | Toggle git sidebar |
-| <kbd>Cmd</kbd>+<kbd>F</kbd> | Find in terminal |
-| <kbd>Cmd</kbd>+<kbd>,</kbd> | Settings |
-
-## CLI Mode
-
-brosh also works as a standalone CLI terminal and MCP server without the desktop app:
-
-```bash
-brosh              # Interactive mode -- shell + MCP server on Unix socket
-brosh --sandbox    # With filesystem/network restrictions
-brosh --record     # With session recording
-```
-
-See the [docs/](./docs/) folder for CLI flags, recording, and sandbox configuration.
-
-## Development
+## Desktop App
 
-```bash
-# Core library
-npm install && npm run build
-
-# Desktop app
-cd packages/desktop-electron
-npm run dev          # Dev mode with hot-reload
-npm run package      # Build distributable
-```
-
-### Linux: Sandbox binaries
-
-The desktop app bundles statically-compiled `socat` and `bwrap` (bubblewrap) so sandbox mode works out of the box on any Linux distro. The binaries are built automatically during `npm run package` (via `prepackage`). You just need the build tools installed:
-
-```bash
-# One-time setup (Linux only)
-sudo apt-get install -y meson ninja-build pkg-config libcap-dev
-```
-
-The script fetches the latest source releases from upstream, compiles static binaries, and places them in `resources/bin/`. On macOS the step is a no-op. You can also run it manually with `npm run prepare-sandbox-bins`.
-
-## Documentation
-
-- [Overview](./docs/index.md) -- [Installation](./docs/installation.md) -- [Architecture](./docs/architecture.md)
-- [Tools Reference](./docs/tools.md) -- [Configuration](./docs/configuration.md) -- [Examples](./docs/examples.md)
-- [Recording](./docs/recording.md) -- [Sandbox Mode](./docs/sandbox.md)
+brosh also ships as a full desktop terminal (Electron) with split panes, tabs, a Git sidebar, themes, and more. See the [GitHub repo](https://github.com/elleryfamilia/brosh) for install instructions and documentation.
 
 ## Requirements
 
-- **Desktop App**: macOS 10.15+, Linux
-- **CLI**: Node.js 18+
+- Node.js 18+
 
 ## License
 
 MIT
-
-The Linux desktop build bundles [socat](http://www.dest-unreach.org/socat/) (GPL-2.0) and [bubblewrap](https://github.com/containers/bubblewrap) (LGPL-2.1) as standalone executables for sandbox support. See [`packages/desktop-electron/THIRD-PARTY-NOTICES`](packages/desktop-electron/THIRD-PARTY-NOTICES) for full license texts.

package/README.npm.md

@@ -0,0 +1,58 @@
+# brosh
+
+A terminal emulator and MCP server that gives Claude Code direct access to your terminal.
+
+brosh runs a shell inside a PTY with a headless xterm emulator, exposing tools over the [Model Context Protocol](https://modelcontextprotocol.io/) so AI agents can type commands, read output, send key combinations, and take screenshots.
+
+## Install
+
+```bash
+npm install -g brosh
+```
+
+## CLI Usage
+
+```bash
+brosh                # Interactive mode -- shell + MCP server on Unix socket
+brosh --sandbox      # With filesystem/network restrictions
+brosh --record       # With session recording (asciicast format)
+```
+
+## MCP Integration
+
+Add to your Claude Code MCP config (`~/.claude/settings.json` or `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "terminal": {
+      "command": "brosh"
+    }
+  }
+}
+```
+
+When Claude Code launches brosh as an MCP server, it connects to the running interactive session over a Unix socket and proxies tool calls.
+
+### Tools
+
+| Tool | Description |
+|------|-------------|
+| `type` | Send text input to the terminal |
+| `sendKey` | Send special keys and key combinations (Enter, Ctrl+C, etc.) |
+| `getContent` | Retrieve terminal buffer content |
+| `takeScreenshot` | Capture terminal state with ANSI formatting |
+| `startRecording` | Start recording terminal output |
+| `stopRecording` | Stop recording and save file |
+
+## Desktop App
+
+brosh also ships as a full desktop terminal (Electron) with split panes, tabs, a Git sidebar, themes, and more. See the [GitHub repo](https://github.com/elleryfamilia/brosh) for install instructions and documentation.
+
+## Requirements
+
+- Node.js 18+
+
+## License
+
+MIT

package/dist/lib.d.ts

@@ -4,7 +4,7 @@
  * This file exports all public APIs for use as a library.
  * The main index.ts is the CLI entry point; this file is for programmatic usage.
  */
-export { TerminalSession, TerminalManager } from "./terminal/index.js";
+export { TerminalSession, TerminalManager, preWarmSession } from "./terminal/index.js";
 export type { TerminalSessionOptions, ScreenshotResult, TerminalManagerOptions, CreateSessionOptions, ManagedSession, } from "./terminal/index.js";
 export { GUIOutputStream, createGUIOutputStream, } from "./transport/index.js";
 export type { GuiClientCallback, GUIOutputStreamEvents, } from "./transport/index.js";

package/dist/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,8BAA8B,EAC9B,8BAA8B,EAC9B,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAChG,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvF,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,8BAA8B,EAC9B,8BAA8B,EAC9B,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAChG,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/lib.js

@@ -5,7 +5,7 @@
  * The main index.ts is the CLI entry point; this file is for programmatic usage.
  */
 // Terminal management
-export { TerminalSession, TerminalManager } from "./terminal/index.js";
+export { TerminalSession, TerminalManager, preWarmSession } from "./terminal/index.js";
 // Transport layer - GUI streaming
 export { GUIOutputStream, createGUIOutputStream, } from "./transport/index.js";
 // GUI protocol types

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AASvE,kCAAkC;AAClC,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAM9B,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAuB9B,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQxD,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElF,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGhG,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAepC,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AASvF,kCAAkC;AAClC,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAM9B,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAuB9B,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQxD,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElF,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGhG,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAepC,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/terminal/index.d.ts

@@ -1,4 +1,4 @@
-export { TerminalSession } from "./session.js";
+export { TerminalSession, preWarmSession } from "./session.js";
 export type { TerminalSessionOptions, ScreenshotResult } from "./session.js";
 export { TerminalManager } from "./manager.js";
 export type { TerminalManagerOptions, CreateSessionOptions, ManagedSession } from "./manager.js";

package/dist/terminal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/terminal/index.js

@@ -1,3 +1,3 @@
-export { TerminalSession } from "./session.js";
+export { TerminalSession, preWarmSession } from "./session.js";
 export { TerminalManager } from "./manager.js";
 //# sourceMappingURL=index.js.map

package/dist/terminal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/terminal/session.d.ts

@@ -1,4 +1,14 @@
 import type { SandboxController } from "../sandbox/index.js";
+export declare function getSystemLocale(): string;
+/**
+ * Pre-warm terminal session resources (locale, RC files, env filtering).
+ * Call this early (e.g. while the mode selection modal is visible) so the
+ * first createSession() is fast.
+ */
+export declare function preWarmSession(options?: {
+    nativeShell?: boolean;
+    setLocaleEnv?: boolean;
+}): void;
 export interface TerminalSessionOptions {
     cols?: number;
     rows?: number;
@@ -36,6 +46,7 @@ export interface ScreenshotResult {
 export declare class TerminalSession {
     private ptyProcess;
     private terminal;
+    private serializeAddon;
     private disposed;
     private dataListeners;
     private exitListeners;
@@ -89,7 +100,9 @@ export declare class TerminalSession {
      */
     write(data: string): void;
     /**
-     * Get the current terminal buffer content as plain text
+     * Get the current terminal buffer content.
+     * Uses the serialize addon to preserve ANSI formatting (colors, bold, etc.)
+     * so that rehydrated terminals look correct.
      */
     getContent(): string;
     /**

package/dist/terminal/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/terminal/session.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAoC7D,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACN,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,eAAe,CAAmD;IAE1E,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAuB;IAEtC;;OAEG;IACH,OAAO;IAEP;;;OAGG;WACU,MAAM,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;IAMnF;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAkIxB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAgD9B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;;OAGG;YACW,UAAU;IAyPxB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI9D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;OAEG;IACH,UAAU,IAAI,MAAM;IAwBpB;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAmB3B;;OAEG;IACH,cAAc,IAAI,gBAAgB;IAoBlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAaxC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO/C;;;OAGG;IACH,UAAU,IAAI,MAAM;IAYpB;;;OAGG;IACH,MAAM,IAAI,MAAM,GAAG,IAAI;IAkFvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAuBhB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/terminal/session.ts"],"names":[],"mappings":"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"}