@ouro.bot/cli 0.1.0-alpha.595 → 0.1.0-alpha.596

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.596",
+      "changes": [
+        "New await_condition primitive. Agents can file a natural-language condition (`await_condition({ name, condition, cadence, alert?, mode?, max_age?, body? })`); the daemon polls on cadence and queues an inner-dialog tick titled `await tick: <name> — <condition>` with the file body + history block (checked count, last-checked age, last observation). The agent calls `resolve_await({ name, verdict, observation })`: verdict=yes archives the file to `awaiting/.done/` and fires an alert via cross-chat-delivery (intent=generic_outreach) targeting `filed_for_friend_id` on the `alert` channel — proactive sends slot into the user's existing thread, no self-loopback. verdict=no records the observation and increments the tick count. `cancel_await({ name, reason? })` silently archives without alert. max_age triggers auto-expiry with a 'timed out' alert. Surfaces `## what i'm waiting on` in the commitments section. Validated end-to-end with Slugger: file → tick → resolve(no, x2) → resolve(yes) → archive + cross_chat_delivery queued_for_later. AwaitScheduler mkdirs its awaits dir at start so the fs.watch watcher attaches on first boot (no need to wait for a periodic reconcile)."
+      ]
+    },
     {
       "version": "0.1.0-alpha.595",
       "changes": [

package/dist/heart/awaiting/await-alert.js

@@ -0,0 +1,146 @@
+"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.resolveAlertKey = resolveAlertKey;
+exports.buildAlertContent = buildAlertContent;
+exports.deliverAwaitAlert = deliverAwaitAlert;
+exports.buildAwaitDeliveryDeps = buildAwaitDeliveryDeps;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../../nerves/runtime");
+const cross_chat_delivery_1 = require("../cross-chat-delivery");
+function readNonEmpty(value) {
+    if (value === null)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/**
+ * Find a session key for (friendId, channel) by scanning the bundle's
+ * sessions directory. Prefers BlueBubbles DM keys (containing ";-;");
+ * for other channels, returns the first available session file stem.
+ *
+ * Returns null when nothing is available — caller decides whether to skip
+ * delivery or fall back to a default like "session".
+ */
+function resolveAlertKey(agentRoot, friendId, channel) {
+    const dir = path.join(agentRoot, "state", "sessions", friendId, channel);
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    const jsonFiles = entries.filter((f) => f.endsWith(".json"));
+    if (jsonFiles.length === 0)
+        return null;
+    const dm = jsonFiles.find((f) => f.includes(";-;"));
+    const chosen = dm ?? jsonFiles[0];
+    return chosen.replace(/\.json$/, "");
+}
+function buildAlertContent(awaitFile, reason, observation) {
+    const condition = awaitFile.condition ?? awaitFile.name;
+    const obs = readNonEmpty(observation);
+    if (reason === "resolved") {
+        return obs ? `${condition} — ready. ${obs}` : `${condition} — ready.`;
+    }
+    return obs ? `${condition} — timed out. last seen: ${obs}` : `${condition} — timed out. last seen: never observed`;
+}
+async function deliverAwaitAlert(options) {
+    const { awaitFile, reason, observation, agentRoot, deliveryDeps } = options;
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.await_alert_start",
+        message: "preparing await alert",
+        meta: { awaitName: awaitFile.name, reason },
+    });
+    const channel = readNonEmpty(awaitFile.alert);
+    const friendId = readNonEmpty(awaitFile.filed_for_friend_id);
+    if (!channel) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "daemon",
+            event: "daemon.await_alert_end",
+            message: "skipping alert — no alert channel configured",
+            meta: { awaitName: awaitFile.name, reason },
+        });
+        return { attempted: false, skipped: "no alert channel" };
+    }
+    if (!friendId) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "daemon",
+            event: "daemon.await_alert_end",
+            message: "skipping alert — no filed_for_friend_id",
+            meta: { awaitName: awaitFile.name, reason },
+        });
+        return { attempted: false, skipped: "no friend id" };
+    }
+    const key = resolveAlertKey(agentRoot, friendId, channel);
+    if (!key) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "daemon",
+            event: "daemon.await_alert_end",
+            message: "skipping alert — no resolvable session key",
+            meta: { awaitName: awaitFile.name, reason, friendId, channel },
+        });
+        return { attempted: false, skipped: "no session key" };
+    }
+    const content = buildAlertContent(awaitFile, reason, observation);
+    const delivery = await (0, cross_chat_delivery_1.deliverCrossChatMessage)({
+        friendId,
+        channel,
+        key,
+        content,
+        intent: "generic_outreach",
+    }, deliveryDeps);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.await_alert_end",
+        message: "await alert delivered",
+        meta: { awaitName: awaitFile.name, reason, status: delivery.status },
+    });
+    return { attempted: true, delivery };
+}
+function buildAwaitDeliveryDeps(options) {
+    return {
+        agentName: options.agentName,
+        queuePending: options.queuePending,
+        deliverers: options.deliverers,
+        now: options.now,
+    };
+}

package/dist/heart/awaiting/await-expiry.js

@@ -0,0 +1,108 @@
+"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.archiveAndAlertExpiredAwait = archiveAndAlertExpiredAwait;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../../nerves/runtime");
+const await_parser_1 = require("./await-parser");
+const await_runtime_state_1 = require("./await-runtime-state");
+const await_alert_1 = require("./await-alert");
+/**
+ * Daemon-side max_age expiry helper. Reads the pending await, moves it to
+ * `awaiting/.done/` with `status: expired`, writes `expired_at` and
+ * `last_observation_at_expiry`, then fires the alert via deliverAwaitAlert.
+ *
+ * Idempotent w.r.t. the alert path: if the file is gone (already archived
+ * by a concurrent path) it returns `archived: false` without alerting.
+ */
+async function archiveAndAlertExpiredAwait(options) {
+    const now = options.now ?? (() => new Date());
+    const source = path.join(options.agentRoot, "awaiting", `${options.awaitName}.md`);
+    const doneDir = path.join(options.agentRoot, "awaiting", ".done");
+    const target = path.join(doneDir, `${options.awaitName}.md`);
+    let content;
+    try {
+        content = fs.readFileSync(source, "utf-8");
+    }
+    catch {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "daemon",
+            event: "daemon.await_expiry_skip",
+            message: "expired await file no longer present at archive time",
+            meta: { agent: options.agentName, awaitName: options.awaitName },
+        });
+        return { archived: false, alerted: false, reason: "file missing" };
+    }
+    const parsed = (0, await_parser_1.parseAwaitFile)(content, source);
+    const runtime = (0, await_runtime_state_1.readAwaitRuntimeState)(options.agentRoot, options.awaitName);
+    const lastObservation = runtime?.last_observation ?? null;
+    const expiredAt = now().toISOString();
+    const merged = {
+        condition: parsed.condition,
+        cadence: parsed.cadence,
+        alert: parsed.alert,
+        mode: parsed.mode,
+        max_age: parsed.max_age,
+        status: "expired",
+        created_at: parsed.created_at,
+        filed_from: parsed.filed_from,
+        filed_for_friend_id: parsed.filed_for_friend_id,
+        expired_at: expiredAt,
+        last_observation_at_expiry: lastObservation,
+    };
+    fs.mkdirSync(doneDir, { recursive: true });
+    fs.writeFileSync(target, (0, await_parser_1.renderAwaitFile)(merged, parsed.body), "utf-8");
+    fs.unlinkSync(source);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.await_expired_archived",
+        message: "expired await archived",
+        meta: { agent: options.agentName, awaitName: options.awaitName, expiredAt },
+    });
+    // Re-parse archived file to feed the alert with merged fields
+    const archivedContent = fs.readFileSync(target, "utf-8");
+    const archived = (0, await_parser_1.parseAwaitFile)(archivedContent, target);
+    const alertResult = await (0, await_alert_1.deliverAwaitAlert)({
+        awaitFile: archived,
+        reason: "expired",
+        observation: lastObservation,
+        agentRoot: options.agentRoot,
+        agentName: options.agentName,
+        deliveryDeps: options.deliveryDeps,
+    });
+    return { archived: true, alerted: alertResult.attempted };
+}

package/dist/heart/awaiting/await-loader.js

@@ -0,0 +1,91 @@
+"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.loadPendingAwaitsForCommitments = loadPendingAwaitsForCommitments;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../../nerves/runtime");
+const await_parser_1 = require("./await-parser");
+const await_runtime_state_1 = require("./await-runtime-state");
+/**
+ * Load the bundle's pending awaits, merged with runtime state, projected into
+ * the AwaitingCommitment shape consumed by the commitments / prompt pipeline.
+ *
+ * Reads only `<bundle>/awaiting/` (never `.done/`). Skips malformed files
+ * silently — those are surfaced via the scheduler's parseErrors path.
+ */
+function loadPendingAwaitsForCommitments(agentRoot) {
+    const dir = path.join(agentRoot, "awaiting");
+    let entries;
+    try {
+        const raw = fs.readdirSync(dir);
+        /* v8 ignore next -- defensive: real readdirSync returns string[]; this only fires when callers stub it to a non-array @preserve */
+        entries = Array.isArray(raw) ? raw : [];
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".md"))
+            continue;
+        const filePath = path.join(dir, entry);
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            const merged = (0, await_runtime_state_1.applyAwaitRuntimeState)(agentRoot, (0, await_parser_1.parseAwaitFile)(content, filePath));
+            if (merged.status !== "pending")
+                continue;
+            if (!merged.condition)
+                continue;
+            out.push({
+                name: merged.name,
+                condition: merged.condition,
+                checkedCount: typeof merged.checked_count === "number" ? merged.checked_count : 0,
+                lastCheckedAt: merged.last_checked ?? null,
+                lastObservation: merged.last_observation ?? null,
+            });
+        }
+        catch {
+            // Skip unreadable/unparseable files — surfaced elsewhere
+        }
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.awaits_loaded_for_commitments",
+        message: "loaded pending awaits for commitments",
+        meta: { agentRoot, count: out.length },
+    });
+    return out;
+}

package/dist/heart/awaiting/await-parser.js

@@ -0,0 +1,141 @@
+"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.parseAwaitFile = parseAwaitFile;
+exports.renderAwaitFile = renderAwaitFile;
+const path = __importStar(require("path"));
+const parser_1 = require("../../repertoire/tasks/parser");
+const runtime_1 = require("../../nerves/runtime");
+function isAwaitStatus(value) {
+    return value === "pending" || value === "resolved" || value === "expired" || value === "canceled";
+}
+function isAwaitMode(value) {
+    return value === "full" || value === "quick";
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function extractFrontmatterAndBody(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== "---")
+        return null;
+    const closing = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+    if (closing === -1)
+        return null;
+    const rawFrontmatter = lines.slice(1, closing).join("\n");
+    const body = lines.slice(closing + 1).join("\n").trim();
+    return { frontmatter: (0, parser_1.parseFrontmatter)(rawFrontmatter), body };
+}
+function emptyAwait(stem, body) {
+    return {
+        name: stem,
+        condition: null,
+        cadence: null,
+        alert: null,
+        mode: "full",
+        max_age: null,
+        status: "pending",
+        created_at: null,
+        filed_from: null,
+        filed_for_friend_id: null,
+        body,
+        resolved_at: null,
+        resolution_observation: null,
+        expired_at: null,
+        last_observation_at_expiry: null,
+        canceled_at: null,
+        cancel_reason: null,
+    };
+}
+function parseAwaitFile(content, filePath) {
+    (0, runtime_1.emitNervesEvent)({
+        event: "daemon.await_parse",
+        component: "daemon",
+        message: "parsing await file",
+        meta: { filePath },
+    });
+    const stem = path.basename(filePath, ".md");
+    const parsed = extractFrontmatterAndBody(content);
+    if (!parsed)
+        return { ...emptyAwait(stem, content.trim()) };
+    const { frontmatter, body } = parsed;
+    const rawStatus = frontmatter.status;
+    const status = typeof rawStatus === "string" && isAwaitStatus(rawStatus) ? rawStatus : "pending";
+    const rawMode = frontmatter.mode;
+    const mode = typeof rawMode === "string" && isAwaitMode(rawMode) ? rawMode : "full";
+    return {
+        name: stem,
+        condition: nonEmptyString(frontmatter.condition),
+        cadence: nonEmptyString(frontmatter.cadence),
+        alert: nonEmptyString(frontmatter.alert),
+        mode,
+        max_age: nonEmptyString(frontmatter.max_age),
+        status,
+        created_at: nonEmptyString(frontmatter.created_at),
+        filed_from: nonEmptyString(frontmatter.filed_from),
+        filed_for_friend_id: nonEmptyString(frontmatter.filed_for_friend_id),
+        body,
+        resolved_at: nonEmptyString(frontmatter.resolved_at),
+        resolution_observation: nonEmptyString(frontmatter.resolution_observation),
+        expired_at: nonEmptyString(frontmatter.expired_at),
+        last_observation_at_expiry: nonEmptyString(frontmatter.last_observation_at_expiry),
+        canceled_at: nonEmptyString(frontmatter.canceled_at),
+        cancel_reason: nonEmptyString(frontmatter.cancel_reason),
+    };
+}
+function formatFrontmatterValue(value) {
+    if (value === null || value === undefined)
+        return "null";
+    if (Array.isArray(value))
+        return `[${value.join(", ")}]`;
+    return String(value);
+}
+function renderAwaitFile(frontmatter, body) {
+    (0, runtime_1.emitNervesEvent)({
+        event: "daemon.await_render",
+        component: "daemon",
+        message: "rendering await file",
+        meta: {},
+    });
+    const lines = ["---"];
+    for (const key of Object.keys(frontmatter)) {
+        lines.push(`${key}: ${formatFrontmatterValue(frontmatter[key])}`);
+    }
+    lines.push("---");
+    lines.push("");
+    lines.push(body.trim());
+    lines.push("");
+    return lines.join("\n");
+}

package/dist/heart/awaiting/await-runtime-state.js

@@ -0,0 +1,97 @@
+"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.readAwaitRuntimeState = readAwaitRuntimeState;
+exports.applyAwaitRuntimeState = applyAwaitRuntimeState;
+exports.writeAwaitRuntimeState = writeAwaitRuntimeState;
+exports.recordAwaitCheck = recordAwaitCheck;
+const path = __importStar(require("path"));
+const json_store_1 = require("../../arc/json-store");
+const runtime_1 = require("../../nerves/runtime");
+function awaitRuntimeStateDir(agentRoot) {
+    return path.join(agentRoot, "state", "awaits");
+}
+function readAwaitRuntimeState(agentRoot, name) {
+    const record = (0, json_store_1.readJsonFile)(awaitRuntimeStateDir(agentRoot), name);
+    if (!record)
+        return null;
+    return {
+        last_checked: typeof record.last_checked === "string" ? record.last_checked : null,
+        last_observation: typeof record.last_observation === "string" ? record.last_observation : null,
+        checked_count: typeof record.checked_count === "number" ? record.checked_count : 0,
+    };
+}
+function applyAwaitRuntimeState(agentRoot, awaitFile) {
+    const state = readAwaitRuntimeState(agentRoot, awaitFile.name);
+    if (state === null)
+        return awaitFile;
+    return {
+        ...awaitFile,
+        // Cast: runtime fields are merged onto the file for prompt/commitments consumers
+        ...state,
+    };
+}
+function writeAwaitRuntimeState(agentRoot, name, partial) {
+    const existing = readAwaitRuntimeState(agentRoot, name);
+    const merged = {
+        last_checked: partial.last_checked ?? existing?.last_checked ?? null,
+        last_observation: partial.last_observation ?? existing?.last_observation ?? null,
+        checked_count: partial.checked_count ?? existing?.checked_count ?? 0,
+    };
+    const record = {
+        schemaVersion: 1,
+        name,
+        last_checked: merged.last_checked,
+        last_observation: merged.last_observation,
+        checked_count: merged.checked_count,
+        updatedAt: new Date().toISOString(),
+    };
+    (0, json_store_1.writeJsonFile)(awaitRuntimeStateDir(agentRoot), name, record);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.await_runtime_state_write",
+        message: "wrote await runtime state",
+        meta: { agentRoot, name, last_checked: merged.last_checked, checked_count: merged.checked_count },
+    });
+}
+function recordAwaitCheck(agentRoot, name, observation, now) {
+    const existing = readAwaitRuntimeState(agentRoot, name);
+    const nextCount = (existing?.checked_count ?? 0) + 1;
+    writeAwaitRuntimeState(agentRoot, name, {
+        last_checked: now,
+        last_observation: observation,
+        checked_count: nextCount,
+    });
+}