@ouro.bot/cli 0.1.0-alpha.80 → 0.1.0-alpha.800

package/dist/rsvp/spend-ledger.js

@@ -0,0 +1,175 @@
+"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.RSVP_SPEND_LEDGER_POLICY_VERSION = void 0;
+exports.readRsvpSpendLedger = readRsvpSpendLedger;
+exports.ensureRsvpSpendLedger = ensureRsvpSpendLedger;
+exports.recordRsvpSpendLedgerRun = recordRsvpSpendLedgerRun;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const runtime_1 = require("../nerves/runtime");
+exports.RSVP_SPEND_LEDGER_POLICY_VERSION = "rsvp-spend-ledger/v1";
+function ledgerPath(agentRoot) {
+    return path.join(agentRoot, "state", "rsvp", "spend-ledger.json");
+}
+function emptyLedger(now) {
+    return {
+        schemaVersion: 1,
+        policyVersion: exports.RSVP_SPEND_LEDGER_POLICY_VERSION,
+        createdAt: now,
+        updatedAt: now,
+        runs: [],
+    };
+}
+function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function stringField(record, key) {
+    const value = record[key];
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function isRun(value) {
+    const row = value;
+    return !!row
+        && row.schemaVersion === 1
+        && typeof row.runId === "string"
+        && typeof row.rootRunId === "string"
+        && typeof row.idempotencyKey === "string"
+        && typeof row.targetHash === "string"
+        && typeof row.habitName === "string"
+        && typeof row.trigger === "string"
+        && typeof row.lifecycle === "string"
+        && typeof row.startedAt === "string"
+        && typeof row.recordedAt === "string"
+        && row.contentStored === false;
+}
+function storedRun(value) {
+    if (isRun(value))
+        return value;
+    return isRecord(value) ? value : null;
+}
+function isLedger(value) {
+    const row = value;
+    return !!row
+        && row.schemaVersion === 1
+        && row.policyVersion === exports.RSVP_SPEND_LEDGER_POLICY_VERSION
+        && typeof row.createdAt === "string"
+        && typeof row.updatedAt === "string"
+        && Array.isArray(row.runs);
+}
+function readRsvpSpendLedger(agentRoot) {
+    const filePath = ledgerPath(agentRoot);
+    if (!fs.existsSync(filePath))
+        return emptyLedger(new Date().toISOString());
+    try {
+        const now = new Date().toISOString();
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        if (!isLedger(parsed)) {
+            if (!isRecord(parsed) || !Array.isArray(parsed.runs))
+                return emptyLedger(now);
+            return {
+                schemaVersion: 1,
+                policyVersion: exports.RSVP_SPEND_LEDGER_POLICY_VERSION,
+                createdAt: stringField(parsed, "createdAt") ?? now,
+                updatedAt: stringField(parsed, "updatedAt") ?? now,
+                runs: parsed.runs.map(storedRun).filter((run) => run !== null),
+            };
+        }
+        return {
+            schemaVersion: 1,
+            policyVersion: exports.RSVP_SPEND_LEDGER_POLICY_VERSION,
+            createdAt: parsed.createdAt,
+            updatedAt: parsed.updatedAt,
+            runs: parsed.runs.map(storedRun).filter((run) => run !== null),
+        };
+    }
+    catch {
+        return emptyLedger(new Date().toISOString());
+    }
+}
+function writeLedger(agentRoot, ledger) {
+    const filePath = ledgerPath(agentRoot);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    fs.writeFileSync(tmp, `${JSON.stringify(ledger, null, 2)}\n`, "utf-8");
+    fs.renameSync(tmp, filePath);
+    return ledger;
+}
+function ensureRsvpSpendLedger(agentRoot, now = new Date().toISOString()) {
+    const filePath = ledgerPath(agentRoot);
+    if (fs.existsSync(filePath))
+        return readRsvpSpendLedger(agentRoot);
+    const ledger = writeLedger(agentRoot, emptyLedger(now));
+    (0, runtime_1.emitNervesEvent)({
+        component: "rsvp",
+        event: "rsvp.spend_ledger_initialized",
+        message: "initialized RSVP spend ledger",
+        meta: { updatedAt: ledger.updatedAt },
+    });
+    return ledger;
+}
+function recordRsvpSpendLedgerRun(agentRoot, record) {
+    const current = readRsvpSpendLedger(agentRoot);
+    const run = {
+        schemaVersion: 1,
+        runId: record.runId,
+        rootRunId: record.rootRunId,
+        idempotencyKey: record.idempotencyKey,
+        targetHash: record.targetHash,
+        habitName: record.senseOrHabit,
+        trigger: record.triggerType,
+        lifecycle: record.lifecycle,
+        startedAt: record.startedAt,
+        recordedAt: record.recordedAt,
+        ...(record.endedAt ? { endedAt: record.endedAt } : {}),
+        ...(record.usage ? { usage: record.usage } : {}),
+        contentStored: false,
+    };
+    const withoutDuplicate = current.runs.filter((entry) => !(entry.runId === run.runId && entry.lifecycle === run.lifecycle));
+    const updated = writeLedger(agentRoot, {
+        schemaVersion: 1,
+        policyVersion: exports.RSVP_SPEND_LEDGER_POLICY_VERSION,
+        createdAt: current.createdAt,
+        updatedAt: run.recordedAt,
+        runs: [...withoutDuplicate, run],
+    });
+    (0, runtime_1.emitNervesEvent)({
+        component: "rsvp",
+        event: "rsvp.spend_ledger_recorded",
+        message: "recorded RSVP spend ledger row",
+        meta: { runId: run.runId, lifecycle: run.lifecycle, habitName: run.habitName },
+    });
+    return updated;
+}

package/dist/scripts/claude-code-hook.js

@@ -0,0 +1,41 @@
+"use strict";
+// Claude Code lifecycle hook handler.
+// Receives events from Claude Code's hooks system (SessionStart, Stop, PostToolUse)
+// and forwards them to the Ouroboros daemon for agent awareness.
+//
+// This module exports handleHookEvent for testability.
+// The actual hook scripts (scripts/claude-code-hook.js) read stdin and call this.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHookEvent = handleHookEvent;
+const socket_client_1 = require("../heart/daemon/socket-client");
+const runtime_1 = require("../nerves/runtime");
+/**
+ * Handle a Claude Code lifecycle hook event.
+ * Sends the event to the daemon and always exits 0 (hooks must not block the IDE).
+ */
+async function handleHookEvent(hookEvent) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.hook_event_received",
+        message: "claude code hook event received",
+        meta: { hookEvent: hookEvent.event, sessionId: hookEvent.sessionId },
+    });
+    try {
+        await (0, socket_client_1.sendDaemonCommand)(socket_client_1.DEFAULT_DAEMON_SOCKET_PATH, {
+            kind: "hook.event",
+            event: hookEvent.event,
+            sessionId: hookEvent.sessionId,
+            toolName: hookEvent.toolName,
+        });
+    }
+    catch {
+        // Daemon unavailable — silently ignore. Hooks must not block.
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.hook_event_daemon_unavailable",
+            message: "daemon unavailable for hook event",
+            meta: { hookEvent: hookEvent.event },
+        });
+    }
+    return { exitCode: 0 };
+}

package/dist/scripts/claude-code-stop-hook.js

@@ -0,0 +1,47 @@
+"use strict";
+// Claude Code stop hook — checks the agent's pending queue and returns
+// any messages as additionalContext for injection into the next turn.
+//
+// This is how the agent can proactively communicate back to the dev tool user:
+// the agent surfaces a message to the pending queue, and the stop hook picks
+// it up and injects it as context in the Claude Code session.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleStopHook = handleStopHook;
+const pending_1 = require("../mind/pending");
+const runtime_1 = require("../nerves/runtime");
+/**
+ * Check the pending queue for messages from the agent to this dev tool session.
+ * Returns accumulated message text as additionalContext.
+ */
+async function handleStopHook(input) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.stop_hook_check_start",
+        message: "checking pending queue for stop hook",
+        meta: { agentName: input.agentName, friendId: input.friendId, sessionId: input.sessionId },
+    });
+    try {
+        const pendingDir = (0, pending_1.getPendingDir)(input.agentName, input.friendId, "mcp", input.sessionId);
+        const pending = (0, pending_1.drainPending)(pendingDir);
+        if (pending.length === 0) {
+            return { additionalContext: "" };
+        }
+        const text = pending.map((m) => m.content).join("\n\n---\n\n");
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.stop_hook_check_end",
+            message: "pending messages found for stop hook",
+            meta: { agentName: input.agentName, count: pending.length },
+        });
+        return { additionalContext: text };
+    }
+    catch {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.stop_hook_check_error",
+            message: "error checking pending queue in stop hook",
+            meta: { agentName: input.agentName },
+        });
+        return { additionalContext: "" };
+    }
+}

package/dist/senses/a2a-entry.js

@@ -0,0 +1,115 @@
+"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 });
+const agentArgIndex = process.argv.indexOf("--agent");
+const agentName = agentArgIndex >= 0 ? process.argv[agentArgIndex + 1] : undefined;
+if (!agentName) {
+    // eslint-disable-next-line no-console -- pre-boot guard: --agent check before imports
+    console.error("Missing required --agent <name> argument.\nUsage: node dist/senses/a2a-entry.js --agent ouroboros [--port 18920] [--base-url https://agent.example]");
+    process.exit(1);
+}
+function argValue(name) {
+    const index = process.argv.indexOf(name);
+    return index >= 0 ? process.argv[index + 1] : undefined;
+}
+const runtime_logging_1 = require("../heart/daemon/runtime-logging");
+const runtime_1 = require("../nerves/runtime");
+(0, runtime_logging_1.configureDaemonRuntimeLogger)("a2a");
+(0, runtime_1.emitNervesEvent)({
+    component: "senses",
+    event: "senses.entry_boot",
+    message: "booting A2A entrypoint",
+    meta: { entry: "a2a", agentName },
+});
+Promise.all([
+    Promise.resolve().then(() => __importStar(require("../a2a/server"))),
+    Promise.resolve().then(() => __importStar(require("../a2a/identity"))),
+    Promise.resolve().then(() => __importStar(require("../heart/runtime-credentials"))),
+    Promise.resolve().then(() => __importStar(require("../heart/machine-identity"))),
+    Promise.resolve().then(() => __importStar(require("@ouro.bot/friends/a2a-client"))),
+])
+    .then(async ([{ startA2AServer }, { loadOrMintA2AIdentity, readStoredA2ASeed }, { waitForRuntimeCredentialBootstrap, readMachineRuntimeCredentialConfig, refreshMachineRuntimeCredentialConfig, mergeMachineRuntimeCredentialConfig }, { loadOrCreateMachineIdentity }, { ready },]) => {
+    const os = await Promise.resolve().then(() => __importStar(require("node:os")));
+    // Wait for the daemon to deliver the machine-local runtime config (carrying the
+    // a2a identity seed) into the in-memory cache before we read or mint identity.
+    const bootstrapped = await waitForRuntimeCredentialBootstrap(agentName);
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.a2a_bootstrap_waited",
+        message: "awaited runtime-credential bootstrap before A2A identity load",
+        meta: { entry: "a2a", agentName, bootstrapped },
+    });
+    const sodium = await ready();
+    const machineId = loadOrCreateMachineIdentity({ homeDir: os.homedir() }).machineId;
+    const cachedMachineConfigRead = readMachineRuntimeCredentialConfig(agentName);
+    const machineConfigRead = cachedMachineConfigRead.ok && readStoredA2ASeed(cachedMachineConfigRead.config)
+        ? cachedMachineConfigRead
+        : await refreshMachineRuntimeCredentialConfig(agentName, machineId);
+    if (!machineConfigRead.ok && machineConfigRead.reason !== "missing") {
+        throw new Error(`A2A identity requires readable machine runtime config at ${machineConfigRead.itemPath}: ${machineConfigRead.error}`);
+    }
+    const machineConfig = machineConfigRead.ok ? machineConfigRead.config : {};
+    const identity = await loadOrMintA2AIdentity({
+        agentName,
+        sodium,
+        config: machineConfig,
+        upsert: async (next) => {
+            const seed = readStoredA2ASeed(next);
+            await mergeMachineRuntimeCredentialConfig(agentName, machineId, { a2a: { identity: { ed25519Seed: seed } } });
+        },
+    });
+    const rawPort = argValue("--port");
+    const port = rawPort ? Number.parseInt(rawPort, 10) : undefined;
+    await startA2AServer({
+        agentName,
+        identity,
+        ...(argValue("--host") ? { host: argValue("--host") } : {}),
+        ...(Number.isInteger(port) ? { port } : {}),
+        ...(argValue("--base-url") ? { baseUrl: argValue("--base-url") } : {}),
+        ...(argValue("--path") ? { path: argValue("--path") } : {}),
+    });
+})
+    .catch((error) => {
+    (0, runtime_1.emitNervesEvent)({
+        level: "error",
+        component: "senses",
+        event: "senses.entry_error",
+        message: "A2A entrypoint failed",
+        meta: { entry: "a2a", agentName, error: error instanceof Error ? error.message : String(error) },
+    });
+    // eslint-disable-next-line no-console -- fatal startup guard for sense process
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});

package/dist/senses/attention-queue.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAttentionQueue = buildAttentionQueue;
+exports.dequeueAttentionItem = dequeueAttentionItem;
+exports.attentionQueueEmpty = attentionQueueEmpty;
+exports.buildAttentionQueueSummary = buildAttentionQueueSummary;
+exports.buildAttentionQueueStatusFrame = buildAttentionQueueStatusFrame;
+const runtime_1 = require("../nerves/runtime");
+// ── Queue construction ───────────────────────────────────────────
+function generateItemId() {
+    return Math.random().toString(36).slice(2, 10);
+}
+function originKey(friendId, channel, key) {
+    return `${friendId}/${channel}/${key}`;
+}
+const PACKET_RETURN_HINT_MAX = 180;
+const PACKET_RETURN_HINT_COUNT_MAX = 4;
+const LITERAL_MARKER_RE = /\b[A-Z][A-Z0-9]*(?:_[A-Z0-9]+){2,}\b/;
+const RETURN_HINT_KEY_RE = /(expected|return|marker|answer|verdict)/i;
+function addReturnHint(hints, seen, value) {
+    if (typeof value !== "string")
+        return;
+    const trimmed = value.trim();
+    if (!trimmed || trimmed.length > PACKET_RETURN_HINT_MAX)
+        return;
+    if (!LITERAL_MARKER_RE.test(trimmed))
+        return;
+    if (seen.has(trimmed))
+        return;
+    seen.add(trimmed);
+    hints.push(trimmed);
+}
+function extractQuotedReturnHints(value, hints, seen) {
+    for (const match of value.matchAll(/"([^"\n]{1,180})"/g)) {
+        addReturnHint(hints, seen, match[1]);
+        if (hints.length >= PACKET_RETURN_HINT_COUNT_MAX)
+            return;
+    }
+}
+function extractPacketReturnHints(packet) {
+    const hints = [];
+    const seen = new Set();
+    const sourceRequest = typeof packet.payload.sourceRequest === "string" ? packet.payload.sourceRequest : "";
+    if (sourceRequest)
+        extractQuotedReturnHints(sourceRequest, hints, seen);
+    for (const [key, value] of Object.entries(packet.payload)) {
+        if (hints.length >= PACKET_RETURN_HINT_COUNT_MAX)
+            break;
+        if (key === "sourceRequest" || !RETURN_HINT_KEY_RE.test(key))
+            continue;
+        addReturnHint(hints, seen, value);
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                addReturnHint(hints, seen, item);
+                if (hints.length >= PACKET_RETURN_HINT_COUNT_MAX)
+                    break;
+            }
+        }
+    }
+    return hints;
+}
+function buildAttentionQueue(input) {
+    const { drainedPending, outstandingObligations, friendNameResolver, packetResolver } = input;
+    const seen = new Set();
+    const items = [];
+    const enrichPacket = (packetId) => {
+        if (!packetId || !packetResolver)
+            return {};
+        const packet = packetResolver(packetId);
+        if (!packet)
+            return { packetId };
+        return {
+            packetId,
+            packetKind: packet.kind,
+            packetObjective: packet.objective,
+            packetSummary: packet.summary,
+            packetSuccessCriteria: packet.successCriteria,
+            packetSourceRequest: typeof packet.payload.sourceRequest === "string" ? packet.payload.sourceRequest : undefined,
+            packetReturnHints: extractPacketReturnHints(packet),
+        };
+    };
+    // Source 1: drained pending messages with delegatedFrom (current-turn delegations)
+    for (const msg of drainedPending) {
+        if (!msg.delegatedFrom)
+            continue;
+        const { friendId, channel, key, bridgeId } = msg.delegatedFrom;
+        const oKey = originKey(friendId, channel, key);
+        seen.add(oKey);
+        const resolvedName = friendNameResolver(friendId);
+        items.push({
+            id: msg.obligationId ?? generateItemId(),
+            friendId,
+            friendName: resolvedName ?? friendId,
+            channel,
+            key,
+            ...(bridgeId ? { bridgeId } : {}),
+            delegatedContent: msg.content,
+            ...(msg.obligationId ? { obligationId: msg.obligationId } : {}),
+            ...enrichPacket(msg.packetId),
+            source: "drained",
+            timestamp: msg.timestamp,
+        });
+    }
+    // Source 2: outstanding obligations (crash recovery)
+    for (const obligation of outstandingObligations) {
+        const { friendId, channel, key, bridgeId } = obligation.origin;
+        const oKey = originKey(friendId, channel, key);
+        if (seen.has(oKey))
+            continue; // deduplicate: prefer drained version
+        seen.add(oKey);
+        const resolvedName = friendNameResolver(friendId);
+        items.push({
+            id: obligation.id,
+            friendId,
+            friendName: resolvedName ?? friendId,
+            channel,
+            key,
+            ...(bridgeId ? { bridgeId } : {}),
+            delegatedContent: obligation.delegatedContent,
+            obligationId: obligation.id,
+            ...enrichPacket(obligation.packetId),
+            source: "obligation-recovery",
+            timestamp: obligation.createdAt,
+        });
+    }
+    // Sort FIFO (oldest first)
+    items.sort((a, b) => a.timestamp - b.timestamp);
+    (0, runtime_1.emitNervesEvent)({
+        event: "senses.attention_queue_built",
+        component: "senses",
+        message: `attention queue built with ${items.length} item(s)`,
+        meta: {
+            drainedCount: items.filter((i) => i.source === "drained").length,
+            recoveredCount: items.filter((i) => i.source === "obligation-recovery").length,
+        },
+    });
+    return items;
+}
+// ── Queue operations ─────────────────────────────────────────────
+function dequeueAttentionItem(queue, id) {
+    const index = queue.findIndex((item) => item.id === id);
+    if (index === -1)
+        return null;
+    return queue.splice(index, 1)[0];
+}
+function attentionQueueEmpty(queue) {
+    return queue.length === 0;
+}
+// ── Queue visibility ─────────────────────────────────────────────
+const CONTENT_PREVIEW_MAX = 80;
+const PACKET_SOURCE_PREVIEW_MAX = 240;
+function preview(value, max) {
+    return value.length > max ? `${value.slice(0, max - 3)}...` : value;
+}
+function buildAttentionQueueSummary(queue) {
+    if (queue.length === 0)
+        return "";
+    const lines = [
+        "[internal: current held work items — not messages to send]",
+        "Only listed items are waiting now; older transcript mentions and completed returns/probes are not current pressure.",
+        "To return one, call surface with delegationId set to the bracketed id.",
+        "Return only the requested result; do not add commentary about prior attempts, old loops, or completed probes.",
+        "If literal return options are listed, copy the chosen option exactly, including suffixes and punctuation.",
+    ];
+    for (const item of queue) {
+        if (item.packetKind && item.packetObjective) {
+            lines.push(`- [${item.id}] ${item.friendName} -> ${item.packetKind}: ${item.packetObjective}`);
+            if (item.packetSuccessCriteria?.length) {
+                lines.push(`  return criteria: ${item.packetSuccessCriteria.join("; ")}`);
+            }
+            if (item.packetReturnHints?.length) {
+                lines.push(`  literal return options: ${item.packetReturnHints.map((hint) => `"${hint}"`).join("; ")}`);
+            }
+            const sourceRequest = item.packetSourceRequest ?? item.delegatedContent;
+            if (sourceRequest.trim().length > 0 && sourceRequest.trim() !== item.packetObjective.trim()) {
+                lines.push(`  source request: "${preview(sourceRequest, PACKET_SOURCE_PREVIEW_MAX)}"`);
+            }
+            continue;
+        }
+        lines.push(`- [${item.id}] ${item.friendName} asked: "${preview(item.delegatedContent, CONTENT_PREVIEW_MAX)}"`);
+    }
+    return lines.join("\n");
+}
+function buildAttentionQueueStatusFrame(queue) {
+    return buildAttentionQueueSummary(queue);
+}

package/dist/senses/await-turn-message.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAwaitTurnMessage = buildAwaitTurnMessage;
+const runtime_1 = require("../nerves/runtime");
+function formatElapsed(ms) {
+    if (ms < 60_000)
+        return "<1m ago";
+    const minutes = Math.floor(ms / 60_000);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+function relativeAge(lastCheckedAt, now) {
+    if (!lastCheckedAt)
+        return null;
+    const lastMs = new Date(lastCheckedAt).getTime();
+    if (!Number.isFinite(lastMs))
+        return null;
+    return formatElapsed(now().getTime() - lastMs);
+}
+function buildAwaitTurnMessage(options) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.await_turn_message_built",
+        message: "built await tick message",
+        meta: { awaitName: options.awaitName, checkedCount: options.checkedCount },
+    });
+    const lines = [];
+    lines.push(`await tick: ${options.awaitName} — ${options.condition}`);
+    if (options.body && options.body.trim().length > 0) {
+        lines.push("");
+        lines.push("what would count as ready:");
+        lines.push(options.body.trim());
+    }
+    const age = relativeAge(options.lastCheckedAt, options.now);
+    const obs = options.lastObservation && options.lastObservation.trim().length > 0
+        ? `last observation: "${options.lastObservation.trim()}"`
+        : "last observation: (none yet)";
+    if (options.checkedCount === 0) {
+        lines.push("");
+        lines.push("history: never checked. this is my first look.");
+    }
+    else {
+        lines.push("");
+        lines.push(`history: checked ${options.checkedCount}x so far. last checked ${age ?? "(unknown)"}. ${obs}.`);
+    }
+    if (options.checkpoint) {
+        lines.push("");
+        lines.push(`last checkpoint: ${options.checkpoint}`);
+    }
+    lines.push("");
+    lines.push("look around and decide. if the condition is met, call resolve_await with verdict='yes' and a one-line observation. otherwise call resolve_await with verdict='no' and a one-line observation of what i saw this tick.");
+    return lines.join("\n");
+}