@ouro.bot/cli 0.1.0-alpha.27 → 0.1.0-alpha.271

package/dist/heart/tool-description.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.humanReadableToolDescription = humanReadableToolDescription;
+const runtime_1 = require("../nerves/runtime");
+function basename(filePath) {
+    const idx = filePath.lastIndexOf("/");
+    return idx >= 0 ? filePath.slice(idx + 1) : filePath;
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    // Cut at last space before maxLen to avoid mid-word truncation
+    const slice = text.slice(0, max - 1);
+    const lastSpace = slice.lastIndexOf(" ");
+    if (lastSpace > 0)
+        return text.slice(0, lastSpace) + "\u2026";
+    // No space found (single long word) — hard truncate
+    return slice + "\u2026";
+}
+const TOOL_DESCRIPTIONS = {
+    // File operations
+    shell: (args) => {
+        const cmd = args.command;
+        if (!cmd)
+            return "running a command...";
+        return `running ${truncate(cmd, 50)}...`;
+    },
+    read_file: (args) => {
+        const fp = args.path || args.file_path;
+        if (!fp)
+            return "reading a file...";
+        return `reading ${basename(fp)}...`;
+    },
+    write_file: (args) => {
+        const fp = args.path || args.file_path;
+        if (!fp)
+            return "writing a file...";
+        return `writing ${basename(fp)}...`;
+    },
+    edit_file: (args) => {
+        const fp = args.path || args.file_path;
+        if (!fp)
+            return "editing a file...";
+        return `editing ${basename(fp)}...`;
+    },
+    glob: (args) => {
+        const p = args.pattern;
+        if (!p)
+            return "searching for files...";
+        return `searching for ${truncate(p, 40)}...`;
+    },
+    grep: (args) => {
+        const p = args.pattern;
+        if (!p)
+            return "searching code...";
+        return `searching code for '${truncate(p, 40)}'...`;
+    },
+    // Memory and knowledge
+    recall: (args) => {
+        const q = args.query;
+        if (!q)
+            return "searching memory...";
+        return `searching memory for '${truncate(q, 40)}'...`;
+    },
+    diary_write: (args) => {
+        const about = args.about;
+        return about ? `noting something about ${truncate(about, 30)}...` : "noting something down...";
+    },
+    save_friend_note: () => "making a note about you...",
+    get_friend_note: () => "checking my notes...",
+    load_skill: (args) => {
+        const name = args.name || args.skill;
+        return name ? `loading ${name} skill...` : "loading a skill...";
+    },
+    // Session and context
+    query_session: (args) => {
+        const mode = args.mode;
+        if (mode === "search")
+            return `searching session for '${truncate(args.query || "", 30)}'...`;
+        if (mode === "status")
+            return "checking inner dialog status...";
+        return "checking session history...";
+    },
+    web_search: (args) => {
+        const q = args.query;
+        return q ? `searching the web for '${truncate(q, 35)}'...` : "searching the web...";
+    },
+    coding_spawn: (args) => {
+        const runner = args.runner;
+        return runner ? `starting ${runner} coding session...` : "starting coding session...";
+    },
+    coding_status: () => "checking coding sessions...",
+    coding_tail: () => "reading coding output...",
+    coding_kill: () => "stopping coding session...",
+    bridge_manage: () => "managing conversation bridge...",
+    // Communication
+    send_message: (args) => {
+        const to = args.to;
+        return to ? `sending a message to ${to}...` : "sending a message...";
+    },
+    surface: () => "sharing a thought...",
+    // Metacognitive (agent's inner life)
+    ponder: (args) => {
+        const thought = args.thought;
+        return thought ? `thinking about ${truncate(thought, 40)}...` : "thinking deeper...";
+    },
+    observe: () => null,
+    claude: () => "reasoning...",
+    set_reasoning_effort: (args) => {
+        const level = args.level;
+        return level ? `setting thinking depth to ${level}...` : "adjusting thinking depth...";
+    },
+    // Hidden — these ARE the response or end-of-turn
+    settle: () => null,
+    rest: () => null,
+    descend: () => null,
+};
+function humanReadableToolDescription(name, args) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.tool_description",
+        message: "generated human-readable tool description",
+        meta: { tool: name },
+    });
+    const builder = TOOL_DESCRIPTIONS[name];
+    if (builder)
+        return builder(args);
+    // MCP tools: mcp__server__toolname — extract last segment
+    if (name.startsWith("mcp__")) {
+        const parts = name.split("__");
+        const toolName = parts[parts.length - 1];
+        return `using ${toolName}...`;
+    }
+    return `using ${name}...`;
+}

package/dist/heart/tool-loop.js

@@ -0,0 +1,200 @@
+"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.GLOBAL_CIRCUIT_BREAKER_LIMIT = exports.PING_PONG_WINDOW = exports.GENERIC_REPEAT_LIMIT = exports.POLL_NO_PROGRESS_LIMIT = exports.TOOL_LOOP_HISTORY_LIMIT = void 0;
+exports.createToolLoopState = createToolLoopState;
+exports.recordToolOutcome = recordToolOutcome;
+exports.detectToolLoop = detectToolLoop;
+const crypto = __importStar(require("crypto"));
+const runtime_1 = require("../nerves/runtime");
+exports.TOOL_LOOP_HISTORY_LIMIT = 30;
+exports.POLL_NO_PROGRESS_LIMIT = 3;
+exports.GENERIC_REPEAT_LIMIT = 4;
+exports.PING_PONG_WINDOW = 6;
+exports.GLOBAL_CIRCUIT_BREAKER_LIMIT = 24;
+function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    /* v8 ignore next -- stableStringify currently receives only objects/strings from normalized loop inputs @preserve */
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => stableStringify(entry)).join(",")}]`;
+    }
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(",")}}`;
+}
+function digest(value) {
+    return crypto.createHash("sha256").update(stableStringify(value)).digest("hex");
+}
+function normalizeArgs(toolName, args) {
+    if (toolName === "query_active_work") {
+        return { toolName };
+    }
+    if (toolName === "coding_status" || toolName === "coding_tail") {
+        return {
+            toolName,
+            sessionId: args.sessionId ?? "",
+        };
+    }
+    if (toolName === "query_session") {
+        return {
+            toolName,
+            mode: args.mode ?? "",
+            friendId: args.friendId ?? "",
+            channel: args.channel ?? "",
+            key: args.key ?? "",
+            query: args.query ?? "",
+        };
+    }
+    return {
+        toolName,
+        args,
+    };
+}
+function normalizeOutcome(result, success) {
+    return {
+        success,
+        result: result.replace(/\s+/g, " ").trim(),
+    };
+}
+function isKnownPollTool(toolName, args) {
+    return toolName === "query_active_work"
+        || toolName === "coding_status"
+        || toolName === "coding_tail"
+        || (toolName === "query_session" && (args.mode ?? "").trim() === "status");
+}
+function emitDetection(detector, toolName, count, message, pairedToolName) {
+    (0, runtime_1.emitNervesEvent)({
+        level: "warn",
+        component: "engine",
+        event: "engine.tool_loop_detected",
+        message: "tool loop guard detected repeated non-progress work",
+        meta: {
+            detector,
+            toolName,
+            count,
+            pairedToolName: pairedToolName ?? null,
+        },
+    });
+    return {
+        stuck: true,
+        detector,
+        count,
+        message,
+        pairedToolName,
+    };
+}
+function countTrailingRepeats(history, toolName, callHash) {
+    let count = 0;
+    let outcomeHash;
+    for (let index = history.length - 1; index >= 0; index--) {
+        const record = history[index];
+        if (record.toolName !== toolName || record.callHash !== callHash) {
+            break;
+        }
+        if (!outcomeHash) {
+            outcomeHash = record.outcomeHash;
+        }
+        if (record.outcomeHash !== outcomeHash) {
+            break;
+        }
+        count += 1;
+    }
+    return { count, outcomeHash };
+}
+function detectPingPong(history, toolName, callHash) {
+    if (history.length < exports.PING_PONG_WINDOW) {
+        return { stuck: false };
+    }
+    const recent = history.slice(-exports.PING_PONG_WINDOW);
+    const first = recent[0];
+    const second = recent[1];
+    if (!first.isKnownPoll || !second.isKnownPoll) {
+        return { stuck: false };
+    }
+    if (first.toolName === second.toolName && first.callHash === second.callHash) {
+        return { stuck: false };
+    }
+    for (let index = 0; index < recent.length; index++) {
+        const expected = index % 2 === 0 ? first : second;
+        const actual = recent[index];
+        if (actual.toolName !== expected.toolName
+            || actual.callHash !== expected.callHash
+            || actual.outcomeHash !== expected.outcomeHash) {
+            return { stuck: false };
+        }
+    }
+    const matchesPair = (toolName === first.toolName && callHash === first.callHash)
+        || (toolName === second.toolName && callHash === second.callHash);
+    if (!matchesPair) {
+        return { stuck: false };
+    }
+    const pairedToolName = toolName === first.toolName ? second.toolName : first.toolName;
+    return emitDetection("ping_pong", toolName, exports.PING_PONG_WINDOW, `repeated ${first.toolName}/${second.toolName} polling is not changing. stop cycling between status checks and either act on the current state, change approach, or answer truthfully with what is known.`, pairedToolName);
+}
+function createToolLoopState() {
+    return { history: [] };
+}
+function recordToolOutcome(state, toolName, args, result, success) {
+    state.history.push({
+        toolName,
+        callHash: digest(normalizeArgs(toolName, args)),
+        outcomeHash: digest(normalizeOutcome(result, success)),
+        isKnownPoll: isKnownPollTool(toolName, args),
+    });
+    if (state.history.length > exports.TOOL_LOOP_HISTORY_LIMIT) {
+        state.history.splice(0, state.history.length - exports.TOOL_LOOP_HISTORY_LIMIT);
+    }
+}
+// Tools that must never be blocked by the circuit breaker.
+// settle = end the turn, surface = deliver results outward.
+// ponder = continue thinking (inner dialog) or hand off to inner dialog (outer).
+// rest = end inner dialog turn (added in Unit 8b).
+// Blocking these traps the agent: it can think all it wants but can never speak or stop.
+const CIRCUIT_BREAKER_EXEMPT = new Set(["settle", "surface", "ponder", "rest"]);
+function detectToolLoop(state, toolName, args) {
+    if (state.history.length >= exports.GLOBAL_CIRCUIT_BREAKER_LIMIT && !CIRCUIT_BREAKER_EXEMPT.has(toolName)) {
+        return emitDetection("global_circuit_breaker", toolName, state.history.length, `this turn has already made ${state.history.length} tool calls. stop thrashing, use the current evidence, and either change approach or answer truthfully with the best grounded status.`);
+    }
+    const callHash = digest(normalizeArgs(toolName, args));
+    const trailing = countTrailingRepeats(state.history, toolName, callHash);
+    if (isKnownPollTool(toolName, args) && trailing.count >= exports.POLL_NO_PROGRESS_LIMIT) {
+        return emitDetection("known_poll_no_progress", toolName, trailing.count, `repeated ${toolName} calls have returned the same state ${trailing.count} times. stop polling and either act on the current state, wait for a meaningful change, or answer truthfully with what is known.`);
+    }
+    if (trailing.count >= exports.GENERIC_REPEAT_LIMIT) {
+        return emitDetection("generic_repeat", toolName, trailing.count, `repeating ${toolName} with the same inputs is not producing new information. change approach, use the evidence already gathered, or answer truthfully with what is known.`);
+    }
+    return detectPingPong(state.history, toolName, callHash);
+}

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("../arc/obligations");
+const target_resolution_1 = require("./target-resolution");
+const episodes_1 = require("../arc/episodes");
+const cares_1 = require("../arc/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,
+    };
+}