agen-vektor 0.3.28 → 0.3.30

package/README.md

@@ -471,6 +471,10 @@ secrets stay private):
 
 ## Changelog
 
+### 0.3.30
+- **Thinking card matches Freebuff `thinking.tsx` exactly — no mid-run color flip-flop.** The reasoning body renders muted (`#acb3bf`) italic in BOTH streaming and completed states; only the header (dot + bold "Thinking") is foreground-white. Previously the body flipped from white (streaming) to muted (done), which read as the card changing color during a run.
+- **Expanded thinking view is raw muted italic with word wrap.** The in-card markdown re-render was removed — headings/inline code no longer paint their own colors inside the card (the mixed-color expanded view read as noise). Markdown markers in reasoning now show as-is, uniformly styled.
+
 ### 0.3.15
 - **Thinking cards are segmented per completed agent step.** Reasoning for each step (think → tool → think → tool) now renders as its own `• Thinking` card instead of stacking every step's reasoning into one ever-growing card — stale reasoning no longer appears to "leak" below the live thinking preview during multi-step tasks like web research.
 - Streaming answers keep the guarded `mergeStreamDelta` accumulation across all providers (no more doubled final text on gateways that resend the full text).

package/dist/tools/e2b.js

@@ -335,6 +335,90 @@ ${lines.join('\n')}`,
                 };
             },
         },
+        {
+            definition: {
+                name: 'e2b_screenshot',
+                description: 'Take a screenshot of a URL with headless Chromium INSIDE a persistent e2b cloud session (from e2b_cloud create) and get it back as a downloadable gateway link (render_ui button opens it). Requires Playwright+Chromium installed in the session (npx playwright install --with-deps chromium). The target URL is fetched FROM INSIDE the sandbox — use http://localhost:<port> for dev servers running in this session. The sandbox needs internet unless the target is localhost.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string', description: 'Session id from e2b_cloud create' },
+                        url: { type: 'string', description: 'URL to capture, e.g. http://localhost:3000 (default)' },
+                        wait_ms: { type: 'number', description: 'Milliseconds to wait for page load before capturing (default 1500)' },
+                        full_page: { type: 'boolean', description: 'Capture full scrollable page (default false)' },
+                    },
+                    required: ['id'],
+                },
+            },
+            async execute(args, ctx) {
+                const id = String(args.id || '');
+                const target = String(args.url || 'http://localhost:3000').trim();
+                if (!/^[A-Za-z0-9-]{8,80}$/.test(id))
+                    return { output: 'ERROR: invalid session id' };
+                if (!/^https?:\/\//.test(target) || target.includes("'"))
+                    return { output: 'ERROR: url harus http(s) tanpa quote' };
+                const waitMs = Math.min(15_000, Math.max(0, Number(args.wait_ms) || 1500));
+                const fullPage = args.full_page === true;
+                // Dua langkah: (1) exec script Playwright → simpan PNG di /home/user/, (2) beri
+                // link download via route /v1/e2b/file (gateway stream PNG → tombol render_ui
+                // di TUI membukanya di browser). Script memakai flag jitless WAJIB (gotcha V8
+                // OOM di sandbox kecil) dan hanya setelah marker __VECTOR_DONE_ hasil poll.
+                // PENTING: script DITULIS ke /home/user (bukan /tmp) — ESM resolve
+                // `import 'playwright'` relatif thd lokasi file, dan package terinstall
+                // di /home/user/node_modules (npm i tanpa -g).
+                const script = [
+                    'mkdir -p /home/user',
+                    `cat > /home/user/vector-shot.mjs <<\'EOF\'`,
+                    `import { chromium } from 'playwright';`,
+                    `const b = await chromium.launch({ args: ['--no-sandbox','--disable-dev-shm-usage','--disable-gpu','--js-flags=--jitless'] });`,
+                    `const p = await b.newPage();`,
+                    `try {`,
+                    `  await p.goto(${JSON.stringify(target)}, { waitUntil: 'load', timeout: 20000 });`,
+                    `  await p.waitForTimeout(${waitMs});`,
+                    `  await p.screenshot({ path: '/home/user/vector-preview.png', fullPage: ${fullPage ? 'true' : 'false'} });`,
+                    `  console.log('SHOT_OK');`,
+                    `} catch (e) { console.log('SHOT_ERR ' + e.message); await b.close(); process.exit(3); }`,
+                    `await b.close();`,
+                    `EOF`,
+                    `cd /home/user && node /home/user/vector-shot.mjs`,
+                ].join('\n');
+                ctx.onActivity?.('e2b', `screenshot ${target}`);
+                // Poll exec manual di sini (bukan e2bExec blocking): kita butuh exit code.
+                const started = await fetch(GW_BASE + '/v1/e2b/exec?id=' + encodeURIComponent(id), {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', 'User-Agent': 'VectorHead-AI-Agent/0.1' },
+                    body: JSON.stringify({ command: script }),
+                    signal: AbortSignal.timeout(30_000),
+                });
+                const sdata = (await started.json().catch(() => null));
+                if (!started.ok || !sdata?.jobId) {
+                    return { output: `ERROR: e2b exec gagal — ${(0, credentials_1.redact)(sdata?.error || 'HTTP ' + started.status)}`, summary: 'screenshot exec error' };
+                }
+                const t0 = Date.now();
+                while (Date.now() - t0 < 90_000) {
+                    await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+                    const jr = await fetch(GW_BASE + '/v1/e2b/job?id=' + encodeURIComponent(id) + '&job=' + sdata.jobId, {
+                        signal: AbortSignal.timeout(15_000),
+                    });
+                    const j = (await jr.json().catch(() => null));
+                    if (j?.status === 'done') {
+                        if (j.exitCode !== 0 || !(j.stdout || '').includes('SHOT_OK')) {
+                            const why = (j.stderr || j.stdout || '').trim().slice(0, 300);
+                            return { output: `ERROR: screenshot gagal (exit ${j.exitCode})\n${(0, credentials_1.redact)(why)}` + (why.includes('Cannot find package') ? '\n→ Playwright belum terpasang di sesi ini: e2b_exec {command: "npm i playwright && npx playwright install --with-deps chromium"}' : ''), summary: 'screenshot error' };
+                        }
+                        const link = `${GW_BASE}/v1/e2b/file?id=${encodeURIComponent(id)}&path=%2Fhome%2Fuser%2Fvector-preview.png`;
+                        return {
+                            output: `screenshot tersimpan: /home/user/vector-preview.png (${target})\nlink: ${link}`,
+                            summary: `e2b screenshot ${target}`,
+                            data: { widget: { type: 'button', text: '🖼 Lihat screenshot', link }, screenshot: link },
+                        };
+                    }
+                    if (j?.status === 'error')
+                        break;
+                }
+                return { output: 'ERROR: screenshot timeout (job tidak selesai dalam 90s)', summary: 'screenshot timeout' };
+            },
+        },
         {
             definition: {
                 name: 'e2b_download',

package/dist/tui/app.js

@@ -1763,7 +1763,13 @@ class App {
                         this.runFollowupMsgs.push(followupMsg);
                     }
                 }
-                if (tool === 'render_ui' && data && data.widget) {
+                // Tombol UI: tool render_ui — dan kini juga tool e2b (screenshot/
+                // preview) — bisa mengembalikan data.widget {type:'button',text,link}.
+                // Whitelist supaya tool pihak ketiga (MCP) tidak bisa memicu tombol
+                // (surface prompt-injection: deskripsi/hasil tool = untrusted data).
+                if ((tool === 'render_ui' || tool.startsWith('e2b_')) &&
+                    data &&
+                    data.widget) {
                     const w = data.widget;
                     this.activeUiButton = w;
                     this.messages.push({ kind: 'ui', content: w.text, ui: w, ts: Date.now() });
@@ -3045,7 +3051,9 @@ class App {
                 continue;
             const args = (m.content.split('\n')[0] || '').trim();
             const head = `${(0, chat_1.toolIcon)(m.tool)} ${theme_1.THEME.bold}${(0, chat_1.toolLabel)(m.tool)}${theme_1.THEME.reset}`;
-            const line = args ? `${head} ${theme_1.THEME.faint}${args}${theme_1.THEME.reset}` : head;
+            // Freebuff SimpleToolCallItem: description in the FOREGROUND (white),
+            // not faint — the panel is a live indicator, dark gray read as junk.
+            const line = args ? `${head} ${theme_1.THEME.textBright}${args}${theme_1.THEME.reset}` : head;
             out.unshift((0, terminal_1.truncate)(line, inner));
         }
         return out;
@@ -3162,6 +3170,16 @@ class App {
         const visible = (0, chat_1.chatWindow)(all, this.scroll, chatH);
         const chatTop = 2;
         const sepRow = chatTop + chatH;
+        // Responsive content width (Freebuff use-terminal-dimensions.ts
+        // separatorWidth = terminal − 2): EVERY structural element — separator,
+        // tool panel, input box — spans exactly cols − 2 with a 1-col margin on
+        // BOTH sides (symmetric). Dulu separator di-cap 120 kolom sementara input
+        // box full-width → di terminal lebar garis ─ tidak lurus dengan box di
+        // bawahnya, dan box menempel ke tepi sementara teks chat ber-gutter 1
+        // kolom ("sisi sama sisi tidak seimbang"). Chat rows carry the same
+        // 1-col SIDE_GUTTER, so text column == box outer width == frameW.
+        const frameW = Math.max(10, cols - 2);
+        const frameIndent = ' ';
         const toolRows = this.toolPanelRows(cols);
         const activityH = toolRows.length > 0 ? toolRows.length + 2 : 0;
         const suggestH = this.suggestHeight();
@@ -3171,9 +3189,9 @@ class App {
         // blank row, input (vertically centered), blank row, bottom border.
         // Slash suggestions render between the tool panel and the box.
         const boxTop = sepRow + activityH + suggestH + 1;
-        const boxBot = boxTop + this.input.wrappedRows(cols) + 3;
+        const boxBot = boxTop + this.input.wrappedRows(frameW) + 3;
         const statusRow = boxBot + 1;
-        const rendered = this.input.render(cols, input_1.DEFAULT_PLACEHOLDER);
+        const rendered = this.input.render(frameW, input_1.DEFAULT_PLACEHOLDER);
         // Cursor row: prompt line 0 DILUKIS di boxTop + 1 (border ╭ di boxTop−1,
         // blank padding di boxTop). Dulu +2 menaruh kursor hardware SATU BARIS di
         // bawah teks prompt — baris kosong dasar box, tepat di atas bar "Build •
@@ -3181,26 +3199,27 @@ class App {
         // YOLO" (laporan user 2026-09-07). Kursor hardware sendiri kini SELALU
         // hidden (lihat doRender di cli/index.ts); posisi tetap diperbaiki agar
         // benar untuk audit/bounds.
-        const cursorCol = rendered.cursorCol + 1;
+        // +2: 1-col frame indent + 1 left border column.
+        const cursorCol = rendered.cursorCol + 2;
         const cursorRow = boxTop + 1 + rendered.cursorRow;
         const frame = new Array(rows).fill('');
         frame[0] = (0, statusbar_1.renderHeader)(cols, info);
         for (let i = 0; i < chatH; i++) {
             frame[chatTop - 1 + i] = visible[i] !== undefined ? visible[i] : '';
         }
-        frame[sepRow - 1] = theme_1.THEME.border + terminal_1.BOX.h.repeat(Math.min(cols, 120)) + theme_1.THEME.reset;
+        frame[sepRow - 1] = frameIndent + theme_1.THEME.border + terminal_1.BOX.h.repeat(frameW) + theme_1.THEME.reset;
         // Boxed tool-call panel: `· Tool args` lines (last TOOL_PANEL_ROWS calls)
         // inside a rounded box, directly above the chat prompt — mirrors the
         // committed README example instead of a plain unboxed strip.
         if (activityH > 0) {
             const toolBorder = `${theme_1.THEME.bold}${theme_1.THEME.textBright}`;
-            frame[sepRow] = `${toolBorder}╭${terminal_1.BOX.h.repeat(Math.max(0, cols - 2))}╮${theme_1.THEME.reset}`;
+            frame[sepRow] = `${frameIndent}${toolBorder}╭${terminal_1.BOX.h.repeat(Math.max(0, frameW - 2))}╮${theme_1.THEME.reset}`;
             for (let i = 0; i < toolRows.length; i++) {
                 const line = toolRows[i];
-                const pad = Math.max(0, cols - 2 - (0, terminal_1.visibleWidth)(line));
-                frame[sepRow + 1 + i] = `${toolBorder}│${theme_1.THEME.reset}${line}${' '.repeat(pad)}${toolBorder}│${theme_1.THEME.reset}`;
+                const pad = Math.max(0, frameW - 2 - (0, terminal_1.visibleWidth)(line));
+                frame[sepRow + 1 + i] = `${frameIndent}${toolBorder}│${theme_1.THEME.reset}${line}${' '.repeat(pad)}${toolBorder}│${theme_1.THEME.reset}`;
             }
-            frame[sepRow + toolRows.length + 1] = `${toolBorder}╰${terminal_1.BOX.h.repeat(Math.max(0, cols - 2))}╯${theme_1.THEME.reset}`;
+            frame[sepRow + toolRows.length + 1] = `${frameIndent}${toolBorder}╰${terminal_1.BOX.h.repeat(Math.max(0, frameW - 2))}╯${theme_1.THEME.reset}`;
         }
         // Freebuff-style slash command popup (when typing `/…`). The reserved
         // height IS the render budget: suggestHeight already fits the whole
@@ -3214,17 +3233,17 @@ class App {
         }
         // Freebuff renders the input box border in the foreground color (white).
         const boxBorder = `${theme_1.THEME.bold}${theme_1.THEME.textBright}`;
-        frame[boxTop - 1] = `${boxBorder}╭${terminal_1.BOX.h.repeat(Math.max(0, cols - 2))}╮${theme_1.THEME.reset}`;
+        frame[boxTop - 1] = `${frameIndent}${boxBorder}╭${terminal_1.BOX.h.repeat(Math.max(0, frameW - 2))}╮${theme_1.THEME.reset}`;
         // Vertical padding (Freebuff chat-input-bar): one blank content row
         // above and below the wrapped prompt lines.
-        const blankRow = `${boxBorder}│${theme_1.THEME.reset}${' '.repeat(Math.max(0, cols - 2))}${boxBorder}│${theme_1.THEME.reset}`;
+        const blankRow = `${frameIndent}${boxBorder}│${theme_1.THEME.reset}${' '.repeat(Math.max(0, frameW - 2))}${boxBorder}│${theme_1.THEME.reset}`;
         frame[boxTop] = blankRow;
         for (let i = 0; i < rendered.lines.length; i++) {
-            frame[boxTop + 1 + i] = `${boxBorder}│${theme_1.THEME.reset}${rendered.lines[i]}${boxBorder}│${theme_1.THEME.reset}`;
+            frame[boxTop + 1 + i] = `${frameIndent}${boxBorder}│${theme_1.THEME.reset}${rendered.lines[i]}${boxBorder}│${theme_1.THEME.reset}`;
         }
         for (let i = boxTop + 1 + rendered.lines.length; i < boxBot - 1; i++)
             frame[i] = blankRow;
-        frame[boxBot - 1] = `${boxBorder}╰${terminal_1.BOX.h.repeat(Math.max(0, cols - 2))}╯${theme_1.THEME.reset}`;
+        frame[boxBot - 1] = `${frameIndent}${boxBorder}╰${terminal_1.BOX.h.repeat(Math.max(0, frameW - 2))}╯${theme_1.THEME.reset}`;
         frame[statusRow - 1] = (0, statusbar_1.renderStatusBar)(cols, info);
         // OpenCode single-buffer compositing: the modal overlay is composed INTO
         // the frame rows so the incremental renderer can row-diff while a dialog

package/dist/tui/chat.js

@@ -126,6 +126,21 @@ const TOOL_LABELS = {
 function toolLabel(tool) {
     return (tool && TOOL_LABELS[tool]) || tool || 'tool';
 }
+/**
+ * Tool-card description color — Freebuff tools/*.tsx parity:
+ * SimpleToolCallItem paints the description with theme.foreground (white)
+ * unless the tool overrides it: read-url.tsx → theme.muted (#acb3bf),
+ * list-directory.tsx → theme.directory (#9CA3AF). The old renderer painted
+ * EVERY description with faint #6b7280 (gray-500) — read as a dark smudge
+ * next to the white tool name ("Read Url · Glob · List masih gelap").
+ */
+const TOOL_DESC_COLOR = {
+    web_fetch: theme_1.THEME.muted,
+    list_directory: theme_1.THEME.directory,
+};
+function toolDescColor(tool) {
+    return (tool && TOOL_DESC_COLOR[tool]) || theme_1.THEME.textBright;
+}
 /** The suggest_followups batch carried by a 'followup' message, if any. */
 function followupsGroupOf(m) {
     if (m.kind !== 'followup')
@@ -147,6 +162,30 @@ function formatTimeout(timeoutSeconds) {
         return `${r / 60}m timeout`;
     return `${r}s timeout`;
 }
+/**
+ * Strip PAIRED inline markdown markers for plain-text surfaces (thinking
+ * preview): `**bold**`/`__bold__` → bold, `*emph*`/`_emph_` → emph,
+ * `` `code` `` → code, `~~strike~~` → plain. UNPAIRED leftovers (a lone `
+ * backtick or asterisk pair still open mid-stream) are dropped so no
+ * "sampah kutipan" sticks to the words. Whitespace collapses back cleanly.
+ */
+function stripPairedMarkdown(text) {
+    let out = text;
+    for (let pass = 0; pass < 2; pass++) {
+        // Pairs first (non-greedy, same line semantics).
+        out = out
+            .replace(/\*\*([^*\n]+)\*\*/g, '$1')
+            .replace(/__([^_\n]+)__/g, '$1')
+            .replace(/(^|[^*])\*([^*\n]+)\*(?!\*)/g, '$1$2')
+            .replace(/(^|[^\w_])_([^_\n]+)_(?!\w)/g, '$1$2')
+            .replace(/~~([^~\n]+)~~/g, '$1')
+            .replace(/`([^`\n]+)`/g, '$1');
+    }
+    // Unpaired leftovers — only chars that would EVER render literal junk.
+    out = out.replace(/^[*`~]+/, '').replace(/[*`~]+$/, '');
+    out = out.replace(/\s*[*`~]\s*/g, ' ').replace(/ {2,}/g, ' ');
+    return out.trim();
+}
 /** Center a string (with ANSI) horizontally within `width`. */
 function center(str, width) {
     const pad = Math.max(0, Math.floor((width - (0, terminal_1.visibleWidth)(str)) / 2));
@@ -959,11 +998,15 @@ function renderMessage(m, width, seenGroups, seenCallIds) {
             if (m.tool === 'suggest_followups') {
                 return out;
             }
-            // Compact block: <icon> tool · preview (Freebuff tool-call style:
-            // bullet + bold tool name + description), then dim result lines.
+            // Compact block (Freebuff tool-call-item.tsx parity): bullet + BOLD
+            // tool name in the foreground, description in the tool's own color
+            // (white by default — read-url muted, list directory), then the result
+            // preview in muted ITALIC (Freebuff ToolCallItem collapsed preview:
+            // `fg={isStreaming ? foreground : muted}` + ITALIC). The old all-faint
+            // #6b7280 rendering read as dark gray junk under the white label.
             const icon = toolIcon(m.tool);
             const parts = body.split('\n');
-            const first = `${icon} ${theme_1.THEME.bold}${toolLabel(m.tool)}${theme_1.THEME.reset} ${theme_1.THEME.faint}${(parts[0] || '').trim()}${theme_1.THEME.reset}`;
+            const first = `${icon} ${theme_1.THEME.bold}${toolLabel(m.tool)}${theme_1.THEME.reset} ${toolDescColor(m.tool)}${(parts[0] || '').trim()}${theme_1.THEME.reset}`;
             if (first.trim()) {
                 for (const line of (0, terminal_1.wrapText)(first, width))
                     out.push(line);
@@ -971,7 +1014,7 @@ function renderMessage(m, width, seenGroups, seenCallIds) {
             const rest = parts.slice(1).filter((l) => l.trim());
             if (rest.length > 0) {
                 for (const line of (0, terminal_1.wrapText)(rest.join('\n'), Math.max(4, width - 2))) {
-                    out.push(`${theme_1.THEME.faint}${line}${theme_1.THEME.reset}`);
+                    out.push(`${theme_1.THEME.muted}${theme_1.THEME.italic}${line}${theme_1.THEME.reset}`);
                 }
             }
             return out;
@@ -1036,14 +1079,19 @@ function renderMessage(m, width, seenGroups, seenCallIds) {
             if (singleBoldMatch)
                 return out;
             const complete = !m.streaming;
-            // Freebuff EXACT: the preview normalizes the content to ONE line and
-            // word-wraps it (getLastNVisualLines) — so the 5-line preview is the
-            // last 5 VISUAL lines, with '...' prefixed when earlier lines exist.
-            // The wrap width accounts for the '...' prefix (−3) and the indent (−2,
-            // Freebuff paddingLeft: 2). Expanded keeps the original line breaks.
+            // Models (GLM/DeepSeek reasoning) often write MARKDOWN inside their
+            // reasoning — raw `**`, backticks and `#` used to leak onto the card as
+            // literal junk ("banyak kutipan seperti sampah"). Freebuff never shows
+            // markers: its renderer CONSUMES them. Mirror that:
+            //   preview  → strip PAIRED markers (bold/italic/code), collapse unpaired
+            //              leftovers (a lone ` or ** mid-stream must not stick out),
+            //              keep words intact;
+            //   expanded → render through the SAME markdown engine as the chat
+            //              (splitMarkdown consumes **bold**, *emph*, `code`, # heads,
+            //              > quotes, lists) so nothing literal survives.
             const PREVIEW_LINE_COUNT = 5;
             const bodyCols = Math.max(10, width - 2);
-            const normalizedContent = th.text.replace(/\r\n?/g, '\n').replace(/\n+/g, ' ').trim();
+            const normalizedContent = stripPairedMarkdown(th.text.replace(/\r\n?/g, '\n').replace(/\n+/g, ' ').trim());
             const effectiveWidth = bodyCols - 3;
             const { lines: previewLines, hasMore } = getLastNVisualLines(normalizedContent, effectiveWidth, PREVIEW_LINE_COUNT);
             const expandedContent = th.text.replace(/\r\n?/g, '\n').replace(/\n\n+/g, '\n\n').trim();
@@ -1054,19 +1102,33 @@ function renderMessage(m, width, seenGroups, seenCallIds) {
             out.push(`${theme_1.THEME.textBright}${toggleIndicator}${theme_1.THEME.reset}${theme_1.THEME.bold}Thinking${theme_1.THEME.reset}`);
             if (th.state === 'hidden')
                 return out;
+            // Body color — Freebuff thinking.tsx EXACT: the preview text element
+            // paints `fg: theme.muted` + TextAttributes.ITALIC in BOTH states
+            // (streaming AND completed); expanded paints the same muted italic
+            // with wrapMode 'word'. There is NO white reasoning state in Freebuff —
+            // the previous "streaming = textBright" flip-flop read as the card
+            // changing color mid-run ("warna thinking masih sama tidak berubah /
+            // makin kacau"). The HEADER (dot + bold label) is the only
+            // foreground-white part of the card.
+            const thinkBody = `${theme_1.THEME.muted}${theme_1.THEME.italic}`;
             if (showPreview) {
                 for (let i = 0; i < previewLines.length; i++) {
                     // '...' sits at the START of the first visual line (Freebuff:
                     // '...' + lines.join('\n')).
                     const body = (i === 0 && hasMore ? '...' : '') + previewLines[i];
-                    for (const w of (0, terminal_1.wrapText)(`${theme_1.THEME.muted}${theme_1.THEME.italic}${body}${theme_1.THEME.reset}`, bodyCols)) {
+                    for (const w of (0, terminal_1.wrapText)(`${thinkBody}${body}${theme_1.THEME.reset}`, bodyCols)) {
                         out.push(`  ${w}`);
                     }
                 }
             }
             if (showFull) {
+                // Expanded — Freebuff thinking.tsx EXACT: the SAME muted italic body,
+                // raw content with original line breaks (wrapMode 'word'). Plain wrap,
+                // NO markdown re-render: the markdown engine paints headings/inline
+                // code in their own colors inside a card whose body must stay uniformly
+                // muted italic (the mixed-color expanded card read as "kacau").
                 for (const line of expandedContent.split('\n')) {
-                    for (const w of (0, terminal_1.wrapText)(`${theme_1.THEME.muted}${theme_1.THEME.italic}${line}${theme_1.THEME.reset}`, bodyCols)) {
+                    for (const w of (0, terminal_1.wrapText)(`${thinkBody}${line}${theme_1.THEME.reset}`, bodyCols)) {
                         out.push(`  ${w}`);
                     }
                 }

package/dist/tui/themes.js

@@ -138,9 +138,31 @@ function resolveValue(spec, value, mode, bg, visited) {
         return resolveValue(spec, next, mode, bg, visited);
     return null; // unknown reference → keep the slot default
 }
+/**
+ * THEME slots a theme may NOT override — the chat TEXT legibility core.
+ * Freebuff renders message text with its foreground palette in BOTH its dark
+ * and light theme (user-content is never dark-on-dark), so a custom theme
+ * with dark/near-background `text`/`textMuted` values must not be able to
+ * turn chat prose, reasoning or tool output into an unreadable smudge.
+ * Everything else (accent, borders, headings, code chips…) stays themeable.
+ */
+const LOCKED_SLOTS = new Set([
+    'text',
+    'textBright',
+    'muted',
+    'faint',
+    'quoteText',
+    'code',
+]);
 /** Apply a parsed ThemeSpec onto THEME (values that resolve win). */
 function applySpec(spec, mode = 'dark') {
     for (const slot of Object.keys(SLOT_KEYS)) {
+        // Chat-body slots keep their Freebuff defaults: custom themes (e.g.
+        // solarized/gold dumps) mapped `text` to a dark base color and the chat
+        // turned near-invisible. Locked = theme colors are for CHROME, not for
+        // the words themselves.
+        if (LOCKED_SLOTS.has(slot))
+            continue;
         for (const key of SLOT_KEYS[slot]) {
             const raw = spec.theme[key];
             if (raw === undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agen-vektor",
-  "version": "0.3.28",
+  "version": "0.3.30",
   "description": "VectorHead (agen-vektor) — AI Coding Agent CLI/TUI for Linux & Termux. Multi-provider, tool calling, session, permission system.",
   "type": "commonjs",
   "bin": {