@hopper-agent/cli 0.1.0 → 0.2.1

package/dist/src/cli.js

@@ -9,10 +9,10 @@ import { resolve, basename, isAbsolute, join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
 const __filename = fileURLToPath(import.meta.url);
-import { ChatSurface, handleSlashCommand } from '@hopper-agent/tui';
+import { ChatSurface, handleSlashCommand, COLD_START_BANNER } from '@hopper-agent/tui';
 import { getTheme } from '@hopper-agent/render';
 import { TurnLoop, SettingsManager, DEFAULT_SETTINGS, CronManager, TelegramGateway, ChannelRegistry, ChannelRouter, HeartbeatExecutor, HeartbeatDelivery, pickNextSchedule, scheduleLabel } from '@hopper-agent/core';
-import { AnthropicProvider, OpenAIProvider } from '@hopper-agent/providers';
+import { AnthropicProvider, OpenAIProvider, OllamaProvider, GoogleGeminiProvider } from '@hopper-agent/providers';
 import { allTools } from '@hopper-agent/tools';
 import { createMcpTools } from '@hopper-agent/mcp';
 const VERSION = '0.5.1';
@@ -140,7 +140,8 @@ Usage:
   hopper-agent                              Interactive TUI
   hopper-agent "<prompt>"                   One-shot prompt
   hopper-agent -p "<prompt>"                Headless mode, stdout answer
-  hopper-agent resume [<id>]                Resume session
+  hopper-agent resume                       Resume last session
+  hopper-agent resume <id>                  Resume specific session
   hopper-agent sessions list|show|rm        Session management
   hopper-agent --version                    Show version
 
@@ -398,7 +399,15 @@ function formatDuration(ms) {
     const s = String(totalSeconds % 60).padStart(2, '0');
     return `${h}:${m}:${s}`;
 }
-function estimateCost(model, inputTokens, outputTokens) {
+function estimateCost(model, inputTokens, outputTokens, customCost) {
+    if (customCost) {
+        const parts = customCost.split(';').map(Number);
+        const inC = parts[0];
+        const outC = parts[1];
+        if (inC !== undefined && outC !== undefined && !isNaN(inC) && !isNaN(outC)) {
+            return (inputTokens * inC + outputTokens * outC) / 1_000_000;
+        }
+    }
     // Rough per-million-token pricing in USD; fall back to Sonnet rates.
     const pricing = {
         'claude-opus': { in: 15, out: 75 },
@@ -409,10 +418,14 @@ function estimateCost(model, inputTokens, outputTokens) {
     const p = pricing[key];
     return (inputTokens * p.in + outputTokens * p.out) / 1_000_000;
 }
-function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeName, system, settings, projects, cronManager: externalCronManager, onReminderHolder, telegramChatIdRef, telegramSubmitRef, telegramGateway, channelRegistry, channelRouter, activeChannelRef, mcpToolsRef, mcpClientsRef, onMcpReconnect, contextWindowSize }) {
+function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeName, system, settings, projects, cronManager: externalCronManager, onReminderHolder, telegramChatIdRef, telegramSubmitRef, telegramGateway, channelRegistry, channelRouter, activeChannelRef, mcpToolsRef, mcpClientsRef, onMcpReconnect, contextWindowSize, resumeSession, resumeSessionId }) {
     const [messages, setMessages] = useState([]);
     // Multi-channel: per-channel message storage (keyed by channel ID)
-    const [channelMessages, setChannelMessages] = useState({});
+    // 'main' channel starts with the cold-start banner as the first message so it
+    // scrolls naturally with the conversation rather than being pinned to a header.
+    const [channelMessages, setChannelMessages] = useState({
+        main: [{ role: 'assistant', content: COLD_START_BANNER }],
+    });
     const [activeChannelId, setActiveChannelId] = useState('main');
     // Per-channel TurnLoop instances
     const channelTurnLoopsRef = useRef(new Map());
@@ -431,6 +444,9 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
     const [status, setStatus] = useState('idle');
     const startedAt = useRef(Date.now());
     const loopRef = useRef(null);
+    // Persist TurnLoop messages across turns so slash commands can read them
+    // even when loopRef.current is cleared (mode change, provider change, etc.)
+    const sessionMessagesRef = useRef([]);
     const busyRef = useRef(false);
     const toolGroupIndexRef = useRef(null);
     const planFileRef = useRef(null);
@@ -516,7 +532,7 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
         return () => clearInterval(id);
     }, []);
     const theme = getTheme(currentTheme);
-    const applySlashResult = useCallback((result, agentPrompt) => {
+    const applySlashResult = useCallback(async (result, agentPrompt) => {
         const push = (content) => {
             // Slash command results must go to the per-channel messages array
             // since that's what the ChatSurface renders.
@@ -548,6 +564,14 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
                 settingsMgr.current.update({ model: result.model });
                 push(result.message);
                 break;
+            case 'update_model_cost':
+                settingsMgr.current.update({ MODEL_COST: result.modelCost });
+                push(result.message);
+                break;
+            case 'update_context_window':
+                settingsMgr.current.update({ MODEL_CONTEXT_WINDOW: result.contextWindow });
+                push(result.message);
+                break;
             case 'update_provider': {
                 const newProvider = result.provider;
                 settingsMgr.current.update({ MODEL_PROVIDER: newProvider });
@@ -803,9 +827,141 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
                 push(result.message ?? 'Switched to Stats tab');
                 break;
             }
+            case 'compact': {
+                const compact = result.compact;
+                const { messages, depth } = compact;
+                const originalSystem = currentSystem;
+                if (!streamProviderHolder.current?.complete) {
+                    push('Compaction requires a provider that supports the complete() method.');
+                    return;
+                }
+                // Build compaction prompt based on depth
+                const conversationText = messages.map(m => {
+                    if (m.role === 'user')
+                        return `USER: ${m.content}`;
+                    if (m.role === 'assistant')
+                        return `ASSISTANT: ${m.content.map((b) => {
+                            if (b.type === 'text')
+                                return b.text;
+                            if (b.type === 'thinking')
+                                return b.thinking;
+                            if (b.type === 'tool-use')
+                                return `[tool: ${b.name}(${JSON.stringify(b.input).slice(0, 100)})]`;
+                            return '';
+                        }).join('\n')}`;
+                    if (m.role === 'tool')
+                        return `TOOL RESULT (${m.toolUseId}): ${m.content.slice(0, 500)}`;
+                    return '';
+                }).join('\n');
+                const compactionPrompt = depth === 'brief'
+                    ? `You are compacting a conversation between a user and an AI coding agent.
+Your job is to reduce the conversation to a single meaningful turn.
+
+RULES:
+- Reduce to approximately 2-4 messages (1 user request + 1-3 assistant/tool responses)
+- Keep the FIRST user message (session intent)
+- Keep the LAST user message (current intent)
+- For assistant messages: keep only text that contains decisions, findings, or key facts
+- For tool calls: keep only tool name + brief input — no need for full output
+- For tool results: keep only if the output was critical to a decision (≤200 chars)
+
+OUTPUT FORMAT:
+Respond ONLY with a valid JSON array of Message objects. Use this exact format:
+
+[{"role":"user","content":"User message text"},
+{"role":"assistant","content":[{"type":"text","text":"Assistant response"}]},
+{"role":"assistant","content":[{"type":"tool-use","id":"tu_1","name":"Read","input":{"path":"main.py"}}]},
+{"role":"tool","toolUseId":"tu_1","content":"Tool output text"}]
+
+CRITICAL: Output ONLY the JSON array. No markdown, no explanation, no code fences.`
+                    : `You are compacting a conversation between a user and an AI coding agent.
+Your job is to reduce the conversation size while preserving all important context.
+
+RULES:
+- Reduce to approximately 50% of the original message count
+- Keep ALL user messages (they define the intent)
+- For assistant messages with tool calls: keep the tool name and a brief description of what it did, but truncate long outputs
+- For assistant text: keep full content unless very long (>200 chars), then summarize
+- For tool results: if >500 chars, keep the first 300 chars + "[truncated, N chars total]"
+- NEVER drop entire turns — always keep at least one response per user message
+
+OUTPUT FORMAT:
+Respond ONLY with a valid JSON array of Message objects. Use this exact format:
+
+[{"role":"user","content":"User message text"},
+{"role":"assistant","content":[{"type":"text","text":"Assistant response"}]},
+{"role":"assistant","content":[{"type":"thinking","thinking":"thinking text","signature":"sig"}]},
+{"role":"assistant","content":[{"type":"tool-use","id":"tu_1","name":"Read","input":{"path":"main.py"}}]},
+{"role":"tool","toolUseId":"tu_1","content":"Tool output text"}]
+
+Each message has: role, content (string for user/tool, array for assistant).
+Assistant blocks: {type:"text",text:"..."} | {type:"thinking",thinking:"...",signature:"..."} | {type:"tool-use",id:"...",name:"...",input:{...}}
+
+CRITICAL: Output ONLY the JSON array. No markdown, no explanation, no code fences.`;
+                try {
+                    const provider = streamProviderHolder.current;
+                    const completeResult = await provider.complete({
+                        messages: messages,
+                        system: compactionPrompt,
+                        tools: [],
+                        model: currentModel,
+                    });
+                    if (!completeResult.text) {
+                        push('Compaction failed: no compacted messages generated.');
+                        return;
+                    }
+                    // Try to extract JSON from the response (LLM may add explanation text)
+                    let jsonStr = completeResult.text.trim();
+                    const firstBracket = jsonStr.indexOf('[');
+                    const lastBracket = jsonStr.lastIndexOf(']');
+                    if (firstBracket >= 0 && lastBracket > firstBracket) {
+                        jsonStr = jsonStr.slice(firstBracket, lastBracket + 1);
+                    }
+                    // Parse and validate the compacted messages
+                    let compactedMessages;
+                    try {
+                        compactedMessages = JSON.parse(jsonStr);
+                        if (!Array.isArray(compactedMessages) || compactedMessages.length === 0) {
+                            push('Compaction failed: invalid response format.');
+                            return;
+                        }
+                    }
+                    catch {
+                        push('Compaction failed: could not parse compacted messages. The model did not return valid JSON.');
+                        return;
+                    }
+                    // Build summary for display: extract any non-JSON text or generate a brief summary
+                    const summaryText = `Compacted conversation to ${compactedMessages.length} messages (${depth}).\nThe agent will continue with the condensed context.`;
+                    // Build new system prompt: original system + compacted messages summary
+                    const compactedText = compactedMessages.map((m) => {
+                        if (m.role === 'user')
+                            return `USER: ${m.content}`;
+                        if (m.role === 'assistant')
+                            return `ASSISTANT: ${m.content.map((b) => (b.type === 'text' ? b.text : '')).join('\n')}`;
+                        if (m.role === 'tool')
+                            return `TOOL RESULT (${m.toolUseId}): ${m.content}`;
+                        return '';
+                    }).join('\n');
+                    const newSystem = originalSystem + '\n\n# Conversation Summary\n\n' + compactedText;
+                    // Null out old loop so next turn creates fresh loop with compacted state
+                    loopRef.current = null;
+                    // Update state
+                    setCurrentSystem(newSystem);
+                    sessionMessagesRef.current = compactedMessages;
+                    setChannelMessages((prev) => ({
+                        ...prev,
+                        [activeChannelId]: compactedMessages,
+                    }));
+                    push(summaryText);
+                }
+                catch (err) {
+                    push(`Compaction failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                break;
+            }
         }
     }, []);
-    const onSlashCommand = useCallback((input) => {
+    const onSlashCommand = useCallback(async (input) => {
         // Echo the submitted slash command as a user message so the transcript
         // shows what the user typed alongside the assistant's reply.
         const echoed = input.args ? `/${input.command} ${input.args}` : `/${input.command}`;
@@ -823,13 +979,15 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
             cwd: currentCwd,
             inputTokens,
             outputTokens,
+            messages: loopRef.current?.getMessages() ?? sessionMessagesRef.current,
+            channelMessages: channelMessages[activeChannelId],
             cronManager: cronManagerRef.current ?? undefined,
             mcpClients: mcpClientsRef.current,
             contextWindowSize: contextWindowSize ?? 200_000,
             thinkingBudget: ({ low: 2000, medium: 6000, high: 16000, max: 32000, auto: 0 })[currentEffort ?? 'auto'] ?? 0,
         };
         const result = handleSlashCommand(input.command, input.args, ctx);
-        applySlashResult(result, input.args);
+        await applySlashResult(result, input.args);
         // Spawn external agent subprocess after the slash command result is applied.
         if (result.type === 'start_agent' && result.agentId) {
             const agentId = result.agentId;
@@ -938,20 +1096,26 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
                     '2': { name: 'openrouter', key: 'OPENROUTER_API_KEY', url: 'OPENROUTER_URL' },
                     '3': { name: 'openai', key: 'OPENAI_API_KEY', url: 'OPENAI_URL' },
                     '4': { name: 'anthropic', key: 'ANTHROPIC_API_KEY', url: 'ANTHROPIC_URL' },
+                    '5': { name: 'google', key: 'GOOGLE_API_KEY', url: 'GOOGLE_URL' },
+                    '6': { name: 'ollama', key: 'MODEL_API_KEY', url: 'MODEL_URL' },
                 };
                 const entry = providerMap[choice];
                 if (!entry) {
-                    setChannelMessages((prev) => ({ ...prev, [targetChannel]: [...(prev[targetChannel] || []), { role: 'assistant', content: 'Invalid choice. Please enter 1-4.\n  1) local\n  2) openrouter\n  3) openai\n  4) anthropic' }] }));
-                    setMessages((prev) => [...prev, { role: 'assistant', content: 'Invalid choice. Please enter 1-4.\n  1) local\n  2) openrouter\n  3) openai\n  4) anthropic' }]);
+                    setChannelMessages((prev) => ({ ...prev, [targetChannel]: [...(prev[targetChannel] || []), { role: 'assistant', content: 'Invalid choice. Please enter 1-6.\n  1) local\n  2) openrouter\n  3) openai\n  4) anthropic\n  5) google\n  6) ollama' }] }));
+                    setMessages((prev) => [...prev, { role: 'assistant', content: 'Invalid choice. Please enter 1-6.\n  1) local\n  2) openrouter\n  3) openai\n  4) anthropic\n  5) google\n  6) ollama' }]);
                     return;
                 }
                 const updates = { MODEL_PROVIDER: entry.name };
                 updates[entry.key] = '';
-                updates[entry.url] = entry.name === 'openrouter' ? 'https://openrouter.ai/api' : `https://api.${entry.name}.com/v1`;
+                updates[entry.url] = entry.name === 'openrouter' ? 'https://openrouter.ai/api'
+                    : entry.name === 'anthropic' ? 'https://api.anthropic.com'
+                        : entry.name === 'google' ? 'https://generativelanguage.googleapis.com/v1beta'
+                            : `https://api.${entry.name}.com/v1`;
                 settingsMgr.current.update(updates);
-                if (entry.name === 'local') {
-                    wizardRef.current = { phase: 'apiKey', provider: entry.name };
-                    pushToChannel(targetChannel, `${entry.name}: Enter your API key:`);
+                if (entry.name === 'ollama') {
+                    // Ollama doesn't need API key — skip to URL
+                    wizardRef.current = { phase: 'url', provider: entry.name };
+                    pushToChannel(targetChannel, `${entry.name}: What is your Ollama API URL?\n  Default: http://localhost:11434/v1\n  (Press Enter for default):`);
                 }
                 else {
                     wizardRef.current = { phase: 'apiKey', provider: entry.name };
@@ -960,15 +1124,25 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
                 return;
             }
             if (wizard.phase === 'apiKey') {
-                const keyName = wizard.provider === 'local' ? 'MODEL_API_KEY'
+                const keyName = wizard.provider === 'local' || wizard.provider === 'ollama' ? 'MODEL_API_KEY'
                     : wizard.provider === 'openrouter' ? 'OPENROUTER_API_KEY'
                         : wizard.provider === 'openai' ? 'OPENAI_API_KEY'
-                            : 'ANTHROPIC_API_KEY';
+                            : wizard.provider === 'google' ? 'GOOGLE_API_KEY'
+                                : 'ANTHROPIC_API_KEY';
                 settingsMgr.current.update({ [keyName]: input });
                 if (wizard.provider === 'local') {
                     wizardRef.current = { phase: 'url', provider: wizard.provider };
                     pushToChannel(targetChannel, `API key configured.\nWhat is your local API URL?\n  Default: http://localhost:8080/v1\n  (Press Enter for default):`);
                 }
+                else if (wizard.provider === 'ollama') {
+                    settingsMgr.current.update({ MODEL_URL: 'http://localhost:11434/v1' });
+                    wizardRef.current = { phase: 'model', provider: wizard.provider };
+                    pushToChannel(targetChannel, `URL configured: http://localhost:11434/v1\nWhich model do you want to use?\n  Examples: llama3.3, mistral, phi3, qwen2.5\n  Enter model name:`);
+                }
+                else if (wizard.provider === 'google') {
+                    wizardRef.current = { phase: 'model', provider: wizard.provider };
+                    pushToChannel(targetChannel, `API key configured.\nWhich model do you want to use?\n  Examples: gemini-2.5-flash, gemini-2.5-pro, gemini-2.0-flash\n  Enter model name:`);
+                }
                 else {
                     wizardRef.current = { phase: 'model', provider: wizard.provider };
                     pushToChannel(targetChannel, `API key configured.\nWhich model do you want to use?\n  Examples: claude-sonnet-4-6, gpt-4o, o1, llama-3.1-405b\n  Enter model name:`);
@@ -976,10 +1150,14 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
                 return;
             }
             if (wizard.phase === 'url') {
-                const url = input || 'http://localhost:8080/v1';
+                const defaultUrl = wizard.provider === 'ollama' ? 'http://localhost:11434/v1' : 'http://localhost:8080/v1';
+                const url = input || defaultUrl;
                 settingsMgr.current.update({ MODEL_URL: url });
+                const modelExamples = wizard.provider === 'ollama'
+                    ? 'llama3.3, mistral, phi3, qwen2.5'
+                    : 'claude-sonnet-4-6, gpt-4o, o1, llama-3.1-405b';
                 wizardRef.current = { phase: 'model', provider: wizard.provider };
-                pushToChannel(targetChannel, `URL configured: ${url}\nWhich model do you want to use?\n  Examples: claude-sonnet-4-6, gpt-4o, o1, llama-3.1-405b\n  Enter model name:`);
+                pushToChannel(targetChannel, `URL configured: ${url}\nWhich model do you want to use?\n  Examples: ${modelExamples}\n  Enter model name:`);
                 return;
             }
             if (wizard.phase === 'model') {
@@ -1054,6 +1232,8 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
                 effort: currentEffort,
                 system: currentSystem + buildModePreamble(currentMode, currentCwd),
                 sessionId: channel?.sessionId,
+                resume: resumeSession,
+                resumeSessionId: resumeSessionId,
                 onApprovalAsk: (req) => new Promise((resolve) => {
                     setPendingApproval({
                         toolName: req.name,
@@ -1080,6 +1260,7 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
             });
             channelTurnLoops.set(targetChannel, loop);
         }
+        loopRef.current = loop;
         const channelMsgs = channelMessages[targetChannel] || [];
         setChannelMessages((prev) => ({
             ...prev,
@@ -1143,6 +1324,16 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
                     globalThis.__hopperSessionId = e.id;
                 }
             }),
+            loop.eventBus.subscribe('session-resumed', (e) => {
+                if (e.type === 'session-resumed' && e.turnsRecovered > 0) {
+                    const bannerText = `Context restored: ${e.turnsRecovered} turn(s) from session ${e.id}`;
+                    setMessages(prev => [...prev, { role: 'system', content: bannerText }]);
+                    setChannelMessages((prev) => ({
+                        ...prev,
+                        [targetChannel]: [...(prev[targetChannel] || []), { role: 'system', content: bannerText }],
+                    }));
+                }
+            }),
             loop.eventBus.subscribe('usage', (e) => {
                 if (e.type === 'usage') {
                     setInputTokens(e.inputTokens);
@@ -1232,9 +1423,12 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
             if (runResult) {
                 channelRegistry.updateSession(targetChannel, runResult.sessionId);
             }
+            // Persist full TurnLoop messages for slash commands (e.g. /context messages)
+            sessionMessagesRef.current = loop.getMessages();
             unsubs.forEach(u => u());
             toolGroupIndexRef.current = null;
             busyRef.current = false;
+            loopRef.current = null;
             setStatus('idle');
             // Route response back to Telegram if this is a Telegram channel
             const telegramChatId = channelRouter.getTelegramChatId(targetChannel);
@@ -1416,7 +1610,7 @@ function App({ provider, streamProviderHolder, model, approvalMode, cwd, themeNa
         setMessages(prev => [...prev, { role: 'system', content: `Active project switched to ${p.label} (${p.projectPath})` }]);
     }, []);
     const project = basename(currentCwd);
-    const cost = estimateCost(currentModel, inputTokens ?? 0, outputTokens ?? 0);
+    const cost = estimateCost(currentModel, inputTokens ?? 0, outputTokens ?? 0, settingsMgr.current?.get().MODEL_COST);
     // Build channel entries for the Channels tab
     const channelList = channelRegistry.list();
     const channelTabEntries = channelList.map(ch => ({
@@ -1448,7 +1642,7 @@ function createProvider(settings) {
             process.env.OPENAI_API_KEY ||
             '';
         const openaiUrl = (typeof settings.OPENAI_URL === 'string' ? settings.OPENAI_URL.trim() : '') ||
-            process.env.OPENAI_BASE_URL ||
+            process.env.OPENAI_URL ||
             '';
         if (!openaiKey) {
             console.error('hopper-agent: no OpenAI API key configured.\n' +
@@ -1473,31 +1667,47 @@ function createProvider(settings) {
         const p = new AnthropicProvider(orKey, orUrl);
         return { name: 'openrouter', stream: p.stream.bind(p), check: p.check.bind(p) };
     }
-    if (providerName === 'local') {
-        const localKey = (typeof settings.MODEL_API_KEY === 'string' ? settings.MODEL_API_KEY.trim() : '') ||
+    if (providerName === 'ollama' || providerName === 'local') {
+        const key = (typeof settings.MODEL_API_KEY === 'string' ? settings.MODEL_API_KEY.trim() : '') ||
             process.env.MODEL_API_KEY ||
             '';
-        const localUrl = (typeof settings.MODEL_URL === 'string' ? settings.MODEL_URL.trim() : '') ||
+        const url = (typeof settings.MODEL_URL === 'string' ? settings.MODEL_URL.trim() : '') ||
             process.env.MODEL_URL ||
             '';
-        if (!localKey && !localUrl) {
-            console.error('hopper-agent: no local provider config.\n' +
-                '  Run `hopper-agent` and use `/init` to configure, or set "MODEL_API_KEY" and "MODEL_URL" in ~/.hopper-agent/settings.json.');
+        if (!url) {
+            console.error('hopper-agent: no local provider URL configured.\n' +
+                '  Run `hopper-agent` and use `/init` to configure, or set "MODEL_URL" in ~/.hopper-agent/settings.json.');
             return null;
         }
-        const p = new AnthropicProvider(localKey || undefined, localUrl || undefined, { local: true });
-        return { name: 'local', stream: p.stream.bind(p), check: p.check.bind(p) };
+        const p = new OllamaProvider(key || undefined, url || undefined);
+        const displayName = providerName === 'ollama' ? 'ollama' : 'local';
+        return { name: displayName, stream: p.stream.bind(p), check: p.check.bind(p) };
+    }
+    if (providerName === 'google') {
+        const googleKey = (typeof settings.GOOGLE_API_KEY === 'string' ? settings.GOOGLE_API_KEY.trim() : '') ||
+            process.env.GOOGLE_API_KEY ||
+            '';
+        const googleUrl = (typeof settings.GOOGLE_URL === 'string' ? settings.GOOGLE_URL.trim() : '') ||
+            process.env.GOOGLE_URL ||
+            '';
+        if (!googleKey) {
+            console.error('hopper-agent: no Google API key configured.\n' +
+                '  Run `hopper-agent` and use `/init` to configure, or set "GOOGLE_API_KEY" in ~/.hopper-agent/settings.json.');
+            return null;
+        }
+        const p = new GoogleGeminiProvider(googleKey, googleUrl || undefined);
+        return { name: p.name, stream: p.stream.bind(p), check: p.check.bind(p) };
     }
     // anthropic (default)
-    const fromSettingsKey = typeof settings.MODEL_API_KEY === 'string' ? settings.MODEL_API_KEY.trim() : '';
-    const fromSettingsUrl = typeof settings.MODEL_URL === 'string' ? settings.MODEL_URL.trim() : '';
+    const fromSettingsKey = typeof settings.ANTHROPIC_API_KEY === 'string' ? settings.ANTHROPIC_API_KEY.trim() : '';
+    const fromSettingsUrl = typeof settings.ANTHROPIC_URL === 'string' ? settings.ANTHROPIC_URL.trim() : '';
     const apiKey = fromSettingsKey || process.env.ANTHROPIC_API_KEY || '';
-    const baseUrl = fromSettingsUrl || process.env.ANTHROPIC_BASE_URL || '';
+    const baseUrl = fromSettingsUrl || process.env.ANTHROPIC_URL || '';
     if (!apiKey) {
         console.error('hopper-agent: no API key configured.\n' +
-            `  Looked at ~/.hopper-agent/settings.json (MODEL_API_KEY = ${fromSettingsKey ? '[set]' : '[missing/empty]'}),\n` +
+            `  Looked at ~/.hopper-agent/settings.json (ANTHROPIC_API_KEY = ${fromSettingsKey ? '[set]' : '[missing/empty]'}),\n` +
             `  and ANTHROPIC_API_KEY env var (${process.env.ANTHROPIC_API_KEY ? '[set]' : '[missing]'}).\n` +
-            '  Run `hopper-agent` and use `/init` to configure, or set "MODEL_API_KEY" in ~/.hopper-agent/settings.json.');
+            '  Run `hopper-agent` and use `/init` to configure, or set "ANTHROPIC_API_KEY" in ~/.hopper-agent/settings.json.');
         return null;
     }
     const p = new AnthropicProvider(apiKey, baseUrl || undefined);
@@ -1742,17 +1952,12 @@ async function main() {
         const result = await loop.run(args.prompt);
         process.exit(result.reason === 'error' ? 1 : 0);
     }
-    // Switch to the alternate screen buffer so the TUI owns the full window and
-    // the header stays pinned at the top. Restore on exit. We also override the
-    // terminal's default background via OSC 11 so the unpainted cells (padding,
-    // gaps between widgets) match the theme instead of showing whatever color
-    // the user's terminal profile happens to use.
+    // Override the terminal's default background via OSC 11 so the unpainted
+    // cells (padding, gaps between widgets) match the theme instead of showing
+    // whatever color the user's terminal profile happens to use.
     const theme = getTheme(themeName);
-    const ENTER_ALT = '\x1b[?1049h\x1b[H';
-    const LEAVE_ALT = '\x1b[?1049l';
-    const SET_BG = `\x1b]11;${theme.background}\x07`;
     const RESET_BG = '\x1b]111\x07';
-    process.stdout.write(ENTER_ALT + SET_BG);
+    process.stdout.write(`\x1b]11;${theme.background}\x07`);
     let restored = false;
     const restore = () => {
         if (restored)
@@ -1762,7 +1967,7 @@ async function main() {
         for (const client of mcpRawClientsRef.current) {
             client.disconnect().catch(() => { });
         }
-        process.stdout.write(RESET_BG + LEAVE_ALT);
+        process.stdout.write(RESET_BG);
         const id = globalThis.__hopperSessionId;
         if (id) {
             process.stdout.write(`\nSession saved. Resume with: hopper-agent resume ${id}\n`);
@@ -1865,7 +2070,7 @@ async function main() {
         }
     });
     console.error(`[cron] Checker started. Pending: ${cronManager.pendingCount}`);
-    render(_jsx(App, { provider: streamProviderHolder.current, streamProviderHolder: streamProviderHolder, model: model, approvalMode: approvalMode, cwd: cwd, themeName: themeName, system: system, settings: settings, projects: claudeProjects, cronManager: cronManager, onReminderHolder: onReminderHolder, telegramChatIdRef: telegramChatIdRef, telegramSubmitRef: telegramSubmitRef, telegramGateway: telegramGateway, channelRegistry: channelRegistry, channelRouter: channelRouter, activeChannelRef: activeChannelRef, mcpToolsRef: mcpToolsRef, mcpClientsRef: mcpClientsRef, onMcpReconnect: reconnectMcp, contextWindowSize: 200_000 }), {
+    render(_jsx(App, { provider: streamProviderHolder.current, streamProviderHolder: streamProviderHolder, model: model, approvalMode: approvalMode, cwd: cwd, themeName: themeName, system: system, settings: settings, projects: claudeProjects, cronManager: cronManager, onReminderHolder: onReminderHolder, telegramChatIdRef: telegramChatIdRef, telegramSubmitRef: telegramSubmitRef, telegramGateway: telegramGateway, channelRegistry: channelRegistry, channelRouter: channelRouter, activeChannelRef: activeChannelRef, mcpToolsRef: mcpToolsRef, mcpClientsRef: mcpClientsRef, onMcpReconnect: reconnectMcp, contextWindowSize: 200_000, resumeSession: args.resume, resumeSessionId: args.resume ? args.prompt : undefined }), {
         exitOnCtrlC: false,
     });
 }