@selesai/code 0.8.1 → 0.8.3

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to `@selesai/code` will be documented in this file.
 
+## [Unreleased]
+
+## [0.8.3] - 2026-08-12
+
+### Added
+- **Pi v0.84.1 migration with fullscreen TUI by default.** Selesai now runs Pi's native fullscreen TUI mode (`tuiMode: "fullscreen"`) by default, with an alternate-screen viewport, a fixed dock for the input editor/status/widgets/footer, a scrollable transcript, and fullscreen-specific keybindings. `--tui-mode regular`, the `tuiMode` setting, or the `TUI mode` entry in `/settings` opt back into regular mode. The powerline extension's unsupported terminal-split compositor and mouse-scroll/chat-jump machinery were removed; its status, editor, and widgets now live in Pi's native dock through the standard extension APIs.
+
+### Changed
+- **Runtime dependencies updated to Pi v0.84.1.** `@earendil-works/pi-ai`, `@earendil-works/pi-tui`, and `@earendil-works/pi-agent-core` moved to 0.84.1 and `undici` to 8.9.0, matching upstream `@earendil-works/pi-coding-agent` 0.84.1. The model-runtime/refresh APIs were ported to the new pi-ai publication model, and the interactive renderer now selects between Pi's `TuiMainScreen` (regular) and `TuiAltScreen` (fullscreen).
+
+## [0.8.2] - 2026-08-11
+
+### Fixed
+- **Guide version-marking no longer locks in the implicit mode.** When the recurring guide marks a new version as seen, Selesai no longer writes the fallback `compact` mode into `settings.json` as if it were a user choice. An explicit `full`, `compact`, or `off` mode is still preserved across version-only writes, so the guide keeps following the current default until you choose otherwise.
+
 ## [0.8.1] - 2026-08-11
 
 ### Fixed

package/README.md

@@ -86,14 +86,16 @@ This is the interaction layer used by the workflow modes and available to normal
 
 ### A richer terminal workspace
 
+The interactive terminal runs Pi's native **fullscreen TUI mode** by default: the chat scrolls inside an alternate-screen viewport while the input editor, status line, and widgets stay fixed in a dock at the bottom. Choose `regular` (inline output) at any time with `--tui-mode regular`, the `tuiMode` setting, or the `TUI mode` entry in `/settings`.
+
 The bundled `pi-powerline-footer` improves the interactive display with:
 
 - a powerline status bar for model, thinking level, path, git state, context, tokens, cost, cache, and session data
-- a fixed-editor layout that keeps the editor and status area visible while chat scrolls
+- status, editor, and widgets that live in Pi's native fixed dock (the old terminal-split compositor was decommissioned)
 - a file-backed queue/inbox for deferred ideas and compaction-safe prompts (`# <idea>`, `/idea`, `/ideas`, and `/queue`), plus session-aware `/cd`
 - a recurring `/guide` tour with compact and remembered-dismissal modes, covering workflows, delegation/research prompts, skills, handoff, and recovery
 - persistent bash mode with shell state, transcript output, history, and ghost suggestions
-- editor stash/restore, prompt history, clipboard shortcuts, and message-jump shortcuts
+- editor stash/restore, prompt history, clipboard shortcuts, and editor boundary navigation
 - themed working-vibe messages, Nerd Font detection, configurable presets, layout, placement, and cost display
 
 ### Coordination between sessions

package/dist/cli/args.d.ts

@@ -3,6 +3,7 @@
  */
 import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
 import type { ExtensionFlag } from "../core/extensions/types.ts";
+import type { TuiMode } from "../core/settings-manager.ts";
 export type Mode = "text" | "json" | "rpc";
 export interface Args {
     provider?: string;
@@ -40,6 +41,7 @@ export interface Args {
     noContextFiles?: boolean;
     listModels?: string | true;
     offline?: boolean;
+    tuiMode?: TuiMode;
     verbose?: boolean;
     projectTrustOverride?: boolean;
     messages: string[];

package/dist/cli/args.js

@@ -157,6 +157,23 @@ export function parseArgs(args) {
                 result.listModels = true;
             }
         }
+        else if (arg === "--tui-mode") {
+            const mode = args[i + 1];
+            if (mode === "regular" || mode === "fullscreen") {
+                result.tuiMode = mode;
+                i++;
+            }
+            else if (mode === undefined || mode.startsWith("-")) {
+                result.diagnostics.push({ type: "error", message: "--tui-mode requires regular or fullscreen" });
+            }
+            else {
+                i++;
+                result.diagnostics.push({
+                    type: "error",
+                    message: `Invalid TUI mode "${mode}". Valid values: regular, fullscreen`,
+                });
+            }
+        }
         else if (arg === "--verbose") {
             result.verbose = true;
         }
@@ -259,6 +276,7 @@ ${chalk.bold("Options:")}
   --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading
   --export <file>                Export session file to HTML and exit
   --list-models [search]         List available models (with optional fuzzy search)
+  --tui-mode <mode>              TUI mode: fullscreen (default) or regular
   --verbose                      Force verbose startup (overrides quietStartup setting)
   --approve, -a                  Trust project-local files for this run
   --no-approve, -na              Ignore project-local files for this run

package/dist/cli/config-selector.js

@@ -1,7 +1,7 @@
 /**
  * TUI config selector for `pi config` command
  */
-import { ProcessTerminal, TUI } from "@earendil-works/pi-tui";
+import { ProcessTerminal, TuiMainScreen } from "@earendil-works/pi-tui";
 import { ConfigSelectorComponent } from "../modes/interactive/components/config-selector.js";
 import { initTheme, stopThemeWatcher } from "../modes/interactive/theme/theme.js";
 /** Show TUI config selector and return when closed */
@@ -9,7 +9,7 @@ export async function selectConfig(options) {
     // Initialize theme before showing TUI
     initTheme(options.settingsManager.getTheme(), true);
     return new Promise((resolve) => {
-        const ui = new TUI(new ProcessTerminal(), undefined, options.agentDir);
+        const ui = new TuiMainScreen(new ProcessTerminal(), undefined, options.agentDir);
         let resolved = false;
         const selector = new ConfigSelectorComponent(options.resolvedPaths, options.settingsManager, options.cwd, options.agentDir, () => {
             if (!resolved) {

package/dist/cli/startup-ui.d.ts

@@ -1,4 +1,4 @@
-import { TUI } from "@earendil-works/pi-tui";
+import { type TUI } from "@earendil-works/pi-tui";
 import { SettingsManager } from "../core/settings-manager.ts";
 export declare function createStartupTui(settingsManager: SettingsManager): Promise<TUI>;
 export declare function startStartupTui(ui: TUI, settingsManager: SettingsManager): void;

package/dist/cli/startup-ui.js

@@ -1,4 +1,4 @@
-import { ProcessTerminal, setKeybindings, TUI } from "@earendil-works/pi-tui";
+import { ProcessTerminal, setKeybindings, TuiMainScreen } from "@earendil-works/pi-tui";
 import { existsSync } from "fs";
 import { ENV_AGENT_DIR, getAgentDir, getFirstRunMarkerPath, markFirstRunComplete } from "../config.js";
 import { KeybindingsManager } from "../core/keybindings.js";
@@ -47,7 +47,7 @@ export async function createStartupTui(settingsManager) {
     const terminalTheme = detectTerminalBackgroundFromEnv().theme;
     initTheme(resolveThemeSetting(settingsManager.getThemeSetting(), terminalTheme) ?? terminalTheme);
     setKeybindings(KeybindingsManager.create());
-    const ui = new TUI(new ProcessTerminal(), settingsManager.getShowHardwareCursor(), getAgentDir());
+    const ui = new TuiMainScreen(new ProcessTerminal(), settingsManager.getShowHardwareCursor(), getAgentDir());
     ui.setClearOnShrink(settingsManager.getClearOnShrink());
     return ui;
 }

package/dist/core/keybindings.d.ts

@@ -57,6 +57,14 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "down";
         readonly description: "Move cursor down";
     };
+    readonly "tui.editor.historyPrevious": {
+        readonly defaultKeys: [];
+        readonly description: "Select previous prompt history entry";
+    };
+    readonly "tui.editor.historyNext": {
+        readonly defaultKeys: [];
+        readonly description: "Select next prompt history entry";
+    };
     readonly "tui.editor.cursorLeft": {
         readonly defaultKeys: ["left", "ctrl+b"];
         readonly description: "Move cursor left";
@@ -74,11 +82,11 @@ export declare const KEYBINDINGS: {
         readonly description: "Move cursor word right";
     };
     readonly "tui.editor.cursorLineStart": {
-        readonly defaultKeys: ["home", "ctrl+a"];
+        readonly defaultKeys: ["home", "ctrl+home", "ctrl+a"];
         readonly description: "Move to line start";
     };
     readonly "tui.editor.cursorLineEnd": {
-        readonly defaultKeys: ["end", "ctrl+e"];
+        readonly defaultKeys: ["end", "ctrl+end", "ctrl+e"];
         readonly description: "Move to line end";
     };
     readonly "tui.editor.jumpForward": {
@@ -90,11 +98,11 @@ export declare const KEYBINDINGS: {
         readonly description: "Jump backward to character";
     };
     readonly "tui.editor.pageUp": {
-        readonly defaultKeys: "pageUp";
+        readonly defaultKeys: ["pageUp", "ctrl+pageUp"];
         readonly description: "Page up";
     };
     readonly "tui.editor.pageDown": {
-        readonly defaultKeys: "pageDown";
+        readonly defaultKeys: ["pageDown", "ctrl+pageDown"];
         readonly description: "Page down";
     };
     readonly "tui.editor.deleteCharBackward": {
@@ -173,6 +181,38 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: ["escape", "ctrl+c"];
         readonly description: "Cancel selection";
     };
+    readonly "tui.altScreen.pageUp": {
+        readonly defaultKeys: "pageUp";
+        readonly description: "Scroll viewport up one page";
+    };
+    readonly "tui.altScreen.pageDown": {
+        readonly defaultKeys: "pageDown";
+        readonly description: "Scroll viewport down one page";
+    };
+    readonly "tui.altScreen.halfPageUp": {
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport up half a page";
+    };
+    readonly "tui.altScreen.halfPageDown": {
+        readonly defaultKeys: [];
+        readonly description: "Scroll viewport down half a page";
+    };
+    readonly "tui.altScreen.previousPrompt": {
+        readonly defaultKeys: "ctrl+shift+up";
+        readonly description: "Jump to previous semantic prompt";
+    };
+    readonly "tui.altScreen.nextPrompt": {
+        readonly defaultKeys: "ctrl+shift+down";
+        readonly description: "Jump to next semantic prompt";
+    };
+    readonly "tui.altScreen.top": {
+        readonly defaultKeys: "home";
+        readonly description: "Scroll viewport to top";
+    };
+    readonly "tui.altScreen.bottom": {
+        readonly defaultKeys: "end";
+        readonly description: "Scroll viewport to bottom";
+    };
     readonly "app.interrupt": {
         readonly defaultKeys: "escape";
         readonly description: "Cancel or abort";

package/dist/core/llama/provider.js

@@ -85,19 +85,34 @@ export function createLlamaProvider() {
         },
         getModels: () => models,
         refreshModels: async (context) => {
-            const stored = await context.store.read();
-            if (stored) {
-                models = stored.models.filter((model) => model.provider === LLAMA_PROVIDER_ID && model.api === "openai-completions");
+            const stored = context.stored;
+            const restored = stored
+                ? stored.models.filter((model) => model.provider === LLAMA_PROVIDER_ID && model.api === "openai-completions")
+                : [];
+            if (!(await context.publish({
+                update: () => {
+                    models = restored;
+                },
+            }))) {
+                return;
             }
-            if (!context.allowNetwork || context.signal?.aborted || context.credential?.type !== "api_key")
+            if (!context.allowNetwork || context.signal.aborted || context.credential?.type !== "api_key")
                 return;
             const serverUrl = credentialServerUrl(context.credential);
             if (!serverUrl)
                 return;
             const catalog = await new LlamaClient(serverUrl, context.credential.key).list({ signal: context.signal });
-            setCatalog(catalog, serverUrl);
-            if (!context.signal?.aborted)
-                await context.store.write({ models, checkedAt: Date.now() });
+            const refreshed = catalog
+                .filter((model) => model.status.value === "loaded")
+                .map((model) => toPiModel(model, serverUrl));
+            if (context.signal.aborted)
+                return;
+            await context.publish({
+                persist: { models: refreshed, checkedAt: Date.now() },
+                update: () => {
+                    models = refreshed;
+                },
+            });
         },
         stream: (model, context, options) => stream(model, context, options),
         streamSimple: (model, context, options) => streamSimple(model, context, options),

package/dist/core/model-resolver.js

@@ -35,6 +35,7 @@ export const defaultModelPerProvider = {
     huggingface: "moonshotai/Kimi-K2.6",
     fireworks: "accounts/fireworks/models/kimi-k2p6",
     together: "moonshotai/Kimi-K2.6",
+    baseten: "zai-org/GLM-5.2",
     opencode: "kimi-k2.6",
     "opencode-go": "kimi-k2.6",
     "kimi-coding": "kimi-for-coding",
@@ -42,6 +43,7 @@ export const defaultModelPerProvider = {
     "cloudflare-ai-gateway": "workers-ai/@cf/moonshotai/kimi-k2.6",
     "qwen-token-plan": "qwen3.7-max",
     "qwen-token-plan-cn": "qwen3.7-max",
+    "qwen-token-plan-individual": "qwen3.8-max",
     xiaomi: "mimo-v2.5-pro",
     "xiaomi-token-plan-cn": "mimo-v2.5-pro",
     "xiaomi-token-plan-ams": "mimo-v2.5-pro",

package/dist/core/model-runtime.d.ts

@@ -1,4 +1,4 @@
-import { type Api, type AssistantMessage, type AssistantMessageEventStream, type AuthCheck, type AuthInteraction, type AuthResult, type AuthType, type Context, type Credential, type CredentialInfo, type CredentialStore, type Model, type Models, type ModelsApiStreamOptions, type ModelsRefreshOptions, type ModelsRefreshResult, type ModelsSimpleStreamOptions, type ModelsStore, type Provider } from "@earendil-works/pi-ai";
+import { type Api, type AssistantMessage, type AssistantMessageEventStream, type AuthCheck, type AuthInteraction, type AuthOperationOptions, type AuthResult, type AuthType, type Context, type Credential, type CredentialInfo, type CredentialStore, type DeferredHandle, type Model, type Models, type ModelsApiStreamOptions, type ModelsDeferredCancelOptions, type ModelsDeferredFetchOptions, type ModelsRefreshOptions, type ModelsRefreshResult, type ModelsSimpleStreamOptions, type ModelsStore, type Provider } from "@earendil-works/pi-ai";
 import { type AuthStatus, type CompatibilityRequestConfig, type ProviderConfigInput } from "./provider-composer.ts";
 export interface CreateModelRuntimeOptions {
     /** Credential storage. Defaults to the file at authPath. */
@@ -13,7 +13,7 @@ export interface CreateModelRuntimeOptions {
     modelRefreshTimeoutMs?: number;
     catalogBaseUrl?: string;
 }
-export interface ModelRuntimeAuthOverrides {
+export interface ModelRuntimeAuthOverrides extends AuthOperationOptions {
     apiKey?: string;
     env?: Record<string, string>;
     /** Require this much remaining OAuth-token validity; defaults to five minutes. */
@@ -73,6 +73,8 @@ export declare class ModelRuntime implements Models {
     complete<TApi extends Api>(model: Model<TApi>, context: Context, options?: ModelsApiStreamOptions<TApi>): Promise<AssistantMessage>;
     streamSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): AssistantMessageEventStream;
     completeSimple(model: Model<Api>, context: Context, options?: ModelsSimpleStreamOptions): Promise<AssistantMessage>;
+    fetchDeferred(model: Model<Api>, handle: DeferredHandle, options?: ModelsDeferredFetchOptions): Promise<AssistantMessage>;
+    cancelDeferred(model: Model<Api>, handle: DeferredHandle, options?: ModelsDeferredCancelOptions): Promise<void>;
     login(providerId: string, type: AuthType, interaction: AuthInteraction): Promise<Credential>;
     logout(providerId: string): Promise<void>;
     getCredentialStore(): CredentialStore;

package/dist/core/model-runtime.js

@@ -313,10 +313,15 @@ export class ModelRuntime {
         const provider = this.models.getProvider(model.provider);
         if (!provider)
             throw new ModelsError("provider", `Unknown provider: ${model.provider}`);
-        const resolution = await this.getAuth(model, { apiKey: options?.apiKey, env: options?.env });
+        const resolution = await this.getAuth(model, {
+            apiKey: options?.apiKey,
+            env: options?.env,
+            signal: options?.signal,
+        });
         if (!resolution)
             throw new ModelsError("auth", `Provider is not configured: ${model.provider}`);
-        const { transformHeaders, ...providerOptions } = options ?? {};
+        const { transformHeaders, ...rawProviderOptions } = options ?? {};
+        const providerOptions = rawProviderOptions;
         let headers = mergeHeaders(resolution.auth.headers, providerOptions.headers);
         if (transformHeaders)
             headers = await transformHeaders(headers ?? {});
@@ -352,6 +357,22 @@ export class ModelRuntime {
     completeSimple(model, context, options) {
         return this.streamSimple(model, context, options).result();
     }
+    async fetchDeferred(model, handle, options) {
+        return lazyStream(model, async () => {
+            const prepared = await this.prepareRequest(model, options);
+            if (!prepared.provider.fetchDeferred) {
+                throw new ModelsError("provider", `Provider ${model.provider} does not support deferred responses`);
+            }
+            return prepared.provider.fetchDeferred(prepared.model, handle, prepared.options);
+        }).result();
+    }
+    async cancelDeferred(model, handle, options) {
+        const prepared = await this.prepareRequest(model, options);
+        if (!prepared.provider.cancelDeferred) {
+            throw new ModelsError("provider", `Provider ${model.provider} does not support deferred responses`);
+        }
+        await prepared.provider.cancelDeferred(prepared.model, handle, prepared.options);
+    }
     async login(providerId, type, interaction) {
         const credential = await this.models.login(providerId, type, interaction);
         await this.refresh({ allowNetwork: this.modelNetworkEnabled });

package/dist/core/remote-catalog-provider.js

@@ -38,77 +38,82 @@ function remoteModels(entry, localGeneratedAt) {
 /** Add a persisted pi.dev catalog overlay to a static built-in provider. */
 export function withRemoteCatalog(provider, catalogBaseUrl = DEFAULT_CATALOG_BASE_URL, localGeneratedAt) {
     let dynamicModels = [];
-    let inflightRefresh;
     return {
         ...provider,
         getModels: () => mergeModels(provider.getModels(), dynamicModels),
-        refreshModels: (context) => {
-            inflightRefresh ??= (async () => {
-                try {
-                    const stored = await context.store.read();
-                    dynamicModels = remoteModels(stored, localGeneratedAt).filter((model) => model.provider === provider.id);
-                    if (!context.allowNetwork || context.signal?.aborted)
-                        return;
-                    if (!context.force &&
-                        stored?.checkedAt !== undefined &&
-                        stored.lastModified !== undefined &&
-                        Date.now() - stored.checkedAt < REMOTE_CATALOG_REFRESH_INTERVAL_MS) {
-                        return;
-                    }
-                    // Only revalidate when a cached body backs the validator, so a 304 can never
-                    // leave the overlay empty.
-                    const validator = stored?.models.length ? stored.etag : undefined;
-                    const url = new URL(`/api/models/providers/${encodeURIComponent(provider.id)}`, catalogBaseUrl);
-                    const response = await fetch(url, {
-                        headers: {
-                            accept: "application/json",
-                            "User-Agent": getPiUserAgent(VERSION),
-                            ...(validator ? { "if-none-match": validator } : {}),
-                        },
-                        signal: context.signal,
-                    });
-                    if (context.signal?.aborted)
-                        return;
-                    const checkedAt = Date.now();
-                    // Unchanged: dynamicModels already holds the stored overlay, so only the
-                    // freshness window moves.
-                    if (response.status === 304 && stored) {
-                        await context.store.write({ ...stored, checkedAt });
-                        return;
-                    }
-                    if (response.status === 404 || response.status === 501) {
-                        await context.store.write({
-                            ...(stored ?? { models: [] }),
-                            checkedAt,
-                            lastModified: 0,
-                            etag: undefined,
-                        });
-                        return;
-                    }
-                    if (!response.ok) {
-                        // Transient failure: the cached body and its validator stay valid, so keep the
-                        // etag and let the next refresh revalidate instead of downloading the catalog.
-                        await context.store.write({ ...(stored ?? { models: [] }), checkedAt });
-                        throw new Error(`Model catalog request failed for ${provider.id}: ${response.status}`);
-                    }
-                    const refreshed = parseCatalog(provider.id, await response.json());
-                    const lastModified = Date.parse(response.headers.get("last-modified") ?? "");
-                    if (context.signal?.aborted)
-                        return;
-                    const entry = {
-                        models: refreshed,
+        refreshModels: async (context) => {
+            const stored = context.stored;
+            const restored = remoteModels(stored, localGeneratedAt).filter((model) => model.provider === provider.id);
+            if (!(await context.publish({
+                update: () => {
+                    dynamicModels = restored;
+                },
+            }))) {
+                return;
+            }
+            if (!context.allowNetwork || context.signal.aborted)
+                return;
+            if (!context.force &&
+                stored?.checkedAt !== undefined &&
+                stored.lastModified !== undefined &&
+                Date.now() - stored.checkedAt < REMOTE_CATALOG_REFRESH_INTERVAL_MS) {
+                return;
+            }
+            // Only revalidate when a cached body backs the validator, so a 304 can never
+            // leave the overlay empty.
+            const validator = stored?.models.length ? stored.etag : undefined;
+            const url = new URL(`/api/models/providers/${encodeURIComponent(provider.id)}`, catalogBaseUrl);
+            const response = await fetch(url, {
+                headers: {
+                    accept: "application/json",
+                    "User-Agent": getPiUserAgent(VERSION),
+                    ...(validator ? { "if-none-match": validator } : {}),
+                },
+                signal: context.signal,
+            });
+            if (context.signal.aborted)
+                return;
+            const checkedAt = Date.now();
+            // Unchanged: dynamicModels already holds the stored overlay, so only the
+            // freshness window moves.
+            if (response.status === 304 && stored) {
+                await context.publish({ persist: { ...stored, checkedAt } });
+                return;
+            }
+            if (response.status === 404 || response.status === 501) {
+                await context.publish({
+                    persist: {
+                        ...(stored ?? { models: [] }),
                         checkedAt,
-                        lastModified: Number.isNaN(lastModified) ? 0 : lastModified,
-                        etag: response.headers.get("etag") ?? undefined,
-                    };
-                    dynamicModels = remoteModels(entry, localGeneratedAt);
-                    await context.store.write(entry);
-                }
-                finally {
-                    inflightRefresh = undefined;
-                }
-            })();
-            return inflightRefresh;
+                        lastModified: 0,
+                        etag: undefined,
+                    },
+                });
+                return;
+            }
+            if (!response.ok) {
+                // Transient failure: the cached body and its validator stay valid, so keep the
+                // etag and let the next refresh revalidate instead of downloading the catalog.
+                await context.publish({ persist: { ...(stored ?? { models: [] }), checkedAt } });
+                throw new Error(`Model catalog request failed for ${provider.id}: ${response.status}`);
+            }
+            const refreshed = parseCatalog(provider.id, await response.json());
+            const lastModified = Date.parse(response.headers.get("last-modified") ?? "");
+            if (context.signal.aborted)
+                return;
+            const entry = {
+                models: refreshed,
+                checkedAt,
+                lastModified: Number.isNaN(lastModified) ? 0 : lastModified,
+                etag: response.headers.get("etag") ?? undefined,
+            };
+            const published = remoteModels(entry, localGeneratedAt);
+            await context.publish({
+                persist: entry,
+                update: () => {
+                    dynamicModels = published;
+                },
+            });
         },
     };
 }

package/dist/core/settings-manager.d.ts

@@ -1,5 +1,6 @@
 import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
 import type { Transport } from "@earendil-works/pi-ai";
+import type { ScrollViewScrollbar, TuiMode as RendererTuiMode } from "@earendil-works/pi-tui";
 export interface CompactionSettings {
     enabled?: boolean;
     reserveTokens?: number;
@@ -20,6 +21,7 @@ export interface RetrySettings {
     baseDelayMs?: number;
     provider?: ProviderRetrySettings;
 }
+export type TuiMode = RendererTuiMode;
 export interface TerminalSettings {
     showImages?: boolean;
     imageWidthCells?: number;
@@ -93,6 +95,8 @@ export interface Settings {
     themes?: string[];
     agents?: string[];
     terminal?: TerminalSettings;
+    tuiMode?: TuiMode;
+    fullscreenScrollbar?: ScrollViewScrollbar;
     images?: ImageSettings;
     enabledModels?: string[];
     doubleEscapeAction?: "fork" | "tree" | "none";
@@ -278,6 +282,10 @@ export declare class SettingsManager {
     setClearOnShrink(enabled: boolean): void;
     getShowTerminalProgress(): boolean;
     setShowTerminalProgress(enabled: boolean): void;
+    getTuiMode(): TuiMode;
+    setTuiMode(mode: TuiMode): void;
+    getFullscreenScrollbar(): ScrollViewScrollbar;
+    setFullscreenScrollbar(mode: ScrollViewScrollbar): void;
     getImageAutoResize(): boolean;
     setImageAutoResize(enabled: boolean): void;
     getBlockImages(): boolean;

package/dist/core/settings-manager.js

@@ -816,6 +816,24 @@ export class SettingsManager {
         this.markModified("terminal", "showTerminalProgress");
         this.save();
     }
+    getTuiMode() {
+        // Selesai defaults to Pi's native fullscreen TUI; users may explicitly choose regular.
+        return this.settings.tuiMode === "regular" ? "regular" : "fullscreen";
+    }
+    setTuiMode(mode) {
+        this.globalSettings.tuiMode = mode;
+        this.markModified("tuiMode");
+        this.save();
+    }
+    getFullscreenScrollbar() {
+        const mode = this.settings.fullscreenScrollbar;
+        return mode === "always" || mode === "hidden" ? mode : "auto";
+    }
+    setFullscreenScrollbar(mode) {
+        this.globalSettings.fullscreenScrollbar = mode;
+        this.markModified("fullscreenScrollbar");
+        this.save();
+    }
     getImageAutoResize() {
         return this.settings.images?.autoResize ?? true;
     }

package/dist/extensions/pi-powerline-footer/CHANGELOG.md

@@ -3,10 +3,12 @@
 ## [Unreleased]
 
 ### Fixed
+- **Guide version-marking never persists an implicit mode** — `markGuideVersionSeen` (version-only writes) preserves an explicit user mode but never writes the fallback default as a user choice, so the guide keeps following the current default instead of locking in `compact`.
 - **Guide defaults to compact mode** — When `selesaiGuide.mode` is unset, the recurring guide opens in compact mode instead of the full tour. Explicit `full`, `compact`, or `off` settings are still honored.
 
 ### Changed
-- **Upstream 0.12.3 merge (Selesai fork)** — Updated from upstream v0.5.4 to v0.12.3. Adopts the Powerline queue/inbox (`/idea`, `/ideas`, `/queue`, `/ideas next`, `/ideas issue`), compaction-aware queue delivery, `/cd` session directory switching, cost currency and subagent cost accounting, `powerline.separator`/`layout`/`placement`/`disabledSegments`/`welcome` options, git host icons, cached session token stats, strict TypeScript gate, and all upstream fixes through 0.12.3. Selesai-specific features are preserved: the fixed editor and chat scrolling, the guide overlay, the TPS tracker, session-usage accounting, and mode-aware autocomplete trigger forwarding.
+- **Upstream 0.12.3 merge (Selesai fork)** — Updated from upstream v0.5.4 to v0.12.3. Adopts the Powerline queue/inbox (`/idea`, `/ideas`, `/queue`, `/ideas next`, `/ideas issue`), compaction-aware queue delivery, `/cd` session directory switching, cost currency and subagent cost accounting, `powerline.separator`/`layout`/`placement`/`disabledSegments`/`welcome` options, git host icons, cached session token stats, strict TypeScript gate, and all upstream fixes through 0.12.3. Selesai-specific features are preserved: the guide overlay, the TPS tracker, session-usage accounting, and mode-aware autocomplete trigger forwarding.
+- **Native fullscreen dock** — Removed the unsupported terminal-split compositor and its fixed-editor/mouse-scroll/chat-jump controls. Powerline status, editor, and widgets now use Pi 0.84.1's native fullscreen dock; Selesai defaults to fullscreen while `tuiMode: "regular"` opts out.
 
 
 ## [0.12.3] - 2026-08-09

package/dist/extensions/pi-powerline-footer/guide.ts

@@ -200,9 +200,17 @@ export function saveGuidePreferences(
   if (!settings) return false;
 
   const current = getGuidePreferences(settings);
-  const next: Record<string, unknown> = {
-    mode: update.mode ?? current.mode,
-  };
+  const raw = isRecord(settings) && isRecord(settings.selesaiGuide)
+    ? settings.selesaiGuide
+    : {};
+  const next: Record<string, unknown> = {};
+  if (update.mode !== undefined) {
+    next.mode = update.mode;
+  } else if (typeof raw.mode === "string") {
+    // Version-only writes (markGuideVersionSeen) must preserve an explicit user
+    // mode but never persist the fallback default as a user choice.
+    next.mode = raw.mode;
+  }
   const lastSeenVersion = update.lastSeenVersion === null
     ? undefined
     : update.lastSeenVersion ?? current.lastSeenVersion;