@ouro.bot/cli 0.1.0-alpha.71 → 0.1.0-alpha.711

package/dist/senses/{bluebubbles-client.js → bluebubbles/client.js}

@@ -1,12 +1,48 @@
 "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.createBlueBubblesClient = createBlueBubblesClient;
 const node_crypto_1 = require("node:crypto");
-const config_1 = require("../heart/config");
-const identity_1 = require("../heart/identity");
-const runtime_1 = require("../nerves/runtime");
-const bluebubbles_model_1 = require("./bluebubbles-model");
-const bluebubbles_media_1 = require("./bluebubbles-media");
+const config_1 = require("../../heart/config");
+const identity_1 = require("../../heart/identity");
+const bluebubbles_health_diagnostics_1 = require("../../heart/daemon/bluebubbles-health-diagnostics");
+const runtime_1 = require("../../nerves/runtime");
+const minimax_1 = require("../../heart/providers/minimax");
+const minimax_vlm_1 = require("../../heart/providers/minimax-vlm");
+const model_1 = require("./model");
+const media_1 = require("./media");
 function buildBlueBubblesApiUrl(baseUrl, endpoint, password) {
     const root = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
     const url = new URL(endpoint.replace(/^\//, ""), root);
@@ -55,6 +91,9 @@ async function parseJsonBody(response) {
         return null;
     }
 }
+function describeCaughtValue(error) {
+    return error instanceof Error ? error.message : String(error);
+}
 function buildRepairUrl(baseUrl, messageGuid, password) {
     const url = buildBlueBubblesApiUrl(baseUrl, `/api/v1/message/${encodeURIComponent(messageGuid)}`, password);
     const parsed = new URL(url);
@@ -99,6 +138,17 @@ function extractChatQueryRows(payload) {
     }
     return data.map((entry) => asRecord(entry)).filter((entry) => entry !== null);
 }
+function extractMessageQueryRows(payload) {
+    const record = asRecord(payload);
+    const data = asRecord(record?.data);
+    const rows = Array.isArray(record?.data) ? record.data
+        : Array.isArray(data?.messages) ? data.messages
+            : Array.isArray(data?.results) ? data.results
+                : Array.isArray(record?.messages) ? record.messages
+                    : Array.isArray(payload) ? payload
+                        : [];
+    return rows.map((entry) => asRecord(entry)).filter((entry) => entry !== null);
+}
 async function resolveChatGuidForIdentifier(config, channelConfig, chatIdentifier) {
     const trimmedIdentifier = chatIdentifier.trim();
     if (!trimmedIdentifier)
@@ -223,7 +273,7 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
             const url = buildBlueBubblesApiUrl(config.serverUrl, "/api/v1/message/text", config.password);
             const body = {
                 chatGuid: resolvedChatGuid,
-                tempGuid: (0, node_crypto_1.randomUUID)(),
+                tempGuid: params.tempGuid?.trim() || (0, node_crypto_1.randomUUID)(),
                 message: trimmedText,
             };
             if (params.replyToMessageGuid?.trim()) {
@@ -330,19 +380,19 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
             }
         },
         async checkHealth() {
-            const url = buildBlueBubblesApiUrl(config.serverUrl, "/api/v1/message/count", config.password);
             (0, runtime_1.emitNervesEvent)({
                 component: "senses",
                 event: "senses.bluebubbles_healthcheck_start",
                 message: "probing bluebubbles upstream health",
                 meta: { serverUrl: config.serverUrl },
             });
-            const response = await fetch(url, {
-                method: "GET",
-                signal: AbortSignal.timeout(channelConfig.requestTimeoutMs),
+            const result = await (0, bluebubbles_health_diagnostics_1.probeBlueBubblesHealth)({
+                serverUrl: config.serverUrl,
+                password: config.password,
+                requestTimeoutMs: channelConfig.requestTimeoutMs,
+                fetchImpl: fetch,
             });
-            if (!response.ok) {
-                const errorText = await response.text().catch(() => "");
+            if (!result.ok) {
                 (0, runtime_1.emitNervesEvent)({
                     level: "warn",
                     component: "senses",
@@ -350,11 +400,13 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                     message: "bluebubbles upstream health probe failed",
                     meta: {
                         serverUrl: config.serverUrl,
-                        status: response.status,
-                        reason: errorText || "unknown",
+                        status: result.status,
+                        reason: result.reason,
+                        classification: result.classification,
+                        detail: (0, bluebubbles_health_diagnostics_1.redactBlueBubblesHealthDetailForNerves)(result.detail),
                     },
                 });
-                throw new Error(`BlueBubbles upstream health check failed (${response.status}): ${errorText || "unknown"}`);
+                throw new Error(result.detail);
             }
             (0, runtime_1.emitNervesEvent)({
                 component: "senses",
@@ -363,6 +415,77 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                 meta: { serverUrl: config.serverUrl },
             });
         },
+        async listRecentMessages(params = {}) {
+            const limit = Math.max(1, Math.min(100, Math.floor(params.limit ?? 50)));
+            const offset = Math.max(0, Math.floor(params.offset ?? 0));
+            const url = buildBlueBubblesApiUrl(config.serverUrl, "/api/v1/message/query", config.password);
+            (0, runtime_1.emitNervesEvent)({
+                component: "senses",
+                event: "senses.bluebubbles_query_recent_start",
+                message: "querying recent bluebubbles messages",
+                meta: { limit, offset },
+            });
+            const body = {
+                limit,
+                offset,
+                sort: "DESC",
+                ...(params.chatGuid?.trim() ? { chatGuid: params.chatGuid.trim() } : {}),
+                ...(params.chatIdentifier?.trim() ? { chatIdentifier: params.chatIdentifier.trim() } : {}),
+                ...(typeof params.beforeTimestamp === "number" && Number.isFinite(params.beforeTimestamp)
+                    ? { beforeTimestamp: params.beforeTimestamp }
+                    : {}),
+                with: ["chats", "attachments", "payloadData", "messageSummaryInfo"],
+            };
+            const response = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(channelConfig.requestTimeoutMs),
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => "");
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "senses",
+                    event: "senses.bluebubbles_query_recent_error",
+                    message: "bluebubbles recent message query failed",
+                    meta: {
+                        status: response.status,
+                        reason: errorText || "unknown",
+                    },
+                });
+                throw new Error(`BlueBubbles recent message query failed (${response.status}): ${errorText || "unknown"}`);
+            }
+            const payload = await parseJsonBody(response);
+            const rows = extractMessageQueryRows(payload);
+            const messages = [];
+            for (const row of rows) {
+                try {
+                    messages.push((0, model_1.normalizeBlueBubblesEvent)({ type: "new-message", data: row }));
+                }
+                catch (error) {
+                    (0, runtime_1.emitNervesEvent)({
+                        level: "warn",
+                        component: "senses",
+                        event: "senses.bluebubbles_query_recent_skip",
+                        message: "skipped unusable bluebubbles recent message row",
+                        meta: {
+                            reason: describeCaughtValue(error),
+                        },
+                    });
+                }
+            }
+            (0, runtime_1.emitNervesEvent)({
+                component: "senses",
+                event: "senses.bluebubbles_query_recent_end",
+                message: "queried recent bluebubbles messages",
+                meta: {
+                    rows: rows.length,
+                    normalized: messages.length,
+                },
+            });
+            return messages;
+        },
         async repairEvent(event) {
             if (!event.requiresRepair) {
                 (0, runtime_1.emitNervesEvent)({
@@ -377,6 +500,7 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                 return event;
             }
             (0, runtime_1.emitNervesEvent)({
+                level: "warn",
                 component: "senses",
                 event: "senses.bluebubbles_repair_start",
                 message: "repairing bluebubbles event by guid",
@@ -423,13 +547,13 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                     });
                     return repaired;
                 }
-                const normalized = (0, bluebubbles_model_1.normalizeBlueBubblesEvent)({
+                const normalized = (0, model_1.normalizeBlueBubblesEvent)({
                     type: event.eventType,
                     data,
                 });
                 const recoveredMessage = event.kind === "mutation"
                     && !event.shouldNotifyAgent
-                    ? (0, bluebubbles_model_1.normalizeBlueBubblesEvent)({
+                    ? (0, model_1.normalizeBlueBubblesEvent)({
                         type: "new-message",
                         data,
                     })
@@ -440,8 +564,42 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                 if (hydrated.kind === "message" &&
                     hydrated.balloonBundleId !== "com.apple.messages.URLBalloonProvider" &&
                     hydrated.attachments.length > 0) {
-                    const media = await (0, bluebubbles_media_1.hydrateBlueBubblesAttachments)(hydrated.attachments, config, channelConfig, {
-                        preferAudioInput: providerSupportsAudioInput((0, identity_1.loadAgentConfig)().provider),
+                    const agentConfig = (0, identity_1.loadAgentConfig)();
+                    const chatModel = agentConfig.humanFacing.model;
+                    const chatProvider = agentConfig.humanFacing.provider;
+                    const vlmDescribe = async (params) => {
+                        if (chatProvider !== "minimax") {
+                            throw new Error("VLM fallback requires a minimax credential for this agent — " +
+                                "configure one or switch to a vision-capable chat model");
+                        }
+                        const { readProviderCredentialRecord } = await Promise.resolve().then(() => __importStar(require("../../heart/provider-credentials")));
+                        const credential = await readProviderCredentialRecord((0, identity_1.getAgentName)(), "minimax");
+                        const apiKey = credential.ok ? credential.record.credentials.apiKey : undefined;
+                        if (!apiKey) {
+                            throw new Error("VLM fallback: minimax API key not found in the agent vault — " +
+                                "run `ouro auth --agent <agent> --provider minimax`");
+                        }
+                        return (0, minimax_vlm_1.minimaxVlmDescribe)({
+                            apiKey: String(apiKey),
+                            prompt: params.prompt,
+                            imageDataUrl: params.imageDataUrl,
+                            baseURL: minimax_1.MINIMAX_PROVIDER_BASE_URL,
+                            attachmentGuid: params.attachmentGuid,
+                            mimeType: params.mimeType,
+                            chatModel: params.chatModel,
+                        });
+                    };
+                    // VLM prompt context wants the user's raw inbound text — NOT
+                    // the agent-facing rendering, which now carries the attachment
+                    // marker after the B2 fix. Pull it from the source payload.
+                    const rawUserText = typeof data.text === "string"
+                        ? (data.text).trim()
+                        : "";
+                    const media = await (0, media_1.hydrateBlueBubblesAttachments)(hydrated.attachments, config, channelConfig, {
+                        preferAudioInput: providerSupportsAudioInput(chatProvider),
+                        chatModel,
+                        vlmDescribe,
+                        userText: rawUserText,
                     });
                     const transcriptSuffix = media.transcriptAdditions.map((entry) => `[${entry}]`).join("\n");
                     const noticeSuffix = media.notices.map((entry) => `[${entry}]`).join("\n");
@@ -453,6 +611,7 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                     };
                 }
                 (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
                     component: "senses",
                     event: "senses.bluebubbles_repair_end",
                     message: "bluebubbles event repaired",
@@ -480,5 +639,53 @@ function createBlueBubblesClient(config = (0, config_1.getBlueBubblesConfig)(),
                 return applyRepairNotice(event, `BlueBubbles repair failed: ${reason}`);
             }
         },
+        async getMessageText(messageGuid) {
+            const url = buildRepairUrl(config.serverUrl, messageGuid, config.password);
+            try {
+                const response = await fetch(url, {
+                    method: "GET",
+                    signal: AbortSignal.timeout(channelConfig.requestTimeoutMs),
+                });
+                if (!response.ok) {
+                    (0, runtime_1.emitNervesEvent)({
+                        level: "warn",
+                        component: "senses",
+                        event: "senses.bluebubbles_get_message_text_error",
+                        message: "failed to fetch message text",
+                        meta: { messageGuid, status: response.status },
+                    });
+                    return null;
+                }
+                const payload = await parseJsonBody(response);
+                const data = extractRepairData(payload);
+                if (!data || typeof data.text !== "string") {
+                    (0, runtime_1.emitNervesEvent)({
+                        level: "warn",
+                        component: "senses",
+                        event: "senses.bluebubbles_get_message_text_error",
+                        message: "message payload missing text field",
+                        meta: { messageGuid, hasData: !!data, textType: data ? typeof data.text : "n/a" },
+                    });
+                    return null;
+                }
+                (0, runtime_1.emitNervesEvent)({
+                    component: "senses",
+                    event: "senses.bluebubbles_get_message_text",
+                    message: "fetched message text by guid",
+                    meta: { messageGuid },
+                });
+                return data.text.trim() || null;
+            }
+            catch (error) {
+                (0, runtime_1.emitNervesEvent)({
+                    level: "warn",
+                    component: "senses",
+                    event: "senses.bluebubbles_get_message_text_error",
+                    message: "exception fetching message text",
+                    meta: { messageGuid, reason: error instanceof Error ? error.message : String(error) },
+                });
+                return null;
+            }
+        },
     };
 }

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

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLUEBUBBLES_CONTEXT_PACKET_MAX_AGE_MS = exports.BLUEBUBBLES_CONTEXT_PACKET_LIMIT = void 0;
+exports.blueBubblesContextChatKey = blueBubblesContextChatKey;
+exports.blueBubblesContextChatKeyHash = blueBubblesContextChatKeyHash;
+exports.buildBlueBubblesContextPacket = buildBlueBubblesContextPacket;
+const node_crypto_1 = require("node:crypto");
+const runtime_1 = require("../../nerves/runtime");
+const context_packets_1 = require("../context-packets");
+exports.BLUEBUBBLES_CONTEXT_PACKET_LIMIT = 40;
+exports.BLUEBUBBLES_CONTEXT_PACKET_MAX_AGE_MS = 48 * 60 * 60 * 1000;
+function sha256Hex(input) {
+    return (0, node_crypto_1.createHash)("sha256").update(input).digest("hex");
+}
+function blueBubblesContextChatKey(event) {
+    return event.chat.chatGuid ?? event.chat.chatIdentifier ?? event.chat.sessionKey;
+}
+function blueBubblesContextChatKeyHash(event) {
+    return sha256Hex(blueBubblesContextChatKey(event));
+}
+function isSameBlueBubblesChat(candidate, anchor) {
+    return candidate.chat.sessionKey === anchor.chat.sessionKey
+        || (!!candidate.chat.chatGuid && candidate.chat.chatGuid === anchor.chat.chatGuid)
+        || (!!candidate.chat.chatIdentifier && candidate.chat.chatIdentifier === anchor.chat.chatIdentifier);
+}
+function contextAuthorLabel(event) {
+    if (event.fromMe)
+        return "Slugger";
+    return event.sender.displayName || event.sender.externalId || "Unknown";
+}
+function messageToContextInput(event, chatGuidHash) {
+    return {
+        timestamp: new Date(event.timestamp).toISOString(),
+        authorLabel: contextAuthorLabel(event),
+        body: event.textForAgent || event.text,
+        sourceRef: {
+            sense: "bluebubbles",
+            adapter: "bluebubbles-api-v1",
+            service: "imessage",
+            chatGuid: event.chat.chatGuid,
+            chatGuidHash,
+            messageGuid: event.messageGuid,
+            senderExternalIdHash: sha256Hex(event.sender.externalId || event.sender.rawId || "unknown"),
+            observedAt: new Date(event.timestamp).toISOString(),
+        },
+    };
+}
+async function buildBlueBubblesContextPacket(input) {
+    if (!Number.isFinite(input.event.timestamp))
+        return null;
+    if (!input.client.listRecentMessages)
+        return null;
+    const event = input.event;
+    const chatGuidHash = blueBubblesContextChatKeyHash(event);
+    const anchorTimestamp = new Date(event.timestamp).toISOString();
+    const candidates = await input.client.listRecentMessages({
+        beforeTimestamp: event.timestamp,
+        limit: exports.BLUEBUBBLES_CONTEXT_PACKET_LIMIT,
+        offset: 0,
+        ...(event.chat.chatGuid ? { chatGuid: event.chat.chatGuid } : {}),
+        ...(!event.chat.chatGuid && event.chat.chatIdentifier ? { chatIdentifier: event.chat.chatIdentifier } : {}),
+    });
+    const history = candidates
+        .filter((candidate) => candidate.kind === "message")
+        .filter((candidate) => isSameBlueBubblesChat(candidate, event))
+        .filter((candidate) => candidate.messageGuid !== event.messageGuid)
+        .filter((candidate) => candidate.timestamp <= event.timestamp)
+        .filter((candidate) => event.timestamp - candidate.timestamp <= exports.BLUEBUBBLES_CONTEXT_PACKET_MAX_AGE_MS);
+    if (history.length === 0)
+        return null;
+    const packet = (0, context_packets_1.buildSenseContextPacket)({
+        agent: input.agentName,
+        sense: "bluebubbles",
+        sessionKey: event.chat.sessionKey,
+        chatKeyHash: chatGuidHash,
+        anchorMessageGuid: event.messageGuid,
+        anchorTimestamp,
+        windowBeforeMessages: exports.BLUEBUBBLES_CONTEXT_PACKET_LIMIT,
+        windowBeforeMs: exports.BLUEBUBBLES_CONTEXT_PACKET_MAX_AGE_MS,
+        messages: history.map((candidate) => messageToContextInput(candidate, chatGuidHash)),
+    });
+    const rendered = (0, context_packets_1.renderSenseContextPacketForPrompt)(packet, {
+        redactionPatterns: [/password=[^\s]+/gi],
+    });
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.bluebubbles_context_packet_built",
+        message: "built bluebubbles same-chat context packet",
+        meta: {
+            packetId: packet.packetId,
+            messageGuid: event.messageGuid,
+            contextMessages: history.length,
+            renderedMessages: rendered.stats.renderedMessages,
+        },
+    });
+    return {
+        packet,
+        rendered,
+        historyCount: history.length,
+    };
+}

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

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.smokeBlueBubblesContext = smokeBlueBubblesContext;
+exports.formatBlueBubblesContextSmokeText = formatBlueBubblesContextSmokeText;
+const machine_identity_1 = require("../../heart/machine-identity");
+const identity_1 = require("../../heart/identity");
+const runtime_credentials_1 = require("../../heart/runtime-credentials");
+const runtime_1 = require("../../nerves/runtime");
+const context_packet_ledger_1 = require("../context-packet-ledger");
+const client_1 = require("./client");
+const context_packet_1 = require("./context-packet");
+const model_1 = require("./model");
+function requireMessageEvent(event, messageGuid) {
+    if (event.kind !== "message") {
+        throw new Error(`BlueBubbles context smoke requires a message event; ${messageGuid} repaired to ${event.kind}`);
+    }
+}
+function smokeResult(params, writeResult) {
+    return {
+        ok: true,
+        sideEffect: writeResult ? "private-runtime-ledger-write" : false,
+        ...params,
+        ...(writeResult ? {
+            ledgerPath: writeResult.ledgerPath,
+            packetPath: writeResult.packetPath,
+            receiptPath: writeResult.receiptPath,
+        } : {}),
+    };
+}
+async function smokeBlueBubblesContext(params, deps = {}) {
+    const agentName = params.agentName.trim();
+    const messageGuid = params.messageGuid.trim();
+    if (!agentName)
+        throw new Error("bluebubbles context-smoke requires agentName");
+    if (!messageGuid)
+        throw new Error("bluebubbles context-smoke requires messageGuid");
+    const setSmokeAgentName = deps.setAgentName ?? identity_1.setAgentName;
+    const resetSmokeIdentity = deps.resetIdentity ?? identity_1.resetIdentity;
+    const normalizeEvent = deps.normalizeEvent ?? model_1.normalizeBlueBubblesEvent;
+    const loadMachineId = deps.loadMachineId ?? (() => (0, machine_identity_1.loadOrCreateMachineIdentity)().machineId);
+    const refreshMachineRuntimeConfig = deps.refreshMachineRuntimeConfig ?? runtime_credentials_1.refreshMachineRuntimeCredentialConfig;
+    const resolveAgentRoot = deps.getAgentRoot ?? identity_1.getAgentRoot;
+    const writePacket = deps.writePacket ?? context_packet_ledger_1.writeSenseContextPacket;
+    const createDefaultClient = deps.createDefaultClient ?? client_1.createBlueBubblesClient;
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.bluebubbles_context_smoke_start",
+        message: "starting bluebubbles context smoke",
+        meta: {
+            agentName,
+            messageGuid,
+            persist: params.persist === true,
+        },
+    });
+    setSmokeAgentName(agentName);
+    try {
+        if (!deps.createClient) {
+            const machineId = loadMachineId();
+            await refreshMachineRuntimeConfig(agentName, machineId, { preserveCachedOnFailure: true });
+        }
+        const client = deps.createClient ? deps.createClient() : createDefaultClient();
+        const probe = normalizeEvent({
+            type: "new-message",
+            data: {
+                guid: messageGuid,
+                hasPayloadData: true,
+            },
+        });
+        const event = await client.repairEvent(probe);
+        requireMessageEvent(event, messageGuid);
+        const built = await (0, context_packet_1.buildBlueBubblesContextPacket)({
+            agentName,
+            client,
+            event,
+        });
+        if (!built) {
+            throw new Error(`BlueBubbles context smoke found no same-thread history before ${messageGuid}`);
+        }
+        const writeResult = params.persist
+            ? writePacket(resolveAgentRoot(agentName), built.packet)
+            : undefined;
+        const result = smokeResult({
+            agentName,
+            messageGuid,
+            packetId: built.packet.packetId,
+            contextMessages: built.historyCount,
+            renderedMessages: built.rendered.stats.renderedMessages,
+            renderedCharacters: built.rendered.stats.outputCharacters,
+            omittedMessages: built.rendered.stats.omittedMessages,
+            truncatedMessages: built.rendered.stats.truncatedMessages,
+        }, writeResult);
+        (0, runtime_1.emitNervesEvent)({
+            component: "senses",
+            event: "senses.bluebubbles_context_smoke_end",
+            message: "completed bluebubbles context smoke",
+            meta: {
+                agentName,
+                messageGuid,
+                packetId: result.packetId,
+                contextMessages: result.contextMessages,
+                sideEffect: result.sideEffect,
+            },
+        });
+        return result;
+    }
+    catch (error) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "senses",
+            event: "senses.bluebubbles_context_smoke_error",
+            message: "bluebubbles context smoke failed",
+            meta: {
+                agentName,
+                messageGuid,
+                reason: error instanceof Error ? error.message : String(error),
+            },
+        });
+        throw error;
+    }
+    finally {
+        resetSmokeIdentity();
+    }
+}
+function formatBlueBubblesContextSmokeText(result) {
+    const lines = [
+        "bluebubbles context smoke passed",
+        `agent: ${result.agentName}`,
+        `message_guid: ${result.messageGuid}`,
+        `context_messages: ${result.contextMessages}`,
+        `packet_id: ${result.packetId}`,
+        `rendered_messages: ${result.renderedMessages}`,
+        `rendered_characters: ${result.renderedCharacters}`,
+        `truncated_messages: ${result.truncatedMessages}`,
+        `omitted_messages: ${result.omittedMessages}`,
+        `side_effect: ${result.sideEffect}`,
+    ];
+    if (result.ledgerPath)
+        lines.push(`ledger_path: ${result.ledgerPath}`);
+    if (result.packetPath)
+        lines.push(`packet_path: ${result.packetPath}`);
+    if (result.receiptPath)
+        lines.push(`receipt_path: ${result.receiptPath}`);
+    return lines.join("\n");
+}

package/dist/senses/bluebubbles/entry.js

@@ -0,0 +1,77 @@
+"use strict";
+// Thin entrypoint for `npm run bluebubbles` / `node dist/senses/bluebubbles/entry.js --agent <name>`.
+// Separated from index.ts so the BlueBubbles adapter stays testable.
+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/bluebubbles/entry.js --agent ouroboros");
+    process.exit(1);
+}
+const runtime_logging_1 = require("../../heart/daemon/runtime-logging");
+const runtime_1 = require("../../nerves/runtime");
+(0, runtime_logging_1.configureDaemonRuntimeLogger)("bluebubbles");
+(0, runtime_1.emitNervesEvent)({
+    component: "senses",
+    event: "senses.entry_boot",
+    message: "booting BlueBubbles entrypoint",
+    meta: { entry: "bluebubbles", agentName },
+});
+Promise.resolve().then(() => __importStar(require("../../heart/runtime-credentials"))).then(async ({ readMachineRuntimeCredentialConfig, refreshMachineRuntimeCredentialConfig, refreshRuntimeCredentialConfig, waitForRuntimeCredentialBootstrap, }) => {
+    await waitForRuntimeCredentialBootstrap(agentName);
+    const { loadOrCreateMachineIdentity } = await Promise.resolve().then(() => __importStar(require("../../heart/machine-identity")));
+    const machine = loadOrCreateMachineIdentity();
+    const machineConfig = readMachineRuntimeCredentialConfig(agentName);
+    if (!machineConfig.ok) {
+        await refreshMachineRuntimeCredentialConfig(agentName, machine.machineId, { preserveCachedOnFailure: true }).catch(() => undefined);
+    }
+    const { startBlueBubblesApp } = await Promise.resolve().then(() => __importStar(require("./index")));
+    await startBlueBubblesApp();
+    void refreshRuntimeCredentialConfig(agentName, { preserveCachedOnFailure: true }).catch(() => undefined);
+})
+    .catch((error) => {
+    (0, runtime_1.emitNervesEvent)({
+        level: "error",
+        component: "senses",
+        event: "senses.entry_error",
+        message: "BlueBubbles entrypoint failed",
+        meta: { entry: "bluebubbles", 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);
+});