visionclaw 0.1.219-dev.codex-issue-2805-worker-runtime.3 → 0.1.219-dev.codex-2941-task-board-on-main.1

package/dist/agent/lifecycle-transitions.d.ts

@@ -39,6 +39,7 @@ export type ForegroundPhase = "Idle" | "Running" | "Recovering" | "Stopping";
  * only after that release.
  */
 export declare function endForegroundWake(input: {
+    readonly state?: LifecyclePublication;
     readonly from: Exclude<ForegroundPhase, "Idle" | "Stopping">;
     readonly cleanup: () => void;
     readonly release: () => void;
@@ -79,13 +80,54 @@ export declare function nextRecoveryPhase(input: {
     readonly bucket: RecoveryBucket;
     readonly spent: number;
 }): "Recovering" | "Stopping";
+/**
+ * The published lifecycle plus whether the host entry is held without an
+ * engine receipt. `entryHeld` is not a sixth state: Gated still requires the
+ * receipt, and a closed entry without one stays Idle but cannot take work.
+ */
+export interface PublishedLifecycle {
+    readonly lifecycle: LifecycleState;
+    readonly entryHeld: boolean;
+}
+/** What a caller may store. Scheduling and the dashboard read it back. */
+export interface LifecyclePublication {
+    lifecycle?: LifecycleState;
+    entryHeld?: boolean;
+}
+/**
+ * Move the published lifecycle. The transition table is checked against the
+ * state already stored, so a caller cannot skip Stopping or enter Gated from
+ * a running wake. Staying in the same state is not an edge.
+ *
+ * `barrierConfirmed` distinguishes Gated from a closed entry. Without the
+ * receipt the entry is held and the published state stays Idle.
+ */
+export declare function publishLifecycle(target: LifecyclePublication, next: LifecycleState, barrierConfirmed?: boolean): PublishedLifecycle;
+/**
+ * Whether the thread loop may start new foreground work.
+ *
+ * Only a published Idle admits work, and Idle is not enough when the entry
+ * is held. Claude never confirms the barrier, so its service gate and
+ * fund-league hold stay refused until the entry reopens.
+ */
+export declare function canAdmitForegroundWork(state: LifecyclePublication): boolean;
+/**
+ * A mid-turn interrupt belongs to the wake that is already Running. Stopping,
+ * Recovering, and a closed entry do not drain queued chat into that turn.
+ */
+export declare function canDrainRunningTurn(state: LifecyclePublication & {
+    busy?: boolean;
+    gated?: boolean;
+}): boolean;
 /**
  * How a host entry may close. A foreground run must stop before the entry is
  * marked closed. An idle loop may close directly. Neither path confirms the
  * engine barrier: that still needs an engine receipt, which this does not have.
  */
 export declare function closeHostEntry(input: {
+    readonly state: LifecyclePublication;
     readonly busy: boolean;
+    readonly barrierConfirmed?: boolean;
     readonly requestStop: () => void;
     readonly markClosed: () => void;
 }): "Idle" | "Stopping";

package/dist/agent/lifecycle-transitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-transitions.d.ts","sourceRoot":"","sources":["../../src/agent/lifecycle-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAC,CAM7F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,CAAC,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,EAMjG,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAExF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CAGxF;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;AAE7E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CACrD,GAAG,eAAe,CAQlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,2HASnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAS3E,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GAAG,YAAY,GAAG,UAAU,CAU5B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC,GAAG,MAAM,GAAG,UAAU,CAWtB"}
+{"version":3,"file":"lifecycle-transitions.d.ts","sourceRoot":"","sources":["../../src/agent/lifecycle-transitions.ts"],"names":[],"mappings":"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"}

package/dist/agent/lifecycle-transitions.js

@@ -43,10 +43,19 @@ export function assertLifecycleTransition(from, to) {
  * only after that release.
  */
 export function endForegroundWake(input) {
-    assertLifecycleTransition(input.from, "Stopping");
+    // A wake the loop already returned to Idle has nothing left to stop.
+    // Stopping is only entered from the run that still holds the slot.
+    const phase = input.state?.lifecycle;
+    if ((phase === "Running" || phase === "Recovering") && input.state)
+        publishLifecycle(input.state, "Stopping");
+    else if (!input.state)
+        assertLifecycleTransition(input.from, "Stopping");
     input.onPhase?.("Stopping");
     input.cleanup();
-    assertLifecycleTransition("Stopping", "Idle");
+    if (input.state?.lifecycle === "Stopping")
+        publishLifecycle(input.state, "Idle");
+    else if (!input.state)
+        assertLifecycleTransition("Stopping", "Idle");
     input.release();
     input.onPhase?.("Idle");
     return "Idle";
@@ -112,20 +121,67 @@ export function nextRecoveryPhase(input) {
     assertLifecycleTransition("Recovering", "Stopping");
     return "Stopping";
 }
+/**
+ * Move the published lifecycle. The transition table is checked against the
+ * state already stored, so a caller cannot skip Stopping or enter Gated from
+ * a running wake. Staying in the same state is not an edge.
+ *
+ * `barrierConfirmed` distinguishes Gated from a closed entry. Without the
+ * receipt the entry is held and the published state stays Idle.
+ */
+export function publishLifecycle(target, next, barrierConfirmed = false) {
+    // Gated without a receipt is not Gated. The legal edge is still checked,
+    // then the published state stays Idle with the entry held.
+    const published = next === "Gated" && !barrierConfirmed ? "Idle" : next;
+    const current = target.lifecycle ?? "Idle";
+    if (current !== next)
+        assertLifecycleTransition(current, next);
+    if (current !== published)
+        assertLifecycleTransition(current, published);
+    target.lifecycle = published;
+    target.entryHeld = next === "Gated" && !barrierConfirmed;
+    return { lifecycle: target.lifecycle, entryHeld: target.entryHeld };
+}
+/**
+ * Whether the thread loop may start new foreground work.
+ *
+ * Only a published Idle admits work, and Idle is not enough when the entry
+ * is held. Claude never confirms the barrier, so its service gate and
+ * fund-league hold stay refused until the entry reopens.
+ */
+export function canAdmitForegroundWork(state) {
+    return (state.lifecycle ?? "Idle") === "Idle" && !state.entryHeld;
+}
+/**
+ * A mid-turn interrupt belongs to the wake that is already Running. Stopping,
+ * Recovering, and a closed entry do not drain queued chat into that turn.
+ */
+export function canDrainRunningTurn(state) {
+    // A state that was never published still answers with the slot it holds.
+    // Once published, only Running with an open entry drains a mid-turn batch.
+    if (state.lifecycle === undefined)
+        return state.busy === true && state.gated !== true;
+    return state.lifecycle === "Running" && !state.entryHeld;
+}
 /**
  * How a host entry may close. A foreground run must stop before the entry is
  * marked closed. An idle loop may close directly. Neither path confirms the
  * engine barrier: that still needs an engine receipt, which this does not have.
  */
 export function closeHostEntry(input) {
-    if (input.busy) {
-        assertLifecycleTransition("Running", "Stopping");
+    const barrierConfirmed = input.barrierConfirmed === true;
+    // `busy` still says a run holds the slot after Stopping has been published.
+    // Stopping again would be an illegal edge, so only Running or Recovering
+    // takes that step. Idle closes directly.
+    const running = input.state.lifecycle === "Running" || input.state.lifecycle === "Recovering";
+    if (input.busy && running) {
+        publishLifecycle(input.state, "Stopping");
         input.requestStop();
-        assertLifecycleTransition("Stopping", "Gated");
+        publishLifecycle(input.state, "Gated", barrierConfirmed);
         input.markClosed();
         return "Stopping";
     }
-    assertLifecycleTransition("Idle", "Gated");
+    publishLifecycle(input.state, "Gated", barrierConfirmed);
     input.markClosed();
     return "Idle";
 }

package/dist/agent/lifecycle-transitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-transitions.js","sourceRoot":"","sources":["../../src/agent/lifecycle-transitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lifecycle-transitions.js","sourceRoot":"","sources":["../../src/agent/lifecycle-transitions.ts"],"names":[],"mappings":"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"}

package/dist/agent/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,EAA+D,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG1I,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAsBpD,OAAO,EAAkB,KAAK,UAAU,EAA6G,MAAM,YAAY,CAAC;AA4BxK,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAYtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAmChE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAS3C;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B;+DAC2D;IAC3D,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uBAAuB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,cAAc,EAAE,cAAc,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3I;;;;OAIG;IACH,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,YAAY,CAAC;QACpB,yEAAyE;QACzE,SAAS,CAAC,EAAE,eAAe,CAAC;KAC7B,CAAC;CACH,GACA,OAAO,CAAC,IAAI,CAAC,CA8lDf"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,EAA+D,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG1I,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAuBpD,OAAO,EAAkB,KAAK,UAAU,EAA6G,MAAM,YAAY,CAAC;AA4BxK,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAK9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAYtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAqChE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAS3C;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B;+DAC2D;IAC3D,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,uBAAuB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,cAAc,EAAE,cAAc,CAAC;QAAC,YAAY,EAAE,YAAY,CAAC;QAAC,WAAW,EAAE,WAAW,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3I;;;;OAIG;IACH,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,YAAY,CAAC;QACpB,yEAAyE;QACzE,SAAS,CAAC,EAAE,eAAe,CAAC;KAC7B,CAAC;CACH,GACA,OAAO,CAAC,IAAI,CAAC,CA0pDf"}

package/dist/agent/loop.js

@@ -13,9 +13,9 @@
  *  - ChannelManager:    messaging channel adapters
  */
 import { createDefaultExternalContextRegistry, ExternalContextRegistry } from "./external-context/registry.js";
-import { createHash, randomUUID } from "node:crypto";
-import { beginLifecycleRun, createLifecycleRunId, deriveShadowLifecycleState, endLifecycleRun, traceLifecycle, traceShadowLifecycle } from "./lifecycle-trace.js";
-import { closeHostEntry, endForegroundWake } from "./lifecycle-transitions.js";
+import { randomUUID } from "node:crypto";
+import { beginLifecycleRun, createLifecycleRunId, endLifecycleRun, traceLifecycle, traceShadowLifecycle } from "./lifecycle-trace.js";
+import { canAdmitForegroundWork, closeHostEntry, endForegroundWake, publishLifecycle } from "./lifecycle-transitions.js";
 import { isProactiveWakeEnabled, isTunnelEnabled, isWorkspaceEnabled } from "../config/types.js";
 import { DEFAULT_THREAD_ID, normalizeChannelName, resolveThreadId } from "../channels/interface.js";
 import { buildSystemPrompt } from "./system-prompt.js";
@@ -31,6 +31,7 @@ import { loadOwnerConfig, consumePendingUpgrade, consumePendingRestart, writePen
 import { syncSystemTimezone } from "../utils/timezone.js";
 import { logger } from "../logger.js";
 import { cleanOldScreenshots } from "../tools/screenshot.js";
+import { wakeDispatchId } from "../tools/delegation.js";
 import { getEffectiveEngine, maybeStartApiProxy } from "./model-provider.js";
 import { EngineFallbackManager, setActiveEngineFallback } from "./engine-fallback.js";
 import { cleanupOldTranscripts } from "./session-trimmer.js";
@@ -91,6 +92,8 @@ import { retireLegacyServices } from "../service/retired-services.js";
 import { backfillMissingThreadApplications, migrateLegacyThreadApplications, threadApplicationBackfillHealthEvent } from "../threads/application-migration.js";
 import { currentApplicationContext, inheritThreadApplication, threadApplication } from "../threads/application-context.js";
 import { ForemanHost } from "../threads/foreman-host.js";
+import { onTaskSettled, reportTaskSettled, settledTaskState } from "../threads/task-settlement.js";
+import { bindRuntimeContext } from "./runtime-context.js";
 import { ForemanStore } from "../threads/foreman-store.js";
 import { canDelegateTasks, foremanEventsOf, getForemanClient, installForemanClient, isForemanRuntime, supportsTaskRuntime } from "../threads/foreman-protocol.js";
 import { ForegroundTaskTracker, installForegroundTaskTracker } from "../threads/foreground-task.js";
@@ -190,6 +193,22 @@ export async function startAgentLoop(config, options) {
                 channelManager.publishThreadActivity("default", activity, activity.workerInstanceId, deliveryTarget);
             },
         });
+    // The progress card waits for handed-off Tasks; it ends when they end,
+    // whether or not their result wakes this conversation.
+    const finishBackgroundCard = (taskId, state) => {
+        if (workerMode)
+            workerMode.relay.finishBackgroundActivity(taskId, state);
+        else
+            mainActivityController?.finishBackgroundTask(taskId, state);
+    };
+    const stopSettlementListener = onTaskSettled(bindRuntimeContext((threadId, taskId, state) => {
+        if (threadId === executionContext.threadId)
+            finishBackgroundCard(taskId, state);
+    }));
+    registerShutdownCallback(() => {
+        stopSettlementListener();
+        return Promise.resolve();
+    });
     const finAppCapabilityState = {
         runtimeReady: false,
         active: null,
@@ -236,6 +255,13 @@ export async function startAgentLoop(config, options) {
                 ?? Promise.resolve({ ok: false, text: "Business reads are unavailable" }),
         });
         supervisor.onExecutionEvent((event, caller) => {
+            // The board and the progress card are a view: never let them break delivery.
+            try {
+                foremanHost?.publishTaskState(event, caller);
+            }
+            catch (error) {
+                logger.warn(`Background task state was not published: ${error instanceof Error ? error.message : String(error)}`);
+            }
             if (caller.kind !== "tui")
                 return;
             channelManager.getAdapter("tui")?.publishExecutionEvent(event);
@@ -272,6 +298,13 @@ export async function startAgentLoop(config, options) {
                     const owner = resolveOwnerDefaultTarget(config, loadOwnerConfig());
                     return owner ? { channel: owner.channel, to: owner.to } : null;
                 },
+                publishTask: (target, task) => {
+                    const adapter = channelManager.getAdapter(target.channel);
+                    // The board repairs rows whose final update was lost from the ledger.
+                    adapter?.setBackgroundTaskLookup?.((taskId) => activeForemanHost?.taskView(taskId) ?? null);
+                    adapter?.publishBackgroundTask?.(target, task);
+                },
+                settleTask: reportTaskSettled,
                 locale: () => resolveLocale(loadOwnerConfig().language),
             });
             const host = foremanHost;
@@ -508,7 +541,11 @@ export async function startAgentLoop(config, options) {
         activityTracker,
         busy: false,
         stopRequested: false,
+        lifecycle: "Idle",
+        entryHeld: false,
         requestStop: () => {
+            // Stopping is published by the caller that decided to end the wake.
+            // This only records the request and asks the engine to stop.
             agentState.stopRequested = true;
             requestSessionStop();
         },
@@ -760,11 +797,11 @@ export async function startAgentLoop(config, options) {
             wakeMainLoop();
             return;
         }
-        if (agentState.busy) {
+        if (!canAdmitForegroundWork(agentState)) {
             // Correlated internal requests are durable queued work, not chat
             // interrupts. They must own a fresh turn for precise lifecycle and
-            // cancellation semantics.
-            if (typeof msg.meta?.tuiRequestId === "string")
+            // cancellation semantics. A closed entry is not a turn to interrupt.
+            if (typeof msg.meta?.tuiRequestId === "string" || agentState.entryHeld || agentState.lifecycle === "Gated")
                 return;
             interruptHandler.schedule();
         }
@@ -916,7 +953,7 @@ export async function startAgentLoop(config, options) {
             logger.system("[nightly-maintenance] Dreaming needs the thread supervisor (multiThread); skipped on this profile");
         nightlyMaintenance = new NightlyMaintenance({
             tryAcquire: () => {
-                if (agentState.busy || agentState.learning || agentState.compacting || agentState.gated
+                if (!canAdmitForegroundWork(agentState) || agentState.learning || agentState.compacting
                     || !messageQueue.isEmpty() || readFundLeagueHold()
                     || shouldEnforceServiceGate(heartbeat.lastServiceStatus))
                     return null;
@@ -930,6 +967,7 @@ export async function startAgentLoop(config, options) {
                     // Maintenance holds the slot the way a foreground wake does. Release
                     // it through Stopping so workers resume only after the slot is free.
                     endForegroundWake({
+                        state: agentState,
                         from: "Running",
                         cleanup: () => { agentState.learning = false; },
                         release: () => {
@@ -1014,7 +1052,9 @@ export async function startAgentLoop(config, options) {
             // held stops first; an idle loop closes the entry directly. Neither
             // confirms an engine barrier.
             closeHostEntry({
+                state: agentState,
                 busy: agentState.busy,
+                barrierConfirmed: session.executionBarrierConfirmed(),
                 requestStop: () => { agentState.requestStop(); },
                 markClosed: () => {
                     executionOwner.setBusy(false, "league_hold");
@@ -1030,8 +1070,12 @@ export async function startAgentLoop(config, options) {
         // A task handed off in an earlier wake no longer blocks new foreground work.
         foregroundTasks?.beginWake();
         executionOwner.setBusy(false, "wake_reset");
-        agentState.gated = false;
         agentState.stopRequested = false;
+        // The hold check above already continued. Reaching here means the entry
+        // may open. A held entry returns through Idle, which is the only way out.
+        if (agentState.lifecycle !== "Idle" || agentState.entryHeld)
+            publishLifecycle(agentState, "Idle");
+        agentState.gated = false;
         agentState.activeTuiRequestId = undefined;
         agentState.hasRepliedInCycle = false;
         agentState.notifiedUserThisWake = false;
@@ -1207,6 +1251,14 @@ export async function startAgentLoop(config, options) {
         if (!workerMode && shouldEnforceServiceGate(heartbeat.lastServiceStatus)) {
             await runServiceGate(config, channelManager, heartbeat, messageQueue);
         }
+        // The five states admit a wake only from Idle, and a closed entry that
+        // still lacks an engine receipt is not Idle enough. Sleep again instead of
+        // taking the slot. Claude never confirms the barrier, so this is what
+        // keeps a closed service gate or fund-league hold from starting work.
+        if (!canAdmitForegroundWork(agentState)) {
+            logger.system(`Foreground wake refused: ${agentState.lifecycle}${agentState.entryHeld ? " (entry held)" : ""}`);
+            continue;
+        }
         // The slot is taken only after the gate. A closed entry therefore does not
         // overlap a foreground run, which would be Running → Gated.
         executionOwner.setBusy(true, "wake", lifecycleRunId);
@@ -1218,19 +1270,12 @@ export async function startAgentLoop(config, options) {
         const hasMessages = !messageQueue.isEmpty();
         const trigger = hasMessages ? "message" : "heartbeat";
         beginLifecycleRun(lifecycleRunId);
-        const observeShadow = (phase, recovering = false) => {
+        const observeShadow = (phase) => {
             traceShadowLifecycle({
                 runId: lifecycleRunId,
                 phase,
-                state: deriveShadowLifecycleState({
-                    gated: agentState.gated,
-                    stopRequested: agentState.stopRequested,
-                    busy: agentState.busy,
-                    recovering,
-                    // Pi confirms this with `agent_settled`. An abort is not a receipt,
-                    // so an engine that cannot prove it stopped stays unconfirmed.
-                    barrierConfirmed: session.executionBarrierConfirmed(),
-                }),
+                state: agentState.lifecycle ?? "Idle",
+                entryHeld: agentState.entryHeld,
                 legacy: {
                     busy: agentState.busy,
                     gated: agentState.gated,
@@ -1245,9 +1290,11 @@ export async function startAgentLoop(config, options) {
             // A worker thread is the same loop: its busy flag lives on the
             // supervisor, and it is cleared only after this cleanup.
             endForegroundWake({
-                // A failed compaction is still this same foreground run. Phase 3 is
-                // what moves that path into Recovering before the wake ends.
-                from: "Running",
+                state: agentState,
+                // A failed compaction is still this same foreground run. Recovering
+                // publishes itself before the wake ends, and Stopping is legal from
+                // either Running or Recovering.
+                from: agentState.lifecycle === "Recovering" ? "Recovering" : "Running",
                 onPhase: (phase) => {
                     if (phase === "Stopping")
                         observeShadow("stopping");
@@ -1382,7 +1429,8 @@ export async function startAgentLoop(config, options) {
                     // long). Rotate with our bounded summarizer before the turn starts
                     // so this wake runs on a session that fits. The summary and the
                     // continuation hint are seeded inline; no extra wake is queued.
-                    observeShadow("compaction_failed", true);
+                    publishLifecycle(agentState, "Recovering");
+                    observeShadow("compaction_failed");
                     traceLifecycle({
                         runId: lifecycleRunId,
                         stage: "compaction",
@@ -1486,7 +1534,7 @@ export async function startAgentLoop(config, options) {
             outcome: "started",
         });
         let releaseConversationTurn;
-        agentState.currentDispatchId = createHash("sha256").update(JSON.stringify(messages.map((message) => message.id))).digest("hex");
+        agentState.currentDispatchId = wakeDispatchId(messages.map((message) => message.id), lifecycleRunId);
         try {
             if (!workerExecution) {
                 releaseConversationTurn = await (options?.acquireConversationTurn?.(options.signal)
@@ -1521,6 +1569,10 @@ export async function startAgentLoop(config, options) {
             // Foreman: the background-task updates this turn handled, read before
             // their claims are released (mid-turn interrupts included).
             const handledForemanEvents = failoverRestartPending ? [] : foremanEventsOf(messageQueue.currentCycleClaims());
+            // Every Task the host accepted this wake (one response can delegate
+            // several, or a batch): the status card waits for all of them.
+            const handedOffIds = [...(foregroundTasks?.handedOffTaskIds() ?? [])];
+            const waitsForBackground = result.finished === true && result.terminalState === "completed" && handedOffIds.length > 0;
             // A completed foreground wake acknowledges its claims. Accepted background
             // work already belongs to the canonical Task ledger.
             if (!failoverRestartPending)
@@ -1536,11 +1588,31 @@ export async function startAgentLoop(config, options) {
                     void getForemanClient()?.request({ type: "turn_ended", events: handledForemanEvents });
                 }
             }
-            if (workerMode) {
-                workerMode.relay.finishActivityRun(result.terminalState);
+            if (waitsForBackground) {
+                for (const taskId of handedOffIds) {
+                    if (workerMode)
+                        workerMode.relay.markActivityWaitingForBackground(taskId);
+                    else
+                        mainActivityController?.markWaitingForBackground(taskId);
+                }
+                // A quick Task can end before this wake does; its notice came earlier.
+                for (const taskId of handedOffIds) {
+                    const settled = settledTaskState(executionContext.threadId, taskId);
+                    if (settled)
+                        finishBackgroundCard(taskId, settled);
+                }
             }
-            else {
-                mainActivityController?.finishRun(result.terminalState);
+            for (const event of handledForemanEvents) {
+                if (event.kind !== "result")
+                    continue;
+                const state = event.status === "succeeded" ? "completed" : "failed";
+                finishBackgroundCard(event.taskId, state);
+            }
+            if (!waitsForBackground) {
+                if (workerMode)
+                    workerMode.relay.finishActivityRun(result.terminalState);
+                else
+                    mainActivityController?.finishRun(result.terminalState);
             }
             tuiTerminalOutcome = resolveTuiTerminalOutcome(result.terminalState);
         }