termux-dev 1.8.0 → 1.8.2

package/README.md

@@ -57,6 +57,8 @@ The terminal interface is built around a framed prompt that carries the status i
   Paste screenshots straight from the clipboard with `Ctrl+V` or `Alt+V` (also `/image`, or a pasted file path). They appear as badges like `[Image #1 203kb]` and are sent to the model as real images, unless the model is known to read text only. Needs `wl-clipboard` on Wayland, `xclip` on X11, `pngpaste` on macOS.
 - **Built-in Live Web Server (`/serve`):**  
   Instantly preview web apps and HTML5 games on port 3000. Seamlessly opens on Android via `termux-open-url`.
+- **Background tasks (`/tasks`):**  
+  The agent can start a dev server, a watcher or a long test run in the background and keep working. It can wait for a line (`ready|error`), read the output later, and is told when a task ends or prints something it asked about; if you are at the prompt then, it picks the news up by itself. A `◈ 2 bg` badge in the prompt frame shows what runs; `/tasks` lists tasks, `/tasks <id>` shows output, `/tasks stop <id|all>` ends them. Starting a task asks for approval like `bash`; everything is stopped when devx exits. Set `"backgroundAutoWake": false` to stop the agent from reacting by itself.
 - **Instant Snapshot Rollback (`/undo`):**  
   Every edit made with the file tools (`write_file`, `edit_file`) is recorded and can be rolled back with a single command. Changes made by shell commands (`bash`) are **not** tracked, and snapshots live in memory for the current session only.
 - **Self-Healing Diagnostics & Auto-Installer:**  
@@ -170,6 +172,7 @@ Type `/` in the prompt to open the autocomplete command palette:
 | **`/rename`** | Rename the chat: `/rename <name>`, or without a name the AI names it again (`/title` is the same) |
 | **`/permissions`** | What is allowed without asking (`Session` / `Always` on an approval card); `/permissions clear` resets it |
 | **`/rewind`** | Go back to one of **your messages**: the chat after it is removed (the model forgets it too), the message returns to the input line to be edited; the files can go back as well (with git) |
+| **`/tasks`** | Background tasks: list, `/tasks <id>` for output, `/tasks stop <id\|all>`, `/tasks clear` |
 | **`/undo`** | Revert all file changes from the last AI turn |
 | **`/diff`** | View colored git diff of modified project files |
 | **`/commit`** | AI-generated semantic commit message & git commit |

package/assets/banner.svg

@@ -16,7 +16,7 @@
     <rect width="1000" height="280" fill="url(#bg)"/>
   </g>
   <rect x="1.5" y="1.5" width="997" height="277" rx="18" fill="none" stroke="#23252c" stroke-width="1.5"/>
-  <text x="500.0" y="70" text-anchor="middle" font-family="'Inter',system-ui,-apple-system,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif" font-size="13" font-weight="600" letter-spacing="5" fill="#7d8896">THE TERMINAL-NATIVE AI CODING AGENT<tspan dx="16" fill="#2fe3ee" font-weight="700">v1.8.0</tspan></text>
+  <text x="500.0" y="70" text-anchor="middle" font-family="'Inter',system-ui,-apple-system,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif" font-size="13" font-weight="600" letter-spacing="5" fill="#7d8896">THE TERMINAL-NATIVE AI CODING AGENT<tspan dx="16" fill="#2fe3ee" font-weight="700">v1.8.2</tspan></text>
   <g>
     <text x="500.0" y="178" text-anchor="middle" font-family="'JetBrains Mono','Fira Code','SF Mono',ui-monospace,Menlo,Consolas,'DejaVu Sans Mono',monospace" font-size="112" font-weight="800" letter-spacing="14" fill="#2fe3ee">DEVX</text>
   </g>

package/assets/preview.svg

@@ -9,9 +9,9 @@
     .i { font-style: italic; }
     .cur { animation: blink 1.1s steps(1) infinite; }
     @keyframes blink { 0%,55% { opacity: 1 } 56%,100% { opacity: 0 } }
-    .spin { animation: pulse 1.6s ease-in-out infinite; }
-    @keyframes pulse { 0%,100% { opacity: 1 } 50% { opacity: .35 } }
-    @media (prefers-reduced-motion: reduce) { .cur, .spin { animation: none } }
+    .sp { opacity: 0; animation: spin .8s steps(1) infinite; }
+    @keyframes spin { 0% { opacity: 1 } 10% { opacity: 0 } 100% { opacity: 0 } }
+    @media (prefers-reduced-motion: reduce) { .cur { animation: none } .sp { animation: none } .sp.f0 { opacity: 1 } }
   </style>
   <rect x="8" y="8" width="924" height="642" rx="14" fill="#000000"/>
   <g clip-path="url(#clip)">
@@ -32,7 +32,7 @@
   <rect x="595.2" y="574.0" width="243.2" height="19" fill="#000000"/>
   <text x="44.8" y="62.0" class="t" fill="#b794f6">▌</text>
   <text x="61.6" y="62.0" class="t b" fill="#f4f7fb">devx</text>
-  <text x="112.0" y="62.0" class="t" fill="#5f6b7a">v1.8.0</text>
+  <text x="112.0" y="62.0" class="t" fill="#5f6b7a">v1.8.2</text>
   <text x="61.6" y="106.0" class="t" fill="#5f6b7a">model</text>
   <text x="128.8" y="106.0" class="t" fill="#e5eaf1">deepseek-v4.1-flash · think high</text>
   <text x="406.0" y="106.0" class="t" fill="#5f6b7a">/model</text>
@@ -69,7 +69,16 @@
   <text x="70.0" y="458.0" class="t" fill="#5f6b7a">╰</text>
   <text x="86.8" y="458.0" class="t" fill="#9aa6b4">24 passed</text>
   <text x="86.8" y="480.0" class="t" fill="#5f6b7a">… +3 lines (ctrl+o to expand)</text>
-  <text x="44.8" y="512.0" class="t spin" fill="#5ed3e0">⠹</text>
+  <text x="44.8" y="512.0" class="t sp f0" style="animation-delay:0.00s" fill="#5ed3e0">⠋</text>
+  <text x="44.8" y="512.0" class="t sp f1" style="animation-delay:0.08s" fill="#5ed3e0">⠙</text>
+  <text x="44.8" y="512.0" class="t sp f2" style="animation-delay:0.16s" fill="#5ed3e0">⠹</text>
+  <text x="44.8" y="512.0" class="t sp f3" style="animation-delay:0.24s" fill="#5ed3e0">⠸</text>
+  <text x="44.8" y="512.0" class="t sp f4" style="animation-delay:0.32s" fill="#5ed3e0">⠼</text>
+  <text x="44.8" y="512.0" class="t sp f5" style="animation-delay:0.40s" fill="#5ed3e0">⠴</text>
+  <text x="44.8" y="512.0" class="t sp f6" style="animation-delay:0.48s" fill="#5ed3e0">⠦</text>
+  <text x="44.8" y="512.0" class="t sp f7" style="animation-delay:0.56s" fill="#5ed3e0">⠧</text>
+  <text x="44.8" y="512.0" class="t sp f8" style="animation-delay:0.64s" fill="#5ed3e0">⠇</text>
+  <text x="44.8" y="512.0" class="t sp f9" style="animation-delay:0.72s" fill="#5ed3e0">⠏</text>
   <text x="61.6" y="512.0" class="t" fill="#e5eaf1">Writing</text>
   <text x="145.6" y="512.0" class="t" fill="#5f6b7a">(12s · ↓ 1.4k tokens · ctrl+c to stop)</text>
   <text x="44.8" y="544.0" class="t" fill="#5ed3e0">●</text>

package/dist/cli/background-ui.js

@@ -0,0 +1,116 @@
+import { formatDuration } from '../core/background.js';
+import { palette } from './ui.js';
+import { displayWidth, padEndWidth, truncateWidth } from './width.js';
+/** What the prompt frame shows: how many tasks run, how many ended badly and were not looked at yet. */
+export function backgroundSummary(manager, seenFailures) {
+    const all = manager.list();
+    return {
+        running: all.filter((t) => t.status === 'running').length,
+        failed: all.filter((t) => t.status === 'failed' && !seenFailures.has(t.id)).length,
+    };
+}
+const STATE_LABEL = {
+    running: 'running',
+    exited: 'done',
+    failed: 'failed',
+    stopped: 'stopped',
+};
+function stateCell(info) {
+    const label = info.status === 'failed' && info.code !== null ? `failed ${info.code}` : STATE_LABEL[info.status];
+    const padded = label.padEnd(9);
+    if (info.status === 'running')
+        return palette.ok('● ' + padded);
+    if (info.status === 'failed')
+        return palette.err('✗ ' + padded);
+    return palette.faint('○ ' + padded);
+}
+/** The list of tasks for `/tasks`: one row each, the newest output line under a running one. */
+export function renderTaskList(manager, cols, now = Date.now()) {
+    const tasks = manager.list();
+    if (tasks.length === 0) {
+        return [`  ${palette.faint('·')} ${palette.muted('No background tasks. The agent starts them for servers, watchers and long runs.')}`];
+    }
+    const rows = [];
+    const running = tasks.filter((t) => t.status === 'running').length;
+    rows.push(`  ${palette.bold('Background tasks')} ${palette.faint(`· ${running} running, ${tasks.length - running} ended`)}`);
+    for (const t of tasks) {
+        const age = formatDuration((t.endedAt ?? now) - t.startedAt);
+        const head = `  ${palette.accent(padEndWidth(t.id, 4))} ${stateCell(t)} ${palette.faint(padEndWidth(age, 7))} `;
+        rows.push(head + palette.text(truncateWidth(t.label, Math.max(8, cols - displayWidth(head) - 1))));
+        const last = lastLine(manager, t.id);
+        if (last)
+            rows.push(`  ${' '.repeat(4)} ${palette.faint('╰')} ${palette.muted(truncateWidth(last, Math.max(8, cols - 14)))}`);
+    }
+    rows.push('');
+    rows.push(`  ${palette.faint(truncateWidth('/tasks <id> output · /tasks stop <id|all> · /tasks clear', Math.max(8, cols - 4)))}`);
+    return rows;
+}
+function lastLine(manager, id) {
+    try {
+        const { text } = manager.read(id, { mode: 'tail', lines: 3 });
+        const lines = text.split('\n').map((l) => l.trim()).filter(Boolean);
+        return lines[lines.length - 1] ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+/** The output of one task for `/tasks <id>`. */
+export function renderTaskOutput(manager, id, cols, lines = 40) {
+    const info = manager.get(id);
+    if (!info)
+        return [`  ${palette.err('✗')} ${palette.err(`No task "${id}". Type /tasks to see them.`)}`];
+    const { text, omitted } = manager.read(id, { mode: 'tail', lines });
+    const rows = [`  ${palette.accent(info.id)} ${stateCell(info)} ${palette.text(truncateWidth(info.label, Math.max(8, cols - 22)))}`];
+    rows.push(`  ${palette.faint(truncateWidth(info.command, Math.max(8, cols - 4)))}`);
+    if (omitted > 0)
+        rows.push(`  ${palette.faint(`… ${omitted} earlier line${omitted === 1 ? '' : 's'}`)}`);
+    if (!text)
+        rows.push(`  ${palette.faint('(no output yet)')}`);
+    for (const line of text.split('\n'))
+        if (text)
+            rows.push('  ' + palette.muted(truncateWidth(line, Math.max(8, cols - 4))));
+    return rows;
+}
+/** The notes the model received, short: one row per note (the first line of each). */
+export function noteRows(content) {
+    const body = content.replace(/^\[devx · background tasks\]\n?/, '');
+    return body
+        .split(/\n\n(?=bg\d+ )/)
+        .map((note) => note.split('\n')[0].trim())
+        .filter(Boolean);
+}
+/** `/tasks ...`: returns what to print. Stopping is asynchronous, so this is too. */
+export async function runTasksCommand(args, manager, cols, markSeen) {
+    const [first, second] = args;
+    const word = (first ?? '').toLowerCase();
+    if (!first || word === 'list' || word === 'ls') {
+        markSeen(manager.list().map((t) => t.id));
+        return renderTaskList(manager, cols);
+    }
+    if (word === 'stop' || word === 'kill') {
+        if (!second)
+            return [`  ${palette.warn('!')} ${palette.warn('Usage: /tasks stop <id|all>')}`];
+        if (second === 'all') {
+            const n = await manager.stopAll();
+            return [`  ${palette.ok('✓')} ${palette.text(n === 0 ? 'Nothing was running' : `Stopped ${n} task${n === 1 ? '' : 's'}`)}`];
+        }
+        try {
+            const info = await manager.stop(second);
+            return [`  ${palette.ok('✓')} ${palette.text(`${info.id} ${STATE_LABEL[info.status]}`)}`];
+        }
+        catch (err) {
+            return [`  ${palette.err('✗')} ${palette.err(err.message)}`];
+        }
+    }
+    if (word === 'clear') {
+        const n = manager.clearFinished();
+        return [`  ${palette.ok('✓')} ${palette.text(n === 0 ? 'No ended tasks to remove' : `Removed ${n} ended task${n === 1 ? '' : 's'}`)}`];
+    }
+    // `/tasks bg1`, `/tasks output bg1`, `/tasks logs bg1`
+    const id = ['output', 'logs', 'log', 'show'].includes(word) ? second : first;
+    if (!id)
+        return [`  ${palette.warn('!')} ${palette.warn('Usage: /tasks output <id>')}`];
+    markSeen([id]);
+    return renderTaskOutput(manager, id, cols);
+}

package/dist/cli/banner.js

@@ -1,5 +1,6 @@
 import pc from 'picocolors';
 import { getCurrentTheme } from './theme.js';
+import { DEVX_LOGO } from './logo.js';
 import { DEVX_VERSION } from '../core/types.js';
 export function renderBannerLines(mode = 'full', version = DEVX_VERSION, cols = 80) {
     if (mode === 'off') {
@@ -18,9 +19,7 @@ export function renderBannerLines(mode = 'full', version = DEVX_VERSION, cols =
     if (cols < 68) {
         // Compact ASCII for narrow mobile screens (~26 chars)
         return [
-            theme.colorFn('  █▀▀▄ █▀▀▀ █   █ █   █'),
-            theme.colorFn('  █  █ █▀▀▀  ▀▄▀   ▀▄▀ '),
-            theme.colorFn('  █▄▄▀ █▄▄▄   ▀    ▀ ▀ '),
+            ...DEVX_LOGO.map((l) => '  ' + theme.colorFn(l)),
             '  ' + theme.boldFn(`v${version}`)
         ];
     }

package/dist/cli/finder.js

@@ -0,0 +1,241 @@
+import { LiveBlock } from './liveblock.js';
+import { WORD_BACKSPACE, normalizeKey, splitKeys } from './keys.js';
+import { windowItems } from './picker.js';
+import { palette } from './ui.js';
+import { displayWidth, padEndWidth, tailWidth, truncateWidth, wrapWords } from './width.js';
+import { t } from '../core/i18n.js';
+/** Every word typed must be found in the label, the id or the keywords; matches at the start of the label come first. */
+export function filterItems(items, query) {
+    const words = query.toLowerCase().split(/\s+/).filter(Boolean);
+    const pinned = items.filter((i) => i.pinned);
+    const rest = items.filter((i) => !i.pinned);
+    if (words.length === 0)
+        return [...pinned, ...rest];
+    const scored = [];
+    for (const item of rest) {
+        const hay = `${item.label} ${item.keywords ?? ''}`.toLowerCase();
+        if (!words.every((w) => hay.includes(w)))
+            continue;
+        const label = item.label.toLowerCase();
+        scored.push({ item, score: label.startsWith(words[0]) ? 0 : label.includes(words[0]) ? 1 : 2 });
+    }
+    scored.sort((a, b) => a.score - b.score); // stable: the original order is kept inside a score
+    return [...pinned, ...scored.map((s) => s.item)];
+}
+function hintLine(width, typing) {
+    const variants = [
+        typing
+            ? [['type', t('finder.hint.filter')], ['↑↓', t('picker.hint.move')], ['enter', t('picker.hint.select')], ['esc', t('picker.hint.cancel')]]
+            : [['enter', t('picker.hint.confirm')], ['esc', t('picker.hint.cancel')]],
+        [['↑↓', ''], ['enter', ''], ['esc', '']],
+        [['enter', ''], ['esc', '']],
+    ];
+    for (const items of variants) {
+        const text = items.map(([k, label]) => palette.text(k) + (label ? ' ' + palette.faint(label) : '')).join(palette.faint(items[0][1] ? ' · ' : ' '));
+        if (displayWidth(text) <= width)
+            return text;
+    }
+    return '';
+}
+/** The card around some content rows; `rows` are already padded to the inner width by the caller's `box`. */
+function frame(title, subtitle, cols, body, footer) {
+    if (cols < 60) {
+        const width = Math.max(20, cols - 1);
+        const head = ' ' + palette.bold(palette.accent(title)) + (subtitle ? palette.faint(' · ' + truncateWidth(subtitle, Math.max(6, width - displayWidth(title) - 6))) : '');
+        const plain = (c, shaded = false) => (shaded ? palette.shade(padEndWidth(' ' + c, width)) : ' ' + c);
+        return [head, ...body(width - 1, plain), ' ' + footer];
+    }
+    const W = Math.min(cols - 1, 76);
+    const iw = W - 4;
+    const rule = palette.rule;
+    const box = (content, shaded = false) => rule('│') + (shaded ? palette.shade(' ' + padEndWidth(content, iw) + ' ') : ' ' + padEndWidth(content, iw) + ' ') + rule('│');
+    const head = ' ' + palette.bold(palette.accent(title)) + ' ';
+    const sub = subtitle ? ' ' + palette.muted(truncateWidth(subtitle, Math.max(6, W - 12 - displayWidth(title)))) + ' ' : '';
+    return [
+        rule('╭─') + head + rule('─'.repeat(Math.max(0, W - 4 - displayWidth(head) - displayWidth(sub)))) + sub + rule('─╮'),
+        box(''),
+        ...body(iw, box),
+        rule('╰' + '─'.repeat(W - 2) + '╯'),
+        ' ' + footer,
+    ];
+}
+/** Where the focus starts: on the first match, not on a pinned row such as "type a name". */
+export function firstMatch(shown) {
+    const i = shown.findIndex((item) => !item.pinned);
+    return i === -1 ? 0 : i;
+}
+export function renderFinder(options, query, shown, focus, cols, termRows = 40) {
+    const maxItems = Math.max(3, termRows - 9 - (options.notes?.length ?? 0));
+    return frame(options.title, options.subtitle ?? `${shown.filter((i) => !i.pinned).length}/${options.items.filter((i) => !i.pinned).length}`, cols, (iw, box) => {
+        const lines = [];
+        const typed = query ? palette.text(tailWidth(query, Math.max(4, iw - 6))) : palette.faint(truncateWidth(options.placeholder ?? t('finder.placeholder'), Math.max(4, iw - 6)));
+        lines.push(box(' ' + palette.accent('/') + ' ' + (query ? typed + palette.accent('█') : palette.accent('█') + typed)));
+        lines.push(box(palette.rule('─'.repeat(Math.max(0, iw - 1)))));
+        if (shown.length === 0) {
+            lines.push(box('  ' + palette.faint(t('finder.empty'))));
+        }
+        else {
+            const labelWidth = Math.min(Math.min(options.labelWidth ?? 24, Math.max(...shown.map((i) => displayWidth(i.label)), 4)) + 2, Math.max(10, iw - 12));
+            const rows = shown.map((item, index) => {
+                const focused = index === focus;
+                const isCurrent = options.current !== undefined && item.value === options.current;
+                const mark = focused ? palette.accent('❯') : ' ';
+                const dot = item.pinned ? palette.accent('+') : isCurrent ? palette.accent('●') : palette.faint('○');
+                const label = focused ? palette.bold(palette.text(truncateWidth(item.label, labelWidth - 1))) : palette.muted(truncateWidth(item.label, labelWidth - 1));
+                const prefix = ` ${mark} ${dot} ${padEndWidth(label, labelWidth)}`;
+                const room = Math.max(0, iw - displayWidth(prefix) - 1);
+                const detail = item.detail && room > 6 ? palette.faint(truncateWidth(item.detail, room)) : '';
+                return { text: prefix + detail, index };
+            });
+            for (const r of windowItems(rows, focus, maxItems, iw))
+                lines.push(box(r.text, r.index === focus));
+        }
+        const notes = (options.notes ?? []).flatMap((n) => wrapWords(n, iw - 3));
+        if (notes.length > 0) {
+            lines.push(box(''));
+            for (const line of notes)
+                lines.push(box('  ' + palette.faint(line)));
+        }
+        return lines;
+    }, hintLine(cols - 2, true));
+}
+/** What a key does to a text that is being typed: `undefined` when the key is not an edit. */
+export function editText(value, key) {
+    if (key === '\x7f' || key === '\b')
+        return Array.from(value).slice(0, -1).join('');
+    if (key === WORD_BACKSPACE)
+        return value.replace(/\s*\S*$/, '');
+    if (key === '\x15')
+        return ''; // Ctrl+U
+    if (/^[^\x00-\x1f\x7f\x1b]+$/.test(key))
+        return value + key; // printable text, also a pasted chunk
+    return undefined;
+}
+function openIO(io) {
+    const { input } = io;
+    const wasRaw = !!input.isRaw;
+    input.setRawMode?.(true);
+    input.resume();
+    return () => { if (!wasRaw)
+        input.setRawMode?.(false); };
+}
+/** The list narrowed by typing. Resolves with the chosen value, or undefined when cancelled. */
+export function runFinder(options, io = { input: process.stdin, output: process.stdout }) {
+    return new Promise((resolve) => {
+        const { input, output } = io;
+        const block = new LiveBlock(output);
+        let query = '';
+        let shown = filterItems(options.items, query);
+        const at = shown.findIndex((i) => options.current !== undefined && i.value === options.current);
+        let focus = at >= 0 ? at : firstMatch(shown);
+        let done = false;
+        const rows = () => output.rows || 40;
+        const draw = () => block.draw(renderFinder(options, query, shown, focus, output.columns || 80, rows()));
+        const restore = openIO(io);
+        const finish = (value) => {
+            done = true;
+            input.off('data', onData);
+            block.erase();
+            restore();
+            resolve(value);
+        };
+        const move = (delta) => {
+            const next = Math.max(0, Math.min(shown.length - 1, focus + delta));
+            if (next !== focus) {
+                focus = next;
+                draw();
+            }
+        };
+        const handleKey = (raw) => {
+            const key = normalizeKey(raw);
+            if (key === '\x1b[A' || key === '\x1bOA')
+                return move(-1);
+            if (key === '\x1b[B' || key === '\x1bOB')
+                return move(1);
+            if (key === '\x1b[5~')
+                return move(-8);
+            if (key === '\x1b[6~')
+                return move(8);
+            if (key === '\r' || key === '\n')
+                return shown.length > 0 ? finish(shown[focus].value) : undefined;
+            if (key === '\x1b' || key === '\x03')
+                return finish(undefined);
+            const edited = editText(query, key);
+            if (edited !== undefined && edited !== query) {
+                query = edited;
+                shown = filterItems(options.items, query);
+                focus = firstMatch(shown);
+                draw();
+            }
+        };
+        const onData = (chunk) => {
+            for (const key of splitKeys(chunk.toString())) {
+                if (done)
+                    return;
+                handleKey(key);
+            }
+        };
+        input.on('data', onData);
+        draw();
+    });
+}
+export function renderTextInput(options, value, cols) {
+    return frame(options.title, options.subtitle, cols, (iw, box) => {
+        const lines = [];
+        for (const line of wrapWords(options.label, iw - 2))
+            lines.push(box(' ' + palette.bold(palette.text(line))));
+        const shownValue = options.secret ? '•'.repeat(Array.from(value).length) : value;
+        const room = Math.max(4, iw - 6);
+        const text = value
+            ? palette.text(tailWidth(shownValue, room)) + palette.accent('█')
+            : palette.accent('█') + palette.faint(truncateWidth(options.placeholder ?? '', room));
+        lines.push(box(''));
+        lines.push(box(' ' + palette.accent('❯') + ' ' + text, true));
+        const notes = (options.notes ?? []).flatMap((n) => wrapWords(n, iw - 3));
+        if (notes.length > 0) {
+            lines.push(box(''));
+            for (const line of notes)
+                lines.push(box('  ' + palette.faint(line)));
+        }
+        return lines;
+    }, hintLine(cols - 2, false));
+}
+/** A one-line input. Resolves with the text (never empty), or undefined when cancelled. */
+export function runTextInput(options, io = { input: process.stdin, output: process.stdout }) {
+    return new Promise((resolve) => {
+        const { input, output } = io;
+        const block = new LiveBlock(output);
+        let value = options.initial ?? '';
+        let done = false;
+        const draw = () => block.draw(renderTextInput(options, value, output.columns || 80));
+        const restore = openIO(io);
+        const finish = (result) => {
+            done = true;
+            input.off('data', onData);
+            block.erase();
+            restore();
+            resolve(result);
+        };
+        const handleKey = (raw) => {
+            const key = normalizeKey(raw);
+            if (key === '\r' || key === '\n')
+                return value.trim() ? finish(value.trim()) : undefined;
+            if (key === '\x1b' || key === '\x03')
+                return finish(undefined);
+            const edited = editText(value, key);
+            if (edited !== undefined && edited !== value) {
+                value = edited;
+                draw();
+            }
+        };
+        const onData = (chunk) => {
+            for (const key of splitKeys(chunk.toString())) {
+                if (done)
+                    return;
+                handleKey(key);
+            }
+        };
+        input.on('data', onData);
+        draw();
+    });
+}

package/dist/cli/headless.js

@@ -10,6 +10,7 @@ import { CLIConsoleGuard } from '../permissions/guard.js';
 import { globalSnapshotManager } from '../core/snapshot.js';
 import { UsageTracker } from '../core/usage.js';
 import { MCPManager } from '../mcp/manager.js';
+import { getBackgroundManager } from '../core/background.js';
 export async function runHeadlessMode(userPrompt, config, options = {}) {
     const planMode = !!options.planMode;
     const isYolo = !!options.yolo || !!config.autoApprove;
@@ -48,7 +49,8 @@ export async function runHeadlessMode(userPrompt, config, options = {}) {
             console.log(pc.bold(pc.cyan(`devx v${DEVX_VERSION} (headless) | ${planMode ? 'PLAN' : 'AGENT'} | ${config.model}`)));
             console.log(pc.dim(`Task: ${userPrompt}\n`));
         }
-        for await (const event of agent.run(abortController.signal)) {
+        const bgManager = getBackgroundManager();
+        for await (const event of agent.run(abortController.signal, { takeNotes: () => bgManager.takeNotes(), hasNotes: () => bgManager.hasNotes() })) {
             if (event.type === 'reasoning_delta') {
                 accumulatedReasoning += event.delta;
                 if (!isQuiet && !isJson) {