@ouro.bot/cli 0.1.0-alpha.60 → 0.1.0-alpha.600

package/dist/senses/inner-dialog.js

@@ -41,6 +41,9 @@ exports.readTaskFile = readTaskFile;
 exports.buildTaskTriggeredMessage = buildTaskTriggeredMessage;
 exports.deriveResumeCheckpoint = deriveResumeCheckpoint;
 exports.innerDialogSessionPath = innerDialogSessionPath;
+exports.enrichDelegatedFromWithBridge = enrichDelegatedFromWithBridge;
+exports.routeDelegatedCompletion = routeDelegatedCompletion;
+exports.buildParseErrorNudge = buildParseErrorNudge;
 exports.runInnerDialogTurn = runInnerDialogTurn;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -49,8 +52,13 @@ const core_1 = require("../heart/core");
 const identity_1 = require("../heart/identity");
 const context_1 = require("../mind/context");
 const prompt_1 = require("../mind/prompt");
+const mcp_manager_1 = require("../repertoire/mcp-manager");
+const tools_1 = require("../repertoire/tools");
 const bundle_manifest_1 = require("../mind/bundle-manifest");
 const pending_1 = require("../mind/pending");
+const obligations_1 = require("../arc/obligations");
+const attention_queue_1 = require("./attention-queue");
+const packets_1 = require("../arc/packets");
 const channel_1 = require("../mind/friends/channel");
 const trust_gate_1 = require("./trust-gate");
 const tokens_1 = require("../mind/friends/tokens");
@@ -60,6 +68,15 @@ const runtime_1 = require("../nerves/runtime");
 const manager_1 = require("../heart/bridges/manager");
 const session_activity_1 = require("../heart/session-activity");
 const bluebubbles_1 = require("./bluebubbles");
+const habit_turn_message_1 = require("./habit-turn-message");
+const await_turn_message_1 = require("./await-turn-message");
+const await_parser_1 = require("../heart/awaiting/await-parser");
+const await_runtime_state_1 = require("../heart/awaiting/await-runtime-state");
+const journal_index_1 = require("../mind/journal-index");
+const habit_parser_1 = require("../heart/habits/habit-parser");
+const habit_runtime_state_1 = require("../heart/habits/habit-runtime-state");
+const cadence_1 = require("../heart/daemon/cadence");
+const daemon_health_1 = require("../heart/daemon/daemon-health");
 const DEFAULT_INNER_DIALOG_INSTINCTS = [
     {
         id: "heartbeat_checkin",
@@ -98,23 +115,31 @@ function buildNonCanonicalCleanupNudge(nonCanonicalPaths) {
     }
     return [
         "## canonical cleanup nudge",
-        "I found non-canonical files in my bundle. I should distill anything valuable into your memory system and remove these files.",
+        "I found non-canonical files in my bundle. I should distill anything valuable into my diary and remove these files.",
         ...listed,
     ].join("\n");
 }
+function displayCheckpoint(checkpoint) {
+    const trimmed = checkpoint?.trim();
+    if (!trimmed || trimmed === "no prior checkpoint recorded") {
+        return undefined;
+    }
+    return trimmed;
+}
 function buildInstinctUserMessage(instincts, _reason, state) {
     const active = instincts.find((instinct) => instinct.enabled !== false) ?? DEFAULT_INNER_DIALOG_INSTINCTS[0];
-    const checkpoint = state.checkpoint?.trim();
+    const checkpoint = displayCheckpoint(state.checkpoint);
     const lines = [active.prompt];
     if (checkpoint) {
-        lines.push(`\nlast i remember: ${checkpoint}`);
+        lines.push(`\nlast checkpoint: ${checkpoint}`);
     }
     return lines.join("\n");
 }
 function readTaskFile(agentRoot, taskId) {
-    // Task files live in collection subdirectories (one-shots, ongoing, habits).
+    // Task files live in collection subdirectories (one-shots, ongoing).
     // Try each collection, then fall back to root tasks/ for legacy layout.
-    const collections = ["one-shots", "ongoing", "habits", ""];
+    // Habits are no longer in tasks/ — they live at bundle root habits/.
+    const collections = ["one-shots", "ongoing", ""];
     for (const collection of collections) {
         try {
             return fs.readFileSync(path.join(agentRoot, "tasks", collection, `${taskId}.md`), "utf8").trim();
@@ -133,8 +158,9 @@ function buildTaskTriggeredMessage(taskId, taskContent, checkpoint) {
     else {
         lines.push("", `## task: ${taskId}`, "(task file not found)");
     }
-    if (checkpoint) {
-        lines.push("", `last i remember: ${checkpoint}`);
+    const renderedCheckpoint = displayCheckpoint(checkpoint);
+    if (renderedCheckpoint) {
+        lines.push("", `last checkpoint: ${renderedCheckpoint}`);
     }
     return lines.join("\n");
 }
@@ -164,19 +190,17 @@ function deriveResumeCheckpoint(messages) {
     const assistantText = contentToText(lastAssistant.content);
     if (!assistantText)
         return "no prior checkpoint recorded";
-    const explicitCheckpoint = assistantText
+    const cleanedLines = assistantText
         .split("\n")
-        .map((line) => line.trim())
+        .map((line) => line.replace(/<\/?think>/gi, "").trim())
+        .filter((line) => line.length > 0);
+    const explicitCheckpoint = cleanedLines
         .find((line) => /^checkpoint\s*:/i.test(line));
     if (explicitCheckpoint) {
         const parsed = explicitCheckpoint.replace(/^checkpoint\s*:\s*/i, "").trim();
         return parsed || "no prior checkpoint recorded";
     }
-    const firstLine = assistantText
-        .split("\n")
-        .map((line) => line.trim())
-        .find((line) => line.length > 0);
-    /* v8 ignore next -- unreachable: contentToText().trim() guarantees a non-empty line @preserve */
+    const firstLine = cleanedLines[0];
     if (!firstLine)
         return "no prior checkpoint recorded";
     if (firstLine.length <= 220)
@@ -247,6 +271,7 @@ function writeInnerDialogRuntimeState(sessionFilePath, state) {
         });
     }
 }
+/* v8 ignore start -- routing helpers: called from routing functions which are integration paths @preserve */
 function writePendingEnvelope(pendingDir, message) {
     fs.mkdirSync(pendingDir, { recursive: true });
     const fileName = `${message.timestamp}-${Math.random().toString(36).slice(2, 10)}.json`;
@@ -258,6 +283,8 @@ function sessionMatchesActivity(activity, session) {
         && activity.channel === session.channel
         && activity.key === session.key;
 }
+/* v8 ignore stop */
+/* v8 ignore start -- routing: delivery now inline via surface tool; routing functions preserved for reuse @preserve */
 function resolveBridgePreferredSession(delegatedFrom, sessionActivity) {
     if (!delegatedFrom.bridgeId)
         return null;
@@ -277,15 +304,82 @@ async function tryDeliverDelegatedCompletion(target, outboundEnvelope) {
         friendId: target.friendId,
         sessionKey: target.key,
         text: outboundEnvelope.content,
+        intent: "explicit_cross_chat",
     });
     return result.delivered;
 }
+function enrichDelegatedFromWithBridge(delegatedFrom) {
+    if (delegatedFrom.bridgeId) {
+        return delegatedFrom;
+    }
+    const bridgeManager = (0, manager_1.createBridgeManager)();
+    const originBridges = bridgeManager.findBridgesForSession({
+        friendId: delegatedFrom.friendId,
+        channel: delegatedFrom.channel,
+        key: delegatedFrom.key,
+    });
+    const activeBridge = originBridges.find((b) => b.lifecycle === "active");
+    if (activeBridge) {
+        return { ...delegatedFrom, bridgeId: activeBridge.id };
+    }
+    return delegatedFrom;
+}
+function advanceObligationQuietly(agentName, obligationId, update) {
+    if (!obligationId)
+        return;
+    try {
+        (0, obligations_1.advanceReturnObligation)(agentName, obligationId, update);
+        /* v8 ignore start -- best-effort: obligation fs errors must never block return routing @preserve */
+    }
+    catch {
+        // swallowed
+    }
+    /* v8 ignore stop */
+}
 async function routeDelegatedCompletion(agentRoot, agentName, completion, drainedPending, timestamp) {
     const delegated = (drainedPending ?? []).find((message) => message.delegatedFrom);
     if (!delegated?.delegatedFrom || !completion?.answer?.trim()) {
         return;
     }
-    const delegatedFrom = delegated.delegatedFrom;
+    const delegatedFrom = enrichDelegatedFromWithBridge(delegated.delegatedFrom);
+    const obligationId = delegated.obligationId;
+    // Advance any inner return obligations from queued -> running (they were drained this turn).
+    // drainedPending is guaranteed non-null here (we found delegated above).
+    for (const msg of drainedPending) {
+        if (msg.obligationId) {
+            advanceObligationQuietly(agentName, msg.obligationId, {
+                status: "running",
+                startedAt: timestamp,
+            });
+        }
+    }
+    if (delegated.obligationStatus === "pending") {
+        // Fulfill the persistent obligation in the store
+        try {
+            const pending = (0, obligations_1.findPendingObligationForOrigin)(agentRoot, {
+                friendId: delegatedFrom.friendId,
+                channel: delegatedFrom.channel,
+                key: delegatedFrom.key,
+            });
+            /* v8 ignore next 2 -- obligation fulfillment tested via obligations.test.ts; integration requires real disk state @preserve */
+            if (pending) {
+                (0, obligations_1.fulfillObligation)(agentRoot, pending.id);
+            }
+        }
+        catch {
+            /* v8 ignore next -- defensive: obligation store read failure should not break delivery @preserve */
+        }
+        (0, runtime_1.emitNervesEvent)({
+            event: "senses.obligation_fulfilled",
+            component: "senses",
+            message: "obligation fulfilled via delegated completion",
+            meta: {
+                friendId: delegatedFrom.friendId,
+                channel: delegatedFrom.channel,
+                key: delegatedFrom.key,
+            },
+        });
+    }
     const outboundEnvelope = {
         from: agentName,
         friendId: delegatedFrom.friendId,
@@ -294,36 +388,62 @@ async function routeDelegatedCompletion(agentRoot, agentName, completion, draine
         content: completion.answer.trim(),
         timestamp,
         delegatedFrom,
+        ...(obligationId ? { obligationId } : {}),
     };
     const sessionActivity = (0, session_activity_1.listSessionActivity)({
         sessionsDir: path.join(agentRoot, "state", "sessions"),
         friendsDir: path.join(agentRoot, "friends"),
         agentName,
     });
+    // Priority 1: Bridge-preferred session (if delegation was within a bridge).
     const bridgeTarget = resolveBridgePreferredSession(delegatedFrom, sessionActivity);
     if (bridgeTarget) {
         if (await tryDeliverDelegatedCompletion(bridgeTarget, outboundEnvelope)) {
+            advanceObligationQuietly(agentName, obligationId, { status: "returned", returnedAt: timestamp, returnTarget: "bridge-session" });
             return;
         }
         writePendingEnvelope((0, pending_1.getPendingDir)(agentName, bridgeTarget.friendId, bridgeTarget.channel, bridgeTarget.key), outboundEnvelope);
+        advanceObligationQuietly(agentName, obligationId, { status: "returned", returnedAt: timestamp, returnTarget: "bridge-session" });
+        return;
+    }
+    // Priority 1.5: Direct return to originating session (ponder without bridge).
+    // When delegatedFrom has specific channel+key, route directly there instead of searching for freshest.
+    if (delegatedFrom.channel && delegatedFrom.key && delegatedFrom.channel !== "inner") {
+        const directTarget = sessionActivity.find((a) => a.friendId === delegatedFrom.friendId && a.channel === delegatedFrom.channel && a.key === delegatedFrom.key);
+        if (directTarget) {
+            if (await tryDeliverDelegatedCompletion(directTarget, outboundEnvelope)) {
+                advanceObligationQuietly(agentName, obligationId, { status: "returned", returnedAt: timestamp, returnTarget: "direct-originator" });
+                return;
+            }
+        }
+        // Even if session isn't in activity list (might have ended), queue to its pending dir
+        writePendingEnvelope((0, pending_1.getPendingDir)(agentName, delegatedFrom.friendId, delegatedFrom.channel, delegatedFrom.key), outboundEnvelope);
+        advanceObligationQuietly(agentName, obligationId, { status: "returned", returnedAt: timestamp, returnTarget: "direct-originator" });
         return;
     }
-    const freshest = (0, session_activity_1.findFreshestFriendSession)({
+    // Priority 2: Freshest active friend session.
+    // For BB, prefer DM sessions (;-;) over group chats (;+;) — proactive outreach should never land in groups.
+    const allFriendSessions = (0, session_activity_1.listSessionActivity)({
         sessionsDir: path.join(agentRoot, "state", "sessions"),
         friendsDir: path.join(agentRoot, "friends"),
         agentName,
-        friendId: delegatedFrom.friendId,
-        activeOnly: true,
-    });
-    if (freshest && freshest.channel !== "inner") {
+    }).filter((s) => s.friendId === delegatedFrom.friendId && s.channel !== "inner");
+    const bbDm = allFriendSessions.find((s) => s.channel === "bluebubbles" && s.key.includes(";-;"));
+    const freshest = bbDm ?? allFriendSessions.find((s) => s.channel !== "bluebubbles" || s.key.includes(";-;")) ?? allFriendSessions[0];
+    if (freshest) {
         if (await tryDeliverDelegatedCompletion(freshest, outboundEnvelope)) {
+            advanceObligationQuietly(agentName, obligationId, { status: "returned", returnedAt: timestamp, returnTarget: "freshest-session" });
             return;
         }
         writePendingEnvelope((0, pending_1.getPendingDir)(agentName, freshest.friendId, freshest.channel, freshest.key), outboundEnvelope);
+        advanceObligationQuietly(agentName, obligationId, { status: "returned", returnedAt: timestamp, returnTarget: "freshest-session" });
         return;
     }
+    // Priority 3: Deferred return queue.
     writePendingEnvelope((0, pending_1.getDeferredReturnDir)(agentName, delegatedFrom.friendId), outboundEnvelope);
+    advanceObligationQuietly(agentName, obligationId, { status: "deferred", returnedAt: timestamp, returnTarget: "deferred" });
 }
+/* v8 ignore stop */
 // Self-referencing friend record for inner dialog (agent talking to itself).
 // No real friend to resolve -- this satisfies the pipeline's friend resolver contract.
 function createSelfFriend(agentName) {
@@ -350,12 +470,59 @@ function createNoOpFriendStore() {
         findByExternalId: async () => null,
     };
 }
+function buildParseErrorNudge(parseErrors) {
+    if (parseErrors.length === 0)
+        return "";
+    const lines = parseErrors.map((e) => `I noticed my habit file \`${e.file}\` has invalid frontmatter — I should fix it. (${e.error})`);
+    return lines.join("\n");
+}
+function buildAlsoDueLine(agentRoot, currentHabitName, now) {
+    const habitsDir = path.join(agentRoot, "habits");
+    let files;
+    try {
+        files = fs.readdirSync(habitsDir);
+    }
+    catch {
+        return "";
+    }
+    const nowMs = now().getTime();
+    const alsoDue = [];
+    for (const file of files) {
+        if (!file.endsWith(".md"))
+            continue;
+        const stem = file.replace(/\.md$/, "");
+        if (stem === currentHabitName)
+            continue;
+        try {
+            const content = fs.readFileSync(path.join(habitsDir, file), "utf-8");
+            const habit = (0, habit_runtime_state_1.applyHabitRuntimeState)(agentRoot, (0, habit_parser_1.parseHabitFile)(content, path.join(habitsDir, file)));
+            if (habit.status !== "active" || !habit.cadence)
+                continue;
+            const cadenceMs = (0, cadence_1.parseCadenceToMs)(habit.cadence);
+            if (cadenceMs === null)
+                continue;
+            if (habit.lastRun === null) {
+                alsoDue.push(stem);
+                continue;
+            }
+            const lastRunMs = new Date(habit.lastRun).getTime();
+            if (nowMs - lastRunMs >= cadenceMs) {
+                alsoDue.push(stem);
+            }
+        }
+        catch {
+            // skip unreadable habits
+        }
+    }
+    if (alsoDue.length === 0)
+        return "";
+    return `also due: ${alsoDue.join(", ")}`;
+}
 async function runInnerDialogTurn(options) {
     const now = options?.now ?? (() => new Date());
-    const reason = options?.reason ?? "heartbeat";
+    const reason = options?.reason ?? "instinct";
     const sessionFilePath = innerDialogSessionPath();
     const agentName = (0, identity_1.getAgentName)();
-    const agentRoot = (0, identity_1.getAgentRoot)();
     writeInnerDialogRuntimeState(sessionFilePath, {
         status: "running",
         reason,
@@ -372,6 +539,8 @@ async function runInnerDialogTurn(options) {
         };
         // ── Adapter concern: build user message ──────────────────────────
         let userContent;
+        let habitTools;
+        let habitParsedSuccessfully = false;
         if (existingMessages.length === 0) {
             // Fresh session: bootstrap message with non-canonical cleanup nudge
             const aspirations = readAspirations((0, identity_1.getAgentRoot)());
@@ -391,6 +560,113 @@ async function runInnerDialogTurn(options) {
                 const taskContent = readTaskFile((0, identity_1.getAgentRoot)(), options.taskId);
                 userContent = buildTaskTriggeredMessage(options.taskId, taskContent, state.checkpoint);
             }
+            else if (reason === "habit" && options?.habitName) {
+                const agentRoot = (0, identity_1.getAgentRoot)();
+                const habitName = options.habitName;
+                const habitFilePath = path.join(agentRoot, "habits", `${habitName}.md`);
+                // Read and parse the habit file
+                let habitBody;
+                let habitTitle = habitName;
+                let habitLastRun = null;
+                try {
+                    const habitContent = fs.readFileSync(habitFilePath, "utf-8");
+                    const parsed = (0, habit_runtime_state_1.applyHabitRuntimeState)(agentRoot, (0, habit_parser_1.parseHabitFile)(habitContent, habitFilePath));
+                    habitBody = parsed.body || undefined;
+                    habitTitle = parsed.title || habitName;
+                    habitLastRun = parsed.lastRun;
+                    habitTools = parsed.tools;
+                }
+                catch {
+                    // Habit file missing or unreadable
+                }
+                // If the habit file couldn't be read at all (no body, no title parsed), error message
+                if (habitBody === undefined && habitTitle === habitName) {
+                    userContent = `habit "${habitName}" could not be read (file not found or unreadable). check habits/${habitName}.md exists.`;
+                }
+                else {
+                    habitParsedSuccessfully = true;
+                    // Unified path: gather context for ALL habits (heartbeat included)
+                    const obligations = (0, obligations_1.listActiveReturnObligations)(agentName);
+                    const nowMs = now().getTime();
+                    const staleObligations = obligations.map((o) => ({
+                        friendName: o.origin.friendId,
+                        content: o.delegatedContent,
+                        stalenessMs: nowMs - o.createdAt,
+                    }));
+                    const alsoDue = buildAlsoDueLine(agentRoot, habitName, now);
+                    // Degraded state (best-effort: never crash)
+                    let degradedComponents = [];
+                    try {
+                        const health = (0, daemon_health_1.readHealth)((0, daemon_health_1.getDefaultHealthPath)());
+                        if (health && health.degraded.length > 0) {
+                            degradedComponents = health.degraded.map((d) => ({ component: d.component, reason: d.reason }));
+                        }
+                    }
+                    catch {
+                        // Best-effort: missing file or parse error -> empty array, no crash
+                    }
+                    userContent = (0, habit_turn_message_1.buildHabitTurnMessage)({
+                        habitName,
+                        habitTitle,
+                        habitBody,
+                        lastRun: habitLastRun,
+                        checkpoint: displayCheckpoint(state.checkpoint),
+                        alsoDue: alsoDue || undefined,
+                        staleObligations,
+                        parseErrors: options?.parseErrors ?? [],
+                        degradedComponents,
+                        now,
+                    });
+                    // Piggyback journal embedding indexing (best-effort, fire-and-forget)
+                    const journalDir = path.join(agentRoot, "journal");
+                    /* v8 ignore start -- journal indexing piggyback: embedding provider may not be available; tested via journal-index unit tests @preserve */
+                    void (0, journal_index_1.indexJournalFiles)(journalDir, path.join(journalDir, ".index.json"), {
+                        embed: async () => [],
+                    }).catch(() => {
+                        // swallowed: indexing failure must never block habit turn
+                    });
+                    /* v8 ignore stop */
+                }
+            }
+            else if (reason === "await" && options?.awaitName) {
+                const agentRoot = (0, identity_1.getAgentRoot)();
+                const awaitName = options.awaitName;
+                const awaitFilePath = path.join(agentRoot, "awaiting", `${awaitName}.md`);
+                let awaitBody;
+                let condition = null;
+                let lastCheckedAt = null;
+                let lastObservation = null;
+                let checkedCount = 0;
+                let awaitFound = false;
+                try {
+                    const awaitContent = fs.readFileSync(awaitFilePath, "utf-8");
+                    const parsed = (0, await_runtime_state_1.applyAwaitRuntimeState)(agentRoot, (0, await_parser_1.parseAwaitFile)(awaitContent, awaitFilePath));
+                    awaitFound = true;
+                    awaitBody = parsed.body || undefined;
+                    condition = parsed.condition;
+                    lastCheckedAt = parsed.last_checked ?? null;
+                    lastObservation = parsed.last_observation ?? null;
+                    checkedCount = parsed.checked_count ?? 0;
+                }
+                catch {
+                    // file missing — fall through to error message
+                }
+                if (!awaitFound || !condition) {
+                    userContent = `await "${awaitName}" could not be read (file not found or no condition). check awaiting/${awaitName}.md.`;
+                }
+                else {
+                    userContent = (0, await_turn_message_1.buildAwaitTurnMessage)({
+                        awaitName,
+                        condition,
+                        body: awaitBody,
+                        lastCheckedAt,
+                        lastObservation,
+                        checkedCount,
+                        checkpoint: displayCheckpoint(state.checkpoint),
+                        now,
+                    });
+                }
+            }
             else {
                 userContent = buildInstinctUserMessage(instincts, reason, state);
             }
@@ -401,15 +677,43 @@ async function runInnerDialogTurn(options) {
         const pendingDir = (0, pending_1.getInnerDialogPendingDir)(agentName);
         const selfFriend = createSelfFriend(agentName);
         const selfContext = { friend: selfFriend, channel: innerCapabilities };
+        const mcpManager = await (0, mcp_manager_1.getSharedMcpManager)() ?? undefined;
+        // ── Habit tool enforcement ───────────────────────────────────────
+        let habitToolsResolved;
+        if (habitTools !== undefined) {
+            const fullTools = (0, tools_1.getToolsForChannel)(innerCapabilities);
+            habitToolsResolved = fullTools.filter((t) => habitTools.includes(t.function.name));
+            (0, runtime_1.emitNervesEvent)({
+                event: "habit.tools_restricted",
+                component: "senses",
+                message: "habit running with restricted tools",
+                meta: {
+                    habitName: options?.habitName,
+                    declared: habitTools,
+                    resolved: habitToolsResolved.map((t) => t.function.name),
+                },
+            });
+        }
+        else if (reason === "habit" && options?.habitName && habitParsedSuccessfully) {
+            (0, runtime_1.emitNervesEvent)({
+                event: "habit.tools_unrestricted",
+                component: "senses",
+                message: "habit running with full tool repertoire",
+                meta: { habitName: options.habitName },
+            });
+        }
         const sessionLoader = {
             loadOrCreate: async () => {
                 if (existingMessages.length > 0) {
-                    return { messages: existingMessages, sessionPath: sessionFilePath };
+                    return {
+                        messages: existingMessages,
+                        sessionPath: sessionFilePath,
+                    };
                 }
                 // Fresh session: build system prompt
                 const systemPrompt = await (0, prompt_1.buildSystem)("inner", { toolChoiceRequired: true });
                 return {
-                    messages: [{ role: "system", content: systemPrompt }],
+                    messages: [{ role: "system", content: (0, prompt_1.flattenSystemPrompt)(systemPrompt) }],
                     sessionPath: sessionFilePath,
                 };
             },
@@ -417,6 +721,8 @@ async function runInnerDialogTurn(options) {
         // ── Call shared pipeline ──────────────────────────────────────────
         const callbacks = createInnerDialogCallbacks();
         const traceId = (0, nerves_1.createTraceId)();
+        // Attention queue: built when pending messages are drained, shared with tool context
+        let attentionQueue = [];
         const result = await (0, pipeline_1.handleInboundTurn)({
             channel: "inner",
             sessionKey: "dialog",
@@ -431,16 +737,55 @@ async function runInnerDialogTurn(options) {
             enforceTrustGate: trust_gate_1.enforceTrustGate,
             drainPending: pending_1.drainPending,
             runAgent: core_1.runAgent,
-            postTurn: context_1.postTurn,
+            postTurn: (turnMessages, sessionPathArg, usage, hooks, state) => {
+                const prepared = (0, context_1.postTurnTrim)(turnMessages, usage, hooks);
+                (0, context_1.deferPostTurnPersist)(sessionPathArg, prepared, usage, state);
+            },
             accumulateFriendTokens: tokens_1.accumulateFriendTokens,
             signal: options?.signal,
+            /* v8 ignore start -- attention queue: callback invoked by pipeline during pending drain; tested via attention-queue unit tests @preserve */
+            onPendingDrained: (drained) => {
+                const outstandingObligations = (0, obligations_1.listActiveReturnObligations)(agentName);
+                attentionQueue = (0, attention_queue_1.buildAttentionQueue)({
+                    drainedPending: drained,
+                    outstandingObligations,
+                    friendNameResolver: (friendId) => {
+                        try {
+                            const raw = fs.readFileSync(path.join((0, identity_1.getAgentRoot)(agentName), "friends", friendId + ".json"), "utf-8");
+                            const parsed = JSON.parse(raw);
+                            return typeof parsed.name === "string" ? parsed.name : null;
+                        }
+                        catch {
+                            return null;
+                        }
+                    },
+                    packetResolver: (packetId) => {
+                        try {
+                            return (0, packets_1.readPonderPacket)((0, identity_1.getAgentRoot)(agentName), packetId);
+                        }
+                        catch {
+                            return null;
+                        }
+                    },
+                });
+                const summary = (0, attention_queue_1.buildAttentionQueueSummary)(attentionQueue);
+                return summary ? [summary] : [];
+            },
+            /* v8 ignore stop */
             runAgentOptions: {
                 traceId,
                 toolChoiceRequired: true,
-                skipConfirmation: true,
+                mcpManager,
+                ...(habitToolsResolved !== undefined && { tools: habitToolsResolved }),
+                toolContext: {
+                    signin: async () => undefined,
+                    delegatedOrigins: attentionQueue,
+                },
             },
         });
-        await routeDelegatedCompletion(agentRoot, agentName, result.completion, result.drainedPending, now().getTime());
+        // Post-turn routeDelegatedCompletion removed: delivery is now inline via surface tool.
+        // settle in inner dialog produces no CompletionMetadata, so routeDelegatedCompletion
+        // would be a no-op. The routing infrastructure is reused by the surface handler.
         const resultMessages = result.messages ?? [];
         const assistantPreview = extractAssistantPreview(resultMessages);
         const toolCalls = extractToolCallNames(resultMessages);

package/dist/senses/mail-entry.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const agentArgIndex = process.argv.indexOf("--agent");
+const agentName = agentArgIndex >= 0 ? process.argv[agentArgIndex + 1] : undefined;
+if (!agentName) {
+    // eslint-disable-next-line no-console -- pre-boot guard: --agent check before imports
+    console.error("Missing required --agent <name> argument.\nUsage: node dist/senses/mail-entry.js --agent ouroboros");
+    process.exit(1);
+}
+const runtime_logging_1 = require("../heart/daemon/runtime-logging");
+const runtime_1 = require("../nerves/runtime");
+(0, runtime_logging_1.configureDaemonRuntimeLogger)("mail");
+(0, runtime_1.emitNervesEvent)({
+    component: "senses",
+    event: "senses.entry_boot",
+    message: "booting Mail entrypoint",
+    meta: { entry: "mail", agentName },
+});
+Promise.resolve().then(() => __importStar(require("./mail"))).then(async ({ startMailSenseApp }) => {
+    await startMailSenseApp({ agentName });
+})
+    .catch((error) => {
+    (0, runtime_1.emitNervesEvent)({
+        level: "error",
+        component: "senses",
+        event: "senses.entry_error",
+        message: "Mail entrypoint failed",
+        meta: { entry: "mail", agentName, error: error instanceof Error ? error.message : String(error) },
+    });
+    // eslint-disable-next-line no-console -- fatal startup guard for sense process
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});