@ekkos/cli 1.3.8 → 1.4.0

package/dist/commands/run.js

@@ -86,6 +86,300 @@ function getConfig(options) {
     };
     /* eslint-enable no-restricted-syntax */
 }
+const MAX_OUTPUT_1M_MODELS = '64000';
+const MAX_OUTPUT_200K_OPUS_SONNET = '32768';
+let runtimeClaudeCodeVersion = null;
+let runtimeClaudeContextWindow = 'auto';
+let runtimeClaudeLaunchModel;
+function normalizeContextWindowOption(value) {
+    const normalized = (value || '').trim().toLowerCase();
+    if (normalized === '200k' || normalized === '200000')
+        return '200k';
+    if (normalized === '1m' || normalized === '1000000')
+        return '1m';
+    return 'auto';
+}
+function normalizeRequestedLaunchModel(value) {
+    if (typeof value !== 'string')
+        return {};
+    const raw = (value || '').trim();
+    if (!raw)
+        return {};
+    if (raw.toLowerCase() === 'default') {
+        return {};
+    }
+    const oneMillionMatch = raw.match(/^(.*)\[1m\]$/i);
+    if (oneMillionMatch) {
+        return {
+            model: oneMillionMatch[1].trim(),
+            syntheticContextWindow: '1m',
+        };
+    }
+    const lower = raw.toLowerCase();
+    if (lower.endsWith('-200k')) {
+        return {
+            model: raw.slice(0, -5).trim(),
+            syntheticContextWindow: '200k',
+        };
+    }
+    if (lower.endsWith('-1m')) {
+        return {
+            model: raw.slice(0, -3).trim(),
+            syntheticContextWindow: '1m',
+        };
+    }
+    return { model: raw };
+}
+function modelSupportsOneMillionContext(model) {
+    const normalized = (model || 'default').trim().toLowerCase();
+    if (!normalized || normalized === 'default')
+        return true;
+    if (normalized === 'opus' || normalized === 'sonnet')
+        return true;
+    return normalized.includes('claude-opus-4-6') || normalized.includes('claude-sonnet-4-6');
+}
+function buildClaudeLaunchModelArg(model, contextWindow) {
+    if (!model)
+        return undefined;
+    const normalized = normalizeRequestedLaunchModel(model).model;
+    if (!normalized)
+        return undefined;
+    if (contextWindow === '1m' && modelSupportsOneMillionContext(normalized)) {
+        return `${normalized}[1m]`;
+    }
+    return normalized;
+}
+function buildClaudeLaunchProfileId(model, contextWindow) {
+    const normalized = normalizeRequestedLaunchModel(model).model;
+    if (!normalized)
+        return undefined;
+    const lower = normalized.toLowerCase();
+    if (/^claude-opus-4-6(?:$|-)/.test(lower)) {
+        if (contextWindow === '200k')
+            return 'claude-opus-4-6-200k';
+        if (contextWindow === '1m')
+            return 'claude-opus-4-6-1m';
+        return undefined;
+    }
+    if (/^claude-sonnet-4-6(?:$|-)/.test(lower)) {
+        if (contextWindow === '200k')
+            return 'claude-sonnet-4-6-200k';
+        if (contextWindow === '1m')
+            return 'claude-sonnet-4-6-1m';
+        return undefined;
+    }
+    if (/^claude-opus-4-5(?:$|-)/.test(lower))
+        return 'claude-opus-4-5';
+    if (/^claude-sonnet-4-5(?:$|-)/.test(lower))
+        return 'claude-sonnet-4-5';
+    if (/^claude-haiku-4-5(?:$|-)/.test(lower))
+        return 'claude-haiku-4-5';
+    return normalized;
+}
+function resolveClaudeContextWindowSize(model, contextWindow) {
+    if (contextWindow === '200k')
+        return 200000;
+    if (contextWindow === '1m' && modelSupportsOneMillionContext(model))
+        return 1000000;
+    if (model && !modelSupportsOneMillionContext(model))
+        return 200000;
+    return undefined;
+}
+function getClaudeSessionMetadata(options) {
+    const normalizedContextWindow = normalizeContextWindowOption(options.contextWindow);
+    const selectedModel = typeof options.model === 'string' ? options.model : undefined;
+    const launchModel = buildClaudeLaunchModelArg(selectedModel, normalizedContextWindow);
+    const profileId = buildClaudeLaunchProfileId(selectedModel, normalizedContextWindow);
+    const contextSize = resolveClaudeContextWindowSize(selectedModel, normalizedContextWindow);
+    const maxOutputTokens = Number.parseInt(resolveClaudeMaxOutputTokens(selectedModel, normalizedContextWindow), 10);
+    return {
+        provider: 'claude',
+        claudeModel: normalizeRequestedLaunchModel(selectedModel).model,
+        claudeLaunchModel: launchModel,
+        claudeProfile: profileId,
+        claudeContextWindow: normalizedContextWindow,
+        claudeContextSize: contextSize,
+        claudeMaxOutputTokens: Number.isFinite(maxOutputTokens) ? maxOutputTokens : undefined,
+        claudeCodeVersion: runtimeClaudeCodeVersion || undefined,
+        dashboardEnabled: options.dashboard === true,
+        bypassEnabled: options.bypass === true,
+    };
+}
+function isTwoHundredKFixedOutputModel(model) {
+    const normalized = (model || '').trim().toLowerCase();
+    if (!normalized)
+        return false;
+    if (normalized === 'opus' || normalized === 'sonnet')
+        return true;
+    return /^claude-(?:opus|sonnet)-4-(?:5|6)(?:$|-)/.test(normalized);
+}
+function resolveClaudeMaxOutputTokens(model, contextWindow) {
+    if (process.env.EKKOS_MAX_OUTPUT_TOKENS) {
+        return process.env.EKKOS_MAX_OUTPUT_TOKENS;
+    }
+    if (contextWindow === '200k' && isTwoHundredKFixedOutputModel(model)) {
+        return MAX_OUTPUT_200K_OPUS_SONNET;
+    }
+    return MAX_OUTPUT_1M_MODELS;
+}
+function shouldOpenLaunchSelector(options) {
+    return options.model === true;
+}
+function renderClaudeLaunchSelectorIntro() {
+    const neonCyan = chalk_1.default.hex('#00f5ff');
+    const acidGreen = chalk_1.default.hex('#9dff00');
+    const signalAmber = chalk_1.default.hex('#ffb300');
+    const steel = chalk_1.default.hex('#8a92a6');
+    const width = 68;
+    const line = (text) => {
+        const pad = Math.max(0, width - stripAnsi(text).length);
+        return `${neonCyan('║')} ${text}${' '.repeat(pad)}${neonCyan('║')}`;
+    };
+    console.log('');
+    console.log(neonCyan('╔══════════════════════════════════════════════════════════════════════╗'));
+    console.log(line(chalk_1.default.white.bold('ekkOS.dev // PULSE')));
+    console.log(neonCyan('╠══════════════════════════════════════════════════════════════════════╣'));
+    console.log(line(`${acidGreen('200K')} ${steel('compat lane')} ${chalk_1.default.white('// Opus/Sonnet 4.5/4.6 => 32,768 output')}`));
+    console.log(line(`${signalAmber(' 1M')} ${steel('wide lane')}   ${chalk_1.default.white('// Opus/Sonnet 4.6 => 64,000 output')}`));
+    console.log(line(steel('Pick a launch vector, then a fixed runtime profile. No hidden context prompt.')));
+    console.log(neonCyan('╚══════════════════════════════════════════════════════════════════════╝'));
+    console.log('');
+}
+function buildLaunchModeChoices() {
+    return [
+        {
+            name: `${chalk_1.default.hex('#00f5ff').bold('Fresh boot')} ${chalk_1.default.gray('// new shell')}`,
+            value: 'fresh',
+        },
+        {
+            name: `${chalk_1.default.hex('#9dff00').bold('Resume recent')} ${chalk_1.default.gray('// latest thread')}`,
+            value: 'continue',
+        },
+        {
+            name: `${chalk_1.default.hex('#ffb300').bold('Resume by ID')} ${chalk_1.default.gray('// targeted reconnect')}`,
+            value: 'resume',
+        },
+    ];
+}
+function buildLaunchModelChoices() {
+    const cyan = chalk_1.default.hex('#00f5ff');
+    const amber = chalk_1.default.hex('#ffb300');
+    const green = chalk_1.default.hex('#00ff88');
+    return [
+        {
+            name: `${cyan.bold('Auto route')} ${chalk_1.default.gray('// Claude decides profile')}`,
+            value: 'default',
+        },
+        {
+            name: `${cyan.bold('Claude Opus 4.5')} ${green('[200K]')} ${chalk_1.default.gray('// out 32,768')}`,
+            value: 'claude-opus-4-5',
+        },
+        {
+            name: `${cyan.bold('Claude Opus 4.6')} ${green('[200K]')} ${chalk_1.default.gray('// out 32,768')}`,
+            value: 'claude-opus-4-6-200k',
+        },
+        {
+            name: `${cyan.bold('Claude Opus 4.6')} ${amber('[1M]')} ${chalk_1.default.gray('// out 64,000')}`,
+            value: 'claude-opus-4-6-1m',
+        },
+        {
+            name: `${cyan.bold('Claude Sonnet 4.5')} ${green('[200K]')} ${chalk_1.default.gray('// out 32,768')}`,
+            value: 'claude-sonnet-4-5',
+        },
+        {
+            name: `${cyan.bold('Claude Sonnet 4.6')} ${green('[200K]')} ${chalk_1.default.gray('// out 32,768')}`,
+            value: 'claude-sonnet-4-6-200k',
+        },
+        {
+            name: `${cyan.bold('Claude Sonnet 4.6')} ${amber('[1M]')} ${chalk_1.default.gray('// out 64,000')}`,
+            value: 'claude-sonnet-4-6-1m',
+        },
+        {
+            name: `${cyan.bold('Claude Haiku 4.5')} ${green('[200K]')} ${chalk_1.default.gray('// fast lane')}`,
+            value: 'claude-haiku-4-5',
+        },
+    ];
+}
+async function resolveClaudeLaunchSelection(options) {
+    const requestedModel = normalizeRequestedLaunchModel(typeof options.model === 'string' ? options.model : process.env.EKKOS_CLAUDE_MODEL);
+    let model = requestedModel.model;
+    let contextWindow = requestedModel.syntheticContextWindow
+        || normalizeContextWindowOption(options.contextWindow || process.env.EKKOS_CLAUDE_CONTEXT_WINDOW);
+    let continueLast = options.continueLast || false;
+    let resumeSession = (options.resumeSession || '').trim();
+    const shouldShowLaunchWindow = shouldOpenLaunchSelector(options)
+        && process.stdin.isTTY === true
+        && process.stdout.isTTY === true
+        && process.env.EKKOS_DISABLE_LAUNCH_WINDOW !== '1';
+    if (!shouldShowLaunchWindow) {
+        if (!modelSupportsOneMillionContext(model)) {
+            contextWindow = '200k';
+        }
+        return {
+            model,
+            contextWindow,
+            continueLast: !!continueLast && !resumeSession,
+            resumeSession: resumeSession || undefined,
+        };
+    }
+    const { default: inquirer } = await Promise.resolve().then(() => __importStar(require('inquirer')));
+    renderClaudeLaunchSelectorIntro();
+    const defaultLaunchMode = resumeSession ? 'resume' : continueLast ? 'continue' : 'fresh';
+    const firstPrompt = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'launchMode',
+            message: chalk_1.default.hex('#00f5ff').bold('>> Boot vector'),
+            default: defaultLaunchMode,
+            pageSize: 3,
+            loop: false,
+            choices: buildLaunchModeChoices(),
+        },
+        {
+            type: 'list',
+            name: 'model',
+            message: chalk_1.default.hex('#00f5ff').bold('>> Model lane'),
+            default: model || 'default',
+            pageSize: 8,
+            loop: false,
+            choices: buildLaunchModelChoices(),
+        },
+    ]);
+    const selectedProfile = normalizeRequestedLaunchModel(firstPrompt.model);
+    model = firstPrompt.model === 'default' ? undefined : selectedProfile.model;
+    continueLast = firstPrompt.launchMode === 'continue';
+    resumeSession = firstPrompt.launchMode === 'resume' ? resumeSession : '';
+    if (firstPrompt.launchMode === 'resume') {
+        const resumePrompt = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'resumeSession',
+                message: 'Claude session ID',
+                default: resumeSession,
+                validate: (value) => value.trim().length > 0 || 'Session ID is required',
+            },
+        ]);
+        resumeSession = resumePrompt.resumeSession.trim();
+    }
+    if (firstPrompt.model === 'default') {
+        contextWindow = 'auto';
+    }
+    else if (selectedProfile.syntheticContextWindow) {
+        contextWindow = selectedProfile.syntheticContextWindow;
+    }
+    else if (!modelSupportsOneMillionContext(model)) {
+        contextWindow = '200k';
+    }
+    else {
+        contextWindow = 'auto';
+    }
+    return {
+        model,
+        contextWindow,
+        continueLast,
+        resumeSession: resumeSession || undefined,
+    };
+}
 // ═══════════════════════════════════════════════════════════════════════════
 // PATTERN MATCHING
 // ═══════════════════════════════════════════════════════════════════════════
@@ -291,13 +585,6 @@ const isWindows = os.platform() === 'win32';
 // Core ekkOS patches (eviction, context management) work with all recent versions
 // Cosmetic patches may fail on newer versions but don't affect functionality
 const PINNED_CLAUDE_VERSION = 'latest';
-// Max output tokens for Claude responses
-// Default: 128000 (Opus 4.6 / Sonnet 4.6 max output)
-// Override via EKKOS_MAX_OUTPUT_TOKENS env var if needed
-// Note: Claude Code has a known bug where CLAUDE_CODE_MAX_OUTPUT_TOKENS is ignored on Opus 4.6
-// (see github.com/anthropics/claude-code/issues/24159). We set it anyway + the proxy also
-// enforces this via max_tokens override on the API request.
-const EKKOS_MAX_OUTPUT_TOKENS = process.env.EKKOS_MAX_OUTPUT_TOKENS || '128000';
 const proxy_url_1 = require("../utils/proxy-url");
 // Track proxy mode for getEkkosEnv (set by run() based on options)
 let proxyModeEnabled = true;
@@ -318,12 +605,13 @@ let cliSessionName = null;
 let cliSessionId = null;
 /**
  * Get environment with ekkOS enhancements
- * - Sets CLAUDE_CODE_MAX_OUTPUT_TOKENS to 128K (API max for Opus/Sonnet 4.6)
+ * - Sets CLAUDE_CODE_MAX_OUTPUT_TOKENS dynamically for the selected Claude profile
  * - Routes API through ekkOS proxy for seamless context eviction (when enabled)
  * - Sets EKKOS_PROXY_MODE to signal JSONL rewriter to disable eviction
  * - Passes session headers for eviction/retrieval context tracking
  */
 function getEkkosEnv() {
+    const maxOutputTokens = resolveClaudeMaxOutputTokens(runtimeClaudeLaunchModel, runtimeClaudeContextWindow);
     /* eslint-disable no-restricted-syntax -- System env spreading, not API key access */
     const env = {
         ...process.env,
@@ -335,13 +623,18 @@ function getEkkosEnv() {
         // Native autocompact would compact without ekkOS saving state first, causing knowledge loss.
         // Only ekkOS-wrapped sessions get this; vanilla `claude` keeps autocompact on.
         DISABLE_AUTO_COMPACT: 'true',
-        // Set max output tokens to 128K (Opus 4.6 / Sonnet 4.6 API max).
-        // Note: Claude Code has a known bug where this env var is ignored on Opus 4.6
-        // (github.com/anthropics/claude-code/issues/24159). The proxy also enforces
-        // this by overriding max_tokens on the API request as a fallback.
-        CLAUDE_CODE_MAX_OUTPUT_TOKENS: EKKOS_MAX_OUTPUT_TOKENS,
+        // Align Claude's advertised output ceiling with the chosen model/context profile.
+        // 1M Opus/Sonnet gets 128K; 200K Opus/Sonnet 4.5/4.6 is forced to 32,768.
+        // The proxy also enforces this server-side in case Claude Code ignores the env var.
+        CLAUDE_CODE_MAX_OUTPUT_TOKENS: maxOutputTokens,
     };
     /* eslint-enable no-restricted-syntax */
+    if (runtimeClaudeContextWindow === '200k') {
+        env.CLAUDE_CODE_DISABLE_1M_CONTEXT = '1';
+    }
+    else {
+        delete env.CLAUDE_CODE_DISABLE_1M_CONTEXT;
+    }
     // Check if proxy is disabled via env var or options
     // eslint-disable-next-line no-restricted-syntax -- Feature flag, not API key
     const proxyDisabled = process.env.EKKOS_DISABLE_PROXY === '1' || !proxyModeEnabled;
@@ -354,7 +647,9 @@ function getEkkosEnv() {
         if (!cliSessionName) {
             cliSessionId = crypto.randomUUID();
             cliSessionName = (0, state_1.uuidToWords)(cliSessionId);
-            console.log(chalk_1.default.gray(`  📂 Session: ${cliSessionName}`));
+            if (process.env.EKKOS_NO_SPLASH !== '1') {
+                console.log(chalk_1.default.gray(`  📂 Session: ${cliSessionName}`));
+            }
         }
         // Get full userId from config (NOT the truncated version from auth token)
         // Config has full UUID like "d4532ba0-0a86-42ce-bab4-22aa62b55ce6"
@@ -374,7 +669,11 @@ function getEkkosEnv() {
         // CRITICAL: Embed user/session in URL path since ANTHROPIC_HEADERS doesn't work
         // Claude Code SDK doesn't forward custom headers, but it DOES use ANTHROPIC_BASE_URL
         // Gateway extracts from URL: /proxy/{userId}/{sessionName}/v1/messages
-        const proxyUrl = (0, proxy_url_1.buildProxyUrl)(userId, cliSessionName, process.cwd(), cliSessionId);
+        const proxyUrl = (0, proxy_url_1.buildProxyUrl)(userId, cliSessionName, process.cwd(), cliSessionId, {
+            claudeCodeVersion: runtimeClaudeCodeVersion || undefined,
+            claudeProfile: buildClaudeLaunchProfileId(runtimeClaudeLaunchModel, runtimeClaudeContextWindow),
+            claudeContextWindow: runtimeClaudeContextWindow,
+        });
         env.ANTHROPIC_BASE_URL = proxyUrl;
         // Proxy URL contains userId + project path — don't leak to terminal
     }
@@ -585,6 +884,105 @@ function resolveGlobalClaudePath() {
 function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
+function formatPulseLaunchMode(options) {
+    if (options.resumeSession)
+        return `RESUME // ${options.resumeSession}`;
+    if (options.continueLast)
+        return 'CONTINUE // most recent Claude thread';
+    return 'FRESH // new interactive shell';
+}
+function formatPulseModel(model) {
+    const normalized = (model || '').trim().toLowerCase();
+    if (!normalized)
+        return 'Claude default';
+    if (normalized === 'opus')
+        return 'Opus alias';
+    if (normalized === 'sonnet')
+        return 'Sonnet alias';
+    if (normalized === 'claude-opus-4-5')
+        return 'Claude Opus 4.5';
+    if (normalized === 'claude-opus-4-6')
+        return 'Claude Opus 4.6';
+    if (normalized === 'claude-sonnet-4-5')
+        return 'Claude Sonnet 4.5';
+    if (normalized === 'claude-sonnet-4-6')
+        return 'Claude Sonnet 4.6';
+    if (normalized === 'claude-haiku-4-5')
+        return 'Claude Haiku 4.5';
+    return model || 'Claude default';
+}
+function formatPulseContextLine(contextWindow) {
+    if (contextWindow === '200k') {
+        return '200K // 200,000 token window // forced 32,768 output';
+    }
+    if (contextWindow === '1m') {
+        return '1M // 1,000,000 token window // safe 64,000 output cap';
+    }
+    return 'AUTO // ekkOS resolves 200K vs 1M from the selected profile';
+}
+async function showPulseLaunchLoader(options) {
+    const cyan = chalk_1.default.hex('#00f0ff');
+    const amber = chalk_1.default.hex('#ffb800');
+    const green = chalk_1.default.hex('#00ff88');
+    const steel = chalk_1.default.hex('#7a7a8e');
+    const panel = chalk_1.default.hex('#111118');
+    const wordmark = [
+        '██████╗ ██╗   ██╗██╗     ███████╗███████╗',
+        '██╔══██╗██║   ██║██║     ██╔════╝██╔════╝',
+        '██████╔╝██║   ██║██║     ███████╗█████╗  ',
+        '██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝  ',
+        '██║     ╚██████╔╝███████╗███████║███████╗',
+        '╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝',
+    ];
+    const stages = [
+        'arming pulse launcher',
+        'syncing dashboard split',
+        'routing claude session',
+    ];
+    const barWidth = 26;
+    const panelInnerWidth = 76;
+    const buildPanelLine = (labelColor, label, value) => {
+        const content = ` ${label.padEnd(7)} ${value}`;
+        const pad = Math.max(0, panelInnerWidth - stripAnsi(content).length);
+        return `  ${cyan('║')} ${labelColor(label.padEnd(7))} ${chalk_1.default.white(value)}${' '.repeat(pad)}${cyan('║')}`;
+    };
+    const headerContent = ' ekkOS.dev // PULSE BOOTSTRAP   live launch matrix for Claude + dashboard';
+    const headerPad = Math.max(0, panelInnerWidth - headerContent.length);
+    console.log('');
+    for (const [idx, line] of wordmark.entries()) {
+        const color = idx % 2 === 0 ? cyan.bold : chalk_1.default.white.bold;
+        console.log('  ' + color(line));
+        await sleep(22);
+    }
+    console.log('  ' + amber('▔').repeat(54));
+    console.log(cyan('  ╔══════════════════════════════════════════════════════════════════════════════╗'));
+    console.log(`  ${cyan('║')}${chalk_1.default.white.bold(' ekkOS.dev // PULSE BOOTSTRAP')}${steel('   live launch matrix for Claude + dashboard')}${' '.repeat(headerPad)}${cyan('║')}`);
+    console.log(buildPanelLine(green, 'MODE', formatPulseLaunchMode(options)));
+    console.log(buildPanelLine(green, 'MODEL', formatPulseModel(typeof options.model === 'string' ? options.model : undefined)));
+    console.log(buildPanelLine(amber, 'WINDOW', formatPulseContextLine(normalizeContextWindowOption(options.contextWindow))));
+    console.log(buildPanelLine(steel, 'PATH', 'selector -> dashboard -> claude -> proxy'));
+    console.log(cyan('  ╚══════════════════════════════════════════════════════════════════════════════╝'));
+    console.log(`  ${green('200K')} ${steel('// Opus/Sonnet 4.5/4.6 => 32,768 output')}`);
+    console.log(`  ${amber('1M  ')} ${steel('// Opus/Sonnet 4.6 => 64,000 output')}`);
+    console.log('');
+    for (const stage of stages) {
+        for (let filled = 0; filled <= barWidth; filled += 1) {
+            const complete = '█'.repeat(filled);
+            const pending = '░'.repeat(barWidth - filled);
+            process.stdout.write(`\r  ${amber('[')}${cyan(complete)}${steel(pending)}${amber(']')} ${chalk_1.default.white(stage)}`);
+            await sleep(16);
+        }
+        process.stdout.write('\n');
+    }
+    console.log(`  ${green('READY')}   ${panel('dashboard split armed')} ${steel('// selector handoff imminent')}`);
+    if (options.bypass) {
+        console.log(`  ${amber('BYPASS')}  ${chalk_1.default.white('permission prompts disabled for this launch')}`);
+    }
+    if (options.verbose) {
+        console.log(`  ${steel('TRACE')}   ${steel('verbose telemetry enabled')}`);
+    }
+    console.log('');
+}
 /**
  * Show morning dreams with WOW factor right after sparkle animation.
  * Colorful, lively, readable — real magic moment. Then pause for Enter.
@@ -790,10 +1188,16 @@ function cleanupInstanceFile(instanceId) {
  * Keeps ~/.ekkos/current-session.json, ~/.claude/state/current-session.json,
  * and ~/.ekkos/session-hint.json in sync whenever the session is known.
  */
-function writeSessionFiles(sessionId, sessionName) {
+function writeSessionFiles(sessionId, sessionName, metadata) {
     try {
         const ekkosDir = path.join(os.homedir(), '.ekkos');
         const claudeStateDir = path.join(os.homedir(), '.claude', 'state');
+        const launchMetadata = metadata || getClaudeSessionMetadata({
+            model: runtimeClaudeLaunchModel,
+            contextWindow: runtimeClaudeContextWindow,
+            dashboard: false,
+            bypass: false,
+        });
         // Ensure directories exist
         if (!fs.existsSync(ekkosDir))
             fs.mkdirSync(ekkosDir, { recursive: true });
@@ -801,16 +1205,17 @@ function writeSessionFiles(sessionId, sessionName) {
             fs.mkdirSync(claudeStateDir, { recursive: true });
         const now = new Date().toISOString();
         // 1. ~/.ekkos/current-session.json
-        fs.writeFileSync(path.join(ekkosDir, 'current-session.json'), JSON.stringify({ session_id: sessionId, session_name: sessionName, timestamp: now }, null, 2));
+        fs.writeFileSync(path.join(ekkosDir, 'current-session.json'), JSON.stringify({ session_id: sessionId, session_name: sessionName, timestamp: now, ...launchMetadata }, null, 2));
         // 2. ~/.claude/state/current-session.json
-        fs.writeFileSync(path.join(claudeStateDir, 'current-session.json'), JSON.stringify({ session_id: sessionId, session_name: sessionName, timestamp: now }, null, 2));
+        fs.writeFileSync(path.join(claudeStateDir, 'current-session.json'), JSON.stringify({ session_id: sessionId, session_name: sessionName, timestamp: now, ...launchMetadata }, null, 2));
         // 3. ~/.ekkos/session-hint.json (dashboard discovery)
         fs.writeFileSync(path.join(ekkosDir, 'session-hint.json'), JSON.stringify({
             session_name: sessionName,
             session_id: sessionId,
             project_path: process.cwd(),
             timestamp: now,
-            pid: process.pid
+            pid: process.pid,
+            ...launchMetadata,
         }, null, 2));
     }
     catch {
@@ -844,12 +1249,21 @@ function launchWithDashboard(options) {
         runArgs.push('--skip-inject');
     if (options.noProxy)
         runArgs.push('--skip-proxy');
+    if (options.continueLast)
+        runArgs.push('--continue-last');
+    if (options.resumeSession)
+        runArgs.push('--resume-session', options.resumeSession);
+    if (typeof options.model === 'string')
+        runArgs.push('--model', options.model);
+    if (options.contextWindow && options.contextWindow !== 'auto') {
+        runArgs.push('--context-window', options.contextWindow);
+    }
     const ekkosCmd = process.argv[1]; // Path to ekkos CLI
     const cwd = process.cwd();
     const termCols = process.stdout.columns ?? 160;
     const termRows = process.stdout.rows ?? 48;
     // Write session hint immediately so dashboard can find JSONL as it appears
-    writeSessionFiles(crypto.randomUUID(), sessionName);
+    writeSessionFiles(crypto.randomUUID(), sessionName, getClaudeSessionMetadata(options));
     const runCommand = `EKKOS_NO_SPLASH=1 node "${ekkosCmd}" ${runArgs.join(' ')}`;
     // Pass session name directly — dashboard starts rendering immediately (lazy JSONL resolution)
     const dashCommand = `node "${ekkosCmd}" dashboard "${sessionName}" --refresh 2000`;
@@ -913,7 +1327,7 @@ function launchWithWindowsTerminal(options) {
     // Pre-generate session name so dashboard can start immediately
     const sessionName = options.session || (0, state_1.uuidToWords)(crypto.randomUUID());
     // Write session hint immediately
-    writeSessionFiles(crypto.randomUUID(), sessionName);
+    writeSessionFiles(crypto.randomUUID(), sessionName, getClaudeSessionMetadata(options));
     // Build ekkos run args WITHOUT --dashboard (prevent recursion)
     // Always pass -s so run reuses the same session name we gave the dashboard
     const runArgs = ['run', '-s', sessionName];
@@ -929,6 +1343,15 @@ function launchWithWindowsTerminal(options) {
         runArgs.push('--skip-inject');
     if (options.noProxy)
         runArgs.push('--skip-proxy');
+    if (options.continueLast)
+        runArgs.push('--continue-last');
+    if (options.resumeSession)
+        runArgs.push('--resume-session', options.resumeSession);
+    if (typeof options.model === 'string')
+        runArgs.push('--model', options.model);
+    if (options.contextWindow && options.contextWindow !== 'auto') {
+        runArgs.push('--context-window', options.contextWindow);
+    }
     // Write a temp batch file to avoid all quoting issues
     // wt.exe doesn't resolve PATH for npm global bins — must use `cmd /c`
     const batPath = path.join(os.tmpdir(), `ekkos-wt-${Date.now()}.cmd`);
@@ -976,6 +1399,14 @@ async function run(options) {
     const verbose = options.verbose || false;
     const bypass = options.bypass || false;
     const noInject = options.noInject || false;
+    const suppressPreClaudeOutput = process.env.EKKOS_NO_SPLASH === '1';
+    const launchSelection = await resolveClaudeLaunchSelection(options);
+    options.model = launchSelection.model;
+    options.contextWindow = launchSelection.contextWindow;
+    options.continueLast = launchSelection.continueLast;
+    options.resumeSession = launchSelection.resumeSession;
+    runtimeClaudeLaunchModel = launchSelection.model;
+    runtimeClaudeContextWindow = launchSelection.contextWindow;
     // Honour -s flag: lock the session name before getEkkosEnv() can mint a new one.
     // This is critical for --dashboard mode where launchWithDashboard() pre-generates
     // a session name and passes it via -s so the dashboard and run command agree.
@@ -986,11 +1417,28 @@ async function run(options) {
     // Set proxy mode based on options (used by getEkkosEnv)
     proxyModeEnabled = !(options.noProxy || false);
     if (proxyModeEnabled) {
-        console.log(chalk_1.default.cyan('  🧠 ekkOS_Continuum Loaded!'));
+        if (!suppressPreClaudeOutput && !options.pulse) {
+            console.log(chalk_1.default.cyan('  🧠 ekkOS_Continuum Loaded!'));
+        }
     }
-    else if (verbose) {
+    else if (verbose && !suppressPreClaudeOutput) {
         console.log(chalk_1.default.yellow('  ⏭️  API proxy disabled (--no-proxy)'));
     }
+    let pulseIntroShown = false;
+    if (options.pulse
+        && process.env.EKKOS_REMOTE_SESSION !== '1'
+        && process.env.EKKOS_NO_SPLASH !== '1'
+        && process.stdout.isTTY === true) {
+        await showPulseLaunchLoader({
+            model: options.model,
+            contextWindow: options.contextWindow,
+            continueLast: options.continueLast,
+            resumeSession: options.resumeSession,
+            bypass: options.bypass,
+            verbose: options.verbose,
+        });
+        pulseIntroShown = true;
+    }
     // ══════════════════════════════════════════════════════════════════════════
     // DASHBOARD MODE: Launch via tmux (Unix) or Windows Terminal split pane
     // ══════════════════════════════════════════════════════════════════════════
@@ -1079,11 +1527,22 @@ async function run(options) {
     const isNpxMode = rawClaudePath.startsWith('npx:');
     const pinnedVersion = isNpxMode ? rawClaudePath.split(':')[1] : null;
     const claudePath = isNpxMode ? 'npx' : rawClaudePath;
+    runtimeClaudeCodeVersion = pinnedVersion || getClaudeVersion(claudePath);
     // Build args early
     const earlyArgs = [];
     if (isNpxMode) {
         earlyArgs.push(`@anthropic-ai/claude-code@${pinnedVersion}`);
     }
+    if (options.resumeSession) {
+        earlyArgs.push('--resume', options.resumeSession);
+    }
+    else if (options.continueLast) {
+        earlyArgs.push('--continue');
+    }
+    const launchModelArg = buildClaudeLaunchModelArg(options.model, options.contextWindow);
+    if (launchModelArg) {
+        earlyArgs.push('--model', launchModelArg);
+    }
     if (bypass) {
         earlyArgs.push('--dangerously-skip-permissions');
     }
@@ -1146,7 +1605,7 @@ async function run(options) {
     // ══════════════════════════════════════════════════════════════════════════
     // STARTUP BANNER WITH COLOR PULSE ANIMATION
     // ══════════════════════════════════════════════════════════════════════════
-    const skipFancyIntro = process.env.EKKOS_REMOTE_SESSION === '1' || process.env.EKKOS_NO_SPLASH === '1' || !!process.env.TMUX;
+    const skipFancyIntro = pulseIntroShown || process.env.EKKOS_REMOTE_SESSION === '1' || suppressPreClaudeOutput || !!process.env.TMUX;
     if (!skipFancyIntro) {
         const logoLines = [
             '                      ▄▄▄▄▄    ▄▄▄▄▄▄▄     ▄▄▄ ▄▄ ▄▄',
@@ -1328,7 +1787,7 @@ async function run(options) {
         }
         console.log('');
     }
-    else {
+    else if (!suppressPreClaudeOutput) {
         // Static banner for Windows / remote / no-splash — no cursor manipulation
         console.log('');
         console.log(chalk_1.default.hex('#FF6B35').bold('  ekkOS_Pulse') + chalk_1.default.gray('  —  Context is finite. Intelligence isn\'t.'));
@@ -1344,7 +1803,9 @@ async function run(options) {
     // ══════════════════════════════════════════════════════════════════════════
     // MAGIC MOMENT: Morning dreams right after sparkle, before Claude appears
     // ══════════════════════════════════════════════════════════════════════════
-    await showMorningDreamsIfNeeded();
+    if (!suppressPreClaudeOutput && !options.pulse) {
+        await showMorningDreamsIfNeeded();
+    }
     // ══════════════════════════════════════════════════════════════════════════
     // ANIMATION COMPLETE: Mark ready and flush buffered Claude output
     // ══════════════════════════════════════════════════════════════════════════
@@ -1381,8 +1842,8 @@ async function run(options) {
     // ════════════════════════════════════════════════════════════════════════════
     const initialSessionId = cliSessionId || 'pending';
     const initialSessionName = currentSession || 'initializing';
-    (0, state_1.registerActiveSession)(initialSessionId, initialSessionName, process.cwd());
-    writeSessionFiles(initialSessionId, initialSessionName);
+    (0, state_1.registerActiveSession)(initialSessionId, initialSessionName, process.cwd(), getClaudeSessionMetadata(options));
+    writeSessionFiles(initialSessionId, initialSessionName, getClaudeSessionMetadata(options));
     dlog(`Registered active session (PID ${process.pid})`);
     // Show active sessions count if verbose
     if (verbose) {
@@ -1549,9 +2010,9 @@ async function run(options) {
                     // and shown in "Continuum Loaded". Re-deriving from JSONL UUID produces a
                     // different name since Claude Code's UUID ≠ the CLI-generated UUID.
                     currentSession = cliSessionName || (0, state_1.uuidToWords)(sessionId);
-                    (0, state_1.updateCurrentProcessSession)(currentSessionId, currentSession);
+                    (0, state_1.updateCurrentProcessSession)(currentSessionId, currentSession, getClaudeSessionMetadata(options));
                     (0, state_1.updateState)({ sessionId: currentSessionId, sessionName: currentSession });
-                    writeSessionFiles(currentSessionId, currentSession);
+                    writeSessionFiles(currentSessionId, currentSession, getClaudeSessionMetadata(options));
                     bindRealSessionToProxy(currentSession, 'fast-transcript', currentSessionId);
                     dlog(`[TRANSCRIPT] FAST DETECT: New transcript found! ${fullPath}`);
                     evictionDebugLog('TRANSCRIPT_SET', 'Fast poll detected new file', {
@@ -1835,9 +2296,21 @@ async function run(options) {
     }
     if (verbose) {
         // Show Claude version
-        const ccVersion = pinnedVersion || PINNED_CLAUDE_VERSION;
+        const ccVersion = runtimeClaudeCodeVersion || pinnedVersion || PINNED_CLAUDE_VERSION;
         const versionStr = `Claude Code v${ccVersion}`;
         console.log(chalk_1.default.gray(`  🤖 ${versionStr}`));
+        if (options.model) {
+            console.log(chalk_1.default.gray(`  🧩 Model: ${buildClaudeLaunchModelArg(options.model, options.contextWindow)}`));
+        }
+        if (options.contextWindow && options.contextWindow !== 'auto') {
+            console.log(chalk_1.default.gray(`  🪟 Context: ${options.contextWindow}`));
+        }
+        if (options.continueLast) {
+            console.log(chalk_1.default.gray('  ↩ Continue: most recent Claude conversation'));
+        }
+        if (options.resumeSession) {
+            console.log(chalk_1.default.gray(`  ↪ Resume: ${options.resumeSession}`));
+        }
         if (currentSession) {
             console.log(chalk_1.default.green(`  📍 Session: ${currentSession}`));
         }
@@ -2433,10 +2906,10 @@ async function run(options) {
             // Keep cliSessionName if set (proxy mode) — JSONL UUID differs from CLI UUID
             currentSession = cliSessionName || (0, state_1.uuidToWords)(currentSessionId);
             // Update THIS process's session entry (not global state.json)
-            (0, state_1.updateCurrentProcessSession)(currentSessionId, currentSession);
+            (0, state_1.updateCurrentProcessSession)(currentSessionId, currentSession, getClaudeSessionMetadata(options));
             // Also update global state for backwards compatibility
             (0, state_1.updateState)({ sessionId: currentSessionId, sessionName: currentSession });
-            writeSessionFiles(currentSessionId, currentSession);
+            writeSessionFiles(currentSessionId, currentSession, getClaudeSessionMetadata(options));
             dlog(`Session detected from UUID: ${currentSession}`);
             resolveTranscriptFromSessionId('session-id-from-output');
             bindRealSessionToProxy(currentSession, 'session-id-from-output', currentSessionId || undefined);
@@ -2469,10 +2942,10 @@ async function run(options) {
                     currentSession = lastSeenSessionName;
                     observedSessionThisRun = true; // Mark that we've seen a session in THIS process
                     // Update THIS process's session entry (not global state.json)
-                    (0, state_1.updateCurrentProcessSession)(currentSessionId || 'unknown', currentSession);
+                    (0, state_1.updateCurrentProcessSession)(currentSessionId || 'unknown', currentSession, getClaudeSessionMetadata(options));
                     // Also update global state for backwards compatibility
                     (0, state_1.updateState)({ sessionName: currentSession });
-                    writeSessionFiles(currentSessionId || 'unknown', currentSession);
+                    writeSessionFiles(currentSessionId || 'unknown', currentSession, getClaudeSessionMetadata(options));
                     dlog(`Session detected from status line: ${currentSession} (observedSessionThisRun=true)`);
                     bindRealSessionToProxy(currentSession, 'status-line', currentSessionId || undefined);
                     resolveTranscriptFromSessionId('status-line');