u-foo 1.2.13 → 1.2.16

package/src/chat/index.js

@@ -34,7 +34,6 @@ const { createInputListenerController } = require("./inputListenerController");
 const { createDaemonMessageRouter } = require("./daemonMessageRouter");
 const { createChatLogController } = require("./chatLogController");
 const { createPasteController } = require("./pasteController");
-const { createCronScheduler } = require("./cronScheduler");
 const { createAgentViewController } = require("./agentViewController");
 const { createSettingsController } = require("./settingsController");
 const { createChatLayout } = require("./layout");
@@ -87,12 +86,7 @@ async function runChat(projectRoot) {
   let agentProvider = config.agentProvider;
   let assistantEngine = normalizeAssistantEngine(config.assistantEngine);
   let autoResume = config.autoResume !== false;
-  let cronScheduler = {
-    addTask: () => null,
-    listTasks: () => [],
-    stopTask: () => false,
-    stopAll: () => 0,
-  };
+  let cronTasks = [];
 
   // Dynamic input height settings
   // Layout: topLine(1) + content + bottomLine(1) + dashboard(1)
@@ -319,7 +313,6 @@ async function runChat(projectRoot) {
     if (daemonCoordinator) {
       daemonCoordinator.markExit();
     }
-    cronScheduler.stopAll();
     exitAgentView();
     if (screen && screen.program && typeof screen.program.decrst === "function") {
       screen.program.decrst(2004);
@@ -724,21 +717,6 @@ async function runChat(projectRoot) {
     daemonCoordinator.send(req);
   }
 
-  cronScheduler = createCronScheduler({
-    dispatch: ({ taskId, target, message }) => {
-      send({
-        type: IPC_REQUEST_TYPES.BUS_SEND,
-        target,
-        message,
-      });
-      queueStatusLine(`cron:${taskId} -> ${target}`);
-    },
-    onChange: () => {
-      renderDashboard();
-      screen.render();
-    },
-  });
-
   function updatePromptBox() {
     if (targetAgent) {
       const label = getAgentLabel(targetAgent);
@@ -907,7 +885,7 @@ async function runChat(projectRoot) {
       selectedProviderIndex,
       selectedAssistantIndex,
       selectedResumeIndex,
-      cronTasks: cronScheduler.listTasks(),
+      cronTasks,
       providerOptions,
       assistantOptions,
       resumeOptions,
@@ -923,6 +901,7 @@ async function runChat(projectRoot) {
     reportPendingTotal = Number.isFinite(status?.reports?.pending_total)
       ? status.reports.pending_total
       : 0;
+    cronTasks = Array.isArray(status?.cron?.tasks) ? status.cron.tasks : [];
     const metaList = Array.isArray(status.active_meta) ? status.active_meta : [];
     let fallbackMap = null;
     if (metaList.length === 0 && activeAgents.length > 0) {
@@ -1018,7 +997,7 @@ async function runChat(projectRoot) {
     agentProvider: { get: () => agentProvider },
     assistantEngine: { get: () => assistantEngine },
     autoResume: { get: () => autoResume },
-    cronTasks: { get: () => cronScheduler.listTasks() },
+    cronTasks: { get: () => cronTasks },
     providerOptions: { get: () => providerOptions },
     assistantOptions: { get: () => assistantOptions },
     resumeOptions: { get: () => resumeOptions },
@@ -1225,10 +1204,12 @@ async function runChat(projectRoot) {
     restartDaemon,
     send,
     requestStatus,
-    createCronTask: ({ intervalMs, targets, prompt }) =>
-      cronScheduler.addTask({ intervalMs, targets, prompt }),
-    listCronTasks: () => cronScheduler.listTasks(),
-    stopCronTask: (id) => cronScheduler.stopTask(id),
+    requestCron: (payload = {}) => {
+      send({
+        type: IPC_REQUEST_TYPES.CRON,
+        ...payload,
+      });
+    },
     activateAgent: async (target) => {
       const activator = new AgentActivator(projectRoot);
       await activator.activate(target);

package/src/cli/onlineCoreCommands.js

@@ -65,7 +65,7 @@ async function runOnlineToken(subscriber, opts = {}) {
   const { generateToken, setToken, defaultTokensPath } = require("../online/tokens");
   const filePath = opts.file || defaultTokensPath();
   const token = generateToken();
-  const entry = setToken(filePath, subscriber, token, opts.server || "", {
+  const entry = setToken(filePath, subscriber, token, opts.server || "https://online.ufoo.dev", {
     nickname: opts.nickname || "",
   });
   console.log(JSON.stringify({
@@ -79,7 +79,7 @@ async function runOnlineToken(subscriber, opts = {}) {
 }
 
 async function runOnlineRoom(action, opts = {}, onlineAuthHeaders) {
-  const base = opts.server || "http://127.0.0.1:8787";
+  const base = opts.server || "https://online.ufoo.dev";
   const endpoint = `${base.replace(/\/$/, "")}/ufoo/online/rooms`;
   const authHeaders = buildAuthHeaders(onlineAuthHeaders, {
     authToken: opts.authToken,
@@ -116,7 +116,7 @@ async function runOnlineRoom(action, opts = {}, onlineAuthHeaders) {
 }
 
 async function runOnlineChannel(action, opts = {}, onlineAuthHeaders) {
-  const base = opts.server || "http://127.0.0.1:8787";
+  const base = opts.server || "https://online.ufoo.dev";
   const endpoint = `${base.replace(/\/$/, "")}/ufoo/online/channels`;
   const authHeaders = buildAuthHeaders(onlineAuthHeaders, {
     authToken: opts.authToken,
@@ -160,7 +160,7 @@ async function runOnlineConnect(opts = {}) {
     projectRoot: opts.projectRoot || process.cwd(),
     nickname: opts.nickname,
     subscriberId: opts.subscriber || "",
-    url: opts.url || "ws://127.0.0.1:8787/ufoo/online",
+    url: opts.url || "wss://online.ufoo.dev/ufoo/online",
     token: opts.token || "",
     tokenHash: opts.tokenHash || "",
     tokenFile: opts.tokenFile || "",
@@ -220,12 +220,12 @@ async function runOnlineCommand(subcmd, payload = {}, options = {}) {
       case "token":
         return runOnlineToken(payload.subscriber, {
           nickname: opts.nickname || "",
-          server: opts.server || "",
+          server: opts.server || "https://online.ufoo.dev",
           file: opts.file || "",
         });
       case "room":
         return runOnlineRoom(payload.action, {
-          server: opts.server || "http://127.0.0.1:8787",
+          server: opts.server || "https://online.ufoo.dev",
           authToken: opts.authToken || "",
           tokenFile: opts.tokenFile || "",
           subscriber: opts.subscriber || "",
@@ -236,7 +236,7 @@ async function runOnlineCommand(subcmd, payload = {}, options = {}) {
         }, onlineAuthHeaders);
       case "channel":
         return runOnlineChannel(payload.action, {
-          server: opts.server || "http://127.0.0.1:8787",
+          server: opts.server || "https://online.ufoo.dev",
           authToken: opts.authToken || "",
           tokenFile: opts.tokenFile || "",
           subscriber: opts.subscriber || "",
@@ -297,14 +297,14 @@ async function runOnlineCommand(subcmd, payload = {}, options = {}) {
       const subscriber = argv[1];
       return runOnlineToken(subscriber, {
         nickname: getFallbackOpt(argv, "--nickname"),
-        server: getFallbackOpt(argv, "--server"),
+        server: getFallbackOpt(argv, "--server") || "https://online.ufoo.dev",
         file: getFallbackOpt(argv, "--file"),
       });
     }
     case "room": {
       const action = argv[1] || "";
       return runOnlineRoom(action, {
-        server: getFallbackOpt(argv, "--server") || "http://127.0.0.1:8787",
+        server: getFallbackOpt(argv, "--server") || "https://online.ufoo.dev",
         authToken: getFallbackOpt(argv, "--auth-token"),
         tokenFile: getFallbackOpt(argv, "--token-file"),
         subscriber: getFallbackOpt(argv, "--subscriber"),
@@ -318,7 +318,7 @@ async function runOnlineCommand(subcmd, payload = {}, options = {}) {
       const action = argv[1] || "";
       const defaultChannelType = options.defaultChannelType || "public";
       return runOnlineChannel(action, {
-        server: getFallbackOpt(argv, "--server") || "http://127.0.0.1:8787",
+        server: getFallbackOpt(argv, "--server") || "https://online.ufoo.dev",
         authToken: getFallbackOpt(argv, "--auth-token"),
         tokenFile: getFallbackOpt(argv, "--token-file"),
         subscriber: getFallbackOpt(argv, "--subscriber"),
@@ -339,7 +339,7 @@ async function runOnlineCommand(subcmd, payload = {}, options = {}) {
         projectRoot: options.projectRoot || process.cwd(),
         nickname: getFallbackOpt(argv, "--nickname"),
         subscriber: getFallbackOpt(argv, "--subscriber"),
-        url: getFallbackOpt(argv, "--url") || "ws://127.0.0.1:8787/ufoo/online",
+        url: getFallbackOpt(argv, "--url") || "wss://online.ufoo.dev/ufoo/online",
         token: getFallbackOpt(argv, "--token"),
         tokenHash: getFallbackOpt(argv, "--token-hash"),
         tokenFile: getFallbackOpt(argv, "--token-file"),

package/src/cli.js

@@ -247,6 +247,45 @@ async function runCli(argv) {
         const repoRoot = getPackageRoot();
         run(process.execPath, [path.join(repoRoot, "bin", "ufoo.js"), "chat"]);
       });
+    program
+      .command("launch")
+      .description("Launch an agent (ucode, uclaude, ucodex)")
+      .argument("<agent>", "Agent type: ucode|uclaude|ucodex|claude|codex")
+      .argument("[nickname]", "Optional nickname for the agent")
+      .action(async (agent, nickname) => {
+        try {
+          const projectRoot = process.cwd();
+          await ensureDaemonRunning(projectRoot);
+
+          // Normalize agent type
+          const agentLower = agent.toLowerCase();
+          let normalizedAgent = "";
+          if (agentLower === "ucode" || agentLower === "ufoo-code" || agentLower === "ufoo") {
+            normalizedAgent = "ucode";
+          } else if (agentLower === "uclaude" || agentLower === "claude-code" || agentLower === "claude") {
+            normalizedAgent = "claude";
+          } else if (agentLower === "ucodex" || agentLower === "codex" || agentLower === "openai") {
+            normalizedAgent = "codex";
+          } else {
+            console.error(`Unknown agent type: ${agent}`);
+            console.error("Valid types: ucode, uclaude, ucodex, claude, codex");
+            process.exitCode = 1;
+            return;
+          }
+
+          const resp = await sendDaemonRequest(projectRoot, {
+            type: "launch_agent",
+            agent: normalizedAgent,
+            nickname: nickname || "",
+            count: 1,
+          });
+          const reply = resp?.data?.reply || `Launching ${normalizedAgent} agent...`;
+          console.log(reply);
+        } catch (err) {
+          console.error(err.message || String(err));
+          process.exitCode = 1;
+        }
+      });
     program
       .command("resume")
       .description("Resume agent sessions (optional nickname)")
@@ -550,7 +589,7 @@ async function runCli(argv) {
       .description("Generate and store a ufoo-online token")
       .argument("<subscriber>", "Subscriber ID (e.g., claude-code:abc123)")
       .option("--nickname <name>", "Nickname for this agent")
-      .option("--server <url>", "Online server URL")
+      .option("--server <url>", "Online server URL", "https://online.ufoo.dev")
       .option("--file <path>", "Tokens file path")
       .action(async (subscriber, opts) => {
         try {
@@ -569,7 +608,7 @@ async function runCli(argv) {
       .command("room")
       .description("Manage online rooms (HTTP)")
       .argument("<action>", "create|list")
-      .option("--server <url>", "Online server base URL (http://host:port)")
+      .option("--server <url>", "Online server base URL (default: https://online.ufoo.dev)")
       .option("--auth-token <token>", "Bearer token for HTTP auth (token or token_hash)")
       .option("--token-file <path>", "Token file path for auth lookup")
       .option("--subscriber <id>", "Subscriber ID to resolve token")
@@ -594,7 +633,7 @@ async function runCli(argv) {
       .command("channel")
       .description("Manage online channels (HTTP)")
       .argument("<action>", "create|list")
-      .option("--server <url>", "Online server base URL (http://host:port)")
+      .option("--server <url>", "Online server base URL (default: https://online.ufoo.dev)")
       .option("--auth-token <token>", "Bearer token for HTTP auth (token or token_hash)")
       .option("--token-file <path>", "Token file path for auth lookup")
       .option("--subscriber <id>", "Subscriber ID to resolve token")
@@ -618,7 +657,7 @@ async function runCli(argv) {
       .command("connect")
       .description("Connect to ufoo-online relay (long-running)")
       .requiredOption("--nickname <name>", "Agent nickname")
-      .option("--url <url>", "WebSocket URL", "ws://127.0.0.1:8787/ufoo/online")
+      .option("--url <url>", "WebSocket URL", "wss://online.ufoo.dev/ufoo/online")
       .option("--subscriber <id>", "Subscriber ID (auto-generated if omitted)")
       .option("--token <tok>", "Auth token")
       .option("--token-hash <hash>", "Auth token hash")

package/src/code/agent.js

@@ -43,6 +43,14 @@ function normalizeLine(input = "") {
   return String(input || "").trim();
 }
 
+function parseProbeMarkerCommand(input = "") {
+  const text = String(input || "").trim();
+  if (!text) return "";
+  // Accept only strict probe markers: "<prefix> <single-marker-token>".
+  const match = text.match(/^(?:\$ufoo|\/ufoo|ufoo)\s+([A-Za-z0-9][A-Za-z0-9._:-]{0,63})$/);
+  return match ? String(match[1] || "").trim() : "";
+}
+
 function parseJson(text = "") {
   const raw = String(text || "").trim();
   if (!raw) return {};
@@ -1209,16 +1217,18 @@ function runSingleCommand(line = "", workspaceRoot = process.cwd()) {
         "  help",
         "  exit|quit",
         "  ubus|/ubus",
+        "  bg|/bg <task>",
         "  resume <session-id>",
         "  tool <read|write|edit|bash> <args-json>",
         "  run <read|write|edit|bash> <args-json>",
       ].join("\n"),
     };
   }
-  if (text.startsWith("$ufoo ") || text.startsWith("/ufoo ") || text.startsWith("ufoo ")) {
+  const probeMarker = parseProbeMarkerCommand(text);
+  if (probeMarker) {
     return {
       kind: "probe",
-      output: text.split(/\s+/).slice(1).join(" ").trim(),
+      marker: probeMarker,
     };
   }
   if (text === "ubus" || text === "/ubus") {
@@ -1226,6 +1236,26 @@ function runSingleCommand(line = "", workspaceRoot = process.cwd()) {
       kind: "ubus",
     };
   }
+  if (text === "bg" || text === "/bg") {
+    return {
+      kind: "error",
+      output: "usage: bg <task>",
+    };
+  }
+  const bgMatch = text.match(/^(?:\/bg|bg)\s+(.+)$/i);
+  if (bgMatch) {
+    const task = String(bgMatch[1] || "").trim();
+    if (!task) {
+      return {
+        kind: "error",
+        output: "usage: bg <task>",
+      };
+    }
+    return {
+      kind: "nl_bg",
+      task,
+    };
+  }
   const resumeMatch = text.match(/^resume(?:\s+(.+))?$/i);
   if (resumeMatch) {
     const session = String(resumeMatch[1] || "").trim();
@@ -1345,6 +1375,8 @@ async function runUcodeCoreAgent({
   });
   return new Promise((resolve) => {
     let chain = Promise.resolve();
+    let backgroundSeq = 0;
+    const backgroundRuns = new Map();
     const subscriberId = String(process.env.UFOO_SUBSCRIBER_ID || "").trim();
     const autoBusEnabled = shouldAutoConsumeBus(subscriberId);
     let autoBusTimer = null;
@@ -1400,6 +1432,38 @@ async function runUcodeCoreAgent({
       scheduleAutoBus();
     }
 
+    const startBackgroundTask = (task = "") => {
+      backgroundSeq += 1;
+      const jobId = `bg-${Date.now().toString(36)}-${backgroundSeq.toString(36)}`;
+      const bgState = {
+        workspaceRoot: state.workspaceRoot,
+        provider: state.provider,
+        model: state.model,
+        engine: state.engine,
+        context: state.context,
+        nlMessages: Array.isArray(state.nlMessages) ? state.nlMessages.slice() : [],
+        sessionId: "",
+        timeoutMs: state.timeoutMs,
+        jsonOutput: false,
+      };
+      const run = runNaturalLanguageTask(task, bgState)
+        .then((nlResult) => {
+          const summary = String(formatNlResult(nlResult, false) || "").trim();
+          const title = nlResult && nlResult.ok ? "done" : "failed";
+          stdout.write(`[${jobId}] ${title}: ${summary || "no summary"}\n`);
+          printPrompt();
+        })
+        .catch((err) => {
+          stdout.write(`[${jobId}] failed: ${err && err.message ? err.message : "background task failed"}\n`);
+          printPrompt();
+        })
+        .finally(() => {
+          backgroundRuns.delete(jobId);
+        });
+      backgroundRuns.set(jobId, run);
+      return jobId;
+    };
+
     const handleLine = async (line) => {
       const runtimeWorkspace = String(state.workspaceRoot || workspaceRoot || process.cwd());
       const result = runSingleCommand(line, runtimeWorkspace);
@@ -1407,7 +1471,10 @@ async function runUcodeCoreAgent({
         rl.close();
         return;
       }
-      if (result.kind === "help" || result.kind === "probe" || result.kind === "tool" || result.kind === "error") {
+      if (result.kind === "probe") {
+        return;
+      }
+      if (result.kind === "help" || result.kind === "tool" || result.kind === "error") {
         stdout.write(`${result.output}\n`);
       }
       if (result.kind === "ubus") {
@@ -1442,6 +1509,10 @@ async function runUcodeCoreAgent({
           stdout.write(`Resumed session ${resumed.sessionId} (${resumed.restoredMessages} messages).\n`);
         }
       }
+      if (result.kind === "nl_bg") {
+        const jobId = startBackgroundTask(result.task);
+        stdout.write(`[${jobId}] started in background.\n`);
+      }
       if (result.kind === "nl") {
         let streamBuffer = null;
         let streamedVisible = false;

package/src/code/tui.js

@@ -468,7 +468,7 @@ function runUcodeTui({
 } = {}) {
   return new Promise((resolve) => {
     const blessed = require("blessed");
-    const { execSync } = require("child_process");
+    const { execFileSync } = require("child_process");
     const { createChatLayout } = require("../chat/layout");
     const { computeDashboardContent } = require("../chat/dashboardView");
     const { escapeBlessed, stripBlessedTags } = require("../chat/text");
@@ -490,6 +490,8 @@ function runUcodeTui({
     let agentListWindowStart = 0;
     let agentSelectionMode = false;
     let pendingTask = null;
+    const backgroundTasks = new Map();
+    let backgroundSeq = 0;
     const logRenderState = { inCodeBlock: false };
     const inputHistory = [];
     let historyIndex = -1;
@@ -900,12 +902,27 @@ function runUcodeTui({
     };
 
     const updateStatus = (message = "", type = "thinking", options = {}) => {
+      const getBackgroundSuffix = () => {
+        if (!backgroundTasks || backgroundTasks.size === 0) return "";
+        let running = 0;
+        let done = 0;
+        let failed = 0;
+        for (const task of backgroundTasks.values()) {
+          const status = String(task && task.status || "").trim().toLowerCase();
+          if (status === "running") running += 1;
+          else if (status === "done") done += 1;
+          else if (status === "failed") failed += 1;
+        }
+        const total = running + done + failed;
+        if (total <= 0) return "";
+        return ` · BG ${running}/${done}/${failed}`;
+      };
       if (statusInterval) {
         clearInterval(statusInterval);
         statusInterval = null;
       }
       if (!message) {
-        statusLine.setContent("{bold}UCODE{/bold} · Ready");
+        statusLine.setContent(escapeBlessed(`UCODE · Ready${getBackgroundSuffix()}`));
         screen.render();
         return;
       }
@@ -918,7 +935,7 @@ function runUcodeTui({
         const timerText = showTimer
           ? ` (${formatPendingElapsed(Date.now() - startedAt)}，esc cancel)`
           : "";
-        statusLine.setContent(escapeBlessed(`${indicator} ${message}${timerText}`));
+        statusLine.setContent(escapeBlessed(`${indicator} ${message}${timerText}${getBackgroundSuffix()}`));
         statusIndex += 1;
         screen.render();
       };
@@ -960,39 +977,63 @@ function runUcodeTui({
         autoBusError = "";
         return;
       }
-      const ubusResult = await runUbusCommand(state, {
-        workspaceRoot,
-        subscriberId: autoBusSubscriberId,
-        onMessageReceived: (msg) => {
-          // Display the incoming message immediately
-          const { extractAgentNickname } = require("./agent");
-          const nickname = extractAgentNickname(msg.from) || msg.from;
-          logText(`${nickname}: ${msg.task}`);
-        },
+
+      // Set pending state for autoBus tasks
+      const abortController = new AbortController();
+      pendingTask = {
+        abortController,
+        startedAt: Date.now(),
+      };
+      updateStatus("Processing bus messages...", "thinking", {
+        showTimer: true,
+        startedAt: pendingTask.startedAt,
       });
-      if (!ubusResult.ok) {
-        const nextError = String(ubusResult.error || "ubus failed");
-        if (nextError !== autoBusError) {
-          autoBusError = nextError;
-          logText(`Error: ${nextError}`);
-        }
-        return;
-      }
-      autoBusError = "";
-      if (ubusResult.handled > 0) {
-        // Display only the replies (tasks were already shown via onMessageReceived)
-        if (ubusResult.messageExchanges && ubusResult.messageExchanges.length > 0) {
-          const { extractAgentNickname } = require("./agent");
-          for (const exchange of ubusResult.messageExchanges) {
-            const nickname = extractAgentNickname(exchange.from) || exchange.from;
-            // Only show the reply since task was already displayed
-            logText(`@${nickname} ${exchange.reply}`);
+
+      try {
+        const ubusResult = await runUbusCommand(state, {
+          workspaceRoot,
+          subscriberId: autoBusSubscriberId,
+          onMessageReceived: (msg) => {
+            // Display the incoming message immediately
+            const { extractAgentNickname } = require("./agent");
+            const nickname = extractAgentNickname(msg.from) || msg.from;
+            logText(`${nickname}: ${msg.task}`);
+            // Update status to show we're working on this specific task
+            updateStatus("Working on task...", "thinking", {
+              showTimer: true,
+              startedAt: pendingTask.startedAt,
+            });
+          },
+        });
+
+        if (!ubusResult.ok) {
+          const nextError = String(ubusResult.error || "ubus failed");
+          if (nextError !== autoBusError) {
+            autoBusError = nextError;
+            logText(`Error: ${nextError}`);
           }
+          return;
         }
-        const persisted = persistSessionState(state);
-        if (!persisted || persisted.ok === false) {
-          logText(`Error: failed to persist session ${state.sessionId}: ${(persisted && persisted.error) || "unknown error"}`);
+        autoBusError = "";
+        if (ubusResult.handled > 0) {
+          // Display only the replies (tasks were already shown via onMessageReceived)
+          if (ubusResult.messageExchanges && ubusResult.messageExchanges.length > 0) {
+            const { extractAgentNickname } = require("./agent");
+            for (const exchange of ubusResult.messageExchanges) {
+              const nickname = extractAgentNickname(exchange.from) || exchange.from;
+              // Only show the reply since task was already displayed
+              logText(`@${nickname} ${exchange.reply}`);
+            }
+          }
+          const persisted = persistSessionState(state);
+          if (!persisted || persisted.ok === false) {
+            logText(`Error: failed to persist session ${state.sessionId}: ${(persisted && persisted.error) || "unknown error"}`);
+          }
         }
+      } finally {
+        // Clear pending state
+        pendingTask = null;
+        updateStatus("", "none");
       }
     };
 
@@ -1058,7 +1099,7 @@ function runUcodeTui({
       if (isBusMessage && targetAgent) {
         updateStatus("Sending message...", "typing");
         try {
-          execSync(`ufoo bus send "${targetAgent}" "${actualLine.replace(/"/g, '\\"')}"`, {
+          execFileSync("ufoo", ["bus", "send", targetAgent, actualLine], {
             cwd: workspaceRoot,
             encoding: "utf8",
           });
@@ -1094,7 +1135,10 @@ function runUcodeTui({
         }, payload);
         return;
       }
-      if (result.kind === "help" || result.kind === "probe" || result.kind === "error") {
+      if (result.kind === "probe") {
+        return;
+      }
+      if (result.kind === "help" || result.kind === "error") {
         logText(result.output || "");
         return;
       }
@@ -1142,6 +1186,54 @@ function runUcodeTui({
         return;
       }
 
+      if (result.kind === "nl_bg") {
+        backgroundSeq += 1;
+        const jobId = `bg-${Date.now().toString(36)}-${backgroundSeq.toString(36)}`;
+        const taskRecord = {
+          id: jobId,
+          task: result.task,
+          status: "running",
+          startedAt: Date.now(),
+          summary: "",
+        };
+        backgroundTasks.set(jobId, taskRecord);
+        updateStatus("", "none");
+        logText(`[${jobId}] started in background.`);
+
+        const bgState = {
+          workspaceRoot: state.workspaceRoot,
+          provider: state.provider,
+          model: state.model,
+          engine: state.engine,
+          context: state.context,
+          nlMessages: Array.isArray(state.nlMessages) ? state.nlMessages.slice() : [],
+          sessionId: "",
+          timeoutMs: state.timeoutMs,
+          jsonOutput: false,
+        };
+
+        Promise.resolve()
+          .then(() => runNaturalLanguageTask(result.task, bgState))
+          .then((nlResult) => {
+            taskRecord.status = nlResult && nlResult.ok ? "done" : "failed";
+            taskRecord.finishedAt = Date.now();
+            taskRecord.summary = String(formatNlResult(nlResult, false) || "").trim();
+            const title = taskRecord.status === "done" ? "done" : "failed";
+            logText(`[${jobId}] ${title}: ${taskRecord.summary || "no summary"}`);
+          })
+          .catch((err) => {
+            taskRecord.status = "failed";
+            taskRecord.finishedAt = Date.now();
+            taskRecord.summary = err && err.message ? String(err.message) : "background task failed";
+            logText(`[${jobId}] failed: ${taskRecord.summary}`);
+          })
+          .finally(() => {
+            updateStatus("", "none");
+            screen.render();
+          });
+        return;
+      }
+
       if (result.kind === "nl") {
         const statusMessages = [
           "Thinking...",