praxis-agent 0.15.0 → 0.16.1

package/README.md

@@ -15,10 +15,15 @@ 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.
+Claude Code 2.1.208 remains the architecture, design, and observable
+compatibility baseline for included and required single-user developer
+capabilities. Only entries classified `required` block developer-core
+closure; `deferred` entries are optional and demand-driven. Exclusions cover
+the existing enterprise, authentication, hosted, and client surfaces plus the
+explicitly classified subscription-bound integration, campaign, hidden
+maintainer diagnostic, and build-experimental commands. A similar Praxis
+surface is not a substitute for the corresponding Claude command or runtime
+contract.
 
 ## Requirements
 
@@ -95,7 +100,8 @@ troubleshooting. Run `praxis --help` for the authoritative command surface.
   tabs, `/sandbox` mode/dependency/override/config controls, local cached
   `/release-notes`, Claude-compatible `/statusline` command execution and setup
   agent, source-aligned `/init` project-instruction onboarding with its enhanced
-  skills/hooks flow, `/mcp`, `/memory` shared instruction and auto-memory
+  skills/hooks flow, provider-free per-session `/color` prompt-bar styling,
+  `/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,

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

@@ -1,3 +1,4 @@
+import { type AgentColorName, type AgentColorSelection } from '../compatibility/claude/agent-color.js';
 import type { ClaudeConditionalRuleResolver } from '../compatibility/claude/context.js';
 import { type ClaudeFileResource, type ClaudeFileResourceConfig } from '../compatibility/claude/file-resources.js';
 import { type ClaudeDisplayTranscriptItem } from '../compatibility/claude/projection.js';
@@ -182,6 +183,7 @@ export declare class ClaudeSessionService {
     sessionNameSuggestion(sessionId: string, signal?: AbortSignal): Promise<string | null>;
     sessions(): Promise<SessionSummary[]>;
     inspect(sessionId: string): Promise<SessionInspection>;
+    readEffectiveAgentColor(sessionId: string): Promise<AgentColorName | undefined>;
     export(sessionId: string): Promise<Buffer>;
     transcript(sessionId: string, resumeSessionAt?: string): Promise<ClaudeDisplayTranscriptItem[]>;
     rename(sessionId: string, name: string): Promise<void>;
@@ -190,6 +192,9 @@ export declare class ClaudeSessionService {
     approveRecentlyDenied(sessionId: string, display: string): Promise<void>;
     retryRecentlyDenied(sessionId: string, display: string, signal?: AbortSignal): Promise<SessionRunResult>;
     recordBtwUsage(sessionId: string | undefined, permissionMode?: ClaudePermissionMode): Promise<string>;
+    recordColorUsage(sessionId: string | undefined, selection: AgentColorSelection, display: string, permissionMode?: ClaudePermissionMode, options?: {
+        createSession?: boolean;
+    }): Promise<string>;
     recordBackgroundUsage(sessionId: string | undefined, permissionMode?: ClaudePermissionMode): Promise<string>;
     recordBackgroundLaunch(sessionId: string): Promise<SessionForkCheckpoint>;
     compact(sessionId: string, signal?: AbortSignal, selection?: ManualCompactSelection): Promise<ManualCompactResult>;
@@ -214,6 +219,7 @@ export declare class ClaudeSessionService {
     private restoreWorktree;
     private paths;
     private appendCdCommand;
+    private appendAgentColorUsage;
     private appendSystemLocalCommand;
     private ensureLocalSession;
     private appendInputHistory;

package/dist/application/session-service.js

@@ -2,6 +2,7 @@ import { randomUUID } from 'node:crypto';
 import { appendFile, copyFile, link, lstat, mkdir, readdir, realpath, stat, unlink, } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { basename, extname, isAbsolute, join, relative } from 'node:path';
+import { AGENT_COLOR_DEFAULT, agentColorMessage, getClaudeEffectiveAgentColor, } from '../compatibility/claude/agent-color.js';
 import { createClaudeCompactEntries, formatClaudeCompactSummary, getCumulativeDroppedTokens, } from '../compatibility/claude/compaction.js';
 import { isClaudeSessionId, resolveClaudePaths, resolveClaudeScheduledTaskFile, } from '../compatibility/claude/paths.js';
 import { downloadClaudeFileResources, } from '../compatibility/claude/file-resources.js';
@@ -696,6 +697,11 @@ export class ClaudeSessionService {
                 : {}),
         };
     }
+    async readEffectiveAgentColor(sessionId) {
+        this.assertSessionPersistence();
+        const recovery = await this.store(sessionId).loadReadOnly();
+        return getClaudeEffectiveAgentColor(recovery.entries, sessionId);
+    }
     async export(sessionId) {
         this.assertSessionPersistence();
         try {
@@ -934,6 +940,21 @@ export class ClaudeSessionService {
             await new Promise((resolve) => setTimeout(resolve, 25));
         }
     }
+    async recordColorUsage(sessionId, selection, display, permissionMode = 'default', options = {}) {
+        const output = agentColorMessage(selection);
+        const agentColor = selection.kind === 'color'
+            ? selection.color
+            : selection.kind === 'reset'
+                ? AGENT_COLOR_DEFAULT
+                : undefined;
+        const createLocalSession = sessionId === undefined || options.createSession === true;
+        const activeSessionId = await this.ensureLocalSession(sessionId, permissionMode, createLocalSession ? agentColor : undefined, options.createSession === true);
+        if (this.options.sessionPersistence !== false) {
+            await this.appendInputHistory(display, activeSessionId);
+        }
+        await this.appendAgentColorUsage(activeSessionId, display, output, createLocalSession ? undefined : agentColor);
+        return activeSessionId;
+    }
     async recordBackgroundUsage(sessionId, permissionMode = 'default') {
         this.assertWritable();
         const activeSessionId = await this.ensureLocalSession(sessionId, permissionMode);
@@ -2566,6 +2587,35 @@ export class ClaudeSessionService {
             throw new Error(`Claude local command conflict: ${result.reason}`);
         }
     }
+    async appendAgentColorUsage(sessionId, display, output, agentColor) {
+        const args = display.replace(/^\/color\s*/u, '').trim();
+        while (true) {
+            const result = await this.turnStore(sessionId).withLease(async (lease) => {
+                const snapshot = await lease.load();
+                if (snapshot.entries.length === 0) {
+                    throw new Error(`Claude session not found: ${sessionId}`);
+                }
+                const appended = await lease.appendMany(snapshot.tail, [
+                    ...(agentColor === undefined
+                        ? []
+                        : [
+                            {
+                                type: 'agent-color',
+                                agentColor,
+                                sessionId,
+                            },
+                        ]),
+                    ...this.localCommandEntries(sessionId, this.activeCwd(), this.logicalTailUuid(snapshot.tail), 'color', args, output),
+                ]);
+                if (appended.status === 'conflict') {
+                    throw new Error(`Claude color local command append conflict: ${appended.reason}`);
+                }
+            });
+            if (result.status === 'completed')
+                return;
+            await new Promise((resolve) => setTimeout(resolve, 25));
+        }
+    }
     async appendSystemLocalCommand(sessionId, command, args, output) {
         while (true) {
             const result = await this.turnStore(sessionId).withLease(async (lease) => {
@@ -2583,13 +2633,22 @@ export class ClaudeSessionService {
             await new Promise((resolve) => setTimeout(resolve, 25));
         }
     }
-    async ensureLocalSession(sessionId, permissionMode) {
-        if (sessionId)
+    async ensureLocalSession(sessionId, permissionMode, agentColor, createExplicit = false) {
+        if (sessionId !== undefined && !createExplicit)
             return sessionId;
         this.assertWritable();
-        const createdSessionId = randomUUID();
+        const createdSessionId = sessionId ?? randomUUID();
         const store = this.turnStore(createdSessionId);
         const created = await store.create([
+            ...(agentColor === undefined
+                ? []
+                : [
+                    {
+                        type: 'agent-color',
+                        agentColor,
+                        sessionId: createdSessionId,
+                    },
+                ]),
             { type: 'mode', mode: 'normal', sessionId: createdSessionId },
             {
                 type: 'permission-mode',

package/dist/cli/interactive.d.ts

@@ -8,6 +8,8 @@ import { type TuiMemoryFiles } from './tui/memory-files.js';
 import { type TuiDiffSnapshot } from './tui/git-diff.js';
 import { type TuiPermissionBehavior, type TuiPermissionRule } from './tui/permission-settings.js';
 import { type RecentlyDeniedStore } from './tui/recently-denied.js';
+import { type AgentColorSelection } from '../compatibility/claude/agent-color.js';
+import type { AgentColorName } from '../compatibility/claude/agent-color.js';
 import type { ClaudeResourceScope } from '../compatibility/claude/shared-resources.js';
 import type { TuiHookConfiguration } from './tui/hook-settings.js';
 import { type TuiSlashCommand } from './tui/slash-commands.js';
@@ -41,6 +43,8 @@ interface InteractiveSessionCommands {
     retryRecentlyDenied?(sessionId: string, display: string, signal?: AbortSignal): Promise<SessionRunResult>;
     answerSideQuestion?(sessionId: string | undefined, question: string, signal?: AbortSignal, onDelta?: (delta: string) => void, permissionMode?: ClaudePermissionMode): Promise<SideQuestionResult>;
     recordBtwUsage?(sessionId: string | undefined, permissionMode?: ClaudePermissionMode): Promise<string>;
+    recordColorUsage?(sessionId: string | undefined, selection: AgentColorSelection, display: string, permissionMode?: ClaudePermissionMode): Promise<string>;
+    agentColor?(sessionId: string): Promise<AgentColorName | undefined>;
     recordBackgroundUsage?(sessionId: string | undefined, permissionMode?: ClaudePermissionMode): Promise<string>;
     recordBackgroundLaunch?(sessionId: string): Promise<SessionForkCheckpoint>;
     forkSideQuestion?(sessionId: string, question: string, signal?: AbortSignal): Promise<SideQuestionForkResult>;
@@ -111,6 +115,7 @@ interface InteractiveAppProps {
     initialSessions: readonly SessionSummary[];
     initialPrompt?: string;
     initialHistory?: readonly TranscriptItem[];
+    initialSessionColor?: AgentColorName;
     signal?: AbortSignal;
     onCancel?: () => void;
     onTurnChange?: (turn: Promise<void> | null) => void;
@@ -179,7 +184,7 @@ interface InteractiveAppProps {
     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, 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 InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory, initialSessionColor, 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;

package/dist/cli/interactive.js

@@ -17,6 +17,7 @@ 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';
+import { agentColorMessage, parseAgentColorInput, } from '../compatibility/claude/agent-color.js';
 import { filterTuiSlashCommands, mergeTuiSlashCommands, slashCommandQuery, } from './tui/slash-commands.js';
 import { createComposerEditor, deleteComposerBackward, deleteComposerForward, deleteComposerToEnd, deleteComposerToStart, deleteComposerWordBackward, insertComposerText, moveComposerCursor, moveComposerCursorByWord, } from './tui/composer-editor.js';
 import { applyMentionReference, fileReferenceAtCursor, filterTuiMentionEntries, loadTuiFileEntries, } from './tui/file-picker.js';
@@ -247,7 +248,7 @@ const HIDDEN_TUI_SLASH_COMMANDS = new Set([
     '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, }) {
+export function InteractiveApp({ 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, 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 ??
@@ -304,6 +305,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const statusLineSessionId = useRef(resume?.sessionId ?? randomUUID());
     const sessionIdRef = useRef(resume?.sessionId ?? null);
     sessionIdRef.current = sessionId;
+    const [sessionColor, setSessionColor] = useState(initialSessionColor);
     const [sessionName, setSessionName] = useState(null);
     const [activeSessionSummary, setActiveSessionSummary] = useState(() => resume?.sessionId
         ? initialSessions.find((session) => session.sessionId === resume.sessionId)
@@ -443,6 +445,17 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const matchingSlashCommands = useMemo(() => commandQuery === null
         ? []
         : filterTuiSlashCommands(allSlashCommands, commandQuery), [allSlashCommands, commandQuery]);
+    const commandArgumentHint = useMemo(() => {
+        if (shellMode || !input.startsWith('/'))
+            return undefined;
+        if (inputCursor !== input.length)
+            return undefined;
+        const match = /^\/(\S+) $/u.exec(input);
+        if (!match?.[1])
+            return undefined;
+        const command = allSlashCommands.find((candidate) => candidate.name === match[1]);
+        return command?.argumentHint;
+    }, [allSlashCommands, input, inputCursor, shellMode]);
     const commandPaletteVisible = !busy &&
         !permission &&
         !planApproval &&
@@ -1443,14 +1456,19 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         sessionLoadRef.current = loadId;
         if (nextSessionId === null) {
             setHistory([]);
+            setSessionColor(undefined);
             return;
         }
         const loading = (async () => {
             try {
                 const commands = await service();
                 const transcript = await commands.transcript?.(nextSessionId);
+                const agentColor = commands.agentColor === undefined
+                    ? undefined
+                    : await commands.agentColor(nextSessionId);
                 if (sessionLoadRef.current === loadId) {
                     setHistory(transcript ? [...transcript] : []);
+                    setSessionColor(agentColor);
                 }
             }
             catch (error) {
@@ -1816,6 +1834,32 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         onTurnChange?.(showing);
         void showing.finally(() => onTurnChange?.(null));
     };
+    const changeSessionColor = (display, selection) => {
+        appendPromptHistory(display);
+        if (selection.kind === 'color')
+            setSessionColor(selection.color);
+        else if (selection.kind === 'reset')
+            setSessionColor(undefined);
+        const changing = (async () => {
+            try {
+                const activeSessionId = await withLocalCommands(async (commands) => {
+                    if (!commands.recordColorUsage) {
+                        throw new Error('Session color is unavailable.');
+                    }
+                    return commands.recordColorUsage(sessionId ?? undefined, selection, display, runtimePreferencesRef.current.permissionMode);
+                });
+                if (activeSessionId)
+                    setSessionId(activeSessionId);
+                append({ kind: 'user', text: display });
+                append({ kind: 'local-result', text: agentColorMessage(selection) });
+            }
+            catch (error) {
+                warn(error);
+            }
+        })();
+        onTurnChange?.(changing);
+        void changing.finally(() => onTurnChange?.(null));
+    };
     const backgroundSession = () => {
         appendPromptHistory('/background');
         const backgrounding = (async () => {
@@ -4794,6 +4838,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             if (!prompt || prompt === '!')
                 return;
             const copyCommand = /^\/copy(?:\s+(\d+))?$/u.exec(prompt);
+            const colorCommand = /^\/color(?:\s+([\s\S]+))?$/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);
@@ -4808,12 +4853,14 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             else if (prompt === '/new') {
                 statusLineSessionId.current = randomUUID();
                 setSessionId(null);
+                setSessionColor(undefined);
                 setPendingFork(false);
                 append({ kind: 'notice', text: 'Started a new session.' });
             }
             else if (prompt === '/clear') {
                 statusLineSessionId.current = randomUUID();
                 setSessionId(null);
+                setSessionColor(undefined);
                 setPendingFork(false);
                 setHistory([]);
                 setUsage(undefined);
@@ -4951,6 +4998,9 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                     text: 'The /agents wizard has been removed.\n\nAsk Claude to create or update subagents for you (e.g. "create a code-reviewer subagent that ..."),\nor edit the files directly:\n  • .claude/agents/       (this project)\n  • ~/.claude/agents/     (all projects)\n\nDocs: https://code.claude.com/docs/en/sub-agents',
                 });
             }
+            else if (colorCommand) {
+                changeSessionColor(prompt, parseAgentColorInput(colorCommand[1] ?? ''));
+            }
             else if (btwCommand) {
                 const sideQuestion = btwCommand[1]?.trim();
                 if (sideQuestion)
@@ -5420,7 +5470,9 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                                 label: 'Save to file',
                                 description: 'Save the conversation to a file in the current directory',
                             },
-                        ], selectedIndex: menu.selectedIndex, footer: "Esc to cancel", width: width, screenReader: axScreenReader })) : menu.kind === 'copy' ? (_jsx(SelectionMenu, { title: "Copy", description: "Select content to copy:", options: menu.candidates, selectedIndex: menu.selectedIndex, footer: "Enter to copy \u00B7 w to write to /tmp/claude \u00B7 Esc to cancel", width: width, screenReader: axScreenReader })) : null) : (_jsxs(_Fragment, { children: [commandPaletteVisible ? (_jsx(CommandPalette, { commands: matchingSlashCommands, selectedIndex: selectedSlashCommandIndex, width: width, screenReader: axScreenReader })) : null, filePickerVisible ? (_jsx(MentionPicker, { entries: matchingMentionEntries, selectedIndex: selectedFileIndex, width: width, screenReader: axScreenReader })) : null, exitConfirmation ? (_jsx(Text, { color: activePalette.warning, children: "Press Ctrl-C again to exit" })) : null, _jsx(Composer, { input: shellMode ? input.slice(1) : input, cursor: shellMode ? Math.max(0, inputCursor - 1) : inputCursor, shellMode: shellMode, busy: busy, clipboardBusy: clipboardBusy, status: status, display: runtimeDisplay, ...(usage === undefined ? {} : { usage }), ...(costUsd === undefined ? {} : { costUsd }), width: width, screenReader: axScreenReader, hasThinking: hasDetailedTranscript, thinkingExpanded: thinkingExpanded, reduceMotion: runtimeSettings.reduceMotion, progressBar: runtimeSettings.progressBar, ...(runtimeSettings.turnDuration
+                        ], selectedIndex: menu.selectedIndex, footer: "Esc to cancel", width: width, screenReader: axScreenReader })) : menu.kind === 'copy' ? (_jsx(SelectionMenu, { title: "Copy", description: "Select content to copy:", options: menu.candidates, selectedIndex: menu.selectedIndex, footer: "Enter to copy \u00B7 w to write to /tmp/claude \u00B7 Esc to cancel", width: width, screenReader: axScreenReader })) : null) : (_jsxs(_Fragment, { children: [commandPaletteVisible ? (_jsx(CommandPalette, { commands: matchingSlashCommands, selectedIndex: selectedSlashCommandIndex, width: width, screenReader: axScreenReader })) : null, filePickerVisible ? (_jsx(MentionPicker, { entries: matchingMentionEntries, selectedIndex: selectedFileIndex, width: width, screenReader: axScreenReader })) : null, exitConfirmation ? (_jsx(Text, { color: activePalette.warning, children: "Press Ctrl-C again to exit" })) : null, _jsx(Composer, { input: shellMode ? input.slice(1) : input, cursor: shellMode ? Math.max(0, inputCursor - 1) : inputCursor, shellMode: shellMode, ...(sessionColor === undefined ? {} : { sessionColor }), ...(commandArgumentHint === undefined
+                                    ? {}
+                                    : { commandArgumentHint }), busy: busy, clipboardBusy: clipboardBusy, status: status, display: runtimeDisplay, ...(usage === undefined ? {} : { usage }), ...(costUsd === undefined ? {} : { costUsd }), width: width, screenReader: axScreenReader, hasThinking: hasDetailedTranscript, thinkingExpanded: thinkingExpanded, reduceMotion: runtimeSettings.reduceMotion, progressBar: runtimeSettings.progressBar, ...(runtimeSettings.turnDuration
                                     ? (() => {
                                         const duration = formatTurnDuration(turnDuration);
                                         return duration === undefined
@@ -5534,11 +5586,16 @@ export async function runInteractive(options) {
             initialAgentPromptResolved = true;
         }
         let initialHistory = [];
+        let initialSessionColor;
         try {
             initialHistory =
                 resume?.sessionId === undefined || listing.transcript === undefined
                     ? []
                     : await listing.transcript(resume.sessionId);
+            initialSessionColor =
+                resume?.sessionId === undefined || listing.agentColor === undefined
+                    ? undefined
+                    : await listing.agentColor(resume.sessionId);
         }
         catch (error) {
             try {
@@ -5563,7 +5620,7 @@ 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, ...(options.settingSources === undefined
+        const instance = render(_jsx(InteractiveApp, { factory: options.factory, initialSessions: initialSessions, slashCommands: initialSlashCommands, agents: initialAgents, initialHistory: history, ...(initialSessionColor === undefined ? {} : { initialSessionColor }), runtimeSettings: currentRuntimeSettings, ...(options.settingSources === undefined
                 ? {}
                 : { settingSources: options.settingSources }), initialThemeSettings: initialThemeSettings, ...(initialThemeLoadError === undefined
                 ? {}

package/dist/cli/protocol.d.ts

@@ -206,6 +206,13 @@ export interface ProtocolResult {
 }
 export declare function createSuccessResult(result: ProtocolResult, info: CliRuntimeInfo, startedAt: number, modelTurns: number): Record<string, unknown>;
 export declare function createErrorResult(message: string, sessionId: string, startedAt: number, modelTurns: number): Record<string, unknown>;
+/**
+ * Returns the argument text of a headless `/color` prompt, or undefined when
+ * the prompt is not a bare `/color` command. A trailing space matches with an
+ * empty argument (random color), while `/colorblue` and `/colorful` are not
+ * the command.
+ */
+export declare function matchHeadlessColorCommand(prompt: string): string | undefined;
 export declare function parseCliInvocation(argv: readonly string[]): CliInvocation;
 export declare function readStreamJsonMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamJsonMessage>;
 export declare function readStreamUserMessages(input: AsyncIterable<string | Uint8Array>): AsyncGenerator<StreamUserMessage>;
@@ -232,6 +239,12 @@ export declare class StreamJsonOutput {
     constructor(write: (value: unknown) => void, info: CliRuntimeInfo, sessionId: string, includePartialMessages: boolean, includeHookEvents?: boolean);
     init(): void;
     replayUser(message: StreamUserMessage['message']): void;
+    /**
+     * Emits the synthetic assistant message for a provider-free local command
+     * (e.g. /color). It must not touch the turn state, so the following result
+     * keeps num_turns 0 and no stream_event records are produced.
+     */
+    syntheticAssistant(text: string): void;
     controlRequest(request: {
         request_id: string;
         request: Record<string, unknown>;

package/dist/cli/protocol.js

@@ -80,6 +80,18 @@ export function createErrorResult(message, sessionId, startedAt, modelTurns) {
         uuid: randomUUID(),
     };
 }
+/**
+ * Returns the argument text of a headless `/color` prompt, or undefined when
+ * the prompt is not a bare `/color` command. A trailing space matches with an
+ * empty argument (random color), while `/colorblue` and `/colorful` are not
+ * the command.
+ */
+export function matchHeadlessColorCommand(prompt) {
+    const match = /^\/color(?:\s+([\s\S]*))?$/u.exec(prompt);
+    if (match === null)
+        return undefined;
+    return match[1] ?? '';
+}
 const INPUT_FORMATS = ['text', 'stream-json'];
 const OUTPUT_FORMATS = ['text', 'json', 'stream-json'];
 const PERMISSION_MODES = [
@@ -1594,6 +1606,28 @@ export class StreamJsonOutput {
     replayUser(message) {
         this.write({ type: 'user', message, session_id: this.sessionId });
     }
+    /**
+     * Emits the synthetic assistant message for a provider-free local command
+     * (e.g. /color). It must not touch the turn state, so the following result
+     * keeps num_turns 0 and no stream_event records are produced.
+     */
+    syntheticAssistant(text) {
+        this.write({
+            type: 'assistant',
+            message: {
+                id: randomUUID(),
+                type: 'message',
+                role: 'assistant',
+                model: '<synthetic>',
+                content: [{ type: 'text', text }],
+                stop_reason: 'stop_sequence',
+                stop_sequence: '',
+                usage: { input_tokens: 0, output_tokens: 0 },
+            },
+            parent_tool_use_id: null,
+            session_id: this.sessionId,
+        });
+    }
     controlRequest(request) {
         this.write({ type: 'control_request', ...request });
     }

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

@@ -1,4 +1,4 @@
-export type ClaudeCommandDisposition = 'included' | 'deferred' | 'excluded';
+export type ClaudeCommandDisposition = 'included' | 'required' | 'deferred' | 'excluded';
 export type ClaudeCommandVisibility = 'visible' | 'hidden' | 'conditional';
 export interface ClaudeCommandInventoryEntry {
     name: string;
@@ -14,7 +14,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "advisor";
     readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "Conditional advice mode is required parity work and is not implemented yet.";
+    readonly reason: "Conditional advice mode is an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "agents";
     readonly disposition: "included";
@@ -29,18 +29,17 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "chrome";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "The CLI-driven Chrome integration is required parity work and is not implemented yet.";
+    readonly reason: "Claude-AI subscription-gated Chrome Beta; a future provider-neutral browser feature is separate from this command.";
 }, {
     readonly name: "clear";
     readonly disposition: "included";
     readonly visibility: "visible";
 }, {
     readonly name: "color";
-    readonly disposition: "deferred";
+    readonly disposition: "included";
     readonly visibility: "visible";
-    readonly reason: "The dedicated /color contract is required; /theme is not a substitute.";
 }, {
     readonly name: "compact";
     readonly disposition: "included";
@@ -64,7 +63,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "cost";
-    readonly disposition: "deferred";
+    readonly disposition: "required";
     readonly visibility: "conditional";
     readonly reason: "The dedicated /cost contract is required; /status is not a substitute.";
 }, {
@@ -73,7 +72,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "visible";
 }, {
     readonly name: "doctor";
-    readonly disposition: "deferred";
+    readonly disposition: "required";
     readonly visibility: "conditional";
     readonly reason: "Interactive /doctor is required; the top-level command is not a substitute.";
 }, {
@@ -88,7 +87,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "fast";
     readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "The /fast state flow is required; model and effort controls are not a substitute.";
+    readonly reason: "The /fast state flow is an optional convenience; model and effort controls cover the core flow, so it is deferred without blocking developer-core closure.";
 }, {
     readonly name: "files";
     readonly disposition: "excluded";
@@ -96,9 +95,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: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "hidden";
-    readonly reason: "The hidden heap-diagnostic contract is required parity work and is not implemented yet.";
+    readonly reason: "Hidden V8 maintainer diagnostic that writes a heap dump to Desktop; not a developer-core command.";
 }, {
     readonly name: "help";
     readonly disposition: "included";
@@ -189,7 +188,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "stats";
     readonly disposition: "deferred";
     readonly visibility: "visible";
-    readonly reason: "Historical usage statistics are required parity work and are not implemented yet.";
+    readonly reason: "Historical usage statistics are an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "status";
     readonly disposition: "included";
@@ -262,7 +261,7 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "insights";
     readonly disposition: "deferred";
     readonly visibility: "visible";
-    readonly reason: "Retrospective insights are required parity work and are not implemented yet.";
+    readonly reason: "Retrospective insights are an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "vim";
     readonly disposition: "included";
@@ -278,24 +277,24 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "buddy";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "proactive";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "brief";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "assistant";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This conditional source mode is required parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }, {
     readonly name: "remote-control";
     readonly disposition: "excluded";
@@ -310,17 +309,17 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly name: "voice";
     readonly disposition: "deferred";
     readonly visibility: "conditional";
-    readonly reason: "Conditional voice input is required parity work and is not implemented yet.";
+    readonly reason: "Conditional voice input is an optional, demand-driven feature that does not block developer-core closure.";
 }, {
     readonly name: "think-back";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "The conditional retrospective flow is required parity work and is not implemented yet.";
+    readonly reason: "The 2025 year-in-review campaign surface; a marketing flow, not a stable developer-core command.";
 }, {
     readonly name: "thinkback-play";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "hidden";
-    readonly reason: "The hidden retrospective playback flow is required parity work and is not implemented yet.";
+    readonly reason: "Hidden animation for the 2025 year-in-review campaign; a marketing flow, not a stable developer-core command.";
 }, {
     readonly name: "permissions";
     readonly disposition: "included";
@@ -376,9 +375,9 @@ export declare const CLAUDE_2_1_208_COMMAND_INVENTORY: readonly [{
     readonly visibility: "conditional";
 }, {
     readonly name: "torch";
-    readonly disposition: "deferred";
+    readonly disposition: "excluded";
     readonly visibility: "conditional";
-    readonly reason: "This source-gated behavior is required conditional parity work and is not implemented yet.";
+    readonly reason: "Compile/build-feature-gated experiment, not a stable single-user developer-core command.";
 }];
 export declare const CLAUDE_2_1_208_COMMAND_BY_NAME: ReadonlyMap<string, ClaudeCommandInventoryEntry>;
 //# sourceMappingURL=claude-command-inventory.d.ts.map