@ouro.bot/cli 0.1.0-alpha.202 → 0.1.0-alpha.204

package/changelog.json

@@ -1,6 +1,18 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.204",
+      "changes": [
+        "refactor: introduce TurnContext snapshot — centralize state assembly from pipeline.ts into buildTurnContext(), thread pre-read state through prompt assembly to eliminate ad-hoc filesystem reads"
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.203",
+      "changes": [
+        "refactor: unify obligation systems — mind/obligations.ts merged into heart/obligations.ts with prefixed ReturnObligation API"
+      ]
+    },
     {
       "version": "0.1.0-alpha.202",
       "changes": [

package/dist/heart/daemon/daemon-cli.js

@@ -3116,9 +3116,9 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
     if (command.kind === "attention.list" || command.kind === "attention.show" || command.kind === "attention.history") {
         try {
             const agentName = command.agent ?? (0, identity_1.getAgentName)();
-            const { listActiveObligations, readObligation } = await Promise.resolve().then(() => __importStar(require("../../mind/obligations")));
+            const { listActiveReturnObligations, readReturnObligation } = await Promise.resolve().then(() => __importStar(require("../obligations")));
             if (command.kind === "attention.list") {
-                const obligations = listActiveObligations(agentName);
+                const obligations = listActiveReturnObligations(agentName);
                 if (obligations.length === 0) {
                     const message = "nothing held — attention queue is empty";
                     deps.writeStdout(message);
@@ -3130,7 +3130,7 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
                 return message;
             }
             if (command.kind === "attention.show") {
-                const obligation = readObligation(agentName, command.id);
+                const obligation = readReturnObligation(agentName, command.id);
                 if (!obligation) {
                     const message = `no obligation found with id ${command.id}`;
                     deps.writeStdout(message);
@@ -3141,8 +3141,8 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
                 return message;
             }
             // attention.history: show returned obligations
-            const { getObligationsDir } = await Promise.resolve().then(() => __importStar(require("../../mind/obligations")));
-            const obligationsDir = getObligationsDir(agentName);
+            const { getReturnObligationsDir } = await Promise.resolve().then(() => __importStar(require("../obligations")));
+            const obligationsDir = getReturnObligationsDir(agentName);
             let entries = [];
             try {
                 entries = fs.readdirSync(obligationsDir);
@@ -3189,7 +3189,7 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
             const { sessionPath: getSessionPath } = await Promise.resolve().then(() => __importStar(require("../config")));
             const { parseCadenceToMs: parseCadenceMs, DEFAULT_CADENCE_MS } = await Promise.resolve().then(() => __importStar(require("./cadence")));
             const { parseFrontmatter } = await Promise.resolve().then(() => __importStar(require("../../repertoire/tasks/parser")));
-            const { listActiveObligations } = await Promise.resolve().then(() => __importStar(require("../../mind/obligations")));
+            const { listActiveReturnObligations } = await Promise.resolve().then(() => __importStar(require("../obligations")));
             // Read runtime state
             const innerSessionPath = getSessionPath("inner-dialog", "inner", "session");
             const runtimeJsonPath = path.join(path.dirname(innerSessionPath), "runtime.json");
@@ -3242,7 +3242,7 @@ async function runOuroCli(args, deps = createDefaultOuroCliDeps()) {
             }
             catch { /* no habits — heartbeat unknown */ }
             // Attention count
-            const activeObligations = listActiveObligations(agentName);
+            const activeObligations = listActiveReturnObligations(agentName);
             const message = buildInnerStatusOutput({
                 agentName,
                 runtimeState,

package/dist/heart/daemon/daemon.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OuroDaemon = void 0;
 exports.killOrphanProcesses = killOrphanProcesses;
 exports.writePidfile = writePidfile;
+exports.handleAgentSenseTurn = handleAgentSenseTurn;
 const fs = __importStar(require("fs"));
 const net = __importStar(require("net"));
 const os = __importStar(require("os"));
@@ -177,6 +178,33 @@ function parseIncomingCommand(raw) {
     }
     return parsed;
 }
+/**
+ * Handle agent.senseTurn command: runs a full agent turn via the daemon process.
+ * Dynamic import lazy-loads shared-turn. Hot-reload works because ouro dev
+ * restarts the daemon process (fresh module cache).
+ */
+async function handleAgentSenseTurn(command) {
+    try {
+        const { runSenseTurn } = await Promise.resolve().then(() => __importStar(require("../../senses/shared-turn")));
+        const result = await runSenseTurn({
+            agentName: command.agent,
+            channel: command.channel,
+            sessionKey: command.sessionKey,
+            friendId: command.friendId,
+            userMessage: command.message,
+        });
+        return {
+            ok: true,
+            message: result.response,
+            data: { ponderDeferred: result.ponderDeferred },
+        };
+    }
+    catch (error) {
+        /* v8 ignore next -- branch: String(error) fallback only for non-Error throws @preserve */
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: `sense turn failed: ${errorMessage}` };
+    }
+}
 class OuroDaemon {
     socketPath;
     processManager;
@@ -683,6 +711,9 @@ class OuroDaemon {
                 return (0, agent_service_1.handleAgentReportBlocker)(command);
             case "agent.reportComplete":
                 return (0, agent_service_1.handleAgentReportComplete)(command);
+            case "agent.senseTurn":
+                return handleAgentSenseTurn(command);
+            /* v8 ignore stop */
             case "cron.list": {
                 const jobs = this.scheduler.listJobs();
                 const summary = jobs.length === 0

package/dist/heart/daemon/mcp-server.js

@@ -38,7 +38,6 @@ exports.getToolSchemas = getToolSchemas;
 const socket_client_1 = require("./socket-client");
 const agentService = __importStar(require("./agent-service"));
 const runtime_1 = require("../../nerves/runtime");
-const shared_turn_1 = require("../../senses/shared-turn");
 const session_id_resolver_1 = require("./session-id-resolver");
 const pending_1 = require("../../mind/pending");
 /**
@@ -249,19 +248,22 @@ function createMcpServer(options) {
             const message = toolArgs.message ?? "";
             /* v8 ignore stop */
             try {
-                const result = await (0, shared_turn_1.runSenseTurn)({
-                    agentName: agent,
+                const response = await (0, socket_client_1.sendDaemonCommand)(socketPath, {
+                    kind: "agent.senseTurn",
+                    agent,
+                    friendId,
                     channel: "mcp",
                     sessionKey: sessionId,
-                    friendId,
-                    userMessage: message,
+                    message,
                 });
+                /* v8 ignore next -- branch: ?? fallback for empty daemon response @preserve */
+                const text = response.message ?? "(empty response)";
                 writeResponse({
                     jsonrpc: "2.0",
                     id: request.id,
                     result: {
-                        content: [{ type: "text", text: result.response }],
-                        isError: false,
+                        content: [{ type: "text", text }],
+                        isError: !response.ok,
                     },
                 });
             }
@@ -269,11 +271,17 @@ function createMcpServer(options) {
                 /* v8 ignore start — instanceof guard defensive; thrown errors are always Error */
                 const errorMessage = error instanceof Error ? error.message : String(error);
                 /* v8 ignore stop */
+                /* v8 ignore start -- daemon-down detection: only triggers with real socket I/O @preserve */
+                const isDaemonDown = errorMessage.includes("ECONNREFUSED") || errorMessage.includes("ENOENT");
+                const userMessage = isDaemonDown
+                    ? "The daemon is not running. Start it with `ouro up` (production) or `ouro dev` (development), then retry."
+                    : `Error: ${errorMessage}`;
+                /* v8 ignore stop */
                 writeResponse({
                     jsonrpc: "2.0",
                     id: request.id,
                     result: {
-                        content: [{ type: "text", text: `Error: ${errorMessage}` }],
+                        content: [{ type: "text", text: userMessage }],
                         isError: true,
                     },
                 });
@@ -306,7 +314,7 @@ function createMcpServer(options) {
             }
             return;
         }
-        // ── delegate: full conversation turn via runSenseTurn ──
+        // ── delegate: full conversation turn via daemon ──
         if (toolName === "delegate") {
             /* v8 ignore start — ?? fallback defensive; MCP clients always send task */
             const task = toolArgs.task ?? "";
@@ -314,19 +322,22 @@ function createMcpServer(options) {
             const context = toolArgs.context;
             const delegateMessage = context ? `[delegate] ${task}\n\ncontext: ${context}` : `[delegate] ${task}`;
             try {
-                const result = await (0, shared_turn_1.runSenseTurn)({
-                    agentName: agent,
+                const response = await (0, socket_client_1.sendDaemonCommand)(socketPath, {
+                    kind: "agent.senseTurn",
+                    agent,
+                    friendId,
                     channel: "mcp",
                     sessionKey: sessionId,
-                    friendId,
-                    userMessage: delegateMessage,
+                    message: delegateMessage,
                 });
+                /* v8 ignore next -- branch: ?? fallback for empty daemon response @preserve */
+                const text = response.message ?? "(empty response)";
                 writeResponse({
                     jsonrpc: "2.0",
                     id: request.id,
                     result: {
-                        content: [{ type: "text", text: result.response }],
-                        isError: false,
+                        content: [{ type: "text", text }],
+                        isError: !response.ok,
                     },
                 });
             }
@@ -334,11 +345,17 @@ function createMcpServer(options) {
                 /* v8 ignore start — instanceof guard defensive; thrown errors are always Error */
                 const errorMessage = error instanceof Error ? error.message : String(error);
                 /* v8 ignore stop */
+                /* v8 ignore start -- daemon-down detection: only triggers with real socket I/O @preserve */
+                const isDaemonDown = errorMessage.includes("ECONNREFUSED") || errorMessage.includes("ENOENT");
+                const userMessage = isDaemonDown
+                    ? "The daemon is not running. Start it with `ouro up` (production) or `ouro dev` (development), then retry."
+                    : `Error: ${errorMessage}`;
+                /* v8 ignore stop */
                 writeResponse({
                     jsonrpc: "2.0",
                     id: request.id,
                     result: {
-                        content: [{ type: "text", text: `Error: ${errorMessage}` }],
+                        content: [{ type: "text", text: userMessage }],
                         isError: true,
                     },
                 });

package/dist/heart/obligations.js

@@ -42,8 +42,15 @@ exports.advanceObligation = advanceObligation;
 exports.fulfillObligation = fulfillObligation;
 exports.findPendingObligationForOrigin = findPendingObligationForOrigin;
 exports.enrichObligation = enrichObligation;
+exports.generateObligationId = generateObligationId;
+exports.getReturnObligationsDir = getReturnObligationsDir;
+exports.createReturnObligation = createReturnObligation;
+exports.readReturnObligation = readReturnObligation;
+exports.advanceReturnObligation = advanceReturnObligation;
+exports.listActiveReturnObligations = listActiveReturnObligations;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const identity_1 = require("./identity");
 const runtime_1 = require("../nerves/runtime");
 const sync_1 = require("./sync");
 function obligationsDir(agentRoot) {
@@ -223,3 +230,92 @@ function enrichObligation(agentRoot, id, meaning) {
     });
     return obligation;
 }
+function generateObligationId(timestamp) {
+    return `${timestamp}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function getReturnObligationsDir(agentName) {
+    return path.join((0, identity_1.getAgentRoot)(agentName), "arc", "obligations", "inner");
+}
+function createReturnObligation(agentName, obligation) {
+    const dir = getReturnObligationsDir(agentName);
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, `${obligation.id}.json`);
+    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf8");
+    (0, sync_1.trackSyncWrite)(filePath);
+    (0, runtime_1.emitNervesEvent)({
+        event: "mind.obligation_created",
+        component: "mind",
+        message: "return obligation created",
+        meta: {
+            obligationId: obligation.id,
+            origin: `${obligation.origin.friendId}/${obligation.origin.channel}/${obligation.origin.key}`,
+            status: obligation.status,
+        },
+    });
+    return filePath;
+}
+function readReturnObligation(agentName, obligationId) {
+    const dir = getReturnObligationsDir(agentName);
+    try {
+        const raw = fs.readFileSync(path.join(dir, `${obligationId}.json`), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function advanceReturnObligation(agentName, obligationId, update) {
+    const existing = readReturnObligation(agentName, obligationId);
+    if (!existing)
+        return null;
+    const updated = {
+        ...existing,
+        status: update.status,
+        ...(update.startedAt !== undefined ? { startedAt: update.startedAt } : {}),
+        ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
+        ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
+    };
+    const dir = getReturnObligationsDir(agentName);
+    const advancedFilePath = path.join(dir, `${obligationId}.json`);
+    fs.writeFileSync(advancedFilePath, JSON.stringify(updated, null, 2), "utf8");
+    (0, sync_1.trackSyncWrite)(advancedFilePath);
+    (0, runtime_1.emitNervesEvent)({
+        event: "mind.obligation_advanced",
+        component: "mind",
+        message: `obligation advanced to ${update.status}`,
+        meta: {
+            obligationId,
+            status: update.status,
+            ...(update.returnTarget ? { returnTarget: update.returnTarget } : {}),
+        },
+    });
+    return updated;
+}
+function listActiveReturnObligations(agentName) {
+    const dir = getReturnObligationsDir(agentName);
+    if (!fs.existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const obligations = [];
+    for (const file of entries) {
+        if (!file.endsWith(".json"))
+            continue;
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
+            const parsed = JSON.parse(raw);
+            if (parsed.status === "queued" || parsed.status === "running") {
+                obligations.push(parsed);
+            }
+        }
+        catch {
+            // skip unparseable
+        }
+    }
+    return obligations.sort((a, b) => a.createdAt - b.createdAt);
+}

package/dist/heart/turn-context.js

@@ -0,0 +1,358 @@
+"use strict";
+/**
+ * TurnContext: a single pre-read snapshot of all state sources needed
+ * by the inbound-turn pipeline and prompt assembly.
+ *
+ * Before this module existed, pipeline.ts read ~10 state sources inline
+ * and prompt.ts did several ad-hoc filesystem reads. This centralizes
+ * all reads into one place so the rest of the turn is pure derivation.
+ */
+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 });
+exports.buildTurnContext = buildTurnContext;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+const manager_1 = require("./bridges/manager");
+const identity_1 = require("./identity");
+const tasks_1 = require("../repertoire/tasks");
+const coding_1 = require("../repertoire/coding");
+const session_activity_1 = require("./session-activity");
+const thoughts_1 = require("./daemon/thoughts");
+const pending_1 = require("../mind/pending");
+const obligations_1 = require("./obligations");
+const target_resolution_1 = require("./target-resolution");
+const episodes_1 = require("../mind/episodes");
+const cares_1 = require("./cares");
+const config_1 = require("./config");
+const daemon_health_1 = require("./daemon/daemon-health");
+const prompt_1 = require("../mind/prompt");
+// ── Helpers ─────────────────────────────────────────────────────────
+const DAEMON_SOCKET_PATH = "/tmp/ouroboros-daemon.sock";
+function isLiveCodingSessionStatus(status) {
+    return status === "spawning"
+        || status === "running"
+        || status === "waiting_input"
+        || status === "stalled";
+}
+function emptyTaskBoard() {
+    return {
+        compact: "",
+        full: "",
+        byStatus: {
+            drafting: [],
+            processing: [],
+            validating: [],
+            collaborating: [],
+            paused: [],
+            blocked: [],
+            done: [],
+            cancelled: [],
+        },
+        issues: [],
+        actionRequired: [],
+        unresolvedDependencies: [],
+        activeSessions: [],
+        activeBridges: [],
+    };
+}
+function readInnerWorkState() {
+    const defaultJob = {
+        status: "idle",
+        content: null,
+        origin: null,
+        mode: "reflect",
+        obligationStatus: null,
+        surfacedResult: null,
+        queuedAt: null,
+        startedAt: null,
+        surfacedAt: null,
+    };
+    try {
+        const agentRoot = (0, identity_1.getAgentRoot)();
+        const pendingDir = (0, pending_1.getInnerDialogPendingDir)((0, identity_1.getAgentName)());
+        const sessionPath = (0, thoughts_1.getInnerDialogSessionPath)(agentRoot);
+        const { pendingMessages, turns, runtimeState } = (0, thoughts_1.readInnerDialogRawData)(sessionPath, pendingDir);
+        const dialogStatus = (0, thoughts_1.deriveInnerDialogStatus)(pendingMessages, turns, runtimeState);
+        const job = (0, thoughts_1.deriveInnerJob)(pendingMessages, turns, runtimeState);
+        const storeObligationPending = (0, obligations_1.readPendingObligations)(agentRoot).length > 0;
+        return {
+            status: dialogStatus.processing === "started" ? "running" : "idle",
+            hasPending: dialogStatus.queue !== "clear",
+            origin: dialogStatus.origin,
+            contentSnippet: dialogStatus.contentSnippet,
+            obligationPending: dialogStatus.obligationPending || storeObligationPending,
+            job,
+        };
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        return {
+            status: "idle",
+            hasPending: false,
+            job: defaultJob,
+            /* v8 ignore stop */
+        };
+    }
+}
+function checkDaemonRunning() {
+    try {
+        return fs.existsSync(DAEMON_SOCKET_PATH);
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        return false;
+        /* v8 ignore stop */
+    }
+}
+function hasTextField(record, key) {
+    return typeof record?.[key] === "string" && record[key].trim().length > 0;
+}
+function readSenseStatusLines() {
+    const config = (0, identity_1.loadAgentConfig)();
+    const senses = config.senses ?? {
+        cli: { enabled: true },
+        teams: { enabled: false },
+        bluebubbles: { enabled: false },
+    };
+    let payload = {};
+    try {
+        const raw = fs.readFileSync((0, identity_1.getAgentSecretsPath)(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            payload = parsed;
+        }
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        payload = {};
+        /* v8 ignore stop */
+    }
+    const teams = payload.teams;
+    const bluebubbles = payload.bluebubbles;
+    const configured = {
+        cli: true,
+        teams: hasTextField(teams, "clientId") && hasTextField(teams, "clientSecret") && hasTextField(teams, "tenantId"),
+        bluebubbles: hasTextField(bluebubbles, "serverUrl") && hasTextField(bluebubbles, "password"),
+    };
+    const rows = [
+        { label: "CLI", status: "interactive" },
+        {
+            label: "Teams",
+            status: !senses.teams.enabled ? "disabled" : configured.teams ? "ready" : "needs_config",
+        },
+        {
+            label: "BlueBubbles",
+            status: !senses.bluebubbles.enabled ? "disabled" : configured.bluebubbles ? "ready" : "needs_config",
+        },
+    ];
+    return rows.map((row) => `- ${row.label}: ${row.status}`);
+}
+function readBundleMetaFile() {
+    try {
+        const metaPath = path.join((0, identity_1.getAgentRoot)(), "bundle-meta.json");
+        const raw = fs.readFileSync(metaPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        return null;
+        /* v8 ignore stop */
+    }
+}
+// ── Builder ─────────────────────────────────────────────────────────
+async function buildTurnContext(input) {
+    const agentRoot = (0, identity_1.getAgentRoot)();
+    const agentName = (0, identity_1.getAgentName)();
+    // Sync config
+    let syncConfig = { enabled: false, remote: "origin" };
+    try {
+        syncConfig = (0, config_1.getSyncConfig)();
+    }
+    catch { /* v8 ignore next -- defensive @preserve */ /* config not available */ }
+    // Bridges
+    const activeBridges = (0, manager_1.createBridgeManager)().findBridgesForSession({
+        friendId: input.currentSession.friendId,
+        channel: input.currentSession.channel,
+        key: input.currentSession.key,
+    });
+    // Session activity
+    let sessionActivity = [];
+    try {
+        sessionActivity = (0, session_activity_1.listSessionActivity)({
+            sessionsDir: `${agentRoot}/state/sessions`,
+            friendsDir: `${agentRoot}/friends`,
+            agentName,
+            currentSession: {
+                friendId: input.currentSession.friendId,
+                channel: input.currentSession.channel,
+                key: input.currentSession.key,
+            },
+        });
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        sessionActivity = [];
+        /* v8 ignore stop */
+    }
+    // Target candidates
+    let targetCandidates = [];
+    try {
+        if (input.channel !== "inner") {
+            targetCandidates = await (0, target_resolution_1.listTargetSessionCandidates)({
+                sessionsDir: `${agentRoot}/state/sessions`,
+                friendsDir: `${agentRoot}/friends`,
+                agentName,
+                currentSession: {
+                    friendId: input.currentSession.friendId,
+                    channel: input.currentSession.channel,
+                    key: input.currentSession.key,
+                },
+                friendStore: input.friendStore,
+            });
+        }
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        targetCandidates = [];
+        /* v8 ignore stop */
+    }
+    // Pending obligations
+    let pendingObligations = [];
+    try {
+        pendingObligations = (0, obligations_1.readPendingObligations)(agentRoot);
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        pendingObligations = [];
+        /* v8 ignore stop */
+    }
+    // Coding sessions
+    let codingSessions = [];
+    let otherCodingSessions = [];
+    try {
+        const liveCodingSessions = (0, coding_1.getCodingSessionManager)()
+            .listSessions()
+            .filter((session) => isLiveCodingSessionStatus(session.status) && Boolean(session.originSession));
+        codingSessions = liveCodingSessions.filter((session) => session.originSession?.friendId === input.currentSession.friendId
+            && session.originSession.channel === input.currentSession.channel
+            && session.originSession.key === input.currentSession.key);
+        otherCodingSessions = liveCodingSessions.filter((session) => !(session.originSession?.friendId === input.currentSession.friendId
+            && session.originSession.channel === input.currentSession.channel
+            && session.originSession.key === input.currentSession.key));
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        codingSessions = [];
+        otherCodingSessions = [];
+        /* v8 ignore stop */
+    }
+    // Inner work state
+    const innerWorkState = readInnerWorkState();
+    // Task board
+    let taskBoard;
+    try {
+        taskBoard = (0, tasks_1.getTaskModule)().getBoard();
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        taskBoard = emptyTaskBoard();
+        /* v8 ignore stop */
+    }
+    // Return obligations
+    let returnObligations = [];
+    try {
+        returnObligations = (0, obligations_1.listActiveReturnObligations)(agentName);
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        returnObligations = [];
+        /* v8 ignore stop */
+    }
+    // Recent episodes
+    const recentEpisodes = (0, episodes_1.readRecentEpisodes)(agentRoot, { limit: 20 });
+    // Active cares
+    const activeCares = (0, cares_1.readActiveCares)(agentRoot);
+    // ── Prompt-assembly pre-reads ──────────────────────────────────────
+    const daemonRunning = checkDaemonRunning();
+    let senseStatusLines = [];
+    try {
+        senseStatusLines = readSenseStatusLines();
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        senseStatusLines = [];
+        /* v8 ignore stop */
+    }
+    const bundleMeta = readBundleMetaFile();
+    let daemonHealth = null;
+    try {
+        daemonHealth = (0, daemon_health_1.readHealth)((0, daemon_health_1.getDefaultHealthPath)());
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        daemonHealth = null;
+        /* v8 ignore stop */
+    }
+    let journalFiles = [];
+    try {
+        const journalDir = path.join(agentRoot, "journal");
+        journalFiles = (0, prompt_1.readJournalFiles)(journalDir);
+    }
+    catch { /* v8 ignore start -- defensive: fallback on read failure @preserve */
+        journalFiles = [];
+        /* v8 ignore stop */
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.turn_context_built",
+        message: "turn context snapshot assembled",
+        meta: {
+            channel: input.channel,
+            obligationCount: pendingObligations.length,
+            bridgeCount: activeBridges.length,
+            codingSessionCount: codingSessions.length,
+            episodeCount: recentEpisodes.length,
+        },
+    });
+    return {
+        activeBridges,
+        sessionActivity,
+        targetCandidates,
+        pendingObligations,
+        codingSessions,
+        otherCodingSessions,
+        innerWorkState,
+        taskBoard,
+        returnObligations,
+        recentEpisodes,
+        activeCares,
+        syncConfig,
+        syncFailure: undefined, // Set by pipeline after preTurnPull
+        daemonRunning,
+        senseStatusLines,
+        bundleMeta,
+        daemonHealth,
+        journalFiles,
+    };
+}

package/dist/mind/prompt.js

@@ -257,7 +257,11 @@ function processTypeLabel(channel) {
     return PROCESS_TYPE_LABELS[channel];
 }
 const DAEMON_SOCKET_PATH = "/tmp/ouroboros-daemon.sock";
-function daemonStatus() {
+function daemonStatus(preRead) {
+    /* v8 ignore next 2 -- pre-read branch: exercised via pipeline TurnContext path, not unit-testable in isolation @preserve */
+    if (preRead !== undefined) {
+        return preRead ? "running" : "not running";
+    }
     try {
         return fs.existsSync(DAEMON_SOCKET_PATH) ? "running" : "not running";
     }
@@ -265,14 +269,15 @@ function daemonStatus() {
         return "unknown";
     }
 }
-function runtimeInfoSection(channel) {
+function runtimeInfoSection(channel, options) {
     const lines = [];
     const agentName = (0, identity_1.getAgentName)();
     const currentVersion = (0, bundle_manifest_1.getPackageVersion)();
     lines.push(`## runtime`);
     lines.push(`agent: ${agentName}`);
     lines.push(`runtime version: ${currentVersion}`);
-    const bundleMeta = readBundleMeta();
+    /* v8 ignore next -- branch: pre-read path exercised via pipeline TurnContext, not unit-testable in isolation @preserve */
+    const bundleMeta = options?.bundleMeta !== undefined ? options.bundleMeta : readBundleMeta();
     if (bundleMeta?.previousRuntimeVersion && bundleMeta.previousRuntimeVersion !== currentVersion) {
         lines.push(`previously: ${bundleMeta.previousRuntimeVersion}`);
         const changelogCommand = (0, ouro_version_manager_1.buildChangelogCommand)(bundleMeta.previousRuntimeVersion, currentVersion);
@@ -289,7 +294,7 @@ function runtimeInfoSection(channel) {
     lines.push(`channel: ${channel}`);
     lines.push(`current sense: ${channel}`);
     lines.push(`process type: ${processTypeLabel(channel)}`);
-    lines.push(`daemon: ${daemonStatus()}`);
+    lines.push(`daemon: ${daemonStatus(options?.daemonRunning)}`);
     lines.push(`mcp serve: i can expose my tools to dev tools via \`ouro mcp-serve\`. see the configure-dev-tools skill for setup.`);
     if (channel === "cli") {
         lines.push("i introduce myself on boot with a fun random greeting.");
@@ -308,7 +313,7 @@ function runtimeInfoSection(channel) {
         lines.push("i am responding in Microsoft Teams. i keep responses concise. i use markdown formatting. i do not introduce myself on boot.");
     }
     lines.push("");
-    lines.push(...senseRuntimeGuidance(channel));
+    lines.push(...senseRuntimeGuidance(channel, options?.senseStatusLines));
     return lines.join("\n");
 }
 function hasTextField(record, key) {
@@ -356,9 +361,9 @@ function localSenseStatusLines() {
     _senseStatusLinesCache = rows.map((row) => `- ${row.label}: ${row.status}`);
     return [..._senseStatusLinesCache];
 }
-function senseRuntimeGuidance(channel) {
+function senseRuntimeGuidance(channel, preReadStatusLines) {
     const lines = ["available senses:"];
-    lines.push(...localSenseStatusLines());
+    lines.push(...(preReadStatusLines ?? localSenseStatusLines()));
     lines.push("sense states:");
     lines.push("- interactive = available when opened by the user instead of kept running by the daemon");
     lines.push("- disabled = turned off in agent.json");
@@ -876,9 +881,8 @@ function formatRelativeTime(nowMs, mtimeMs) {
     const days = Math.floor(hours / 24);
     return `${days} day${days === 1 ? "" : "s"} ago`;
 }
-function journalSection(agentRoot, now) {
-    const journalDir = path.join(agentRoot, "journal");
-    const files = readJournalFiles(journalDir);
+function journalSection(agentRoot, now, preReadFiles) {
+    const files = preReadFiles ?? readJournalFiles(path.join(agentRoot, "journal"));
     if (files.length === 0)
         return "";
     const nowMs = (now ?? new Date()).getTime();
@@ -977,9 +981,10 @@ function formatElapsedBrief(ms) {
     const hours = Math.floor(minutes / 60);
     return `${hours}h ago`;
 }
-function rhythmStatusSection() {
+function rhythmStatusSection(preReadHealth) {
     try {
-        const health = (0, daemon_health_1.readHealth)((0, daemon_health_1.getDefaultHealthPath)());
+        /* v8 ignore next -- branch: pre-read path exercised via pipeline TurnContext @preserve */
+        const health = preReadHealth !== undefined ? preReadHealth : (0, daemon_health_1.readHealth)((0, daemon_health_1.getDefaultHealthPath)());
         if (!health)
             return "";
         const habitNames = Object.keys(health.habits);
@@ -1032,8 +1037,8 @@ async function buildSystem(channel = "cli", options, context) {
         // Group 2: my body & environment
         "# my body & environment",
         bodyMapSection((0, identity_1.getAgentName)()),
-        runtimeInfoSection(channel),
-        rhythmStatusSection(),
+        runtimeInfoSection(channel, options),
+        rhythmStatusSection(options?.daemonHealth),
         channelNatureSection((0, channel_1.getChannelCapabilities)(channel)),
         providerSection(channel),
         dateSection(),
@@ -1055,7 +1060,7 @@ async function buildSystem(channel = "cli", options, context) {
         ...(channel === "inner" ? [
             "# my inner life",
             metacognitiveFramingSection(channel),
-            journalSection((0, identity_1.getAgentRoot)()),
+            journalSection((0, identity_1.getAgentRoot)(), undefined, options?.journalFiles),
         ] : []),
         // Group 6: social context (non-local, non-inner channels)
         // Individual sections self-gate on isRemoteChannel/channel checks.

package/dist/repertoire/tools-base.js

@@ -58,10 +58,9 @@ const coding_1 = require("./coding");
 const diary_1 = require("../mind/diary");
 const tasks_1 = require("./tasks");
 const pending_1 = require("../mind/pending");
-const obligations_1 = require("../mind/obligations");
+const obligations_1 = require("../heart/obligations");
 const progress_story_1 = require("../heart/progress-story");
 const cross_chat_delivery_1 = require("../heart/cross-chat-delivery");
-const obligations_2 = require("../heart/obligations");
 const episodes_1 = require("../mind/episodes");
 const cares_1 = require("../heart/cares");
 const presence_1 = require("../heart/presence");
@@ -220,7 +219,7 @@ function readActiveWorkInnerState() {
         const { pendingMessages, turns, runtimeState } = (0, thoughts_1.readInnerDialogRawData)(sessionPath, pendingDir);
         const dialogStatus = (0, thoughts_1.deriveInnerDialogStatus)(pendingMessages, turns, runtimeState);
         const job = (0, thoughts_1.deriveInnerJob)(pendingMessages, turns, runtimeState);
-        const storeObligationPending = (0, obligations_2.readPendingObligations)(agentRoot).length > 0;
+        const storeObligationPending = (0, obligations_1.readPendingObligations)(agentRoot).length > 0;
         return {
             status: dialogStatus.processing === "started" ? "running" : "idle",
             hasPending: dialogStatus.queue !== "clear",
@@ -269,7 +268,7 @@ async function buildToolActiveWorkFrame(ctx) {
     }
     const pendingObligations = (() => {
         try {
-            return (0, obligations_2.readPendingObligations)(agentRoot);
+            return (0, obligations_1.readPendingObligations)(agentRoot);
         }
         catch {
             return [];
@@ -1296,7 +1295,7 @@ exports.baseToolDefinitions = [
                 writePendingEnvelope(pendingDir, envelope);
                 if (delegatedFrom) {
                     try {
-                        (0, obligations_2.createObligation)((0, identity_1.getAgentRoot)(), {
+                        (0, obligations_1.createObligation)((0, identity_1.getAgentRoot)(), {
                             origin: {
                                 friendId: delegatedFrom.friendId,
                                 channel: delegatedFrom.channel,
@@ -1311,7 +1310,7 @@ exports.baseToolDefinitions = [
                     }
                     /* v8 ignore next -- obligationId always set when delegatedFrom is set (see generateObligationId above) @preserve */
                     if (obligationId) {
-                        (0, obligations_1.createObligation)(agentName, {
+                        (0, obligations_1.createReturnObligation)(agentName, {
                             id: obligationId,
                             origin: delegatedFrom,
                             status: "queued",

package/dist/repertoire/tools.js

@@ -48,8 +48,7 @@ const runtime_1 = require("../nerves/runtime");
 const guardrails_1 = require("./guardrails");
 const identity_1 = require("../heart/identity");
 const surface_tool_1 = require("../senses/surface-tool");
-const obligations_1 = require("../mind/obligations");
-const obligations_2 = require("../heart/obligations");
+const obligations_1 = require("../heart/obligations");
 const session_activity_1 = require("../heart/session-activity");
 const path = __importStar(require("path"));
 function safeGetAgentRoot() {
@@ -198,7 +197,7 @@ const surfaceToolDefinition = {
                     catch {
                         return "unknown";
                     } })();
-                    (0, obligations_1.advanceObligation)(name, obligationId, {
+                    (0, obligations_1.advanceReturnObligation)(name, obligationId, {
                         status: update.status,
                         ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
                         ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
@@ -213,9 +212,9 @@ const surfaceToolDefinition = {
                 /* v8 ignore start -- heart obligation fulfillment: tested via surface-tool.test.ts @preserve */
                 try {
                     const agentRoot = (0, identity_1.getAgentRoot)();
-                    const heartObligation = (0, obligations_2.findPendingObligationForOrigin)(agentRoot, origin);
+                    const heartObligation = (0, obligations_1.findPendingObligationForOrigin)(agentRoot, origin);
                     if (heartObligation) {
-                        (0, obligations_2.fulfillObligation)(agentRoot, heartObligation.id);
+                        (0, obligations_1.fulfillObligation)(agentRoot, heartObligation.id);
                     }
                 }
                 catch {

package/dist/senses/inner-dialog.js

@@ -55,7 +55,7 @@ const prompt_1 = require("../mind/prompt");
 const mcp_manager_1 = require("../repertoire/mcp-manager");
 const bundle_manifest_1 = require("../mind/bundle-manifest");
 const pending_1 = require("../mind/pending");
-const obligations_1 = require("../mind/obligations");
+const obligations_1 = require("../heart/obligations");
 const attention_queue_1 = require("./attention-queue");
 const channel_1 = require("../mind/friends/channel");
 const trust_gate_1 = require("./trust-gate");
@@ -66,7 +66,6 @@ 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 obligations_2 = require("../heart/obligations");
 const habit_turn_message_1 = require("./habit-turn-message");
 const journal_index_1 = require("../mind/journal-index");
 const habit_parser_1 = require("../heart/daemon/habit-parser");
@@ -324,7 +323,7 @@ function advanceObligationQuietly(agentName, obligationId, update) {
     if (!obligationId)
         return;
     try {
-        (0, obligations_1.advanceObligation)(agentName, obligationId, update);
+        (0, obligations_1.advanceReturnObligation)(agentName, obligationId, update);
         /* v8 ignore start -- best-effort: obligation fs errors must never block return routing @preserve */
     }
     catch {
@@ -352,14 +351,14 @@ async function routeDelegatedCompletion(agentRoot, agentName, completion, draine
     if (delegated.obligationStatus === "pending") {
         // Fulfill the persistent obligation in the store
         try {
-            const pending = (0, obligations_2.findPendingObligationForOrigin)(agentRoot, {
+            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_2.fulfillObligation)(agentRoot, pending.id);
+                (0, obligations_1.fulfillObligation)(agentRoot, pending.id);
             }
         }
         catch {
@@ -577,7 +576,7 @@ async function runInnerDialogTurn(options) {
                 }
                 else {
                     // Unified path: gather context for ALL habits (heartbeat included)
-                    const obligations = (0, obligations_1.listActiveObligations)(agentName);
+                    const obligations = (0, obligations_1.listActiveReturnObligations)(agentName);
                     const nowMs = now().getTime();
                     const staleObligations = obligations.map((o) => ({
                         friendName: o.origin.friendId,
@@ -670,7 +669,7 @@ async function runInnerDialogTurn(options) {
             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.listActiveObligations)(agentName);
+                const outstandingObligations = (0, obligations_1.listActiveReturnObligations)(agentName);
                 attentionQueue = (0, attention_queue_1.buildAttentionQueue)({
                     drainedPending: drained,
                     outstandingObligations,

package/dist/senses/pipeline.js

@@ -47,17 +47,10 @@ const commands_1 = require("./commands");
 const continuity_1 = require("./continuity");
 const manager_1 = require("../heart/bridges/manager");
 const identity_1 = require("../heart/identity");
-const tasks_1 = require("../repertoire/tasks");
-const coding_1 = require("../repertoire/coding");
-const session_activity_1 = require("../heart/session-activity");
 const socket_client_1 = require("../heart/daemon/socket-client");
 const active_work_1 = require("../heart/active-work");
 const delegation_1 = require("../heart/delegation");
-const target_resolution_1 = require("../heart/target-resolution");
-const thoughts_1 = require("../heart/daemon/thoughts");
-const pending_1 = require("../mind/pending");
 const obligations_1 = require("../heart/obligations");
-const obligations_2 = require("../mind/obligations");
 const provider_failover_1 = require("../heart/provider-failover");
 const provider_ping_1 = require("../heart/provider-ping");
 const auth_flow_1 = require("../heart/daemon/auth-flow");
@@ -68,7 +61,7 @@ const sync_1 = require("../heart/sync");
 const config_1 = require("../heart/config");
 const presence_1 = require("../heart/presence");
 const episodes_1 = require("../mind/episodes");
-const cares_1 = require("../heart/cares");
+const turn_context_1 = require("../heart/turn-context");
 /**
  * Emit episodes for obligation state transitions detected during a turn.
  * Exported for direct testability (avoids v8 coverage merge issues in multi-file test suites).
@@ -89,33 +82,6 @@ function emitObligationTransitionEpisodes(agentRoot, preTurnObligationIds, postT
         }
     }
 }
-function emptyTaskBoard() {
-    return {
-        compact: "",
-        full: "",
-        byStatus: {
-            drafting: [],
-            processing: [],
-            validating: [],
-            collaborating: [],
-            paused: [],
-            blocked: [],
-            done: [],
-            cancelled: [],
-        },
-        issues: [],
-        actionRequired: [],
-        unresolvedDependencies: [],
-        activeSessions: [],
-        activeBridges: [],
-    };
-}
-function isLiveCodingSessionStatus(status) {
-    return status === "spawning"
-        || status === "running"
-        || status === "waiting_input"
-        || status === "stalled";
-}
 function prependTurnSections(message, sections) {
     /* v8 ignore next -- defensive: only user messages with non-empty sections reach here @preserve */
     if (message.role !== "user" || sections.length === 0)
@@ -137,44 +103,6 @@ function prependTurnSections(message, sections) {
     };
     /* v8 ignore stop */
 }
-function readInnerWorkState() {
-    const defaultJob = {
-        status: "idle",
-        content: null,
-        origin: null,
-        mode: "reflect",
-        obligationStatus: null,
-        surfacedResult: null,
-        queuedAt: null,
-        startedAt: null,
-        surfacedAt: null,
-    };
-    try {
-        const agentRoot = (0, identity_1.getAgentRoot)();
-        const pendingDir = (0, pending_1.getInnerDialogPendingDir)((0, identity_1.getAgentName)());
-        const sessionPath = (0, thoughts_1.getInnerDialogSessionPath)(agentRoot);
-        const { pendingMessages, turns, runtimeState } = (0, thoughts_1.readInnerDialogRawData)(sessionPath, pendingDir);
-        const dialogStatus = (0, thoughts_1.deriveInnerDialogStatus)(pendingMessages, turns, runtimeState);
-        const job = (0, thoughts_1.deriveInnerJob)(pendingMessages, turns, runtimeState);
-        // Derive obligationPending from both the pending message field and the obligation store
-        const storeObligationPending = (0, obligations_1.readPendingObligations)(agentRoot).length > 0;
-        return {
-            status: dialogStatus.processing === "started" ? "running" : "idle",
-            hasPending: dialogStatus.queue !== "clear",
-            origin: dialogStatus.origin,
-            contentSnippet: dialogStatus.contentSnippet,
-            obligationPending: dialogStatus.obligationPending || storeObligationPending,
-            job,
-        };
-    }
-    catch {
-        return {
-            status: "idle",
-            hasPending: false,
-            job: defaultJob,
-        };
-    }
-}
 // ── Pipeline ──────────────────────────────────────────────────────
 let _lastSessionKey = null;
 async function handleInboundTurn(input) {
@@ -378,100 +306,29 @@ async function handleInboundTurn(input) {
                 }
             }
             /* v8 ignore stop */
-            const activeBridges = (0, manager_1.createBridgeManager)().findBridgesForSession({
-                friendId: currentSession.friendId,
-                channel: currentSession.channel,
-                key: currentSession.key,
+            // Build the turn context snapshot — centralizes all state reads
+            const ctx = await (0, turn_context_1.buildTurnContext)({
+                currentSession,
+                channel: input.channel,
+                friendStore: input.friendStore,
             });
+            // Propagate sync failure from pre-turn pull
+            ctx.syncFailure = syncFailure;
+            const { activeBridges, sessionActivity, pendingObligations, codingSessions, otherCodingSessions } = ctx;
             const bridgeContext = (0, manager_1.formatBridgeContext)(activeBridges) || undefined;
-            let sessionActivity = [];
-            try {
-                const agentRoot = (0, identity_1.getAgentRoot)();
-                sessionActivity = (0, session_activity_1.listSessionActivity)({
-                    sessionsDir: `${agentRoot}/state/sessions`,
-                    friendsDir: `${agentRoot}/friends`,
-                    agentName: (0, identity_1.getAgentName)(),
-                    currentSession: {
-                        friendId: currentSession.friendId,
-                        channel: currentSession.channel,
-                        key: currentSession.key,
-                    },
-                });
-            }
-            catch {
-                sessionActivity = [];
-            }
-            let targetCandidates = [];
-            try {
-                if (input.channel !== "inner") {
-                    const agentRoot = (0, identity_1.getAgentRoot)();
-                    targetCandidates = await (0, target_resolution_1.listTargetSessionCandidates)({
-                        sessionsDir: `${agentRoot}/state/sessions`,
-                        friendsDir: `${agentRoot}/friends`,
-                        agentName: (0, identity_1.getAgentName)(),
-                        currentSession: {
-                            friendId: currentSession.friendId,
-                            channel: currentSession.channel,
-                            key: currentSession.key,
-                        },
-                        friendStore: input.friendStore,
-                    });
-                }
-            }
-            catch {
-                targetCandidates = [];
-            }
-            let pendingObligations = [];
-            try {
-                pendingObligations = (0, obligations_1.readPendingObligations)((0, identity_1.getAgentRoot)());
-            }
-            catch {
-                pendingObligations = [];
-            }
-            let codingSessions = [];
-            let otherCodingSessions = [];
-            try {
-                const liveCodingSessions = (0, coding_1.getCodingSessionManager)()
-                    .listSessions()
-                    .filter((session) => isLiveCodingSessionStatus(session.status) && Boolean(session.originSession));
-                codingSessions = liveCodingSessions.filter((session) => session.originSession?.friendId === currentSession.friendId
-                    && session.originSession.channel === currentSession.channel
-                    && session.originSession.key === currentSession.key);
-                otherCodingSessions = liveCodingSessions.filter((session) => !(session.originSession?.friendId === currentSession.friendId
-                    && session.originSession.channel === currentSession.channel
-                    && session.originSession.key === currentSession.key));
-            }
-            catch {
-                codingSessions = [];
-                otherCodingSessions = [];
-            }
             const activeWorkFrame = (0, active_work_1.buildActiveWorkFrame)({
                 currentSession,
                 currentObligation,
                 mustResolveBeforeHandoff,
-                inner: readInnerWorkState(),
+                inner: ctx.innerWorkState,
                 bridges: activeBridges,
                 codingSessions,
                 otherCodingSessions,
                 pendingObligations,
-                taskBoard: (() => {
-                    try {
-                        return (0, tasks_1.getTaskModule)().getBoard();
-                    }
-                    catch {
-                        return emptyTaskBoard();
-                    }
-                })(),
+                taskBoard: ctx.taskBoard,
                 friendActivity: sessionActivity,
-                targetCandidates,
-                innerReturnObligations: (() => {
-                    try {
-                        return (0, obligations_2.listActiveObligations)((0, identity_1.getAgentName)());
-                    }
-                    catch {
-                        return [];
-                    }
-                })(),
+                targetCandidates: ctx.targetCandidates,
+                innerReturnObligations: ctx.returnObligations,
             });
             const delegationDecision = (0, delegation_1.decideDelegation)({
                 channel: input.channel,
@@ -502,8 +359,7 @@ async function handleInboundTurn(input) {
             try {
                 const agentRoot = (0, identity_1.getAgentRoot)();
                 const agentName = (0, identity_1.getAgentName)();
-                const recentEpisodes = (0, episodes_1.readRecentEpisodes)(agentRoot, { limit: 20 });
-                const activeCares = (0, cares_1.readActiveCares)(agentRoot);
+                const { recentEpisodes, activeCares } = ctx;
                 const tempoState = (0, tempo_1.deriveTempo)({
                     activeSessions: sessionActivity.length + 1,
                     openObligations: pendingObligations.length,
@@ -571,6 +427,12 @@ async function handleInboundTurn(input) {
                 setMustResolveBeforeHandoff: (value) => {
                     mustResolveBeforeHandoff = value;
                 },
+                // Pre-read state from TurnContext for prompt assembly
+                daemonRunning: ctx.daemonRunning,
+                senseStatusLines: ctx.senseStatusLines,
+                bundleMeta: ctx.bundleMeta,
+                daemonHealth: ctx.daemonHealth,
+                journalFiles: ctx.journalFiles,
                 toolContext: {
                     /* v8 ignore next -- default no-op signin satisfies interface; real signin injected by sense adapter @preserve */
                     signin: async () => undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.202",
+  "version": "0.1.0-alpha.204",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",

package/dist/mind/obligations.js

@@ -1,138 +0,0 @@
-"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 });
-exports.getObligationsDir = getObligationsDir;
-exports.generateObligationId = generateObligationId;
-exports.createObligation = createObligation;
-exports.readObligation = readObligation;
-exports.advanceObligation = advanceObligation;
-exports.listActiveObligations = listActiveObligations;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const identity_1 = require("../heart/identity");
-const runtime_1 = require("../nerves/runtime");
-const sync_1 = require("../heart/sync");
-// ── Paths ────────────────────────────────────────────────────────
-function getObligationsDir(agentName) {
-    return path.join((0, identity_1.getAgentRoot)(agentName), "arc", "obligations", "inner");
-}
-// ── ID generation ────────────────────────────────────────────────
-function generateObligationId(timestamp) {
-    return `${timestamp}-${Math.random().toString(36).slice(2, 10)}`;
-}
-// ── Store operations ─────────────────────────────────────────────
-function createObligation(agentName, obligation) {
-    const dir = getObligationsDir(agentName);
-    fs.mkdirSync(dir, { recursive: true });
-    const filePath = path.join(dir, `${obligation.id}.json`);
-    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf8");
-    (0, sync_1.trackSyncWrite)(filePath);
-    (0, runtime_1.emitNervesEvent)({
-        event: "mind.obligation_created",
-        component: "mind",
-        message: "return obligation created",
-        meta: {
-            obligationId: obligation.id,
-            origin: `${obligation.origin.friendId}/${obligation.origin.channel}/${obligation.origin.key}`,
-            status: obligation.status,
-        },
-    });
-    return filePath;
-}
-function readObligation(agentName, obligationId) {
-    const dir = getObligationsDir(agentName);
-    try {
-        const raw = fs.readFileSync(path.join(dir, `${obligationId}.json`), "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-function advanceObligation(agentName, obligationId, update) {
-    const existing = readObligation(agentName, obligationId);
-    if (!existing)
-        return null;
-    const updated = {
-        ...existing,
-        status: update.status,
-        ...(update.startedAt !== undefined ? { startedAt: update.startedAt } : {}),
-        ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
-        ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
-    };
-    const dir = getObligationsDir(agentName);
-    const advancedFilePath = path.join(dir, `${obligationId}.json`);
-    fs.writeFileSync(advancedFilePath, JSON.stringify(updated, null, 2), "utf8");
-    (0, sync_1.trackSyncWrite)(advancedFilePath);
-    (0, runtime_1.emitNervesEvent)({
-        event: "mind.obligation_advanced",
-        component: "mind",
-        message: `obligation advanced to ${update.status}`,
-        meta: {
-            obligationId,
-            status: update.status,
-            ...(update.returnTarget ? { returnTarget: update.returnTarget } : {}),
-        },
-    });
-    return updated;
-}
-function listActiveObligations(agentName) {
-    const dir = getObligationsDir(agentName);
-    if (!fs.existsSync(dir))
-        return [];
-    let entries;
-    try {
-        entries = fs.readdirSync(dir);
-    }
-    catch {
-        return [];
-    }
-    const obligations = [];
-    for (const file of entries) {
-        if (!file.endsWith(".json"))
-            continue;
-        try {
-            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
-            const parsed = JSON.parse(raw);
-            if (parsed.status === "queued" || parsed.status === "running") {
-                obligations.push(parsed);
-            }
-        }
-        catch {
-            // skip unparseable
-        }
-    }
-    return obligations.sort((a, b) => a.createdAt - b.createdAt);
-}