praxis-agent 0.44.0 → 0.45.0

package/README.md

@@ -101,7 +101,8 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
 ## What Praxis provides
 
 - **Local agent runtime** — C+ Quiet Operator responsive TUI with a linear
-  `you>`/`praxis>` conversation, compact stable tool rows, responsive density,
+  `❯` user / `⏺` assistant conversation, `✻` thinking activity, and `!` shell
+  composer grammar, compact stable tool rows, responsive density,
   terminal-native background, and a minimal composer/status row. Interactive
   surfaces share the same presentation across terminals, with English
   permission/configuration choices and a taught `❯` / Up/Down / Enter / Esc
@@ -139,8 +140,9 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   provider-free `/terminal-setup` diagnostics and repeatable Shift+Enter setup
   for supported local terminals,
   `Ctrl+V` text/image clipboard paste, `Ctrl+Z` shell suspension and `fg`
-  recovery, permission-gated `!` shell turns, navigable current/per-turn Git
-  diff views, semantic plan/question decision panels with complete
+  recovery, permission-gated provider-free `!` shell turns that persist shell
+  input/output for later ordinary prompts without creating an assistant turn,
+  navigable current/per-turn Git diff views, semantic plan/question decision panels with complete
   screen-reader actions, semantic screen projection across selectable surfaces,
   deterministic resize-aware URL/form elicitation rendering, and measured
   context budgets; print mode,
@@ -210,6 +212,22 @@ Detailed feature status and executable evidence live in the
 [parity matrix](https://github.com/Forest-Isle/Praxis/blob/main/docs/PARITY_MATRIX.md),
 not in this entry-point README.
 
+## Native data plane
+
+Praxis defaults to an independent local native data plane:
+
+```text
+Praxis ─── ~/.praxis (or PRAXIS_HOME)
+```
+
+All sessions, memory, tasks, scheduled tasks, resources, and private state live
+under `~/.praxis` (or `PRAXIS_HOME`). The authoritative transcript is
+append-only `praxis.transcript` v1 JSONL; legacy Claude transcripts, indexes,
+sidechains, and migration/recovery paths have been removed. `CLAUDE_CONFIG_DIR`
+does not participate in native runs, and legacy directories are neither read
+nor written. Claude-shaped messages and tool fields describe protocol shape
+only; they do not change Praxis data ownership.
+
 ## Documentation
 
 | Need                                       | Document                                                                                         |

package/dist/application/session-service.js

@@ -2592,7 +2592,9 @@ export class ClaudeSessionService {
                     });
                 }
                 const initialPricing = this.options.pricing?.resolve(provider.model ?? 'praxis/provider');
-                if (this.options.maxBudgetUsd !== undefined && !initialPricing) {
+                if (shellCommand === undefined &&
+                    this.options.maxBudgetUsd !== undefined &&
+                    !initialPricing) {
                     throw new Error(`Cannot enforce --max-budget-usd: no pricing is configured for model ${provider.model ?? 'praxis/provider'}`);
                 }
                 const shellInputUuid = shellCommand === undefined ? null : randomUUID();
@@ -3699,7 +3701,9 @@ export class ClaudeSessionService {
                             };
                         },
                     });
-                    await contextEngine.prepare(contextTransitionPort(pendingUserMessages), signal);
+                    if (shellCommand === undefined) {
+                        await contextEngine.prepare(contextTransitionPort(pendingUserMessages), signal);
+                    }
                     for (const [index, message] of expandedMessages.entries()) {
                         if (shellCommand !== undefined)
                             break;
@@ -3783,6 +3787,9 @@ export class ClaudeSessionService {
                     }
                     let shellUsage = { inputTokens: 0, outputTokens: 0 };
                     let shellModelUsage;
+                    let shellDurationApiMs;
+                    let shellDurationApiWithoutRetriesMs;
+                    let shellToolDurationMs;
                     if (shellCommand !== undefined) {
                         const call = {
                             id: `shell_${randomUUID().replaceAll('-', '')}`,
@@ -3822,6 +3829,10 @@ export class ClaudeSessionService {
                             throw error;
                         }
                         shellUsage = shellResult.usage ?? shellUsage;
+                        shellDurationApiMs = shellResult.durationApiMs;
+                        shellDurationApiWithoutRetriesMs =
+                            shellResult.durationApiWithoutRetriesMs;
+                        shellToolDurationMs = shellResult.durationToolMs;
                         if (!shellResult.isError) {
                             shellModelUsage = shellResult.modelUsage;
                             foregroundLineChanges.add(shellResult);
@@ -3872,7 +3883,74 @@ export class ClaudeSessionService {
                             isError: shellResult.isError,
                         });
                     }
-                    if (budget) {
+                    if (shellCommand !== undefined) {
+                        const tracker = this.sessionCostTrackers.get(sessionId);
+                        if (!tracker) {
+                            throw new Error(`Session cost tracker is not active for session ${sessionId}`);
+                        }
+                        const totalUsage = mergeUsage(recoveryUsage, shellUsage);
+                        const turnModelUsage = mergeSessionRawModelUsage(recoveryModelUsage, shellModelUsage);
+                        let rawCostUsd;
+                        if (turnModelUsage) {
+                            for (const [model, usage] of Object.entries(turnModelUsage)) {
+                                const pricing = this.options.pricing?.resolve(model);
+                                const costUsd = pricing
+                                    ? usageCostUsd(usage, pricing)
+                                    : undefined;
+                                if (costUsd !== undefined)
+                                    rawCostUsd = (rawCostUsd ?? 0) + costUsd;
+                                tracker.recordTurn({
+                                    model,
+                                    usage,
+                                    ...(costUsd === undefined ? {} : { costUsd }),
+                                    ...(usage.webSearchRequests === undefined
+                                        ? {}
+                                        : { webSearchRequests: usage.webSearchRequests }),
+                                });
+                            }
+                        }
+                        let combinedToolDurationMs = 0;
+                        for (const recoveryResult of recoveryResults) {
+                            combinedToolDurationMs = addToolDuration(recoveryResult.durationToolMs, combinedToolDurationMs);
+                        }
+                        combinedToolDurationMs = addToolDuration(shellToolDurationMs, combinedToolDurationMs);
+                        tracker.recordDurations({
+                            ...(shellDurationApiMs === undefined
+                                ? {}
+                                : { apiDurationMs: shellDurationApiMs }),
+                            ...(shellDurationApiWithoutRetriesMs === undefined
+                                ? {}
+                                : {
+                                    apiDurationWithoutRetriesMs: shellDurationApiWithoutRetriesMs,
+                                }),
+                            ...(combinedToolDurationMs === 0
+                                ? {}
+                                : { toolDurationMs: combinedToolDurationMs }),
+                        });
+                        if (foregroundLineChanges.linesAdded !== 0 ||
+                            foregroundLineChanges.linesRemoved !== 0) {
+                            tracker.recordLineChanges({
+                                ...(foregroundLineChanges.linesAdded === 0
+                                    ? {}
+                                    : { linesAdded: foregroundLineChanges.linesAdded }),
+                                ...(foregroundLineChanges.linesRemoved === 0
+                                    ? {}
+                                    : { linesRemoved: foregroundLineChanges.linesRemoved }),
+                            });
+                        }
+                        turnCompleted = true;
+                        return {
+                            sessionId,
+                            text: '',
+                            usage: totalUsage,
+                            ...(rawCostUsd === undefined ? {} : { costUsd: rawCostUsd }),
+                            ...(turnModelUsage ? { modelUsage: { ...turnModelUsage } } : {}),
+                            ...(shellDurationApiMs === undefined
+                                ? {}
+                                : { durationApiMs: shellDurationApiMs }),
+                        };
+                    }
+                    if (shellCommand === undefined && budget) {
                         await contextEngine.prepare(contextTransitionPort([], currentTurnUserMessages ?? []), signal);
                         budget.assertFits(budget.evaluate([
                             ...contextMessages,
@@ -3911,7 +3989,9 @@ export class ClaudeSessionService {
                                 ];
                             }
                             await refreshRuntimeContext?.();
-                            await contextEngine.prepare(contextTransitionPort([], currentTurnUserMessages ?? []), signal);
+                            if (shellCommand === undefined) {
+                                await contextEngine.prepare(contextTransitionPort([], currentTurnUserMessages ?? []), signal);
+                            }
                             runtimeRequest.stableSystemMessageCount = stableSystemMessageCount;
                             return [
                                 ...contextMessages,

package/dist/cli/interactive.js

@@ -3240,7 +3240,9 @@ export function InteractiveApp({ dataPlane = resolveDataPlane(), configRoot: sup
             streamingFrameRef.current?.resetText();
             streamingFrameRef.current?.resetThinking();
             streamingFrameRef.current?.flush();
-            append({ kind: 'assistant', text: result.text });
+            if (shellCommand === undefined) {
+                append({ kind: 'assistant', text: result.text });
+            }
             if (turnMutatedFilesRef.current) {
                 try {
                     const snapshot = await loadDiffSnapshot();

package/dist/cli/tui/quiet-frame.js

@@ -272,18 +272,18 @@ export function projectQuietFrame(input) {
                 : cleanActiveTail(body.transcript.active.text, viewportRows === undefined ? 200 : Math.max(1, viewportRows - 2));
             const activeText = activeTail.lines;
             if (activeText.some(({ text }) => Boolean(text)))
-                activeText.forEach(({ text: part, start }, index) => lines.push(createQuietFrameRow(`quiet:active:text:${start}`, `${index === 0 ? 'praxis> ' : '        '}${index === 0 && activeTail.hidden ? '… ' : ''}${part}`, 'active', 'body', `${index === 0 ? 'Praxis: ' : ''}${part}`)));
+                activeText.forEach(({ text: part, start }, index) => lines.push(createQuietFrameRow(`quiet:active:text:${start}`, `${index === 0 ? '⏺ ' : '        '}${index === 0 && activeTail.hidden ? '… ' : ''}${part}`, 'active', 'body', `${index === 0 ? 'Praxis: ' : ''}${part}`)));
             const thinking = screenReader
                 ? cleanActiveTail(body.transcript.active.thinking, Number.POSITIVE_INFINITY)
                 : cleanActiveTail(body.transcript.active.thinking, viewportRows === undefined ? 200 : Math.max(1, viewportRows - 2));
             if (thinking.lines.some(({ text }) => Boolean(text)))
-                thinking.lines.forEach(({ text: part, start }, index) => lines.push(createQuietFrameRow(`quiet:active:thinking:${start}`, `${index === 0 ? '… ' : '  '}${part}`, 'active', 'muted', `${index === 0 ? 'Thinking: ' : ''}${part}`)));
+                thinking.lines.forEach(({ text: part, start }, index) => lines.push(createQuietFrameRow(`quiet:active:thinking:${start}`, `${index === 0 ? '✻ ' : '  '}${part}`, 'active', 'muted', `${index === 0 ? 'Thinking: ' : ''}${part}`)));
         }
     }
     const focus = input.focusRows.length > 0
         ? input.focusRows.map((item) => withRegion(item, 'focus'))
         : [
-            createQuietFrameRow('quiet:composer', `${input.shellMode ? 'shell>' : 'you>'} ${clean(input.composerText)}`, 'composer', 'input', `${input.shellMode ? 'Shell' : 'Composer'} input field`),
+            createQuietFrameRow('quiet:composer', `${input.shellMode ? '! ' : '❯ '}${clean(input.composerText)}`, 'composer', 'input', `${input.shellMode ? 'Shell' : 'Composer'} input field`),
         ];
     lines.push(...focus);
     const statusText = `${input.busy ? 'Working · ' : ''}${clean(input.status) || (input.busy ? 'In progress' : 'Ready')}`;
@@ -302,7 +302,7 @@ export function projectQuietFrame(input) {
         const compact = [...retained, ...focusRows, status];
         lines.splice(0, lines.length, ...compact);
     }
-    const composerPrefix = `${input.shellMode ? 'shell>' : 'you>'} `;
+    const composerPrefix = input.shellMode ? '! ' : '❯ ';
     if (!screenReader) {
         for (let index = 0; index < lines.length; index += 1) {
             const row = lines[index];

package/dist/cli/tui/transcript-viewport.js

@@ -497,7 +497,7 @@ function estimateRenderedTranscriptEntryLines(entry, width, mode) {
         if (item.kind === 'user')
             return (1 +
                 (mode === 'screen-reader' ? 1 : 0) +
-                wrappedLineCount(`${mode === 'screen-reader' ? 'You: ' : 'you> '}${item.text}`, width));
+                wrappedLineCount(`${mode === 'screen-reader' ? 'You: ' : '❯ '}${item.text}`, width));
         if (item.kind === 'assistant')
             return (1 +
                 (mode === 'screen-reader' ? 1 : 0) +
@@ -667,7 +667,7 @@ function entryViewportRows(entry, width, mode) {
             return [
                 '',
                 ...(mode === 'screen-reader' ? [''] : []),
-                ...textVisualRows(`${mode === 'screen-reader' ? 'You: ' : 'you> '}${item.text}`, width),
+                ...textVisualRows(`${mode === 'screen-reader' ? 'You: ' : '❯ '}${item.text}`, width),
             ];
         if (item.kind === 'assistant')
             return [
@@ -818,7 +818,7 @@ function assistantMarkdownProjectionRows(text, width, mode) {
         fenceAfter: false,
         fenceLabel: 'code',
     };
-    const prefixed = textVisualRows(`praxis> ${first.text.trimEnd()}`, width).map((rowText) => ({ ...first, text: rowText }));
+    const prefixed = textVisualRows(`⏺ ${first.text.trimEnd()}`, width).map((rowText) => ({ ...first, text: rowText }));
     return [...prefixed, ...rows.slice(1)];
 }
 export function createTranscriptEntryViewportIndex(entry, width, mode) {

package/package.json

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