@ouro.bot/cli 0.1.0-alpha.657 → 0.1.0-alpha.659

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.657",
+  "version": "0.1.0-alpha.659",
   "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