neoctl 0.1.4 → 0.1.6

package/dist/repl/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import fs from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { stdin, stdout } from "node:process";
 import React, { useCallback, useEffect, useRef, useState } from "react";
@@ -7,13 +8,12 @@ import { Box, Static, Text, render, useApp, useInput } from "ink";
 import stripAnsi from "strip-ansi";
 import wrapAnsi from "wrap-ansi";
 import { QueryEngine } from "../core/query-engine.js";
-import { loadDefaultDotEnvFiles } from "../model/env.js";
+import { getUserDotEnvPath, loadDefaultDotEnvFiles } from "../model/env.js";
 import { readModelProviderConfig } from "../model/config.js";
-import { loadModelCatalog, reasoningEffortsForModel, resolveContextWindowTokens } from "../model/context-window.js";
+import { findModelMetadata, loadModelCatalog, reasoningEffortsForModel, resolveContextWindowTokens } from "../model/context-window.js";
 import { CommunicationLogger, LoggingModelGateway } from "../model/communication-logger.js";
-import { createModelGatewayFromProcessEnv } from "../model/provider-factory.js";
+import { createModelGatewayFromConfig, createModelGatewayFromProcessEnv } from "../model/provider-factory.js";
 import { ToolRegistry } from "../tools/registry.js";
-import { echoTool } from "../tools/builtins/echo-tool.js";
 import { editTool, writeTool } from "../tools/builtins/edit-tool.js";
 import { createExecTool } from "../tools/builtins/exec-tool.js";
 import { listDirectoryTool, readFileTool } from "../tools/builtins/filesystem-tools.js";
@@ -25,6 +25,7 @@ import { createTaskTools } from "../tasks/task-tools.js";
 import { TaskStore } from "../tasks/task-store.js";
 import { isModelReasoningArgument, isValidReplCommandLine, parseReplCommand, helpText, replCommandDefinitions } from "./commands.js";
 import { estimateMarkdownLineCount, markdownRenderKey, MarkdownText } from "./markdown-renderer.js";
+import { writeSessionMarkdownExport } from "../session/session-export.js";
 import { readClipboard } from "./clipboard.js";
 const e = React.createElement;
 class SessionUsageTracker {
@@ -114,7 +115,6 @@ async function createRuntime() {
     const modelGateway = new LoggingModelGateway(createModelGatewayFromProcessEnv(process.env), communicationLogger);
     const taskStore = new TaskStore();
     const tools = new ToolRegistry();
-    tools.register(echoTool);
     tools.register(editTool);
     tools.register(writeTool);
     tools.register(createExecTool({ taskStore }));
@@ -145,6 +145,7 @@ async function createRuntime() {
         modelGateway,
         tools,
         taskNotificationSource,
+        commands: replCommandDefinitions.map((command) => command.usage),
         session: {
             enabled: process.env.AGENT_SESSION_TRANSCRIPT !== "0",
             sessionId: process.env.AGENT_SESSION_ID,
@@ -156,18 +157,22 @@ async function createRuntime() {
         },
     });
     await engine.initialize();
+    const initialMetrics = await engine.contextMetrics();
     return {
         engine,
         communicationLogger,
+        modelGateway,
+        agentRuntime,
         usage: new SessionUsageTracker(),
         taskStore,
-        initialMetrics: initialContextMetrics(modelConfig?.model, engine.snapshot().messages, tools.names().length),
+        initialMetrics,
         defaultReasoning: modelConfig?.defaultReasoning,
+        envPath: process.env.NEO_ENV_FILE?.trim() ? path.resolve(process.env.NEO_ENV_FILE.trim()) : envLoad.userDotEnvPath,
         envNotice: envLoad.createdUserDotEnv ? formatCreatedEnvNotice(envLoad.userDotEnvPath) : undefined,
     };
 }
 function formatCreatedEnvNotice(path) {
-    return `Created default config file: ${path}\nFill MODEL_API_KEY in that file, then restart neo.`;
+    return `Created default config file: ${path}\nSet MODEL_PROVIDER and the matching provider section (for example OPENAI_API_KEY), then restart neo.`;
 }
 function parseResumeFlag(value) {
     if (!value)
@@ -198,23 +203,25 @@ function initialContextMetrics(model, messageCount, toolCount) {
             : undefined,
     };
 }
-function initialStatus(runtime) {
+function initialStatus(runtime, metrics = runtime.initialMetrics) {
     return {
         phase: "ready",
         metrics: {
-            ...runtime.initialMetrics,
+            ...metrics,
             messageCount: runtime.engine.snapshot().messages,
         },
         streamedOutputTokens: 0,
         activityTick: 0,
     };
 }
-function setTerminalTitle(title, dotFilled = true) {
+function resetStatus(runtime) {
+    return initialStatus(runtime, initialContextMetrics(runtime.engine.getModelSettings().model, runtime.engine.snapshot().messages, runtime.initialMetrics.toolCount));
+}
+function setTerminalTitle(title, prefix = TERMINAL_TITLE_WORKING_PREFIX) {
     if (!stdout.isTTY)
         return;
     const safeTitle = title.replace(/[\u0000-\u001f\u007f]+/g, " ").replace(/\s+/g, " ").trim();
-    const dotPrefix = dotFilled ? TERMINAL_TITLE_DOT_FILLED_PREFIX : TERMINAL_TITLE_DOT_BLANK_PREFIX;
-    const decoratedTitle = `${dotPrefix}${safeTitle || "neo"}`.slice(0, 120);
+    const decoratedTitle = `${prefix}${safeTitle || "neo"}`.slice(0, 120);
     stdout.write(`\u001b]0;${decoratedTitle}\u0007`);
 }
 function playReadySound() {
@@ -359,7 +366,7 @@ function InkRepl({ runtime }) {
     const sessionTitleRef = useRef(sessionTerminalTitle(runtime.engine.snapshot().session));
     const [backgroundTaskCount, setBackgroundTaskCount] = useState(() => runtime.taskStore.activeCount());
     const [animationTick, setAnimationTick] = useState(0);
-    const [terminalTitleDotVisible, setTerminalTitleDotVisible] = useState(true);
+    const [terminalTitlePrefix, setTerminalTitlePrefix] = useState(TERMINAL_TITLE_READY_PREFIX);
     const terminalTitleWorking = isActivePhase(status.phase) || backgroundTaskCount > 0;
     const [sessionsBrowser, setSessionsBrowser] = useState(undefined);
     const inputRef = useRef(input);
@@ -377,6 +384,8 @@ function InkRepl({ runtime }) {
     const [pasteStatus, setPasteStatus] = useState(undefined);
     const pasteStatusTimerRef = useRef(undefined);
     const [slashCompletionIndex, setSlashCompletionIndex] = useState(0);
+    const [loginForm, setLoginForm] = useState(undefined);
+    const loginFormRef = useRef(undefined);
     useEffect(() => {
         enableTerminalFocusReporting();
         enableTerminalMouseReporting();
@@ -398,24 +407,23 @@ function InkRepl({ runtime }) {
     }, [runtime]);
     useEffect(() => {
         if (!terminalTitleWorking) {
-            setTerminalTitleDotVisible(true);
+            setTerminalTitlePrefix(TERMINAL_TITLE_READY_PREFIX);
             return undefined;
         }
-        setTerminalTitleDotVisible(true);
-        const interval = setInterval(() => setTerminalTitleDotVisible((visible) => !visible), TERMINAL_TITLE_BLINK_INTERVAL_MS);
-        return () => clearInterval(interval);
+        setTerminalTitlePrefix(TERMINAL_TITLE_WORKING_PREFIX);
+        return undefined;
     }, [terminalTitleWorking]);
     useEffect(() => {
         const updateTitle = (snapshot) => {
             sessionTitleRef.current = sessionTerminalTitle(snapshot);
-            setTerminalTitle(sessionTitleRef.current, terminalTitleDotVisible);
+            setTerminalTitle(sessionTitleRef.current, terminalTitlePrefix);
         };
         updateTitle(runtime.engine.snapshot().session);
         return runtime.engine.onSessionTitleChange(updateTitle);
-    }, [runtime, terminalTitleDotVisible]);
+    }, [runtime, terminalTitlePrefix]);
     useEffect(() => {
-        setTerminalTitle(sessionTitleRef.current, terminalTitleDotVisible);
-    }, [terminalTitleDotVisible]);
+        setTerminalTitle(sessionTitleRef.current, terminalTitlePrefix);
+    }, [terminalTitlePrefix]);
     const setPromptState = (text, nextCursor, options) => {
         const safeCursor = Math.max(0, Math.min(nextCursor, text.length));
         inputRef.current = text;
@@ -442,6 +450,10 @@ function InkRepl({ runtime }) {
         setSlashCompletionIndex(safeIndex);
     };
     const resetSlashCompletionSelection = () => setSlashCompletionSelection(0);
+    const setLoginFormState = (next) => {
+        loginFormRef.current = next;
+        setLoginForm(next);
+    };
     const syncAttachmentsForText = (text) => {
         const next = attachmentsRef.current.filter((attachment) => text.includes(attachment.label));
         if (next.length === attachmentsRef.current.length)
@@ -486,6 +498,10 @@ function InkRepl({ runtime }) {
                 return;
             }
             if (payload.type === "image") {
+                if (!runtime.engine.canAcceptImageInput()) {
+                    setPasteStatusMessage("current model does not support image input; image was not added");
+                    return;
+                }
                 const id = ++imageAttachmentCounterRef.current;
                 insertAttachmentLabel({ id, kind: "image", label: `[img#${id}]`, image: payload.image });
                 setPasteStatusMessage(undefined);
@@ -538,9 +554,9 @@ function InkRepl({ runtime }) {
     const replaceLine = (id, patch) => {
         setLines((current) => current.map((line) => line.id === id ? { ...line, ...patch, renderedKey: undefined } : line));
     };
-    const resumeSnapshot = (snapshot) => {
+    const resumeSnapshot = (snapshot, metrics) => {
         runtime.usage.reset();
-        setStatus(initialStatus(runtime));
+        setStatus(initialStatus(runtime, metrics));
         resetLinesToHistory(runtime, setLines, lineId);
         assistantLineId.current = undefined;
         thinkingLineId.current = undefined;
@@ -693,6 +709,10 @@ function InkRepl({ runtime }) {
         const trimmed = text.trim();
         if (!trimmed)
             return;
+        if (submitAttachments.some((attachment) => attachment.kind === "image") && !runtime.engine.canAcceptImageInput()) {
+            append({ kind: "error", text: "Current model does not support image input; image attachments were not added to the conversation." });
+            return;
+        }
         if (busyRef.current) {
             if (queuedInputRef.current !== undefined)
                 return;
@@ -798,7 +818,7 @@ function InkRepl({ runtime }) {
         if (command.type === "reset") {
             runtime.engine.reset();
             runtime.usage.reset();
-            setStatus(initialStatus(runtime));
+            setStatus(resetStatus(runtime));
             append(systemLine("transcript reset"));
             return;
         }
@@ -806,18 +826,53 @@ function InkRepl({ runtime }) {
             append(systemLine(formatReplData({ ...runtime.engine.snapshot(), communicationLog: runtime.communicationLogger.snapshot() }, 12000), EXPANDED_SUMMARY_MAX_LINES));
             return;
         }
+        if (command.type === "export") {
+            setBusyState(true);
+            setStatus((current) => ({ ...current, phase: "running", detail: "exporting session", activityTick: current.activityTick + 1 }));
+            try {
+                const line = await handleExportCommand(command, runtime);
+                append(line);
+            }
+            catch (error) {
+                append({ kind: "error", text: error instanceof Error ? error.message : String(error) });
+            }
+            finally {
+                setBusyState(false);
+                setStatus((current) => ({ ...current, phase: "ready", detail: undefined, activityTick: current.activityTick + 1 }));
+            }
+            return;
+        }
         if (command.type === "sessions") {
             await handleSessionsCommand(runtime, setSessionsBrowser, (line) => append(line));
             return;
         }
+        if (command.type === "login") {
+            setSessionsBrowser(undefined);
+            setLoginFormState(createLoginFormState(runtime.envPath));
+            append(systemLine("Opening provider login. Use ↑/↓ to choose, Enter to continue/save, Esc to cancel."));
+            return;
+        }
         if (command.type === "log") {
             await handleLogCommand(command, runtime, append);
             return;
         }
         if (command.type === "model") {
-            const line = handleModelCommand(command, runtime);
-            setStatus((current) => ({ ...current, metrics: { ...initialContextMetrics(runtime.engine.getModelSettings().model, runtime.engine.snapshot().messages, runtime.initialMetrics.toolCount), messageCount: runtime.engine.snapshot().messages } }));
-            append(line);
+            setBusyState(true);
+            setStatus((current) => ({ ...current, phase: "running", detail: "saving model settings", activityTick: current.activityTick + 1 }));
+            try {
+                const line = await handleModelCommand(command, runtime);
+                setStatus((current) => ({
+                    ...current,
+                    phase: "ready",
+                    detail: undefined,
+                    metrics: { ...initialContextMetrics(runtime.engine.getModelSettings().model, runtime.engine.snapshot().messages, runtime.initialMetrics.toolCount), messageCount: runtime.engine.snapshot().messages },
+                    activityTick: current.activityTick + 1,
+                }));
+                append(line);
+            }
+            finally {
+                setBusyState(false);
+            }
             return;
         }
         if (text.trimStart().startsWith("/")) {
@@ -825,6 +880,10 @@ function InkRepl({ runtime }) {
             return;
         }
         const promptPayload = buildPromptPayload(command.text, submitAttachments);
+        if (promptPayload.blocks?.some((block) => block.type === "image") && !runtime.engine.canAcceptImageInput()) {
+            append({ kind: "error", text: "Current model does not support image input; image attachments were not added to the conversation." });
+            return;
+        }
         append({ kind: "user", text });
         const abortController = new AbortController();
         activeAbortController.current = abortController;
@@ -888,6 +947,7 @@ function InkRepl({ runtime }) {
         clearPendingToolResultTimers();
         setStatus(initialStatus(runtime));
         setSessionsBrowser(undefined);
+        setLoginFormState(undefined);
         setQueuedPromptState(undefined);
         setPromptState("", 0);
     }, [runtime]);
@@ -897,7 +957,7 @@ function InkRepl({ runtime }) {
     const prompt = promptPrefix(busy);
     const promptDisplayText = input.length === 0 && promptPlaceholder ? promptPlaceholder : input;
     const promptDisplayCursor = input.length === 0 && promptPlaceholder ? promptPlaceholder.length : cursor;
-    const slashCompletions = inputLockedByQueue || promptPlaceholder ? [] : slashCommandCompletions(input, cursor);
+    const slashCompletions = inputLockedByQueue || promptPlaceholder || loginForm ? [] : slashCommandCompletions(input, cursor);
     const visibleSlashCompletionCount = slashCompletions.length;
     const selectedSlashCompletionIndex = visibleSlashCompletionCount === 0
         ? 0
@@ -915,7 +975,8 @@ function InkRepl({ runtime }) {
     }, 0);
     const statusRenderRows = STATUS_BAR_RENDER_ROWS + (backgroundTaskCount > 0 ? BACKGROUND_TASK_STATUS_RENDER_ROWS : 0);
     const sessionsBrowserHeight = sessionsBrowser ? sessionsBrowserViewHeight(sessionsBrowser) : 0;
-    const liveViewportLines = Math.max(MIN_LIVE_VIEWPORT_LINES, terminalSize.rows - promptHeight - statusRenderRows - sessionsBrowserHeight - dynamicMarginOverhead - 1);
+    const loginFormHeight = loginForm ? loginFormViewHeight(loginForm) : 0;
+    const liveViewportLines = Math.max(MIN_LIVE_VIEWPORT_LINES, terminalSize.rows - promptHeight - statusRenderRows - sessionsBrowserHeight - loginFormHeight - dynamicMarginOverhead - 1);
     useInput((value, key) => {
         if (isTerminalFocusInSequence(value)) {
             terminalFocusedRef.current = true;
@@ -963,6 +1024,10 @@ function InkRepl({ runtime }) {
                 restoreQueuedPromptToEditor();
             return;
         }
+        if (loginFormRef.current) {
+            handleLoginFormInput(value, key, loginFormRef.current, setLoginFormState, runtime, append, setStatus);
+            return;
+        }
         if (sessionsBrowser) {
             if (key.escape) {
                 setSessionsBrowser(undefined);
@@ -988,9 +1053,9 @@ function InkRepl({ runtime }) {
                 const selected = sessionsBrowser.sessions[sessionAbsoluteIndex(sessionsBrowser)];
                 if (selected) {
                     setSessionsBrowser(undefined);
-                    void handleResumeCommand(selected.sessionId, runtime, (line) => append(line)).then((resumed) => {
-                        if (resumed)
-                            resumeSnapshot(resumed);
+                    void handleResumeCommand(selected.sessionId, runtime, (line) => append(line)).then((result) => {
+                        if (result)
+                            resumeSnapshot(result.snapshot, result.metrics);
                     });
                 }
                 return;
@@ -1102,7 +1167,7 @@ function InkRepl({ runtime }) {
             insertAtCursor(value);
         }
     });
-    return e(Box, { flexDirection: "column" }, e((Static), { items: staticLines, children: (line, index) => e(MessageBlock, { key: line.id, line, width, blockIndex: index }) }), e(MessageList, { lines: dynamicLines, width, liveMaxLines: liveViewportLines, lineIndexOffset: staticLines.length, onMarkdownRenderComplete: markLineRendered }), sessionsBrowser ? e(SessionsBrowser, { state: sessionsBrowser, width }) : null, e(StatusBar, { status, animationTick, width }), backgroundTaskCount > 0 ? e(BackgroundTaskStatusLine, { count: backgroundTaskCount, width }) : null, pasteStatus ? e(PasteStatusLine, { text: pasteStatus, width }) : null, queuedInput !== undefined ? e(QueuedInputLine, { text: queuedInput, width }) : null, e(PromptLine, { text: promptDisplayText, cursor: promptDisplayCursor, busy, locked: inputLockedByQueue, placeholder: input.length === 0 && promptPlaceholder !== undefined, width, prompt, slashCompletions, selectedSlashCompletionIndex, attachments }));
+    return e(Box, { flexDirection: "column" }, e((Static), { items: staticLines, children: (line, index) => e(MessageBlock, { key: line.id, line, width, blockIndex: index }) }), e(MessageList, { lines: dynamicLines, width, liveMaxLines: liveViewportLines, lineIndexOffset: staticLines.length, onMarkdownRenderComplete: markLineRendered }), sessionsBrowser ? e(SessionsBrowser, { state: sessionsBrowser, width }) : null, loginForm ? e(LoginFormView, { state: loginForm, width }) : null, e(StatusBar, { status, animationTick, width }), backgroundTaskCount > 0 ? e(BackgroundTaskStatusLine, { count: backgroundTaskCount, width }) : null, pasteStatus ? e(PasteStatusLine, { text: pasteStatus, width }) : null, queuedInput !== undefined ? e(QueuedInputLine, { text: queuedInput, width }) : null, e(PromptLine, { text: promptDisplayText, cursor: promptDisplayCursor, busy, locked: inputLockedByQueue, placeholder: input.length === 0 && promptPlaceholder !== undefined, width, prompt, slashCompletions, selectedSlashCompletionIndex, attachments }));
 }
 const MessageList = React.memo(function MessageList({ lines, width, liveMaxLines, lineIndexOffset = 0, onMarkdownRenderComplete }) {
     const contentWidth = messageContentWidth(width);
@@ -1678,17 +1743,40 @@ function SlashCompletionLines({ completions, width, prompt, selectedIndex }) {
         e(Text, { key: "slash-completion-footer", color: "gray" }, fitToWidth(footer, contentWidth)),
     ].map((line, index) => e(Box, { key: `slash-completion-line-${index}`, height: 1, overflow: "hidden" }, e(Text, { color: "gray" }, " ".repeat(prompt.length)), line));
 }
-function handleModelCommand(command, runtime) {
+async function handleModelCommand(command, runtime) {
     const current = runtime.engine.getModelSettings();
     const nextModel = command.model ?? current.model;
     const validationError = validateModelReasoningArgument(nextModel, command.reasoning);
     if (validationError)
         return { kind: "error", text: validationError };
     const reasoningUpdate = resolveModelReasoningUpdate(command.reasoning, current.reasoning, nextModel, command.model !== undefined);
-    if (command.model !== undefined || command.reasoning !== undefined) {
+    const changed = command.model !== undefined || command.reasoning !== undefined;
+    if (changed) {
         runtime.engine.setModel(nextModel, reasoningUpdate.reasoning, reasoningUpdate.update);
+        try {
+            const { providerChanged } = await persistModelCommandSettings(runtime, command, reasoningUpdate);
+            if (providerChanged) {
+                const config = readModelProviderConfig(process.env);
+                if (config) {
+                    const innerGateway = createModelGatewayFromConfig(config);
+                    runtime.modelGateway.setInner(innerGateway);
+                    runtime.agentRuntime.modelGateway = runtime.modelGateway;
+                    runtime.engine.setModelProvider({
+                        modelGateway: runtime.modelGateway,
+                        model: config.model,
+                        fallbackModel: config.fallbackModel,
+                        reasoning: config.defaultReasoning,
+                    });
+                    runtime.defaultReasoning = config.defaultReasoning;
+                }
+            }
+        }
+        catch (error) {
+            return { kind: "error", text: `Model settings changed for this session, but saving to ${runtime.envPath} failed: ${error instanceof Error ? error.message : String(error)}` };
+        }
     }
-    return systemLine(formatModelSettings(runtime.engine.getModelSettings(), runtime.defaultReasoning));
+    const settings = formatModelSettings(runtime.engine.getModelSettings(), runtime.defaultReasoning);
+    return systemLine(changed ? `${settings}\nSaved to ${runtime.envPath}` : settings);
 }
 function resolveModelReasoningUpdate(value, current, modelId, modelChanged) {
     if (value === "off")
@@ -1702,6 +1790,58 @@ function resolveModelReasoningUpdate(value, current, modelId, modelChanged) {
     }
     return { reasoning: current, update: false };
 }
+async function persistModelCommandSettings(runtime, command, reasoningUpdate) {
+    const currentProvider = currentModelProvider();
+    let targetProvider = currentProvider;
+    const updates = {};
+    if (command.model !== undefined) {
+        const metadata = findModelMetadata(command.model);
+        if (metadata) {
+            const modelProvider = parseLoginProvider(metadata.provider);
+            if (modelProvider) {
+                targetProvider = modelProvider;
+                if (targetProvider !== currentProvider)
+                    updates.MODEL_PROVIDER = targetProvider;
+            }
+        }
+        updates[modelEnvKeyForProvider(targetProvider)] = command.model.trim() || undefined;
+    }
+    if (command.reasoning !== undefined || reasoningUpdate.update) {
+        updates.MODEL_REASONING_EFFORT = envValueForReasoning(reasoningUpdate.reasoning);
+        updates.MODEL_REASONING_SUMMARY = undefined;
+    }
+    if (Object.keys(updates).length === 0)
+        return { providerChanged: false };
+    await writeEnvUpdates(runtime.envPath, updates);
+    applyEnvUpdatesToProcess(updates);
+    runtime.defaultReasoning = reasoningUpdate.update ? reasoningUpdate.reasoning : runtime.defaultReasoning;
+    return { providerChanged: targetProvider !== currentProvider };
+}
+function currentModelProvider() {
+    return parseLoginProvider(process.env.MODEL_PROVIDER) ?? "openai";
+}
+function modelEnvKeyForProvider(provider) {
+    return provider === "deepseek" ? "DEEPSEEK_MODEL" : "OPENAI_MODEL";
+}
+function envValueForReasoning(reasoning) {
+    if (reasoning === null)
+        return "off";
+    return reasoning?.effort;
+}
+async function writeEnvUpdates(envPath, updates, removeKeys = []) {
+    await fs.mkdir(path.dirname(envPath), { recursive: true });
+    const existing = existsSync(envPath) ? readFileSync(envPath, "utf8") : "";
+    const next = updateEnvContent(existing, updates, removeKeys);
+    await fs.writeFile(envPath, next, "utf8");
+}
+function applyEnvUpdatesToProcess(updates) {
+    for (const [key, value] of Object.entries(updates)) {
+        if (value === undefined)
+            delete process.env[key];
+        else
+            process.env[key] = value;
+    }
+}
 function validateModelReasoningArgument(modelId, reasoning) {
     if (!reasoning || reasoning === "default" || reasoning === "off")
         return undefined;
@@ -1933,9 +2073,25 @@ async function handleSessionsCommand(runtime, setBrowser, append) {
     }
     setBrowser({ sessions, pageSize: SESSIONS_DEFAULT_PAGE_SIZE, pageIndex: 0, selectedIndex: 0 });
 }
+async function handleExportCommand(command, runtime) {
+    const snapshot = runtime.engine.snapshot();
+    if (!snapshot.session)
+        throw new Error("session transcripts are disabled; cannot export current session");
+    const promptSnapshot = await runtime.engine.promptExportSnapshot();
+    const result = await writeSessionMarkdownExport({
+        outputPath: command.path,
+        session: snapshot.session,
+        agentId: snapshot.agentId,
+        promptSnapshot,
+        engineSnapshot: { ...snapshot, communicationLog: runtime.communicationLogger.snapshot(), usage: runtime.usage.snapshot() },
+    });
+    return systemLine(`Exported current session to ${result.outputPath}\nEntries: ${result.entries}\nMessages: ${result.messages}\nBytes: ${result.bytes}`);
+}
 async function handleResumeCommand(sessionId, runtime, append) {
     try {
-        return await runtime.engine.resumeSession(sessionId);
+        const snapshot = await runtime.engine.resumeSession(sessionId);
+        const metrics = await runtime.engine.contextMetrics();
+        return { snapshot, metrics };
     }
     catch (error) {
         append({ kind: "error", text: error instanceof Error ? error.message : String(error) });
@@ -1999,6 +2155,52 @@ function restoredHistoryLines(runtime) {
     }
     return lines;
 }
+const LOGIN_PROVIDERS = ["openai", "deepseek"];
+const SHARED_LOGIN_FIELDS = [
+    { key: "reasoningEffort", label: "Reasoning effort", envKey: "MODEL_REASONING_EFFORT", scope: "shared", options: ["", "off", "none", "minimal", "low", "medium", "high", "xhigh", "max"] },
+    { key: "reasoningSummary", label: "Reasoning summary", envKey: "MODEL_REASONING_SUMMARY", scope: "shared", options: ["", "auto", "concise", "detailed"] },
+    { key: "maxOutputTokens", label: "Max output tokens", envKey: "MODEL_MAX_OUTPUT_TOKENS", scope: "shared", placeholder: "800" },
+    { key: "timeoutMs", label: "Timeout ms", envKey: "MODEL_TIMEOUT_MS", scope: "shared", placeholder: "120000" },
+    { key: "streamIdleTimeoutMs", label: "Stream idle timeout ms", envKey: "MODEL_STREAM_IDLE_TIMEOUT_MS", scope: "shared", placeholder: "120000" },
+    { key: "maxRetries", label: "Max retries", envKey: "MODEL_MAX_RETRIES", scope: "shared", placeholder: "2" },
+];
+const LOGIN_FIELD_DEFINITIONS = {
+    openai: [
+        { key: "apiKey", label: "API key", envKey: "OPENAI_API_KEY", scope: "provider", required: true, secret: true, placeholder: "sk-..." },
+        { key: "baseUrl", label: "Base URL", envKey: "OPENAI_BASE_URL", scope: "provider", placeholder: "https://api.openai.com" },
+        { key: "model", label: "Model", envKey: "OPENAI_MODEL", scope: "provider", required: true, placeholder: "gpt-5.5" },
+        { key: "fallbackModel", label: "Fallback model", envKey: "OPENAI_FALLBACK_MODEL", scope: "provider" },
+        { key: "endpoint", label: "Endpoint", envKey: "OPENAI_ENDPOINT", scope: "provider", placeholder: "auto", options: ["auto", "responses", "chat"] },
+        ...SHARED_LOGIN_FIELDS,
+    ],
+    deepseek: [
+        { key: "apiKey", label: "API key", envKey: "DEEPSEEK_API_KEY", scope: "provider", required: true, secret: true, placeholder: "sk-..." },
+        { key: "baseUrl", label: "Base URL", envKey: "DEEPSEEK_BASE_URL", scope: "provider", placeholder: "https://api.deepseek.com" },
+        { key: "model", label: "Model", envKey: "DEEPSEEK_MODEL", scope: "provider", required: true, placeholder: "deepseek-chat" },
+        { key: "fallbackModel", label: "Fallback model", envKey: "DEEPSEEK_FALLBACK_MODEL", scope: "provider" },
+        ...SHARED_LOGIN_FIELDS,
+    ],
+};
+const DEPRECATED_MODEL_ENV_KEYS = [
+    "MODEL_API_KEY",
+    "MODEL_BASE_URL",
+    "MODEL_ID",
+    "MODEL_FALLBACK_ID",
+    "MODEL_ENDPOINT",
+    "OPENAI_PROVIDER",
+    "OPENAI_REASONING_EFFORT",
+    "OPENAI_REASONING_SUMMARY",
+    "OPENAI_MAX_OUTPUT_TOKENS",
+    "OPENAI_TIMEOUT_MS",
+    "OPENAI_STREAM_IDLE_TIMEOUT_MS",
+    "OPENAI_MAX_RETRIES",
+    "DEEPSEEK_REASONING_EFFORT",
+    "DEEPSEEK_REASONING_SUMMARY",
+    "DEEPSEEK_MAX_OUTPUT_TOKENS",
+    "DEEPSEEK_TIMEOUT_MS",
+    "DEEPSEEK_STREAM_IDLE_TIMEOUT_MS",
+    "DEEPSEEK_MAX_RETRIES",
+];
 function sessionsPageCount(state) {
     return Math.max(1, Math.ceil(state.sessions.length / state.pageSize));
 }
@@ -2048,6 +2250,307 @@ function SessionsBrowser({ state, width }) {
         }, row.numberPrefix), row.rest);
     }), e(Text, { color: "gray" }, fitToWidth(footer, contentWidth)));
 }
+function handleLoginFormInput(value, key, state, setLoginFormState, runtime, append, setStatus) {
+    if (key.escape) {
+        if (state.step === "fields")
+            setLoginFormState({ ...state, step: "provider" });
+        else {
+            setLoginFormState(undefined);
+            append(systemLine("Login cancelled."));
+        }
+        return;
+    }
+    if (state.step === "provider") {
+        if (key.upArrow) {
+            setLoginFormState(moveLoginProviderSelection(state, -1));
+            return;
+        }
+        if (key.downArrow) {
+            setLoginFormState(moveLoginProviderSelection(state, 1));
+            return;
+        }
+        if (key.return) {
+            const provider = state.providers[state.selectedProviderIndex] ?? state.provider;
+            setLoginFormState({ ...loginFormForProvider(provider, state.envPath), step: "fields" });
+            return;
+        }
+        return;
+    }
+    const fields = LOGIN_FIELD_DEFINITIONS[state.provider];
+    const field = fields[state.selectedFieldIndex];
+    if (!field)
+        return;
+    if (key.upArrow) {
+        setLoginFormState(moveLoginFieldSelection(state, -1));
+        return;
+    }
+    if (key.downArrow) {
+        setLoginFormState(moveLoginFieldSelection(state, 1));
+        return;
+    }
+    if (key.leftArrow) {
+        setLoginFormState({ ...state, cursor: Math.max(0, state.cursor - 1) });
+        return;
+    }
+    if (key.rightArrow) {
+        const current = state.values[field.key] ?? "";
+        setLoginFormState({ ...state, cursor: Math.min(current.length, state.cursor + 1) });
+        return;
+    }
+    if (key.tab && field.options?.length) {
+        setLoginFormState(cycleLoginFieldOption(state, field));
+        return;
+    }
+    if (key.backspace || key.delete) {
+        setLoginFormState(deleteLoginFieldCharacter(state, field));
+        return;
+    }
+    if (key.return) {
+        void submitLoginForm(state, runtime, append, setLoginFormState, setStatus);
+        return;
+    }
+    if (value && !key.ctrl && !key.meta) {
+        setLoginFormState(insertLoginFieldText(state, field, value));
+    }
+}
+function moveLoginProviderSelection(state, delta) {
+    const selectedProviderIndex = (state.selectedProviderIndex + delta + state.providers.length) % state.providers.length;
+    return { ...state, selectedProviderIndex, provider: state.providers[selectedProviderIndex] ?? state.provider };
+}
+function moveLoginFieldSelection(state, delta) {
+    const fields = LOGIN_FIELD_DEFINITIONS[state.provider];
+    const selectedFieldIndex = (state.selectedFieldIndex + delta + fields.length) % fields.length;
+    const field = fields[selectedFieldIndex];
+    return { ...state, selectedFieldIndex, cursor: field ? (state.values[field.key] ?? "").length : 0 };
+}
+function cycleLoginFieldOption(state, field) {
+    const options = field.options ?? [];
+    const current = state.values[field.key] ?? "";
+    const index = options.indexOf(current);
+    const next = options[(index + 1 + options.length) % options.length] ?? "";
+    return { ...state, values: { ...state.values, [field.key]: next }, cursor: next.length };
+}
+function insertLoginFieldText(state, field, value) {
+    const current = state.values[field.key] ?? "";
+    const cursor = Math.max(0, Math.min(state.cursor, current.length));
+    const next = `${current.slice(0, cursor)}${value}${current.slice(cursor)}`;
+    return { ...state, values: { ...state.values, [field.key]: next }, cursor: cursor + value.length };
+}
+function deleteLoginFieldCharacter(state, field) {
+    const current = state.values[field.key] ?? "";
+    const cursor = Math.max(0, Math.min(state.cursor, current.length));
+    if (cursor <= 0)
+        return state;
+    const next = `${current.slice(0, cursor - 1)}${current.slice(cursor)}`;
+    return { ...state, values: { ...state.values, [field.key]: next }, cursor: cursor - 1 };
+}
+async function submitLoginForm(state, runtime, append, setLoginFormState, setStatus) {
+    const validationError = validateLoginForm(state);
+    if (validationError) {
+        append({ kind: "error", text: validationError });
+        return;
+    }
+    try {
+        await saveLoginFormToEnv(state);
+        applyLoginFormToProcessEnv(state);
+        const config = readModelProviderConfig(process.env);
+        if (!config)
+            throw new Error("Saved provider config could not be loaded from environment.");
+        const innerGateway = createModelGatewayFromConfig(config);
+        runtime.modelGateway.setInner(innerGateway);
+        runtime.agentRuntime.modelGateway = runtime.modelGateway;
+        runtime.engine.setModelProvider({
+            modelGateway: runtime.modelGateway,
+            model: config.model,
+            fallbackModel: config.fallbackModel,
+            reasoning: config.defaultReasoning,
+        });
+        runtime.defaultReasoning = config.defaultReasoning;
+        setStatus((current) => ({
+            ...current,
+            metrics: { ...initialContextMetrics(config.model, runtime.engine.snapshot().messages, runtime.initialMetrics.toolCount), messageCount: runtime.engine.snapshot().messages },
+        }));
+        setLoginFormState(undefined);
+        append(systemLine(`Saved ${state.provider} login to ${state.envPath}\n${formatModelSettings(runtime.engine.getModelSettings(), runtime.defaultReasoning)}`, EXPANDED_SUMMARY_MAX_LINES));
+    }
+    catch (error) {
+        append({ kind: "error", text: `Login save failed: ${error instanceof Error ? error.message : String(error)}` });
+    }
+}
+function validateLoginForm(state) {
+    for (const field of LOGIN_FIELD_DEFINITIONS[state.provider]) {
+        const value = (state.values[field.key] ?? "").trim();
+        if (field.required && !value)
+            return `${field.label} is required.`;
+        if (field.options?.length && value && !field.options.includes(value))
+            return `${field.label} must be one of: ${field.options.filter(Boolean).join(", ")}`;
+    }
+    for (const fieldKey of ["maxOutputTokens", "timeoutMs", "streamIdleTimeoutMs", "maxRetries"]) {
+        const value = state.values[fieldKey]?.trim();
+        if (value && !Number.isFinite(Number(value)))
+            return `${fieldKey} must be a number.`;
+    }
+    return undefined;
+}
+function createLoginFormState(envPath = getUserDotEnvPath()) {
+    const env = parseEnvFileSafe(envPath);
+    const currentProvider = parseLoginProvider(env.MODEL_PROVIDER ?? process.env.MODEL_PROVIDER) ?? ((env.DEEPSEEK_API_KEY ?? process.env.DEEPSEEK_API_KEY) ? "deepseek" : "openai");
+    return loginFormForProvider(currentProvider, envPath, env);
+}
+function loginFormForProvider(provider, envPath, env = parseEnvFileSafe(envPath)) {
+    const selectedProviderIndex = Math.max(0, LOGIN_PROVIDERS.indexOf(provider));
+    return {
+        step: "provider",
+        providers: LOGIN_PROVIDERS,
+        selectedProviderIndex,
+        provider,
+        selectedFieldIndex: 0,
+        cursor: 0,
+        values: loginValuesForProvider(provider, env),
+        envPath,
+    };
+}
+function loginValuesForProvider(provider, env) {
+    const values = {};
+    for (const field of LOGIN_FIELD_DEFINITIONS[provider]) {
+        values[field.key] = env[field.envKey] ?? "";
+    }
+    if (!values.baseUrl)
+        values.baseUrl = provider === "deepseek" ? "https://api.deepseek.com" : "https://api.openai.com";
+    if (!values.model)
+        values.model = provider === "deepseek" ? "deepseek-chat" : "gpt-5.5";
+    if (provider === "openai" && !values.endpoint)
+        values.endpoint = "auto";
+    return values;
+}
+function parseLoginProvider(value) {
+    if (value === "openai" || value === "deepseek")
+        return value;
+    return undefined;
+}
+function loginFormViewHeight(state) {
+    return state.step === "provider" ? state.providers.length + 3 : LOGIN_FIELD_DEFINITIONS[state.provider].length + 4;
+}
+function LoginFormView({ state, width }) {
+    const contentWidth = Math.max(30, width);
+    if (state.step === "provider") {
+        return e(Box, { flexDirection: "column", marginTop: 1 }, e(Text, { color: "cyan", bold: true }, fitToWidth(`Login: choose provider · saving to ${state.envPath}`, contentWidth)), ...state.providers.map((provider, index) => e(Text, { key: provider, color: "white" }, e(Text, { color: index === state.selectedProviderIndex ? "black" : "white", backgroundColor: index === state.selectedProviderIndex ? "cyan" : undefined }, `${index + 1}.`.padStart(3)), e(Text, { color: "gray" }, " "), e(Text, { color: "cyan" }, provider))), e(Text, { color: "gray" }, fitToWidth("↑/↓ select · Enter edit config · Esc close", contentWidth)));
+    }
+    const fields = LOGIN_FIELD_DEFINITIONS[state.provider];
+    const maxLabel = Math.max(...fields.map((field) => field.label.length));
+    return e(Box, { flexDirection: "column", marginTop: 1 }, e(Text, { color: "cyan", bold: true }, fitToWidth(`Login: ${state.provider} · ${state.envPath}`, contentWidth)), ...fields.map((field, index) => {
+        const selected = index === state.selectedFieldIndex;
+        const rawValue = state.values[field.key] ?? "";
+        const visibleValue = formatLoginFieldValue(field, rawValue, selected ? state.cursor : undefined);
+        const placeholder = rawValue ? "" : (field.placeholder ? ` (${field.placeholder})` : "");
+        return e(Text, { key: field.key, color: "white" }, e(Text, { color: selected ? "black" : "white", backgroundColor: selected ? "cyan" : undefined }, `${index + 1}.`.padStart(3)), e(Text, { color: field.required ? "yellow" : "gray" }, ` ${field.label.padEnd(maxLabel)} `), e(Text, { color: field.scope === "shared" ? "blue" : "gray" }, field.scope === "shared" ? "shared " : "provider "), e(Text, { color: rawValue ? "white" : "gray" }, fitToWidth(`${visibleValue}${placeholder}`, Math.max(8, contentWidth - maxLabel - 14))));
+    }), e(Text, { color: "gray" }, fitToWidth("↑/↓ field · ←/→ cursor · type edit · Tab cycle choices · Enter save · Esc back/cancel", contentWidth)), e(Text, { color: "gray" }, fitToWidth("Provider fields save as OPENAI_* / DEEPSEEK_*; shared runtime fields save as MODEL_*.", contentWidth)));
+}
+function formatLoginFieldValue(field, value, cursor) {
+    const display = field.secret && value ? "•".repeat(Math.min(value.length, 24)) : value;
+    if (cursor === undefined)
+        return display;
+    const safeCursor = Math.max(0, Math.min(cursor, display.length));
+    const selected = display[safeCursor] ?? " ";
+    return `${display.slice(0, safeCursor)}█${selected === " " ? "" : display.slice(safeCursor + 1)}`;
+}
+function applyLoginFormToProcessEnv(state) {
+    applyEnvUpdatesToProcess(envEntriesForLoginForm(state));
+    for (const key of DEPRECATED_MODEL_ENV_KEYS)
+        delete process.env[key];
+}
+async function saveLoginFormToEnv(state) {
+    await writeEnvUpdates(state.envPath, envEntriesForLoginForm(state), DEPRECATED_MODEL_ENV_KEYS);
+}
+function envEntriesForLoginForm(state) {
+    const entries = {
+        MODEL_PROVIDER: state.provider,
+    };
+    for (const field of LOGIN_FIELD_DEFINITIONS[state.provider]) {
+        const value = (state.values[field.key] ?? "").trim();
+        entries[field.envKey] = value || undefined;
+    }
+    return entries;
+}
+function updateEnvContent(content, updates, removeKeys = []) {
+    const keys = new Set(Object.keys(updates));
+    const removals = new Set(removeKeys);
+    const seen = new Set();
+    const lines = content ? content.split(/\r?\n/) : [];
+    const updatedLines = lines.map((line) => {
+        const parsed = parseEnvLine(line);
+        if (!parsed)
+            return line;
+        if (removals.has(parsed.key) && !keys.has(parsed.key))
+            return undefined;
+        if (!keys.has(parsed.key))
+            return line;
+        seen.add(parsed.key);
+        const value = updates[parsed.key];
+        if (value === undefined)
+            return undefined;
+        return `${parsed.key}=${quoteEnvValue(value)}`;
+    }).filter((line) => line !== undefined);
+    const missing = Object.entries(updates).filter((entry) => !seen.has(entry[0]) && entry[1] !== undefined);
+    if (missing.length > 0) {
+        const grouped = groupLoginEnvEntries(missing);
+        appendEnvGroup(updatedLines, "# Neo active provider", grouped.active);
+        appendEnvGroup(updatedLines, "# OpenAI provider settings", grouped.openai);
+        appendEnvGroup(updatedLines, "# DeepSeek provider settings", grouped.deepseek);
+        appendEnvGroup(updatedLines, "# Shared model runtime settings", grouped.shared);
+    }
+    return `${updatedLines.join("\n").replace(/\n*$/u, "")}\n`;
+}
+function groupLoginEnvEntries(entries) {
+    return {
+        active: entries.filter(([key]) => key === "MODEL_PROVIDER"),
+        openai: entries.filter(([key]) => key.startsWith("OPENAI_")),
+        deepseek: entries.filter(([key]) => key.startsWith("DEEPSEEK_")),
+        shared: entries.filter(([key]) => key.startsWith("MODEL_") && key !== "MODEL_PROVIDER"),
+    };
+}
+function appendEnvGroup(lines, header, entries) {
+    if (entries.length === 0)
+        return;
+    if (lines.length > 0 && lines[lines.length - 1]?.trim())
+        lines.push("");
+    lines.push(header);
+    for (const [key, value] of entries)
+        lines.push(`${key}=${quoteEnvValue(value)}`);
+}
+function parseEnvFileSafe(envPath) {
+    if (!existsSync(envPath))
+        return {};
+    const env = {};
+    for (const line of readFileSync(envPath, "utf8").split(/\r?\n/)) {
+        const parsed = parseEnvLine(line);
+        if (parsed)
+            env[parsed.key] = stripEnvQuotes(parsed.value.trim());
+    }
+    return env;
+}
+function parseEnvLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#"))
+        return undefined;
+    const separator = trimmed.indexOf("=");
+    if (separator <= 0)
+        return undefined;
+    const key = trimmed.slice(0, separator).trim();
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
+        return undefined;
+    return { key, value: trimmed.slice(separator + 1) };
+}
+function quoteEnvValue(value) {
+    if (/^[A-Za-z0-9_./:@+-]*$/.test(value))
+        return value;
+    return JSON.stringify(value);
+}
+function stripEnvQuotes(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'")))
+        return value.slice(1, -1);
+    return value;
+}
 function formatSessionBrowserRow(session, absoluteIndex, width) {
     const numberPrefix = `${absoluteIndex + 1}.`.padStart(4);
     const title = session.title?.trim() || "(untitled)";
@@ -2900,9 +3403,8 @@ function isFullWidthCodePoint(codePoint) {
         (codePoint >= 0x20000 && codePoint <= 0x3fffd)));
 }
 const SESSIONS_DEFAULT_PAGE_SIZE = 10;
-const TERMINAL_TITLE_DOT_FILLED_PREFIX = "● ";
-const TERMINAL_TITLE_DOT_BLANK_PREFIX = "  ";
-const TERMINAL_TITLE_BLINK_INTERVAL_MS = 1000;
+const TERMINAL_TITLE_WORKING_PREFIX = "● ";
+const TERMINAL_TITLE_READY_PREFIX = "✓ ";
 const REPL_ANIMATION_INTERVAL_MS = 420;
 const TOOL_RESULT_REPLACEMENT_DELAY_MS = 2000;
 const TOKEN_PULSE_MS = 900;