very-happy-cli 0.2.156 → 0.2.158

package/dist/{index-BbtR-Qto.cjs → index-BG932eCh.cjs}

@@ -3,14 +3,14 @@
 var chalk = require('chalk');
 var os = require('node:os');
 var node_crypto = require('node:crypto');
-var index = require('./types-CphWjqHc.cjs');
-var persistence = require('./limits-o29KXBgj.cjs');
+var index = require('./types-DnrPeN80.cjs');
+var persistence = require('./limits-kqFqhfsh.cjs');
 var spawn = require('cross-spawn');
 var path = require('node:path');
 var node_readline = require('node:readline');
 var node_fs = require('node:fs');
 var terminalTitleSuggest = require('./terminalTitleSuggest-Dji8I0Jy.cjs');
-var agentGuidance = require('./agentGuidance-C-CmV03f.cjs');
+var agentGuidance = require('./agentGuidance-DwOWbX55.cjs');
 var promises = require('node:fs/promises');
 var fs = require('fs/promises');
 var ink = require('ink');
@@ -137,6 +137,11 @@ class Session {
   sessionId;
   mode = "local";
   thinking = false;
+  /** B-507: background tasks still in flight (async sub-agents, backgrounded
+   *  commands, monitors) — published with every keepAlive. Always an array
+   *  for the Claude runner: an empty one says "nothing running", which is a
+   *  different statement from a runner that has no such notion (undefined). */
+  backgroundTasks = [];
   /**
    * Window after a user-initiated abort during which stray promise rejections
    * from tearing down the SDK query (MCP transports, in-flight tool calls,
@@ -198,11 +203,21 @@ class Session {
       persistence.logger.debug("[Session] Failed to create notification producer:", err);
       this.notificationProducer = null;
     }
-    this.client.keepAlive(this.thinking, this.mode);
+    this.client.keepAlive(this.thinking, this.mode, this.backgroundTasks);
     this.keepAliveInterval = setInterval(() => {
-      this.client.keepAlive(this.thinking, this.mode);
+      this.client.keepAlive(this.thinking, this.mode, this.backgroundTasks);
     }, 2e3);
   }
+  /**
+   * B-507: the tracker's current set (`claude/backgroundTasks.ts`). A change
+   * beats at once so the daemon, agentState and the web see the edge without
+   * waiting for the 2s tick; an unchanged set is left to the interval.
+   */
+  setBackgroundTasks = (tasks) => {
+    if (persistence.sameBackgroundTasks(this.backgroundTasks, tasks)) return;
+    this.backgroundTasks = tasks;
+    this.client.keepAlive(this.thinking, this.mode, this.backgroundTasks);
+  };
   /**
    * Cleanup resources (call when session is no longer needed)
    */
@@ -237,7 +252,7 @@ class Session {
       this.lastAssistantSnippet = void 0;
     }
     this.thinking = thinking;
-    this.client.keepAlive(thinking, this.mode);
+    this.client.keepAlive(thinking, this.mode, this.backgroundTasks);
   };
   /**
    * Record that Claude emitted an assistant text reply during this turn.
@@ -304,7 +319,7 @@ class Session {
   };
   onModeChange = (mode) => {
     this.mode = mode;
-    this.client.keepAlive(this.thinking, mode);
+    this.client.keepAlive(this.thinking, mode, this.backgroundTasks);
     this._onModeChange(mode);
   };
   onAbort = () => {
@@ -3948,6 +3963,7 @@ async function claudeRemoteLauncher(session, onPermissionModeChange, onEffective
   const turnSteering = createTurnSteeringController();
   const runtimeControls = createRuntimeControls(() => session.thinking);
   session.client.rpcHandlerManager.registerHandler("claude-runtime-control", async (input) => runtimeControls.request(input));
+  const backgroundTasks = persistence.createBackgroundTaskTracker();
   async function abort() {
     if (abortController && !abortController.signal.aborted) {
       abortController.abort();
@@ -4033,6 +4049,8 @@ async function claudeRemoteLauncher(session, onPermissionModeChange, onEffective
   let notifiedQuestionToolCalls = /* @__PURE__ */ new Set();
   function onMessage(message) {
     runtimeControls.observe(message);
+    backgroundTasks.observe(message);
+    session.setBackgroundTasks(backgroundTasks.list());
     if (isRuntimeCheckpointReplay(message)) return;
     if (message.type === "user" && isClaudeInterruptSentinelContent(message.message.content)) {
       sdkToLogConverter.convert(message);
@@ -4257,6 +4275,8 @@ async function claudeRemoteLauncher(session, onPermissionModeChange, onEffective
           },
           onQueryReady: (q) => {
             runtimeControls.setQuery(q);
+            backgroundTasks.reset();
+            session.setBackgroundTasks([]);
             turnSteering.setInterrupt(q.interrupt);
             session.setSideQuestionLive({ ask: q.sideQuestion, canControl: q.canControl });
             session.setSteerHandler(async (input) => {
@@ -4353,6 +4373,8 @@ async function claudeRemoteLauncher(session, onPermissionModeChange, onEffective
         }
       } finally {
         runtimeControls.setQuery(null);
+        backgroundTasks.reset();
+        session.setBackgroundTasks([]);
         turnSteering.reset();
         session.setSteerHandler(null);
         session.setSideQuestionLive(null);
@@ -5402,8 +5424,8 @@ ${typeLabels[type] || type}:`));
   }
   console.log(chalk.gray("  An external claude command is only needed for native terminal/mirror use."));
   try {
-    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-CmIJNV7f.cjs'); });
-    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./types-CphWjqHc.cjs'); }).then(function (n) { return n.index; });
+    const { resolveAgentHomesForCli } = await Promise.resolve().then(function () { return require('./agentHome-Dw8Jx_CJ.cjs'); });
+    const { describeAgentHome } = await Promise.resolve().then(function () { return require('./types-DnrPeN80.cjs'); }).then(function (n) { return n.index; });
     const homes = await resolveAgentHomesForCli();
     console.log(chalk.green(`\u2713 Claude config dir: ${describeAgentHome(homes.claudeConfigDir)}`));
     console.log(chalk.green(`\u2713 Codex home: ${describeAgentHome(homes.codexHome)}`));
@@ -6226,6 +6248,18 @@ function checkPreviewPath(input, opts) {
   return { resolved, deniedReason: null };
 }
 
+const BackgroundTaskInfoSchema = z.z.object({
+  id: z.z.string().min(1).max(200),
+  type: z.z.string().max(64),
+  description: z.z.string().max(persistence.BACKGROUND_TASK_DESCRIPTION_MAX + 1),
+  startedAt: z.z.number()
+});
+const BackgroundTasksReportSchema = z.z.object({
+  count: z.z.number().int().nonnegative(),
+  tasks: z.z.array(BackgroundTaskInfoSchema),
+  reportedAt: z.z.number().optional(),
+  stale: z.z.boolean().optional()
+});
 function startDaemonControlServer({
   controlToken,
   getChildren,
@@ -6237,6 +6271,8 @@ function startDaemonControlServer({
   onSessionStateEvent,
   onClaudeAuthFailed,
   onSessionTurnEvent,
+  onSessionBackgroundTasks,
+  getBackgroundTasks,
   pushClipboard,
   pushFilePreview,
   onTerminalHook,
@@ -6297,8 +6333,10 @@ function startDaemonControlServer({
       schema: {
         body: z.z.object({
           sessionId: z.z.string(),
-          event: z.z.enum(["completed", "needs_input", "auth_failed", "turn_started", "turn_ended"]),
-          spawnedBy: z.z.string().optional()
+          event: z.z.enum(["completed", "needs_input", "auth_failed", "turn_started", "turn_ended", "background_tasks"]),
+          spawnedBy: z.z.string().optional(),
+          // B-507: only with event 'background_tasks' — the wrapper's full set.
+          backgroundTasks: z.z.array(BackgroundTaskInfoSchema).max(persistence.BACKGROUND_TASKS_MAX).optional()
         }),
         response: {
           200: z.z.object({
@@ -6309,6 +6347,10 @@ function startDaemonControlServer({
     }, async (request) => {
       const { sessionId, event, spawnedBy } = request.body;
       persistence.logger.debug(`[CONTROL SERVER] Session event: ${sessionId} ${event} (spawnedBy=${spawnedBy ?? "unset"})`);
+      if (event === "background_tasks") {
+        onSessionBackgroundTasks?.(sessionId, request.body.backgroundTasks ?? []);
+        return { status: "ok" };
+      }
       if (event === "auth_failed") {
         onClaudeAuthFailed?.(sessionId);
         return { status: "ok" };
@@ -6328,7 +6370,9 @@ function startDaemonControlServer({
               startedBy: z.z.string(),
               happySessionId: z.z.string(),
               pid: z.z.number(),
-              turnActive: z.z.boolean()
+              turnActive: z.z.boolean(),
+              // B-507: in-flight background tasks per the wrapper's last report (lease-expired = count 0).
+              backgroundTasks: BackgroundTasksReportSchema.optional()
             }))
           })
         }
@@ -6341,7 +6385,8 @@ function startDaemonControlServer({
           startedBy: child.startedBy,
           happySessionId: child.happySessionId,
           pid: child.pid,
-          turnActive: isTurnActive ? isTurnActive(child.happySessionId) : false
+          turnActive: isTurnActive ? isTurnActive(child.happySessionId) : false,
+          ...getBackgroundTasks ? { backgroundTasks: getBackgroundTasks(child.happySessionId) } : {}
         }))
       };
     });
@@ -6909,6 +6954,170 @@ function createPeerCoordinator(deps) {
   };
 }
 
+const WRITE_METHODS = /* @__PURE__ */ new Set(["sessions.send", "sessions.message"]);
+const REMOTE_CLIENT_TAG = "cli-send-remote";
+function defaultDeps(machineId) {
+  return {
+    machineId,
+    host: os.hostname(),
+    enabled: async () => (await persistence.readSettings()).remoteSessionOps !== "off",
+    readPersisted: persistence.readPersistedSessions,
+    listLocal: (options) => agentGuidance.listSessions(options),
+    listAccount: (options) => agentGuidance.listAccountSessions(options),
+    readTranscript: (sessionId, limit, options) => agentGuidance.readSessionTranscript(sessionId, limit, options),
+    deliver: (sessionId, persisted, text, client, options, deps) => agentGuidance.deliverToSession(sessionId, persisted, text, client, options, deps),
+    listPeers: (context, scope) => agentGuidance.listPeerSessions(context, scope),
+    sendPeer: (context, args) => agentGuidance.sendPeerMessage(context, args),
+    log: (line) => persistence.logger.info(line),
+    now: () => Date.now()
+  };
+}
+function createRemoteSessionOpsHandlers(machineId, overrides = {}) {
+  const deps = { ...defaultDeps(machineId), ...overrides };
+  const readBudget = deps.budget ?? new agentGuidance.RemoteCallBudget(void 0, deps.now);
+  const writeBudget = deps.writeBudget ?? new agentGuidance.RemoteCallBudget(agentGuidance.REMOTE_WRITE_CALLS_PER_MINUTE, deps.now);
+  const deadlineMs = deps.deadlineMs ?? agentGuidance.REMOTE_OP_DEADLINE_MS;
+  const sendCommitDeadlineMs = deps.sendCommitDeadlineMs ?? agentGuidance.REMOTE_SEND_COMMIT_DEADLINE_MS;
+  const resumeWaitMs = deps.resumeWaitMs ?? agentGuidance.REMOTE_RESUME_WAIT_MS;
+  const run = (method, op, targetOf) => async (params) => {
+    const started = deps.now();
+    let from = null;
+    let sessionId;
+    const finish = (response) => {
+      const outcome = response.ok ? "ok" : response.error.code;
+      deps.log(agentGuidance.formatRemoteAuditLine({ method, from, sessionId, outcome, durationMs: deps.now() - started }));
+      return response;
+    };
+    let enabled = false;
+    try {
+      enabled = await deps.enabled();
+    } catch {
+      enabled = false;
+    }
+    const guard = agentGuidance.guardRemoteSessionOpsRequest(method, params, { enabled });
+    if (!guard.ok) return finish(guard);
+    from = guard.request.from;
+    sessionId = targetOf(guard.request.args);
+    const budget = WRITE_METHODS.has(method) ? writeBudget : readBudget;
+    const token = budget.take();
+    if (!token.ok) {
+      return finish(agentGuidance.remoteError("rate_limited", `This machine accepts at most ${budget.perMinute} remote ${WRITE_METHODS.has(method) ? "send/message" : "list/read/peers"} calls per minute; retry in ${Math.ceil(token.retryAfterMs / 1e3)}s`));
+    }
+    let timer;
+    const deadline = new Promise((_, reject) => {
+      timer = setTimeout(() => reject(new RemoteOpFailure("timeout", `${method} did not finish within ${Math.round(deadlineMs / 1e3)}s on ${deps.host}`)), deadlineMs);
+      timer.unref?.();
+    });
+    try {
+      return finish({ ok: true, result: await Promise.race([op(guard.request.args, from, started), deadline]) });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Remote session operation failed";
+      if (error instanceof RemoteOpFailure) return finish(agentGuidance.remoteError(error.code, message));
+      return finish(agentGuidance.remoteError("internal", message));
+    } finally {
+      if (timer) clearTimeout(timer);
+    }
+  };
+  const requirePersisted = (id) => {
+    const persisted = deps.readPersisted()[id];
+    if (!persisted) throw new RemoteOpFailure("no_local_key", `Session ${id} is not on ${deps.host} (no local key there either)`);
+    return persisted;
+  };
+  return {
+    "sessions.list": run("sessions.list", async (args) => {
+      const wanted = args.ids ? new Set(args.ids) : null;
+      let sessions;
+      if (args.all) {
+        sessions = (await deps.listAccount({ tag: args.tag, recentLimit: wanted ? 1e4 : args.limit, includeArchived: true })).filter((row) => row.decryptable);
+      } else if (wanted) {
+        const persisted = deps.readPersisted();
+        const live = await deps.listLocal({ recentLimit: 1e4 });
+        const liveById = new Map(live.map((row) => [row.id, row]));
+        sessions = [...wanted].filter((id) => persisted[id] !== void 0 || liveById.has(id)).map((id) => liveById.get(id) ?? summaryFromPersisted(id, persisted[id]));
+      } else {
+        sessions = await deps.listLocal({ tag: args.tag, recentLimit: args.limit });
+      }
+      if (wanted) sessions = sessions.filter((row) => wanted.has(row.id));
+      const result = { machineId: deps.machineId, host: deps.host, sessions };
+      return result;
+    }, () => void 0),
+    "sessions.read": run("sessions.read", async (args) => {
+      requirePersisted(args.sessionId);
+      const limit = Math.max(1, Math.min(agentGuidance.MAX_READ_LIMIT, args.limit ?? 20));
+      const transcript = await deps.readTranscript(args.sessionId, limit, { full: args.full === true });
+      const capped = agentGuidance.capRemoteTranscript(transcript.transcript);
+      const result = {
+        ...transcript,
+        summary: {
+          ...transcript.summary,
+          ...transcript.summary.title !== void 0 ? { title: agentGuidance.capRemoteText(transcript.summary.title, agentGuidance.REMOTE_TITLE_MAX_BYTES) } : {}
+        },
+        turn: { ...transcript.turn, answer: agentGuidance.capRemoteText(transcript.turn.answer, agentGuidance.REMOTE_ANSWER_MAX_BYTES, "tail") },
+        transcript: capped.transcript,
+        ...capped.truncated ? { truncated: true } : {},
+        machineId: deps.machineId,
+        host: deps.host
+      };
+      return result;
+    }, (args) => args.sessionId),
+    "sessions.send": run("sessions.send", async (args, _from, started) => {
+      const persisted = requirePersisted(args.sessionId);
+      const send = (sessionId, key, text, client, options) => {
+        if (deps.now() - started > sendCommitDeadlineMs) {
+          throw new RemoteOpFailure("timeout", `Session ${sessionId} was not live within ${Math.round(sendCommitDeadlineMs / 1e3)}s on ${deps.host}; nothing was sent \u2014 retry (the same localId cannot double-deliver)`);
+        }
+        return agentGuidance.sendUserMessage(sessionId, key, text, client, { ...options, ...args.localId ? { localId: args.localId } : {} });
+      };
+      return deps.deliver(args.sessionId, persisted, args.text, REMOTE_CLIENT_TAG, {
+        resume: args.resume === true,
+        waitMs: resumeWaitMs,
+        pollMs: 1e3,
+        ...args.model !== void 0 ? { model: args.model } : {},
+        ...args.sentFrom !== void 0 ? { sentFrom: args.sentFrom } : {}
+      }, { send });
+    }, (args) => args.sessionId),
+    "sessions.peers": run("sessions.peers", async (args, from) => {
+      const scope = args.cwd ? args.scope ?? "machine" : "machine";
+      const context = {
+        self: () => ({ sessionId: from.sessionId ?? agentGuidance.CLI_PEER_SENDER_ID, cwd: args.cwd ?? "/", machine: from.host }),
+        readPersisted: deps.readPersisted
+      };
+      const listing = await deps.listPeers(context, scope);
+      return { ...listing, machineId: deps.machineId, host: deps.host };
+    }, () => void 0),
+    "sessions.message": run("sessions.message", async (args) => {
+      requirePersisted(args.to);
+      const context = {
+        self: () => ({ ...args.from, cwd: args.from.cwd ?? "/" }),
+        readPersisted: deps.readPersisted,
+        // The target must be HERE; never bounce a remote request onward.
+        remoteMessage: null
+      };
+      return deps.sendPeer(context, { to: args.to, body: args.body, ...args.replyTo ? { replyTo: args.replyTo } : {} });
+    }, (args) => args.to)
+  };
+}
+class RemoteOpFailure extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+}
+function summaryFromPersisted(id, persisted) {
+  const meta = persisted?.metadata;
+  return {
+    id,
+    live: false,
+    ...meta?.summary?.text ? { title: meta.summary.text } : {},
+    ...meta?.path ? { cwd: meta.path } : {},
+    ...meta?.flavor ? { flavor: meta.flavor } : {},
+    ...meta?.tags?.length ? { tags: [...meta.tags] } : {},
+    ...meta?.variant ? { variant: meta.variant } : {},
+    ...persisted?.savedAt !== void 0 ? { savedAt: persisted.savedAt } : {},
+    url: agentGuidance.sessionWebUrl(id)
+  };
+}
+
 const ASSISTANT_CLAUDE_MD = `# very-happy \u8C03\u5EA6\u4E2D\u5FC3\uFF08\u8BED\u97F3\u52A9\u624B\uFF09
 
 \u4F60\u662F very-happy \u7684\u8C03\u5EA6\u4E2D\u5FC3\uFF0C\u8DD1\u5728\u7528\u6237\u81EA\u5DF1\u7684\u673A\u5668\u4E0A\u3002\u7528\u6237\u4E3B\u8981\u901A\u8FC7\u8BED\u97F3\u8DDF\u4F60\u8BF4\u8BDD\uFF0C
@@ -8445,7 +8654,7 @@ function parseJsonObject(text) {
     return null;
   }
 }
-function resolveSdkClaudeBinary(platform = process.platform, arch = process.arch, resolver = (s) => node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BbtR-Qto.cjs', document.baseURI).href))).resolve(s)) {
+function resolveSdkClaudeBinary(platform = process.platform, arch = process.arch, resolver = (s) => node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BG932eCh.cjs', document.baseURI).href))).resolve(s)) {
   const platformArch = `${platform}-${arch}`;
   const candidates = [
     `@anthropic-ai/claude-agent-sdk-${platformArch}/claude`,
@@ -10617,6 +10826,13 @@ ${action.prompt}`, { localId: `automation-${run.id}`, ...meta });
       if (edgeFell) item.sawTurn = false;
       const turn = await readTurn(sessionId, item.runId).catch(() => null);
       if (!turn?.ended) continue;
+      const background = deps.backgroundTasks?.(sessionId) ?? 0;
+      if (background > 0 && turn.status !== "failed" && turn.status !== "cancelled") {
+        if (!item.waitingOnBackground) deps.log(`Automation run ${item.runId}: turn ended but ${background} background task(s) still running; not done yet`);
+        item.waitingOnBackground = true;
+        continue;
+      }
+      item.waitingOnBackground = false;
       if (turn.status === "failed" || turn.status === "cancelled") await finish(item, { claimId: item.claimId, status: "failed", sessionId, error: turn.error ?? `Turn ${turn.status}`, needsAttention: true, attentionReason: `turn_${turn.status}` });
       else await finish(item, { claimId: item.claimId, status: "done", sessionId, summary: clipText(turn.answer, persistence.AUTOMATION_SUMMARY_MAX_CHARS) });
     }
@@ -10701,6 +10917,7 @@ ${action.prompt}`, { localId: `automation-${run.id}`, ...meta });
     for (const item of tracked.values()) {
       if (item.sessionId !== sessionId) continue;
       if (event === "exited") item.exited = true;
+      if (event === "idle") item.attentionReported = false;
       if (event === "blocked" && !item.attentionReported) {
         item.attentionReported = true;
         void client.report(item.runId, { claimId: item.claimId, needsAttention: true, attentionReason: "needs_input" }).catch(() => deps.log(`Automation run ${item.runId} attention report failed`));
@@ -10911,6 +11128,7 @@ async function startDaemon() {
     persistence.logger.debug("[DAEMON RUN] Auth and machine setup complete");
     const pidToTrackedSession = /* @__PURE__ */ new Map();
     const turnActivity = new index.TurnActivityTracker();
+    const backgroundTasks = new persistence.BackgroundTaskTracker();
     const peerCoordinator = createPeerCoordinator({ getChildren: () => Array.from(pidToTrackedSession.values()) });
     const sessionIdToFinishedSession = /* @__PURE__ */ new Map();
     let teamWorker;
@@ -11771,6 +11989,7 @@ async function startDaemon() {
       if (session?.happySessionId && (session.spawnedBy === "teams" || teamWorker?.hasSession(session.happySessionId))) teamWorker?.report(session.happySessionId, "exited");
       if (session?.happySessionId && automationRunner?.hasSession(session.happySessionId)) automationRunner.report(session.happySessionId, "exited");
       if (session?.happySessionId) turnActivity.forget(session.happySessionId);
+      if (session?.happySessionId) backgroundTasks.forget(session.happySessionId);
       if (session?.happySessionId) peerCoordinator.forget(session.happySessionId);
       if (session?.happySessionId && session.encryption) {
         sessionIdToFinishedSession.set(session.happySessionId, session);
@@ -11857,6 +12076,8 @@ async function startDaemon() {
       onSessionStateEvent,
       onClaudeAuthFailed: (sessionId) => claudeAuthServiceRef?.signalAuthFailed(sessionId),
       onSessionTurnEvent: (sessionId, event) => turnActivity.apply(sessionId, event),
+      onSessionBackgroundTasks: (sessionId, tasks) => backgroundTasks.apply(sessionId, tasks),
+      getBackgroundTasks: (sessionId) => backgroundTasks.report(sessionId),
       onSessionEdit: (edit) => {
         peerCoordinator.onEdit(edit);
       },
@@ -11956,6 +12177,7 @@ async function startDaemon() {
       listTrackedSessionIds: () => [...pidToTrackedSession.values()].map((session) => session.happySessionId).filter((sessionId) => typeof sessionId === "string"),
       requestShutdown: () => requestShutdown("happy-app")
     });
+    apiMachine.setRemoteSessionOpsHandlers(createRemoteSessionOpsHandlers(machineId));
     const claudeAuthService = new ClaudeAuthService({
       happyHomeDir: persistence.configuration.happyHomeDir,
       happyLibDir: terminalTitleSuggest.projectPath(),
@@ -11988,8 +12210,9 @@ async function startDaemon() {
       enabled: async () => ((await persistence.readSettings()).cliAutoUpdate ?? "idle") !== "off",
       // B-466: "idle" = no agent turn in flight. Idle wrappers survive a
       // handover (they talk to the server themselves) and web terminals live
-      // in tmux, so neither is a reason to hold an update.
-      idle: () => !turnActivity.hasActiveTurn(),
+      // in tmux, so neither is a reason to hold an update. B-507: a session
+      // whose turn ended but still has background tasks is busy too.
+      idle: () => !turnActivity.hasActiveTurn() && !backgroundTasks.hasAny(),
       install: installCliSafely,
       publish: (state) => {
         cliUpdateStateRef = state;
@@ -12044,7 +12267,7 @@ async function startDaemon() {
             } catch {
             }
           }
-          if (bundleReplaced && !teamWorker?.busy && !automationRunner?.busy && !updateController.isRunning() && !turnActivity.hasActiveTurn()) {
+          if (bundleReplaced && !teamWorker?.busy && !automationRunner?.busy && !updateController.isRunning() && !turnActivity.hasActiveTurn() && !backgroundTasks.hasAny()) {
             const preflight = await preflightNewBundle(bundlePath);
             if (preflight.action === "hold") {
               if (lastHandoverHold !== preflight.reason) {
@@ -12054,7 +12277,7 @@ async function startDaemon() {
               updateController.holdHandover(preflight.reason);
               return;
             }
-            if (teamWorker?.busy || automationRunner?.busy || updateController.isRunning() || turnActivity.hasActiveTurn()) return;
+            if (teamWorker?.busy || automationRunner?.busy || updateController.isRunning() || turnActivity.hasActiveTurn() || backgroundTasks.hasAny()) return;
             lastHandoverHold = null;
             persistence.logger.debug("[DAEMON RUN] Daemon bundle replaced on disk and verified, handing off to new daemon");
             teamWorker?.stop();
@@ -12120,6 +12343,7 @@ async function startDaemon() {
       spawn: spawnSession,
       live: (id) => [...pidToTrackedSession.values()].some((s) => s.happySessionId === id && isPidAlive(s.pid)),
       turnActive: (id) => turnActivity.activeSessions().includes(id),
+      backgroundTasks: (id) => backgroundTasks.count(id),
       log: (message) => persistence.logger.debug(`[DAEMON RUN] ${message}`)
     });
     void apiMachine.updateMachineMetadata((current) => ({
@@ -12413,36 +12637,54 @@ ${sessions.map(describeSummary).join("\n")}`);
     }
   });
   mcp.registerTool("session_read", {
-    description: "Read the latest messages of a session as a compact role-tagged transcript (user / assistant / tool summaries; large payloads truncated). Only works for sessions spawned by this machine (their keys live in ~/.happy/sessions.json).",
+    description: "Read the latest messages of a session as a compact role-tagged transcript (user / assistant / tool summaries; large payloads truncated). Sessions spawned by this machine are read directly; a session spawned by another machine of this account is read through that machine's daemon (it must be online).",
     title: "Read Session Transcript",
     inputSchema: {
       sessionId: z.z.string().describe("The Happy session id to read"),
-      limit: z.z.number().optional().describe("How many recent messages to fetch (default 20, max 100)")
+      limit: z.z.number().optional().describe("How many recent messages to fetch (default 20, max 100)"),
+      machineId: z.z.string().optional().describe("Machine id the session runs on, when known (skips the lookup across the account's machines)")
     }
   }, async (args) => {
     if (!persistence.isValidSessionId(args.sessionId)) return fail("Invalid sessionId");
     try {
-      const result = await agentGuidance.readSessionTranscript(args.sessionId, args.limit ?? 20);
+      const local = persistence.readPersistedSessions()[args.sessionId];
+      if (local && !args.machineId) {
+        const result2 = await agentGuidance.readSessionTranscript(args.sessionId, args.limit ?? 20);
+        const body2 = result2.transcript.length > 0 ? result2.transcript : "(no readable conversation content in this range)";
+        return ok(`${describeSummary(result2.summary)}
+--- last ${result2.messageCount} message(s) ---
+${body2}`);
+      }
+      const result = await agentGuidance.readRemoteTranscript(args.sessionId, { limit: args.limit ?? 20, ...args.machineId ? { machineId: args.machineId } : {} });
       const body = result.transcript.length > 0 ? result.transcript : "(no readable conversation content in this range)";
-      return ok(`${describeSummary(result.summary)}
---- last ${result.messageCount} message(s) ---
+      return ok(`${describeSummary(result.summary)} machine=${result.host} (${result.machineId})
+--- last ${result.messageCount} message(s)${result.truncated ? ", truncated to fit" : ""} ---
 ${body}`);
     } catch (error) {
       return fail(`Failed to read session: ${error instanceof Error ? error.message : String(error)}`);
     }
   });
   mcp.registerTool("session_send", {
-    description: "Send a user message into an existing session on this machine. Only delivers when a live wrapper will read it: an archived / offline session is refused (the server would store the message unread) unless resume:true brings it back on this machine first. Returns immediately after delivery \u2014 it does NOT wait for the session to respond; use session_read later to check progress.",
+    description: "Send a user message into an existing session. Only delivers when a live wrapper will read it: an archived / offline session is refused (the server would store the message unread) unless resume:true brings it back on its machine first. A session spawned by another machine of this account is delivered through that machine's daemon (it must be online). Returns immediately after delivery \u2014 it does NOT wait for the session to respond; use session_read later to check progress.",
     title: "Send Message to Session",
     inputSchema: {
       sessionId: z.z.string().describe("The Happy session id to message"),
       text: z.z.string().describe("The message text to send"),
-      resume: z.z.boolean().optional().describe("If the session is archived or offline, resume it on this machine (like the web Restore button) and wait until it is live before sending")
+      resume: z.z.boolean().optional().describe("If the session is archived or offline, resume it on its machine (like the web Restore button) and wait until it is live before sending"),
+      machineId: z.z.string().optional().describe("Machine id the session runs on, when known (skips the lookup across the account's machines)")
     }
   }, async (args) => {
     if (!persistence.isValidSessionId(args.sessionId)) return fail("Invalid sessionId");
     if (typeof args.text !== "string" || args.text.trim().length === 0) return fail("text must be non-empty");
     try {
+      if (!persistence.readPersistedSessions()[args.sessionId] || args.machineId) {
+        const remote = await agentGuidance.sendRemoteMessage(args.sessionId, args.text, { resume: args.resume === true, sentFrom: "assistant", ...args.machineId ? { machineId: args.machineId } : {} });
+        if (!remote.delivered) {
+          const detail = remote.error ?? `session is ${remote.status}`;
+          return fail(remote.stored ? `Not delivered (via ${remote.machine.host}): ${detail}` : `Session ${args.sessionId} on ${remote.machine.host} is ${remote.status}: ${detail}`);
+        }
+        return ok(`Message delivered${remote.resumed ? ` (session resumed on ${remote.machine.host})` : ""} to ${args.sessionId} on machine ${remote.machine.host} (${remote.machine.id}) ${agentGuidance.sessionWebUrl(args.sessionId)}`);
+      }
       const persisted = await agentGuidance.waitForSessionKey(args.sessionId, 0);
       const result = await agentGuidance.deliverToSession(args.sessionId, persisted, args.text, MCP_CLIENT_TAG, {
         resume: args.resume === true,
@@ -12454,6 +12696,7 @@ ${body}`);
       }
       return ok(`Message delivered${result.resumed ? " (session resumed on this machine)" : ""} to ${describeSession(args.sessionId, persisted, { live: true })}`);
     } catch (error) {
+      if (error instanceof agentGuidance.RemoteSessionOpsError) return fail(`Failed to send (${error.code}): ${error.message}`);
       return fail(`Failed to send: ${error instanceof Error ? error.message : String(error)}`);
     }
   });
@@ -13261,7 +13504,7 @@ function registerSideQuestionHandler(rpc, deps) {
   const retainMs = deps.retainMs ?? SIDE_QUESTION_RETAIN_MS;
   const maxRunMs = deps.maxRunMs ?? SIDE_QUESTION_MAX_RUN_MS;
   const fork = deps.run ?? (async (input) => {
-    const { query } = await Promise.resolve().then(function () { return require('./index-CB8QnjvS.cjs'); });
+    const { query } = await Promise.resolve().then(function () { return require('./index-D5ScEErM.cjs'); });
     return runSideQuestion(query, input);
   });
   const run = async (input, live) => {
@@ -13380,7 +13623,7 @@ const MAX_TITLE_CHARS = 60;
 const GENERATION_TIMEOUT_MS = 3e4;
 function resolveClaudeBinary() {
   try {
-    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BbtR-Qto.cjs', document.baseURI).href)));
+    const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BG932eCh.cjs', document.baseURI).href)));
     const utilsPath = path.resolve(path.join(terminalTitleSuggest.projectPath(), "scripts", "claude_version_utils.cjs"));
     const { getClaudeCliPath } = require$1(utilsPath);
     const path$1 = getClaudeCliPath();
@@ -15624,9 +15867,9 @@ function resolveLocalSignupBootstrap(configuredMode, configuredInviteCodes, gene
   };
 }
 
-const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BbtR-Qto.cjs', document.baseURI).href)));
+const __filename$1 = node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BG932eCh.cjs', document.baseURI).href)));
 const __dirname$1 = path.dirname(__filename$1);
-const require_ = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BbtR-Qto.cjs', document.baseURI).href)));
+const require_ = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index-BG932eCh.cjs', document.baseURI).href)));
 const PRISMA_QUERY_ENGINE_FILES = {
   "arm64-darwin": "libquery_engine-darwin-arm64.dylib.node",
   "x64-darwin": "libquery_engine-darwin.dylib.node",
@@ -18569,7 +18812,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "install-terminal-hooks") {
     try {
-      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await Promise.resolve().then(function () { return require('./installTerminalHooks-BOAnQ1Qe.cjs'); });
+      const { installTerminalHooks, parseTerminalHooksArgs, TERMINAL_HOOKS_HELP } = await Promise.resolve().then(function () { return require('./installTerminalHooks-DcQfee_O.cjs'); });
       const command = parseTerminalHooksArgs(args.slice(1));
       if (command.action === "help") {
         console.log(TERMINAL_HOOKS_HELP);
@@ -18586,7 +18829,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
   } else if (subcommand === "agent-home") {
     try {
-      const { parseAgentHomeArgs, runAgentHomeCommand } = await Promise.resolve().then(function () { return require('./agentHome-CmIJNV7f.cjs'); });
+      const { parseAgentHomeArgs, runAgentHomeCommand } = await Promise.resolve().then(function () { return require('./agentHome-Dw8Jx_CJ.cjs'); });
       await runAgentHomeCommand(parseAgentHomeArgs(args.slice(1)));
       process.exit(0);
     } catch (error) {
@@ -18595,7 +18838,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
   } else if (subcommand === "spawn") {
     try {
-      const { handleSpawnCommand } = await Promise.resolve().then(function () { return require('./spawn-CC6V2KiA.cjs'); });
+      const { handleSpawnCommand } = await Promise.resolve().then(function () { return require('./spawn-Ddtom1cb.cjs'); });
       await handleSpawnCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -18607,7 +18850,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "sessions") {
     try {
-      const { handleSessionsCommand } = await Promise.resolve().then(function () { return require('./sessions-OmvyJb0n.cjs'); });
+      const { handleSessionsCommand } = await Promise.resolve().then(function () { return require('./sessions-BNMPQoLE.cjs'); });
       await handleSessionsCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -18619,7 +18862,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "send") {
     try {
-      const { handleSendCommand } = await Promise.resolve().then(function () { return require('./send-CTcGMVuG.cjs'); });
+      const { handleSendCommand } = await Promise.resolve().then(function () { return require('./send-D5ejHPXG.cjs'); });
       await handleSendCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -18725,9 +18968,9 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     if (geminiSubcommand === "project" && args[2] === "set" && args[3]) {
       const projectId = args[3];
       try {
-        const { saveGoogleCloudProjectToConfig } = await Promise.resolve().then(function () { return require('./config-BYHSRY2E.cjs'); });
-        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await Promise.resolve().then(function () { return require('./limits-o29KXBgj.cjs'); }).then(function (n) { return n.persistence; });
-        const { ApiClient: ApiClient2 } = await Promise.resolve().then(function () { return require('./types-CphWjqHc.cjs'); }).then(function (n) { return n.api; });
+        const { saveGoogleCloudProjectToConfig } = await Promise.resolve().then(function () { return require('./config-DG84bjwF.cjs'); });
+        const { readCredentialsForConfiguredRelay: readCredentialsForConfiguredRelay2 } = await Promise.resolve().then(function () { return require('./limits-kqFqhfsh.cjs'); }).then(function (n) { return n.persistence; });
+        const { ApiClient: ApiClient2 } = await Promise.resolve().then(function () { return require('./types-DnrPeN80.cjs'); }).then(function (n) { return n.api; });
         let userEmail = void 0;
         try {
           const credentials = await readCredentialsForConfiguredRelay2();
@@ -18758,7 +19001,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     }
     if (geminiSubcommand === "project" && args[2] === "get") {
       try {
-        const { readGeminiLocalConfig } = await Promise.resolve().then(function () { return require('./config-BYHSRY2E.cjs'); });
+        const { readGeminiLocalConfig } = await Promise.resolve().then(function () { return require('./config-DG84bjwF.cjs'); });
         const config = readGeminiLocalConfig();
         if (config.googleCloudProject) {
           console.log(`Current Google Cloud Project: ${config.googleCloudProject}`);
@@ -18798,7 +19041,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       process.exit(0);
     }
     try {
-      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini--QqK-Ap5.cjs'); });
+      const { runGemini } = await Promise.resolve().then(function () { return require('./runGemini-28O2sqyI.cjs'); });
       let startedBy = void 0;
       for (let i = 1; i < args.length; i++) {
         if (args[i] === "--started-by") {
@@ -18821,7 +19064,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
   } else if (subcommand === "pi") {
     if (args[1] === "--terminal") {
       try {
-        const { runPiTerminal } = await Promise.resolve().then(function () { return require('./piTerminal-D-BIbov9.cjs'); });
+        const { runPiTerminal } = await Promise.resolve().then(function () { return require('./piTerminal-BYxp3LMr.cjs'); });
         process.exitCode = await runPiTerminal(args.slice(2));
       } catch (error) {
         console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Unknown error");
@@ -18838,7 +19081,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
       }
     };
     try {
-      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-B_-7NpGZ.cjs'); });
+      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-DPCsWlWK.cjs'); });
       const parsed = parsePiRunnerArgs(args.slice(1));
       const resolved = resolveAcpAgentConfig(["pi", ...parsed.passthrough]);
       const { credentials } = await authAndSetupMachineIfNeeded();
@@ -18866,7 +19109,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "acp") {
     try {
-      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-B_-7NpGZ.cjs'); });
+      const { runAcp, resolveAcpAgentConfig } = await Promise.resolve().then(function () { return require('./index-DPCsWlWK.cjs'); });
       let startedBy = void 0;
       let verbose = false;
       const acpArgs = [];
@@ -18906,7 +19149,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "openclaw") {
     try {
-      const { runOpenClaw } = await Promise.resolve().then(function () { return require('./runOpenClaw-C0xLhTvk.cjs'); });
+      const { runOpenClaw } = await Promise.resolve().then(function () { return require('./runOpenClaw-CiMZad-H.cjs'); });
       let startedBy = void 0;
       let verbose = false;
       let gatewayUrl;
@@ -18957,7 +19200,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "todo") {
     try {
-      const { handleTodoCommand } = await Promise.resolve().then(function () { return require('./todo-CEDvKNXK.cjs'); });
+      const { handleTodoCommand } = await Promise.resolve().then(function () { return require('./todo-BYMg0fR0.cjs'); });
       await handleTodoCommand(args.slice(1));
     } catch (error) {
       console.error(JSON.stringify({ error: error instanceof Error ? error.message : "Todo command failed" }));
@@ -18966,7 +19209,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "teams") {
     try {
-      const { handleTeamsCommand } = await Promise.resolve().then(function () { return require('./teams-XtrH3_h3.cjs'); });
+      const { handleTeamsCommand } = await Promise.resolve().then(function () { return require('./teams-BZ1tayg_.cjs'); });
       await handleTeamsCommand(args.slice(1));
     } catch (error) {
       console.error(error instanceof Error ? error.message : "Teams command failed");
@@ -18975,7 +19218,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "auto") {
     try {
-      const { handleAutoCommand } = await Promise.resolve().then(function () { return require('./auto-CMDq4oIu.cjs'); });
+      const { handleAutoCommand } = await Promise.resolve().then(function () { return require('./auto-DZbNcTXx.cjs'); });
       await handleAutoCommand(args.slice(1));
     } catch (error) {
       console.error(chalk.red("Error:"), error instanceof Error ? error.message : "Automation command failed");
@@ -18987,7 +19230,7 @@ Conversation history is preserved on the server, but in-flight tool calls are in
     return;
   } else if (subcommand === "mcp" && (args.length === 1 || args.length === 2 && args[1] === "--terminal-tools")) {
     try {
-      const { handleMcpCommand } = await Promise.resolve().then(function () { return require('./mcp-CwK1nI7Y.cjs'); });
+      const { handleMcpCommand } = await Promise.resolve().then(function () { return require('./mcp-DGdeUUDJ.cjs'); });
       await handleMcpCommand(args[1] === "--terminal-tools");
     } catch (error) {
       process.stderr.write(`[very-happy mcp] Fatal: ${error instanceof Error ? error.message : String(error)}
@@ -19018,6 +19261,8 @@ Conversation history is preserved on the server, but in-flight tool calls are in
           console.log(JSON.stringify(sessions, null, 2));
           const busy = sessions.filter((s) => s.turnActive === true);
           console.log(busy.length === 0 ? "No turn in flight on this machine (wrappers older than 0.2.139 do not report turns)." : `${busy.length} session(s) with a turn in flight: ${busy.map((s) => s.happySessionId).join(", ")}`);
+          const background = sessions.filter((s) => (s.backgroundTasks?.count ?? 0) > 0);
+          console.log(background.length === 0 ? "No background tasks in flight (wrappers older than 0.2.157 do not report them)." : `${background.length} session(s) with background tasks in flight: ${background.map((s) => `${s.happySessionId} (${s.backgroundTasks?.count})`).join(", ")}`);
         }
       } catch (error) {
         console.log("No daemon running");