praxis-agent 0.20.14 → 0.20.16

package/dist/cli/interactive.js

@@ -5626,7 +5626,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         }
         editComposer();
     });
-    return (_jsx(TuiThemeProvider, { settings: themeSettings, children: _jsx(Box, { flexDirection: "column", children: selectingSession ? (_jsx(SessionPicker, { sessions: filteredPickerChoices, selectedIndex: selectedIndex, screenReader: axScreenReader, query: sessionSearch })) : (_jsxs(_Fragment, { children: [!axScreenReader && history.length === 0 && !sessionId ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width })) : null, sessionId ? (_jsxs(Text, { dimColor: true, children: ["Session ", sessionId.slice(0, 8)] })) : null, _jsx(Transcript, { items: history, activeText: activeText, activeThinking: activeThinking, thinkingExpanded: thinkingExpanded, detailedTranscript: thinkingExpanded || runtimeSettings.verbose, screenReader: axScreenReader }), externalEditorRequest !== null ||
+    return (_jsx(TuiThemeProvider, { settings: themeSettings, children: _jsx(Box, { flexDirection: "column", children: selectingSession ? (_jsx(SessionPicker, { sessions: filteredPickerChoices, selectedIndex: selectedIndex, screenReader: axScreenReader, query: sessionSearch })) : (_jsxs(_Fragment, { children: [!axScreenReader && history.length === 0 && !sessionId ? (_jsx(WelcomePanel, { display: runtimeDisplay, width: width, showTips: runtimeSettings.tips })) : null, sessionId ? (_jsxs(Text, { dimColor: true, children: ["Session ", sessionId.slice(0, 8)] })) : null, _jsx(Transcript, { items: history, activeText: activeText, activeThinking: activeThinking, thinkingExpanded: thinkingExpanded, detailedTranscript: thinkingExpanded || runtimeSettings.verbose, screenReader: axScreenReader }), externalEditorRequest !== null ||
                         keybindingsEditing ||
                         memoryEditorRequest !== null ? (_jsx(ExternalEditorWait, { screenReader: axScreenReader })) : permission ? (permission.kind === 'tool' && toolPermissionModel ? (_jsx(ToolPermissionDialog, { model: toolPermissionModel, selection: permissionSelection, feedbackMode: permissionFeedbackMode, feedback: input, ruleEditor: permissionRuleEditor, screenReader: axScreenReader })) : (_jsxs(DialogFrame, { title: `Retry interrupted ${permission.call.name}?`, screenReader: axScreenReader, children: [_jsx(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: _jsx(Text, { bold: true, children: describeTool(permission.call, sensitiveValues) }) }), _jsx(Text, { children: "Do you want to proceed?" }), _jsxs(Text, { inverse: !axScreenReader && permissionSelection === 0, children: [selectionPrefix(permissionSelection === 0, axScreenReader), "1. Yes"] }), _jsxs(Text, { inverse: !axScreenReader && permissionSelection === 1, children: [selectionPrefix(permissionSelection === 1, axScreenReader), "2. No"] }), permissionFeedbackMode ? (_jsxs(Text, { children: ["\u203A", ' ', input ||
                                         (permissionSelection === 0

package/dist/cli/tui/claude-style.d.ts

@@ -71,10 +71,11 @@ export interface TuiBtwEntry {
     error?: string;
 }
 export declare function useTerminalWidth(override?: number): number;
-export declare function WelcomePanel({ display, width, }: {
+export declare function WelcomePanel({ display, width, showTips, }: {
     display: TuiDisplayMetadata;
     width: number;
-}): import("react").JSX.Element;
+    showTips: boolean;
+}): import("react").JSX.Element | null;
 export declare function MarkdownText({ text }: {
     text: string;
 }): ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;

package/dist/cli/tui/claude-style.js

@@ -49,17 +49,23 @@ function selectionPrefix(selected, screenReader) {
         return screenReader ? 'Selected: ' : '  ❯ ';
     return screenReader ? '' : '    ';
 }
-export function WelcomePanel({ display, width, }) {
+export function WelcomePanel({ display, width, showTips, }) {
     const palette = useTuiPalette();
+    if (!showTips)
+        return null;
     const panelWidth = Math.min(100, Math.max(32, width));
     const wide = panelWidth >= 68;
     const brand = 'Praxis';
-    // Claude 2.1.208 embeds the title in the top border row:
-    //   ╭───Claude Code v2.1.208 ───...───╮
-    // Title block = "╭" + "───" + "Praxis Code vX.Y.Z" + " " = 4 + title.length + 1 chars.
-    const title = `${brand} Code v${display.version}`;
-    const fill = Math.max(1, panelWidth - title.length - 6);
-    return (_jsxs(Box, { flexDirection: "column", width: panelWidth, children: [_jsxs(Text, { color: palette.muted, children: ['╭───', _jsx(Text, { color: palette.brand, bold: true, children: brand }), ` Code v${display.version} `, _jsx(Text, { dimColor: true, children: '─'.repeat(fill) }), '╮'] }), _jsx(Box, { borderStyle: "round", borderColor: palette.muted, borderTop: false, flexDirection: "column", width: panelWidth, paddingX: 1, children: _jsxs(Box, { flexDirection: wide ? 'row' : 'column', children: [_jsxs(Box, { alignItems: wide ? 'center' : undefined, flexDirection: "column", width: wide ? '50%' : '100%', children: [_jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Welcome back!" }), _jsx(Text, { children: " " }), _jsx(Text, { color: palette.brand, bold: true, children: "\u2590\u259B\u2588\u2588\u2588\u259C\u258C" }), _jsx(Text, { color: palette.brand, children: "\u259D\u259C\u2588\u2588\u2588\u2588\u2588\u259B\u2598" }), _jsx(Text, { color: palette.brand, children: " \u2598\u2598 \u259D\u259D" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [display.model ?? 'provider default', display.effort ? (_jsxs(Text, { dimColor: true, children: [" \u00B7 ", display.effort, " effort"] })) : null] }), _jsx(Text, { dimColor: true, children: compactPath(display.cwd) })] }), _jsxs(Box, { flexDirection: "column", width: wide ? '50%' : '100%', marginTop: wide ? 0 : 1, children: [_jsx(Text, { bold: true, children: "Tips for getting started" }), _jsx(Text, { children: "Run /init to create a CLAUDE.md file with instructions for Claude" }), _jsx(Text, { dimColor: true, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }), _jsx(Text, { bold: true, children: "What's new" }), _jsx(Text, { children: 'Subagent forking is now on by default: a `subagent_type: "fork"` subagent inherits the full conversation and prompt cache, and non-teammate agent spawns in interactive sessions now run in the background by default' }), _jsx(Text, { children: 'Type `@` in the prompt to mention another Claude session by name; Claude then uses `SendMessage` to reach that session directly' }), _jsx(Text, { children: '`SendMessage` now delivers to a bare name that exactly matches one live session, instead of asking to confirm with a ref first' }), _jsx(Text, { dimColor: true, children: "/release-notes for more" })] })] }) })] }));
+    const model = display.model ?? 'provider default';
+    const effort = display.effort ? ` · ${display.effort} effort` : '';
+    const cwd = compactPath(display.cwd);
+    // Title lives in the top border row:
+    //   ╭───Praxis Code vX.Y.Z ───...───╮
+    // Fixed prefix/suffix = "╭───"(4) + "Praxis"(6) + " Code vX.Y.Z "(8 + version)
+    // + "╮"(1), so the fill keeps the row exactly at panelWidth.
+    const fill = Math.max(1, panelWidth - display.version.length - 19);
+    const identity = `Welcome to ${brand} · ${model}${effort} · ${cwd}`;
+    return (_jsxs(Box, { flexDirection: "column", width: panelWidth, children: [_jsxs(Text, { color: palette.muted, children: ['╭───', _jsx(Text, { color: palette.brand, bold: true, children: brand }), ` Code v${display.version} `, _jsx(Text, { dimColor: true, children: '─'.repeat(fill) }), '╮'] }), wide ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: identity }), _jsx(Text, { children: "/init to create CLAUDE.md \u00B7 /config to open settings" })] })) : (_jsxs(_Fragment, { children: [_jsxs(Text, { children: ["Welcome to ", brand] }), _jsxs(Text, { children: [model, effort] }), _jsx(Text, { children: cwd }), _jsx(Text, { children: "/init to create CLAUDE.md" }), _jsx(Text, { children: "/config to open settings" })] }))] }));
 }
 const INLINE_SEGMENT_CACHE_MAX = 4096;
 const inlineSegmentCache = new Map();

package/dist/cli-runtime.d.ts

@@ -7,6 +7,7 @@ import { type ModelDocument, type ModelImage, type ModelProvider, type ModelTool
 import type { InteractiveResumeOptions, InteractiveServiceFactory } from './cli/interactive.js';
 import type { TuiSlashCommand } from './cli/tui/slash-commands.js';
 import { type TuiHookConfiguration } from './cli/tui/hook-settings.js';
+import { type PraxisRuntimeSettings } from './cli/tui/runtime-settings.js';
 import { type ClaudePermissionMode } from './permissions/claude-permission-resolver.js';
 import { type ClaudeMcpServerStatus, type ClaudeMcpToolInspection } from './mcp/claude-mcp-tools.js';
 import { authenticateMcpServer } from './mcp/claude-mcp-oauth.js';
@@ -164,6 +165,14 @@ export interface CliDependencies extends InteractiveServiceFactory {
         force?: boolean;
     }) => Promise<SelfUpdateResult>;
 }
+/**
+ * Shared runtime model precedence used by every consumer (provider
+ * construction, status/doctor output, and the interactive display):
+ * explicit CLI selection > non-empty PRAXIS_MODEL > Praxis settings model,
+ * with the configured default (settings.model === 'default') falling through
+ * to the existing default behavior (undefined).
+ */
+export declare function resolveRuntimeModel(explicitModel: string | undefined, environment: NodeJS.ProcessEnv, settings: PraxisRuntimeSettings | undefined): string | undefined;
 export declare function createDefaultDependencies(entrypoint?: string): CliDependencies;
 export declare function createBackgroundWorkerRuntime(workerSink: RuntimeEventSink, dispatch: {
     argv: string[];

package/dist/cli-runtime.js

@@ -695,6 +695,20 @@ const consoleIO = {
     isTTY: Boolean(process.stdin.isTTY && process.stdout.isTTY),
     readStdinLines: () => process.stdin,
 };
+/**
+ * Shared runtime model precedence used by every consumer (provider
+ * construction, status/doctor output, and the interactive display):
+ * explicit CLI selection > non-empty PRAXIS_MODEL > Praxis settings model,
+ * with the configured default (settings.model === 'default') falling through
+ * to the existing default behavior (undefined).
+ */
+export function resolveRuntimeModel(explicitModel, environment, settings) {
+    const envModel = environment.PRAXIS_MODEL;
+    const settingsModel = settings && settings.model !== 'default' ? settings.model : undefined;
+    return (explicitModel ??
+        (envModel !== undefined && envModel.trim() !== '' ? envModel : undefined) ??
+        settingsModel);
+}
 const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = false, approveRecovery, approveTool, agent, model: interactiveModel, effort: interactiveEffort, permissionMode: interactivePermissionMode, isSessionActionApproved, controls = DEFAULT_CLI_CONTROLS, interactive = false, sessionKind, signal, exposeToolRegistry = false, onElicitation, askUser, approvePlan, emitToolUseSummaries = false, cwd: requestedCwd, sandboxOriginalCwd, configRoot: requestedConfigRoot, environment, providerEnvironment: requestedProviderEnvironment, }) => {
     const runtimeEnvironment = requestedProviderEnvironment ?? process.env;
     const sandboxEnvironment = { ...runtimeEnvironment, ...environment };
@@ -740,7 +754,7 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
     let providerForMainModel;
     const context = parseContextEnvironment(runtimeEnvironment);
     const apiKey = runtimeEnvironment.PRAXIS_API_KEY;
-    const model = cli.model ?? runtimeEnvironment.PRAXIS_MODEL;
+    const model = resolveRuntimeModel(interactiveModel ?? controls.model, runtimeEnvironment, runtimeSettings);
     const providerEnvironment = apiKey && model
         ? parseProviderEnvironment(runtimeEnvironment)
         : cli.fileResources.length > 0
@@ -1300,7 +1314,9 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
         ];
         const runtimeInfo = {
             cwd: workspace.cwd(),
-            model: provider?.model ?? runtimeEnvironment.PRAXIS_MODEL ?? 'unknown',
+            model: provider?.model ??
+                resolveRuntimeModel(interactiveModel ?? controls.model, runtimeEnvironment, runtimeSettings) ??
+                'unknown',
             ...(provider?.capabilities.contextWindowTokens === undefined
                 ? {}
                 : { contextWindowTokens: provider.capabilities.contextWindowTokens }),
@@ -1457,7 +1473,7 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
                     cwd: workspace.cwd(),
                     model: service.model() ??
                         provider?.model ??
-                        runtimeEnvironment.PRAXIS_MODEL ??
+                        resolveRuntimeModel(interactiveModel ?? controls.model, runtimeEnvironment, runtimeSettings) ??
                         'unknown',
                 };
                 delete staticInfo.contextWindowTokens;
@@ -1498,7 +1514,12 @@ const createDefaultService = async ({ eventSink, requireProvider, hooksOnly = fa
 };
 const createDefaultAutoModeCritic = async ({ model }) => {
     const apiKey = process.env.PRAXIS_API_KEY;
-    const selectedModel = model ?? process.env.PRAXIS_MODEL;
+    const configRoot = resolve(process.env.CLAUDE_CONFIG_DIR ?? resolve(homedir(), '.claude'));
+    const runtimeSettings = await loadRuntimeSettings({
+        configRoot,
+        statePath: join(configRoot, '.claude.json'),
+    });
+    const selectedModel = resolveRuntimeModel(model, process.env, runtimeSettings);
     if (!apiKey || !selectedModel) {
         throw new Error('PRAXIS_API_KEY and a model (--model or PRAXIS_MODEL) are required');
     }
@@ -1657,6 +1678,18 @@ export function createDefaultDependencies(entrypoint = fileURLToPath(import.meta
             const { runInteractive } = await import('./cli/interactive.js');
             const interactiveControls = controls ?? DEFAULT_CLI_CONTROLS;
             const initialAdditionalDirectories = interactiveControls.addDirectories.map((directory) => realpathSync(resolve(process.cwd(), directory)));
+            const configuredRoot = process.env.CLAUDE_CONFIG_DIR || undefined;
+            const interactiveConfigRoot = resolve(configuredRoot ?? resolve(homedir(), '.claude'));
+            const interactiveStatePath = configuredRoot
+                ? join(interactiveConfigRoot, '.claude.json')
+                : resolve(homedir(), '.claude.json');
+            const interactiveRuntimeSettings = interactiveControls.safeMode || interactiveControls.bare
+                ? undefined
+                : await loadRuntimeSettings({
+                    configRoot: interactiveConfigRoot,
+                    statePath: interactiveStatePath,
+                });
+            const effectiveModel = resolveRuntimeModel(interactiveControls.model, process.env, interactiveRuntimeSettings);
             return runInteractive({
                 factory: {
                     createService: ({ additionalDirectories, cwd, ...options }) => createDefaultService({
@@ -1670,8 +1703,7 @@ export function createDefaultDependencies(entrypoint = fileURLToPath(import.meta
                         },
                         interactive: true,
                     }),
-                    scheduledPrompts: Boolean(process.env.PRAXIS_API_KEY &&
-                        (interactiveControls.model ?? process.env.PRAXIS_MODEL)),
+                    scheduledPrompts: Boolean(process.env.PRAXIS_API_KEY && effectiveModel),
                 },
                 ...(signal ? { signal } : {}),
                 ...(initialPrompt === undefined ? {} : { initialPrompt }),
@@ -1686,11 +1718,7 @@ export function createDefaultDependencies(entrypoint = fileURLToPath(import.meta
                 display: {
                     version: VERSION,
                     cwd: process.cwd(),
-                    ...(controls?.model
-                        ? { model: controls.model }
-                        : process.env.PRAXIS_MODEL
-                            ? { model: process.env.PRAXIS_MODEL }
-                            : {}),
+                    ...(effectiveModel === undefined ? {} : { model: effectiveModel }),
                     effort: controls?.effort ?? 'high',
                     permissionMode: controls?.dangerouslySkipPermissions
                         ? 'bypassPermissions'
@@ -2090,6 +2118,7 @@ async function executeDoctorCommand(args, invocation, io) {
         configRoot,
         statePath: claudeStatePath,
     });
+    const effectiveModel = resolveRuntimeModel(invocation.model, process.env, runtimeSettings);
     const report = await runDoctor({
         version: VERSION,
         executablePath: fileURLToPath(import.meta.url),
@@ -2098,7 +2127,9 @@ async function executeDoctorCommand(args, invocation, io) {
         configRoot,
         claudeStatePath,
         cwd: process.cwd(),
-        environment: process.env,
+        environment: effectiveModel === undefined
+            ? process.env
+            : { ...process.env, PRAXIS_MODEL: effectiveModel },
         autoUpdateChannel: runtimeSettings.autoUpdatesChannel,
         ...(process.argv[1] === undefined
             ? {}
@@ -4053,6 +4084,10 @@ async function execute(argv, io, dependencies, signal) {
         const startedAt = Date.now();
         const sessionId = invocation.sessionId ?? randomUUID();
         const configRoot = resolve(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), '.claude'));
+        const runtimeSettings = await loadRuntimeSettings({
+            configRoot,
+            statePath: join(configRoot, '.claude.json'),
+        });
         const text = dependencies.loadReleaseNotes
             ? await dependencies.loadReleaseNotes(configRoot)
             : await loadClaudeReleaseNotes({ configRoot });
@@ -4063,7 +4098,8 @@ async function execute(argv, io, dependencies, signal) {
         };
         const info = {
             cwd: process.cwd(),
-            model: invocation.model ?? process.env.PRAXIS_MODEL ?? 'unknown',
+            model: resolveRuntimeModel(invocation.model, process.env, runtimeSettings) ??
+                'unknown',
             tools: [],
             mcpServers: [],
             permissionMode: invocation.permissionMode,
@@ -4218,9 +4254,15 @@ async function execute(argv, io, dependencies, signal) {
                 io.stdout(transcript);
             return 0;
         }
+        const configRoot = resolve(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), '.claude'));
+        const runtimeSettings = await loadRuntimeSettings({
+            configRoot,
+            statePath: join(configRoot, '.claude.json'),
+        });
         const runtimeInfo = service.runtimeInfo?.() ?? {
             cwd: process.cwd(),
-            model: process.env.PRAXIS_MODEL ?? 'unknown',
+            model: resolveRuntimeModel(invocation.model, process.env, runtimeSettings) ??
+                'unknown',
             tools: [],
             mcpServers: [],
             permissionMode: 'default',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "praxis-agent",
-  "version": "0.20.14",
+  "version": "0.20.16",
   "description": "Local-first, single-user general agent for the command line.",
   "license": "MIT",
   "author": "wuqisen",