@ouro.bot/cli 0.1.0-alpha.695 → 0.1.0-alpha.697

package/changelog.json

@@ -1,6 +1,21 @@
 {
   "_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.697",
+      "changes": [
+        "Add BlueBubbles same-thread context, native RSVP habit, autonomy budgets, run ledger attribution, diagnostics, cutover, and verification guardrails.",
+        "Harden Twilio phone agent-root resolution so test and runtime callers use explicit bundle roots without falling back to the host AgentBundles tree.",
+        "Gate native RSVP live sends on a current passing legacy cutover check so refreshes and smoke tests cannot compete with the old RSVP sender.",
+        "Align RSVP doctor cutover preflight with the native config's legacy root so triage reports the same sender state enforced by live sends."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.696",
+      "changes": [
+        "Prevent completed return-work packets from re-entering active Arc state."
+      ]
+    },
     {
       "version": "0.1.0-alpha.695",
       "changes": [

package/dist/arc/flight-recorder.js

@@ -51,6 +51,7 @@ const crypto_1 = require("crypto");
 const session_events_1 = require("../heart/session-events");
 const runtime_1 = require("../nerves/runtime");
 const obligations_1 = require("./obligations");
+const packets_1 = require("./packets");
 function isHabitRunTrigger(value) {
     return value === "cron"
         || value === "launchd"
@@ -235,10 +236,16 @@ function remainingArcWorkDescriptions(resume) {
         ...resume.openEvolutionCaseIds.map((id) => `evolution case ${id}`),
     ];
 }
-function nextSafeActionAfterObligationReconcile(resume, activeObligations, staleActiveObligationIds, unverifiableActiveObligationIds) {
+function nextSafeActionAfterObligationReconcile(resume, activeObligations, staleActiveObligationIds, unverifiableActiveObligationIds, staleActiveReturnObligationIds, unverifiableActiveReturnObligationIds, staleActivePacketIds, unverifiableActivePacketIds) {
     if (unverifiableActiveObligationIds.length > 0) {
         return (0, session_events_1.capStructuredRecordString)(`inspect unverifiable active obligations before acting: ${unverifiableActiveObligationIds.join(", ")}`);
     }
+    if (unverifiableActiveReturnObligationIds.length > 0) {
+        return (0, session_events_1.capStructuredRecordString)(`inspect unverifiable active return obligations before acting: ${unverifiableActiveReturnObligationIds.join(", ")}`);
+    }
+    if (unverifiableActivePacketIds.length > 0) {
+        return (0, session_events_1.capStructuredRecordString)(`inspect unverifiable active packets before acting: ${unverifiableActivePacketIds.join(", ")}`);
+    }
     const firstActive = activeObligations[0];
     if (firstActive) {
         const detail = firstActive.nextAction?.trim() || firstActive.content;
@@ -248,11 +255,56 @@ function nextSafeActionAfterObligationReconcile(resume, activeObligations, stale
     if (remainingWork.length > 0) {
         return (0, session_events_1.capStructuredRecordString)(`continue remaining Arc work: ${remainingWork.slice(0, 5).join(", ")}`);
     }
-    return (0, session_events_1.capStructuredRecordString)(`wait for new input; reconciled completed or missing obligations: ${staleActiveObligationIds.join(", ")}`);
+    if (staleActiveObligationIds.length > 0) {
+        return (0, session_events_1.capStructuredRecordString)(`wait for new input; reconciled completed or missing obligations: ${staleActiveObligationIds.join(", ")}`);
+    }
+    if (staleActiveReturnObligationIds.length > 0) {
+        return (0, session_events_1.capStructuredRecordString)(`wait for new input; reconciled completed or missing return obligations: ${staleActiveReturnObligationIds.join(", ")}`);
+    }
+    return (0, session_events_1.capStructuredRecordString)(`wait for new input; reconciled completed or missing packets: ${staleActivePacketIds.join(", ")}`);
+}
+function reconcileActiveReturnObligationIds(resume, returnObligations, activeReturnObligations) {
+    const canonicalIdSet = new Set(returnObligations.map((obligation) => obligation.id));
+    const activeIdSet = new Set(activeReturnObligations.map((obligation) => obligation.id));
+    const resumeIdSet = new Set(resume.activeReturnObligationIds);
+    const staleActiveReturnObligationIds = resume.activeReturnObligationIds.filter((id) => canonicalIdSet.has(id) && !activeIdSet.has(id));
+    const unverifiableActiveReturnObligationIds = resume.activeReturnObligationIds.filter((id) => !canonicalIdSet.has(id));
+    const missingActiveReturnObligationIds = activeReturnObligations
+        .map((obligation) => obligation.id)
+        .filter((id) => !resumeIdSet.has(id));
+    const activeReturnObligationIds = uniqueStrings([
+        ...resume.activeReturnObligationIds.filter((id) => !staleActiveReturnObligationIds.includes(id)),
+        ...missingActiveReturnObligationIds,
+    ]);
+    return {
+        activeReturnObligationIds,
+        staleActiveReturnObligationIds,
+        missingActiveReturnObligationIds,
+        unverifiableActiveReturnObligationIds,
+    };
+}
+function reconcileActivePacketIds(resume, packets, activePackets) {
+    const canonicalIdSet = new Set(packets.map((packet) => packet.id));
+    const activeIdSet = new Set(activePackets.map((packet) => packet.id));
+    const resumeIdSet = new Set(resume.activePacketIds);
+    const staleActivePacketIds = resume.activePacketIds.filter((id) => canonicalIdSet.has(id) && !activeIdSet.has(id));
+    const unverifiableActivePacketIds = resume.activePacketIds.filter((id) => !canonicalIdSet.has(id));
+    const missingActivePacketIds = activePackets
+        .map((packet) => packet.id)
+        .filter((id) => !resumeIdSet.has(id));
+    const activePacketIds = uniqueStrings([
+        ...resume.activePacketIds.filter((id) => !staleActivePacketIds.includes(id)),
+        ...missingActivePacketIds,
+    ]);
+    return { activePacketIds, staleActivePacketIds, missingActivePacketIds, unverifiableActivePacketIds };
 }
 function reconcileActiveObligations(agentRoot, resume) {
     const obligations = (0, obligations_1.readVerifiedObligations)(agentRoot);
     const activeObligations = (0, obligations_1.readVerifiedPendingObligations)(agentRoot);
+    const returnObligations = (0, obligations_1.listReturnObligationsForRoot)(agentRoot);
+    const activeReturnObligations = (0, obligations_1.listActiveReturnObligationsForRoot)(agentRoot);
+    const packets = (0, packets_1.listPonderPackets)(agentRoot);
+    const activePackets = (0, packets_1.listActivePonderPackets)(agentRoot);
     const canonicalIdSet = new Set(obligations.map((obligation) => obligation.id));
     const openIdSet = new Set(activeObligations.map((obligation) => obligation.id));
     const resumeIdSet = new Set(resume.activeObligationIds);
@@ -261,33 +313,66 @@ function reconcileActiveObligations(agentRoot, resume) {
     const missingActiveObligationIds = activeObligations
         .map((obligation) => obligation.id)
         .filter((id) => !resumeIdSet.has(id));
+    const { activeReturnObligationIds, staleActiveReturnObligationIds, missingActiveReturnObligationIds, unverifiableActiveReturnObligationIds, } = reconcileActiveReturnObligationIds(resume, returnObligations, activeReturnObligations);
+    const { activePacketIds, staleActivePacketIds, missingActivePacketIds, unverifiableActivePacketIds, } = reconcileActivePacketIds(resume, packets, activePackets);
     if (staleActiveObligationIds.length === 0
         && missingActiveObligationIds.length === 0
-        && unverifiableActiveObligationIds.length === 0) {
-        return { resume, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds };
+        && unverifiableActiveObligationIds.length === 0
+        && staleActiveReturnObligationIds.length === 0
+        && missingActiveReturnObligationIds.length === 0
+        && unverifiableActiveReturnObligationIds.length === 0
+        && staleActivePacketIds.length === 0
+        && missingActivePacketIds.length === 0
+        && unverifiableActivePacketIds.length === 0) {
+        return {
+            resume,
+            staleActiveObligationIds,
+            missingActiveObligationIds,
+            unverifiableActiveObligationIds,
+            staleActiveReturnObligationIds,
+            missingActiveReturnObligationIds,
+            unverifiableActiveReturnObligationIds,
+            staleActivePacketIds,
+            missingActivePacketIds,
+            unverifiableActivePacketIds,
+        };
     }
     const activeObligationIds = uniqueStrings([
         ...resume.activeObligationIds.filter((id) => !staleActiveObligationIds.includes(id)),
         ...missingActiveObligationIds,
     ]);
     const hasActiveArcContinuation = activeObligationIds.length > 0
-        || resume.activeReturnObligationIds.length > 0
-        || resume.activePacketIds.length > 0
+        || activeReturnObligationIds.length > 0
+        || activePacketIds.length > 0
         || resume.openEvolutionCaseIds.length > 0;
-    const isTerminalWait = staleActiveObligationIds.length > 0 && !hasActiveArcContinuation;
+    const isTerminalWait = (staleActiveObligationIds.length > 0
+        || staleActiveReturnObligationIds.length > 0
+        || staleActivePacketIds.length > 0) && !hasActiveArcContinuation;
     const mustSynthesizeAction = staleActiveObligationIds.length > 0
         || unverifiableActiveObligationIds.length > 0
+        || staleActiveReturnObligationIds.length > 0
+        || unverifiableActiveReturnObligationIds.length > 0
+        || staleActivePacketIds.length > 0
+        || unverifiableActivePacketIds.length > 0
         || !nonEmpty(resume.nextSafeAction.value);
     const nextSafeActionValue = mustSynthesizeAction
-        ? nextSafeActionAfterObligationReconcile(resume, activeObligations, staleActiveObligationIds, unverifiableActiveObligationIds)
+        ? nextSafeActionAfterObligationReconcile({ ...resume, activeObligationIds, activeReturnObligationIds, activePacketIds }, activeObligations, staleActiveObligationIds, unverifiableActiveObligationIds, staleActiveReturnObligationIds, unverifiableActiveReturnObligationIds, staleActivePacketIds, unverifiableActivePacketIds)
         : resume.nextSafeAction.value;
-    const recorderHealth = unverifiableActiveObligationIds.length > 0
+    const unverifiableIssues = [
+        ...(unverifiableActiveObligationIds.length > 0
+            ? [`active obligation ids could not be verified in arc/obligations: ${unverifiableActiveObligationIds.join(", ")}`]
+            : []),
+        ...(unverifiableActiveReturnObligationIds.length > 0
+            ? [`active return obligation ids could not be verified in arc/obligations/inner: ${unverifiableActiveReturnObligationIds.join(", ")}`]
+            : []),
+        ...(unverifiableActivePacketIds.length > 0
+            ? [`active packet ids could not be verified in arc/packets: ${unverifiableActivePacketIds.join(", ")}`]
+            : []),
+    ];
+    const recorderHealth = unverifiableIssues.length > 0
         ? {
             status: resume.recorderHealth.status === "unavailable" ? "unavailable" : "degraded",
-            issues: uniqueStrings([
-                ...resume.recorderHealth.issues,
-                `active obligation ids could not be verified in arc/obligations: ${unverifiableActiveObligationIds.join(", ")}`,
-            ]),
+            issues: uniqueStrings([...resume.recorderHealth.issues, ...unverifiableIssues]),
         }
         : resume.recorderHealth;
     const canContinue = nonEmpty(resume.currentAsk.value)
@@ -302,6 +387,8 @@ function reconcileActiveObligations(agentRoot, resume) {
             canContinue,
             recorderHealth,
             activeObligationIds,
+            activeReturnObligationIds,
+            activePacketIds,
             nextSafeAction: {
                 ...resume.nextSafeAction,
                 value: nextSafeActionValue,
@@ -309,22 +396,41 @@ function reconcileActiveObligations(agentRoot, resume) {
                     ? [FLIGHT_RECORDER_RECONCILE_SOURCE_ID]
                     : resume.nextSafeAction.sourceEventIds,
                 stopBefore: unverifiableActiveObligationIds.length > 0
-                    ? uniqueStrings([...resume.nextSafeAction.stopBefore, "acting on unverifiable obligation state"])
+                    || unverifiableActiveReturnObligationIds.length > 0
+                    || unverifiableActivePacketIds.length > 0
+                    ? uniqueStrings([
+                        ...resume.nextSafeAction.stopBefore,
+                        ...(unverifiableActiveObligationIds.length > 0 ? ["acting on unverifiable obligation state"] : []),
+                        ...(unverifiableActiveReturnObligationIds.length > 0 ? ["acting on unverifiable return obligation state"] : []),
+                        ...(unverifiableActivePacketIds.length > 0 ? ["acting on unverifiable packet state"] : []),
+                    ])
                     : resume.nextSafeAction.stopBefore,
             },
         }),
         staleActiveObligationIds,
         missingActiveObligationIds,
         unverifiableActiveObligationIds,
+        staleActiveReturnObligationIds,
+        missingActiveReturnObligationIds,
+        unverifiableActiveReturnObligationIds,
+        staleActivePacketIds,
+        missingActivePacketIds,
+        unverifiableActivePacketIds,
     };
 }
 function normalizeResumeForAgentRoot(agentRoot, resume) {
     return reconcileActiveObligations(agentRoot, normalizeResumeInvariants(resume));
 }
-function emitFlightRecorderReconciled(agentRoot, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds) {
+function emitFlightRecorderReconciled(agentRoot, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds, staleActiveReturnObligationIds, missingActiveReturnObligationIds, unverifiableActiveReturnObligationIds, staleActivePacketIds, missingActivePacketIds, unverifiableActivePacketIds) {
     if (staleActiveObligationIds.length === 0
         && missingActiveObligationIds.length === 0
-        && unverifiableActiveObligationIds.length === 0)
+        && unverifiableActiveObligationIds.length === 0
+        && staleActiveReturnObligationIds.length === 0
+        && missingActiveReturnObligationIds.length === 0
+        && unverifiableActiveReturnObligationIds.length === 0
+        && staleActivePacketIds.length === 0
+        && missingActivePacketIds.length === 0
+        && unverifiableActivePacketIds.length === 0)
         return;
     (0, runtime_1.emitNervesEvent)({
         component: "mind",
@@ -335,6 +441,12 @@ function emitFlightRecorderReconciled(agentRoot, staleActiveObligationIds, missi
             staleActiveObligationIds,
             missingActiveObligationIds,
             unverifiableActiveObligationIds,
+            staleActiveReturnObligationIds,
+            missingActiveReturnObligationIds,
+            unverifiableActiveReturnObligationIds,
+            staleActivePacketIds,
+            missingActivePacketIds,
+            unverifiableActivePacketIds,
         },
     });
 }
@@ -390,11 +502,17 @@ function readFlightRecorderResume(agentRoot) {
         if (!isFlightRecorderResume(parsed)) {
             throw new Error("latest.json has invalid flight-recorder resume shape");
         }
-        const { resume, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds, } = normalizeResumeForAgentRoot(agentRoot, parsed);
+        const { resume, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds, staleActiveReturnObligationIds, missingActiveReturnObligationIds, unverifiableActiveReturnObligationIds, staleActivePacketIds, missingActivePacketIds, unverifiableActivePacketIds, } = normalizeResumeForAgentRoot(agentRoot, parsed);
         if (staleActiveObligationIds.length > 0
             || missingActiveObligationIds.length > 0
-            || unverifiableActiveObligationIds.length > 0) {
-            emitFlightRecorderReconciled(agentRoot, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds);
+            || unverifiableActiveObligationIds.length > 0
+            || staleActiveReturnObligationIds.length > 0
+            || missingActiveReturnObligationIds.length > 0
+            || unverifiableActiveReturnObligationIds.length > 0
+            || staleActivePacketIds.length > 0
+            || missingActivePacketIds.length > 0
+            || unverifiableActivePacketIds.length > 0) {
+            emitFlightRecorderReconciled(agentRoot, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds, staleActiveReturnObligationIds, missingActiveReturnObligationIds, unverifiableActiveReturnObligationIds, staleActivePacketIds, missingActivePacketIds, unverifiableActivePacketIds);
         }
         (0, runtime_1.emitNervesEvent)({
             component: "mind",
@@ -418,9 +536,9 @@ function readFlightRecorderResume(agentRoot) {
     }
 }
 function writeFlightRecorderResume(agentRoot, resume) {
-    const { resume: safeResume, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds, } = normalizeResumeForAgentRoot(agentRoot, resume);
+    const { resume: safeResume, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds, staleActiveReturnObligationIds, missingActiveReturnObligationIds, unverifiableActiveReturnObligationIds, staleActivePacketIds, missingActivePacketIds, unverifiableActivePacketIds, } = normalizeResumeForAgentRoot(agentRoot, resume);
     atomicWriteJson(flightRecorderLatestPath(agentRoot), safeResume);
-    emitFlightRecorderReconciled(agentRoot, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds);
+    emitFlightRecorderReconciled(agentRoot, staleActiveObligationIds, missingActiveObligationIds, unverifiableActiveObligationIds, staleActiveReturnObligationIds, missingActiveReturnObligationIds, unverifiableActiveReturnObligationIds, staleActivePacketIds, missingActivePacketIds, unverifiableActivePacketIds);
     (0, runtime_1.emitNervesEvent)({
         component: "mind",
         event: "mind.flight_recorder_resume_written",

package/dist/arc/obligations.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.readObligation = readObligation;
 exports.isOpenObligationStatus = isOpenObligationStatus;
 exports.isOpenObligation = isOpenObligation;
 exports.createObligation = createObligation;
@@ -49,7 +50,11 @@ exports.getReturnObligationsDir = getReturnObligationsDir;
 exports.getReturnObligationsDirForRoot = getReturnObligationsDirForRoot;
 exports.createReturnObligation = createReturnObligation;
 exports.readReturnObligation = readReturnObligation;
+exports.readReturnObligationForRoot = readReturnObligationForRoot;
 exports.advanceReturnObligation = advanceReturnObligation;
+exports.isActiveReturnObligationStatus = isActiveReturnObligationStatus;
+exports.listReturnObligationsForRoot = listReturnObligationsForRoot;
+exports.isActiveReturnObligationRecord = isActiveReturnObligationRecord;
 exports.listActiveReturnObligations = listActiveReturnObligations;
 exports.listActiveReturnObligationsForRoot = listActiveReturnObligationsForRoot;
 const path = __importStar(require("path"));
@@ -60,6 +65,9 @@ const json_store_1 = require("./json-store");
 function obligationsDir(agentRoot) {
     return path.join(agentRoot, "arc", "obligations");
 }
+function readObligation(agentRoot, obligationId) {
+    return (0, json_store_1.readJsonFile)(obligationsDir(agentRoot), obligationId);
+}
 function isOpenObligationStatus(status) {
     return status !== "fulfilled";
 }
@@ -256,6 +264,9 @@ function createReturnObligation(agentName, obligation) {
 function readReturnObligation(agentName, obligationId) {
     return (0, json_store_1.readJsonFile)(getReturnObligationsDir(agentName), obligationId);
 }
+function readReturnObligationForRoot(agentRoot, obligationId) {
+    return (0, json_store_1.readJsonFile)(getReturnObligationsDirForRoot(agentRoot), obligationId);
+}
 function advanceReturnObligation(agentName, obligationId, update) {
     const existing = readReturnObligation(agentName, obligationId);
     if (!existing)
@@ -295,6 +306,9 @@ const RETURN_OBLIGATION_INJECTION_MAX_AGE_MS = 14 * 24 * 60 * 60 * 1000;
 // surface-tool boundary) is treated as terminal — i.e., we do not re-inject
 // it. This is a read-time defense; the underlying file is left as-is.
 const ACTIVE_RETURN_OBLIGATION_STATUSES = new Set(["queued", "running"]);
+function isActiveReturnObligationStatus(status) {
+    return ACTIVE_RETURN_OBLIGATION_STATUSES.has(status);
+}
 function isSelfInnerReturnObligation(obligation) {
     return obligation.origin?.friendId === "self" && obligation.origin.channel === "inner";
 }
@@ -311,16 +325,24 @@ function isReturnObligationRecord(value) {
         && typeof candidate.origin.channel === "string"
         && typeof candidate.origin.key === "string";
 }
+function listReturnObligationsForRoot(agentRoot) {
+    return (0, json_store_1.readJsonDir)(getReturnObligationsDirForRoot(agentRoot))
+        .filter(isReturnObligationRecord);
+}
+function isActiveReturnObligationRecord(value, options = {}) {
+    if (!isReturnObligationRecord(value))
+        return false;
+    const nowMs = (options.now ?? Date.now)();
+    return isActiveReturnObligationStatus(value.status)
+        && !isSelfInnerReturnObligation(value)
+        && nowMs - value.createdAt <= RETURN_OBLIGATION_INJECTION_MAX_AGE_MS;
+}
 function listActiveReturnObligations(agentName, options = {}) {
     return listActiveReturnObligationsForRoot((0, identity_1.getAgentRoot)(agentName), options);
 }
 function listActiveReturnObligationsForRoot(agentRoot, options = {}) {
-    const all = (0, json_store_1.readJsonDir)(getReturnObligationsDirForRoot(agentRoot));
     const nowMs = (options.now ?? Date.now)();
-    return all
-        .filter(isReturnObligationRecord)
-        .filter((parsed) => ACTIVE_RETURN_OBLIGATION_STATUSES.has(parsed.status))
-        .filter((parsed) => !isSelfInnerReturnObligation(parsed))
-        .filter((parsed) => nowMs - parsed.createdAt <= RETURN_OBLIGATION_INJECTION_MAX_AGE_MS)
+    return listReturnObligationsForRoot(agentRoot)
+        .filter((parsed) => isActiveReturnObligationRecord(parsed, { now: () => nowMs }))
         .sort((a, b) => a.createdAt - b.createdAt);
 }

package/dist/arc/packets.js

@@ -33,9 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTIVE_PONDER_PACKET_STATUSES = void 0;
 exports.getPonderPacketArtifactsDir = getPonderPacketArtifactsDir;
+exports.isActivePonderPacketStatus = isActivePonderPacketStatus;
+exports.isActivePonderPacket = isActivePonderPacket;
 exports.listPonderPackets = listPonderPackets;
+exports.listActivePonderPackets = listActivePonderPackets;
 exports.readPonderPacket = readPonderPacket;
+exports.findPonderPacketByRelatedReturnObligationId = findPonderPacketByRelatedReturnObligationId;
+exports.listPonderPacketsByRelatedReturnObligationId = listPonderPacketsByRelatedReturnObligationId;
+exports.listPonderPacketsByRelatedObligationId = listPonderPacketsByRelatedObligationId;
 exports.createPonderPacket = createPonderPacket;
 exports.revisePonderPacket = revisePonderPacket;
 exports.advancePonderPacket = advancePonderPacket;
@@ -46,6 +53,7 @@ const session_events_1 = require("../heart/session-events");
 const runtime_1 = require("../nerves/runtime");
 const task_lifecycle_1 = require("./task-lifecycle");
 const json_store_1 = require("./json-store");
+const obligations_1 = require("./obligations");
 const evolution_1 = require("./evolution");
 function packetsDir(agentRoot) {
     return path.join(agentRoot, "arc", "packets");
@@ -82,6 +90,34 @@ function isPonderPacket(value) {
         && typeof packet.createdAt === "number"
         && typeof packet.updatedAt === "number";
 }
+exports.ACTIVE_PONDER_PACKET_STATUSES = new Set([
+    "drafting",
+    "processing",
+    "validating",
+    "collaborating",
+    "paused",
+    "blocked",
+]);
+function isActivePonderPacketStatus(status) {
+    return exports.ACTIVE_PONDER_PACKET_STATUSES.has(status);
+}
+function hasInactiveLinkedReturnObligation(agentRoot, packet, options = {}) {
+    if (!packet.relatedReturnObligationId)
+        return false;
+    const obligation = (0, obligations_1.readReturnObligationForRoot)(agentRoot, packet.relatedReturnObligationId);
+    return !(0, obligations_1.isActiveReturnObligationRecord)(obligation, options);
+}
+function hasFulfilledLinkedObligation(agentRoot, packet) {
+    if (!packet.relatedObligationId)
+        return false;
+    const obligation = (0, obligations_1.readObligation)(agentRoot, packet.relatedObligationId);
+    return obligation?.status === "fulfilled";
+}
+function isActivePonderPacket(agentRoot, packet, options = {}) {
+    return isActivePonderPacketStatus(packet.status)
+        && !hasInactiveLinkedReturnObligation(agentRoot, packet, options)
+        && !hasFulfilledLinkedObligation(agentRoot, packet);
+}
 function payloadString(payload, key) {
     const value = payload[key];
     return typeof value === "string" && value.trim().length > 0 ? value : null;
@@ -156,10 +192,22 @@ function listPonderPackets(agentRoot) {
         .filter(isPonderPacket)
         .sort((left, right) => left.createdAt - right.createdAt);
 }
+function listActivePonderPackets(agentRoot, options = {}) {
+    return listPonderPackets(agentRoot).filter((packet) => isActivePonderPacket(agentRoot, packet, options));
+}
 function readPonderPacket(agentRoot, packetId) {
     const packet = (0, json_store_1.readJsonFile)(packetsDir(agentRoot), packetId);
     return isPonderPacket(packet) ? packet : null;
 }
+function findPonderPacketByRelatedReturnObligationId(agentRoot, relatedReturnObligationId) {
+    return listPonderPacketsByRelatedReturnObligationId(agentRoot, relatedReturnObligationId)[0] ?? null;
+}
+function listPonderPacketsByRelatedReturnObligationId(agentRoot, relatedReturnObligationId) {
+    return listPonderPackets(agentRoot).filter((packet) => packet.relatedReturnObligationId === relatedReturnObligationId);
+}
+function listPonderPacketsByRelatedObligationId(agentRoot, relatedObligationId) {
+    return listPonderPackets(agentRoot).filter((packet) => packet.relatedObligationId === relatedObligationId);
+}
 function createPonderPacket(agentRoot, input) {
     const now = Date.now();
     const packet = bindHarnessFrictionEvolutionCase(agentRoot, {