@songsid/agend 2.1.5 → 2.1.6-beta.10

package/dist/daemon.js

@@ -9,6 +9,9 @@ import { clearPausedMarker, writePausedMarker } from "./pause-marker.js";
 import { TmuxManager, resolveTmuxLogicalSize } from "./tmux-manager.js";
 import { TranscriptMonitor } from "./transcript-monitor.js";
 import { createTranscriptSource } from "./transcript-sources.js";
+import { credentialProfileStoreHome, resolveCredentialProfile } from "./backend/credential-profile.js";
+import { resolveToolSet } from "./tool-permissions.js";
+import { getAgendHome } from "./paths.js";
 import { LOGIN_FLOWS } from "./login-flows.js";
 import { ProgressAccumulator, summarizeProgress } from "./tool-progress.js";
 import { ContextGuardian } from "./context-guardian.js";
@@ -26,6 +29,7 @@ import { formatCrossInstanceInboundMessage, renderCrossInstanceHandoffMetadata,
 import { bottomRowIsReady, inputAreaText, inputShowsPastedText, pastedTextSignature, pasteLeftInInput, strandedAgendMessageInInput } from "./pane-input-residue.js";
 import { TurnReplyGuard } from "./turn-reply-guard.js";
 import { t } from "./locale.js";
+import { MuseUsageRelay, clearMuseUsageSnapshot } from "./muse-usage-relay.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Tool routing sets — module-level to avoid re-creation on every handleToolCall
@@ -40,7 +44,7 @@ const REPLY_DROP_WARNING_COOLDOWN_MS = 5 * 60_000;
 const REPLY_RECOVERY_PROMPT = "[system:reply-required] The previous human-facing turn ended without a successfully delivered reply. Do not redo the work. Use the reply tool exactly once now to send the user a concise conclusion. If no substantive answer is needed, send a brief acknowledgement. Do not reply to this system instruction except through the reply tool.";
 /** Point a resumed CLI at its one backend-native instruction source. */
 export function buildInstructionReloadNotice(binaryName, instanceName, instanceDir) {
-    const source = binaryName === "codex" || binaryName === "grok"
+    const source = binaryName === "codex" || binaryName === "grok" || binaryName === "muse"
         ? "AGENTS.md"
         : binaryName === "kiro-cli"
             ? `.kiro/steering/agend-${instanceName}.md`
@@ -83,6 +87,8 @@ export const DEFAULT_STATE_IDLE_DEBOUNCE_MS = 2_000;
 export const DEFAULT_STATE_SAFETY_SWEEP_MS = 60_000;
 /** Coalesce one cosmetic-redraw burst before comparing the visible pane. */
 export const PERIODIC_REDRAW_PROBE_MS = 25;
+/** Do not turn a streaming Codex turn into one capture-pane per burst. */
+export const STRUCTURED_IDLE_PROBE_MS = 500;
 /** A foreground server/port-forward should hand control back or be acknowledged. */
 export const DEFAULT_BLOCKING_PROCESS_GRACE_MS = 2 * 60_000;
 const LAST_INBOUND_FILE = "last-inbound-at";
@@ -432,7 +438,23 @@ export class BackendUnreachableStartupError extends Error {
 /** Bounded wait (under the pane lock) for the prompt to return before retrying a dropped Enter. */
 const STRANDED_RETRY_READY_WAIT_MS = 30_000;
 /** A passive startup phase must clear within this bound before an Enter is sent. */
-const INPUT_TRANSIENT_WAIT_MS = 30_000;
+/**
+ * How long a passive startup/resume transient may sit WITHOUT REPAINTING before
+ * delivery gives up. It is a stall budget, not a total: a CLI that is still
+ * painting its resume is making progress, and #826 is what happens when the two
+ * are confused — codex's resume is the only declared transient in the fleet
+ * (backend/codex.ts), a woken paused codex routinely takes longer than this to
+ * come back, and the flat 30s cap turned that into ❌ plus a discarded message
+ * on a pane that was seconds from ready.
+ */
+const INPUT_TRANSIENT_STALL_MS = 30_000;
+/**
+ * The absolute ceiling for the same wait, so a transient that repaints forever
+ * (a spinner on a wedged resume) still ends in an honest failure. Bounded, as
+ * every other delivery wait is — just bounded by "no progress", not by a guess
+ * at how long a resume takes.
+ */
+const INPUT_TRANSIENT_WAIT_MS = 10 * 60_000;
 const INPUT_TRANSIENT_POLL_MS = 250;
 /** Max "stranded text → submit → wait for prompt → re-check" rounds per delivery; each may send one recovery Enter. */
 const STRANDED_INPUT_MAX_ROUNDS = 3;
@@ -875,6 +897,11 @@ export class Daemon extends EventEmitter {
     /** Identity of that dialog: its pattern, not its description (two tables may describe one screen differently). */
     dialogParkedKey = null;
     dialogParkedReported = false;
+    /** Current stdin-owning runtime dialog, independent from execution state. */
+    inputBlockedDialogKey = null;
+    /** Generation/signature fence for safety dialogs while their screen is still visible. */
+    autoResolvedDialogKey = null;
+    autoResolvedDialogGeneration = 0;
     backgroundSessionRecoveryAttempted = false;
     /** Whether the last spawn started a fresh session (not resumed). */
     isNewSession = false;
@@ -889,6 +916,9 @@ export class Daemon extends EventEmitter {
     instanceStateMonitorTimer = null;
     instanceStateIdleTimer = null;
     instanceStateOutputProbeTimer = null;
+    /** Consecutive structural idle captures for a noisy, periodically-redrawing
+     * pane.  Two are required before a working -> idle transition. */
+    instanceStatePeriodicIdleConfirmations = 0;
     instanceStateStuckTimer = null;
     instanceStateOutputListener = null;
     instanceStateOutputEventName = null;
@@ -941,6 +971,11 @@ export class Daemon extends EventEmitter {
     fatalStartupBlocked = false;
     /** model_error seen mid-turn: notify only if it survives to the idle screen. */
     pendingModelErrorKey = null;
+    /** Optional per-instance localhost relay used to observe Muse usage events. */
+    museUsageRelay = null;
+    /** Set after an in-run relay failure so subsequent Muse respawns go direct. */
+    museRelayFallback = false;
+    museRelayFallbackInFlight = null;
     /**
      * Let the next pause() proceed from a stuck pane. Set only for the auth-deferred
      * pause — see the pausePending consumption site for why waiting for idle there
@@ -1323,7 +1358,7 @@ export class Daemon extends EventEmitter {
             // (statusline transcript); codex/kiro/opencode read their CLI's own
             // conversation store via a pluggable source. Backends with no known
             // source stay inert exactly as before.
-            this.transcriptMonitor = new TranscriptMonitor(this.instanceDir, this.logger, createTranscriptSource(this.config.backend ?? "claude-code", this.config.working_directory));
+            this.transcriptMonitor = new TranscriptMonitor(this.instanceDir, this.logger, createTranscriptSource(this.config.backend ?? "claude-code", this.config.working_directory, this.credentialProfileStore()));
             // 5. Wire transcript events
             const ackIfPending = () => {
                 if (!this.pendingAckMessage || !this.adapter)
@@ -2162,6 +2197,7 @@ export class Daemon extends EventEmitter {
                 if (!alive)
                     return;
                 const pane = await this.tmux.capturePane();
+                const inputBlockedDialog = this.updateInputBlockedState(pane, dialogs);
                 const interactivePrompt = this.interactivePromptDetector.observe(pane, Date.now(), this.instanceStateLastOutputAt);
                 if (interactivePrompt) {
                     this.logger.warn(interactivePrompt, "Interactive terminal prompt is waiting for human input");
@@ -2178,7 +2214,7 @@ export class Daemon extends EventEmitter {
                 const hasPendingWork = this.pendingWork.hasPendingWork();
                 if (!hasPendingWork)
                     this.blockingProcessDetector.reset();
-                const blockingProcess = hasPendingWork
+                const blockingProcess = hasPendingWork && !inputBlockedDialog
                     ? this.blockingProcessDetector.observe(pane, paneActivity, Date.now())
                     : null;
                 if (blockingProcess) {
@@ -2200,27 +2236,80 @@ export class Daemon extends EventEmitter {
                         blockingSeen = dialog;
                     if (dialog.holdOnly)
                         break; // recognised, deliberately not answered; trackDialogParked reports it
+                    const autoKey = dialog.autoResolutionKey;
+                    if (dialog.verifyAfterKeys && autoKey
+                        && this.autoResolvedDialogGeneration === this.spawnGeneration
+                        && this.autoResolvedDialogKey === autoKey) {
+                        // A previous poll sent the safety choice but the CLI has not
+                        // repainted yet. Never send another Enter into the same screen.
+                        continue;
+                    }
                     // These keys go straight into the pane. Sent while a message delivery is
                     // mid-transaction, an `Escape` wipes the pasted text and an `Enter`
                     // submits it half-composed — the user sees a message that vanished. Skip
                     // (not queue) when the pane is busy: this poller runs every 5s, and the
                     // dialog will still be on screen next tick.
+                    let resolved = false;
                     const dismissed = await this.paneWriteLock.tryRun(async () => {
+                        // Re-read under the lock: the first capture may have gone stale
+                        // while a delivery was finishing. A stale danger menu must never
+                        // receive a blind key sequence.
+                        const currentPane = await this.tmux.capturePane();
+                        if (!Daemon.dialogMatches(dialog, currentPane)) {
+                            this.updateInputBlockedState(currentPane, dialogs);
+                            return;
+                        }
+                        if (dialog.verifyAfterKeys && autoKey
+                            && this.autoResolvedDialogGeneration === this.spawnGeneration
+                            && this.autoResolvedDialogKey === autoKey)
+                            return;
+                        if (dialog.verifyAfterKeys && autoKey) {
+                            this.autoResolvedDialogGeneration = this.spawnGeneration;
+                            this.autoResolvedDialogKey = autoKey;
+                        }
                         this.logger.info(`Auto-dismissing runtime dialog: ${dialog.description}`);
                         const SPECIAL_KEYS = new Set(["Up", "Down", "Enter", "Escape", "Right", "Left"]);
                         for (const key of dialog.keys) {
+                            let sent = false;
                             if (SPECIAL_KEYS.has(key)) {
-                                await this.tmux.sendSpecialKey(key);
+                                sent = await this.tmux.sendSpecialKey(key);
                             }
                             else {
-                                await this.tmux.pasteText(key, this.systemPasteOptions());
+                                sent = await this.tmux.pasteText(key, this.systemPasteOptions());
+                            }
+                            if (!sent) {
+                                if (dialog.verifyAfterKeys && autoKey) {
+                                    this.autoResolvedDialogGeneration = 0;
+                                    this.autoResolvedDialogKey = null;
+                                }
+                                return;
                             }
                             await new Promise(r => setTimeout(r, 200));
                         }
+                        if (dialog.verifyAfterKeys) {
+                            const afterKeysPane = await this.tmux.capturePane();
+                            const dialogStillActive = dialog.inputBlocked
+                                ? dialogs.some(candidate => candidate.inputBlocked && Daemon.dialogMatches(candidate, afterKeysPane))
+                                : Daemon.dialogMatches(dialog, afterKeysPane);
+                            if (dialogStillActive) {
+                                this.logger.warn({ dialog: dialog.description }, "Runtime dialog remained after its safety choice");
+                                return;
+                            }
+                            this.updateInputBlockedState(afterKeysPane, dialogs);
+                            if (dialog.postDismissNotice) {
+                                resolved = await this.submitSystemPaste(dialog.postDismissNotice.text, dialog.postDismissNotice.label);
+                            }
+                            else {
+                                resolved = true;
+                            }
+                        }
                     });
                     if (!dismissed) {
                         this.logger.info({ dialog: dialog.description }, "Dialog dismissal deferred — pane write in flight");
                     }
+                    else if (dialog.verifyAfterKeys && !resolved) {
+                        this.logger.warn({ dialog: dialog.description }, "Safety dialog choice was sent but follow-up verification or notice submission failed");
+                    }
                     this.trackDialogParked(blockingSeen);
                     return; // Dialog handled (or deliberately deferred): skip error checks this cycle
                 }
@@ -2539,6 +2628,13 @@ export class Daemon extends EventEmitter {
         this.inputTransientGuardGeneration = null;
         this.freezeRuntimeMonitors();
         this.pendingIpcRequests.clear();
+        if (this.museUsageRelay) {
+            await this.museUsageRelay.stop().catch(() => { });
+            this.museUsageRelay = null;
+        }
+        else if (this.backend?.binaryName === "muse") {
+            clearMuseUsageSnapshot(this.instanceDir);
+        }
         if (this.adapter)
             await this.adapter.stop();
         // Notify MCP servers of graceful shutdown (prevents reconnect attempts)
@@ -2818,6 +2914,15 @@ export class Daemon extends EventEmitter {
     }
     applyInstanceStateSnapshot(snapshot, pane) {
         const previous = this.instanceState;
+        // A live safety menu owns stdin.  It may still contain Claude's persistent
+        // `❯` ready marker, but that is not an idle turn and must not clear pending
+        // work, retire Cancel, arm auto-pause, or enter the generic stuck path.
+        // Keep the public execution state unchanged until the menu disappears; the
+        // dedicated input_blocked event carries the reason to observers.
+        if (this.inputBlockedDialogKey !== null) {
+            this.logger.debug({ dialog: this.inputBlockedDialogKey }, "Suppressing execution-state edge while CLI input is blocked by a dialog");
+            return;
+        }
         this.instanceState = snapshot.state;
         // OpenCode creates its session lazily on the first submitted message.
         // Waiting until stop/pause to persist that id loses resume state when the
@@ -3230,13 +3335,13 @@ export class Daemon extends EventEmitter {
      * visible cell. Probe the pane once per burst: a changed capture is real work;
      * an identical ready capture remains idle and emits no state edge.
      */
-    scheduleInstanceStateOutputProbe() {
+    scheduleInstanceStateOutputProbe(delayMs = PERIODIC_REDRAW_PROBE_MS) {
         if (this.instanceStateOutputProbeTimer)
             return;
         this.instanceStateOutputProbeTimer = setTimeout(() => {
             this.instanceStateOutputProbeTimer = null;
             void this.captureAndEvaluateInstanceState("output_probe", this.instanceStateLastOutputAt);
-        }, PERIODIC_REDRAW_PROBE_MS);
+        }, delayMs);
         this.instanceStateOutputProbeTimer.unref?.();
     }
     clearInstanceStateStuckTimer() {
@@ -3291,6 +3396,7 @@ export class Daemon extends EventEmitter {
         const captureStartedAt = Date.now();
         try {
             const pane = await this.tmux.capturePane();
+            this.updateInputBlockedState(pane);
             // Output received while capture-pane was in flight makes this snapshot
             // stale. Its output handler has already armed a new debounce.
             const outputMovedDuringCapture = (expectedOutputAt > 0 && this.instanceStateLastOutputAt > expectedOutputAt)
@@ -3319,11 +3425,98 @@ export class Daemon extends EventEmitter {
             // changed when tmux reported output (observedChangeAt), but idle/stuck are
             // decisions about *now*. The old double-observe expressed that by calling
             // observe twice, which silently disabled the "content moved" branch.
-            const snapshot = this.instanceStateMachine.observe(pane, Date.now(), {
-                settled,
-                changeAt: observedChangeAt,
-                forceBusy: paneActivity !== null,
-            });
+            const structuredPeriodicIdle = this.backend?.isPeriodicRedrawIdlePane;
+            let snapshot;
+            if (structuredPeriodicIdle && reason === "output_probe") {
+                const idlePane = structuredPeriodicIdle.call(this.backend, pane);
+                if (idlePane) {
+                    if (this.instanceState === "idle") {
+                        // Cosmetic output must not manufacture an idle -> working edge.
+                        this.instanceStatePeriodicIdleConfirmations = 2;
+                    }
+                    else {
+                        this.instanceStatePeriodicIdleConfirmations++;
+                    }
+                    if (this.instanceStatePeriodicIdleConfirmations < 2) {
+                        // One positive frame is intentionally not enough to bless a
+                        // working pane while the starfield is still repainting.
+                        snapshot = this.instanceStateMachine.recordOutput(observedChangeAt);
+                    }
+                    else {
+                        snapshot = this.instanceStateMachine.observe(pane, Date.now(), {
+                            settled: true,
+                            changeAt: observedChangeAt,
+                        });
+                    }
+                }
+                else {
+                    // A live busy marker or an unfamiliar layout outranks the broad Codex
+                    // ready pattern during the noisy-redraw path. Unknown is working.
+                    this.instanceStatePeriodicIdleConfirmations = 0;
+                    snapshot = this.instanceStateMachine.recordOutput(observedChangeAt);
+                }
+            }
+            else if (structuredPeriodicIdle && reason !== "idle_debounce" && !settled) {
+                // Startup, safety, and explicit state probes must not bless a broad
+                // Codex ready match when the structural layout is unknown or visibly
+                // busy. The settled debounce below remains the compatibility path for
+                // drafts and older layouts that simply lack the new footer.
+                //
+                // ONLY while output is still recent. recordOutput sets working
+                // unconditionally, and the safety sweep fires for every daemon on a
+                // timer — so without this guard a Codex that had gone quiet was flipped
+                // to working by the next sweep and could never come back, because a
+                // quiet pane produces no further output to re-evaluate it. That state
+                // holds the Cancel button open, disables auto-pause, and makes the hang
+                // detector report a perfectly idle instance as stuck. A settled capture
+                // has no recent output to defend and falls through to the legacy
+                // ready/busy reading below.
+                //
+                // The `settled` guard alone is not enough for the case this whole
+                // branch exists to serve. While the Astra star field keeps repainting,
+                // output never stops arriving, so the capture is NEVER settled — and a
+                // sweep landing on an already-idle animated pane flipped it to working
+                // once a minute, then back an instant later once two probes re-proved
+                // it. Each flicker is a spurious pair of state edges for the fleet and
+                // resets the idleSince this daemon reports when it asks to auto-pause.
+                //
+                // So the same rule the output_probe branch already applies holds here:
+                // cosmetic output must not manufacture an idle -> working edge. A pane
+                // that is STRUCTURALLY idle and already known idle stays idle.
+                //
+                // It must be re-read as SETTLED to do that. Falling through to the
+                // ordinary reading is not equivalent: that path is given the real
+                // `settled` (false, because the animation is still painting), and an
+                // unsettled capture of a CHANGED pane is working by definition — so a
+                // sweep landing on a frame no probe had captured yet still flipped an
+                // idle pane over. Treating this capture as settled is what lets the
+                // ready/busy reading decide on the frame itself.
+                const idlePane = structuredPeriodicIdle.call(this.backend, pane);
+                if (idlePane && this.instanceState === "idle") {
+                    this.instanceStatePeriodicIdleConfirmations = 2;
+                    snapshot = this.instanceStateMachine.observe(pane, Date.now(), {
+                        settled: true,
+                        changeAt: observedChangeAt,
+                    });
+                }
+                else {
+                    this.instanceStatePeriodicIdleConfirmations = 0;
+                    snapshot = this.instanceStateMachine.recordOutput(observedChangeAt);
+                }
+            }
+            else {
+                // Structural proof is an additional working-stage escape hatch only.
+                // Settled captures retain the legacy ready/busy semantics for drafts,
+                // older Codex layouts, and panes without a Context footer.
+                if (structuredPeriodicIdle && settled) {
+                    this.instanceStatePeriodicIdleConfirmations = 0;
+                }
+                snapshot = this.instanceStateMachine.observe(pane, Date.now(), {
+                    settled,
+                    changeAt: observedChangeAt,
+                    forceBusy: paneActivity !== null,
+                });
+            }
             this.applyInstanceStateSnapshot(snapshot, pane);
             // Backends without a transcript feed can still say what they are doing, if
             // their TUI names it. Free-riding on a capture that already happened: no
@@ -3332,10 +3525,11 @@ export class Daemon extends EventEmitter {
             if (this.backend?.getPaneActivity) {
                 this.publishActivity(snapshot.state === "idle" ? null : paneActivity);
             }
-            if (snapshot.state === "idle") {
+            const currentState = this.instanceState;
+            if (currentState === "idle") {
                 this.clearInstanceStateStuckTimer();
             }
-            else if (snapshot.state === "working") {
+            else if (currentState === "working") {
                 // If control mode missed the pane change, the safety capture becomes
                 // the new progress timestamp and re-arms both deadlines.
                 if (!expectedOutputAt)
@@ -3357,11 +3551,17 @@ export class Daemon extends EventEmitter {
         if (!windowId || event.windowId !== windowId || !this.instanceStateMachine)
             return;
         this.instanceStateLastOutputAt = event.at;
-        if (this.backend?.hasPeriodicPaneRedraw?.() === true && this.instanceState === "idle") {
+        const canProvePeriodicIdle = !!this.backend?.isPeriodicRedrawIdlePane;
+        if (canProvePeriodicIdle || (this.backend?.hasPeriodicPaneRedraw?.() === true && this.instanceState === "idle")) {
             // Do not emit idle→working solely because agy repainted an identical
-            // footer. The short capture probe below still observes genuine pane
-            // changes promptly and moves the state to working.
-            this.scheduleInstanceStateOutputProbe();
+            // footer. Codex additionally uses a structural probe while working: two
+            // positive prompt captures can recover from an animation stream that
+            // never leaves a two-second quiet window.
+            if (this.instanceState !== "idle") {
+                this.applyInstanceStateSnapshot(this.instanceStateMachine.recordOutput(event.at));
+                this.scheduleInstanceStateStuckDeadline(event.at);
+            }
+            this.scheduleInstanceStateOutputProbe(canProvePeriodicIdle ? STRUCTURED_IDLE_PROBE_MS : PERIODIC_REDRAW_PROBE_MS);
             this.scheduleInstanceStateIdleCapture();
             return;
         }
@@ -3397,6 +3597,7 @@ export class Daemon extends EventEmitter {
         this.instanceStateBusyPattern = this.backend.getBusyPattern?.() ?? null;
         this.instanceStateMachine = new PaneStateMachine(this.instanceStateReadyPattern, this.instanceStateStuckTimeoutMs, Date.now(), this.instanceStateBusyPattern);
         this.instanceStateLastOutputAt = 0;
+        this.instanceStatePeriodicIdleConfirmations = 0;
         this.instanceStateMonitorActive = true;
         if (this.controlClient) {
             this.instanceStateSafetyListener = () => { void this.captureAndEvaluateInstanceState("safety_sweep"); };
@@ -3414,6 +3615,7 @@ export class Daemon extends EventEmitter {
     }
     stopInstanceStateMonitor() {
         this.instanceStateMonitorActive = false;
+        this.instanceStatePeriodicIdleConfirmations = 0;
         this.clearInstanceStateIdleTimer();
         this.clearInstanceStateOutputProbeTimer();
         this.clearInstanceStateStuckTimer();
@@ -3431,6 +3633,10 @@ export class Daemon extends EventEmitter {
         this.instanceStateSafetyListener = null;
     }
     handleStuckTransition(pane, snapshot, readyPattern) {
+        if (this.inputBlockedDialogKey !== null) {
+            this.logger.debug({ dialog: this.inputBlockedDialogKey }, "Suppressing stuck notification while CLI input is blocked by a dialog");
+            return;
+        }
         const deterministicReadyPattern = new RegExp(readyPattern.source, readyPattern.flags.replace(/[gy]/g, ""));
         const diagnostic = {
             backend: this.backend?.binaryName ?? this.config.backend ?? "unknown",
@@ -3730,6 +3936,28 @@ export class Daemon extends EventEmitter {
         }
         return formatted;
     }
+    /**
+     * Whether ONE delivery reached a verdict, carried by that delivery.
+     *
+     * `deliverMessage` returns false for two unrelated things: a delivery that
+     * cannot land (window gone, a pane that never came back, an unanswered
+     * dialog) and a delivery that was never attempted (user cancel, a tmux storm,
+     * shutdown). Only the first is a failure to tell the sender about; reporting
+     * the second told a sending agent its message was lost while the fleet was
+     * merely standing down (#826).
+     *
+     * It is per call and not a field on the daemon because deliveries do NOT all
+     * share one lock: an ordinary delivery is serialised on `pasteLock`, a steer
+     * on `steerLock`, and the two run concurrently by design. A field would let a
+     * steer's verdict decide whether a queued message's sender is told its
+     * delivery failed — a false ❌ carrying the wrong correlation id.
+     */
+    failDelivery(verdict, status) {
+        verdict.reached = true;
+        if (status)
+            this.emit("message_failed", status); // ❌
+        return false;
+    }
     /** Tell the fleet when an already-accepted cross-instance pane write failed. */
     reportCrossInstanceDeliveryFailure(meta, error) {
         if (!meta.from_instance)
@@ -3785,10 +4013,14 @@ export class Daemon extends EventEmitter {
             await this.wake();
             if (!this.isDeliveryEpochCurrent(deliveryEpoch))
                 return;
-            if (await this.deliverMessage(formatted, status, { steer: true, deliveryEpoch, submissionId: meta.message_id })) {
+            const verdict = { reached: false };
+            if (await this.deliverMessage(formatted, status, { steer: true, deliveryEpoch, submissionId: meta.message_id, verdict })) {
                 this.markTurnStarted(meta, formatted);
             }
-            else if (this.isDeliveryEpochCurrent(deliveryEpoch)) {
+            else if (verdict.reached && this.isDeliveryEpochCurrent(deliveryEpoch)) {
+                // Same rule as the queued path: a steer that never got to try is not a
+                // delivery failure. This holder is the steer's own, which is the point
+                // — it runs on steerLock while a queued delivery runs on pasteLock.
                 this.reportCrossInstanceDeliveryFailure(meta);
             }
         }).catch(err => {
@@ -3918,10 +4150,16 @@ export class Daemon extends EventEmitter {
                 // A fresh delivery begins a fresh turn — its bubble must not inherit
                 // the previous turn's tool list.
                 this.resetToolProgress();
-                if (await this.deliverMessage(formatted, status, { deliveryEpoch, submissionId: meta.message_id })) {
+                const verdict = { reached: false };
+                if (await this.deliverMessage(formatted, status, { deliveryEpoch, submissionId: meta.message_id, verdict })) {
                     this.markTurnStarted(meta, formatted);
                 }
-                else if (meta.from_instance && this.isDeliveryEpochCurrent(deliveryEpoch)) {
+                else if (meta.from_instance && verdict.reached
+                    && this.isDeliveryEpochCurrent(deliveryEpoch)) {
+                    // Only a delivery that reached a verdict is reported. A pane that is
+                    // not ready yet, a cancel, a storm hold or a shutdown all return
+                    // false without one, and telling the sender its message was lost
+                    // there would be the false ❌ of #826 in its other form.
                     this.reportCrossInstanceDeliveryFailure(meta);
                 }
             }
@@ -3953,6 +4191,9 @@ export class Daemon extends EventEmitter {
      * serial in both cases so separate PTY writes can never overlap.
      */
     async deliverMessage(formatted, status, opts) {
+        // The caller passes its own holder when it needs the answer; a system paste
+        // that ignores the outcome gets a throwaway.
+        const verdict = opts?.verdict ?? { reached: false };
         const cancelled = () => opts?.deliveryEpoch !== undefined
             && !this.isDeliveryEpochCurrent(opts.deliveryEpoch);
         if (cancelled() || this.stormWindow?.isStopped())
@@ -3976,7 +4217,7 @@ export class Daemon extends EventEmitter {
         await this.waitForSpawnToSettle();
         if (cancelled())
             return false;
-        if (this.refuseFatalStartupDelivery(status))
+        if (this.refuseFatalStartupDelivery(verdict, status))
             return false;
         let windowId = this.getWindowId();
         const supportsQueuedInput = this.backend?.supportsQueuedInput?.() === true;
@@ -4018,9 +4259,7 @@ export class Daemon extends EventEmitter {
                     // wedged CLI (where the text would sit unsubmitted and the next message
                     // would land on top of it) — and instead of holding the queue silently.
                     this.logger.error("Pane still busy after the idle wait — reporting delivery failure");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
             }
         }
@@ -4041,9 +4280,7 @@ export class Daemon extends EventEmitter {
                 // recovery Enter, so exactly STRANDED_INPUT_MAX_ROUNDS of them go out.
                 if (round >= STRANDED_INPUT_MAX_ROUNDS) {
                     this.logger.error({ round }, "Input row still not clear after the stranded-text recovery budget — reporting delivery failure");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
                 const stranded = await this.submitStrandedInputIfAny(windowId);
                 if (cancelled())
@@ -4052,18 +4289,14 @@ export class Daemon extends EventEmitter {
                     break;
                 if (stranded === "failed") {
                     this.logger.error({ round }, "Could not submit the stranded text — reporting delivery failure");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
                 const readyAgain = await this.waitForPaneReadyForDelivery(windowId);
                 if (cancelled())
                     return false;
                 if (!readyAgain) {
                     this.logger.error("Pane never returned to its prompt after submitting stranded input — reporting delivery failure");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
             }
         }
@@ -4075,15 +4308,13 @@ export class Daemon extends EventEmitter {
             const outcome = await this.paneWriteLock.run(async () => {
                 if (cancelled())
                     return false;
-                if (this.refuseFatalStartupDelivery(status))
+                if (this.refuseFatalStartupDelivery(verdict, status))
                     return false;
                 // A passive startup phase may paint after the outer readiness probe.
                 // It clears without input, so waiting under the pane lock cannot starve
                 // a dialog dismisser and closes the final clear→paste TOCTOU window.
                 if (!(await this.waitForInputTransientToClear("pre-write"))) {
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
                 // TOCTOU: the probes above ran outside this lock, and the CLI repaints
                 // whenever it likes — a resume prompt can be painted between "clear" and
@@ -4094,7 +4325,7 @@ export class Daemon extends EventEmitter {
                     if (probe.state !== "clear")
                         return "dialog";
                 }
-                return this.writeMessageToPane(formatted, windowId, handingOffToNativeQueue, status, opts?.submissionId);
+                return this.writeMessageToPane(formatted, windowId, handingOffToNativeQueue, status, opts?.submissionId, verdict);
             });
             if (outcome !== "dialog")
                 return outcome;
@@ -4103,18 +4334,14 @@ export class Daemon extends EventEmitter {
             // an honest failure rather than a message that never lands.
             if (round + 1 >= LATE_DIALOG_WRITE_ROUNDS) {
                 this.logger.error({ rounds: round + 1 }, "A dialog kept appearing before the pane write — reporting delivery failure");
-                if (status)
-                    this.emit("message_failed", status); // ❌
-                return false;
+                return this.failDelivery(verdict, status);
             }
             this.logger.info("Dialog appeared before the pane write — waiting for it to clear");
             const clear = gateWindowId ? await this.waitForPaneReadyForDelivery(gateWindowId) : false;
             if (cancelled())
                 return false;
             if (!clear) {
-                if (status)
-                    this.emit("message_failed", status); // ❌
-                return false;
+                return this.failDelivery(verdict, status);
             }
         }
     }
@@ -4149,13 +4376,47 @@ export class Daemon extends EventEmitter {
         return null;
     }
     /** Capture failure is unknown, never evidence that input is available. */
+    /**
+     * The budget for waiting out a passive transient, measured in progress rather
+     * than in wall clock.
+     *
+     * `observe(pane)` answers "may I keep waiting?". The stall timer restarts
+     * every time the pane text changes, so a resume that is still painting never
+     * runs out; a screen that has not changed for INPUT_TRANSIENT_STALL_MS, or a
+     * transient that outlives the ceiling, does. Both ends stay bounded — the
+     * point of #826 was never that the wait should be unlimited, it was that a
+     * flat 30s could not tell "slow" from "stuck".
+     */
+    transientProgressBudget(overallDeadline) {
+        const ceiling = Math.min(overallDeadline, Date.now() + INPUT_TRANSIENT_WAIT_MS);
+        let lastPane = null;
+        let stallDeadline = 0;
+        const budget = {
+            stalled: false,
+            observe(pane) {
+                const now = Date.now();
+                if (pane !== lastPane) {
+                    lastPane = pane;
+                    stallDeadline = now + INPUT_TRANSIENT_STALL_MS;
+                }
+                if (now >= ceiling)
+                    return false;
+                budget.stalled = now >= stallDeadline;
+                return !budget.stalled;
+            },
+        };
+        return budget;
+    }
     async probeInputTransient() {
         if (this.guardedInputTransients().length === 0 || !this.tmux)
             return { state: "clear" };
         try {
             const pane = await this.tmux.capturePane();
             const transient = this.inputTransientInPane(pane);
-            return transient ? { state: "active", transient } : { state: "clear" };
+            // The pane text comes back with the verdict: a transient that is still
+            // repainting is still working, and that is the only thing separating a
+            // slow resume from a wedged one.
+            return transient ? { state: "active", transient, pane } : { state: "clear" };
         }
         catch (err) {
             this.logger.debug({ err }, "capture-pane failed during the input-transient probe — pane state unknown");
@@ -4171,7 +4432,12 @@ export class Daemon extends EventEmitter {
         const generation = this.inputTransientGuardGeneration;
         if (generation === null || generation !== this.spawnGeneration)
             return true;
-        const deadline = Date.now() + timeoutMs;
+        // Same progress rule as the outer readiness wait, for the same reason: this
+        // runs under the pane write lock, so a flat cap here turned a resume that
+        // repainted one second too late into a discarded message. Holding the lock
+        // while the pane is still painting costs nothing — every other writer is
+        // waiting on the same screen.
+        const budget = this.transientProgressBudget(Date.now() + timeoutMs);
         let observedDescription = null;
         for (;;) {
             if (this.inputTransientGuardGeneration !== generation || this.spawnGeneration !== generation) {
@@ -4189,12 +4455,18 @@ export class Daemon extends EventEmitter {
                 observedDescription = probe.transient.description;
                 this.logger.info({ phase, transient: probe.transient.description, generation }, "CLI is still completing startup — waiting before sending Enter");
             }
-            const remaining = deadline - Date.now();
-            if (remaining <= 0) {
-                this.logger.error({ phase, generation, timeoutMs, transient: observedDescription }, "CLI input stayed unavailable — refusing to send Enter");
+            // "unknown" (capture-pane failed) has to consume the budget too, or an
+            // unreadable pane would loop forever now that the flat deadline is gone.
+            // It never "changes", so it stalls out on the same rule.
+            if (!budget.observe(probe.state === "active" ? probe.pane : "\u0000unreadable")) {
+                this.logger.error({
+                    phase, generation, transient: observedDescription,
+                    stalledForMs: budget.stalled ? INPUT_TRANSIENT_STALL_MS : undefined,
+                    ceilingMs: timeoutMs,
+                }, "CLI input stayed unavailable — refusing to send Enter");
                 return false;
             }
-            await new Promise(r => setTimeout(r, Math.min(INPUT_TRANSIENT_POLL_MS, remaining)));
+            await new Promise(r => setTimeout(r, INPUT_TRANSIENT_POLL_MS));
         }
     }
     static dialogKey(dialog) {
@@ -4202,8 +4474,33 @@ export class Daemon extends EventEmitter {
     }
     /** A dialog counts only when it is the CURRENT interactive region, if the backend can tell; else by pattern. */
     static dialogMatches(dialog, pane) {
+        dialog.pattern.lastIndex = 0;
         return dialog.isActive ? dialog.isActive(pane) : dialog.pattern.test(pane);
     }
+    /** Refresh the separate stdin-blocked observation from one pane capture. */
+    updateInputBlockedState(pane, dialogs = this.backend?.getRuntimeDialogs?.() ?? []) {
+        const active = dialogs.find(dialog => dialog.inputBlocked && Daemon.dialogMatches(dialog, pane)) ?? null;
+        const nextKey = active ? Daemon.dialogKey(active) : null;
+        if (nextKey !== this.inputBlockedDialogKey) {
+            this.inputBlockedDialogKey = nextKey;
+            this.emit("input_blocked", {
+                name: this.name,
+                blocked: active !== null,
+                description: active?.description,
+            });
+        }
+        if (!active && this.autoResolvedDialogGeneration === this.spawnGeneration) {
+            // The old screen is gone.  A later dangerous command in the same spawn
+            // must get its own one-shot answer.
+            this.autoResolvedDialogKey = null;
+            this.autoResolvedDialogGeneration = 0;
+        }
+        return active;
+    }
+    /** Whether a runtime prompt currently owns the pane's stdin. */
+    isInputBlocked() {
+        return this.inputBlockedDialogKey !== null;
+    }
     /**
      * Tri-state liveness. tmux's own isWindowAlive folds every query failure
      * into `false`, so a transient tmux hiccup would read as "the CLI died" —
@@ -4369,7 +4666,7 @@ export class Daemon extends EventEmitter {
         const deadline = Date.now() + timeoutMs;
         const bottomGated = this.backend?.dropsEnterWhileBusy?.() === true;
         let unknownStreak = 0;
-        let transientDeadline = 0;
+        let transientBudget = null;
         for (;;) {
             const remaining = deadline - Date.now();
             if (remaining <= 0)
@@ -4382,15 +4679,19 @@ export class Daemon extends EventEmitter {
             const transient = await this.probeInputTransient();
             if (transient.state === "active") {
                 unknownStreak = 0;
-                transientDeadline ||= Math.min(deadline, Date.now() + INPUT_TRANSIENT_WAIT_MS);
-                if (Date.now() >= transientDeadline) {
-                    this.logger.error({ transient: transient.transient.description, timeoutMs: INPUT_TRANSIENT_WAIT_MS }, "CLI input stayed unavailable during the delivery-readiness wait");
+                transientBudget ||= this.transientProgressBudget(deadline);
+                if (!transientBudget.observe(transient.pane)) {
+                    this.logger.error({
+                        transient: transient.transient.description,
+                        stalledForMs: transientBudget.stalled ? INPUT_TRANSIENT_STALL_MS : undefined,
+                        ceilingMs: INPUT_TRANSIENT_WAIT_MS,
+                    }, "CLI input stayed unavailable during the delivery-readiness wait");
                     return false;
                 }
                 await new Promise(r => setTimeout(r, BOTTOM_READY_POLL_MS));
                 continue;
             }
-            transientDeadline = 0;
+            transientBudget = null;
             if (transient.state === "unknown") {
                 if (++unknownStreak >= DIALOG_PROBE_UNKNOWN_MAX) {
                     this.logger.error({ probes: unknownStreak }, "Pane stayed unreadable during the input-transient probe — refusing to deliver blind");
@@ -4536,12 +4837,11 @@ export class Daemon extends EventEmitter {
      * what to fix, and holding would only build a queue that floods the pane the
      * moment the flag clears.
      */
-    refuseFatalStartupDelivery(status) {
+    refuseFatalStartupDelivery(verdict, status) {
         if (!this.fatalStartupBlocked)
             return false;
         this.logger.error("Delivery refused — CLI is parked on a fatal startup screen");
-        if (status)
-            this.emit("message_failed", status); // ❌
+        this.failDelivery(verdict, status);
         return true;
     }
     /**
@@ -4556,7 +4856,7 @@ export class Daemon extends EventEmitter {
             return true;
         if (this.controlClient.isIdle(windowId))
             return true;
-        if (this.backend?.hasPeriodicPaneRedraw?.() !== true || this.instanceState !== "idle")
+        if (!this.canTrustRedrawIdleState() || this.instanceState !== "idle")
             return false;
         const lastOutputAt = this.controlClient.getLastOutputAt(windowId);
         if (lastOutputAt === undefined || !this.instanceStateMachine)
@@ -4568,7 +4868,7 @@ export class Daemon extends EventEmitter {
     waitForPaneIdleForDelivery(windowId, timeoutMs = 30 * 60_000) {
         if (!this.controlClient)
             return Promise.resolve(true);
-        if (this.backend?.hasPeriodicPaneRedraw?.() !== true) {
+        if (!this.canTrustRedrawIdleState()) {
             return this.controlClient.waitUntilIdle(windowId, timeoutMs);
         }
         if (this.isPaneIdleForDelivery(windowId))
@@ -4587,6 +4887,20 @@ export class Daemon extends EventEmitter {
             }, timeoutMs);
         });
     }
+    /**
+     * Antigravity has always opted into pane-state delivery readiness because its
+     * footer redraws while idle.  Codex's structural idle proof is useful only
+     * while the event-driven state monitor is actually running; without that
+     * monitor there is no fresh proof to trust, so preserve the legacy
+     * TmuxControlClient.waitUntilIdle fallback.  This matters during isolated
+     * startup/recovery paths as well as in tests: merely having a matcher must
+     * never turn a missing observer into a 30-minute polling wait.
+     */
+    canTrustRedrawIdleState() {
+        if (this.backend?.hasPeriodicPaneRedraw?.() === true)
+            return true;
+        return this.instanceStateMonitorActive && !!this.backend?.isPeriodicRedrawIdlePane;
+    }
     /**
      * The write half of a delivery: paste → Enter → confirm, with retries.
      *
@@ -4606,7 +4920,10 @@ export class Daemon extends EventEmitter {
         }
         return sent;
     }
-    async writeMessageToPane(formatted, initialWindowId, handingOffToNativeQueue, status, submissionId) {
+    async writeMessageToPane(formatted, initialWindowId, handingOffToNativeQueue, status, submissionId, 
+    // Last and defaulted so the positional callers that ignore the outcome stay
+    // readable; deliverMessage, the only one that reports, always passes its own.
+    verdict = { reached: false }) {
         const signature = this.submissionSignature(formatted, submissionId);
         let windowId = initialWindowId;
         // Bug A: paste with backoff. Transient failures are usually a stale window id
@@ -4625,9 +4942,9 @@ export class Daemon extends EventEmitter {
                     ? "pasteBuffer failed — recovering window and backing off"
                     : "pasteBuffer failed — non-retryable tmux error");
                 if (!recoverable) {
-                    if (status)
-                        this.emit("message_failed", status);
-                    return false;
+                    // A tmux error the window cannot be recovered from: the text will
+                    // never reach this pane, so it is a verdict like the others.
+                    return this.failDelivery(verdict, status);
                 }
                 windowId = (await this.recoverWindow()) ?? windowId;
                 if (attempt < maxAttempts)
@@ -4657,9 +4974,7 @@ export class Daemon extends EventEmitter {
             }
             let enterAt = Date.now();
             if (!(await this.sendDeliveryEnter("initial-submit"))) {
-                if (status)
-                    this.emit("message_failed", status); // ❌
-                return false;
+                return this.failDelivery(verdict, status);
             }
             // Kiro's legacy TUI can swallow Enter while it is still processing a large
             // paste — not only during the post-ready redraw (#479): on slower hosts it
@@ -4742,9 +5057,7 @@ export class Daemon extends EventEmitter {
                     this.logger.warn("Message still in the input row after idle — submitting the existing text instead of pasting it again");
                     const strandedAt = Date.now();
                     if (!(await this.sendDeliveryEnter("native-queue-stranded-submit"))) {
-                        if (status)
-                            this.emit("message_failed", status); // ❌
-                        return false;
+                        return this.failDelivery(verdict, status);
                     }
                     const afterEnter = await this.confirmSubmitted(signature, pasteBaseline);
                     if (afterEnter === "submitted") {
@@ -4759,9 +5072,7 @@ export class Daemon extends EventEmitter {
                     // message nobody submitted. Output is corroboration; text sitting in
                     // the input row is disqualifying, and disqualifying evidence wins.
                     this.logger.error({ afterEnter, strandedAt }, "Stranded message could not be submitted by Enter");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
                 // "unproven": nothing of ours is on screen — the paste itself was lost,
                 // so pasting it again cannot duplicate anything.
@@ -4770,16 +5081,12 @@ export class Daemon extends EventEmitter {
                     this.logger.error({
                         tmuxError: this.tmux.getLastPasteError?.() ?? "unknown tmux paste failure",
                     }, "Idle-gated redelivery paste failed after native-queue silent loss");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
                 await new Promise(r => setTimeout(r, NORMAL_ENTER_SETTLE_MS));
                 const retryAt = Date.now();
                 if (!(await this.sendDeliveryEnter("native-queue-idle-redelivery"))) {
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
                 if (windowId && this.controlClient) {
                     if (await this.confirmAfterEnter(windowId, retryAt, signature, pasteBaseline, "native-queue-idle-redelivery-retry")) {
@@ -4794,9 +5101,7 @@ export class Daemon extends EventEmitter {
                     return true;
                 }
                 this.logger.error("Idle-gated redelivery also failed after native-queue silent loss");
-                if (status)
-                    this.emit("message_failed", status); // ❌
-                return false;
+                return this.failDelivery(verdict, status);
             }
             if (windowId && this.controlClient && this.backend?.dropsEnterWhileBusy?.() === true) {
                 // F2: output after Enter is necessary but not sufficient — the paste
@@ -4810,9 +5115,7 @@ export class Daemon extends EventEmitter {
                     const promptBack = await this.waitForPaneReadyForDelivery(windowId, STRANDED_RETRY_READY_WAIT_MS);
                     const retryAt = Date.now();
                     if (promptBack && !(await this.sendDeliveryEnter("stranded-text-retry"))) {
-                        if (status)
-                            this.emit("message_failed", status); // ❌
-                        return false;
+                        return this.failDelivery(verdict, status);
                     }
                     submitted = promptBack && await this.confirmSubmittedAfterEnter(windowId, retryAt, formatted);
                 }
@@ -4822,9 +5125,7 @@ export class Daemon extends EventEmitter {
                 }
                 else {
                     this.logger.error("Message pasted but never submitted (text still in the input row after Enter retry)");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
             }
             else if (windowId && this.controlClient) {
@@ -4849,9 +5150,7 @@ export class Daemon extends EventEmitter {
                     // forever and the next delivery pasted on top — submitting two messages
                     // as one. Say so instead.
                     this.logger.error("Message pasted but never submitted (no idle→busy after two Enters)");
-                    if (status)
-                        this.emit("message_failed", status); // ❌
-                    return false;
+                    return this.failDelivery(verdict, status);
                 }
             }
             else {
@@ -4864,9 +5163,7 @@ export class Daemon extends EventEmitter {
             return true;
         }
         this.logger.error("Message delivery failed after retries — window not ready");
-        if (status)
-            this.emit("message_failed", status); // ❌
-        return false;
+        return this.failDelivery(verdict, status);
     }
     /**
      * The single place a pasted message is judged submitted, shared by the
@@ -5327,7 +5624,12 @@ export class Daemon extends EventEmitter {
             this.ipcServer?.broadcast({
                 type: typeMap[tool],
                 payload: args,
-                meta: { chat_id: this.lastChatId, thread_id: this.lastThreadId, instance_name: this.name },
+                meta: {
+                    chat_id: this.lastChatId,
+                    thread_id: this.lastThreadId,
+                    adapter_id: this.lastAdapterId,
+                    instance_name: this.name,
+                },
                 fleetRequestId: fleetReqId,
             });
             return;
@@ -5517,10 +5819,17 @@ export class Daemon extends EventEmitter {
         // profile instead of `full`. Every tool's schema is resent on every API call,
         // so full (44 tools) costs a general ~22k chars per turn — the single largest
         // slice of its prompt. Explicit config still wins.
-        const defaultToolSet = this.config.general_topic ? "general" : undefined;
-        const toolSet = this.config.tool_set ?? defaultToolSet;
-        if (toolSet)
-            mcpEnv.AGEND_TOOL_SET = toolSet;
+        // One rule for "is this a general", shared with everywhere else that asks.
+        // The daemon used to read `general_topic` alone while `isGeneralInstance`
+        // also accepted the name, so an instance called `general` without the flag
+        // was a worker here and a general everywhere else.
+        const isGeneral = this.config.general_topic === true || this.name === "general";
+        // No third argument for an ordinary instance: the default is `worker` now,
+        // and naming it here would be a second place to change it.
+        const toolSet = isGeneral
+            ? resolveToolSet(this.config, this.name, "general")
+            : resolveToolSet(this.config, this.name);
+        mcpEnv.AGEND_TOOL_SET = toolSet;
         if (this.config.display_name)
             mcpEnv.AGEND_DISPLAY_NAME = this.config.display_name;
         if (this.config.description)
@@ -5953,6 +6262,10 @@ export class Daemon extends EventEmitter {
         this.startupAborted = true;
         this.freezeRuntimeMonitors();
         this.pendingIpcRequests.clear();
+        if (this.museUsageRelay) {
+            await this.museUsageRelay.stop().catch(() => { });
+            this.museUsageRelay = null;
+        }
         try {
             await this.killProcessTree();
         }
@@ -6008,6 +6321,32 @@ export class Daemon extends EventEmitter {
             reason: reuseWindow ? "wake" : this.lastSpawnAt > 0 ? "recovery" : "startup",
         }, () => this.trySpawnInsideGate(reuseWindow, startupTimeoutMs));
     }
+    /**
+     * A relay crash must not make the daemon kill a live Muse process. The
+     * supervisor normally reclaims the same port; when that bounded recovery
+     * fails, mark usage unavailable and leave Muse untouched. A later natural
+     * spawn sees museRelayFallback and starts direct, without interrupting the
+     * current conversation or destroying its session.
+     */
+    switchMuseToDirect() {
+        if (this.museRelayFallbackInFlight || this.startupAborted || this.backend?.binaryName !== "muse") {
+            return this.museRelayFallbackInFlight ?? Promise.resolve();
+        }
+        this.museRelayFallbackInFlight = (async () => {
+            this.museRelayFallback = true;
+            this.logger.warn("Muse usage relay could not recover — usage is unavailable until the next natural Muse restart");
+            try {
+                if (this.museUsageRelay) {
+                    await this.museUsageRelay.stop().catch(() => { });
+                    this.museUsageRelay = null;
+                }
+            }
+            catch (err) {
+                this.logger.warn({ reason: err instanceof Error ? err.message : "relay stop failed" }, "Muse usage relay cleanup failed");
+            }
+        })().finally(() => { this.museRelayFallbackInFlight = null; });
+        return this.museRelayFallbackInFlight;
+    }
     /**
      * Tell the agent its instructions moved, once the CLI is idle.
      *
@@ -6143,7 +6482,30 @@ export class Daemon extends EventEmitter {
         if (backendConfig.agentMode === "cli" && backendConfig.agentPort) {
             envPrefix += ` AGEND_PORT=${backendConfig.agentPort}`;
         }
-        const cmd = `${envPrefix} ` + this.backend.buildCommand(backendConfig);
+        // Muse's usage relay must be listening before its command is assembled.
+        // Preparation is best-effort: if the loopback port cannot be bound, leave
+        // museBaseUrl unset and let Muse connect directly so usage never blocks a
+        // conversation.
+        let launchConfig = backendConfig;
+        if (this.backend?.binaryName === "muse" && !this.museRelayFallback) {
+            try {
+                this.museUsageRelay ??= new MuseUsageRelay({
+                    instanceDir: this.instanceDir,
+                    onUnavailable: () => { void this.switchMuseToDirect(); },
+                });
+                const baseUrl = await this.museUsageRelay.start();
+                launchConfig = { ...backendConfig, museBaseUrl: baseUrl };
+            }
+            catch (err) {
+                this.logger.warn({ reason: err instanceof Error ? err.message : "relay unavailable" }, "Muse usage relay unavailable — using direct connection");
+                if (this.museUsageRelay) {
+                    await this.museUsageRelay.stop().catch(() => { });
+                    this.museUsageRelay = null;
+                }
+                clearMuseUsageSnapshot(this.instanceDir);
+            }
+        }
+        const cmd = `${envPrefix} ` + this.backend.buildCommand(launchConfig);
         // Ensure tmux session exists (may have been destroyed if all windows died)
         await TmuxManager.ensureSession(this.tmuxSessionName);
         if (this.stormWindow?.observeServerAlive(await TmuxManager.getServerPid(this.tmuxSessionName))) {
@@ -6579,6 +6941,30 @@ export class Daemon extends EventEmitter {
         }, "Snapshot written");
         return snapshot;
     }
+    /**
+     * The credential profile's store this instance's CLI writes to, if any.
+     *
+     * The conversation lives in the same file as the login, so an instance on a
+     * profile keeps its transcript there too — reading the shared store would
+     * follow whichever *other* agent happens to be talking, or find nothing.
+     * Built with the same `getAgendHome()` the launch prefix uses, or the two
+     * would disagree about where the profile is.
+     */
+    credentialProfileStore() {
+        const backendName = this.config.backend ?? "claude-code";
+        let profile;
+        try {
+            profile = resolveCredentialProfile(this.config.backend_options?.[backendName]);
+        }
+        catch {
+            // A malformed name is refused where it is written; a transcript reader
+            // must not take the instance down over it.
+            return undefined;
+        }
+        if (!profile)
+            return undefined;
+        return credentialProfileStoreHome(getAgendHome(), backendName, profile);
+    }
     /** Collect ring buffer data for handover to a replacement instance. */
     collectHandoverContext() {
         const lines = [];