@ouro.bot/cli 0.1.0-alpha.720 → 0.1.0-alpha.721

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_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.721",
+      "changes": [
+        "Make Slugger context hydration and native habit traces inspectable and coverage-gated."
+      ]
+    },
     {
       "version": "0.1.0-alpha.720",
       "changes": [

package/dist/arc/flight-recorder.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isHabitRunTrigger = isHabitRunTrigger;
 exports.flightRecorderLatestPath = flightRecorderLatestPath;
+exports.decisionsFromHabitRunTraceSteps = decisionsFromHabitRunTraceSteps;
 exports.isFlightRecorderResume = isFlightRecorderResume;
 exports.readFlightRecorderResume = readFlightRecorderResume;
 exports.writeFlightRecorderResume = writeFlightRecorderResume;
@@ -86,6 +87,17 @@ function atomicWriteJson(filePath, value) {
 function cappedArray(values) {
     return values.map((value) => (0, session_events_1.capStructuredRecordString)(value));
 }
+function decisionsFromHabitRunTraceSteps(traceSteps = []) {
+    const decisions = [];
+    for (const step of traceSteps) {
+        for (const decision of step.decisions ?? []) {
+            const trimmed = decision.trim();
+            if (trimmed.length > 0)
+                decisions.push((0, session_events_1.capStructuredRecordString)(trimmed));
+        }
+    }
+    return uniqueStrings(decisions);
+}
 function normalizeEvent(input) {
     const recordedAt = input.recordedAt ?? new Date().toISOString();
     return {
@@ -604,6 +616,55 @@ function isHabitSurfaceAttemptArray(value) {
             && (entry.rawStatus === undefined || typeof entry.rawStatus === "string")
             && (entry.error === undefined || typeof entry.error === "string"));
 }
+function isHabitRunTraceStepKind(value) {
+    return value === "trigger"
+        || value === "habit_definition"
+        || value === "fetch"
+        || value === "snapshot"
+        || value === "render"
+        || value === "decision"
+        || value === "produced_ref"
+        || value === "surface_attempt"
+        || value === "send"
+        || value === "ledger"
+        || value === "error"
+        || value === "complete";
+}
+function isHabitRunTraceStepStatus(value) {
+    return value === "started"
+        || value === "succeeded"
+        || value === "skipped"
+        || value === "blocked"
+        || value === "failed";
+}
+function isHabitRunTraceRefArray(value) {
+    return Array.isArray(value)
+        && value.every((entry) => isPlainRecord(entry)
+            && typeof entry.kind === "string"
+            && entry.kind.trim().length > 0
+            && typeof entry.locator === "string"
+            && entry.locator.trim().length > 0
+            && (entry.label === undefined || typeof entry.label === "string"));
+}
+function isHabitRunTraceStepArray(value) {
+    return Array.isArray(value)
+        && value.every((entry) => isPlainRecord(entry)
+            && entry.schemaVersion === 1
+            && typeof entry.stepId === "string"
+            && entry.stepId.trim().length > 0
+            && isHabitRunTraceStepKind(entry.kind)
+            && isHabitRunTraceStepStatus(entry.status)
+            && typeof entry.at === "string"
+            && entry.at.trim().length > 0
+            && typeof entry.summary === "string"
+            && entry.summary.trim().length > 0
+            && (entry.refs === undefined || isHabitRunTraceRefArray(entry.refs))
+            && (entry.producedRefs === undefined || isProducedRefArray(entry.producedRefs))
+            && (entry.decisions === undefined || isStringArray(entry.decisions))
+            && (entry.surfaceAttempt === undefined || isHabitSurfaceAttemptArray([entry.surfaceAttempt]))
+            && (entry.error === undefined || typeof entry.error === "string")
+            && (entry.meta === undefined || isPlainRecord(entry.meta)));
+}
 function isHabitReturnRouteArray(value) {
     return Array.isArray(value)
         && value.every((entry) => isPlainRecord(entry)
@@ -633,10 +694,11 @@ function isHabitToolPolicy(value) {
         && typeof value.outwardMessagingAllowed === "boolean";
 }
 function defaultHabitRunSummarySnapshot(receipt) {
+    const decisions = decisionsFromHabitRunTraceSteps(receipt.traceSteps);
     if (receipt.errors.length > 0) {
         return {
             summary: `Habit ${receipt.habitName} finished with errors: ${receipt.errors.join("; ")}`,
-            decisions: [],
+            decisions,
             nextLikelyStep: null,
         };
     }
@@ -644,7 +706,7 @@ function defaultHabitRunSummarySnapshot(receipt) {
     if (surface) {
         return {
             summary: `Habit ${receipt.habitName} surfaced via ${surface.recipient}/${surface.channel}.`,
-            decisions: [],
+            decisions,
             nextLikelyStep: null,
         };
     }
@@ -652,13 +714,13 @@ function defaultHabitRunSummarySnapshot(receipt) {
     if (produced) {
         return {
             summary: `Habit ${receipt.habitName} produced ${produced.kind}: ${produced.locator}.`,
-            decisions: [],
+            decisions,
             nextLikelyStep: null,
         };
     }
     return {
         summary: `Habit ${receipt.habitName} finished with ${receipt.outcome}.`,
-        decisions: [],
+        decisions,
         nextLikelyStep: null,
     };
 }
@@ -674,7 +736,7 @@ function normalizeHabitRunSummarySnapshot(value, fallback) {
             : fallback.nextLikelyStep;
     return {
         summary: (0, session_events_1.capStructuredRecordString)(summary),
-        decisions: cappedArray(isStringArray(snapshot.decisions) ? snapshot.decisions : fallback.decisions),
+        decisions: cappedArray(isStringArray(snapshot.decisions) && snapshot.decisions.length > 0 ? snapshot.decisions : fallback.decisions),
         nextLikelyStep: nextLikelyStep === null ? null : (0, session_events_1.capStructuredRecordString)(nextLikelyStep),
     };
 }
@@ -711,6 +773,7 @@ function isHabitRunReceipt(value) {
         && (value.summarySnapshot === undefined || isPlainRecord(value.summarySnapshot))
         && isProducedRefArray(value.producedRefs)
         && isHabitSurfaceAttemptArray(value.surfaceAttempts)
+        && (value.traceSteps === undefined || isHabitRunTraceStepArray(value.traceSteps))
         && isStringArray(value.errors);
 }
 function isLegacyHabitRunReceipt(value) {
@@ -780,11 +843,53 @@ function normalizeLegacyHabitRunReceipt(receipt) {
         summarySnapshot: defaultHabitRunSummarySnapshot(receipt),
         producedRefs: receipt.producedRefs,
         surfaceAttempts: receipt.surfaceAttempts,
+        traceSteps: [],
         errors: receipt.errors,
     };
 }
+function capHabitRunTraceRefs(refs) {
+    if (!refs || refs.length === 0)
+        return undefined;
+    return refs.map((ref) => ({
+        kind: (0, session_events_1.capStructuredRecordString)(ref.kind),
+        locator: (0, session_events_1.capStructuredRecordString)(ref.locator),
+        ...(ref.label ? { label: (0, session_events_1.capStructuredRecordString)(ref.label) } : {}),
+    }));
+}
+function capHabitRunTraceStep(step) {
+    const refs = capHabitRunTraceRefs(step.refs);
+    const producedRefs = step.producedRefs?.map((ref) => ({ ...ref, locator: (0, session_events_1.capStructuredRecordString)(ref.locator) }));
+    const decisions = step.decisions ? cappedArray(step.decisions) : undefined;
+    const surfaceAttempt = step.surfaceAttempt
+        ? {
+            ...step.surfaceAttempt,
+            recipient: (0, session_events_1.capStructuredRecordString)(step.surfaceAttempt.recipient),
+            channel: (0, session_events_1.capStructuredRecordString)(step.surfaceAttempt.channel),
+            ...(step.surfaceAttempt.rawStatus ? { rawStatus: (0, session_events_1.capStructuredRecordString)(step.surfaceAttempt.rawStatus) } : {}),
+            ...(step.surfaceAttempt.error ? { error: (0, session_events_1.capStructuredRecordString)(step.surfaceAttempt.error) } : {}),
+        }
+        : undefined;
+    return {
+        schemaVersion: 1,
+        stepId: (0, session_events_1.capStructuredRecordString)(step.stepId),
+        kind: step.kind,
+        status: step.status,
+        at: (0, session_events_1.capStructuredRecordString)(step.at),
+        summary: (0, session_events_1.capStructuredRecordString)(step.summary),
+        ...(refs ? { refs } : {}),
+        ...(producedRefs && producedRefs.length > 0 ? { producedRefs } : {}),
+        ...(decisions && decisions.length > 0 ? { decisions } : {}),
+        ...(surfaceAttempt ? { surfaceAttempt } : {}),
+        ...(step.error ? { error: (0, session_events_1.capStructuredRecordString)(step.error) } : {}),
+        ...(step.meta ? { meta: (0, session_events_1.capStructuredRecordStringLeaves)(step.meta) } : {}),
+    };
+}
+function normalizeHabitRunTraceSteps(traceSteps) {
+    return (traceSteps ?? []).map((step) => capHabitRunTraceStep(step));
+}
 function capHabitRunReceipt(receipt) {
-    const fallbackSnapshot = defaultHabitRunSummarySnapshot(receipt);
+    const traceSteps = normalizeHabitRunTraceSteps(receipt.traceSteps);
+    const fallbackSnapshot = defaultHabitRunSummarySnapshot({ ...receipt, traceSteps });
     return {
         ...receipt,
         habitName: (0, session_events_1.capStructuredRecordString)(receipt.habitName),
@@ -822,6 +927,7 @@ function capHabitRunReceipt(receipt) {
             ...(attempt.rawStatus ? { rawStatus: (0, session_events_1.capStructuredRecordString)(attempt.rawStatus) } : {}),
             ...(attempt.error ? { error: (0, session_events_1.capStructuredRecordString)(attempt.error) } : {}),
         })),
+        traceSteps,
         errors: receipt.errors.map((error) => (0, session_events_1.capStructuredRecordString)(error)),
     };
 }

package/dist/heart/habits/habit-session.js

@@ -460,10 +460,11 @@ function computeNextRunAt(habit, endedAt) {
 }
 function defaultSummarySnapshot(input) {
     const errors = input.errors ?? [];
+    const decisions = (0, flight_recorder_1.decisionsFromHabitRunTraceSteps)(input.traceSteps);
     if (errors.length > 0) {
         return {
             summary: `Habit ${input.habit.name} finished with errors: ${errors.join("; ")}`,
-            decisions: [],
+            decisions,
             nextLikelyStep: null,
         };
     }
@@ -471,7 +472,7 @@ function defaultSummarySnapshot(input) {
     if (surfaced) {
         return {
             summary: `Habit ${input.habit.name} surfaced via ${surfaced.recipient}/${surfaced.channel}.`,
-            decisions: [],
+            decisions,
             nextLikelyStep: null,
         };
     }
@@ -479,13 +480,13 @@ function defaultSummarySnapshot(input) {
     if (produced) {
         return {
             summary: `Habit ${input.habit.name} produced ${produced.kind}: ${produced.locator}.`,
-            decisions: [],
+            decisions,
             nextLikelyStep: null,
         };
     }
     return {
         summary: `Habit ${input.habit.name} finished with ${input.outcome}.`,
-        decisions: [],
+        decisions,
         nextLikelyStep: null,
     };
 }
@@ -512,6 +513,7 @@ function buildHabitRunReceipt(input) {
         summarySnapshot: input.summarySnapshot ?? defaultSummarySnapshot(input),
         producedRefs: input.producedRefs ?? [],
         surfaceAttempts: input.surfaceAttempts ?? [],
+        traceSteps: input.traceSteps ?? [],
         errors: input.errors ?? [],
     };
     (0, runtime_1.emitNervesEvent)({
@@ -572,6 +574,7 @@ function completeHabitRun(input) {
             toolPolicy: input.toolPolicy,
             producedRefs,
             surfaceAttempts: input.surfaceAttempts,
+            traceSteps: input.traceSteps,
             errors: input.errors,
             summarySnapshot: input.summarySnapshot,
         });

package/dist/heart/mailbox/mailbox-http-hooks.js

@@ -86,6 +86,8 @@ function createMailboxHttpReadHooks(options) {
         readAgentHabitRun: options.readAgentHabitRun ?? ((agentName, runId) => (0, mailbox_read_1.readHabitRunReceiptView)(agentRoot(agentName), runId)),
         readAgentHabitRunSummaries: options.readAgentHabitRunSummaries ?? ((agentName, habitOptions) => (0, mailbox_read_1.readHabitSessionSummaryListView)(agentRoot(agentName), habitOptions)),
         readAgentHabitRunSummary: options.readAgentHabitRunSummary ?? ((agentName, selector) => (0, mailbox_read_1.readHabitSessionSummaryView)(agentRoot(agentName), selector)),
+        readAgentContextPackets: options.readAgentContextPackets ?? ((agentName, packetOptions) => (0, mailbox_read_1.readContextPacketListView)(agentRoot(agentName), packetOptions)),
+        readAgentContextPacket: options.readAgentContextPacket ?? ((agentName, packetId) => (0, mailbox_read_1.readContextPacketView)(agentRoot(agentName), packetId)),
         readAgentMail: options.readAgentMail ?? ((agentName) => (0, mailbox_read_1.readMailView)(agentName)),
         readAgentMailMessage: options.readAgentMailMessage ?? ((agentName, messageId) => (0, mailbox_read_1.readMailMessageView)(agentName, messageId)),
         readDaemonHealth: options.readDaemonHealth ?? (() => (0, mailbox_read_1.readDaemonHealthDeep)(options.healthPath)),

package/dist/heart/mailbox/mailbox-http-routes.js

@@ -321,6 +321,29 @@ async function handleAgentRoute(request, response, context) {
         (0, mailbox_http_response_1.writeJson)(response, 200, view);
         return;
     }
+    if (surface === "context-packets") {
+        const limit = parseHabitRunLimit(request.url);
+        if (limit === null) {
+            (0, mailbox_http_response_1.writeJson)(response, 400, { ok: false, error: "limit must be an integer between 1 and 100" });
+            return;
+        }
+        const view = limit === undefined
+            ? options.hooks.readAgentContextPackets(agent)
+            : options.hooks.readAgentContextPackets(agent, { limit });
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
+    if (surface.startsWith("context-packets/")) {
+        const rawPacketId = surface.slice("context-packets/".length);
+        const packetId = decodePathSegment(rawPacketId);
+        const view = packetId ? options.hooks.readAgentContextPacket(agent, packetId) : null;
+        if (!view) {
+            (0, mailbox_http_response_1.writeJson)(response, 404, { ok: false, error: `context packet '${rawPacketId}' not found` });
+            return;
+        }
+        (0, mailbox_http_response_1.writeJson)(response, 200, view);
+        return;
+    }
     if (surface === "mail") {
         (0, mailbox_http_response_1.writeJson)(response, 200, await options.hooks.readAgentMail(agent));
         return;

package/dist/heart/mailbox/mailbox-read.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readSelfFixView = exports.readMailboxContinuity = exports.readOrientationView = exports.readObligationDetailView = exports.readNoteDecisionView = exports.readSentinelView = exports.readContextLossGauntletView = exports.readChangesView = exports.readNeedsMeView = exports.readNotesView = exports.readLogView = exports.readHabitView = exports.readHabitRunView = exports.readHabitRunReceiptView = exports.readHabitSessionSummaryView = exports.readHabitSessionSummaryListView = exports.readFriendView = exports.readDeskPrefs = exports.readDaemonHealthDeep = exports.readCodingDeep = exports.readBridgeInventory = exports.readAttentionView = exports.readMailView = exports.readMailMessageView = exports.readSessionTranscript = exports.readSessionInventory = exports.readMailboxMachineState = exports.readMailboxAgentState = exports.readObligationSummary = void 0;
+exports.readSelfFixView = exports.readMailboxContinuity = exports.readOrientationView = exports.readObligationDetailView = exports.readNoteDecisionView = exports.readSentinelView = exports.readContextLossGauntletView = exports.readChangesView = exports.readNeedsMeView = exports.readNotesView = exports.readLogView = exports.readContextPacketView = exports.readContextPacketListView = exports.readHabitView = exports.readHabitRunView = exports.readHabitRunReceiptView = exports.readHabitSessionSummaryView = exports.readHabitSessionSummaryListView = exports.readFriendView = exports.readDeskPrefs = exports.readDaemonHealthDeep = exports.readCodingDeep = exports.readBridgeInventory = exports.readAttentionView = exports.readMailView = exports.readMailMessageView = exports.readSessionTranscript = exports.readSessionInventory = exports.readMailboxMachineState = exports.readMailboxAgentState = exports.readObligationSummary = void 0;
 var agent_machine_1 = require("./readers/agent-machine");
 Object.defineProperty(exports, "readObligationSummary", { enumerable: true, get: function () { return agent_machine_1.readObligationSummary; } });
 Object.defineProperty(exports, "readMailboxAgentState", { enumerable: true, get: function () { return agent_machine_1.readMailboxAgentState; } });
@@ -23,6 +23,8 @@ Object.defineProperty(exports, "readHabitSessionSummaryView", { enumerable: true
 Object.defineProperty(exports, "readHabitRunReceiptView", { enumerable: true, get: function () { return runtime_readers_1.readHabitRunReceiptView; } });
 Object.defineProperty(exports, "readHabitRunView", { enumerable: true, get: function () { return runtime_readers_1.readHabitRunView; } });
 Object.defineProperty(exports, "readHabitView", { enumerable: true, get: function () { return runtime_readers_1.readHabitView; } });
+Object.defineProperty(exports, "readContextPacketListView", { enumerable: true, get: function () { return runtime_readers_1.readContextPacketListView; } });
+Object.defineProperty(exports, "readContextPacketView", { enumerable: true, get: function () { return runtime_readers_1.readContextPacketView; } });
 Object.defineProperty(exports, "readLogView", { enumerable: true, get: function () { return runtime_readers_1.readLogView; } });
 Object.defineProperty(exports, "readNotesView", { enumerable: true, get: function () { return runtime_readers_1.readNotesView; } });
 Object.defineProperty(exports, "readNeedsMeView", { enumerable: true, get: function () { return runtime_readers_1.readNeedsMeView; } });

package/dist/heart/mailbox/readers/runtime-readers.js

@@ -35,6 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readCodingDeep = readCodingDeep;
 exports.readAttentionView = readAttentionView;
+exports.readContextPacketListView = readContextPacketListView;
+exports.readContextPacketView = readContextPacketView;
 exports.readBridgeInventory = readBridgeInventory;
 exports.readDaemonHealthDeep = readDaemonHealthDeep;
 exports.readNotesView = readNotesView;
@@ -56,6 +58,7 @@ const habit_session_summary_1 = require("../../habits/habit-session-summary");
 const identity_1 = require("../../identity");
 const daemon_health_1 = require("../../daemon/daemon-health");
 const flight_recorder_1 = require("../../../arc/flight-recorder");
+const context_packet_ledger_1 = require("../../../senses/context-packet-ledger");
 const shared_1 = require("./shared");
 const agent_machine_1 = require("./agent-machine");
 const sessions_1 = require("./sessions");
@@ -217,6 +220,12 @@ function readAttentionView(agentName, options = {}) {
         returnObligations,
     };
 }
+function readContextPacketListView(agentRoot, options = {}) {
+    return (0, context_packet_ledger_1.listSenseContextPacketSummaries)(agentRoot, options);
+}
+function readContextPacketView(agentRoot, packetId) {
+    return (0, context_packet_ledger_1.readSenseContextPacketView)(agentRoot, packetId);
+}
 /* v8 ignore start — defensive parsing */
 function readBridgeInventory(agentRoot) {
     const bridgesDir = path.join(agentRoot, "state", "bridges");

package/dist/rsvp/native-habit-runner.js

@@ -44,6 +44,7 @@ const run_ledger_1 = require("../heart/run-ledger");
 const spend_ledger_1 = require("./spend-ledger");
 const habit_policy_1 = require("./habit-policy");
 const runtime_1 = require("../nerves/runtime");
+const flight_recorder_1 = require("../arc/flight-recorder");
 function sha256Hex(input) {
     return (0, node_crypto_1.createHash)("sha256").update(input).digest("hex");
 }
@@ -127,13 +128,33 @@ function producedRefsFor(payload) {
     const snapshotId = stringField(refreshRecord(payload) ?? {}, "snapshotId");
     return snapshotId ? [{ kind: "none", locator: `state/rsvp/snapshots/${snapshotId}.json` }] : [];
 }
+function outboundAction(payload) {
+    const refresh = refreshRecord(payload);
+    const decision = refresh?.outboundDecision;
+    if (!decision || typeof decision !== "object" || Array.isArray(decision))
+        return "unknown";
+    return stringField(decision, "action") ?? "unknown";
+}
 function surfaceAttemptsFor(payload, requestedSend, errorMessage) {
     if (payload.sendAllowed === true) {
+        const delivery = (refreshRecord(payload)?.delivery ?? {});
+        const rawStatus = stringField(delivery, "status") ?? stringField(delivery, "result");
+        if (rawStatus === "failed" || rawStatus === "error") {
+            return [{
+                    recipient: "rsvp",
+                    channel: "bluebubbles",
+                    reason: "status",
+                    result: "failed",
+                    rawStatus,
+                    error: stringField(delivery, "error") ?? stringField(delivery, "message") ?? rawStatus,
+                }];
+        }
         return [{
                 recipient: "rsvp",
                 channel: "bluebubbles",
                 reason: "status",
                 result: "sent",
+                ...(rawStatus ? { rawStatus } : {}),
             }];
     }
     if (requestedSend && errorMessage) {
@@ -153,6 +174,140 @@ function payloadError(payload) {
     }
     return null;
 }
+function traceStatusForSurfaceAttempt(attempt) {
+    if (!attempt)
+        return "skipped";
+    if (attempt.result === "failed")
+        return "failed";
+    if (attempt.result === "blocked" || attempt.result === "unavailable")
+        return "blocked";
+    return "succeeded";
+}
+function nativeRsvpTraceSteps(input) {
+    const refresh = refreshRecord(input.payload);
+    const snapshotId = stringField(refresh ?? {}, "snapshotId");
+    const reportText = stringField(refresh ?? {}, "reportText");
+    const action = outboundAction(input.payload);
+    const firstAttempt = input.surfaceAttempts[0];
+    const snapshotLocator = snapshotId ? `state/rsvp/snapshots/${snapshotId}.json` : null;
+    const decisions = [
+        `mode=${input.mode}`,
+        `sendAllowed=${String(input.sendAllowed)}`,
+        `outboundAction=${action}`,
+    ];
+    return [
+        {
+            schemaVersion: 1,
+            stepId: "trigger",
+            kind: "trigger",
+            status: "succeeded",
+            at: input.startedAt,
+            summary: `${input.trigger} triggered ${input.habitName}.`,
+        },
+        {
+            schemaVersion: 1,
+            stepId: "habit-definition",
+            kind: "habit_definition",
+            status: "succeeded",
+            at: input.startedAt,
+            summary: `Loaded habit definition for ${input.habitName}.`,
+            refs: [{ kind: "habit_definition", locator: `habits/${input.habitName}.md`, label: input.habitName }],
+        },
+        {
+            schemaVersion: 1,
+            stepId: "fetch-refresh",
+            kind: "fetch",
+            status: input.errors.length > 0 ? "failed" : "succeeded",
+            at: input.endedAt,
+            summary: `Ran RSVP refresh in ${input.mode} mode.`,
+            refs: [{ kind: "source", locator: `rsvp/${input.source}` }],
+        },
+        {
+            schemaVersion: 1,
+            stepId: "snapshot",
+            kind: "snapshot",
+            status: snapshotLocator ? "succeeded" : "skipped",
+            at: input.endedAt,
+            summary: snapshotLocator ? "Recorded the RSVP snapshot reference." : "No RSVP snapshot reference was returned.",
+            ...(snapshotLocator ? { refs: [{ kind: "snapshot", locator: snapshotLocator }] } : {}),
+        },
+        {
+            schemaVersion: 1,
+            stepId: "render",
+            kind: "render",
+            status: reportText ? "succeeded" : "skipped",
+            at: input.endedAt,
+            summary: reportText ? "Rendered RSVP update text." : "No rendered RSVP update text was returned.",
+        },
+        {
+            schemaVersion: 1,
+            stepId: "decision",
+            kind: "decision",
+            status: input.errors.length > 0 ? "blocked" : "succeeded",
+            at: input.endedAt,
+            summary: `RSVP outbound decision: ${action}.`,
+            decisions,
+        },
+        {
+            schemaVersion: 1,
+            stepId: "produced-ref",
+            kind: "produced_ref",
+            status: input.producedRefs.length > 0 ? "succeeded" : "skipped",
+            at: input.endedAt,
+            summary: input.producedRefs.length > 0 ? "Recorded produced RSVP refs." : "No separate produced refs were recorded.",
+            ...(input.producedRefs.length > 0 ? { producedRefs: input.producedRefs } : {}),
+        },
+        {
+            schemaVersion: 1,
+            stepId: "surface-attempt",
+            kind: "surface_attempt",
+            status: traceStatusForSurfaceAttempt(firstAttempt),
+            at: input.endedAt,
+            summary: firstAttempt ? `Surface attempt ${firstAttempt.result} via ${firstAttempt.channel}.` : "No surface attempt was needed.",
+            ...(firstAttempt ? { surfaceAttempt: firstAttempt } : {}),
+        },
+        {
+            schemaVersion: 1,
+            stepId: "send",
+            kind: "send",
+            status: input.sendAllowed
+                ? traceStatusForSurfaceAttempt(firstAttempt)
+                : "skipped",
+            at: input.endedAt,
+            summary: input.sendAllowed ? "Live send was allowed for this run." : "Live send was not allowed for this run.",
+            ...(firstAttempt ? { surfaceAttempt: firstAttempt } : {}),
+        },
+        {
+            schemaVersion: 1,
+            stepId: "ledger",
+            kind: "ledger",
+            status: "succeeded",
+            at: input.endedAt,
+            summary: "Recorded native RSVP run ledger evidence.",
+            refs: [
+                { kind: "ledger", locator: "state/run-ledger/runs.jsonl" },
+                { kind: "ledger", locator: "state/rsvp/spend-ledger.json" },
+            ],
+        },
+        {
+            schemaVersion: 1,
+            stepId: "error",
+            kind: "error",
+            status: input.errors.length > 0 ? "failed" : "skipped",
+            at: input.endedAt,
+            summary: input.errors.length > 0 ? "RSVP refresh returned an error." : "No RSVP error happened.",
+            ...(input.errors[0] ? { error: input.errors[0] } : {}),
+        },
+        {
+            schemaVersion: 1,
+            stepId: "complete",
+            kind: "complete",
+            status: input.lifecycle === "completed" ? "succeeded" : "failed",
+            at: input.endedAt,
+            summary: `Native RSVP habit ${input.lifecycle}.`,
+        },
+    ];
+}
 function recordNativeRunLedger(input) {
     const target = {
         habitName: input.habitName,
@@ -247,6 +402,7 @@ async function runNativeRsvpHabit(input) {
     const lifecycle = errorMessage ? "error" : "completed";
     const surfaceAttempts = surfaceAttemptsFor(payload, policy.sendAllowed, errorMessage);
     const errors = errorMessage ? [errorMessage] : [];
+    const producedRefs = producedRefsFor(payload);
     recordNativeRunLedger({
         agentRoot,
         agent: input.agent,
@@ -258,6 +414,20 @@ async function runNativeRsvpHabit(input) {
         endedAt,
         lifecycle,
     });
+    const traceSteps = nativeRsvpTraceSteps({
+        habitName: input.habitName,
+        trigger: input.trigger,
+        mode: habit.rsvp.mode,
+        source: habit.rsvp.source,
+        sendAllowed: policy.sendAllowed,
+        startedAt,
+        endedAt,
+        payload,
+        producedRefs,
+        surfaceAttempts,
+        errors,
+        lifecycle,
+    });
     const completion = (0, habit_session_1.completeHabitRun)({
         agentRoot,
         habit,
@@ -268,17 +438,15 @@ async function runNativeRsvpHabit(input) {
         operationId: `rsvp-native:${input.trigger}:${input.occurrenceId ?? runId}`,
         permissionEnvelope: permissionEnvelope(policy.sendAllowed),
         toolPolicy: toolPolicy(policy.sendAllowed),
-        producedRefs: producedRefsFor(payload),
+        producedRefs,
         surfaceAttempts,
+        traceSteps,
         errors,
         summarySnapshot: {
             summary: errorMessage
                 ? `Native RSVP habit failed: ${errorMessage}`
                 : "Native RSVP habit completed.",
-            decisions: [
-                `mode=${habit.rsvp.mode}`,
-                `sendAllowed=${String(policy.sendAllowed)}`,
-            ],
+            decisions: (0, flight_recorder_1.decisionsFromHabitRunTraceSteps)(traceSteps),
             nextLikelyStep: null,
         },
     });

package/dist/senses/bluebubbles/context-packet.js

@@ -45,6 +45,23 @@ function messageToContextInput(event, chatGuidHash) {
         },
     };
 }
+function normalizeKnownMessageText(value) {
+    return value.replace(/\s+/g, " ").trim().toLowerCase();
+}
+function hasKnownMessageText(candidate, knownTexts) {
+    if (knownTexts.size === 0)
+        return false;
+    const body = normalizeKnownMessageText(candidate.textForAgent || candidate.text);
+    if (!body)
+        return true;
+    if (knownTexts.has(body))
+        return true;
+    for (const known of knownTexts) {
+        if (body.length >= 12 && known.includes(body))
+            return true;
+    }
+    return false;
+}
 async function buildBlueBubblesContextPacket(input) {
     if (!Number.isFinite(input.event.timestamp))
         return null;
@@ -53,6 +70,9 @@ async function buildBlueBubblesContextPacket(input) {
     const event = input.event;
     const chatGuidHash = blueBubblesContextChatKeyHash(event);
     const anchorTimestamp = new Date(event.timestamp).toISOString();
+    const knownTexts = new Set((input.knownMessageTexts ?? [])
+        .map(normalizeKnownMessageText)
+        .filter((value) => value.length > 0));
     const candidates = await input.client.listRecentMessages({
         beforeTimestamp: event.timestamp,
         limit: exports.BLUEBUBBLES_CONTEXT_PACKET_LIMIT,
@@ -65,7 +85,8 @@ async function buildBlueBubblesContextPacket(input) {
         .filter((candidate) => isSameBlueBubblesChat(candidate, event))
         .filter((candidate) => candidate.messageGuid !== event.messageGuid)
         .filter((candidate) => candidate.timestamp <= event.timestamp)
-        .filter((candidate) => event.timestamp - candidate.timestamp <= exports.BLUEBUBBLES_CONTEXT_PACKET_MAX_AGE_MS);
+        .filter((candidate) => event.timestamp - candidate.timestamp <= exports.BLUEBUBBLES_CONTEXT_PACKET_MAX_AGE_MS)
+        .filter((candidate) => !hasKnownMessageText(candidate, knownTexts));
     if (history.length === 0)
         return null;
     const packet = (0, context_packets_1.buildSenseContextPacket)({

package/dist/senses/bluebubbles/index.js

@@ -623,12 +623,18 @@ function insertEphemeralContextMessages(messages, contextMessages) {
         ...messages.slice(insertionIndex),
     ];
 }
+function knownProviderMessageTexts(messages) {
+    return messages
+        .map((message) => extractMessageText(message.content))
+        .map((text) => text.trim())
+        .filter((text) => text.length > 0);
+}
 async function buildBlueBubblesContextMessages(input) {
     if (input.event.kind !== "message")
-        return [];
+        return { messages: [], contextPacketIds: [] };
     const event = input.event;
     if (!Number.isFinite(event.timestamp))
-        return [];
+        return { messages: [], contextPacketIds: [] };
     const chatGuidHash = (0, context_packet_1.blueBubblesContextChatKeyHash)(event);
     const anchorTimestamp = new Date(event.timestamp).toISOString();
     try {
@@ -636,9 +642,10 @@ async function buildBlueBubblesContextMessages(input) {
             agentName: input.agentName,
             client: input.client,
             event,
+            knownMessageTexts: knownProviderMessageTexts(input.knownMessages ?? []),
         });
         if (!result)
-            return [];
+            return { messages: [], contextPacketIds: [] };
         const { packet, rendered, historyCount } = result;
         (0, context_packet_ledger_1.writeSenseContextPacket)(input.agentRoot, packet);
         (0, runtime_1.emitNervesEvent)({
@@ -651,7 +658,10 @@ async function buildBlueBubblesContextMessages(input) {
                 contextMessages: historyCount,
             },
         });
-        return [{ role: "system", content: rendered.text }];
+        return {
+            messages: [{ role: "system", content: rendered.text }],
+            contextPacketIds: [packet.packetId],
+        };
     }
     catch (error) {
         (0, runtime_1.emitNervesEvent)({
@@ -671,9 +681,12 @@ async function buildBlueBubblesContextMessages(input) {
             maxAgeMs: 24 * 60 * 60 * 1000,
         });
         if (!fallback)
-            return [];
+            return { messages: [], contextPacketIds: [] };
         const rendered = (0, context_packets_1.renderSenseContextPacketForPrompt)(fallback);
-        return [{ role: "system", content: rendered.text }];
+        return {
+            messages: [{ role: "system", content: rendered.text }],
+            contextPacketIds: [fallback.packetId],
+        };
     }
 }
 function createReplyTargetController(event) {
@@ -1468,6 +1481,10 @@ async function handleBlueBubblesNormalizedEvent(event, resolvedDeps, source, opt
                 if (typeof timeoutTimer.unref === "function") {
                     timeoutTimer.unref();
                 }
+                let preparedBlueBubblesContext = {
+                    messages: [],
+                    contextPacketIds: [],
+                };
                 const turnPromise = (0, pipeline_1.handleInboundTurn)({
                     channel: "bluebubbles",
                     sessionKey: event.chat.sessionKey,
@@ -1494,35 +1511,44 @@ async function handleBlueBubblesNormalizedEvent(event, resolvedDeps, source, opt
                     enforceTrustGate: trust_gate_1.enforceTrustGate,
                     drainPending: pending_1.drainPending,
                     drainDeferredReturns: (deferredFriendId) => (0, pending_1.drainDeferredReturns)(resolvedDeps.getAgentName(), deferredFriendId),
-                    runAgent: async (msgs, cb, channel, sig, opts) => {
-                        const contextMessages = await buildBlueBubblesContextMessages({
+                    prepareRunAgentOptions: async ({ messages, runAgentOptions }) => {
+                        preparedBlueBubblesContext = await buildBlueBubblesContextMessages({
                             agentName,
                             agentRoot: (0, identity_1.getAgentRoot)(),
                             client,
                             event,
+                            knownMessages: messages,
                         });
-                        return resolvedDeps.runAgent(insertEphemeralContextMessages(msgs, contextMessages), cb, channel, sig, {
-                            ...opts,
-                            toolContext: {
-                                /* v8 ignore next -- default no-op signin; pipeline provides the real one @preserve */
-                                signin: async () => undefined,
-                                ...opts?.toolContext,
-                                summarize,
-                                bluebubblesReplyTarget: {
-                                    setSelection: (selection) => replyTarget.setSelection(selection),
-                                },
-                                codingFeedback: {
-                                    send: async (message) => {
-                                        await client.sendText({
-                                            chat: event.chat,
-                                            text: message,
-                                            replyToMessageGuid: replyTarget.getReplyToMessageGuid(),
-                                        });
-                                    },
+                        if (preparedBlueBubblesContext.contextPacketIds.length === 0)
+                            return undefined;
+                        return {
+                            contextPacketIds: [
+                                ...(runAgentOptions.contextPacketIds ?? []),
+                                ...preparedBlueBubblesContext.contextPacketIds,
+                            ],
+                        };
+                    },
+                    runAgent: async (msgs, cb, channel, sig, opts) => resolvedDeps.runAgent(insertEphemeralContextMessages(msgs, preparedBlueBubblesContext.messages), cb, channel, sig, {
+                        ...opts,
+                        toolContext: {
+                            /* v8 ignore next -- default no-op signin; pipeline provides the real one @preserve */
+                            signin: async () => undefined,
+                            ...opts?.toolContext,
+                            summarize,
+                            bluebubblesReplyTarget: {
+                                setSelection: (selection) => replyTarget.setSelection(selection),
+                            },
+                            codingFeedback: {
+                                send: async (message) => {
+                                    await client.sendText({
+                                        chat: event.chat,
+                                        text: message,
+                                        replyToMessageGuid: replyTarget.getReplyToMessageGuid(),
+                                    });
                                 },
                             },
-                        });
-                    },
+                        },
+                    }),
                     postTurn: (turnMessages, sessionPathArg, usage, hooks, state) => {
                         const prepared = resolvedDeps.postTurnTrim(turnMessages, usage, hooks);
                         resolvedDeps.deferPostTurnPersist(sessionPathArg, prepared, usage, state);

package/dist/senses/context-packet-ledger.js

@@ -35,6 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeSenseContextPacket = writeSenseContextPacket;
 exports.readSenseContextLedger = readSenseContextLedger;
+exports.listSenseContextPacketSummaries = listSenseContextPacketSummaries;
+exports.readSenseContextPacketView = readSenseContextPacketView;
 exports.readLatestVisibleSenseContextPacket = readLatestVisibleSenseContextPacket;
 exports.compactSenseContextPacketReceipts = compactSenseContextPacketReceipts;
 const fs = __importStar(require("node:fs"));
@@ -44,6 +46,9 @@ const context_packets_1 = require("./context-packets");
 function contextPacketRoot(agentRoot, sense) {
     return path.join(agentRoot, "state", "senses", "context-packets", sense);
 }
+function contextPacketBaseRoot(agentRoot) {
+    return path.join(agentRoot, "state", "senses", "context-packets");
+}
 function packetPath(agentRoot, packet) {
     const month = packet.anchorTimestamp.slice(0, 7) || "unknown";
     return path.join(contextPacketRoot(agentRoot, packet.sense), month, `${packet.packetId}.json`);
@@ -181,6 +186,127 @@ function readSenseContextLedger(agentRoot, sense) {
     });
     return rows;
 }
+function safeContextPacketLimit(limit) {
+    return Number.isInteger(limit) && typeof limit === "number" && limit >= 1 && limit <= 100 ? limit : 20;
+}
+function discoverContextPacketSenses(agentRoot) {
+    const root = contextPacketBaseRoot(agentRoot);
+    if (!fs.existsSync(root))
+        return [];
+    return fs.readdirSync(root)
+        .filter((entry) => {
+        try {
+            return fs.statSync(path.join(root, entry)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
+function summarizeLedgerRow(row) {
+    return {
+        packetId: row.packetId,
+        sense: row.sense,
+        agent: row.agent,
+        chatKeyHash: row.chatKeyHash,
+        anchorMessageGuid: row.anchorMessageGuid,
+        anchorTimestamp: row.anchorTimestamp,
+        createdAt: row.createdAt,
+        messageCount: row.messageCount,
+        sourceRefs: row.sourceRefs,
+        bodyHashes: row.bodyHashes,
+        rawBodyStored: row.rawBodyStored,
+        privacyClass: row.privacyClass,
+        omittedMessages: row.omittedMessages,
+        truncatedMessages: row.truncatedMessages,
+    };
+}
+function readAllContextPacketRows(agentRoot, sense) {
+    const senses = sense ? [sense] : discoverContextPacketSenses(agentRoot);
+    return senses.flatMap((entry) => readSenseContextLedger(agentRoot, entry));
+}
+function timestampSortValue(value) {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function listSenseContextPacketSummaries(agentRoot, options = {}) {
+    const limit = safeContextPacketLimit(options.limit);
+    const rows = readAllContextPacketRows(agentRoot, options.sense)
+        .sort((left, right) => timestampSortValue(right.createdAt || right.anchorTimestamp) - timestampSortValue(left.createdAt || left.anchorTimestamp));
+    return {
+        totalCount: rows.length,
+        limit,
+        items: rows.slice(0, limit).map(summarizeLedgerRow),
+    };
+}
+function isSafeContextPacketId(packetId) {
+    return /^scp_[A-Za-z0-9_-]+$/.test(packetId);
+}
+function pathInsideContextPacketRoot(agentRoot, sense, filePath) {
+    const root = path.resolve(contextPacketRoot(agentRoot, sense));
+    const resolved = path.resolve(filePath);
+    return resolved === root || resolved.startsWith(`${root}${path.sep}`);
+}
+function redactPreview(value) {
+    return value
+        .replace(/\bpassword=[^\s]+/gi, "password=[redacted]")
+        .replace(/\b(token|api[_-]?key|secret)=[^\s]+/gi, "$1=[redacted]");
+}
+function viewMessage(message) {
+    const { chatGuid: _chatGuid, ...sourceRef } = message.sourceRef;
+    return {
+        timestamp: message.timestamp,
+        authorLabel: message.authorLabel,
+        bodyHash: message.bodyHash,
+        bodyPreview: redactPreview(message.bodyPreview),
+        sourceRef,
+        renderedSourceRef: message.renderedSourceRef,
+    };
+}
+function emitContextPacketReadWarning(packetId, reason) {
+    (0, runtime_1.emitNervesEvent)({
+        level: "warn",
+        component: "senses",
+        event: "senses.context_packet_read_error",
+        message: "failed to read sense context packet view",
+        meta: { packetId, reason },
+    });
+}
+function readSenseContextPacketView(agentRoot, packetId) {
+    if (!isSafeContextPacketId(packetId))
+        return null;
+    const row = readAllContextPacketRows(agentRoot).find((entry) => entry.packetId === packetId);
+    if (!row)
+        return null;
+    if (!pathInsideContextPacketRoot(agentRoot, row.sense, row.packetPath)) {
+        emitContextPacketReadWarning(packetId, "packet path escaped context-packet root");
+        return null;
+    }
+    if (!fs.existsSync(row.packetPath))
+        return null;
+    try {
+        const packet = JSON.parse(fs.readFileSync(row.packetPath, "utf-8"));
+        if (packet.packetId !== packetId || !Array.isArray(packet.messages))
+            return null;
+        return {
+            row: summarizeLedgerRow(row),
+            packet: {
+                packetId,
+                sense: typeof packet.sense === "string" ? packet.sense : row.sense,
+                agent: typeof packet.agent === "string" ? packet.agent : row.agent,
+                privacyClass: packet.privacyClass === "private-runtime" ? packet.privacyClass : "private-runtime",
+                messages: packet.messages.map((message) => viewMessage(message)),
+                omittedMessages: typeof packet.omittedMessages === "number" ? packet.omittedMessages : row.omittedMessages,
+                truncatedMessages: typeof packet.truncatedMessages === "number" ? packet.truncatedMessages : row.truncatedMessages,
+            },
+        };
+    }
+    catch (error) {
+        emitContextPacketReadWarning(packetId, error instanceof Error ? error.message : String(error));
+        return null;
+    }
+}
 function timestampMs(value) {
     return Date.parse(value);
 }

package/dist/senses/pipeline.js

@@ -369,6 +369,36 @@ let _lastSessionKey = null;
 function runAgentOptionContextPacketIds(options) {
     return Array.isArray(options.contextPacketIds) ? options.contextPacketIds : [];
 }
+function mergeRunAgentContextPacketIds(left, right) {
+    const merged = [
+        ...(Array.isArray(left) ? left : []),
+        ...(Array.isArray(right) ? right : []),
+    ].filter((value) => typeof value === "string" && value.trim().length > 0);
+    return merged.length > 0 ? [...new Set(merged)] : undefined;
+}
+function mergePreparedRunAgentOptions(base, prepared) {
+    if (!prepared)
+        return base;
+    const contextPacketIds = mergeRunAgentContextPacketIds(base.contextPacketIds, prepared.contextPacketIds);
+    const { contextPacketIds: _baseContextPacketIds, ...baseOptions } = base;
+    const { contextPacketIds: _preparedContextPacketIds, ...preparedOptions } = prepared;
+    const merged = {
+        ...baseOptions,
+        ...preparedOptions,
+        ...(contextPacketIds ? { contextPacketIds } : {}),
+    };
+    if (prepared.toolContext) {
+        const toolContext = {
+            ...base.toolContext,
+            ...prepared.toolContext,
+        };
+        merged.toolContext = {
+            ...toolContext,
+            signin: toolContext.signin ?? (async () => undefined),
+        };
+    }
+    return merged;
+}
 function buildInboundRunLedgerInput(input) {
     const target = {
         channel: input.channel,
@@ -822,7 +852,7 @@ async function handleInboundTurn(input) {
         const existingToolContext = input.runAgentOptions?.toolContext;
         const currentUserMessage = existingToolContext?.currentUserMessage
             ?? latestUserAuthoredText(input.messages, input.continuityIngressTexts);
-        const runAgentOptions = {
+        let runAgentOptions = {
             ...input.runAgentOptions,
             ...(orientationFrame ? { orientationFrame } : {}),
             ...(liveLatencyMode ? { skipKeptNotes: true } : {}),
@@ -856,6 +886,12 @@ async function handleInboundTurn(input) {
                 ...(orientationFrame ? { orientationFrame } : {}),
             },
         };
+        runAgentOptions = mergePreparedRunAgentOptions(runAgentOptions, await input.prepareRunAgentOptions?.({
+            messages: sessionMessages,
+            currentUserMessages,
+            resolvedContext,
+            runAgentOptions,
+        }));
         const runLedger = prepareInboundRunLedger({
             channel: input.channel,
             senseType: input.capabilities.senseType,

package/package.json

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