@ouro.bot/cli 0.1.0-alpha.7 → 0.1.0-alpha.700

package/dist/heart/versioning/update-hooks.js

@@ -0,0 +1,154 @@
+"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.registerUpdateHook = registerUpdateHook;
+exports.getRegisteredHooks = getRegisteredHooks;
+exports.clearRegisteredHooks = clearRegisteredHooks;
+exports.applyPendingUpdates = applyPendingUpdates;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const semver = __importStar(require("semver"));
+const runtime_1 = require("../../nerves/runtime");
+const _hooks = [];
+function registerUpdateHook(hook) {
+    _hooks.push(hook);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.update_hook_registered",
+        message: "registered update hook",
+        meta: {},
+    });
+}
+function getRegisteredHooks() {
+    return _hooks;
+}
+function clearRegisteredHooks() {
+    _hooks.length = 0;
+}
+function isNoAgentDefaultBundle(agentRoot, entryName) {
+    return entryName === "default.ouro" && !fs.existsSync(path.join(agentRoot, "agent.json"));
+}
+async function applyPendingUpdates(bundlesRoot, currentVersion) {
+    const summary = { updated: [] };
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.apply_pending_updates_start",
+        message: "applying pending updates",
+        meta: { bundlesRoot, currentVersion },
+    });
+    try {
+        if (!fs.existsSync(bundlesRoot)) {
+            return summary;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(bundlesRoot, { withFileTypes: true });
+        }
+        catch {
+            return summary;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory() || !entry.name.endsWith(".ouro"))
+                continue;
+            const agentRoot = path.join(bundlesRoot, entry.name);
+            if (isNoAgentDefaultBundle(agentRoot, entry.name)) {
+                (0, runtime_1.emitNervesEvent)({
+                    component: "daemon",
+                    event: "daemon.update_hook_skip_no_agent_default",
+                    message: "skipping no-agent default bundle during pending updates",
+                    meta: { agentRoot },
+                });
+                continue;
+            }
+            let previousVersion;
+            const metaPath = path.join(agentRoot, "bundle-meta.json");
+            try {
+                if (fs.existsSync(metaPath)) {
+                    const raw = fs.readFileSync(metaPath, "utf-8");
+                    const meta = JSON.parse(raw);
+                    previousVersion = meta.runtimeVersion;
+                    if (previousVersion === currentVersion) {
+                        continue;
+                    }
+                    // Skip downgrades — only update forward
+                    if (semver.valid(previousVersion) && semver.valid(currentVersion) && semver.gte(previousVersion, currentVersion)) {
+                        (0, runtime_1.emitNervesEvent)({
+                            component: "daemon",
+                            event: "daemon.update_hook_skip_downgrade",
+                            message: "skipping downgrade",
+                            meta: { agentRoot, previousVersion, currentVersion },
+                        });
+                        continue;
+                    }
+                }
+            }
+            catch {
+                // Malformed or unreadable bundle-meta.json -- treat as needing update
+                previousVersion = undefined;
+            }
+            const ctx = { agentRoot, currentVersion, previousVersion };
+            for (const hook of _hooks) {
+                try {
+                    await hook(ctx);
+                }
+                catch (err) {
+                    (0, runtime_1.emitNervesEvent)({
+                        component: "daemon",
+                        event: "daemon.update_hook_error",
+                        message: "update hook threw",
+                        meta: {
+                            agentRoot,
+                            error: err instanceof Error ? err.message : /* v8 ignore next -- defensive: non-Error catch branch @preserve */ String(err),
+                        },
+                    });
+                }
+            }
+            summary.updated.push({
+                agent: entry.name.replace(/\.ouro$/, ""),
+                from: previousVersion,
+                to: currentVersion,
+            });
+        }
+        return summary;
+    }
+    finally {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.apply_pending_updates_end",
+            message: "pending updates applied",
+            meta: { bundlesRoot },
+        });
+    }
+}

package/dist/heart/versioning/wrapper-publish-guard.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assessWrapperPublishSync = assessWrapperPublishSync;
+const runtime_1 = require("../../nerves/runtime");
+function wrapperPackageChanged(changedFiles) {
+    return changedFiles.some((file) => file.startsWith("packages/ouro.bot/"));
+}
+function assessWrapperPublishSync(input) {
+    let result;
+    if (input.localVersion !== input.cliVersion) {
+        result = {
+            ok: false,
+            message: `ouro.bot wrapper version ${input.localVersion} must match @ouro.bot/cli version ${input.cliVersion}`,
+        };
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "daemon",
+            event: "daemon.wrapper_publish_guard_checked",
+            message: "evaluated wrapper publish sync",
+            meta: {
+                changed: wrapperPackageChanged(input.changedFiles),
+                localVersion: input.localVersion,
+                cliVersion: input.cliVersion,
+                publishedVersion: input.publishedVersion,
+                ok: result.ok,
+            },
+        });
+        return result;
+    }
+    if (!wrapperPackageChanged(input.changedFiles)) {
+        result = {
+            ok: true,
+            message: "wrapper package unchanged",
+        };
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.wrapper_publish_guard_checked",
+            message: "evaluated wrapper publish sync",
+            meta: {
+                changed: false,
+                localVersion: input.localVersion,
+                cliVersion: input.cliVersion,
+                publishedVersion: input.publishedVersion,
+                ok: result.ok,
+            },
+        });
+        return result;
+    }
+    if (input.publishedVersion === input.localVersion) {
+        result = {
+            ok: false,
+            message: `ouro.bot wrapper changed but ouro.bot@${input.localVersion} is already published; bump packages/ouro.bot/package.json before merging`,
+        };
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "daemon",
+            event: "daemon.wrapper_publish_guard_checked",
+            message: "evaluated wrapper publish sync",
+            meta: {
+                changed: true,
+                localVersion: input.localVersion,
+                cliVersion: input.cliVersion,
+                publishedVersion: input.publishedVersion,
+                ok: result.ok,
+            },
+        });
+        return result;
+    }
+    result = {
+        ok: true,
+        message: "wrapper package changed and local wrapper version is unpublished",
+    };
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.wrapper_publish_guard_checked",
+        message: "evaluated wrapper publish sync",
+        meta: {
+            changed: true,
+            localVersion: input.localVersion,
+            cliVersion: input.cliVersion,
+            publishedVersion: input.publishedVersion,
+            ok: result.ok,
+        },
+    });
+    return result;
+}

package/dist/heart/work-card.js

@@ -0,0 +1,380 @@
+"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.validateWorkCardAgentName = validateWorkCardAgentName;
+exports.buildWorkCard = buildWorkCard;
+exports.formatWorkCardText = formatWorkCardText;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+const provider_visibility_1 = require("./provider-visibility");
+const evolution_1 = require("../arc/evolution");
+const obligations_1 = require("../arc/obligations");
+const packets_1 = require("../arc/packets");
+const flight_recorder_1 = require("../arc/flight-recorder");
+function isoFromMs(ms) {
+    return new Date(ms).toISOString();
+}
+function obligationLocator(id) {
+    return `arc/obligations/${id}.json`;
+}
+function returnObligationLocator(id) {
+    return `arc/obligations/inner/${id}.json`;
+}
+function packetLocator(id) {
+    return `arc/packets/${id}.json`;
+}
+function evolutionLocator(id) {
+    return `arc/evolution/cases/${id}.json`;
+}
+function flightRecorderLocator() {
+    return "arc/flight-recorder/latest.json";
+}
+function validateWorkCardAgentName(agentName) {
+    const trimmed = agentName.trim();
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(trimmed)) {
+        throw new Error("work card requires a safe agent name (letters, numbers, dot, underscore, hyphen; no path separators)");
+    }
+    return trimmed;
+}
+function source(kind, locator, freshness = "current", redaction = "summary") {
+    return { kind, locator, freshness, redaction };
+}
+function issue(code, sourceRef, detail, severity = "degraded") {
+    return { code, severity, source: sourceRef, detail };
+}
+function readJsonDiagnostic(filePath) {
+    try {
+        return { ok: true, parsed: JSON.parse(fs.readFileSync(filePath, "utf-8")) };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            detail: error instanceof Error ? error.message : /* v8 ignore next -- defensive: non-Error catch branch @preserve */ String(error),
+        };
+    }
+}
+function scanJsonDir(dir, sourceKind, locatorForFile, isValid) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((entry) => entry.endsWith(".json"))
+        .flatMap((entry) => {
+        const filePath = path.join(dir, entry);
+        const sourceRef = source(sourceKind, locatorForFile(path.basename(entry, ".json")), "unknown");
+        const read = readJsonDiagnostic(filePath);
+        if (!read.ok) {
+            return [issue("arc_json_unreadable", sourceRef, `${sourceRef.locator} could not be parsed: ${read.detail}`)];
+        }
+        if (!isValid(read.parsed)) {
+            return [issue("arc_json_invalid_shape", sourceRef, `${sourceRef.locator} does not match the expected Work Card source shape`)];
+        }
+        return [];
+    });
+}
+function hasStringRecordFields(value, fields) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const record = value;
+    return fields.every((field) => typeof record[field] === "string");
+}
+function scanArcSourceIssues(agentRoot) {
+    return [
+        ...scanJsonDir(path.join(agentRoot, "arc", "obligations"), "obligation", obligationLocator, (value) => hasStringRecordFields(value, ["id", "content", "status"])),
+        ...scanJsonDir(path.join(agentRoot, "arc", "obligations", "inner"), "return_obligation", returnObligationLocator, (value) => hasStringRecordFields(value, ["id", "status", "delegatedContent"])
+            && typeof value.createdAt === "number"),
+        ...scanJsonDir(path.join(agentRoot, "arc", "packets"), "ponder_packet", packetLocator, (value) => hasStringRecordFields(value, ["id", "kind", "status", "objective"])),
+        ...scanJsonDir(path.join(agentRoot, "arc", "evolution", "cases"), "evolution_case", evolutionLocator, (value) => hasStringRecordFields(value, ["id", "title", "status"])),
+    ];
+}
+function obligationItem(obligation) {
+    const freshness = obligation.meaning?.stalenessClass === "at-risk" ? "stale_risky" : "current";
+    const status = typeof obligation.status === "string" ? obligation.status : "pending";
+    const updatedAt = typeof obligation.updatedAt === "string"
+        ? obligation.updatedAt
+        : typeof obligation.createdAt === "string" ? obligation.createdAt : undefined;
+    return {
+        id: obligation.id,
+        title: obligation.content,
+        status,
+        source: source("obligation", obligationLocator(obligation.id), freshness),
+        ...(obligation.latestNote ? { summary: obligation.latestNote } : {}),
+        ...(obligation.nextAction ? { nextAction: obligation.nextAction } : {}),
+        ...(updatedAt ? { updatedAt } : {}),
+    };
+}
+function returnObligationItem(obligation) {
+    return {
+        id: obligation.id,
+        title: obligation.delegatedContent,
+        status: obligation.status,
+        source: source("return_obligation", returnObligationLocator(obligation.id)),
+        ...(obligation.packetId ? { summary: `packet: ${obligation.packetId}` } : {}),
+        nextAction: obligation.status === "queued" ? "start private work and preserve the return route" : "finish and surface the delegated result",
+        updatedAt: isoFromMs(obligation.startedAt ?? obligation.createdAt),
+    };
+}
+function packetItem(packet) {
+    return {
+        id: packet.id,
+        title: packet.objective,
+        status: packet.status,
+        source: source("ponder_packet", packetLocator(packet.id)),
+        summary: packet.summary,
+        nextAction: packet.status === "blocked" ? "resolve blocker or mark waiting" : "advance packet toward validation and return",
+        updatedAt: isoFromMs(packet.updatedAt),
+    };
+}
+function evolutionItem(item) {
+    return {
+        id: item.id,
+        title: item.title,
+        status: item.status,
+        source: source("evolution_case", evolutionLocator(item.id)),
+        summary: item.problemStatement,
+        nextAction: (0, evolution_1.nextEvolutionActionForStatus)(item.status),
+        updatedAt: item.updatedAt,
+    };
+}
+function waitingOnHuman(items) {
+    return items.filter((item) => {
+        const lowerStatus = item.status.toLowerCase();
+        return lowerStatus.includes("waiting")
+            || lowerStatus.includes("blocked");
+    });
+}
+function chooseNextAction(input) {
+    if (input.waiting.length > 0) {
+        return {
+            actor: "human",
+            summary: input.waiting[0].nextAction ?? input.waiting[0].title,
+            source: input.waiting[0].source,
+        };
+    }
+    if (input.flightRecorderResume.blockedBecause.length > 0) {
+        return {
+            actor: "unknown",
+            summary: `flight recorder blocked: ${input.flightRecorderResume.blockedBecause.join("; ")}`,
+            source: source("flight_recorder", flightRecorderLocator(), input.flightRecorderResume.recorderHealth.status === "ok" ? "current" : "unknown"),
+        };
+    }
+    if (input.flightRecorderResume.recorderHealth.status === "ok"
+        && input.flightRecorderResume.canContinue
+        && input.flightRecorderResume.nextSafeAction.value) {
+        return {
+            actor: "agent",
+            summary: input.flightRecorderResume.nextSafeAction.value,
+            source: source("flight_recorder", flightRecorderLocator()),
+        };
+    }
+    if (input.returnObligations[0]) {
+        return {
+            actor: "agent",
+            summary: input.returnObligations[0].nextAction,
+            source: input.returnObligations[0].source,
+        };
+    }
+    if (input.owed[0]) {
+        return {
+            actor: "agent",
+            summary: input.owed[0].nextAction ?? input.owed[0].title,
+            source: input.owed[0].source,
+        };
+    }
+    if (input.activeWork[0]) {
+        return {
+            actor: "agent",
+            summary: input.activeWork[0].nextAction,
+            source: input.activeWork[0].source,
+        };
+    }
+    return {
+        actor: "unknown",
+        summary: "no open work found in arc; verify against current session context before claiming clear state",
+    };
+}
+function buildWorkCard(agentName, agentRoot, options = {}) {
+    const safeAgentName = validateWorkCardAgentName(agentName);
+    const generatedAt = (options.now ?? (() => new Date()))().toISOString();
+    const sourceIssues = scanArcSourceIssues(agentRoot);
+    const owed = (0, obligations_1.readPendingObligations)(agentRoot).map(obligationItem);
+    const returnObligations = (0, obligations_1.listActiveReturnObligationsForRoot)(agentRoot, { now: options.nowMs }).map(returnObligationItem);
+    const activePackets = (0, packets_1.listActivePonderPackets)(agentRoot, { now: options.nowMs }).map(packetItem);
+    const evolutionCases = (0, evolution_1.listOpenEvolutionCases)(agentRoot).map(evolutionItem);
+    const activeWork = [...activePackets, ...evolutionCases];
+    const waiting = waitingOnHuman([...owed, ...returnObligations, ...activeWork]);
+    const flightRecorderResume = options.flightRecorderResume ?? (0, flight_recorder_1.readFlightRecorderResume)(agentRoot);
+    const claims = {
+        available: false,
+        unavailableReason: "WorkClaim store is not implemented yet; unverified claim counts are unknown, not zero.",
+        counts: {
+            unverified: null,
+            partial: null,
+            failed: null,
+            unverifiable: null,
+            staleRisky: null,
+            verified: null,
+        },
+        items: [],
+    };
+    const recorderIssues = flightRecorderResume.recorderHealth.status === "ok"
+        ? []
+        : flightRecorderResume.recorderHealth.issues.map((recorderIssue) => issue("flight_recorder_degraded", source("flight_recorder", flightRecorderLocator(), "unknown"), recorderIssue, flightRecorderResume.recorderHealth.status === "unavailable" ? "unavailable" : "degraded"));
+    const providers = (0, provider_visibility_1.buildAgentProviderVisibility)({ agentName: safeAgentName, agentRoot, homeDir: options.homeDir });
+    const nextAction = chooseNextAction({
+        owed,
+        returnObligations,
+        activeWork,
+        waiting,
+        claims,
+        flightRecorderResume,
+    });
+    const sources = [...owed, ...returnObligations, ...activeWork, ...claims.items].map((item) => item.source);
+    sources.push(source("claim_store", "arc/claims", "unknown"));
+    sources.push(source("flight_recorder", flightRecorderLocator(), flightRecorderResume.recorderHealth.status === "ok" ? "current" : "unknown"));
+    const issues = [...sourceIssues, ...recorderIssues];
+    const card = {
+        schemaVersion: 1,
+        projection: {
+            owner: "arc/work-card",
+            scope: "durable-arc-work",
+            relationToActiveWorkFrame: "complements-live-turn-frame",
+        },
+        agent: safeAgentName,
+        generatedAt,
+        degraded: {
+            status: issues.length > 0 ? "degraded" : "ok",
+            issues,
+        },
+        currentAsk: {
+            available: Boolean(flightRecorderResume.currentAsk.value),
+            ...(flightRecorderResume.currentAsk.value ? { value: flightRecorderResume.currentAsk.value } : {}),
+            source: flightRecorderResume.currentAsk.value ? "flight_recorder" : "not_tracked_yet",
+            confidence: flightRecorderResume.currentAsk.confidence,
+        },
+        counts: {
+            owed: owed.length,
+            returnObligations: returnObligations.length,
+            activePackets: activePackets.length,
+            evolutionCases: evolutionCases.length,
+            waitingOnHuman: waiting.length,
+            unverifiedClaims: null,
+            staleRiskyClaims: null,
+        },
+        owed,
+        returnObligations,
+        activeWork,
+        waitingOnOthers: waiting,
+        claims,
+        capabilityHealth: {
+            available: true,
+            providers,
+        },
+        nextAction,
+        sources,
+    };
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.work_card_compiled",
+        message: "work card compiled from arc records",
+        meta: {
+            agent: agentName,
+            owedCount: card.counts.owed,
+            returnObligationCount: card.counts.returnObligations,
+            activeWorkCount: card.counts.activePackets + card.counts.evolutionCases,
+            waitingOnHumanCount: card.counts.waitingOnHuman,
+            claimsAvailable: card.claims.available,
+            sourceIssueCount: sourceIssues.length,
+        },
+    });
+    return card;
+}
+function formatItems(items, empty) {
+    if (items.length === 0)
+        return [`  ${empty}`];
+    return items.map((item) => {
+        const suffixes = [
+            item.nextAction ? `next: ${item.nextAction}` : null,
+            `source: ${item.source.locator}`,
+        ].filter(Boolean);
+        return `  - [${item.status}] ${item.title} (${suffixes.join("; ")})`;
+    });
+}
+function formatWorkCardText(card) {
+    return [
+        `Work Card — ${card.agent}`,
+        `generated: ${card.generatedAt}`,
+        `health: ${card.degraded.status} (${card.degraded.issues.length} issue${card.degraded.issues.length === 1 ? "" : "s"})`,
+        "",
+        `counts: owed=${card.counts.owed} return_obligations=${card.counts.returnObligations} active_packets=${card.counts.activePackets} evolution_cases=${card.counts.evolutionCases} waiting_on_human=${card.counts.waitingOnHuman} unverified_claims=${card.counts.unverifiedClaims ?? "unknown"} stale_risky_claims=${card.counts.staleRiskyClaims ?? "unknown"}`,
+        "",
+        "Current Ask",
+        card.currentAsk.available
+            ? `  ${card.currentAsk.value} (source: ${card.currentAsk.source}, confidence: ${card.currentAsk.confidence})`
+            : `  unavailable (${card.currentAsk.source})`,
+        "",
+        "Owed",
+        ...formatItems(card.owed, "none found in arc/obligations"),
+        "",
+        "Return Obligations",
+        ...formatItems(card.returnObligations, "none active"),
+        "",
+        "Active Work",
+        ...formatItems(card.activeWork, "none found in packets or evolution cases"),
+        "",
+        "Waiting On Others",
+        ...formatItems(card.waitingOnOthers, "none detected from durable records"),
+        "",
+        "Claims",
+        `  unavailable: ${card.claims.unavailableReason}`,
+        "",
+        "Source Issues",
+        ...card.degraded.issues.map((item) => `  - [${item.severity}] ${item.code}: ${item.detail} (source: ${item.source.locator})`),
+        "",
+        "Capability Health",
+        card.capabilityHealth.available
+            ? `  provider lanes: ${card.capabilityHealth.providers.lanes.map((lane) => `${lane.lane}:${lane.status}/${lane.readiness.status}`).join(", ")}`
+            : `  unavailable: ${card.capabilityHealth.unavailableReason}`,
+        "",
+        "Next Action",
+        `  ${card.nextAction.actor}: ${card.nextAction.summary}`,
+        card.nextAction.source ? `  source: ${card.nextAction.source.locator}` : "",
+    ].filter((line, index, lines) => line !== "" || lines[index - 1] !== "").join("\n").trim();
+}