@ouro.bot/cli 0.1.0-alpha.597 → 0.1.0-alpha.598

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.598",
+      "changes": [
+        "New `restart_runtime({ reason })` tool. Agent self-maintenance: asking Ari to restart the daemon over BlueBubbles is now a thing of the past. Sends `daemon.restart` over the existing socket — daemon logs the reason as `daemon.restart_requested`, runs its normal stop pathway, and exits. launchctl's KeepAlive policy auto-respawns the daemon, so the agent comes back fresh on the other side. The agent will not see this tool's return value — its process exits with the daemon and a clean boot replaces it. In dev mode (no launchctl) the daemon just exits; same observable behavior as `daemon.stop`, with the restart-requested audit event distinguishing intent."
+      ]
+    },
     {
       "version": "0.1.0-alpha.597",
       "changes": [

package/dist/heart/daemon/daemon.js

@@ -1073,6 +1073,27 @@ class OuroDaemon {
                 await this.stop();
                 this.onStopCommandComplete?.();
                 return { ok: true, message: "daemon stopped" };
+            case "daemon.restart": {
+                // Restart is "stop + let launchctl respawn." Under launchctl's KeepAlive
+                // policy the process is auto-restarted on exit, so daemon.restart and
+                // daemon.stop differ only in intent + audit trail. In dev (no launchctl),
+                // the process simply exits — same observable behavior as daemon.stop.
+                (0, runtime_1.emitNervesEvent)({
+                    component: "daemon",
+                    event: "daemon.restart_requested",
+                    message: "daemon restart requested",
+                    meta: {
+                        reason: command.reason ?? null,
+                        requestedBy: command.requestedBy ?? null,
+                    },
+                });
+                await this.stop();
+                this.onStopCommandComplete?.();
+                return {
+                    ok: true,
+                    message: "daemon restarting — launchctl will respawn",
+                };
+            }
             case "daemon.status": {
                 const data = this.buildStatusPayload();
                 return {

package/dist/repertoire/tools-base.js

@@ -20,6 +20,7 @@ const tools_mail_1 = require("./tools-mail");
 const tools_trip_1 = require("./tools-trip");
 const tools_awaiting_1 = require("./tools-awaiting");
 const tools_obligations_1 = require("./tools-obligations");
+const tools_runtime_1 = require("./tools-runtime");
 // Re-export flow tools for consumers that import them from tools-base
 var tools_flow_1 = require("./tools-flow");
 Object.defineProperty(exports, "ponderTool", { enumerable: true, get: function () { return tools_flow_1.ponderTool; } });
@@ -55,6 +56,7 @@ exports.baseToolDefinitions = [
     ...tools_trip_1.tripToolDefinitions,
     ...tools_awaiting_1.awaitingToolDefinitions,
     ...tools_obligations_1.obligationToolDefinitions,
+    ...tools_runtime_1.runtimeToolDefinitions,
 ];
 // Convenience array of just the tool schemas (no handler/integration metadata).
 // Used by consumers that need the OpenAI function-tool format.

package/dist/repertoire/tools-runtime.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeToolDefinitions = void 0;
+const identity_1 = require("../heart/identity");
+const runtime_1 = require("../nerves/runtime");
+const socket_client_1 = require("../heart/daemon/socket-client");
+async function restartRuntime(args, agentName) {
+    if (typeof args.reason !== "string" || args.reason.trim().length === 0) {
+        return JSON.stringify({ error: "reason is required (one-line audit string)" });
+    }
+    const reason = args.reason.trim();
+    (0, runtime_1.emitNervesEvent)({
+        component: "repertoire",
+        event: "repertoire.runtime_restart_requested",
+        message: "agent requested runtime restart",
+        meta: { agent: agentName, reason },
+    });
+    try {
+        const response = await (0, socket_client_1.sendDaemonCommand)(socket_client_1.DEFAULT_DAEMON_SOCKET_PATH, {
+            kind: "daemon.restart",
+            reason,
+            requestedBy: agentName,
+        });
+        return JSON.stringify({
+            requested: true,
+            reason,
+            detail: response.message ?? "daemon restart requested",
+        });
+    }
+    catch (error) {
+        return JSON.stringify({
+            error: "failed to reach daemon socket",
+            detail: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+exports.runtimeToolDefinitions = [
+    {
+        tool: {
+            type: "function",
+            function: {
+                name: "restart_runtime",
+                description: "ask my runtime (the daemon hosting me) to restart itself. for when something is wedged — stale state, recovery queue jammed, version mismatch, or i just need a fresh boot. under launchctl the daemon auto-respawns, so i come back on the other side with a clean slate. takes a one-line reason that lands in the audit log. i will NOT see this tool's response — my process exits with the daemon and i wake up fresh.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        reason: {
+                            type: "string",
+                            description: "one-line audit reason (e.g. 'bluebubbles recovery queue wedged for 4h', 'picking up daemon version update').",
+                        },
+                    },
+                    required: ["reason"],
+                },
+            },
+        },
+        handler: async (args) => {
+            const agentName = (0, identity_1.getAgentName)();
+            return restartRuntime({ reason: args.reason }, agentName);
+        },
+    },
+];

package/package.json

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