praxis-agent 0.11.0 → 0.13.0

package/README.md

@@ -15,6 +15,11 @@ Anthropic/OpenAI-compatible model access. Praxis deliberately excludes
 accounts, organizations, billing, managed enterprise policy, remote control,
 IDE surfaces, and telemetry control planes.
 
+Claude Code 2.1.208 is the compatibility, architecture, and design baseline.
+Every single-user CLI capability remains required unless it falls inside an
+explicit exclusion above. A similar Praxis surface is not a substitute for the
+corresponding Claude command or runtime contract.
+
 ## Requirements
 
 - macOS or Linux
@@ -87,8 +92,10 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   `/rewind`, runtime `/cd`, transcript-free
   `/btw` side questions with background-Agent handoff, interactive
   `/background` terminal handoff, unified `/status`/`/config`/`/usage` settings
-  tabs, `/mcp`, `/memory` shared
-  instruction and auto-memory access, and live extension-reload controls,
+  tabs, `/sandbox` mode/dependency/override/config controls, local cached
+  `/release-notes`, Claude-compatible `/statusline` command execution and setup
+  agent, `/mcp`, `/memory` shared instruction and auto-memory access, and live
+  extension-reload controls,
   cursor/history composer, 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
@@ -121,6 +128,10 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   constraints, internal auto-memory/session/task path handling, compound `cd` +
   Git protection, mode-ordered `acceptEdits` handling, live raw/resolved-path
   grants for external directories,
+  Claude-compatible opt-in Bash sandboxing with filesystem and network
+  isolation, explicit ask/deny precedence, sandbox-only auto-allow,
+  write-allowlist/deny-within-allow enforcement, per-command overrides and
+  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.

package/dist/application/subagent-service.d.ts

@@ -1,7 +1,7 @@
 import { type ClaudeSidechainPermissionMode } from '../compatibility/claude/sidechain.js';
 import { type ContextAssembler } from '../core/context.js';
 import { type ModelProvider, type ModelToolCall, type ModelToolDefinition, type ModelUsage, type PermissionResolver, type PermissionApproval, type PermissionDecision, type PermissionUpdate, type RuntimeEventSink, type ToolExecutionContext, type ToolExecutionResult, type ToolRegistry } from '../core/runtime.js';
-import type { ClaudeExtensionCatalog } from '../extensions/claude-extensions.js';
+import { type ClaudeExtensionCatalog } from '../extensions/claude-extensions.js';
 import type { ClaudeHookRunner } from '../hooks/claude-hooks.js';
 import { type BackgroundAgentSnapshot } from './background-agent-manager.js';
 export interface WorkflowAgentRunOptions {

package/dist/application/subagent-service.js

@@ -11,6 +11,7 @@ import { createClaudeHookAttachmentEntries, translateProviderEvents, } from '../
 import { injectFirstUserMessageContext, } from '../core/context.js';
 import { ContextBudget } from '../core/context-budget.js';
 import { AgentRuntime, } from '../core/runtime.js';
+import { BUILTIN_STATUSLINE_AGENT_PATH, } from '../extensions/claude-extensions.js';
 import { ClaudeHookToolCoordinator } from '../hooks/claude-hook-tools.js';
 import { ClaudeSidechainStore } from '../persistence/claude-sidechain-store.js';
 import { InMemorySidechainStore } from '../persistence/in-memory-sidechain-store.js';
@@ -79,6 +80,29 @@ export class StructuredOutputRegistry {
         });
     }
 }
+class RestrictedToolRegistry {
+    base;
+    allowed;
+    constructor(base, names) {
+        this.base = base;
+        this.allowed = new Set(names);
+    }
+    definitions() {
+        return this.base
+            .definitions()
+            .filter((definition) => this.allowed.has(definition.name));
+    }
+    prepare(call, context) {
+        if (!this.allowed.has(call.name))
+            throw new Error(`Tool ${call.name} is unavailable to this agent`);
+        return this.base.prepare(call, context);
+    }
+    execute(call, context) {
+        if (!this.allowed.has(call.name))
+            throw new Error(`Tool ${call.name} is unavailable to this agent`);
+        return this.base.execute(call, context);
+    }
+}
 function parseAgentInput(call) {
     const allowed = new Set([
         'description',
@@ -942,9 +966,16 @@ export class ClaudeSubagentExecutor {
             permission_mode: options.input.permissionMode ?? 'default',
         };
         const nestedTools = this.registry(String(options.root.sessionId), options.spawnDepth, () => options.promptId);
-        const agentTools = options.outputSchema
-            ? new StructuredOutputRegistry(structuredOnlyTools, options.outputSchema, options.structuredOutput)
+        const builtInStatusLineAgent = this.options.extensions?.agent(options.input.subagentType)?.path ===
+            BUILTIN_STATUSLINE_AGENT_PATH;
+        const scopedTools = builtInStatusLineAgent
+            ? new RestrictedToolRegistry(nestedTools, ['Read', 'Edit'])
             : nestedTools;
+        const agentTools = options.outputSchema
+            ? new StructuredOutputRegistry(builtInStatusLineAgent
+                ? new RestrictedToolRegistry(structuredOnlyTools, ['Read', 'Edit'])
+                : structuredOnlyTools, options.outputSchema, options.structuredOutput)
+            : scopedTools;
         const runtimeTools = this.options.hooks
             ? new ClaudeHookToolCoordinator({
                 tools: agentTools,

package/dist/cli/interactive.d.ts

@@ -18,6 +18,7 @@ import { loadTuiKeybindings, type TuiKeybindingsFile } from './tui/keybindings.j
 import { completeTuiWorkspaceDirectory, resolveTuiWorkspaceDirectory } from './tui/workspace-directories.js';
 import { type TuiThemeSettings } from './tui/theme.js';
 import { type CustomThemeBase, type CustomThemeToken, type TuiCustomTheme } from './tui/custom-themes.js';
+import { type TuiSandboxStore } from './tui/sandbox-settings.js';
 import { type ConfigSettingsTarget } from './tui/config-settings.js';
 import { type PraxisRuntimeSettings } from './tui/runtime-settings.js';
 import { type TuiNotificationWriter } from './tui/terminal-notifications.js';
@@ -152,6 +153,7 @@ interface InteractiveAppProps {
         }): Promise<void>;
         remove?(rule: TuiPermissionRule): Promise<void>;
     };
+    sandboxStore?: TuiSandboxStore;
     recentlyDeniedStore?: RecentlyDeniedStore;
     themeStore?: {
         load(): Promise<TuiThemeSettings>;
@@ -173,8 +175,10 @@ interface InteractiveAppProps {
     runtimeSettingsTarget?: ConfigSettingsTarget;
     notificationWriter?: TuiNotificationWriter;
     elicitationUrlOpener?: (url: string) => void | Promise<void>;
+    releaseNotesLoader?: (configRoot: string) => Promise<string>;
+    settingSources?: readonly ClaudeResourceScope[];
 }
-export declare function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader, allowNewSession, resume, display, terminalWidth, slashCommands, agents, allowDangerouslySkipPermissions, additionalDirectories, diffLoader, fileLoader, externalEditor, keybindingsConfigRoot, keybindingsFile, keybindingsLoader, keybindingsEditor, memoryFilesLoader, memoryEditor, memoryFolderOpener, suspendProcess, clipboardReader, clipboardWriter, sideQuestionClipboardWriter, exportWriter, permissionRuleStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver, workspaceDirectoryCompleter, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener, }: InteractiveAppProps): import("react").JSX.Element;
+export declare function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory, signal, onCancel, onTurnChange, onCleanup, onRendererChange, onBackground, axScreenReader, allowNewSession, resume, display, terminalWidth, slashCommands, agents, allowDangerouslySkipPermissions, additionalDirectories, diffLoader, 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, elicitationUrlOpener, releaseNotesLoader, settingSources, }: InteractiveAppProps): import("react").JSX.Element;
 export declare function runInteractive(options: {
     factory: InteractiveServiceFactory;
     initialPrompt?: string;
@@ -190,6 +194,7 @@ export declare function runInteractive(options: {
     onBackground?: (request: InteractiveBackgroundRequest) => Promise<InteractiveBackgroundResult>;
     onBackgrounded?: (result: InteractiveBackgroundResult) => void;
     runtimeSettings?: PraxisRuntimeSettings;
+    settingSources?: readonly ClaudeResourceScope[];
 }): Promise<number>;
 export {};
 //# sourceMappingURL=interactive.d.ts.map

package/dist/cli/interactive.js

@@ -12,6 +12,8 @@ import { claudePermissionActionKey, claudePermissionRuleMatches, } from '../perm
 import { redactSensitiveText, sensitiveEnvironmentValues, } from '../platform/sensitive-data.js';
 import { CommandPalette, BtwPanel, Composer, DiffDashboard, DialogFrame, ExternalEditorWait, HelpMenu, HookDashboard, ListDashboard, MemoryDashboard, MentionPicker, ModelMenu, PermissionDashboard, SelectionMenu, SessionPicker, ThemePicker, CustomThemeEditor, Transcript, WelcomePanel, useTerminalWidth, } from './tui/claude-style.js';
 import { loadTuiMemoryFiles, openTuiMemoryFolder, } from './tui/memory-files.js';
+import { loadClaudeReleaseNotes } from './tui/release-notes.js';
+import { createClaudeStatusLineInput, StatusLine } from './tui/status-line.js';
 import { loadGitDiff, visiblePatchLines, } from './tui/git-diff.js';
 import { addTuiPermissionRule, loadTuiPermissionRules, removeTuiPermissionRule, } from './tui/permission-settings.js';
 import { createRecentlyDeniedStore, } from './tui/recently-denied.js';
@@ -33,6 +35,8 @@ import { commitElicitationText, createTuiElicitationForm, elicitationFormIsValid
 import { openTuiUrl } from './tui/open-url.js';
 import { projectTuiToolPermission, ToolPermissionDialog, } from './tui/tool-permission.js';
 import { ConfigDashboard, projectConfigRows } from './tui/config-dashboard.js';
+import { SandboxDashboard, tuiSandboxTabs } from './tui/sandbox-dashboard.js';
+import { createTuiSandboxStore, } from './tui/sandbox-settings.js';
 import { loadConfigSettings, saveConfigSetting, configSettingDefinition, resolveConfigSettingsLocation, } from './tui/config-settings.js';
 import { projectRuntimeSettings, loadRuntimeSettings, } from './tui/runtime-settings.js';
 import { autoUpdateTarget, copyCandidates, externalEditorInitialContent, formatTurnDuration, questionTimeoutMilliseconds, sessionRecap, spinnerTip, shouldShowCopyPicker, } from './tui/runtime-interactions.js';
@@ -232,7 +236,18 @@ function ordinal(value) {
             return `${value}th`;
     }
 }
-export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], 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, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader = (configRoot, cwd) => loadTuiMemoryFiles({ configRoot, cwd }), memoryEditor = openTuiEditorFile, memoryFolderOpener = openTuiMemoryFolder, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, recentlyDeniedStore: suppliedRecentlyDeniedStore, terminalSetup: terminalSetupOverride, themeStore, initialThemeSettings, initialThemeLoadError, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, runtimeSettings: suppliedRuntimeSettings, runtimeSettingsTarget, notificationWriter, elicitationUrlOpener = openTuiUrl, }) {
+const HIDDEN_TUI_SLASH_COMMANDS = new Set([
+    'background',
+    'new',
+    'output-style',
+    'reload-skills',
+    'sessions',
+    'skill',
+    'terminal-setup',
+    'update',
+    'usage',
+]);
+export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], 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, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, memoryFilesLoader = (configRoot, cwd) => loadTuiMemoryFiles({ configRoot, cwd }), 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, elicitationUrlOpener = openTuiUrl, releaseNotesLoader = (configRoot) => loadClaudeReleaseNotes({ configRoot }), settingSources, }) {
     const { exit, suspendTerminal, waitUntilRenderFlush } = useApp();
     const width = useTerminalWidth(terminalWidth);
     const keybindingsRoot = useMemo(() => resolve(keybindingsConfigRoot ??
@@ -286,6 +301,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const [selectedIndex, setSelectedIndex] = useState(0);
     const selectedIndexRef = useRef(0);
     const [sessionId, setSessionId] = useState(resume?.sessionId ?? null);
+    const statusLineSessionId = useRef(resume?.sessionId ?? randomUUID());
     const sessionIdRef = useRef(resume?.sessionId ?? null);
     sessionIdRef.current = sessionId;
     const [sessionName, setSessionName] = useState(null);
@@ -369,6 +385,18 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         permissionMode: permissionMode(display.permissionMode),
         additionalDirectories: [...new Set(additionalDirectories)],
     }));
+    const sandboxStore = useMemo(() => suppliedSandboxStore ??
+        createTuiSandboxStore({
+            configRoot: keybindingsRoot,
+            cwd: runtimeCwd,
+            homeDirectory: homedir(),
+            additionalDirectories: runtimePreferences.additionalDirectories,
+        }), [
+        keybindingsRoot,
+        runtimeCwd,
+        runtimePreferences.additionalDirectories,
+        suppliedSandboxStore,
+    ]);
     const runtimePreferencesRef = useRef(runtimePreferences);
     const [permission, setPermission] = useState(null);
     const permissionRef = useRef(null);
@@ -3157,6 +3185,62 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             }
             return;
         }
+        if (earlyMenu?.kind === 'sandbox') {
+            if (key.escape || value === '\u001B') {
+                updateMenu(null);
+                return;
+            }
+            const tabs = tuiSandboxTabs(earlyMenu.snapshot);
+            if (key.leftArrow || key.rightArrow || key.tab) {
+                const index = tabs.indexOf(earlyMenu.tab);
+                const direction = key.leftArrow || (key.tab && key.shift) ? -1 : 1;
+                const tab = tabs[Math.max(0, Math.min(tabs.length - 1, index + direction))] ??
+                    earlyMenu.tab;
+                updateMenu({ ...earlyMenu, tab, selectedIndex: 0 });
+                return;
+            }
+            const rowCount = earlyMenu.tab === 'mode'
+                ? 3
+                : earlyMenu.tab === 'overrides' && earlyMenu.snapshot.settings.enabled
+                    ? 2
+                    : 0;
+            if (rowCount > 0 && (key.upArrow || key.downArrow)) {
+                updateMenu({
+                    ...earlyMenu,
+                    selectedIndex: Math.max(0, Math.min(rowCount - 1, earlyMenu.selectedIndex + (key.upArrow ? -1 : 1))),
+                });
+                return;
+            }
+            if (rowCount > 0 && key.return) {
+                const saving = (async () => {
+                    setBusy(true);
+                    try {
+                        const snapshot = earlyMenu.tab === 'mode'
+                            ? await sandboxStore.setMode(['auto-allow', 'regular', 'disabled'][earlyMenu.selectedIndex] ?? 'auto-allow')
+                            : await sandboxStore.setAllowUnsandboxedCommands(earlyMenu.selectedIndex === 0);
+                        await retireService();
+                        const tabs = tuiSandboxTabs(snapshot);
+                        updateMenu({
+                            kind: 'sandbox',
+                            tab: tabs.includes(earlyMenu.tab)
+                                ? earlyMenu.tab
+                                : (tabs[0] ?? 'dependencies'),
+                            selectedIndex: earlyMenu.selectedIndex,
+                            snapshot,
+                        });
+                    }
+                    catch (error) {
+                        warn(error);
+                    }
+                    finally {
+                        setBusy(false);
+                    }
+                })();
+                onTurnChange?.(saving);
+                void saving.finally(() => onTurnChange?.(null));
+            }
+            return;
+        }
         if (earlyMenu?.kind === 'config') {
             if (key.escape || value === '\u001B') {
                 if (earlyMenu.searchFocused && earlyMenu.query) {
@@ -4673,9 +4757,13 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                 commandNameQuery === selectedCommand.name.toLocaleLowerCase();
             const selectedCommandMatchesName = selectedCommand !== undefined &&
                 selectedCommand.name.toLocaleLowerCase().startsWith(commandNameQuery);
+            const exactHiddenCommand = HIDDEN_TUI_SLASH_COMMANDS.has(commandNameQuery);
             if (selectedCommand &&
                 (key.tab ||
-                    (key.return && !exactSelectedCommand && selectedCommandMatchesName))) {
+                    (key.return &&
+                        !exactSelectedCommand &&
+                        !exactHiddenCommand &&
+                        selectedCommandMatchesName))) {
                 updateComposerInput(`/${selectedCommand.name} `);
                 setCommandPaletteOpen(false);
                 return;
@@ -4702,6 +4790,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             if (!prompt || prompt === '!')
                 return;
             const copyCommand = /^\/copy(?:\s+(\d+))?$/u.exec(prompt);
+            const sandboxCommand = /^\/sandbox(?:\s+([\s\S]+))?$/u.exec(prompt);
             const tuiCommand = /^\/tui(?:\s+(default|fullscreen))?$/u.exec(prompt);
             const renameCommand = /^\/rename(?:\s+(.+))?$/u.exec(prompt);
             const cdCommand = /^\/cd(?:\s+(.+))?$/u.exec(prompt);
@@ -4713,11 +4802,13 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                 updateMenu({ kind: 'help', tabIndex: 0, selectedIndex: 0 });
             }
             else if (prompt === '/new') {
+                statusLineSessionId.current = randomUUID();
                 setSessionId(null);
                 setPendingFork(false);
                 append({ kind: 'notice', text: 'Started a new session.' });
             }
             else if (prompt === '/clear') {
+                statusLineSessionId.current = randomUUID();
                 setSessionId(null);
                 setPendingFork(false);
                 setHistory([]);
@@ -4883,6 +4974,52 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                 append({ kind: 'user', text: prompt });
                 updateMenu({ kind: 'export', selectedIndex: 0 });
             }
+            else if (sandboxCommand) {
+                const operation = (async () => {
+                    setBusy(true);
+                    try {
+                        const args = sandboxCommand[1]?.trim();
+                        if (args) {
+                            const exclude = /^exclude(?:\s+([\s\S]+))?$/u.exec(args);
+                            if (!exclude) {
+                                throw new Error(`Unknown subcommand "${args.split(/\s+/u)[0] ?? args}". Available subcommand: exclude`);
+                            }
+                            if (!exclude[1]?.trim()) {
+                                throw new Error('Please provide a command pattern to exclude (e.g. /sandbox exclude "npm run test:*")');
+                            }
+                            const result = await sandboxStore.exclude(exclude[1]);
+                            await retireService();
+                            append({
+                                kind: 'local-result',
+                                text: `Added "${result.pattern}" to excluded commands in ${result.settingsPath}`,
+                            });
+                            return;
+                        }
+                        const snapshot = await sandboxStore.load();
+                        if (!snapshot.supported) {
+                            throw new Error('Sandboxing is currently only supported on macOS, Linux, and WSL2.');
+                        }
+                        if (snapshot.unavailableReason?.includes('not in sandbox.enabledPlatforms')) {
+                            throw new Error(snapshot.unavailableReason);
+                        }
+                        const tabs = tuiSandboxTabs(snapshot);
+                        updateMenu({
+                            kind: 'sandbox',
+                            tab: tabs[0] ?? 'dependencies',
+                            selectedIndex: 0,
+                            snapshot,
+                        });
+                    }
+                    catch (error) {
+                        warn(error);
+                    }
+                    finally {
+                        setBusy(false);
+                    }
+                })();
+                onTurnChange?.(operation);
+                void operation.finally(() => onTurnChange?.(null));
+            }
             else if (prompt === '/permissions') {
                 const loading = (async () => {
                     setBusy(true);
@@ -5044,6 +5181,27 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             else if (prompt === '/status') {
                 openSettings('status');
             }
+            else if (prompt === '/release-notes') {
+                const loading = (async () => {
+                    setBusy(true);
+                    setStatus('loading release notes');
+                    try {
+                        append({
+                            kind: 'local-result',
+                            text: await releaseNotesLoader(keybindingsRoot),
+                        });
+                    }
+                    catch (error) {
+                        warn(error);
+                    }
+                    finally {
+                        setBusy(false);
+                        setStatus('ready');
+                    }
+                })();
+                onTurnChange?.(loading);
+                void loading.finally(() => onTurnChange?.(null));
+            }
             else if (prompt === '/config') {
                 openSettings('config');
             }
@@ -5197,7 +5355,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                                         ? `restore ${menu.point.fileChanges.join(', ')}.`
                                         : 'be unchanged.'] }), _jsx(Text, { children: " " }), rewindActions(menu.point).map((option, index) => (_jsxs(Text, { inverse: menu.selectedIndex === index, children: [menu.selectedIndex === index ? '❯ ' : '  ', index + 1, ". ", option.label] }, option.action))), _jsx(Text, { children: " " }), _jsx(Text, { color: activePalette.warning, children: "\u26A0 Rewinding does not affect files edited manually or via bash." })] })) : menu?.kind === 'rewind-context' ? (_jsxs(DialogFrame, { title: `Summarize ${menu.direction === 'from' ? 'from' : 'up to'} here`, screenReader: axScreenReader, children: [_jsx(Text, { children: menu.direction === 'from'
                                     ? 'Messages after this point will be summarized.'
-                                    : 'Messages up to this point will be summarized.' }), _jsx(Text, { children: " " }), _jsxs(Text, { children: ["add context (optional): ", input] }), _jsx(Text, { dimColor: true, children: "Enter to summarize \u00B7 Esc to go back" })] })) : menu?.kind === 'permission-rule-input' ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: ["Add ", menu.behavior, " permission rule"] }), _jsx(Text, { children: "Permission rules are a tool name, optionally followed by a specifier in parentheses." }), _jsx(Text, { children: "e.g., WebFetch or Bash(ls *)" }), _jsx(Text, { children: " " }), _jsx(Box, { borderStyle: axScreenReader ? undefined : 'round', paddingX: axScreenReader ? 0 : 1, children: _jsx(Text, { ...(input ? {} : { dimColor: true }), children: input || 'Enter permission rule…' }) }), _jsx(Text, { dimColor: true, children: "Enter to submit \u00B7 Esc to cancel" })] })) : menu?.kind === 'workspace-directory-input' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Add directory to workspace" }), _jsx(Text, { children: "Praxis Code will be able to read files in this directory and make edits when auto-accept edits is on." }), _jsx(Text, { children: " " }), _jsx(Text, { children: "Enter the path to the directory:" }), _jsx(Box, { borderStyle: axScreenReader ? undefined : 'round', paddingX: axScreenReader ? 0 : 1, children: _jsx(Text, { ...(input ? {} : { dimColor: true }), children: input || 'Directory path…' }) }), _jsx(Text, { dimColor: true, children: "Tab to complete \u00B7 Enter to add \u00B7 Esc to cancel" })] })) : menu?.kind === 'permission-delete' ? (_jsxs(DialogFrame, { title: permissionDeleteTitle(menu.rule.behavior), screenReader: axScreenReader, children: [_jsx(Text, { children: menu.rule.rule }), permissionRuleDescription(menu.rule.rule) ? (_jsx(Text, { dimColor: true, children: permissionRuleDescription(menu.rule.rule) })) : null, _jsx(Text, { dimColor: true, children: permissionScopeLabel(menu.rule.scope) }), _jsx(Text, { children: " " }), _jsx(Text, { children: "Are you sure you want to delete this permission rule?" }), _jsx(Text, { children: " " }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 0, children: [selectionPrefix(menu.selectedIndex === 0, axScreenReader), "1. Yes"] }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 1, children: [selectionPrefix(menu.selectedIndex === 1, axScreenReader), "2. No"] }), _jsx(Text, { dimColor: true, children: "Esc to cancel" })] })) : menu?.kind === 'workspace-directory-delete' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Remove directory from workspace?" }), _jsxs(Text, { children: [" ", menu.path] }), _jsx(Text, { children: " " }), _jsx(Text, { children: "Praxis Code will no longer have access to files in this directory." }), _jsx(Text, { children: " " }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 0, children: [selectionPrefix(menu.selectedIndex === 0, axScreenReader), "1. Yes"] }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 1, children: [selectionPrefix(menu.selectedIndex === 1, axScreenReader), "2. No"] }), _jsx(Text, { dimColor: true, children: "Enter to confirm \u00B7 Esc to cancel" })] })) : menu ? (menu.kind === 'help' ? (_jsx(HelpMenu, { tabIndex: menu.tabIndex, selectedIndex: menu.selectedIndex, builtinCommands: builtinSlashCommands, customCommands: customSlashCommands, width: width, screenReader: axScreenReader })) : menu.kind === 'diff' ? (_jsx(DiffDashboard, { snapshots: menu.snapshots, sourceIndex: menu.sourceIndex, selectedIndex: menu.selectedIndex, viewingFile: menu.viewingFile, scrollOffset: menu.scrollOffset, width: width, screenReader: axScreenReader })) : menu.kind === 'permission-dashboard' ? (_jsx(PermissionDashboard, { tabIndex: menu.tabIndex, selectedIndex: menu.selectedIndex, query: menu.query, rules: menu.rules, recentDenied: recentDenied, retryingDeniedId: retryingDeniedId, workspaceDirectories: workspaceDirectories, width: width, screenReader: axScreenReader })) : menu.kind === 'permission-scope' ? (_jsx(SelectionMenu, { title: "Where should this rule be saved?", description: `${menu.rule}${permissionRuleDescription(menu.rule)
+                                    : 'Messages up to this point will be summarized.' }), _jsx(Text, { children: " " }), _jsxs(Text, { children: ["add context (optional): ", input] }), _jsx(Text, { dimColor: true, children: "Enter to summarize \u00B7 Esc to go back" })] })) : menu?.kind === 'permission-rule-input' ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: ["Add ", menu.behavior, " permission rule"] }), _jsx(Text, { children: "Permission rules are a tool name, optionally followed by a specifier in parentheses." }), _jsx(Text, { children: "e.g., WebFetch or Bash(ls *)" }), _jsx(Text, { children: " " }), _jsx(Box, { borderStyle: axScreenReader ? undefined : 'round', paddingX: axScreenReader ? 0 : 1, children: _jsx(Text, { ...(input ? {} : { dimColor: true }), children: input || 'Enter permission rule…' }) }), _jsx(Text, { dimColor: true, children: "Enter to submit \u00B7 Esc to cancel" })] })) : menu?.kind === 'workspace-directory-input' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Add directory to workspace" }), _jsx(Text, { children: "Praxis Code will be able to read files in this directory and make edits when auto-accept edits is on." }), _jsx(Text, { children: " " }), _jsx(Text, { children: "Enter the path to the directory:" }), _jsx(Box, { borderStyle: axScreenReader ? undefined : 'round', paddingX: axScreenReader ? 0 : 1, children: _jsx(Text, { ...(input ? {} : { dimColor: true }), children: input || 'Directory path…' }) }), _jsx(Text, { dimColor: true, children: "Tab to complete \u00B7 Enter to add \u00B7 Esc to cancel" })] })) : menu?.kind === 'permission-delete' ? (_jsxs(DialogFrame, { title: permissionDeleteTitle(menu.rule.behavior), screenReader: axScreenReader, children: [_jsx(Text, { children: menu.rule.rule }), permissionRuleDescription(menu.rule.rule) ? (_jsx(Text, { dimColor: true, children: permissionRuleDescription(menu.rule.rule) })) : null, _jsx(Text, { dimColor: true, children: permissionScopeLabel(menu.rule.scope) }), _jsx(Text, { children: " " }), _jsx(Text, { children: "Are you sure you want to delete this permission rule?" }), _jsx(Text, { children: " " }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 0, children: [selectionPrefix(menu.selectedIndex === 0, axScreenReader), "1. Yes"] }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 1, children: [selectionPrefix(menu.selectedIndex === 1, axScreenReader), "2. No"] }), _jsx(Text, { dimColor: true, children: "Esc to cancel" })] })) : menu?.kind === 'workspace-directory-delete' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "Remove directory from workspace?" }), _jsxs(Text, { children: [" ", menu.path] }), _jsx(Text, { children: " " }), _jsx(Text, { children: "Praxis Code will no longer have access to files in this directory." }), _jsx(Text, { children: " " }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 0, children: [selectionPrefix(menu.selectedIndex === 0, axScreenReader), "1. Yes"] }), _jsxs(Text, { inverse: !axScreenReader && menu.selectedIndex === 1, children: [selectionPrefix(menu.selectedIndex === 1, axScreenReader), "2. No"] }), _jsx(Text, { dimColor: true, children: "Enter to confirm \u00B7 Esc to cancel" })] })) : menu ? (menu.kind === 'help' ? (_jsx(HelpMenu, { tabIndex: menu.tabIndex, selectedIndex: menu.selectedIndex, builtinCommands: builtinSlashCommands, customCommands: customSlashCommands, width: width, screenReader: axScreenReader })) : menu.kind === 'diff' ? (_jsx(DiffDashboard, { snapshots: menu.snapshots, sourceIndex: menu.sourceIndex, selectedIndex: menu.selectedIndex, viewingFile: menu.viewingFile, scrollOffset: menu.scrollOffset, width: width, screenReader: axScreenReader })) : menu.kind === 'permission-dashboard' ? (_jsx(PermissionDashboard, { tabIndex: menu.tabIndex, selectedIndex: menu.selectedIndex, query: menu.query, rules: menu.rules, recentDenied: recentDenied, retryingDeniedId: retryingDeniedId, workspaceDirectories: workspaceDirectories, width: width, screenReader: axScreenReader })) : menu.kind === 'sandbox' ? (_jsx(SandboxDashboard, { snapshot: menu.snapshot, tab: menu.tab, selectedIndex: menu.selectedIndex, width: width, screenReader: axScreenReader })) : menu.kind === 'permission-scope' ? (_jsx(SelectionMenu, { title: "Where should this rule be saved?", description: `${menu.rule}${permissionRuleDescription(menu.rule)
                             ? ` · ${permissionRuleDescription(menu.rule)}`
                             : ''}`, options: [
                             {
@@ -5263,7 +5421,39 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                                     ? { prStatus: `PR #${activeSessionSummary.prNumber}` }
                                     : {}), shortcutsVisible: shortcutsVisible, ...(editorFooterMessage === undefined
                                     ? {}
-                                    : { footerMessage: editorFooterMessage }) })] }))] })) }) }));
+                                    : { footerMessage: editorFooterMessage }) }), _jsx(StatusLine, { configRoot: keybindingsRoot, cwd: runtimeCwd, input: createClaudeStatusLineInput({
+                                    configRoot: keybindingsRoot,
+                                    cwd: runtimeCwd,
+                                    projectDir: display.cwd,
+                                    sessionId: sessionId ?? statusLineSessionId.current,
+                                    sessionName,
+                                    ...(runtimeDisplay.model === undefined
+                                        ? {}
+                                        : { model: runtimeDisplay.model }),
+                                    version: runtimeDisplay.version,
+                                    outputStyle: runtimeSettings.outputStyle,
+                                    permissionMode: runtimePreferences.permissionMode,
+                                    additionalDirectories: runtimePreferences.additionalDirectories,
+                                    ...(usage === undefined ? {} : { usage }),
+                                    ...(costUsd === undefined ? {} : { costUsd }),
+                                    ...(runtimeDisplay.contextWindowTokens === undefined
+                                        ? {}
+                                        : {
+                                            contextWindowTokens: runtimeDisplay.contextWindowTokens,
+                                        }),
+                                    ...(runtimeSettings.editor === 'vim'
+                                        ? { vimMode: vimInsertMode ? 'INSERT' : 'NORMAL' }
+                                        : {}),
+                                }), refreshKey: [
+                                    history.length,
+                                    runtimePreferences.permissionMode,
+                                    runtimeDisplay.model,
+                                    runtimeSettings.outputStyle,
+                                    vimInsertMode,
+                                    sessionName,
+                                    usage?.inputTokens,
+                                    usage?.outputTokens,
+                                ].join(':'), ...(settingSources === undefined ? {} : { settingSources }) })] }))] })) }) }));
 }
 export async function runInteractive(options) {
     const controller = new AbortController();
@@ -5352,7 +5542,9 @@ export async function runInteractive(options) {
         let cleanup = null;
         let backgrounded;
         rendererChange = null;
-        const instance = render(_jsx(InteractiveApp, { factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, runtimeSettings: currentRuntimeSettings, initialThemeSettings: initialThemeSettings, ...(initialThemeLoadError === undefined
+        const instance = render(_jsx(InteractiveApp, { factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, runtimeSettings: currentRuntimeSettings, ...(options.settingSources === undefined
+                ? {}
+                : { settingSources: options.settingSources }), initialThemeSettings: initialThemeSettings, ...(initialThemeLoadError === undefined
                 ? {}
                 : { initialThemeLoadError }), ...(currentInitialPrompt === undefined
                 ? {}

package/dist/cli/tui/claude-command-inventory.d.ts

@@ -1,4 +1,4 @@
-export type ClaudeCommandDisposition = 'included' | 'excluded';
+export type ClaudeCommandDisposition = 'included' | 'deferred' | 'excluded';
 export type ClaudeCommandVisibility = 'visible' | 'hidden' | 'conditional';
 export interface ClaudeCommandInventoryEntry {
     name: string;
@@ -12,8 +12,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "advisor";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "Conditional advice mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "agents";
     readonly disposition: "included";
@@ -28,17 +29,18 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "chrome";
-    readonly disposition: "excluded";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "Chrome integration is outside the CLI-only product boundary.";
+    readonly reason: "The CLI-driven Chrome integration is required parity work and is not implemented yet.";
 }, {
     readonly name: "clear";
     readonly disposition: "included";
     readonly visibility: "visible";
 }, {
     readonly name: "color";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "visible";
+    readonly reason: "The dedicated /color contract is required; /theme is not a substitute.";
 }, {
     readonly name: "compact";
     readonly disposition: "included";
@@ -62,16 +64,18 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "cost";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "The dedicated /cost contract is required; /status is not a substitute.";
 }, {
     readonly name: "diff";
     readonly disposition: "included";
     readonly visibility: "visible";
 }, {
     readonly name: "doctor";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "Interactive /doctor is required; the top-level command is not a substitute.";
 }, {
     readonly name: "effort";
     readonly disposition: "included";
@@ -82,8 +86,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "fast";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "The /fast state flow is required; model and effort controls are not a substitute.";
 }, {
     readonly name: "files";
     readonly disposition: "excluded";
@@ -91,8 +96,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly reason: "The source command is restricted to the internal Ant user type.";
 }, {
     readonly name: "heapdump";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "hidden";
+    readonly reason: "The hidden heap-diagnostic contract is required parity work and is not implemented yet.";
 }, {
     readonly name: "help";
     readonly disposition: "included";
@@ -181,8 +187,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "stats";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "visible";
+    readonly reason: "Historical usage statistics are required parity work and are not implemented yet.";
 }, {
     readonly name: "status";
     readonly disposition: "included";
@@ -253,8 +260,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly reason: "The source command is the Claude subscription plan-usage panel.";
 }, {
     readonly name: "insights";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "visible";
+    readonly reason: "Retrospective insights are required parity work and are not implemented yet.";
 }, {
     readonly name: "vim";
     readonly disposition: "included";
@@ -270,20 +278,24 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "buddy";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "proactive";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "brief";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "assistant";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
 }, {
     readonly name: "remote-control";
     readonly disposition: "excluded";
@@ -296,16 +308,19 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly reason: "Remote Control is outside the local-only boundary.";
 }, {
     readonly name: "voice";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "Conditional voice input is required parity work and is not implemented yet.";
 }, {
     readonly name: "think-back";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "The conditional retrospective flow is required parity work and is not implemented yet.";
 }, {
     readonly name: "thinkback-play";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "hidden";
+    readonly reason: "The hidden retrospective playback flow is required parity work and is not implemented yet.";
 }, {
     readonly name: "permissions";
     readonly disposition: "included";
@@ -361,8 +376,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "torch";
-    readonly disposition: "included";
+    readonly disposition: "deferred";
     readonly visibility: "conditional";
+    readonly reason: "This source-gated behavior is required conditional parity work and is not implemented yet.";
 }];
 export declare const CLAUDE_2_1_208_COMMAND_BY_NAME: ReadonlyMap<string, ClaudeCommandInventoryEntry>;
 //# sourceMappingURL=claude-command-inventory.d.ts.map