@selesai/code 0.8.2 → 0.8.3

package/docs/settings.md

@@ -1,25 +1,25 @@
 # Settings
 
-Pi uses JSON settings files with project settings overriding global settings.
+Selesai uses JSON settings files with project settings overriding global settings.
 
 | Location | Scope |
 |----------|-------|
-| `~/.pi/agent/settings.json` | Global (all projects) |
-| `.pi/settings.json` | Project (current directory) |
+| `~/.selesai/agent/settings.json` | Global (all projects) |
+| `.selesai/settings.json` | Project (current directory) |
 
 Edit directly or use `/settings` for common options.
 
 ## Project Trust
 
-On interactive startup, pi asks before trusting a project folder that contains project-local settings, resources, or project `.agents/skills` and has no saved decision for the folder or a parent folder in `~/.pi/agent/trust.json`. Trusting a project allows pi to load `.pi/settings.json` and `.pi` resources, install missing project packages, and execute project extensions.
+On interactive startup, Selesai asks before trusting a project folder that contains project-local settings, resources, or project `.agents/skills` and has no saved decision for the folder or a parent folder in `~/.selesai/agent/trust.json`. Trusting a project allows Selesai to load `.selesai/settings.json` and `.selesai` resources, install missing project packages, and execute project extensions.
 
 Non-interactive modes (`-p`, `--mode json`, and `--mode rpc`) do not show a trust prompt. Without an applicable saved trust decision, they use `defaultProjectTrust` from global settings: `ask` (default) and `never` ignore those project resources, while `always` trusts them. Pass `--approve`/`-a` or `--no-approve`/`-na` to override project trust for one run.
 
-If no extension or saved decision applies, `defaultProjectTrust` controls the fallback behavior. Set it to `"ask"`, `"always"`, or `"never"` in `~/.pi/agent/settings.json`, or change it with `/settings`.
+If no extension or saved decision applies, `defaultProjectTrust` controls the fallback behavior. Set it to `"ask"`, `"always"`, or `"never"` in `~/.selesai/agent/settings.json`, or change it with `/settings`.
 
-`pi config` and package commands use the same project trust flow, except `pi update` never prompts. Pass `--approve` to trust project-local settings for one command or `--no-approve` to ignore them.
+`selesai config` and package commands use the same project trust flow, except `selesai update` never prompts. Pass `--approve` to trust project-local settings for one command or `--no-approve` to ignore them.
 
-Use `/trust` in interactive mode to save a project trust decision for future sessions, including trust for the immediate parent folder. It writes `~/.pi/agent/trust.json` only; the current session is not reloaded, so restart pi for changes to take effect.
+Use `/trust` in interactive mode to save a project trust decision for future sessions, including trust for the immediate parent folder. It writes `~/.selesai/agent/trust.json` only; the current session is not reloaded, so restart Selesai for changes to take effect.
 
 ## All Settings
 
@@ -62,6 +62,8 @@ Use `/trust` in interactive mode to save a project trust decision for future ses
 | `editorPaddingX` | number | `0` | Horizontal padding for input editor (0-3) |
 | `autocompleteMaxVisible` | number | `5` | Max visible items in autocomplete dropdown (3-20) |
 | `showHardwareCursor` | boolean | `false` | Show the terminal cursor while TUI positions it for IME support |
+| `tuiMode` | string | `"fullscreen"` | TUI layout: `"fullscreen"` (default) or `"regular"`. `fullscreen` uses Pi's native alternate-screen viewport with a fixed dock for the input editor, status, and widgets; set `"regular"` to opt out |
+| `fullscreenScrollbar` | string | `"auto"` | Fullscreen transcript scrollbar: `"auto"`, `"always"`, or `"hidden"`; configurable in `/settings`. No effect in regular TUI mode |
 
 ### Telemetry and update checks
 
@@ -184,7 +186,7 @@ Keep `retry.provider.maxRetries` at `0` unless provider-level retries are explic
 }
 ```
 
-`npmCommand` is used for all npm package-manager operations, including installs, uninstalls, and dependency installs inside git packages. User-scoped npm packages install under `~/.pi/agent/npm/`; project-scoped npm packages install under `.pi/npm/`. Use argv-style entries exactly as the process should be launched. When `npmCommand` is configured, git package dependency installs use plain `install` to avoid npm-specific flags in wrappers or alternate package managers.
+`npmCommand` is used for all npm package-manager operations, including installs, uninstalls, and dependency installs inside git packages. User-scoped npm packages install under `~/.selesai/agent/npm/`; project-scoped npm packages install under `.selesai/npm/`. Use argv-style entries exactly as the process should be launched. When `npmCommand` is configured, git package dependency installs use plain `install` to avoid npm-specific flags in wrappers or alternate package managers.
 
 ### Sessions
 
@@ -193,10 +195,10 @@ Keep `retry.provider.maxRetries` at `0` unless provider-level retries are explic
 | `sessionDir` | string | - | Directory where session files are stored. Accepts absolute or relative paths, plus `~`. |
 
 ```json
-{ "sessionDir": ".pi/sessions" }
+{ "sessionDir": ".selesai/sessions" }
 ```
 
-When multiple sources specify a session directory, precedence is `--session-dir`, `PI_CODING_AGENT_SESSION_DIR`, then `sessionDir` in settings.json.
+When multiple sources specify a session directory, precedence is `--session-dir`, `SELESAI_CODING_AGENT_SESSION_DIR`, then `sessionDir` in settings.json.
 
 ### Model Cycling
 
@@ -220,7 +222,7 @@ When multiple sources specify a session directory, precedence is `--session-dir`
 
 These settings define where to load extensions, skills, prompts, and themes from.
 
-Paths in `~/.pi/agent/settings.json` resolve relative to `~/.pi/agent`. Paths in `.pi/settings.json` resolve relative to `.pi`. Absolute paths and `~` are supported.
+Paths in `~/.selesai/agent/settings.json` resolve relative to `~/.selesai/agent`. Paths in `.selesai/settings.json` resolve relative to `.selesai`. Absolute paths and `~` are supported.
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
@@ -300,16 +302,16 @@ Keys are top-level entry names (dir name for packaged extensions, file name for
 
 ## Project Overrides
 
-Project settings (`.pi/settings.json`) override global settings. Nested objects are merged:
+Project settings (`.selesai/settings.json`) override global settings. Nested objects are merged:
 
 ```json
-// ~/.pi/agent/settings.json (global)
+// ~/.selesai/agent/settings.json (global)
 {
   "theme": "dark",
   "compaction": { "enabled": true, "reserveTokens": 16384 }
 }
 
-// .pi/settings.json (project)
+// .selesai/settings.json (project)
 {
   "compaction": { "reserveTokens": 8192 }
 }

package/docs/usage.md

@@ -15,6 +15,10 @@ The interface has four main areas:
 
 The editor can be replaced temporarily by built-in UI such as `/settings` or by custom extension UI.
 
+### TUI Mode
+
+Selesai runs its terminal interface in **fullscreen TUI mode** by default: the chat scrolls inside Pi's native alternate-screen viewport while the input editor, status line, and extension widgets stay fixed in a dock at the bottom. The `TUI mode` entry in `/settings` (or `tuiMode` in `settings.json`) switches between `fullscreen` and `regular` immediately and picks the default for future sessions. The `--tui-mode fullscreen|regular` flag overrides it for a single run. In regular mode, output renders inline into the terminal scrollback. See [Keybindings](keybindings.md) for the fullscreen transcript scrolling keys.
+
 ### Editor Features
 
 | Feature | How |
@@ -236,6 +240,7 @@ pi --no-extensions -e ./my-extension.ts
 |--------|-------------|
 | `--system-prompt <text>` | Replace default prompt; context files and skills are still appended |
 | `--append-system-prompt <text>` | Append to system prompt |
+| `--tui-mode <mode>` | TUI mode: `fullscreen` (default) or `regular` |
 | `--verbose` | Force verbose startup |
 | `-a`, `--approve` | Trust project-local files for this run |
 | `-na`, `--no-approve` | Ignore project-local files for this run |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@selesai/code",
-	"version": "0.8.2",
+	"version": "0.8.3",
 	"description": "Maintained, extension-first Pi coding agent with built-in workflows, subagents, web research, questions, skills, and an enhanced terminal UI.",
 	"type": "module",
 	"repository": {
@@ -55,9 +55,9 @@
 	},
 	"dependencies": {
 		"@ast-grep/cli": "0.45.0",
-		"@earendil-works/pi-agent-core": "0.83.0",
-		"@earendil-works/pi-ai": "0.83.0",
-		"@earendil-works/pi-tui": "0.83.0",
+		"@earendil-works/pi-agent-core": "0.84.1",
+		"@earendil-works/pi-ai": "0.84.1",
+		"@earendil-works/pi-tui": "0.84.1",
 		"@mozilla/readability": "^0.6.0",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"chalk": "5.6.2",
@@ -76,7 +76,7 @@
 		"semver": "7.8.0",
 		"tsx": "^4.20.0",
 		"typebox": "1.3.7",
-		"undici": "8.5.0",
+		"undici": "8.9.0",
 		"yaml": "2.9.0"
 	},
 	"devDependencies": {

package/dist/extensions/pi-powerline-footer/fixed-editor/cluster.ts

@@ -1,113 +0,0 @@
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-
-export const CURSOR_MARKER = "\x1b_pi:c\x07";
-
-export interface FixedEditorClusterInput {
-  width: number;
-  terminalRows: number;
-  statusLines?: string[];
-  topLines?: string[];
-  editorLines: string[];
-  secondaryLines?: string[];
-  transcriptLines?: string[];
-  lastPromptLines?: string[];
-}
-
-export interface FixedEditorCursor {
-  row: number;
-  col: number;
-}
-
-export interface FixedEditorClusterRender {
-  lines: string[];
-  cursor: FixedEditorCursor | null;
-}
-
-function normalizeLines(lines: string[] | undefined, width: number): string[] {
-  if (!lines || width <= 0) return [];
-
-  return lines
-    .filter((line) => line !== undefined && line !== null)
-    .map((line) => visibleWidth(line) > width ? truncateToWidth(line, width, "", true) : line);
-}
-
-function takeTail(lines: string[], count: number): string[] {
-  if (count <= 0) return [];
-  return lines.length <= count ? lines : lines.slice(lines.length - count);
-}
-
-function capEditorLines(lines: string[], count: number): string[] {
-  if (count <= 0) return [];
-  if (lines.length <= count) return lines;
-
-  const cursorRow = lines.findIndex((line) => line.includes(CURSOR_MARKER));
-  if (cursorRow !== -1) {
-    const start = Math.max(0, Math.min(cursorRow - count + 1, lines.length - count));
-    return lines.slice(start, start + count);
-  }
-
-  const selectedRow = lines.findIndex((line) => line.replace(/\x1b\[[0-9;]*m/g, "").trimStart().startsWith("→ "));
-  if (selectedRow === -1) {
-    return lines.slice(0, count);
-  }
-
-  const start = Math.max(0, Math.min(selectedRow - Math.floor(count / 2), lines.length - count));
-  return lines.slice(start, start + count);
-}
-
-function extractCursor(lines: string[]): FixedEditorClusterRender {
-  let cursor: FixedEditorCursor | null = null;
-  const cleaned = lines.map((line, row) => {
-    const markerIndex = line.indexOf(CURSOR_MARKER);
-    if (markerIndex === -1) return line;
-
-    if (!cursor) {
-      cursor = {
-        row,
-        col: visibleWidth(line.slice(0, markerIndex)),
-      };
-    }
-
-    return line.slice(0, markerIndex) + line.slice(markerIndex + CURSOR_MARKER.length);
-  });
-
-  return { lines: cleaned, cursor };
-}
-
-export function renderFixedEditorCluster(input: FixedEditorClusterInput): FixedEditorClusterRender {
-  const width = Math.max(1, input.width);
-  const maxRows = Math.max(1, input.terminalRows - 1);
-
-  const statusLines = normalizeLines(input.statusLines, width);
-  const topLines = normalizeLines(input.topLines, width);
-  const editorSource = normalizeLines(input.editorLines, width);
-  const secondaryLines = normalizeLines(input.secondaryLines, width);
-  const transcriptLines = normalizeLines(input.transcriptLines, width);
-  const lastPromptLines = normalizeLines(input.lastPromptLines, width);
-
-  const editorLines = capEditorLines(editorSource, maxRows);
-  let remaining = maxRows - editorLines.length;
-
-  const top = takeTail(topLines, remaining);
-  remaining -= top.length;
-
-  const secondary = takeTail(secondaryLines, remaining);
-  remaining -= secondary.length;
-
-  const lastPrompt = takeTail(lastPromptLines, remaining);
-  remaining -= lastPrompt.length;
-
-  const status = takeTail(statusLines, remaining);
-  remaining -= status.length;
-
-  const transcript = takeTail(transcriptLines, remaining);
-
-  return extractCursor([
-    ...status,
-    ...top,
-    ...editorLines,
-    ...secondary,
-    ...transcript,
-    ...lastPrompt,
-  ]);
-}