termux-dev 1.8.1 → 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.1</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

@@ -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.1</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>

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/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) {

package/dist/cli/index.js

@@ -42,6 +42,9 @@ import { SessionExporter } from './export.js';
 import { MCPManager, discoverProjectMcpServers, hashProjectMcpServers, readClaudeServers, removeUserServer, saveUserServers } from '../mcp/manager.js';
 import { writeSecureFile } from '../core/secure-file.js';
 import { applyLocalConfig, persistedConfig, withoutSessionOnlySettings } from '../core/local-config.js';
+import { cloneConfig, mergeConfigChanges } from '../core/config-merge.js';
+import { getBackgroundManager } from '../core/background.js';
+import { backgroundSummary, noteRows, runTasksCommand } from './background-ui.js';
 import { LiveTelemetryTracker } from './telemetry.js';
 import { renderPowerlineStatus, GitStatusCache } from './statusline.js';
 import { formatDiffBox } from './diff.js';
@@ -75,7 +78,18 @@ function maskApiKey(key) {
         return '****';
     return `${key.slice(0, 4)}...${key.slice(-4)}`;
 }
-async function saveConfig(config) {
+/**
+ * What this process last knew of the config file (its own settings after the start-up overrides,
+ * or what it wrote last). A save writes only the difference to it, see core/config-merge.ts.
+ */
+let configBaseline = null;
+let saveChain = Promise.resolve();
+/** Call once the start-up overrides (-m, project config) are applied: those are not saved by accident. */
+function markConfigBaseline(config) {
+    syncKeyMaps(config);
+    configBaseline = cloneConfig(persistedConfig(config));
+}
+function syncKeyMaps(config) {
     config.apiKeys = config.apiKeys || {};
     config.baseUrls = config.baseUrls || {};
     if (config.provider && config.apiKey) {
@@ -84,10 +98,38 @@ async function saveConfig(config) {
     if (config.provider && config.baseUrl) {
         config.baseUrls[config.provider] = config.baseUrl;
     }
+}
+async function writeConfigFile(config) {
+    syncKeyMaps(config);
     // Runtime-only flags and YOLO (one run only) must not end up in the user's config file.
-    const persisted = persistedConfig(config);
-    // The file holds API keys: owner-only permissions (0600).
-    await writeSecureFile(CONFIG_PATH, JSON.stringify(persisted, null, 2));
+    const mine = cloneConfig(persistedConfig(config));
+    // Another devx may have saved since we looked: write only our own changes on top of the file.
+    let disk = null;
+    try {
+        const parsed = JSON.parse(await fs.readFile(CONFIG_PATH, 'utf8'));
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+            disk = withoutSessionOnlySettings(parsed);
+    }
+    catch { }
+    const merged = disk ? mergeConfigChanges(configBaseline ?? {}, mine, disk) : mine;
+    // The file holds API keys: owner-only permissions (0600). Written aside and renamed, so a second
+    // process never reads half a file.
+    const tmp = `${CONFIG_PATH}.${process.pid}.tmp`;
+    try {
+        await writeSecureFile(tmp, JSON.stringify(merged, null, 2));
+        await fs.rename(tmp, CONFIG_PATH);
+    }
+    catch (err) {
+        await fs.rm(tmp, { force: true }).catch(() => null);
+        throw err;
+    }
+    configBaseline = mine;
+}
+async function saveConfig(config) {
+    // One save at a time inside this process; the read-merge-write of the next one sees the previous.
+    const run = saveChain.then(() => writeConfigFile(config));
+    saveChain = run.catch(() => undefined);
+    return run;
 }
 async function fetchModels(baseUrl, apiKey) {
     try {
@@ -768,6 +810,8 @@ export async function main() {
         config.model = options.model;
         config.maxContextTokens = resolveContextLimit({ ...config, maxContextTokens: 0 }).limit;
     }
+    // -m and the project config are for this run: only what changes from here on is saved.
+    markConfigBaseline(config);
     if (options.yolo) {
         config.autoApprove = true;
     }
@@ -857,6 +901,10 @@ export async function main() {
     const checkpoints = [];
     // What the user allowed on the approval card for this session ("Session"); "Always" goes to the config.
     const permissionMemory = newPermissionMemory();
+    // Commands the agent keeps running in the background (servers, watchers): shown in the prompt frame, listed by /tasks.
+    const bg = getBackgroundManager();
+    const seenBgFailures = new Set();
+    const bgSummary = () => backgroundSummary(bg, seenBgFailures);
     // The most a session may cost (USD, 0 = no limit); "continue" at the limit raises it for this session only.
     let costLimitRaised = null;
     let costWarned = false;
@@ -885,6 +933,11 @@ export async function main() {
     // and start from a clean slate: history, cost, usage counters, undo stack, screen.
     const startFreshSession = async () => {
         sessionManager.startNewSession(config.model, planMode);
+        // The tasks belonged to the conversation that is being left.
+        await bg.stopAll().catch(() => 0);
+        bg.clearFinished();
+        bg.takeNotes();
+        seenBgFailures.clear();
         transcript.length = 0;
         checkpoints.length = 0;
         windowTitle = '';
@@ -965,6 +1018,8 @@ export async function main() {
             }
         }
         let answer = '';
+        // Set when this turn starts by itself, from the news of a background task (not from the user).
+        let wakeNotes = '';
         if (autoTriggerPrompt) {
             answer = autoTriggerPrompt;
             autoTriggerPrompt = '';
@@ -996,7 +1051,19 @@ export async function main() {
                 dirty: GitStatusCache.getStatus()?.isDirty,
                 contextPercent: usagePercent,
                 cost: sessionCost.total,
-                costState: sessionCost.state()
+                costState: sessionCost.state(),
+                background: bgSummary,
+                subscribe: (signal) => {
+                    const onChange = () => signal('redraw');
+                    // A task ended or printed what the agent asked to hear about: the agent takes it up by itself.
+                    const onNote = () => signal(config.backgroundAutoWake === false ? 'redraw' : 'wake');
+                    bg.on('change', onChange);
+                    bg.on('note', onNote);
+                    return () => {
+                        bg.off('change', onChange);
+                        bg.off('note', onNote);
+                    };
+                },
             });
             if (inputStr.startsWith('__TOGGLE_MODE__:')) {
                 currentDraft = inputStr.slice('__TOGGLE_MODE__:'.length);
@@ -1011,19 +1078,31 @@ export async function main() {
                 }
                 continue;
             }
-            currentDraft = '';
-            if (inputStr === '__CANCEL__') {
-                const confirmExit = await askConfirm({ title: t('confirm.exitTitle'), question: t('confirm.exit'), record: false });
-                if (confirmExit) {
-                    resetTerminalTheme();
-                    printFarewell(t('confirm.goodbye'));
-                    break;
-                }
-                else {
+            if (inputStr.startsWith('__WAKE__:')) {
+                // The prompt was closed by news from a background task: the agent answers it. What was typed stays.
+                currentDraft = inputStr.slice('__WAKE__:'.length);
+                wakeNotes = bg.takeNotes();
+                if (!wakeNotes)
                     continue;
+                console.log(noteRows(wakeNotes).map((r) => renderNotice('info', r)).join('\n'));
+                console.log();
+                answer = wakeNotes;
+            }
+            else {
+                currentDraft = '';
+                if (inputStr === '__CANCEL__') {
+                    const confirmExit = await askConfirm({ title: t('confirm.exitTitle'), question: t('confirm.exit'), record: false });
+                    if (confirmExit) {
+                        resetTerminalTheme();
+                        printFarewell(t('confirm.goodbye'));
+                        break;
+                    }
+                    else {
+                        continue;
+                    }
                 }
+                answer = inputStr.trim();
             }
-            answer = inputStr.trim();
         }
         if (!answer)
             continue;
@@ -1045,7 +1124,7 @@ export async function main() {
                     '/settings', '/update', '/model', '/provider', '/providers',
                     '/plan', '/agent', '/image', '/serve', '/memory', '/permissions', '/copy', '/rename', '/title', '/rewind', '/undo',
                     '/diff', '/commit', '/status', '/compact', '/init', '/doctor',
-                    '/config', '/clear', '/exit', '/quit', '/help', '/effort'
+                    '/config', '/clear', '/exit', '/quit', '/help', '/effort', '/tasks', '/bg', '/jobs'
                 ];
                 if (!VALID_COMMANDS.includes(cmd)) {
                     const customList = await CustomCommandManager.listCommands();
@@ -1070,6 +1149,7 @@ export async function main() {
                         { name: '/plan         - Switch to PLAN mode (architect)', value: '/plan' },
                         { name: '/agent        - Switch to AGENT mode (coder)', value: '/agent' },
                         { name: '/serve        - Start local web server for web preview', value: '/serve' },
+                        { name: '/tasks        - Background tasks (list, output, stop)', value: '/tasks' },
                         { name: '/memory       - View or edit project memory bank', value: '/memory' },
                         { name: '/permissions  - What is allowed without asking', value: '/permissions' },
                         { name: '/copy         - Copy the last answer to the clipboard', value: '/copy' },
@@ -1471,6 +1551,12 @@ export async function main() {
                 await runDoctor(config);
                 continue;
             }
+            if (cmd === '/tasks' || cmd === '/bg' || cmd === '/jobs') {
+                const rows = await runTasksCommand(parts.slice(1).filter(Boolean), bg, process.stdout.columns || 80, (ids) => ids.forEach((id) => seenBgFailures.add(id)));
+                console.log(rows.join('\n'));
+                console.log();
+                continue;
+            }
             if (cmd === '/serve') {
                 const sub = parts[1]?.toLowerCase();
                 if (sub === 'stop') {
@@ -1897,7 +1983,10 @@ export async function main() {
             }
         }
         // Resolve @file and @image mentions
-        const { text: cleanAnswer, attachments, images, warnings: attachWarnings } = await resolveAtMentions(answer);
+        // News from a background task is output of a program, not a message of the user: no @file in it is read.
+        const { text: cleanAnswer, attachments, images, warnings: attachWarnings } = wakeNotes
+            ? { text: answer, attachments: [], images: [], warnings: [] }
+            : await resolveAtMentions(answer);
         for (const warning of attachWarnings)
             log.warn(warning);
         let finalContent = cleanAnswer;
@@ -1938,9 +2027,12 @@ export async function main() {
             if (turnCheckpoint)
                 checkpoints.push(turnCheckpoint);
         }
-        transcript.push({ kind: 'user', text: answer });
+        if (wakeNotes)
+            transcript.push({ kind: 'raw', rows: noteRows(wakeNotes).map((r) => renderNotice('info', r)) });
+        else
+            transcript.push({ kind: 'user', text: answer });
         // Until the model has named the chat, the start of the first message stands in for the name.
-        if (!windowTitle && !sessionManager.hasGeneratedTitle)
+        if (!wakeNotes && !windowTitle && !sessionManager.hasGeneratedTitle)
             setWindowTitle(provisionalTitle(answer));
         history.addMessage({
             role: 'user',
@@ -2262,8 +2354,12 @@ export async function main() {
                 contextPercent: Math.min(100, Math.round((used / (config.maxContextTokens || getModelContextLimit(config.model))) * 100)),
                 cost: sessionCost.total,
                 costState: sessionCost.state(),
+                background: bgSummary(),
             };
         }, undefined, statusLine, sendQueuedNow);
+        // A task started or ended during the turn: the frame shows the new count.
+        const onBgChange = () => composer.refresh();
+        bg.on('change', onBgChange);
         composer.live = liveThought;
         composer.onToggle = toggleView;
         const releasePauseHook = registerPauseHook(() => {
@@ -2320,6 +2416,8 @@ export async function main() {
             for await (const event of agent.run(abortController.signal, {
                 takePending: async () => Promise.all(composer.takeQueued().map(queuedToMessage)),
                 hasPending: () => composer.hasQueued(),
+                takeNotes: () => bg.takeNotes(),
+                hasNotes: () => bg.hasNotes(),
             })) {
                 if (aborted)
                     break;
@@ -2609,6 +2707,22 @@ export async function main() {
                     else
                         log.info(event.message);
                 }
+                else if (event.type === 'background_note') {
+                    // A background task ended or printed what the agent asked to hear about.
+                    if (spinnerActive) {
+                        s.stop();
+                        spinnerActive = false;
+                    }
+                    finishThinking(true);
+                    streamer.finish();
+                    endText();
+                    const rows = noteRows(event.content);
+                    transcript.push({ kind: 'raw', rows: rows.map((r) => renderNotice('info', r)) });
+                    for (const row of rows)
+                        console.log(cleanUi ? renderNotice('info', row) : pc.dim(row));
+                    s.start(cleanUi ? t('status.waiting') : 'Connecting...');
+                    spinnerActive = true;
+                }
             }
             finishThinking(true);
             streamer.finish();
@@ -2619,6 +2733,7 @@ export async function main() {
             endText();
             // Hand the bottom of the screen back. Whatever was typed but not sent waits in the next prompt;
             // a message that arrived too late for the agent starts the next turn by itself.
+            bg.off('change', onBgChange);
             const leftover = composer.stop();
             if (interruptPrompt) {
                 autoTriggerPrompt = interruptPrompt;
@@ -2744,6 +2859,7 @@ export async function main() {
             }
         }
         finally {
+            bg.off('change', onBgChange);
             const unsent = composer.stop();
             if (process.stdout.isTTY)
                 process.stdout.write('\x1b[?1004l');

package/dist/cli/prompt.js

@@ -6,7 +6,7 @@ import { CustomCommandManager } from '../core/commands.js';
 import { formatPromptHeader } from './modeborder.js';
 import { filterCommandPalette, estimatePromptTokens, formatPromptTokenBadge } from './prompt_palette.js';
 import { PromptHistoryNavigator } from './history_search.js';
-import { buildPromptFrame, palette, renderUserEcho, resolveMode } from './ui.js';
+import { buildPromptFrame, moveCursorRow, palette, renderUserEcho, resolveMode } from './ui.js';
 import { padEndWidth, truncateWidth } from './width.js';
 export const SLASH_COMMANDS = [
     { cmd: '/new', desc: 'Start a new clean chat session' },
@@ -27,6 +27,7 @@ export const SLASH_COMMANDS = [
     { cmd: '/agent', desc: 'Switch to AGENT mode (coder & executor)' },
     { cmd: '/image', desc: 'Paste the image from the clipboard (same as Ctrl+V or Alt+V)' },
     { cmd: '/serve', desc: 'Start local web server for web/game preview' },
+    { cmd: '/tasks', desc: 'Background tasks: list, /tasks <id> output, /tasks stop <id|all>' },
     { cmd: '/copy', desc: 'Copy the last answer of the AI to the clipboard' },
     { cmd: '/rewind', desc: 'Go back to one of your messages: the chat after it is removed' },
     { cmd: '/rename', desc: 'Rename the chat (/rename <name>), or let the AI name it again' },
@@ -141,6 +142,7 @@ export function askPrompt(opts = {}) {
                 contextPercent: opts.contextPercent ?? 0,
                 cost: opts.cost ?? 0,
                 costState: opts.costState,
+                background: opts.background?.(),
                 input,
                 cursorPos,
                 placeholder,
@@ -180,6 +182,35 @@ export function askPrompt(opts = {}) {
             render();
         };
         process.stdout.on('resize', onResize);
+        const unsubscribeOwner = opts.subscribe?.((kind) => {
+            if (disposed)
+                return;
+            if (kind === 'redraw') {
+                render();
+                return;
+            }
+            // News for the model: close the prompt, the owner starts a turn. What was typed is kept.
+            if (cleanLayout)
+                eraseFrame();
+            else
+                process.stdout.write(`\x1b[0m\r\x1b[2K`);
+            cleanup();
+            resolve(`__WAKE__:${input}`);
+        });
+        /** Up / down inside a text that wraps onto several rows; false when there is no row to go to (history takes over). */
+        function moveInInput(dir) {
+            if (!cleanLayout)
+                return false;
+            let to = moveCursorRow(input, cursorPos, process.stdout.columns || 80, dir);
+            if (to === null)
+                return false;
+            // Never land inside an attachment tag: go to its start.
+            const inside = getTagSpans().find((sp) => to > sp.start && to < sp.end);
+            if (inside)
+                to = inside.start;
+            cursorPos = to;
+            return true;
+        }
         function getTagSpans() {
             const spans = [];
             const regex = new RegExp(`\\[Pasted text #\\d+ \\+\\d+ lines\\]|${IMAGE_TAG_SOURCE}`, 'g');
@@ -505,6 +536,7 @@ export function askPrompt(opts = {}) {
         render();
         function cleanup() {
             disposed = true;
+            unsubscribeOwner?.();
             if (process.stdout.isTTY) {
                 process.stdout.write('\x1b[?2004l');
             }
@@ -696,6 +728,9 @@ export function askPrompt(opts = {}) {
                     selectedIndex = Math.max(0, selectedIndex - 1); // stops at the first item
                     render();
                 }
+                else if (moveInInput(-1)) {
+                    render();
+                }
                 else {
                     const prev = historyNav.navigateUp(input);
                     if (prev !== null) {
@@ -712,6 +747,9 @@ export function askPrompt(opts = {}) {
                     selectedIndex = Math.min(items.length - 1, selectedIndex + 1); // stops at the last item
                     render();
                 }
+                else if (moveInInput(1)) {
+                    render();
+                }
                 else {
                     const next = historyNav.navigateDown();
                     if (next !== null) {