@ouro.bot/cli 0.1.0-alpha.457 → 0.1.0-alpha.459

package/changelog.json

@@ -1,6 +1,22 @@
 {
   "_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.459",
+      "changes": [
+        "`ouro connect bluebubbles` now applies a machine-local attachment to a running daemon by recycling Ouro once after the vault and bundle update, so the webhook listener starts immediately instead of requiring a manual `ouro down && ouro up` discovery step.",
+        "`ouro status` and daemon health now probe the BlueBubbles listener declared in the agent's machine-local vault config, including non-default webhook ports, instead of reporting stale health against the default port.",
+        "BlueBubbles setup docs now state the live-apply behavior directly, and daemon coverage locks the dynamic sense-health probe plus running-daemon connect path."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.458",
+      "changes": [
+        "Agent Mail setup guidance now explicitly forbids telling the human to run setup CLI commands; the agent must run `ouro account ensure`, `ouro connect mail`, `ouro mail import-mbox`, `ouro status`, and `ouro doctor` itself when doing setup.",
+        "If the agent's current surface cannot run shell/tools, the setup contract now says to move to a tool-capable Ouro setup session or companion instead of offloading CLI operation to the human.",
+        "Prompt and runbook contract tests now cover the live failure mode where the agent says it owns setup but still asks Ari to run `ouro connect mail`."
+      ]
+    },
     {
       "version": "0.1.0-alpha.457",
       "changes": [

package/dist/heart/daemon/cli-exec.js

@@ -1911,6 +1911,29 @@ async function applyRuntimeChangeToRunningAgent(agent, deps, onProgress) {
         return `daemon restart skipped: ${error instanceof Error ? error.message : String(error)}`;
     }
 }
+async function applyLocalSenseChangeToRunningDaemon(agent, senseLabel, deps, onProgress) {
+    try {
+        onProgress?.("checking whether Ouro is already running");
+        const alive = await deps.checkSocketAlive(deps.socketPath);
+        if (!alive)
+            return "daemon is not running; next `ouro up` will load the change";
+        onProgress?.(`restarting Ouro so ${senseLabel} is attached in the live sense manager`);
+        const stopped = await withCliTimeout(DEFAULT_AGENT_RESTART_TIMEOUT_MS, "daemon stop request timed out", () => deps.sendCommand(deps.socketPath, { kind: "daemon.stop" }));
+        if (!stopped.ok)
+            return `daemon restart skipped: ${stopped.error ?? stopped.message ?? "unknown daemon error"}`;
+        deps.cleanupStaleSocket(deps.socketPath);
+        const started = await ensureDaemonRunning({
+            ...deps,
+            reportDaemonStartupPhase: (message) => onProgress?.(message),
+        }, { initialAlive: false });
+        if (!started.ok)
+            return `daemon restart requested, but startup failed: ${started.message}`;
+        return `restarted Ouro; ${senseLabel} is loaded for ${agent}`;
+    }
+    catch (error) {
+        return `daemon restart skipped: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
 async function executeVaultConfigSet(command, deps) {
     if (command.agent === "SerpentGuide") {
         throw new Error("SerpentGuide does not have persistent runtime credentials. Store credentials in the hatchling agent vault.");
@@ -2623,6 +2646,7 @@ async function executeConnectBlueBubbles(agent, deps) {
     const machineId = currentMachineId(deps);
     const progress = createHumanCommandProgress(deps, "connect bluebubbles");
     let stored;
+    let daemonApply = "not applied";
     try {
         progress.startPhase("saving BlueBubbles attachment");
         progress.updateDetail("checking existing machine runtime config");
@@ -2649,6 +2673,7 @@ async function executeConnectBlueBubbles(agent, deps) {
         progress.updateDetail("enabling BlueBubbles in agent.json");
         enableAgentSense(agent, "bluebubbles", deps);
         progress.completePhase("saving BlueBubbles attachment", "secret stored");
+        daemonApply = await runCommandProgressPhase(progress, "applying BlueBubbles to running Ouro", () => applyLocalSenseChangeToRunningDaemon(agent, "BlueBubbles", deps, (message) => progress.updateDetail(message)), (result) => result);
         progress.end();
     }
     catch (error) {
@@ -2663,11 +2688,13 @@ async function executeConnectBlueBubbles(agent, deps) {
             `Machine: ${machineId}`,
             `Stored: ${stored.itemPath}`,
             "agent.json: senses.bluebubbles.enabled = true",
+            `Runtime: ${daemonApply}`,
             "secret was not printed",
             ...(syncSummary ? [syncSummary] : []),
         ],
         nextMoves: [
-            "Point BlueBubbles at this machine's webhook, then run ouro up.",
+            `Point BlueBubbles at this machine's webhook listener on port ${port}${webhookPath}.`,
+            "If BlueBubbles was already pointed there, messages can now reach the agent.",
             `Attach other machines separately if ${agent} should use BlueBubbles there too.`,
         ],
         fallbackLines: [
@@ -2675,9 +2702,10 @@ async function executeConnectBlueBubbles(agent, deps) {
             `machine: ${machineId}`,
             `stored: ${stored.itemPath}`,
             "agent.json: senses.bluebubbles.enabled = true",
+            `runtime: ${daemonApply}`,
             "secret was not printed",
             "",
-            "Next: point BlueBubbles at this machine's webhook, then run `ouro up`.",
+            `Next: point BlueBubbles at this machine's webhook listener on port ${port}${webhookPath}.`,
             ...(syncSummary ? [syncSummary] : []),
         ],
     });

package/dist/heart/daemon/daemon-entry.js

@@ -58,8 +58,6 @@ const agent_config_check_1 = require("./agent-config-check");
 const pulse_1 = require("./pulse");
 const socket_client_1 = require("./socket-client");
 const bundle_manifest_1 = require("../../mind/bundle-manifest");
-const http_health_probe_1 = require("./http-health-probe");
-const config_1 = require("../config");
 function parseSocketPath(argv) {
     const socketIndex = argv.indexOf("--socket");
     if (socketIndex >= 0) {
@@ -128,19 +126,10 @@ const router = new message_router_1.FileMessageRouter();
 const senseManager = new sense_manager_1.DaemonSenseManager({
     agents: [...managedAgents],
 });
-/* v8 ignore next 5 -- entry-point wiring: probe factory and HealthMonitor both have full unit tests @preserve */
-let bbPort = 18790;
-try {
-    bbPort = (0, config_1.getBlueBubblesChannelConfig)().port;
-}
-catch {
-    // Daemon runs without --agent; agent-scoped config may not be available.
-}
-const bbProbe = (0, http_health_probe_1.createHttpHealthProbe)("bluebubbles", bbPort);
 const healthMonitor = new health_monitor_1.HealthMonitor({
     processManager,
     scheduler,
-    senseProbes: [bbProbe],
+    senseProbeProvider: () => senseManager.listHealthProbes(),
     alertSink: (message) => {
         (0, runtime_1.emitNervesEvent)({
             level: "error",

package/dist/heart/daemon/health-monitor.js

@@ -9,6 +9,7 @@ class HealthMonitor {
     diskUsagePercent;
     onCriticalAgent;
     senseProbes;
+    senseProbeProvider;
     intervalHandle = null;
     constructor(options) {
         this.processManager = options.processManager;
@@ -17,6 +18,7 @@ class HealthMonitor {
         this.diskUsagePercent = options.diskUsagePercent ?? (() => 0);
         this.onCriticalAgent = options.onCriticalAgent ?? (() => undefined);
         this.senseProbes = options.senseProbes ?? [];
+        this.senseProbeProvider = options.senseProbeProvider ?? (() => []);
     }
     startPeriodicChecks(intervalMs) {
         if (this.intervalHandle !== null)
@@ -113,7 +115,18 @@ class HealthMonitor {
                 message: `disk usage healthy (${diskPercent}%)`,
             });
         }
-        for (const probe of this.senseProbes) {
+        const senseProbes = [...this.senseProbes];
+        try {
+            senseProbes.push(...this.senseProbeProvider());
+        }
+        catch (error) {
+            results.push({
+                name: "sense-probes",
+                status: "warn",
+                message: `sense probe discovery failed: ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+        for (const probe of senseProbes) {
             try {
                 const outcome = await probe.check();
                 if (outcome.ok) {

package/dist/heart/daemon/sense-manager.js

@@ -43,6 +43,7 @@ const runtime_credentials_1 = require("../runtime-credentials");
 const sense_truth_1 = require("../sense-truth");
 const machine_identity_1 = require("../machine-identity");
 const process_manager_1 = require("./process-manager");
+const http_health_probe_1 = require("./http-health-probe");
 const DEFAULT_TEAMS_PORT = 3978;
 const DEFAULT_BLUEBUBBLES_PORT = 18790;
 const DEFAULT_BLUEBUBBLES_WEBHOOK_PATH = "/bluebubbles-webhook";
@@ -352,6 +353,22 @@ class DaemonSenseManager {
             .filter((pid) => pid !== null && pid !== undefined);
     }
     /* v8 ignore stop */
+    listHealthProbes() {
+        const probes = [];
+        for (const [agent, context] of this.contexts.entries()) {
+            const runtimeConfig = (0, runtime_credentials_1.readRuntimeCredentialConfig)(agent);
+            const machineRuntimeConfig = (0, runtime_credentials_1.readMachineRuntimeCredentialConfig)(agent);
+            context.facts = senseFactsFromRuntimeConfig(agent, context.senses, runtimeConfig, machineRuntimeConfig);
+            if (!context.senses.bluebubbles.enabled || !context.facts.bluebubbles.configured || !machineRuntimeConfig.ok) {
+                continue;
+            }
+            const machinePayload = machineRuntimeConfig.config;
+            const bluebubblesChannel = machinePayload.bluebubblesChannel;
+            const port = numberField(bluebubblesChannel, "port", DEFAULT_BLUEBUBBLES_PORT);
+            probes.push((0, http_health_probe_1.createHttpHealthProbe)(`bluebubbles:${agent}`, port));
+        }
+        return probes;
+    }
     listSenseRows() {
         const runtime = new Map();
         for (const snapshot of this.processManager.listAgentSnapshots()) {

package/dist/mind/prompt.js

@@ -465,6 +465,7 @@ function senseRuntimeGuidance(channel, preReadStatusLines) {
     lines.push("teams setup truth: run `ouro connect teams --agent <agent>` from the connect bay; it stores Teams runtime/config fields and enables `senses.teams.enabled`.");
     lines.push("bluebubbles setup truth: run `ouro connect bluebubbles --agent <agent>` from the connect bay; it stores this machine's BlueBubbles URL/password/listener config in the agent vault machine runtime item.");
     lines.push("mail setup AX: if a human asks me to set up email, I do not hand them a terminal checklist. I guide the flow end-to-end: name the current phase, run agent-runnable commands myself with shell/tools when available, ask the human only for human-required facts or browser actions, wait for their reply, verify the result, then continue.");
+    lines.push("mail setup hard rule: never tell the human to run `ouro account ensure`, `ouro connect mail`, `ouro mail import-mbox`, `ouro status`, or `ouro doctor` for setup. Say what I am about to run, run it myself, and report the result. If my current surface cannot run shell/tools, I ask for a tool-capable Ouro setup session or companion to continue; I do not offload CLI operation to the human.");
     lines.push("mail setup truth: Agent Mail uses Mailroom, not HEY OAuth/IMAP. For the full work substrate account, the agent-runnable command is `ouro account ensure --agent <agent> --owner-email <email> --source hey`; use `ouro connect mail --agent <agent> --owner-email <email> --source hey` for mail-only repair/provisioning, or `--no-delegated-source` for native-only mail. The detailed runbook is `docs/agent-mail-setup.md`.");
     lines.push("mail setup truth: HEY archive bootstrap is human-exported MBOX only. I ask for the browser-downloaded MBOX path, then I run `ouro mail import-mbox --file <path> --owner-email <email> --source hey --agent <agent>` myself and verify the import.");
     lines.push("mail setup truth: verify with `ouro status`, `ouro doctor`, bounded mail tools (`mail_recent`, `mail_search`, `mail_thread`, `mail_access_log`), and the read-only Outlook Mailbox tab. `ouro doctor` is installation-wide; do not invent `ouro doctor --agent <agent>`.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.457",
+  "version": "0.1.0-alpha.459",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",