praxis-agent 0.39.0 → 0.41.0

package/README.md

@@ -90,7 +90,8 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
 
 - **Local agent runtime** — Claude-style responsive TUI with a fixed fullscreen
   viewport, non-shrinking composer/status area, and complete bounded welcome
-  surface, plus a shared-command
+  surface with the reusable P-loop + spark Praxis mark and ANSI/no-color
+  fallbacks, plus a shared-command
   slash palette, tabbed help and shortcut surfaces, searchable resume picker,
   restored active-branch conversation history, streaming and expandable
   thinking, grouped multi-file reads, globally expandable tool results,
@@ -105,7 +106,29 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   skills/hooks flow, provider-free per-session `/color` prompt-bar styling,
   `/mcp`, `/memory` shared instruction and auto-memory
   access, and live extension-reload controls,
+  plus a framework-free runtime kernel that atomically publishes streaming
+  frames and keeps status/busy transitions deterministic, with a unified
+  framework-free TuiStore that retains runtime and composer state together,
+  with a shared semantic transcript Row IR for renderer-neutral layout and
+  stable incremental updates,
+  backed by the authoritative grapheme/Markdown viewport layout so narrow and
+  Unicode-heavy transcripts wrap consistently across renderers,
+  and an independent ANSI fullscreen frame renderer with alternate-screen
+  lifecycle, synchronized output, and dirty-row diffing,
+  opt-in TTY wiring with automatic Ink fallback on renderer failure,
+  with complex overlays and dialogs intentionally remaining on the mature Ink
+  surface until their semantic ANSI projections are complete,
+  while welcome and identity intros also remain on Ink for a complete first
+  frame,
+  and a pure FocusStack that centralizes overlay/dialog precedence and Esc
+  cancellation routing,
+  plus a generation-aware effect runner that drops stale asynchronous results
+  and aborts cleanly on replacement or unmount,
+  with ANSI fullscreen text styles derived from the active semantic theme and
+  automatic no-color/screen-reader suppression,
   cursor/history composer, provider-free `/cost` usage and pricing summaries,
+  with a hermetic PTY smoke covering real `runInteractive` ANSI entry,
+  resize-safe lifecycle, and Ctrl-C restoration,
   interactive `/doctor` diagnostics, per-session model/effort/permission controls,
   context/status/skill/task dashboards, prompt stash and continuation shortcuts,
   filterable `@` file and agent references, composer undo, `Ctrl+G` external
@@ -147,7 +170,9 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   exclusions, violation reporting, and bare-repository control-file cleanup,
   safe-property Skill auto-allow, interactive
   workspace-directory add/remove controls, path confinement, credential
-  redaction, and sanitized child processes.
+  redaction, sanitized child processes, and exact-fingerprint workspace trust
+  that blocks automatically discovered project/local hooks and MCP servers
+  until the canonical workspace configuration is explicitly accepted.
 - **Durable local work** — resumable sessions, full-history forks, file
   checkpoints, tasks, foreground/background subagents, top-level agents, and
   Claude-compatible main-thread agent definitions with native prompt, model,

package/dist/cli/controls.js

@@ -7,6 +7,7 @@ export const DEFAULT_CLI_CONTROLS = {
     settingSources: undefined,
     safeMode: false,
     bare: false,
+    trustProject: false,
     systemPrompt: undefined,
     systemPromptFile: undefined,
     appendSystemPrompt: undefined,
@@ -180,6 +181,7 @@ export async function resolveCliControls(controls, cwd) {
         settingSources: controls.settingSources,
         safeMode: controls.safeMode,
         bare: controls.bare,
+        trustProject: controls.trustProject,
         systemPrompt,
         appendSystemPrompt,
         excludeDynamicSystemPromptSections: controls.excludeDynamicSystemPromptSections,

package/dist/cli/interactive.d.ts

@@ -135,6 +135,7 @@ interface InteractiveAppProps {
     onRendererChange?: (mode: PraxisRuntimeSettings['tui'], sessionId: string | null) => void;
     onBackground?: (request: InteractiveBackgroundRequest) => Promise<InteractiveBackgroundResult>;
     axScreenReader?: boolean;
+    ansiRenderer?: boolean;
     allowNewSession?: boolean;
     resume?: InteractiveResumeOptions;
     display?: TuiDisplayMetadata;
@@ -204,7 +205,7 @@ export interface InteractiveHistoryState {
 }
 /** Advances the React-owned transcript plus its exact local mutation fact. */
 export declare function advanceInteractiveHistoryState(current: InteractiveHistoryState, items: TranscriptItem[], changedFrom: number): InteractiveHistoryState;
-export declare function InteractiveApp({ dataPlane, configRoot: suppliedConfigRoot, statePath: suppliedStatePath, factory, initialSessions, initialPrompt, initialHistory, initialSessionColor, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader, allowNewSession, resume, display, terminalWidth, slashCommands, agents, allowDangerouslySkipPermissions, additionalDirectories, diffLoader, doctorLoader, fileLoader, externalEditor, keybindingsConfigRoot, keybindingsFile, keybindingsLoader, keybindingsEditor, memoryFilesLoader, memoryEditor, memoryFolderOpener, suspendProcess, clipboardReader, clipboardWriter, sideQuestionClipboardWriter, exportWriter, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver, workspaceDirectoryCompleter, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, notificationDelayMs, elicitationUrlOpener, releaseNotesLoader, settingSources, }: InteractiveAppProps): import("react").JSX.Element;
+export declare function InteractiveApp({ dataPlane, configRoot: suppliedConfigRoot, statePath: suppliedStatePath, factory, initialSessions, initialPrompt, initialHistory, initialSessionColor, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader, ansiRenderer, allowNewSession, resume, display, terminalWidth, slashCommands, agents, allowDangerouslySkipPermissions, additionalDirectories, diffLoader, doctorLoader, fileLoader, externalEditor, keybindingsConfigRoot, keybindingsFile, keybindingsLoader, keybindingsEditor, memoryFilesLoader, memoryEditor, memoryFolderOpener, suspendProcess, clipboardReader, clipboardWriter, sideQuestionClipboardWriter, exportWriter, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver, workspaceDirectoryCompleter, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, notificationDelayMs, elicitationUrlOpener, releaseNotesLoader, settingSources, }: InteractiveAppProps): import("react").JSX.Element;
 export declare function runInteractive(options: {
     dataPlane?: DataPlane;
     configRoot?: string;

package/dist/cli/interactive.js

@@ -5,7 +5,7 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { useEffect, useMemo, useRef, useState } from 'react';
+import { useEffect, useMemo, useReducer, useRef, useState, } from 'react';
 import { Box, Text, render, useApp, useInput } from 'ink';
 import { permissionRuleValueToString } from '../permissions/permission-updates.js';
 import { resolveDataPlane, resolveDataPlaneRoot, } from '../persistence/data-plane.js';
@@ -22,10 +22,13 @@ import { loadTuiMemoryFiles, openTuiMemoryFolder, } from './tui/memory-files.js'
 import { loadClaudeReleaseNotes } from './tui/release-notes.js';
 import { tuiInkRenderOptions, useTuiPresentationEnvironment, } from './tui/presentation-environment.js';
 import { StreamingFrameBuffer } from './tui/streaming-frame-buffer.js';
+import { createTuiStoreState, reduceTuiStore } from './tui/kernel/tui-store.js';
+import { TuiEffectRunner } from './tui/kernel/tui-effect-runner.js';
 import { createClaudeStatusLineInput, StatusLine } from './tui/status-line.js';
 import { createTuiAppendHistoryChange } from './tui/transcript-window-model.js';
 import { createTuiHistoryChange, resolveTuiRenderer, } from './tui/tui-view-model.js';
 import { projectTuiScreen, } from './tui/tui-screen-model.js';
+import { supportsAnsiSurface, TuiAnsiSurface } from './tui/ansi-surface.js';
 import { projectTuiHelpSurface, } from './tui/help-surface-model.js';
 import { projectTuiHooksSurface, } from './tui/hooks-surface-model.js';
 import { loadGitDiff } from './tui/git-diff.js';
@@ -41,6 +44,7 @@ import { canonicalClaudeCostModelName, formatCostSummary, } from './tui/cost-sum
 import { createComposerEditor, deleteComposerBackward, deleteComposerForward, insertComposerText, moveComposerCursor, } from './tui/composer-editor.js';
 import { routeComposerKey, } from './tui/composer-key-router.js';
 import { routeTuiInteraction, } from './tui/tui-interaction-router.js';
+import { currentTuiInteractionLayer, projectTuiFocusStack, } from './tui/tui-focus-stack.js';
 import { applyMentionReference, fileReferenceAtCursor, loadTuiFileEntries, } from './tui/file-picker.js';
 import { projectTuiMentionPicker, tuiMentionEntryId, } from './tui/mention-picker-model.js';
 import { projectTuiListSurface, } from './tui/list-surface-model.js';
@@ -270,7 +274,7 @@ export function advanceInteractiveHistoryState(current, items, changedFrom) {
             : createTuiHistoryChange(revision, changedFrom, items, current.items),
     };
 }
-export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: suppliedConfigRoot, statePath: suppliedStatePath, factory, initialSessions, initialPrompt, initialHistory = [], initialSessionColor, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, doctorLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader, memoryEditor = openTuiEditorFile, memoryFolderOpener = openTuiMemoryFolder, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, notificationDelayMs = 6_000, elicitationUrlOpener = openTuiUrl, releaseNotesLoader = (configRoot) => loadClaudeReleaseNotes({ configRoot }), settingSources, }) {
+export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: suppliedConfigRoot, statePath: suppliedStatePath, factory, initialSessions, initialPrompt, initialHistory = [], initialSessionColor, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader = false, ansiRenderer = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, doctorLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader, memoryEditor = openTuiEditorFile, memoryFolderOpener = openTuiMemoryFolder, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, sandboxStore: suppliedSandboxStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, notificationDelayMs = 6_000, elicitationUrlOpener = openTuiUrl, releaseNotesLoader = (configRoot) => loadClaudeReleaseNotes({ configRoot }), settingSources, }) {
     const { exit, suspendTerminal, waitUntilRenderFlush } = useApp();
     const settingsDirectory = '.praxis';
     const keybindingsRoot = useMemo(() => resolve(suppliedConfigRoot ?? keybindingsConfigRoot ?? resolveDataPlaneRoot()), [dataPlane, keybindingsConfigRoot, suppliedConfigRoot]);
@@ -338,8 +342,17 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
     const [themeSettings, setThemeSettings] = useState(initialThemeSettings ?? DEFAULT_TUI_THEME_SETTINGS);
     const [runtimeSettings, setRuntimeSettings] = useState(suppliedRuntimeSettings ??
         projectRuntimeSettings({ settings: {}, state: {} }));
+    const [ansiRendererFailed, setAnsiRendererFailed] = useState(false);
+    const ansiRequested = ansiRenderer &&
+        !ansiRendererFailed &&
+        !axScreenReader &&
+        runtimeSettings.tui === 'fullscreen';
     const presentation = useTuiPresentationEnvironment({
-        renderer: runtimeSettings.tui,
+        renderer: ansiRenderer
+            ? ansiRequested
+                ? 'fullscreen'
+                : 'default'
+            : runtimeSettings.tui,
         screenReader: axScreenReader,
         ...(terminalWidth === undefined
             ? {}
@@ -379,9 +392,7 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
         ? initialSessions.find((session) => session.sessionId === resume.sessionId)
         : undefined);
     const [pendingFork, setPendingFork] = useState(resume?.forkSession === true);
-    const [input, setInput] = useState('');
     const inputRef = useRef('');
-    const [inputCursor, setInputCursor] = useState(0);
     const inputCursorRef = useRef(0);
     const inputHistoryRef = useRef([]);
     const inputHistoryIndexRef = useRef(null);
@@ -392,6 +403,9 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
     const clipboardQueueRef = useRef(Promise.resolve());
     const clipboardPendingRef = useRef(0);
     const componentMountedRef = useRef(true);
+    const themeEffectRunnerRef = useRef(null);
+    if (themeEffectRunnerRef.current === null)
+        themeEffectRunnerRef.current = new TuiEffectRunner();
     const [clipboardBusy, setClipboardBusy] = useState(false);
     const stashedInputRef = useRef('');
     const lastEscapeAtRef = useRef(0);
@@ -430,15 +444,20 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
     const configOperationRef = useRef(null);
     const doctorMenuGenerationRef = useRef(0);
     const doctorOperationRef = useRef(null);
-    const [busy, setBusy] = useState(false);
+    const [tuiStore, dispatchKernel] = useReducer(reduceTuiStore, undefined, createTuiStoreState);
+    const busy = tuiStore.busy;
+    const status = tuiStore.status;
+    const activeText = tuiStore.activeText;
+    const activeThinking = tuiStore.activeThinking;
+    const input = tuiStore.composer.text;
+    const inputCursor = tuiStore.composer.cursor;
+    const setBusy = (value) => dispatchKernel({ type: 'set-busy', busy: value });
+    const setStatus = (value) => dispatchKernel({ type: 'set-status', status: value });
     const taskEntriesRef = useRef([]);
     const mcpControllerRef = useRef(null);
     const [compactProgress, setCompactProgress] = useState(0);
     const initialPromptRef = useRef(initialPrompt?.trim() ?? '');
     const [initialPromptPending, setInitialPromptPending] = useState(initialPromptRef.current.length > 0);
-    const [status, setStatus] = useState('ready');
-    const [activeText, setActiveText] = useState('');
-    const [activeThinking, setActiveThinking] = useState('');
     // One provider-neutral streaming frame buffer per mounted app. RuntimeEvent
     // text/thinking deltas accumulate here and are coalesced into bounded frames
     // instead of causing a React state update per delta. The React state is only
@@ -448,8 +467,11 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
     if (streamingFrameRef.current === null) {
         streamingFrameRef.current = new StreamingFrameBuffer({
             publish: (frame) => {
-                setActiveText(frame.text);
-                setActiveThinking(frame.thinking);
+                dispatchKernel({
+                    type: 'publish-stream-frame',
+                    text: frame.text,
+                    thinking: frame.thinking,
+                });
             },
         });
     }
@@ -1194,6 +1216,7 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
         sessionId,
         screenSurfaces,
     ]);
+    const ansiActive = ansiRequested && supportsAnsiSurface(screen);
     useEffect(() => {
         previousTuiScreenRef.current = screen;
     }, [screen]);
@@ -1273,6 +1296,7 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
     }, [exit, signal]);
     useEffect(() => () => {
         componentMountedRef.current = false;
+        themeEffectRunnerRef.current?.dispose();
         streamingFrameRef.current?.dispose();
         drainPermissionQueue();
         elicitationRef.current?.resolve({ action: 'cancel' });
@@ -1308,20 +1332,23 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
                 append({ kind: 'warning', text: initialThemeLoadError });
             return;
         }
-        let cancelled = false;
-        void presentationThemeStore.load().then((loaded) => {
-            if (!cancelled)
+        const themeEffectRunner = themeEffectRunnerRef.current;
+        if (themeEffectRunner === null)
+            return;
+        const run = themeEffectRunner.run(async ({ isCurrent }) => {
+            const loaded = await presentationThemeStore.load();
+            return isCurrent() ? loaded : undefined;
+        });
+        void run.promise.then((loaded) => {
+            if (loaded !== undefined)
                 setThemeSettings(themeSettingsWithCustomTheme(loaded, customThemes));
         }, (error) => {
-            if (!cancelled)
-                append({
-                    kind: 'warning',
-                    text: `Unable to load theme settings: ${error instanceof Error ? error.message : String(error)}`,
-                });
+            append({
+                kind: 'warning',
+                text: `Unable to load theme settings: ${error instanceof Error ? error.message : String(error)}`,
+            });
         });
-        return () => {
-            cancelled = true;
-        };
+        return run.cancel;
     }, [
         customThemes,
         initialThemeLoadError,
@@ -1404,8 +1431,11 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
         const editor = createComposerEditor(next, cursor);
         inputRef.current = editor.text;
         inputCursorRef.current = editor.cursor;
-        setInput(editor.text);
-        setInputCursor(editor.cursor);
+        dispatchKernel({
+            type: 'set-composer',
+            text: editor.text,
+            cursor: editor.cursor,
+        });
         setShortcutsVisible(false);
         setCommandPaletteOpen(slashCommandQuery(editor.text) !== null);
         setCommandSelection(0);
@@ -3578,32 +3608,23 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
         if (hasPendingPrefix) {
             keySequenceRef.current = { chord: inputChord, at: Date.now() };
         }
-        const layer = hasPendingPrefix
-            ? { kind: 'pending-prefix' }
-            : permission
-                ? { kind: 'cancelable', target: 'permission' }
-                : planApproval
-                    ? { kind: 'cancelable', target: 'plan-approval' }
-                    : question
-                        ? { kind: 'cancelable', target: 'question' }
-                        : elicitation
-                            ? {
-                                kind: 'cancelable',
-                                target: elicitationUrlWaiting
-                                    ? 'elicitation-url-waiting'
-                                    : elicitationForm?.expandedField
-                                        ? 'elicitation-options'
-                                        : 'elicitation',
-                            }
-                            : selectingSession
-                                ? { kind: 'delegated', target: 'session-picker' }
-                                : menuRef.current
-                                    ? { kind: 'delegated', target: 'menu' }
-                                    : filePickerVisible
-                                        ? { kind: 'cancelable', target: 'file-picker' }
-                                        : commandPaletteVisible
-                                            ? { kind: 'cancelable', target: 'command-palette' }
-                                            : { kind: 'none' };
+        const layer = currentTuiInteractionLayer(projectTuiFocusStack({
+            pendingPrefix: hasPendingPrefix,
+            permission: Boolean(permission),
+            planApproval: Boolean(planApproval),
+            question: Boolean(question),
+            elicitation: elicitation
+                ? elicitationUrlWaiting
+                    ? 'url-waiting'
+                    : elicitationForm?.expandedField
+                        ? 'expanded-options'
+                        : 'plain'
+                : false,
+            selectingSession: Boolean(selectingSession),
+            menu: Boolean(menuRef.current),
+            filePicker: filePickerVisible,
+            commandPalette: commandPaletteVisible,
+        }));
         const callerIntent = !busy && value === '?' && inputRef.current.length === 0
             ? 'toggle-shortcuts'
             : runtimeSettingsRef.current.leftArrowOpensAgents &&
@@ -6482,7 +6503,9 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
     });
     return (_jsx(TuiThemeProvider, { settings: themeSettings, screenReader: axScreenReader, children: _jsx(Box, { flexDirection: "column", ...(!fixedViewport
                 ? {}
-                : { height: rows, overflowY: 'hidden' }), children: screen.body.kind === 'session-picker' ? (_jsx(SessionPicker, { model: screen.body.surface, screenReader: axScreenReader })) : (_jsxs(_Fragment, { children: [screen.body.intro === 'welcome' ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width, showTips: runtimeSettings.tips })) : null, screen.body.sessionLabel ? (_jsxs(Text, { dimColor: true, children: ["Session ", screen.body.sessionLabel] })) : null, screen.body.intro === 'identity' ? (_jsx(SessionIdentity, { display: runtimeDisplay, width: width })) : null, _jsx(Box, { ...(fixedViewport
+                : { height: rows, overflowY: 'hidden' }), children: ansiActive ? (_jsx(TuiAnsiSurface, { screen: screen, width: width, rows: rows, input: shellMode ? input.slice(1) : input, busy: busy, status: status, display: runtimeDisplay, ...(conversationScreen?.sessionLabel === undefined
+                    ? {}
+                    : { sessionLabel: conversationScreen.sessionLabel }), cursor: shellMode ? Math.max(0, inputCursor - 1) : inputCursor, screenReader: axScreenReader, onError: () => setAnsiRendererFailed(true) })) : screen.body.kind === 'session-picker' ? (_jsx(SessionPicker, { model: screen.body.surface, screenReader: axScreenReader })) : (_jsxs(_Fragment, { children: [screen.body.intro === 'welcome' ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width, showTips: runtimeSettings.tips })) : null, screen.body.sessionLabel ? (_jsxs(Text, { dimColor: true, children: ["Session ", screen.body.sessionLabel] })) : null, screen.body.intro === 'identity' ? (_jsx(SessionIdentity, { display: runtimeDisplay, width: width })) : null, _jsx(Box, { ...(fixedViewport
                             ? {
                                 flexShrink: 1,
                                 minHeight: 0,
@@ -6702,13 +6725,16 @@ export async function runInteractive(options) {
         let cleanup = null;
         let backgrounded;
         rendererChange = null;
+        const ansiRendererEnabled = currentRenderer === 'fullscreen' &&
+            process.stdin.isTTY === true &&
+            options.axScreenReader !== true;
         const instance = render(_jsx(InteractiveApp, { dataPlane: dataPlane, configRoot: configRoot, statePath: statePath, factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, ...(initialSessionColor === undefined ? {} : { initialSessionColor }), runtimeSettings: currentRuntimeSettings, runtimeSettingsTarget: runtimeSettingsTarget, ...(options.settingSources === undefined
                 ? {}
                 : { settingSources: options.settingSources }), initialThemeSettings: initialThemeSettings, ...(initialThemeLoadError === undefined
                 ? {}
                 : { initialThemeLoadError }), ...(currentInitialPrompt === undefined
                 ? {}
-                : { initialPrompt: currentInitialPrompt }), signal: signal, onCancel: () => controller.abort(), onTurnChange: (turn) => {
+                : { initialPrompt: currentInitialPrompt }), signal: signal, ansiRenderer: ansiRendererEnabled, onCancel: () => controller.abort(), onTurnChange: (turn) => {
                 activeTurn = turn;
             }, onCleanup: (closing) => {
                 cleanup = closing;
@@ -6732,7 +6758,7 @@ export async function runInteractive(options) {
                 ? { allowDangerouslySkipPermissions: true }
                 : {}) }), {
             exitOnCtrlC: false,
-            ...tuiInkRenderOptions(currentRenderer, options.axScreenReader === true),
+            ...tuiInkRenderOptions(ansiRendererEnabled ? 'default' : currentRenderer, options.axScreenReader === true),
             interactive: true,
         });
         await instance.waitUntilExit();

package/dist/cli/protocol.d.ts

@@ -14,6 +14,7 @@ export interface CliControls {
     settingSources: readonly ('user' | 'project' | 'local')[] | undefined;
     safeMode: boolean;
     bare: boolean;
+    trustProject: boolean;
     systemPrompt: string | undefined;
     systemPromptFile: string | undefined;
     appendSystemPrompt: string | undefined;

package/dist/cli/protocol.js

@@ -359,6 +359,7 @@ export function parseCliInvocation(argv) {
     let autocompact;
     let safeMode = false;
     let bare = false;
+    let trustProject = false;
     let systemPrompt;
     let systemPromptFile;
     let appendSystemPrompt;
@@ -1082,6 +1083,10 @@ export function parseCliInvocation(argv) {
             bare = true;
             continue;
         }
+        if (value === '--trust-project') {
+            trustProject = true;
+            continue;
+        }
         if (value === '--init') {
             init = true;
             continue;
@@ -1343,6 +1348,7 @@ export function parseCliInvocation(argv) {
         settingSources,
         safeMode,
         bare,
+        trustProject,
         systemPrompt,
         systemPromptFile,
         appendSystemPrompt,

package/dist/cli/tui/ansi-frame-renderer.d.ts

@@ -0,0 +1,24 @@
+import type { TuiRow, TuiTextRole } from './tui-row-ir.js';
+export interface AnsiFrameWriter {
+    write(chunk: string): void;
+}
+export interface AnsiFrame {
+    readonly columns: number;
+    readonly rows: number;
+    readonly lines: readonly TuiRow[];
+}
+export interface AnsiFullscreenRendererOptions {
+    readonly writer: AnsiFrameWriter;
+    readonly synchronizedOutput?: boolean;
+    readonly styles?: Partial<Record<TuiTextRole, string>>;
+}
+export declare class AnsiFullscreenRenderer {
+    #private;
+    constructor(options: AnsiFullscreenRendererOptions);
+    setStyles(styles?: Partial<Record<TuiTextRole, string>>): void;
+    get mounted(): boolean;
+    mount(): void;
+    draw(frame: AnsiFrame): void;
+    dispose(): void;
+}
+//# sourceMappingURL=ansi-frame-renderer.d.ts.map

package/dist/cli/tui/ansi-frame-renderer.js

@@ -0,0 +1,120 @@
+import { stripVTControlCharacters } from 'node:util';
+const ALTERNATE_SCREEN_ENTER = '\u001b[?1049h';
+const ALTERNATE_SCREEN_LEAVE = '\u001b[?1049l';
+const HIDE_CURSOR = '\u001b[?25l';
+const SHOW_CURSOR = '\u001b[?25h';
+const SYNCHRONIZED_BEGIN = '\u001b[?2026h';
+const SYNCHRONIZED_END = '\u001b[?2026l';
+const RESET = '\u001b[0m';
+function validateFrame(frame) {
+    if (frame === null || typeof frame !== 'object') {
+        throw new TypeError('ANSI frame must be an object');
+    }
+    for (const key of ['columns', 'rows']) {
+        const value = frame[key];
+        if (!Number.isFinite(value) || !Number.isInteger(value) || value <= 0) {
+            throw new TypeError(`ANSI frame ${key} must be a positive finite integer`);
+        }
+    }
+    if (!Array.isArray(frame.lines)) {
+        throw new TypeError('ANSI frame lines must be an array');
+    }
+}
+function renderLine(row, styles, columns) {
+    const segments = row.segments.map((segment) => ({
+        text: stripVTControlCharacters(segment.text).replace(/[\r\n]/gu, ''),
+        role: segment.role,
+    }));
+    const visibleLength = segments.reduce((length, segment) => length + Array.from(segment.text).length, 0);
+    const wasTruncated = visibleLength > columns;
+    const targetLength = wasTruncated ? Math.max(0, columns - 1) : columns;
+    let remaining = targetLength;
+    let line = '';
+    for (const segment of segments) {
+        if (remaining === 0)
+            break;
+        const text = Array.from(segment.text).slice(0, remaining).join('');
+        remaining -= Array.from(text).length;
+        const style = styles?.[segment.role];
+        line += style === undefined ? text : `${style}${text}${RESET}`;
+    }
+    if (wasTruncated)
+        line += '…';
+    if (line.length === 0)
+        line = ' ';
+    return line;
+}
+export class AnsiFullscreenRenderer {
+    #writer;
+    #synchronizedOutput;
+    #styles;
+    #mounted = false;
+    #previousLines = [];
+    constructor(options) {
+        this.#writer = options.writer;
+        this.#synchronizedOutput = options.synchronizedOutput === true;
+        this.#styles = options.styles;
+    }
+    setStyles(styles) {
+        this.#styles = styles;
+    }
+    get mounted() {
+        return this.#mounted;
+    }
+    mount() {
+        if (this.#mounted)
+            return;
+        this.#writer.write(ALTERNATE_SCREEN_ENTER);
+        this.#writer.write(HIDE_CURSOR);
+        if (this.#synchronizedOutput)
+            this.#writer.write(SYNCHRONIZED_BEGIN);
+        this.#mounted = true;
+    }
+    draw(frame) {
+        if (!this.#mounted)
+            throw new Error('ANSI fullscreen renderer is not mounted');
+        validateFrame(frame);
+        const lines = frame.lines.map((row) => renderLine(row, this.#styles, frame.columns));
+        const previousLines = this.#previousLines;
+        const changed = lines.length !== previousLines.length ||
+            lines.some((line, index) => line !== previousLines[index]);
+        if (!changed)
+            return;
+        if (this.#synchronizedOutput)
+            this.#writer.write(SYNCHRONIZED_BEGIN);
+        try {
+            const commonLength = Math.max(lines.length, previousLines.length);
+            for (let index = 0; index < commonLength; index += 1) {
+                const line = lines[index];
+                if (line !== undefined) {
+                    if (line === previousLines[index])
+                        continue;
+                    this.#writer.write(`\u001b[${index + 1};1H\u001b[2K${line}`);
+                }
+                else {
+                    this.#writer.write(`\u001b[${index + 1};1H\u001b[2K`);
+                }
+            }
+            this.#previousLines = lines;
+        }
+        finally {
+            if (this.#synchronizedOutput)
+                this.#writer.write(SYNCHRONIZED_END);
+        }
+    }
+    dispose() {
+        if (!this.#mounted)
+            return;
+        try {
+            if (this.#synchronizedOutput)
+                this.#writer.write(SYNCHRONIZED_END);
+            this.#writer.write(SHOW_CURSOR);
+            this.#writer.write(ALTERNATE_SCREEN_LEAVE);
+        }
+        finally {
+            this.#mounted = false;
+            this.#previousLines = [];
+        }
+    }
+}
+//# sourceMappingURL=ansi-frame-renderer.js.map

package/dist/cli/tui/ansi-surface.d.ts

@@ -0,0 +1,26 @@
+import { type AnsiFrame } from './ansi-frame-renderer.js';
+import type { TuiScreenModel } from './tui-screen-model.js';
+export interface TuiAnsiSurfaceProps {
+    screen: TuiScreenModel;
+    width: number;
+    rows: number | undefined;
+    input: string;
+    busy: boolean;
+    status: string;
+    screenReader?: boolean;
+    display?: {
+        cwd: string;
+        model?: string;
+        effort?: string;
+        permissionMode?: string;
+        version?: string;
+    };
+    sessionLabel?: string;
+    cursor?: number;
+    onError: (error: unknown) => void;
+}
+/** ANSI mode is intentionally limited to the plain conversation surface. */
+export declare function supportsAnsiSurface(screen: TuiScreenModel): boolean;
+export declare function projectAnsiSurfaceFrame(props: TuiAnsiSurfaceProps): AnsiFrame;
+export declare function TuiAnsiSurface(props: TuiAnsiSurfaceProps): null;
+//# sourceMappingURL=ansi-surface.d.ts.map