@ouro.bot/cli 0.1.0-alpha.655 → 0.1.0-alpha.658

package/dist/senses/inner-dialog.js

@@ -73,11 +73,12 @@ 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 flight_recorder_1 = require("../arc/flight-recorder");
+const desk_section_1 = require("../mind/desk-section");
 const DEFAULT_INNER_DIALOG_INSTINCTS = [
     {
         id: "heartbeat_checkin",
@@ -627,6 +628,20 @@ function buildAlsoDueLine(agentRoot, currentHabitName, now) {
         return "";
     return `also due: ${alsoDue.join(", ")}`;
 }
+function buildHabitSurfacePolicy(origin, surface) {
+    const lines = ["## habit surface policy"];
+    lines.push("this habit runs privately, but it may message outward when it needs input, has a useful answer, is blocked, or should report status.");
+    if (surface.family)
+        lines.push("- family recipients are allowed by default.");
+    if (surface.originator && origin)
+        lines.push(`- the originator is allowed: ${origin.friendId} via ${origin.channel}/${origin.key}.`);
+    if (surface.originator && !origin)
+        lines.push("- originator messaging is enabled, but this habit has no origin metadata.");
+    if (surface.extra.length > 0)
+        lines.push(`- extra allowed recipients: ${surface.extra.join(", ")}.`);
+    lines.push("- use send_message for intentional contact; use surface only for a held return tied to an existing return obligation.");
+    return lines.join("\n");
+}
 async function runInnerDialogTurn(options) {
     const now = options?.now ?? (() => new Date());
     const reason = options?.reason ?? "instinct";
@@ -681,6 +696,8 @@ async function runInnerDialogTurn(options) {
                 let habitBody;
                 let habitTitle = habitName;
                 let habitLastRun = null;
+                let habitOrigin = null;
+                let habitSurface = { family: true, originator: true, extra: [] };
                 try {
                     const habitContent = fs.readFileSync(habitFilePath, "utf-8");
                     const parsed = (0, habit_runtime_state_1.applyHabitRuntimeState)(agentRoot, (0, habit_parser_1.parseHabitFile)(habitContent, habitFilePath));
@@ -688,6 +705,8 @@ async function runInnerDialogTurn(options) {
                     habitTitle = parsed.title || habitName;
                     habitLastRun = parsed.lastRun;
                     habitTools = parsed.tools;
+                    habitOrigin = parsed.origin;
+                    habitSurface = parsed.surface;
                 }
                 catch {
                     // Habit file missing or unreadable
@@ -707,6 +726,9 @@ async function runInnerDialogTurn(options) {
                         stalenessMs: nowMs - o.createdAt,
                     }));
                     const alsoDue = buildAlsoDueLine(agentRoot, habitName, now);
+                    const arcResume = (0, flight_recorder_1.formatFlightRecorderResume)((0, flight_recorder_1.readFlightRecorderResume)(agentRoot));
+                    const deskOrientation = (0, desk_section_1.deskRecordOrientationSection)(agentRoot, now());
+                    const surfacePolicy = buildHabitSurfacePolicy(habitOrigin, habitSurface);
                     // Degraded state (best-effort: never crash)
                     let degradedComponents = [];
                     try {
@@ -728,17 +750,11 @@ async function runInnerDialogTurn(options) {
                         staleObligations,
                         parseErrors: options?.parseErrors ?? [],
                         degradedComponents,
+                        arcResume,
+                        deskOrientation,
+                        surfacePolicy,
                         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) {
@@ -827,7 +843,10 @@ async function runInnerDialogTurn(options) {
                     };
                 }
                 // Fresh session: build system prompt
-                const systemPrompt = await (0, prompt_1.buildSystem)("inner", { toolChoiceRequired: true });
+                const systemPrompt = await (0, prompt_1.buildSystem)("inner", {
+                    toolChoiceRequired: true,
+                    flightRecorderResume: (0, flight_recorder_1.readFlightRecorderResume)((0, identity_1.getAgentRoot)()),
+                });
                 return {
                     messages: [{ role: "system", content: (0, prompt_1.flattenSystemPrompt)(systemPrompt) }],
                     sessionPath: sessionFilePath,

package/dist/senses/pipeline.js

@@ -52,6 +52,8 @@ const socket_client_1 = require("../heart/daemon/socket-client");
 const active_work_1 = require("../heart/active-work");
 const delegation_1 = require("../heart/delegation");
 const obligations_1 = require("../arc/obligations");
+const packets_1 = require("../arc/packets");
+const evolution_1 = require("../arc/evolution");
 const provider_failover_1 = require("../heart/provider-failover");
 const openai_codex_token_1 = require("../heart/providers/openai-codex-token");
 const tempo_1 = require("../heart/tempo");
@@ -66,7 +68,16 @@ const episodes_1 = require("../arc/episodes");
 const turn_context_1 = require("../heart/turn-context");
 const provider_visibility_1 = require("../heart/provider-visibility");
 const orientation_frame_1 = require("../heart/orientation-frame");
+const flight_recorder_1 = require("../arc/flight-recorder");
 const VOICE_PENDING_MAX_AGE_MS = 15 * 60 * 1_000;
+const ACTIVE_FLIGHT_RECORDER_PACKET_STATUSES = new Set([
+    "drafting",
+    "processing",
+    "validating",
+    "collaborating",
+    "paused",
+    "blocked",
+]);
 function pendingExpirationReason(channel, message, now) {
     /* v8 ignore start -- pending expiry edge permutations are covered by the stale voice queue tests; this helper keeps defensive non-voice fallbacks @preserve */
     if (Number.isFinite(message.expiresAt) && Number(message.expiresAt) <= now)
@@ -198,6 +209,65 @@ function latestUserAuthoredText(messages, continuityIngressTexts) {
         .filter(Boolean);
     return userMessages[userMessages.length - 1];
 }
+function sessionRefForFlightRecorder(session) {
+    return `${session.friendId}/${session.channel}/${session.key}`;
+}
+function isTerminalWithoutContinuation(outcome, hasActiveContinuation) {
+    return !hasActiveContinuation && (outcome === "settled"
+        || outcome === "observed"
+        || outcome === "rested"
+        || outcome === "superseded");
+}
+function readPostTurnFlightRecorderArcSnapshot(agentRoot) {
+    const latest = (0, flight_recorder_1.readFlightRecorderResume)(agentRoot);
+    return {
+        activeObligationIds: (0, obligations_1.readPendingObligations)(agentRoot).map((obligation) => obligation.id),
+        activeReturnObligationIds: (0, obligations_1.listActiveReturnObligationsForRoot)(agentRoot).map((obligation) => obligation.id),
+        activePacketIds: (0, packets_1.listPonderPackets)(agentRoot)
+            .filter((packet) => ACTIVE_FLIGHT_RECORDER_PACKET_STATUSES.has(packet.status))
+            .map((packet) => packet.id),
+        openEvolutionCaseIds: (0, evolution_1.listOpenEvolutionCases)(agentRoot).map((evolutionCase) => evolutionCase.id),
+        recentClaimIds: latest.recentClaimIds,
+        unverifiedClaimIds: latest.unverifiedClaimIds,
+    };
+}
+function recordPostTurnFlightRecorderCheckpoint(input) {
+    const hasActiveContinuation = input.mustResolveBeforeHandoff
+        || input.activeObligationIds.length > 0
+        || input.activeReturnObligationIds.length > 0
+        || input.activePacketIds.length > 0
+        || input.openEvolutionCaseIds.length > 0;
+    const blockedBecause = [
+        ...(input.outcome === "blocked" ? ["agent reported a blocker in this turn"] : []),
+        ...(input.outcome === "errored" ? ["turn errored before a safe continuation was reached"] : []),
+        ...(input.outcome === "aborted" ? ["turn aborted before a safe continuation was reached"] : []),
+        ...(isTerminalWithoutContinuation(input.outcome, hasActiveContinuation) ? [`turn outcome ${input.outcome}; wait for new input before acting`] : []),
+    ];
+    const nextSafeAction = input.nextSafeAction
+        ?? (blockedBecause.length > 0
+            ? "inspect the latest session and wait for new input before acting"
+            : "continue the current held work and update Arc/Desk with the next checkpoint");
+    (0, flight_recorder_1.recordFlightRecorderEvent)(input.agentRoot, {
+        kind: "post_turn_persisted",
+        sessionRef: sessionRefForFlightRecorder(input.currentSession),
+        summary: `persisted ${input.currentSession.channel}/${input.currentSession.key} turn with outcome ${input.outcome}`,
+        currentAsk: input.currentAsk,
+        nextSafeAction,
+        blockedBecause,
+        stopBefore: blockedBecause.length > 0 ? ["acting on stale context"] : [],
+        activeObligationIds: input.activeObligationIds,
+        activeReturnObligationIds: input.activeReturnObligationIds,
+        activePacketIds: input.activePacketIds,
+        openEvolutionCaseIds: input.openEvolutionCaseIds,
+        recentClaimIds: input.recentClaimIds,
+        unverifiedClaimIds: input.unverifiedClaimIds,
+        meta: {
+            outcome: input.outcome,
+            mustResolveBeforeHandoff: input.mustResolveBeforeHandoff,
+            sessionPath: input.currentSession.sessionPath,
+        },
+    });
+}
 function resolveCurrentFailoverBinding(agentName, lane) {
     const agentRoot = (0, identity_1.getAgentRoot)();
     const { config: agentConfig } = (0, auth_flow_1.readAgentConfigForAgent)(agentName, path.dirname(agentRoot));
@@ -643,6 +713,7 @@ async function handleInboundTurn(input) {
                     all: activeWorkFrame.pendingObligations,
                 },
                 currentSessionTiming,
+                flightRecorderResume: ctx.flightRecorderResume,
             });
             /* v8 ignore next 3 -- syncFailure propagation tested in sync.test.ts @preserve */
             if (syncFailure) {
@@ -708,7 +779,7 @@ async function handleInboundTurn(input) {
             senseStatusLines: ctx.senseStatusLines,
             bundleMeta: ctx.bundleMeta,
             daemonHealth: ctx.daemonHealth,
-            journalFiles: ctx.journalFiles,
+            flightRecorderResume: ctx.flightRecorderResume,
             ...(ctx.providerVisibility ? { providerVisibility: ctx.providerVisibility } : {}),
             toolContext: {
                 /* v8 ignore next -- default no-op signin satisfies interface; real signin injected by sense adapter @preserve */
@@ -738,6 +809,36 @@ async function handleInboundTurn(input) {
                 result.error?.message ?? "unknown error", classification, currentProvider, currentBinding.model, agentName, inventory, {}, { currentLane });
                 input.failoverState.pending = failoverContext;
                 input.postTurn(sessionMessages, session.sessionPath, result.usage);
+                try {
+                    const postTurnArc = readPostTurnFlightRecorderArcSnapshot((0, identity_1.getAgentRoot)());
+                    recordPostTurnFlightRecorderCheckpoint({
+                        agentRoot: (0, identity_1.getAgentRoot)(),
+                        currentSession,
+                        currentAsk: currentObligation
+                            ?? activeWorkFrame.primaryObligation?.content?.trim()
+                            ?? currentUserMessage
+                            ?? null,
+                        nextSafeAction: failoverContext.userMessage,
+                        outcome: "errored",
+                        mustResolveBeforeHandoff,
+                        activeObligationIds: postTurnArc.activeObligationIds,
+                        activeReturnObligationIds: postTurnArc.activeReturnObligationIds,
+                        activePacketIds: postTurnArc.activePacketIds,
+                        openEvolutionCaseIds: postTurnArc.openEvolutionCaseIds,
+                        recentClaimIds: postTurnArc.recentClaimIds,
+                        unverifiedClaimIds: postTurnArc.unverifiedClaimIds,
+                    });
+                }
+                catch (checkpointError) {
+                    /* v8 ignore next -- best-effort recorder write must not hide provider-failover guidance @preserve */
+                    (0, runtime_1.emitNervesEvent)({
+                        level: "warn",
+                        component: "senses",
+                        event: "senses.flight_recorder_checkpoint_error",
+                        message: "failed to record provider-failover flight recorder checkpoint",
+                        meta: { error: checkpointError instanceof Error ? checkpointError.message : String(checkpointError) },
+                    });
+                }
                 return {
                     resolvedContext,
                     gateResult,
@@ -781,6 +882,39 @@ async function handleInboundTurn(input) {
                 : undefined)
             : (Object.keys(continuingState).length > 0 ? continuingState : undefined);
         input.postTurn(sessionMessages, session.sessionPath, result.usage, undefined, nextState);
+        try {
+            const agentRoot = (0, identity_1.getAgentRoot)();
+            const postTurnArc = readPostTurnFlightRecorderArcSnapshot(agentRoot);
+            recordPostTurnFlightRecorderCheckpoint({
+                agentRoot,
+                currentSession,
+                currentAsk: currentObligation
+                    ?? activeWorkFrame.primaryObligation?.content?.trim()
+                    ?? currentUserMessage
+                    ?? null,
+                nextSafeAction: activeWorkFrame.resumeHandle?.nextAction
+                    ?? activeWorkFrame.primaryObligation?.nextAction?.trim()
+                    ?? null,
+                outcome: result.outcome ?? "observed",
+                mustResolveBeforeHandoff,
+                activeObligationIds: postTurnArc.activeObligationIds,
+                activeReturnObligationIds: postTurnArc.activeReturnObligationIds,
+                activePacketIds: postTurnArc.activePacketIds,
+                openEvolutionCaseIds: postTurnArc.openEvolutionCaseIds,
+                recentClaimIds: postTurnArc.recentClaimIds,
+                unverifiedClaimIds: postTurnArc.unverifiedClaimIds,
+            });
+        }
+        catch (error) {
+            /* v8 ignore next -- defensive recorder failures are non-fatal to already-persisted user turns @preserve */
+            (0, runtime_1.emitNervesEvent)({
+                level: "warn",
+                component: "senses",
+                event: "senses.flight_recorder_checkpoint_error",
+                message: "failed to record post-turn flight recorder checkpoint",
+                meta: { error: error instanceof Error ? error.message : String(error) },
+            });
+        }
         // Step 7: Token accumulation
         await input.accumulateFriendTokens(input.friendStore, resolvedContext.friend.id, result.usage);
         (0, runtime_1.emitNervesEvent)({

package/dist/util/frontmatter.js

@@ -17,6 +17,10 @@ function parseScalar(raw) {
     const value = raw.trim();
     if (value === "null")
         return null;
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
     if (value === "[]")
         return [];
     if ((value.startsWith("\"") && value.endsWith("\"")) || (value.startsWith("'") && value.endsWith("'"))) {
@@ -46,7 +50,19 @@ function parseFrontmatter(raw) {
             items.push(parseScalar(lines[cursor].replace(/^\s*-\s+/, "")));
             cursor += 1;
         }
-        frontmatter[key] = items;
+        if (items.length > 0) {
+            frontmatter[key] = items;
+            idx = cursor - 1;
+            continue;
+        }
+        const nested = {};
+        cursor = idx + 1;
+        while (cursor < lines.length && /^\s+[A-Za-z0-9_:-]+:\s*/.test(lines[cursor])) {
+            const child = /^\s+([A-Za-z0-9_:-]+):\s*(.*)$/.exec(lines[cursor]);
+            nested[child[1]] = parseScalar(child[2]);
+            cursor += 1;
+        }
+        frontmatter[key] = Object.keys(nested).length > 0 ? nested : items;
         idx = cursor - 1;
     }
     return frontmatter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.655",
+  "version": "0.1.0-alpha.658",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",
@@ -79,12 +79,12 @@
     "@types/mailparser": "^3.4.6",
     "@types/semver": "^7.7.1",
     "@types/smtp-server": "^3.5.13",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/coverage-v8": "^4.1.8",
     "eslint": "^10.0.2",
     "jsdom": "^29.0.2",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.56.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.8"
   },
   "overrides": {
     "@microsoft/teams.apps": {

package/skills/configure-dev-tools.md

@@ -64,7 +64,7 @@ Once connected, these tools are available:
 - **status** -- Get agent's current status and activity
 - **catchup** -- Get recent activity summary
 - **get_context** -- Get agent's current working context
-- **search_notes** -- Read-only note search for specific topics; missing hits are not evidence that the agent has no belief or preference
+- **search_facts** -- Read-only Desk record fact search for specific topics; missing hits are not evidence that the agent has no belief or preference
 - **get_task** -- Get details of the agent's current task
 
 ## Troubleshooting

package/skills/travel-planning.md

@@ -92,7 +92,7 @@ an interactive sign-up flow.
 
 ### Post-Booking
 - Save confirmation details (confirmation number, dates, hotel name, airline, booking reference)
-- Save to diary/journal for future reference
+- Save durable travel facts to the Desk record diary or notes for future reference
 - Set reminders for check-in windows
 - Note cancellation deadlines
 

package/dist/mind/journal-index.js

@@ -1,162 +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.indexJournalFiles = indexJournalFiles;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const session_events_1 = require("../heart/session-events");
-const runtime_1 = require("../nerves/runtime");
-const TEXT_EXTENSIONS = new Set([".md", ".txt"]);
-const PREVIEW_CHAR_LIMIT = 500;
-function readExistingIndex(indexPath) {
-    try {
-        const raw = fs.readFileSync(indexPath, "utf8");
-        const parsed = JSON.parse(raw);
-        if (!Array.isArray(parsed))
-            return [];
-        return parsed;
-    }
-    catch {
-        return [];
-    }
-}
-function extractPreview(content) {
-    const trimmed = content.trim();
-    if (!trimmed)
-        return "";
-    return trimmed.split("\n")[0].replace(/^#+\s*/, "").trim();
-}
-async function indexJournalFiles(journalDir, indexPath, embedProvider) {
-    // Read existing index
-    const existingIndex = readExistingIndex(indexPath);
-    const indexMap = new Map();
-    for (const entry of existingIndex) {
-        indexMap.set(entry.filename, entry);
-    }
-    // Scan journal dir for text files
-    let dirEntries;
-    try {
-        dirEntries = fs.readdirSync(journalDir, { withFileTypes: true });
-    }
-    catch {
-        (0, runtime_1.emitNervesEvent)({
-            component: "mind",
-            event: "mind.journal_index_scan",
-            message: "journal dir not found or unreadable",
-            meta: { journalDir },
-        });
-        return 0;
-    }
-    const textFiles = dirEntries.filter((entry) => {
-        if (!entry.isFile())
-            return false;
-        if (entry.name.startsWith("."))
-            return false;
-        const ext = path.extname(entry.name).toLowerCase();
-        return TEXT_EXTENSIONS.has(ext);
-    });
-    if (textFiles.length === 0) {
-        (0, runtime_1.emitNervesEvent)({
-            component: "mind",
-            event: "mind.journal_index_scan",
-            message: "no text files found in journal",
-            meta: { journalDir },
-        });
-        return 0;
-    }
-    let newlyIndexed = 0;
-    for (const file of textFiles) {
-        const filePath = path.join(journalDir, file.name);
-        let stat;
-        try {
-            stat = fs.statSync(filePath);
-        }
-        catch {
-            /* v8 ignore next -- filesystem race: file deleted between readdir and stat @preserve */
-            continue;
-        }
-        // Check if already indexed with same mtime
-        const existing = indexMap.get(file.name);
-        if (existing && existing.mtime === stat.mtimeMs) {
-            continue;
-        }
-        // Read content for embedding
-        let content;
-        try {
-            content = fs.readFileSync(filePath, "utf8");
-        }
-        catch {
-            /* v8 ignore next -- filesystem race: file deleted between stat and read @preserve */
-            continue;
-        }
-        const preview = (0, session_events_1.capStructuredRecordString)(extractPreview(content));
-        const embedText = content.slice(0, PREVIEW_CHAR_LIMIT);
-        // Generate embedding
-        let embedding;
-        try {
-            const vectors = await embedProvider.embed([embedText]);
-            embedding = vectors[0] ?? [];
-        }
-        catch {
-            (0, runtime_1.emitNervesEvent)({
-                level: "warn",
-                component: "mind",
-                event: "mind.journal_embedding_error",
-                message: "embedding failed for journal file",
-                meta: { filename: file.name },
-            });
-            embedding = [];
-        }
-        indexMap.set(file.name, {
-            filename: file.name,
-            embedding,
-            mtime: stat.mtimeMs,
-            preview,
-        });
-        newlyIndexed++;
-    }
-    // Write updated index back
-    if (newlyIndexed > 0) {
-        const updatedIndex = Array.from(indexMap.values());
-        fs.writeFileSync(indexPath, JSON.stringify(updatedIndex, null, 2), "utf8");
-    }
-    (0, runtime_1.emitNervesEvent)({
-        component: "mind",
-        event: "mind.journal_index_complete",
-        message: "journal indexing complete",
-        meta: { journalDir, newlyIndexed, total: indexMap.size },
-    });
-    return newlyIndexed;
-}